knip 1.0.0-beta.4 → 1.0.0-beta.6

package/README.md

@@ -80,29 +80,30 @@ This will analyze the project and output unused files, dependencies and exports.
 
 ## Options
 
-    ❯ npx knip
+    $ npx knip --help
     knip [options]
 
     Options:
-      -c/--config [file]     Configuration file path (default: ./knip.json, knip.jsonc 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 workspaces. Not devDependencies, not ancestor workspaces.
-      --workspace            Analyze a single workspace (default: analyze all configured workspaces)
-      --include              Report only listed issue type(s), can be comma-separated or repeated
-      --exclude              Exclude issue type(s) from report, can be comma-separated or repeated
-      --ignore               Ignore files matching this glob pattern, can be repeated
-      --no-gitignore         Don't use .gitignore
-      --no-progress          Don't show dynamic progress updates
-      --no-exit-code         Always exit with code zero (0)
-      --max-issues           Maximum number of issues before non-zero exit code (default: 0)
-      --reporter             Select reporter: symbols, compact, codeowners, json (default: symbols)
-      --reporter-options     Pass extra options to the reporter (as JSON string, see example)
-      --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
-
-    Issue types: files, dependencies, unlisted, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates
+      -c/--config [file]       Configuration file path (default: knip.json, knip.jsonc 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)
+      --include-entry-exports  Include unused exports in entry files (without `@public`)
+      --ignore                 Ignore files matching this glob pattern, can be repeated
+      --no-gitignore           Don't use .gitignore
+      --include                Report only provided issue type(s), can be comma-separated or repeated (1)
+      --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)
+      --no-progress            Don't show dynamic progress updates
+      --reporter               Select reporter: symbols, compact, codeowners, json (default: symbols)
+      --reporter-options       Pass extra options to the reporter (as JSON string, see example)
+      --no-exit-code           Always exit with code zero (0)
+      --max-issues             Maximum number of issues before non-zero exit code (default: 0)
+      --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
+
+    (1) Issue types: files, dependencies, unlisted, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates
 
     Examples:
 
@@ -271,6 +272,12 @@ 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.
 
+### Create a new plugin
+
+Getting false positives because a plugin is missing? Want to help out? Feel free to add your own plugin! Get started:
+
+    npm run create-plugin -- --name [myplugin]
+
 ## Configuration
 
 ### Libraries versus Applications
@@ -407,7 +414,7 @@ The following commands are similar:
     unimported
     knip --production --include files,dependencies,unlisted
 
-See [production mode](#production-mode).
+See [production mode][7].
 
 ## TypeScript language services
 

package/dist/cli.js

@@ -2,15 +2,14 @@
 import path from 'node:path';
 import { register } from 'esbuild-register/dist/node.js';
 import reporters from './reporters/index.js';
+import parsedArgs, { helpText } from './util/cli-arguments.js';
 import { ConfigurationError } from './util/errors.js';
-import { printHelp } from './util/help.js';
-import parsedArgs from './util/parseArgs.js';
 import { measure } from './util/performance.js';
 import { main } from './index.js';
 register();
-const { values: { debug: isDebug = false, help, 'ignore-entry-exports': isIgnoreEntryExports = false, 'max-issues': maxIssues = '0', 'no-exit-code': noExitCode = false, 'no-gitignore': isNoGitIgnore = false, 'no-progress': noProgress = false, production: isProduction = false, reporter = 'symbols', 'reporter-options': reporterOptions = '', strict: isStrict = false, tsConfig, }, } = parsedArgs;
+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': noProgress = false, production: isProduction = false, reporter = 'symbols', 'reporter-options': reporterOptions = '', strict: isStrict = false, tsConfig, }, } = parsedArgs;
 if (help) {
-    printHelp();
+    console.log(helpText);
     process.exit(0);
 }
 const cwd = process.cwd();
@@ -25,7 +24,7 @@ const run = async () => {
             isStrict,
             isProduction,
             isShowProgress,
-            isIgnoreEntryExports,
+            isIncludeEntryExports,
         });
         await printReport({ report, issues, cwd, isProduction, options: reporterOptions });
         const totalErrorCount = Object.keys(report)
