@knip/mcp 0.0.21 → 0.0.23

package/src/docs/docs/reference/plugins/vitest.md

@@ -0,0 +1,72 @@
+---
+title: Vitest
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"vitest"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "vitest": {
+    "config": [
+      "vitest.config.{js,mjs,ts,cjs,mts,cts}",
+      "vitest.{workspace,projects}.{js,mjs,ts,cjs,mts,cts,json}"
+    ],
+    "entry": [
+      "**/*.{bench,test,test-d,spec,spec-d}.?(c|m)[jt]s?(x)",
+      "**/__mocks__/**/*.[jt]s?(x)"
+    ]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins][1] for more details about plugins and their `entry` and `config` options.
+
+## Shell commands
+
+This plugin adds argument parsing for the <code>vitest</code>
+binary. Configuration:
+
+```
+config: true
+resolveInputs: (parsed            ) => {
+    const inputs          = [];
+    if (parsed['ui']) inputs.push(toDependency('@vitest/ui', { optional: true }));
+    if (typeof parsed['coverage'] === 'object' && parsed['coverage'].provider) {
+      inputs.push(toDependency(`@vitest/coverage-${parsed['coverage'].provider}`));
+    }
+    if (parsed['reporter']) {
+      for (const reporter of getExternalReporters([parsed['reporter']].flat())) {
+        inputs.push(toDependency(reporter));
+      }
+    }
+    if (parsed['environment'] && parsed['environment'] !== 'node') {
+      inputs.push(toDependency(getEnvSpecifier(parsed['environment'])));
+    }
+    if (typeof parsed['typecheck'] === 'object' && parsed['typecheck'].checker) {
+      inputs.push(toDependency(parsed['typecheck'].checker === 'tsc' ? 'typescript' : parsed['typecheck'].checker));
+    }
+    return inputs;
+  }
+```
+
+The configuration was generated from source code. Also see [Script Parser][2].
+
+## Generated from source
+
+This page was generated from the [vitest plugin source code][3].
+
+[1]: ../../explanations/plugins.md
+[2]: ../../features/script-parser.md
+[3]: https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/vitest/index.ts

package/src/docs/docs/reference/plugins/vue.md

@@ -0,0 +1,34 @@
+---
+title: Vue
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"vue"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "vue": {
+    "config": ["vue.config.{js,ts,mjs}"]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins][1] for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [vue plugin source code][2].
+
+[1]: ../../explanations/plugins.md
+[2]: https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/vue/index.ts

package/src/docs/docs/reference/plugins/webdriver-io.md

@@ -0,0 +1,34 @@
+---
+title: WebdriverIO
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"@wdio/cli"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "webdriver-io": {
+    "config": ["wdio.conf.{js,ts}"]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins][1] for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [webdriver-io plugin source code][2].
+
+[1]: ../../explanations/plugins.md
+[2]: https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/webdriver-io/index.ts

package/src/docs/docs/reference/plugins/webpack.md

@@ -0,0 +1,55 @@
+---
+title: webpack
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if there's a match in `"dependencies"` or `"devDependencies"` in `package.json`:
+
+- `webpack`
+
+- `webpack-cli`
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "webpack": {
+    "config": ["webpack.config.{js,ts,mjs,cjs,mts,cts}"]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins][1] for more details about plugins and their `entry` and `config` options.
+
+## Shell commands
+
+This plugin adds argument parsing for the <code>webpack and webpack-dev-server</code>
+binaries. Configuration:
+
+```
+config: true
+resolveInputs: (parsed            ) => {
+    const inputs          = [toDependency('webpack-cli')];
+    if (parsed._[0] === 'serve') inputs.push(toDependency('webpack-dev-server'));
+    return inputs;
+  }
+```
+
+The configuration was generated from source code. Also see [Script Parser][2].
+
+## Generated from source
+
+This page was generated from the [webpack plugin source code][3].
+
+[1]: ../../explanations/plugins.md
+[2]: ../../features/script-parser.md
+[3]: https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/webpack/index.ts

package/src/docs/docs/reference/plugins/wireit.md

