knip 1.1.0 → 1.3.0

package/README.md

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

package/dist/configuration-chief.js

@@ -2,21 +2,19 @@ import path from 'node:path';
 import mapWorkspaces from '@npmcli/map-workspaces';
 import micromatch from 'micromatch';
 import { ConfigurationValidator } from './configuration-validator.js';
-import { ROOT_WORKSPACE_NAME } from './constants.js';
+import { ROOT_WORKSPACE_NAME, DEFAULT_WORKSPACE_CONFIG, KNIP_CONFIG_LOCATIONS } 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 { _load } from './util/loader.js';
+import { toCamelCase } from './util/plugin.js';
 import { resolveIncludedIssueTypes } from './util/resolve-included-issue-types.js';
 import { byPathDepth } from './util/workspace.js';
 const { values: { config: rawConfigArg, workspace: rawWorkspaceArg, include = [], exclude = [], dependencies = false, exports = false, }, } = parsedArgs;
-const defaultWorkspaceConfig = {
-    entry: ['index.{js,ts,tsx}!', 'src/index.{js,ts,tsx}!'],
-    project: ['**/*.{js,ts,tsx}!'],
-    ignore: [],
-};
+const defaultWorkspaceConfig = DEFAULT_WORKSPACE_CONFIG;
 const defaultConfig = {
     include: [],
     exclude: [],
@@ -49,12 +47,16 @@ export default class ConfigurationChief {
         }
         this.manifestPath = manifestPath;
         this.manifest = manifest;
-        const configFilePath = rawConfigArg ?? 'knip.json';
-        const resolvedConfigFilePath = (await findFile(this.cwd, configFilePath)) ?? (!rawConfigArg && (await findFile(this.cwd, configFilePath + 'c')));
+        let resolvedConfigFilePath;
+        for (const configPath of rawConfigArg ? [rawConfigArg] : KNIP_CONFIG_LOCATIONS) {
+            resolvedConfigFilePath = await findFile(this.cwd, configPath);
+            if (resolvedConfigFilePath)
+                break;
+        }
         if (rawConfigArg && !resolvedConfigFilePath && !manifest.knip) {
             throw new ConfigurationError(`Unable to find ${rawConfigArg} or package.json#knip`);
         }
-        const rawLocalConfig = resolvedConfigFilePath ? await loadJSON(resolvedConfigFilePath) : manifest.knip;
+        const rawLocalConfig = resolvedConfigFilePath ? await _load(resolvedConfigFilePath) : manifest.knip;
         if (rawLocalConfig) {
             this.config = this.normalize(ConfigurationValidator.parse(rawLocalConfig));
         }
@@ -94,16 +96,17 @@ export default class ConfigurationChief {
                     ignore: arrayify(workspaceConfig.ignore),
                 };
                 for (const [pluginName, pluginConfig] of Object.entries(workspaceConfig)) {
-                    if (PLUGIN_NAMES.includes(pluginName)) {
+                    const name = toCamelCase(pluginName);
+                    if (PLUGIN_NAMES.includes(name)) {
                         if (pluginConfig === false) {
-                            workspaces[workspaceName][pluginName] = false;
+                            workspaces[workspaceName][name] = false;
                         }
                         else {
                             const isObject = typeof pluginConfig !== 'string' && !Array.isArray(pluginConfig);
                             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] = {
+                            workspaces[workspaceName][name] = {
                                 config,
                                 entry,
                                 project,

package/dist/configuration-validator.d.ts

@@ -158,6 +158,19 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         }>]>>;
+        'npm-package-json-lint': z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
+            config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+            entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+            project: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        }, "strip", z.ZodTypeAny, {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        }, {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        }>]>>;
         nx: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
             config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
             entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
@@ -399,6 +412,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'npm-package-json-lint'?: string | false | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         nx?: string | false | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -528,6 +546,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'npm-package-json-lint'?: string | false | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         nx?: string | false | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -743,6 +766,19 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
     }>]>>;
+    'npm-package-json-lint': z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
+        config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        project: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    }, "strip", z.ZodTypeAny, {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    }, {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    }>]>>;
     nx: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
         config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
         entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
@@ -989,6 +1025,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
     } | undefined;
+    'npm-package-json-lint'?: string | false | string[] | {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    } | undefined;
     nx?: string | false | string[] | {
         config?: string | string[] | undefined;
         entry?: string | string[] | undefined;
@@ -1118,6 +1159,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'npm-package-json-lint'?: string | false | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         nx?: string | false | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -1253,6 +1299,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
     } | undefined;