@@ -39,7 +38,7 @@ const run = async () => {
     catch (error) {
         if (error instanceof ConfigurationError) {
             console.error(error.message + '\n');
-            printHelp();
+            console.log(helpText);
             process.exit(1);
         }
         throw error;

package/dist/configuration-chief.d.ts

@@ -5,18 +5,16 @@ import type { Configuration, WorkspaceConfiguration } from './types/config.js';
 import type { PackageJson } from '@npmcli/package-json';
 type ConfigurationManagerOptions = {
     cwd?: string;
-    isStrict: boolean;
     isProduction: boolean;
 };
 export default class ConfigurationChief {
     cwd: string;
-    isStrict: boolean;
     isProduction: boolean;
     config: Configuration;
     manifestPath: undefined | string;
     manifest: undefined | PackageJson;
     manifestWorkspaces: undefined | string[];
-    constructor({ cwd, isStrict, isProduction }: ConfigurationManagerOptions);
+    constructor({ cwd, isProduction }: ConfigurationManagerOptions);
     loadLocalConfig(): Promise<void>;
     normalize(rawLocalConfig: z.infer<typeof ConfigurationValidator>): {
         include: string[];

package/dist/configuration-chief.js

@@ -5,10 +5,10 @@ import { ConfigurationValidator } from './configuration-validator.js';
 import { ROOT_WORKSPACE_NAME } from './constants.js';
 import * as plugins from './plugins/index.js';
 import { arrayify } from './util/array.js';
+import parsedArgs from './util/cli-arguments.js';
 import { ConfigurationError } from './util/errors.js';
 import { findFile, loadJSON } from './util/fs.js';
 import { ensurePosixPath } from './util/glob.js';
-import parsedArgs from './util/parseArgs.js';
 import { resolveIncludedIssueTypes } from './util/resolve-included-issue-types.js';
 import { byPathDepth } from './util/workspace.js';
 const { values: { config: rawConfigArg, workspace: rawWorkspaceArg, include = [], exclude = [] }, } = parsedArgs;
@@ -31,15 +31,13 @@ const defaultConfig = {
 const PLUGIN_NAMES = Object.keys(plugins);
 export default class ConfigurationChief {
     cwd = process.cwd();
-    isStrict = false;
     isProduction = false;
     config;
     manifestPath;
     manifest;
     manifestWorkspaces;
-    constructor({ cwd, isStrict, isProduction }) {
+    constructor({ cwd, isProduction }) {
         this.cwd = cwd ?? this.cwd;
-        this.isStrict = isStrict;
         this.isProduction = isProduction;
         this.config = defaultConfig;
     }
@@ -102,7 +100,7 @@ export default class ConfigurationChief {
                         }
                         else {
                             const isObject = typeof pluginConfig !== 'string' && !Array.isArray(pluginConfig);
-                            const config = typeof pluginConfig === 'string' ? [pluginConfig] : isObject ? arrayify(pluginConfig.config) : null;
+                            const config = isObject ? arrayify(pluginConfig.config) : pluginConfig ? arrayify(pluginConfig) : null;
                             const entry = isObject && 'entry' in pluginConfig ? arrayify(pluginConfig.entry) : null;
                             const project = isObject && 'project' in pluginConfig ? arrayify(pluginConfig.project) : entry;
                             workspaces[workspaceName][pluginName] = {
@@ -150,7 +148,7 @@ export default class ConfigurationChief {
             ancestors: [],
         };
         const isOnlyRootWorkspace = (manifestWorkspaces.length === 0 && !rawWorkspaceArg) ||
-            (rawWorkspaceArg && ['.', './'].includes(rawWorkspaceArg));
+            (rawWorkspaceArg && [ROOT_WORKSPACE_NAME, './'].includes(rawWorkspaceArg));
         if (isOnlyRootWorkspace)
             return [rootWorkspace];
         if (rawWorkspaceArg) {
@@ -160,7 +158,7 @@ export default class ConfigurationChief {
                 config: this.getConfigForWorkspace(rawWorkspaceArg),
                 ancestors: [ROOT_WORKSPACE_NAME],
             };
-            return this.hasConfigForWorkspace('.') ? [rootWorkspace, workspace] : [workspace];
+            return this.hasConfigForWorkspace(ROOT_WORKSPACE_NAME) ? [rootWorkspace, workspace] : [workspace];
         }
         const workspaces = [...manifestWorkspaces, ...additionalWorkspaces];
         const activeWorkspaces = workspaces.filter(workspaceName => this.hasConfigForWorkspace(workspaceName));
@@ -215,7 +213,6 @@ export default class ConfigurationChief {
             include: this.config.include ?? [],
             exclude: this.config.exclude ?? [],
             isProduction: this.isProduction,
-            isStrict: this.isStrict,
         });
     }
 }

package/dist/index.js

@@ -16,8 +16,8 @@ import { loadTSConfig } from './util/tsconfig-loader.js';
 import { byPathDepth } from './util/workspace.js';
 import WorkspaceWorker from './workspace-worker.js';
 export const main = async (unresolvedConfiguration) => {
-    const { cwd, tsConfigFile, gitignore, isStrict, isProduction, isShowProgress, isIgnoreEntryExports } = unresolvedConfiguration;
-    const chief = new ConfigurationChief({ cwd, isStrict, isProduction });
+    const { cwd, tsConfigFile, gitignore, isStrict, isProduction, isShowProgress, isIncludeEntryExports } = unresolvedConfiguration;
+    const chief = new ConfigurationChief({ cwd, isProduction });
     debugLogObject('Unresolved configuration', unresolvedConfiguration);
     const collector = new IssueCollector({ cwd, isShowProgress });
     collector.updateMessage('Reading configuration and manifest files...');
@@ -81,7 +81,7 @@ export const main = async (unresolvedConfiguration) => {
                 });
                 debugLogFiles(`Globbed entry paths${suffix}`, workspaceEntryPaths);
                 workspaceEntryPaths.forEach(entryPath => principal.addEntryPath(entryPath));
-                if (isIgnoreEntryExports)
+                if (!isIncludeEntryExports)
                     workspaceEntryPaths.forEach(entryPath => lab.skipExportsAnalysisFor(entryPath));
                 collector.updateMessage(`Resolving production plugin entry files${suffix}...`);
                 const pluginWorkspaceEntryPaths = await _glob({
@@ -122,7 +122,7 @@ export const main = async (unresolvedConfiguration) => {
                     });
                     debugLogFiles(`Globbed entry paths${suffix}`, workspaceEntryPaths);
                     workspaceEntryPaths.forEach(entryPath => principal.addEntryPath(entryPath));
-                    if (isIgnoreEntryExports)
+                    if (!isIncludeEntryExports)
                         workspaceEntryPaths.forEach(entryPath => lab.skipExportsAnalysisFor(entryPath));
                 }
                 {

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

@@ -1,7 +1,9 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "";
+export declare const ENABLERS: string[];
+export declare const isEnabled: IsPluginEnabledCallback;
 export declare const CONFIG_FILE_PATTERNS: never[];
 export declare const ENTRY_FILE_PATTERNS: never[];
 export declare const PRODUCTION_ENTRY_FILE_PATTERNS: never[];
 export declare const PROJECT_FILE_PATTERNS: never[];
-export declare const isEnabled: IsPluginEnabledCallback;
 export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/_template/index.js

@@ -1,12 +1,12 @@
 import { _load } from '../../util/loader.js';
 import { timerify } from '../../util/performance.js';
+export const NAME = '';
+export const ENABLERS = [''];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = [];
 export const ENTRY_FILE_PATTERNS = [];
 export const PRODUCTION_ENTRY_FILE_PATTERNS = [];
 export const PROJECT_FILE_PATTERNS = [];
-export const isEnabled = ({ dependencies }) => {
-    return dependencies.has('[pkg]');
-};
 const findPluginDependencies = async (configFilePath, { manifest }) => {
     const config = configFilePath.endsWith('package.json') ? manifest.plugin : await _load(configFilePath);
     return config?.plugins ?? [];

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
-export declare const CONFIG_FILE_PATTERNS: string[];
+export declare const NAME = "Babel";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
+export declare const CONFIG_FILE_PATTERNS: string[];
 export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/babel/index.js

@@ -3,6 +3,9 @@ import { _load } from '../../util/loader.js';
 import { getPackageName } from '../../util/modules.js';
 import { timerify } from '../../util/performance.js';
 import { resolvePresetName, resolvePluginName } from './helpers.js';
+export const NAME = 'Babel';
+export const ENABLERS = ['@babel/cli', '@babel/core', '@babel/preset-env', '@babel/register'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = [
     'babel.config.json',
     'babel.config.js',
@@ -11,12 +14,6 @@ export const CONFIG_FILE_PATTERNS = [
     '.babelrc',
     'package.json',
 ];
-export const isEnabled = ({ dependencies }) => {
-    return (dependencies.has('@babel/cli') ||
-        dependencies.has('@babel/core') ||
-        dependencies.has('@babel/preset-env') ||
-        dependencies.has('@babel/register'));
-};
 const api = {
     caller: () => true,
 };

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "Capacitor";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const CONFIG_FILE_PATTERNS: string[];
 export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/capacitor/index.js

@@ -1,8 +1,8 @@
 import { _load } from '../../util/loader.js';
 import { timerify } from '../../util/performance.js';
-export const isEnabled = ({ dependencies }) => {
-    return dependencies.has('@capacitor/core') || dependencies.has('@capacitor/cli');
-};
+export const NAME = 'Capacitor';
+export const ENABLERS = ['@capacitor/core', '@capacitor/cli'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = ['capacitor.config.ts'];
 const findCapacitorDependencies = async (configFilePath) => {
     const config = await _load(configFilePath);

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "Changesets";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const CONFIG_FILE_PATTERNS: string[];
 export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/changesets/index.js

@@ -1,6 +1,8 @@
 import { _load } from '../../util/loader.js';
 import { timerify } from '../../util/performance.js';
-export const isEnabled = ({ dependencies }) => dependencies.has('@changesets/cli');
+export const NAME = 'Changesets';
+export const ENABLERS = ['@changesets/cli'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = ['.changeset/config.json'];
 const findChangesetsDependencies = async (configFilePath) => {
     const config = await _load(configFilePath);

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "commitlint";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const CONFIG_FILE_PATTERNS: string[];
 export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/commitlint/index.js

@@ -1,6 +1,8 @@
 import { _load } from '../../util/loader.js';
 import { timerify } from '../../util/performance.js';
-export const isEnabled = ({ dependencies }) => dependencies.has('@commitlint/cli');
+export const NAME = 'commitlint';
+export const ENABLERS = ['@commitlint/cli'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = ['commitlint.config.{js,ts}'];
 const findCommitLintDependencies = async (configFilePath) => {
     const config = await _load(configFilePath);

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

@@ -1,3 +1,5 @@
 import type { IsPluginEnabledCallback } from '../../types/plugins.js';
+export declare const NAME = "Cypress";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const ENTRY_FILE_PATTERNS: string[];

package/dist/plugins/cypress/index.js

@@ -1,4 +1,6 @@
-export const isEnabled = ({ dependencies }) => dependencies.has('cypress');
+export const NAME = 'Cypress';
+export const ENABLERS = ['cypress'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const ENTRY_FILE_PATTERNS = [
     'cypress.config.{js,ts,mjs,cjs}',
     'cypress/support/e2e.{js,jsx,ts,tsx}',

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "ESLint";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const CONFIG_FILE_PATTERNS: string[];
 export declare const ENTRY_FILE_PATTERNS: string[];

package/dist/plugins/eslint/index.js

@@ -6,7 +6,9 @@ import { _load } from '../../util/loader.js';
 import { getPackageName } from '../../util/modules.js';
 import { timerify } from '../../util/performance.js';
 import { resolvePluginPackageName, customResolvePluginPackageNames, getDependenciesFromSettings } from './helpers.js';
-export const isEnabled = ({ dependencies }) => dependencies.has('eslint');
+export const NAME = 'ESLint';
+export const ENABLERS = ['eslint'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = ['.eslintrc', '.eslintrc.{js,json,cjs}', '.eslintrc.{yml,yaml}', 'package.json'];
 export const ENTRY_FILE_PATTERNS = ['eslint.config.js'];
 const findESLintDependencies = async (configFilePath, { cwd, manifest, workspaceConfig }) => {

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "Gatsby";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const CONFIG_FILE_PATTERNS: string[];
 export declare const PRODUCTION_ENTRY_FILE_PATTERNS: string[];

package/dist/plugins/gatsby/index.js

@@ -1,8 +1,8 @@
 import { _load } from '../../util/loader.js';
 import { timerify } from '../../util/performance.js';
-export const isEnabled = ({ dependencies }) => {
-    return dependencies.has('gatsby') || dependencies.has('gatsby-cli');
-};
+export const NAME = 'Gatsby';
+export const ENABLERS = ['gatsby', 'gatsby-cli'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = ['gatsby-{config,node}.{js,jsx,ts,tsx}'];
 export const PRODUCTION_ENTRY_FILE_PATTERNS = [
     'gatsby-{browser,ssr}.{js,jsx,ts,tsx}',

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+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[];

package/dist/plugins/jest/index.js

@@ -2,9 +2,9 @@ import path from 'node:path';
 import { _load } from '../../util/loader.js';
 import { getPackageName } from '../../util/modules.js';
 import { timerify } from '../../util/performance.js';
-export const isEnabled = ({ dependencies }) => {
-    return dependencies.has('jest');
-};
+export const NAME = 'Jest';
+export const ENABLERS = ['jest'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 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)'];
 const resolveExtensibleConfig = async (configFilePath) => {

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+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[];

package/dist/plugins/mocha/index.js

@@ -1,9 +1,9 @@
 import { _load } from '../../util/loader.js';
 import { getPackageName } from '../../util/modules.js';
 import { timerify } from '../../util/performance.js';
-export const isEnabled = ({ dependencies }) => {
-    return dependencies.has('mocha');
-};
+export const NAME = 'Mocha';
+export const ENABLERS = ['mocha'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = ['.mocharc.{js,cjs,json,jsonc,yml,yaml}', 'package.json'];
 export const ENTRY_FILE_PATTERNS = ['test/**/*.{js,cjs,mjs}'];
 const findMochaDependencies = async (configFilePath, { manifest }) => {

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback } from '../../types/plugins.js';
+export declare const NAME = "Next.js";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const ENTRY_FILE_PATTERNS: string[];
 export declare const PRODUCTION_ENTRY_FILE_PATTERNS: string[];

package/dist/plugins/next/index.js

@@ -1,5 +1,5 @@
-export const isEnabled = ({ dependencies }) => {
-    return dependencies.has('next');
-};
+export const NAME = 'Next.js';
+export const ENABLERS = ['next'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const ENTRY_FILE_PATTERNS = ['next.config.{js,ts}'];
 export const PRODUCTION_ENTRY_FILE_PATTERNS = ['pages/**/*.{js,jsx,ts,tsx}', 'src/pages/**/*.{js,jsx,ts,tsx}'];

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "Nx";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const CONFIG_FILE_PATTERNS: string[];
 export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/nx/index.js

@@ -1,9 +1,9 @@
 import { compact } from '../../util/array.js';
 import { _load } from '../../util/loader.js';
 import { timerify } from '../../util/performance.js';
-export const isEnabled = ({ dependencies }) => {
-    return dependencies.has('@nrwl/workspace');
-};
+export const NAME = 'Nx';
+export const ENABLERS = ['@nrwl/workspace'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = ['{apps,libs}/**/project.json'];
 const findNxDependencies = async (configFilePath) => {
     const config = await _load(configFilePath);

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "nyc";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const CONFIG_FILE_PATTERNS: string[];
 export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/nyc/index.js

@@ -1,6 +1,8 @@
 import { _load } from '../../util/loader.js';
 import { timerify } from '../../util/performance.js';
-export const isEnabled = ({ dependencies }) => dependencies.has('nyc');
+export const NAME = 'nyc';
+export const ENABLERS = ['nyc'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = ['.nycrc', '.nycrc.json', '.nycrc.{yml,yaml}', 'nyc.config.js'];
 const findNycDependencies = async (configFilePath) => {
     const config = await _load(configFilePath);

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

@@ -1,3 +1,5 @@
 import type { IsPluginEnabledCallback } from '../../types/plugins.js';
+export declare const NAME = "Playwright";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const ENTRY_FILE_PATTERNS: string[];

package/dist/plugins/playwright/index.js

@@ -1,2 +1,4 @@
-export const isEnabled = ({ dependencies }) => dependencies.has('@playwright/test');
+export const NAME = 'Playwright';
+export const ENABLERS = ['@playwright/test'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const ENTRY_FILE_PATTERNS = ['playwright.config.{js,ts}', '.*{test,spec}.{js,ts,mjs}'];

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

@@ -1,5 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "PostCSS";
+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 findDependencies: GenericPluginCallback;

package/dist/plugins/postcss/index.js

@@ -1,9 +1,10 @@
 import { _load } from '../../util/loader.js';
 import { getPackageName } from '../../util/modules.js';
 import { timerify } from '../../util/performance.js';
-export const isEnabled = ({ dependencies }) => dependencies.has('postcss');
+export const NAME = 'PostCSS';
+export const ENABLERS = ['postcss'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = ['postcss.config.js', 'package.json'];
-export const ENTRY_FILE_PATTERNS = ['postcss.config.js'];
 const findPostCSSDependencies = async (configFilePath, { manifest }) => {
     const config = configFilePath.endsWith('package.json')
         ? manifest?.postcss

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

@@ -1,5 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "Prettier";
+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 findDependencies: GenericPluginCallback;

package/dist/plugins/prettier/index.js

@@ -1,14 +1,15 @@
 import { _load } from '../../util/loader.js';
 import { getPackageName } from '../../util/modules.js';
 import { timerify } from '../../util/performance.js';
-export const isEnabled = ({ dependencies }) => dependencies.has('prettier');
+export const NAME = 'Prettier';
+export const ENABLERS = ['prettier'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = [
     '.prettierrc',
     '.prettierrc.{json,js,cjs,yml,yaml}',
     'prettier.config.{js,cjs}',
     'package.json',
 ];
-export const ENTRY_FILE_PATTERNS = ['.prettierrc.{js,cjs}', 'prettier.config.{js,cjs}'];
 const findPrettierDependencies = async (configFilePath, { manifest }) => {
     const config = configFilePath.endsWith('package.json')
         ? manifest.prettier

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "Remark";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const CONFIG_FILE_PATTERNS: string[];
 export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/remark/index.js

@@ -1,6 +1,8 @@
 import { load } from 'js-yaml';
 import { timerify } from '../../util/performance.js';
-export const isEnabled = ({ dependencies }) => dependencies.has('remark-cli');
+export const NAME = 'Remark';
+export const ENABLERS = ['remark-cli'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = [
     'package.json',
     '.remarkrc',

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback } from '../../types/plugins.js';
+export declare const NAME = "Remix";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const ENTRY_FILE_PATTERNS: string[];
 export declare const PRODUCTION_ENTRY_FILE_PATTERNS: string[];

package/dist/plugins/remix/index.js

@@ -1,6 +1,6 @@
-export const isEnabled = ({ dependencies }) => {
-    return dependencies.has('@remix-run/dev');
-};
+export const NAME = 'Remix';
+export const ENABLERS = ['@remix-run/dev'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const ENTRY_FILE_PATTERNS = ['remix.config.js', 'remix.init/index.js'];
 export const PRODUCTION_ENTRY_FILE_PATTERNS = [
     'app/root.tsx',

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

@@ -1,3 +1,5 @@
 import type { IsPluginEnabledCallback } from '../../types/plugins.js';
+export declare const NAME = "Rollup";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const ENTRY_FILE_PATTERNS: string[];

package/dist/plugins/rollup/index.js

@@ -1,2 +1,4 @@
-export const isEnabled = ({ dependencies }) => dependencies.has('rollup');
+export const NAME = 'Rollup';
+export const ENABLERS = ['rollup'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const ENTRY_FILE_PATTERNS = ['rollup.config.{js,mjs,ts}'];

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "Sentry";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const ENTRY_FILE_PATTERNS: string[];
 export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/sentry/index.js

@@ -1,6 +1,8 @@
 import { _load } from '../../util/loader.js';
 import { timerify } from '../../util/performance.js';
-export const isEnabled = ({ dependencies }) => dependencies.has('@sentry/replay');
+export const NAME = 'Sentry';
+export const ENABLERS = ['@sentry/replay'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const ENTRY_FILE_PATTERNS = ['sentry.{client,server}.config.{js,ts}'];
 const findNycDependencies = async (configFilePath) => {
     const config = await _load(configFilePath);

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "Storybook";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const CONFIG_FILE_PATTERNS: string[];
 export declare const ENTRY_FILE_PATTERNS: string[];

package/dist/plugins/storybook/index.js

@@ -4,9 +4,9 @@ import { _load } from '../../util/loader.js';
 import { getPackageName } from '../../util/modules.js';
 import { timerify } from '../../util/performance.js';
 const require = createRequire(process.cwd());
-export const isEnabled = ({ dependencies }) => {
-    return dependencies.has('@storybook/core') || dependencies.has('@nrwl/storybook');
-};
+export const NAME = 'Storybook';
+export const ENABLERS = ['@storybook/core', '@nrwl/storybook'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = ['.storybook/{main,manager}.{js,ts}'];
 export const ENTRY_FILE_PATTERNS = ['.storybook/preview.{js,jsx,ts,tsx}', '**/*.stories.{js,jsx,ts,tsx}'];
 export const PROJECT_FILE_PATTERNS = ['.storybook/**/*.{js,ts,tsx}'];

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "Stryker";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const CONFIG_FILE_PATTERNS: string[];
 export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/stryker/index.js

@@ -1,6 +1,8 @@
 import { _load } from '../../util/loader.js';
 import { timerify } from '../../util/performance.js';
-export const isEnabled = ({ dependencies }) => dependencies.has('@stryker-mutator/core');
+export const NAME = 'Stryker';
+export const ENABLERS = ['@stryker-mutator/core'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = ['?(.)stryker.{conf,config}.{js,mjs,json}'];
 const findStrykerDependencies = async (configFilePath) => {
     const config = await _load(configFilePath);

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

@@ -1,4 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
-export declare const CONFIG_FILE_PATTERNS: string[];
+export declare const NAME = "TypeScript";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
+export declare const CONFIG_FILE_PATTERNS: string[];
 export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/typescript/index.js

@@ -2,11 +2,13 @@ import { compact } from '../../util/array.js';
 import { _load } from '../../util/loader.js';
 import { getPackageName } from '../../util/modules.js';
 import { timerify } from '../../util/performance.js';
+export const NAME = 'TypeScript';
+export const ENABLERS = ['typescript'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = ['tsconfig.json'];
-export const isEnabled = ({ dependencies }) => dependencies.has('typescript');
 const findTypeScriptDependencies = async (configFilePath) => {
     const config = await _load(configFilePath);
-    const extend = config?.extends ? [getPackageName(config.extends)] : [];
+    const extend = config?.extends && !config.extends.startsWith('.') ? [getPackageName(config.extends)] : [];
     const plugins = compact(config?.compilerOptions?.plugins?.map(plugin => plugin.name) ?? []);
     return [...extend, ...plugins];
 };

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

@@ -1,5 +1,6 @@
 import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
-export declare const CONFIG_FILE_PATTERNS: string[];
-export declare const ENTRY_FILE_PATTERNS: string[];
+export declare const NAME = "Webpack";
+export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
+export declare const CONFIG_FILE_PATTERNS: string[];
 export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/webpack/index.js

@@ -1,9 +1,10 @@
 import { compact } from '../../util/array.js';
 import { _load } from '../../util/loader.js';
 import { timerify } from '../../util/performance.js';
+export const NAME = 'Webpack';
+export const ENABLERS = ['webpack'];
+export const isEnabled = ({ dependencies }) => ENABLERS.some(enabler => dependencies.has(enabler));
 export const CONFIG_FILE_PATTERNS = ['webpack.config*.js'];
-export const ENTRY_FILE_PATTERNS = ['webpack.config*.js'];
-export const isEnabled = ({ dependencies }) => dependencies.has('webpack');
 const resolveRuleSetLoaders = (rule) => {
     if (!rule || typeof rule === 'string')
         return [];

package/dist/types/cli.d.ts

@@ -5,5 +5,5 @@ export interface CommandLineOptions {
     isStrict: boolean;
     isProduction: boolean;
     isShowProgress: boolean;
-    isIgnoreEntryExports: boolean;
+    isIncludeEntryExports: boolean;
 }

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

@@ -0,0 +1,26 @@
+export declare const helpText = "knip [options]\n\nOptions:\n  -c/--config [file]       Configuration file path (default: knip.json, knip.jsonc 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  --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";
+declare const _default: {
+    values: {
+        config: string | undefined;
+        debug: boolean | undefined;
+        'debug-file-filter': string | undefined;
+        exclude: string[] | undefined;
+        help: boolean | undefined;
+        ignore: string[] | undefined;
+        'include-entry-exports': boolean | undefined;
+        include: string[] | undefined;
+        'max-issues': string | undefined;
+        'no-exit-code': boolean | undefined;
+        'no-gitignore': boolean | undefined;
+        'no-progress': boolean | undefined;
+        performance: boolean | undefined;
+        production: boolean | undefined;
+        reporter: string | undefined;
+        'reporter-options': string | undefined;
+        strict: boolean | undefined;
+        tsConfig: string | undefined;
+        workspace: string | undefined;
+    };
+    positionals: [];
+};
+export default _default;

package/dist/util/cli-arguments.js

@@ -0,0 +1,58 @@
+import { parseArgs } from 'node:util';
+export const helpText = `knip [options]
+
+Options:
+  -c/--config [file]       Configuration file path (default: knip.json, knip.jsonc 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)
+  --include-entry-exports  Include unused exports in entry files (without \`@public\`)
+  --ignore                 Ignore files matching this glob pattern, can be repeated
+  --no-gitignore           Don't use .gitignore
+  --include                Report only provided issue type(s), can be comma-separated or repeated (1)
+  --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)
+  --no-progress            Don't show dynamic progress updates
+  --reporter               Select reporter: symbols, compact, codeowners, json (default: symbols)
+  --reporter-options       Pass extra options to the reporter (as JSON string, see example)
+  --no-exit-code           Always exit with code zero (0)
+  --max-issues             Maximum number of issues before non-zero exit code (default: 0)
+  --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
+
+(1) Issue types: files, dependencies, unlisted, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates
+
+Examples:
+
+$ knip
+$ knip --production
+$ knip --workspace packages/client --include files,dependencies
+$ 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`;
+export default parseArgs({
+    options: {
+        config: { type: 'string', short: 'c' },
+        debug: { type: 'boolean' },
+        'debug-file-filter': { type: 'string' },
+        exclude: { type: 'string', multiple: true },
+        help: { type: 'boolean', short: 'h' },
+        ignore: { type: 'string', multiple: true },
+        'include-entry-exports': { type: 'boolean' },
+        include: { type: 'string', multiple: true },
+        'max-issues': { type: 'string' },
+        'no-exit-code': { type: 'boolean' },
+        'no-gitignore': { type: 'boolean' },
+        'no-progress': { type: 'boolean' },
+        performance: { type: 'boolean' },
+        production: { type: 'boolean' },
+        reporter: { type: 'string' },
+        'reporter-options': { type: 'string' },
+        strict: { type: 'boolean' },
+        tsConfig: { type: 'string', short: 't' },
+        workspace: { type: 'string' },
+    },
+});

package/dist/util/debug.js

@@ -1,5 +1,5 @@
 import util from 'node:util';
-import parsedArgs from './parseArgs.js';
+import parsedArgs from './cli-arguments.js';
 const { debug, 'debug-file-filter': debugFileFilter } = parsedArgs.values;
 const IS_ENABLED = debug ?? false;
 const FILE_FILTER = debugFileFilter;

package/dist/util/glob.js

@@ -2,6 +2,7 @@ import path from 'node:path';
 import fg from 'fast-glob';
 import { globby } from 'globby';
 import memoize from 'nano-memoize';
+import { ROOT_WORKSPACE_NAME } from '../constants.js';
 import { compact } from './array.js';
 import { debugLogObject } from './debug.js';
 import { timerify } from './performance.js';
@@ -22,8 +23,11 @@ const glob = async ({ cwd, workingDir = cwd, patterns, ignore = [], gitignore =
     const relativePath = path.posix.relative(cwdPosix, workingDirPosix);
     const prepend = (pattern) => prependDirToPattern(relativePath, pattern);
     const globPatterns = compact([patterns].flat().map(prepend).map(removeProductionSuffix)).sort(negatedLast);
-    const ignorePatterns = [...ignore, '**/node_modules/**'];
-    debugLogObject("Globbin'", { cwd, globPatterns, ignorePatterns });
+    const ignorePatterns = compact([
+        ...ignore.map(pattern => prependDirToPattern(relativePath, pattern)),
+        '**/node_modules/**',
+    ]);
+    debugLogObject(`Globbing (${relativePath || ROOT_WORKSPACE_NAME})`, { cwd, globPatterns, ignorePatterns });
     return globby(globPatterns, {
         cwd,
         ignore: ignorePatterns,

package/dist/util/loader.js

@@ -3,8 +3,8 @@ import { createRequire } from 'node:module';
 import path from 'node:path';
 import { load as esmLoad } from '@esbuild-kit/esm-loader';
 import yaml from 'js-yaml';
+import parsedArgs from './cli-arguments.js';
 import { loadJSON } from './fs.js';
-import parsedArgs from './parseArgs.js';
 import { timerify } from './performance.js';
 const require = createRequire(process.cwd());
 const { values: { 'no-progress': noProgress = false }, } = parsedArgs;

package/dist/util/performance.js

@@ -1,7 +1,7 @@
 import { performance, PerformanceObserver } from 'node:perf_hooks';
 import EasyTable from 'easy-table';
 import prettyMilliseconds from 'pretty-ms';
-import parsedArgs from './parseArgs.js';
+import parsedArgs from './cli-arguments.js';
 import Summary from 'summary';
 const { values } = parsedArgs;
 const { performance: isEnabled = false } = values;

package/dist/util/resolve-included-issue-types.d.ts

@@ -1,7 +1,6 @@
 import type { Report } from '../types/issues.js';
 type Options = {
     isProduction?: boolean;
-    isStrict?: boolean;
     include?: string[];
     exclude?: string[];
 };

package/dist/workspace-worker.js

@@ -47,14 +47,15 @@ export default class WorkspaceWorker {
         const dependencies = new Set([this.manifest, ...this.ancestorManifests]
             .flatMap(manifest => [Object.keys(manifest?.dependencies ?? {}), Object.keys(manifest?.devDependencies ?? {})])
             .flat());
-        for (const [pluginName, plugin] of Object.entries(plugins)) {
+        const pluginEntries = Object.entries(plugins);
+        for (const [pluginName, plugin] of pluginEntries) {
             const hasIsEnabled = typeof plugin.isEnabled === 'function';
             this.enabled[pluginName] =
                 this.config[pluginName] !== false &&
                     hasIsEnabled &&
                     plugin.isEnabled({ manifest: this.manifest, dependencies });
         }
-        const enabledPlugins = Object.keys(this.enabled).filter(k => this.enabled[k]);
+        const enabledPlugins = pluginEntries.filter(([name]) => this.enabled[name]).map(([, plugin]) => plugin.NAME);
         debugLogObject(`Enabled plugins (${this.name})`, enabledPlugins);
     }
     async initReferencedDependencies() {
@@ -201,7 +202,7 @@ export default class WorkspaceWorker {
             if (this.enabled[pluginName] && isIncludePlugin) {
                 const hasDependencyFinder = 'findDependencies' in plugin && typeof plugin.findDependencies === 'function';
                 if (hasDependencyFinder) {
-                    const dependencies = await this.findDependenciesByPlugin(pluginName, plugin.findDependencies);
+                    const dependencies = await this.findDependenciesByPlugin(pluginName, plugin.NAME, plugin.findDependencies);
                     dependencies.forEach(dependency => this.referencedDependencyIssues.add(dependency));
                     dependencies.forEach(dependency => this.referencedDependencies.add(dependency.symbol));
                 }
@@ -212,7 +213,7 @@ export default class WorkspaceWorker {
             referencedDependencies: this.referencedDependencies,
         };
     }
-    async findDependenciesByPlugin(pluginName, pluginCallback) {
+    async findDependenciesByPlugin(pluginName, pluginTitle, pluginCallback) {
         const pluginConfig = this.getConfigForPlugin(pluginName);
         if (!pluginConfig)
             return [];
@@ -220,7 +221,7 @@ export default class WorkspaceWorker {
         const cwd = this.dir;
         const ignore = this.getWorkspaceIgnorePatterns();
         const configFilePaths = await _pureGlob({ patterns, cwd, ignore });
-        debugLogFiles(`Globbed ${pluginName} config file paths`, configFilePaths);
+        debugLogFiles(`Globbed ${pluginTitle} config file paths`, configFilePaths);
         if (configFilePaths.length === 0)
             return [];
         const referencedDependencyIssues = (await Promise.all(configFilePaths.map(async (configFilePath) => {
@@ -232,7 +233,7 @@ export default class WorkspaceWorker {
             });
             return dependencies.map(symbol => ({ type: 'unlisted', filePath: configFilePath, symbol }));
         }))).flat();
-        debugLogIssues(`Dependencies used by ${pluginName} configuration`, referencedDependencyIssues);
+        debugLogIssues(`Dependencies used by ${pluginTitle} configuration`, referencedDependencyIssues);
         return referencedDependencyIssues;
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "1.0.0-beta.4",
+  "version": "1.0.0-beta.6",
   "description": "Find unused files, dependencies and exports in your TypeScript and JavaScript project",
   "keywords": [
     "find",
@@ -32,19 +32,20 @@
   },
   "type": "module",
   "scripts": {
-    "preknip": "npm run build",
     "knip": "node ./dist/cli.js",
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",
     "test": "globstar -- node --loader tsx --test \"test/**/*.spec.ts\"",
     "watch": "tsc --watch",
-    "build": "rm -rf dist && tsc",
-    "prepublishOnly": "npm test && npm run build && npm run knip",
-    "format": "remark README.md -o",
+    "prebuild": "rm -rf dist",
+    "build": "tsc",
+    "docs": "npm run docs:cli && npm run docs:plugins && npm run docs:format",
+    "docs:cli": "tsx ./scripts/update-cli-usage-in-readme.ts",
+    "docs:plugins": "tsx ./scripts/generate-plugin-docs.ts",
+    "docs:format": "remark README.md src/plugins/*/README.md -o",
     "release": "release-it",
     "postinstall": "patch-package",
-    "add-plugin:help": "echo 'Usage: npm run add-plugin --name=[name] (and update README.md and schema.json)'",
-    "add-plugin": "cp -R src/plugins/_template src/plugins/$npm_config_name && echo \"export * as $npm_config_name from \\\"./$npm_config_name/index.js\\\";\" >> src/plugins/index.ts"
+    "create-plugin": "tsx ./scripts/create-new-plugin.ts"
   },
   "files": [
     "dist",
@@ -63,7 +64,7 @@
     "easy-table": "1.2.0",
     "esbuild": "0.16.12",
     "esbuild-register": "3.4.2",
-    "eslint": "8.30.0",
+    "eslint": "8.31.0",
     "fast-glob": "3.2.12",
     "globby": "13.1.3",
     "js-yaml": "4.1.0",
@@ -99,6 +100,14 @@
     "typescript": "4.9.4"
   },
   "release-it": {
+    "hooks": {
+      "before:init": [
+        "npm run build",
+        "npm run knip",
+        "npm run docs",
+        "npm test"
+      ]
+    },
     "github": {
       "release": true
     }

package/dist/util/help.d.ts

@@ -1 +0,0 @@
-export declare const printHelp: () => void;

package/dist/util/help.js

@@ -1,36 +0,0 @@
-export const printHelp = () => {
-    console.log(`knip [options]
-
-Options:
-  -c/--config [file]     Configuration file path (default: ./knip.json, knip.jsonc 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 workspaces. Not devDependencies, not ancestor workspaces.
-  --workspace            Analyze a single workspace (default: analyze all configured workspaces)
-  --include              Report only listed issue type(s), can be comma-separated or repeated
-  --exclude              Exclude issue type(s) from report, can be comma-separated or repeated
-  --ignore               Ignore files matching this glob pattern, can be repeated
-  --ignore-entry-exports Ignore exports from entry files
-  --no-gitignore         Don't use .gitignore
-  --no-progress          Don't show dynamic progress updates
-  --no-exit-code         Always exit with code zero (0)
-  --max-issues           Maximum number of issues before non-zero exit code (default: 0)
-  --reporter             Select reporter: symbols, compact, codeowners, json (default: symbols)
-  --reporter-options     Pass extra options to the reporter (as JSON string, see example)
-  --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
-
-Issue types: files, dependencies, unlisted, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates
-
-Examples:
-
-$ knip
-$ knip --production
-$ knip --workspace packages/client --include files,dependencies
-$ 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`);
-};

package/dist/util/parseArgs.d.ts

@@ -1,25 +0,0 @@
-declare const _default: {
-    values: {
-        config: string | undefined;
-        debug: boolean | undefined;
-        'debug-file-filter': string | undefined;
-        exclude: string[] | undefined;
-        help: boolean | undefined;
-        ignore: string[] | undefined;
-        'ignore-entry-exports': boolean | undefined;
-        include: string[] | undefined;
-        'max-issues': string | undefined;
-        'no-exit-code': boolean | undefined;
-        'no-gitignore': boolean | undefined;
-        'no-progress': boolean | undefined;
-        performance: boolean | undefined;
-        production: boolean | undefined;
-        reporter: string | undefined;
-        'reporter-options': string | undefined;
-        strict: boolean | undefined;
-        tsConfig: string | undefined;
-        workspace: string | undefined;
-    };
-    positionals: [];
-};
-export default _default;

package/dist/util/parseArgs.js

@@ -1,24 +0,0 @@
-import { parseArgs } from 'node:util';
-export default parseArgs({
-    options: {
-        config: { type: 'string', short: 'c' },
-        debug: { type: 'boolean' },
-        'debug-file-filter': { type: 'string' },
-        exclude: { type: 'string', multiple: true },
-        help: { type: 'boolean', short: 'h' },
-        ignore: { type: 'string', multiple: true },
-        'ignore-entry-exports': { type: 'boolean' },
-        include: { type: 'string', multiple: true },
-        'max-issues': { type: 'string' },
-        'no-exit-code': { type: 'boolean' },
-        'no-gitignore': { type: 'boolean' },
-        'no-progress': { type: 'boolean' },
-        performance: { type: 'boolean' },
-        production: { type: 'boolean' },
-        reporter: { type: 'string' },
-        'reporter-options': { type: 'string' },
-        strict: { type: 'boolean' },
-        tsConfig: { type: 'string', short: 't' },
-        workspace: { type: 'string' },
-    },
-});