@@ -0,0 +1,34 @@
+---
+title: Wireit
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"wireit"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "wireit": {
+    "config": ["package.json"]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins][1] for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [wireit plugin source code][2].
+
+[1]: ../../explanations/plugins.md
+[2]: https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/wireit/index.ts

package/src/docs/docs/reference/plugins/wrangler.md

@@ -0,0 +1,34 @@
+---
+title: Wrangler
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"wrangler"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "wrangler": {
+    "config": ["wrangler.{json,jsonc,toml}"]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins][1] for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [wrangler plugin source code][2].
+
+[1]: ../../explanations/plugins.md
+[2]: https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/wrangler/index.ts

package/src/docs/docs/reference/plugins/xo.md

@@ -0,0 +1,40 @@
+---
+title: xo
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"xo"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "xo": {
+    "config": [
+      "package.json",
+      ".xo-config",
+      ".xo-config.{js,cjs,json}",
+      "xo.config.{js,cjs}"
+    ],
+    "entry": [".xo-config.{js,cjs}", "xo.config.{js,cjs}"]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins][1] for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [xo plugin source code][2].
+
+[1]: ../../explanations/plugins.md
+[2]: https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/xo/index.ts

package/src/docs/docs/reference/plugins/yarn.md

@@ -0,0 +1,35 @@
+---
+title: Yarn
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled when a `yarn.lock` file is found in the root folder.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "yarn": {
+    "config": [".yarnrc.yml"],
+    "entry": ["yarn.config.cjs"]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins][1] for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [yarn plugin source code][2].
+
+[1]: ../../explanations/plugins.md
+[2]: https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/yarn/index.ts

package/src/docs/docs/reference/plugins/yorkie.md

@@ -0,0 +1,34 @@
+---
+title: yorkie
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"yorkie"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "yorkie": {
+    "config": ["package.json"]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins][1] for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [yorkie plugin source code][2].
+
+[1]: ../../explanations/plugins.md
+[2]: https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/yorkie/index.ts

package/src/docs/docs/reference/plugins/zx.md

@@ -0,0 +1,15 @@
+---
+title: zx
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"zx"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Generated from source
+
+This page was generated from the [zx plugin source code][1].
+
+[1]: https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/zx/index.ts

package/src/docs/docs/typescript/unused-exports.md

@@ -55,9 +55,9 @@ them to ensure no unintended modifications were made.
 
 ## Can Knip handle large codebases?
 
-Absolutely. Knip supports [monorepos with workspaces][5] and utilizes [workspace
-sharing][6] to efficiently analyze large monorepos. This makes it easier and
-more fun to manage and optimize large multi-package projects.
+Absolutely. Knip supports [monorepos with workspaces][5] to efficiently analyze
+large monorepos. This makes it easier and more fun to manage and optimize large
+multi-package projects.
 
 ## Does Knip work with my favorite editor or IDE?
 
@@ -70,18 +70,17 @@ to easily navigate around.
 
 While linters like ESLint can find unused imports and variables within
 individual files, Knip analyzes the entire project to determine which exports
-are actually unused. By building [a comprehensive module graph][7], Knip
+are actually unused. By building [a comprehensive module graph][6], Knip
 identifies exports that are not imported or used anywhere in the codebase. This
 allows Knip to catch unused exports and dead code that ESLint and other linters
 would miss.
 
