@knip/mcp 0.0.18 → 0.0.19

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

@@ -68,7 +68,7 @@ to easily navigate around.
 
 ## How is Knip different from ESLint for finding unused exports?
 
-While linters like ESLint can find unused variables and imports within
+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
 identifies exports that are not imported or used anywhere in the codebase. This

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

@@ -248,7 +248,7 @@ const resolveConfig: ResolveConfig<AstroConfig> = async config => {
 
 This is why plugins can implement the `resolveFromAST` function.
 
-### 7. resolveFromAST
+### 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.
@@ -317,6 +317,19 @@ const plugin: Plugin {
 export default plugin;
 ```
 
+## None Of The Above
+
+### 9. `resolve`
+
+If there is no configuration file to parse or there is a need for customization,
+use `resolve`:
+
+```ts
+const resolve: Resolve = async options => {
+  return toDependency('troublesome', { optional: true });
+};
+```
+
 ## Inputs
 
 You may have noticed functions like `toDeferResolve` and `toEntry`. They're a
@@ -374,6 +387,6 @@ plugin, this might be the right time to open a pull request!
 [3]: ../explanations/plugins.md#entry-files-from-config-files
 [4]:
   https://github.com/webpro-nl/knip/blob/6a6954386b33ee8a2919005230a4bc094e11bc03/knip.json#L12
-[5]: ./writing-a-plugin/inputs.md
+[5]: ./inputs.md
 [6]: ../features/script-parser.md
-[7]: ./writing-a-plugin/argument-parsing.md
+[7]: ./argument-parsing.md

package/src/tools.js

@@ -46,15 +46,9 @@ export function buildResults(results, options) {
  * @param {string} cwd
  */
 export async function getResults(cwd) {
-  const originalCwd = process.cwd();
-  try {
-    process.chdir(cwd);
-    const options = await createOptions({ cwd, isSession: true, isUseTscFiles: false });
-    const session = await createSession(options);
-    return buildResults(session.getResults(), options);
-  } finally {
-    process.chdir(originalCwd);
-  }
+  const options = await createOptions({ cwd, isSession: true, isUseTscFiles: false });
+  const session = await createSession(options);
+  return buildResults(session.getResults(), options);
 }
 
 /** @param {string} filePath */

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

@@ -1,33 +0,0 @@
----
-title: Angular
-sidebar:
-  hidden: true
----
-
-## Enabled
-
-This plugin is enabled if `"@angular/cli"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
-
-## Default configuration
-
-If this plugin is enabled, the following configuration is added automatically:
-
-```json
-{
-  "angular": {
-    "config": [
-      "angular.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](../../explanations/plugins.md) for more details about plugins and their `entry` and `config` options.
-
-## Generated from source
-
-This page was generated from the [angular plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/angular/index.ts).

package/src/docs/docs/reference/plugins/astro-db.md

@@ -1,34 +0,0 @@
----
-title: Astro DB
-sidebar:
-  hidden: true
----
-
-## Enabled
-
-This plugin is enabled if `"@astrojs/db"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
-
-## Default configuration
-
-If this plugin is enabled, the following configuration is added automatically:
-
-```json
-{
-  "astro-db": {
-    "entry": [
-      "db/config.{js,ts}",
-      "db/seed.{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](../../explanations/plugins.md) for more details about plugins and their `entry` and `config` options.
-
-## Generated from source
-
-This page was generated from the [astro-db plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/astro-db/index.ts).

package/src/docs/docs/reference/plugins/astro-og-canvas.md

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

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

@@ -1,43 +0,0 @@
----
-title: Astro
-sidebar:
-  hidden: true
----
-
-## Enabled
-
-This plugin is enabled if `"astro"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
-
-## Default configuration
-
-If this plugin is enabled, the following configuration is added automatically:
-
-```json
-{
-  "astro": {
-    "config": [
-      "astro.config.{js,cjs,mjs,ts,mts}"
-    ],
-    "entry": [
-      "src/content/config.ts",
-      "src/content.config.ts",
-      "src/pages/**/*.{astro,mdx,js,ts}",
-      "!src/pages/**/_*",
-      "!src/pages/**/_*/**",
-      "src/content/**/*.mdx",
-      "src/middleware.{js,ts}",
-      "src/actions/index.{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](../../explanations/plugins.md) for more details about plugins and their `entry` and `config` options.
-
-## Generated from source
-
-This page was generated from the [astro plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/astro/index.ts).

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

@@ -1,46 +0,0 @@
----
-title: Ava
-sidebar:
-  hidden: true
----
-
-## Enabled
-
-This plugin is enabled if `"ava"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
-
-## Default configuration
-
-If this plugin is enabled, the following configuration is added automatically:
-
-```json
-{
-  "ava": {
-    "config": [
-      "ava.config.{js,cjs,mjs}",
-      "package.json"
-    ],
-    "entry": [
-      "test.{js,cjs,mjs,ts}",
-      "{src,source}/test.{js,cjs,mjs,ts}",
-      "**/__tests__/**/*.{js,cjs,mjs,ts}",
-      "**/*.spec.{js,cjs,mjs,ts}",
-      "**/*.test.{js,cjs,mjs,ts}",
-      "**/test-*.{js,cjs,mjs,ts}",
-      "**/test/**/*.{js,cjs,mjs,ts}",
-      "**/tests/**/*.{js,cjs,mjs,ts}",
-      "!**/__tests__/**/__{helper,fixture}?(s)__/**/*",
-      "!**/test?(s)/**/{helper,fixture}?(s)/**/*"
-    ]
-  }
-}
-```
-
-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](../../explanations/plugins.md) for more details about plugins and their `entry` and `config` options.
-
-## Generated from source
-
-This page was generated from the [ava plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/ava/index.ts).

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

@@ -1,38 +0,0 @@
----
-title: Babel
-sidebar:
-  hidden: true
----
-
-## Enabled
-
-This plugin is enabled if there's a match in `"dependencies"` or `"devDependencies"` in `package.json`:
-
-- `^@babel\/`
-
-## Default configuration
-
-If this plugin is enabled, the following configuration is added automatically:
-
-```json
-{
-  "babel": {
-    "config": [
-      "babel.config.{json,js,cjs,mjs,cts,ts}",
-      ".babelrc.{json,js,cjs,mjs,cts}",
-      ".babelrc",
-      "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](../../explanations/plugins.md) for more details about plugins and their `entry` and `config` options.
-
-## Generated from source
-
-This page was generated from the [babel plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/babel/index.ts).

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

@@ -1,34 +0,0 @@
----
-title: Biome
-sidebar:
-  hidden: true
----
-
-## Enabled
-
-This plugin is enabled if `"@biomejs/biome"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
-
-## Default configuration
-
-If this plugin is enabled, the following configuration is added automatically:
-
-```json
-{
-  "biome": {
-    "config": [
-      "biome.json",
-      "biome.jsonc"
-    ]
-  }
-}
-```
-
-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](../../explanations/plugins.md) for more details about plugins and their `entry` and `config` options.
-
-## Generated from source
-
-This page was generated from the [biome plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/biome/index.ts).

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

