@envsa/knip-config/readme.md

Knip configuration for @envsa/shared-config.

<!--+ Warning: Content inside HTML comment blocks was generated by mdat and may be overwritten. +-->

<!-- title -->

# @envsa/knip-config

<!-- /title -->

<!-- badges -->

[![NPM Package @envsa/knip-config](https://img.shields.io/npm/v/@envsa/knip-config.svg)](https://npmjs.com/package/@envsa/knip-config)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

<!-- /badges -->

<!-- description -->

**Knip configuration for @envsa/shared-config.**

<!-- /description -->

## Overview

It's a shared [knip](https://knip.dev) config, plus a command-line tool `envsa-knip` to perform knip-related project initialization, linting and fixing.

<!-- recommendation -->

> [!IMPORTANT]
>
> **You can use this package on its own, but it's recommended to use [`@envsa/shared-config`](https://www.npmjs.com/package/@envsa/shared-config) instead for a single-dependency and single-package approach to linting and fixing your project.**
>
> This package is included as a dependency in [`@envsa/shared-config`](https://www.npmjs.com/package/@envsa/shared-config), which also automatically invokes the command line functionality in this package via its `envsa` command

<!-- /recommendation -->

## Setup

To use just this Knip config in isolation:

1. Install the `.npmrc` in your project root. This is required for correct PNPM behavior:

```sh
pnpm dlx @envsa/repo-config init
```

2. Add the package

```sh
pnpm add -D @envsa/knip-config
```

3. Add the starter `knip.config.ts` files to your project root, and add any customizations you'd like:

```sh
pnpm exec envsa-knip init
```

## Usage

Integrate with your `package.json` scripts as you see fit, for example:

```json
{
  "scripts": {
    "lint": "envsa-knip lint"
  }
}
```

### Configuration

To create a `knip.config.ts` in your project root:

```sh
pnpm exec envsa-knip init
```

(Note that this will delete the `knip` property in your `package.json`)

_Or_

To create a `knip` property in `package.json`:

```sh
pnpm exec envsa-knip init --location package
```

(Note that this will delete the `knip.config.ts` file in your project root!)

### CLI

<!-- cli-help -->

#### Command: `envsa-knip`

Envsa's Knip shared configuration tools.

This section lists top-level commands for `envsa-knip`.

Usage:

```txt
envsa-knip <command>
```

| Command        | Description                                                                                                                                             |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `init`         | Initialize by copying starter config files to your project root or to your package.json file.                                                           |
| `lint`         | Check for unused code and dependencies. Package-scoped. In a monorepo, it will also run in all packages below the current working directory.            |
| `fix`          | Automatically remove unused code and dependencies. Package-scoped. In a monorepo, it will also run in all packages below the current working directory. |
| `print-config` | Print the effective Knip configuration. Package-scoped. Searches up to the root of a monorepo if necessary.                                             |

| Option              | Description         | Type      |
| ------------------- | ------------------- | --------- |
| `--help`<br>`-h`    | Show help           | `boolean` |
| `--version`<br>`-v` | Show version number | `boolean` |

_See the sections below for more information on each subcommand._

#### Subcommand: `envsa-knip init`

Initialize by copying starter config files to your project root or to your package.json file.

Usage:

```txt
envsa-knip init
```

| Option              | Description         | Type                 | Default  |
| ------------------- | ------------------- | -------------------- | -------- |
| `--location`        | TK                  | `"file"` `"package"` | `"file"` |
| `--help`<br>`-h`    | Show help           | `boolean`            |          |
| `--version`<br>`-v` | Show version number | `boolean`            |          |

#### Subcommand: `envsa-knip lint`

Check for unused code and dependencies. Package-scoped. In a monorepo, it will also run in all packages below the current working directory.

Usage:

```txt
envsa-knip lint
```

| Option              | Description         | Type      |
| ------------------- | ------------------- | --------- |
| `--help`<br>`-h`    | Show help           | `boolean` |
| `--version`<br>`-v` | Show version number | `boolean` |

#### Subcommand: `envsa-knip fix`

Automatically remove unused code and dependencies. Package-scoped. In a monorepo, it will also run in all packages below the current working directory.

Usage:

```txt
envsa-knip fix
```

| Option              | Description         | Type      |
| ------------------- | ------------------- | --------- |
| `--help`<br>`-h`    | Show help           | `boolean` |
| `--version`<br>`-v` | Show version number | `boolean` |

#### Subcommand: `envsa-knip print-config`

Print the effective Knip configuration. Package-scoped. Searches up to the root of a monorepo if necessary.

Usage:

```txt
envsa-knip print-config
```

| Option              | Description         | Type      |
| ------------------- | ------------------- | --------- |
| `--help`<br>`-h`    | Show help           | `boolean` |
| `--version`<br>`-v` | Show version number | `boolean` |

<!-- /cli-help -->

<!-- license -->

## License

[MIT](license.txt) © Liam Rella

<!-- /license -->