-Also see [Why isn't Knip an ESLint plugin?][8]
+Also see [Why isn't Knip an ESLint plugin?][7]
 
 [1]: ../overview/getting-started.mdx
 [2]: ../reference/faq.md#what-does-knip-look-for-in-source-files
 [3]: ../guides/working-with-commonjs.md
 [4]: ../features/auto-fix.mdx
 [5]: ../features/monorepos-and-workspaces.md
-[6]: ../guides/performance.md#workspace-sharing
-[7]: ../reference/faq.md#whats-in-the-graphs
-[8]: ../reference/faq.md#why-isnt-knip-an-eslint-plugin
+[6]: ../reference/faq.md#whats-in-the-graphs
+[7]: ../reference/faq.md#why-isnt-knip-an-eslint-plugin

package/src/docs/docs/writing-a-plugin/argument-parsing.md

@@ -190,8 +190,7 @@ returned as numbers by minimist.
 [3]: #boolean
 [4]: #string
 [5]: https://github.com/webpro-nl/knip/blob/main/packages/knip/src/types/args.ts
-[6]:
-  https://github.com/search?q=repo%3Awebpro-nl%2Fknip++path%3Apackages%2Fknip%2Fsrc%2Fplugins+%22const+args+%3D%22&type=code
+[6]: https://github.com/search?q=repo%3Awebpro-nl%2Fknip++path%3Apackages%2Fknip%2Fsrc%2Fplugins+%22const+args+%3D%22&type=code
 [7]: #args
 [8]: #binaries
 [9]: #config

package/src/docs/docs/writing-a-plugin/index.md

@@ -251,20 +251,20 @@ This is why plugins can implement the `resolveFromAST` function.
 ### 8. resolveFromAST
 
 Let's take a look at the Astro plugin implementation. This example assumes some
-familiarity with Abstract Syntax Trees (AST) and the TypeScript compiler API.
-Knip will provide more and more AST helpers to make implementing plugins more
-fun and a little less tedious.
+familiarity with Abstract Syntax Trees (AST). Knip provides AST helpers to make
+implementing plugins more fun and a little less tedious.
 
 Anyway, let's dive in. Here's how we're adding the Starlight `components` paths
 to the default `production` file patterns:
 
 ```ts
-import ts from 'typescript';
+import type { Program } from 'oxc-parser';
 import {
+  findCallArg,
   getDefaultImportName,
   getImportMap,
   getPropertyValues,
-} from '../../typescript/ast-helpers.js';
+} from '../../typescript/ast-helpers.ts';
 
 const title = 'Astro';
 
@@ -275,44 +275,24 @@ const production = [
   'src/actions/index.{js,ts}',
 ];
 
-const getComponentPathsFromSourceFile = (sourceFile: ts.SourceFile) => {
-  const componentPaths: Set<string> = new Set();
-  const importMap = getImportMap(sourceFile);
+const getComponentPaths = (program: Program) => {
+  const importMap = getImportMap(program);
   const importName = getDefaultImportName(importMap, '@astrojs/starlight');
-
-  function visit(node: ts.Node) {
-    if (
-      ts.isCallExpression(node) &&
-      ts.isIdentifier(node.expression) &&
-      node.expression.text === importName // match the starlight() function call
-    ) {
-      const starlightConfig = node.arguments[0];
-      if (ts.isObjectLiteralExpression(starlightConfig)) {
-        const values = getPropertyValues(starlightConfig, 'components');
-        for (const value of values) componentPaths.add(value);
-      }
-    }
-
-    ts.forEachChild(node, visit);
-  }
-
-  visit(sourceFile);
-
-  return componentPaths;
+  if (!importName) return new Set<string>();
+  const starlightConfig = findCallArg(program, importName);
+  return getPropertyValues(starlightConfig, 'components');
 };
 
-const resolveFromAST: ResolveFromAST = (sourceFile: ts.SourceFile) => {
-  // Include './src/components/Head.astro' and './src/components/Footer.astro'
-  // as production entry files so they're also part of the analysis
-  const componentPaths = getComponentPathsFromSourceFile(sourceFile);
+const resolveFromAST: ResolveFromAST = (program: Program) => {
+  const componentPaths = getComponentPaths(program);
   return [...production, ...componentPaths].map(id => toProductionEntry(id));
 };
 
-const plugin: Plugin {
+const plugin: Plugin = {
   title,
   production,
   resolveFromAST,
-}
+};
 
 export default plugin;
 ```
@@ -385,8 +365,7 @@ plugin, this might be the right time to open a pull request!
 [1]: #create-a-new-plugin
 [2]: ../reference/plugins.md
 [3]: ../explanations/plugins.md#entry-files-from-config-files
-[4]:
-  https://github.com/webpro-nl/knip/blob/6a6954386b33ee8a2919005230a4bc094e11bc03/knip.json#L12
+[4]: https://github.com/webpro-nl/knip/blob/6a6954386b33ee8a2919005230a4bc094e11bc03/knip.json#L12
 [5]: ./inputs.md
 [6]: ../features/script-parser.md
 [7]: ./argument-parsing.md