@@ -1,38 +0,0 @@
----
-title: bumpp
-sidebar:
-  hidden: true
----
-
-## Enabled
-
-This plugin is enabled if `"bumpp"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
-
-## Default configuration
-
-If this plugin is enabled, the following configuration is added automatically:
-
-```json
-{
-  "bumpp": {
-    "entry": [
-      "package.json",
-      ".bumprc",
-      ".config/bumprc",
-      ".bumprc.{json,jsonc,json5,yaml,yml,js,ts,mjs,cjs,mts,cts,toml}",
-      "bump.config.{js,ts,mjs,cjs,mts,cts}",
-      ".config/bumprc.{json,jsonc,json5,yaml,yml,js,ts,mjs,cjs,mts,cts,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](../../explanations/plugins.md) for more details about plugins and their `entry` and `config` options.
-
-## Generated from source
-
-This page was generated from the [bumpp plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/bumpp/index.ts).

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

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

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

@@ -1,26 +0,0 @@
----
-title: c8
-sidebar:
-  hidden: true
----
-
-## Enabled
-
-This plugin is always enabled.
-
-## Shell commands
-
-This plugin adds argument parsing for the <code>c8</code>
-binary. Configuration:
-
-```
-args: args2=>args2.filter(arg=>arg!=="check-coverage")
-boolean: ["all", "check-coverage", "clean", "exclude-after-remap", "per-file", "skip-full"]
-fromArgs: (parsed,args2)=>argsFrom(args2,parsed._[0])
-```
-
-The configuration was generated from source code. Also see [Script Parser](../../features/script-parser.md).
-
-## Generated from source
-
-This page was generated from the [c8 plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/c8/index.ts).

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

@@ -1,35 +0,0 @@
----
-title: Capacitor
-sidebar:
-  hidden: true
----
-
-## Enabled
-
-This plugin is enabled if there's a match in `"dependencies"` or `"devDependencies"` in `package.json`:
-
-- `^@capacitor\/`
-
-## Default configuration
-
-If this plugin is enabled, the following configuration is added automatically:
-
-```json
-{
-  "capacitor": {
-    "config": [
-      "capacitor.config.{json,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](../../explanations/plugins.md) for more details about plugins and their `entry` and `config` options.
-
-## Generated from source
-
-This page was generated from the [capacitor plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/capacitor/index.ts).

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

@@ -1,38 +0,0 @@
----
-title: Changelogen
-sidebar:
-  hidden: true
----
-
-## Enabled
-
-This plugin is enabled if `"changelogen"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
-
-## Default configuration
-
-If this plugin is enabled, the following configuration is added automatically:
-
-```json
-{
-  "changelogen": {
-    "entry": [
-      "package.json",
-      ".changelogrc",
-      ".config/changelogrc",
-      ".changelogrc.{json,jsonc,json5,yaml,yml,js,ts,mjs,cjs,mts,cts,toml}",
-      "changelog.config.{js,ts,mjs,cjs,mts,cts}",
-      ".config/changelogrc.{json,jsonc,json5,yaml,yml,js,ts,mjs,cjs,mts,cts,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](../../explanations/plugins.md) for more details about plugins and their `entry` and `config` options.
-
-## Generated from source
-
-This page was generated from the [changelogen plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/changelogen/index.ts).

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

@@ -1,38 +0,0 @@
----
-title: Changelogithub
-sidebar:
-  hidden: true
----
-
-## Enabled
-
-This plugin is enabled if `"changelogithub"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
-
-## Default configuration
-
-If this plugin is enabled, the following configuration is added automatically:
-
-```json
-{
-  "changelogithub": {
-    "entry": [
-      "package.json",
-      ".changelogithubrc",
-      ".config/changelogithubrc",
-      ".changelogithubrc.{json,jsonc,json5,yaml,yml,js,ts,mjs,cjs,mts,cts,toml}",
-      "changelogithub.config.{js,ts,mjs,cjs,mts,cts}",
-      ".config/changelogithubrc.{json,jsonc,json5,yaml,yml,js,ts,mjs,cjs,mts,cts,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](../../explanations/plugins.md) for more details about plugins and their `entry` and `config` options.
-
-## Generated from source
-
-This page was generated from the [changelogithub plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/changelogithub/index.ts).

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

@@ -1,33 +0,0 @@
----
-title: Changesets
-sidebar:
-  hidden: true
----
-
-## Enabled
-
-This plugin is enabled if `"@changesets/cli"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
-
-## Default configuration
-
-If this plugin is enabled, the following configuration is added automatically:
-
-```json
-{
-  "changesets": {
-    "config": [
-      ".changeset/config.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](../../explanations/plugins.md) for more details about plugins and their `entry` and `config` options.
-
-## Generated from source
-
-This page was generated from the [changesets plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/changesets/index.ts).

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

@@ -1,35 +0,0 @@
----
-title: Commitizen
-sidebar:
-  hidden: true
----
-
-## Enabled
-
-This plugin is enabled if `"commitizen"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
-
-## Default configuration
-
-If this plugin is enabled, the following configuration is added automatically:
-
-```json
-{
-  "commitizen": {
-    "config": [
-      ".czrc",
-      ".cz.json",
-      "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](../../explanations/plugins.md) for more details about plugins and their `entry` and `config` options.
-
-## Generated from source
-
-This page was generated from the [commitizen plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/commitizen/index.ts).

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

@@ -1,39 +0,0 @@
----
-title: commitlint
-sidebar:
-  hidden: true
----
-
-## Enabled
-
-This plugin is enabled if `"@commitlint/cli"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
-
-## Default configuration
-
-If this plugin is enabled, the following configuration is added automatically:
-
-```json
-{
-  "commitlint": {
-    "config": [
-      "package.json",
-      "package.yaml",
-      ".commitlintrc",
-      ".config/commitlintrc",
-      ".commitlintrc.{json,yaml,yml,js,ts,cjs,mjs,cts}",
-      "commitlint.config.{js,ts,cjs,mjs,cts}",
-      ".config/commitlintrc.{json,yaml,yml,js,ts,cjs,mjs,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](../../explanations/plugins.md) for more details about plugins and their `entry` and `config` options.
-
-## Generated from source
-
-This page was generated from the [commitlint plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/commitlint/index.ts).

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

@@ -1,34 +0,0 @@
----
-title: Convex
-sidebar:
-  hidden: true
----
-
-## Enabled
-
-This plugin is enabled if `"convex"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
-
-## Default configuration
-
-If this plugin is enabled, the following configuration is added automatically:
-
-```json
-{
-  "convex": {
-    "entry": [
-      "convex/*.config.@(js|ts)",
-      "convex/_generated/*.@(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](../../explanations/plugins.md) for more details about plugins and their `entry` and `config` options.
-
-## Generated from source
-
-This page was generated from the [convex plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/convex/index.ts).