+    'npm-package-json-lint'?: string | false | string[] | {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    } | undefined;
     nx?: string | false | string[] | {
         config?: string | string[] | undefined;
         entry?: string | string[] | undefined;
@@ -1382,6 +1433,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'npm-package-json-lint'?: string | false | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         nx?: string | false | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;

package/dist/configuration-validator.js

@@ -33,6 +33,7 @@ const pluginsSchema = z.object({
     'lint-staged': pluginSchema,
     mocha: pluginSchema,
     next: pluginSchema,
+    'npm-package-json-lint': pluginSchema,
     nx: pluginSchema,
     nyc: pluginSchema,
     playwright: pluginSchema,

package/dist/constants.d.ts

@@ -1,5 +1,11 @@
 import type { IssueType } from './types/issues.js';
 export declare const ROOT_WORKSPACE_NAME = ".";
+export declare const KNIP_CONFIG_LOCATIONS: string[];
+export declare const DEFAULT_WORKSPACE_CONFIG: {
+    entry: string[];
+    project: string[];
+    ignore: never[];
+};
 export declare const TEST_FILE_PATTERNS: string[];
 export declare const IGNORED_GLOBAL_BINARIES: string[];
 export declare const IGNORE_DEFINITELY_TYPED: string[];

package/dist/constants.js

@@ -1,4 +1,10 @@
 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_WORKSPACE_CONFIG = {
+    entry: ['index.{js,ts,tsx}!', 'src/index.{js,ts,tsx}!'],
+    project: ['**/*.{js,ts,tsx}!'],
+    ignore: [],
+};
 export const TEST_FILE_PATTERNS = ['**/*.{test,spec}.{js,jsx,ts,tsx}', '**/__tests__/**/*.{js,jsx,ts,tsx}'];
 export const IGNORED_GLOBAL_BINARIES = ['npm', 'npx', 'node', 'yarn', 'pnpm', 'deno', 'git'];
 export const IGNORE_DEFINITELY_TYPED = ['node'];

package/dist/manifest/helpers.js

@@ -1,14 +1,10 @@
 import path from 'node:path';
 import { FIRST_ARGUMENT_AS_BINARY_EXCEPTIONS } from '../constants.js';
+import { getArgumentValues } from '../util/plugin.js';
 import { require } from '../util/require.js';
 const normalizeBinaries = (command) => command.replace(/(\.\/)?node_modules\/\.bin\/(\w+)/, '$2').replace(/\$\(npm bin\)\/(\w+)/, '$1');
 const stripEnvironmentVariables = (value) => value.replace(/([A-Z][^ ]*)=([^ ])+ /g, '');
-const getLoaderArgumentValues = (value) => {
-    const match = value.match(/ (--(experimental-)?loader|--require|-r)[ =]([^ ]+)/g);
-    if (match)
-        return match.map(value => value.trim().split(/[ =]/)[1].trim());
-    return [];
-};
+const getLoaderArgumentValues = (value) => getArgumentValues(value, / (--(experimental-)?loader|--require|-r)[ =]([^ ]+)/g);
 const getDependenciesFromLoaderArguments = (args) => getLoaderArgumentValues(' ' + args.join(' '))
     .filter(scripts => !scripts.startsWith('.'))
     .map(script => {

package/dist/plugins/index.d.ts

@@ -7,8 +7,10 @@ export * as eslint from './eslint/index.js';
 export * as gatsby from './gatsby/index.js';
 export * as jest from './jest/index.js';
 export * as lintStaged from './lint-staged/index.js';
+export * as markdownlint from './markdownlint/index.js';
 export * as mocha from './mocha/index.js';
 export * as next from './next/index.js';
+export * as npmPackageJsonLint from './npm-package-json-lint/index.js';
 export * as nx from './nx/index.js';
 export * as nyc from './nyc/index.js';
 export * as playwright from './playwright/index.js';

package/dist/plugins/index.js

@@ -7,8 +7,10 @@ export * as eslint from './eslint/index.js';
 export * as gatsby from './gatsby/index.js';
 export * as jest from './jest/index.js';
 export * as lintStaged from './lint-staged/index.js';
+export * as markdownlint from './markdownlint/index.js';
 export * as mocha from './mocha/index.js';
 export * as next from './next/index.js';
+export * as npmPackageJsonLint from './npm-package-json-lint/index.js';
 export * as nx from './nx/index.js';
 export * as nyc from './nyc/index.js';
 export * as playwright from './playwright/index.js';

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

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

@@ -0,0 +1,20 @@
+import { _load } from '../../util/loader.js';
+import { getPackageName } from '../../util/modules.js';
+import { timerify } from '../../util/performance.js';
+import { hasDependency, getArgumentValues } from '../../util/plugin.js';
+export const NAME = 'markdownlint';
+export const ENABLERS = ['markdownlint-cli'];
+export const isEnabled = ({ dependencies }) => hasDependency(dependencies, ENABLERS);
+export const CONFIG_FILE_PATTERNS = ['.markdownlint.{json,jsonc}', '.markdownlint.{yml,yaml}'];
+const findMarkdownlintConfigDependencies = async (configFilePath, { manifest }) => {
+    const config = await _load(configFilePath);
+    const extend = config?.extends ? [getPackageName(config.extends)] : [];
+    const scripts = manifest.scripts
+        ? Object.values(manifest.scripts).filter((script) => typeof script === 'string')
+        : [];
+    const uses = scripts
+        .filter(script => script.includes('markdownlint '))
+        .flatMap(script => getArgumentValues(script, / (--rules|-r)[ =]([^ ]+)/g));
+    return [...extend, ...uses];
+};
+export const findDependencies = timerify(findMarkdownlintConfigDependencies);

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

@@ -0,0 +1,3 @@
+export type MarkdownlintConfig = {
+    extends?: string;
+};

package/dist/plugins/markdownlint/types.js

@@ -0,0 +1 @@
+export {};

package/dist/plugins/npm-package-json-lint/index.d.ts

@@ -0,0 +1,6 @@
+import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "npm-package-json-lint";
+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/npm-package-json-lint/index.js

@@ -0,0 +1,14 @@
+import { _load } from '../../util/loader.js';
+import { timerify } from '../../util/performance.js';
+import { hasDependency } from '../../util/plugin.js';
+export const NAME = 'npm-package-json-lint';
+export const ENABLERS = ['npm-package-json-lint'];
+export const isEnabled = ({ dependencies }) => hasDependency(dependencies, ENABLERS);
+export const CONFIG_FILE_PATTERNS = ['.npmpackagejsonlintrc.json', 'npmpackagejsonlint.config.js', 'package.json'];
+const findNpmPkgJsonLintConfigDependencies = async (configFilePath, { manifest }) => {
+    const config = configFilePath.endsWith('package.json')
+        ? manifest.npmpackagejsonlint
+        : await _load(configFilePath);
+    return config?.extends ? [config.extends] : [];
+};
+export const findDependencies = timerify(findNpmPkgJsonLintConfigDependencies);

package/dist/plugins/npm-package-json-lint/types.d.ts

@@ -0,0 +1,3 @@
+export type NpmPkgJsonLintConfig = {
+    extends?: string;
+};

package/dist/plugins/npm-package-json-lint/types.js

@@ -0,0 +1 @@
+export {};

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, 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  --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 = "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";
 declare const _default: {
     values: {
         config: string | undefined;

package/dist/util/cli-arguments.js

@@ -2,7 +2,7 @@ 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)
+  -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)

package/dist/util/loader.js

@@ -8,7 +8,7 @@ import { logIfDebug } from './log.js';
 import { timerify } from './performance.js';
 const load = async (filePath) => {
     try {
-        if (path.extname(filePath) === '.json' || /rc$/.test(filePath)) {
+        if (/\.jsonc?$/.test(filePath) || /rc$/.test(filePath)) {
             return loadJSON(filePath);
         }
         if (path.extname(filePath) === '.yaml' || path.extname(filePath) === '.yml') {

package/dist/util/plugin.d.ts

@@ -1 +1,3 @@
+export declare const toCamelCase: (name: string) => string;
+export declare const getArgumentValues: (value: string, matcher: RegExp) => string[];
 export declare const hasDependency: (dependencies: Set<string>, values: (string | RegExp)[]) => boolean;

package/dist/util/plugin.js

@@ -1,3 +1,10 @@
+export const toCamelCase = (name) => name.toLowerCase().replace(/(-[a-z])/g, group => group.toUpperCase().replace('-', ''));
+export const getArgumentValues = (value, matcher) => {
+    const match = value.match(matcher);
+    if (match)
+        return match.map(value => value.trim().split(/[ =]/)[1].trim());
+    return [];
+};
 export const hasDependency = (dependencies, values) => values.some(value => {
     if (typeof value === 'string') {
         return dependencies.has(value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Find unused files, dependencies and exports in your TypeScript and JavaScript projects",
   "homepage": "https://github.com/webpro/knip",
   "repository": "github:webpro/knip",
@@ -42,7 +42,7 @@
     "@snyk/github-codeowners": "1.1.0",
     "chalk": "5.2.0",
     "easy-table": "1.2.0",
-    "esbuild": "0.16.16",
+    "esbuild": "0.16.17",
     "esbuild-register": "3.4.2",
     "eslint": "8.31.0",
     "fast-glob": "3.2.12",

package/schema.json

@@ -192,6 +192,10 @@
           "title": "lint-staged plugin configuration (https://github.com/webpro/knip/blob/main/src/plugins/lint-staged/README.md)",
           "$ref": "#/definitions/plugin"
         },
+        "markdownlint": {
+          "title": "markdownlint plugin configuration (https://github.com/webpro/knip/blob/main/src/plugins/markdownlint/README.md)",
+          "$ref": "#/definitions/plugin"
+        },
         "mocha": {
           "title": "Mocha plugin configuration (https://github.com/webpro/knip/blob/main/src/plugins/mocha/README.md)",
           "$ref": "#/definitions/plugin"
@@ -200,6 +204,10 @@
           "title": "Next.js plugin configuration (https://github.com/webpro/knip/blob/main/src/plugins/main/README.md)",
           "$ref": "#/definitions/plugin"
         },
+        "npm-package-json-lint": {
+          "title": "npm-package-json-lint plugin configuration (https://github.com/webpro/knip/blob/main/src/plugins/npm-package-json-lint/README.md)",
+          "$ref": "#/definitions/plugin"
+        },
         "nx": {
           "title": "Nx plugin configuration (https://github.com/webpro/knip/blob/main/src/plugins/nx/README.md)",
           "$ref": "#/definitions/plugin"