eslint-plugin-vuoto

> ESLint plugin for detecting and fixing whitespace issues - zero-width characters, non-breaking spaces, and Unicode normalization

Table of Contents

- Features
- Installation
- Usage
- Flat Config (ESLint 9+)
- Configuration Presets
- Rules
- Zero-Width Characters
- Invisible Separators
- Visible Whitespace
- Control Characters
- Building
- License

Features

- ✅ 13 specialized rules for whitespace normalization
- 🔧 Auto-fix support for all rules
- 📦 4 preset configurations (recommended, strict, all, off)
- 🎯 ESLint 9+ flat config support
- 🚀 Zero dependencies (except peer dependency on ESLint)
- 📝 TypeScript support with full type definitions

Installation

``bash
npm install --save-dev eslint-plugin-vuoto


or

yarn add -D eslint-plugin-vuoto

or

pnpm add -D eslint-plugin-vuoto
`

Usage

$3

`javascript
// eslint.config.js
import vuoto from 'eslint-plugin-vuoto';

export default [
{
plugins: {
vuoto,
},
rules: {
...vuoto.configs.recommended[0].rules,
},
},
];
`

$3

The plugin provides four preset configurations:

#### recommended

The default configuration with all rules set to error. Suitable for most projects.

`javascript
import vuoto from 'eslint-plugin-vuoto';

export default [
{
plugins: { vuoto },
rules: {
...vuoto.configs.recommended[0].rules,
},
},
];
`

#### strict

Same as recommended (all rules as errors). Use for maximum strictness.

`javascript
rules: {
...vuoto.configs.strict[0].rules,
}
`

#### all

Enable all available rules.

`javascript
rules: {
...vuoto.configs.all[0].rules,
}
`

#### off

Disable all rules (useful for gradual adoption).

`javascript
rules: {
...vuoto.configs.off[0].rules,
}
`

Rules

All rules support auto-fixing and are enabled by default in the recommended config.

$3

| Rule | Description | Fixable |
| ------------------ | ------------------------------------------------------- | ------- |
| vuoto/zero-width | Detects zero-width characters (ZWSP, ZWNJ, ZWJ, ZWNBSP) | ✅ |

$3

| Rule | Description | Fixable |
| ---------------------------- | -------------------------------------------- | ------- |
| vuoto/invisible-separators | Detects invisible separator characters | ✅ |
| vuoto/line-separator | Detects Unicode line separator (U+2028) | ✅ |
| vuoto/paragraph-separator | Detects Unicode paragraph separator (U+2029) | ✅ |

$3

| Rule | Description | Fixable |
| ----------------------------- | --------------------------------------- | ------- |
| vuoto/non-breaking-space | Detects non-breaking spaces (U+00A0) | ✅ |
| vuoto/narrow-no-break-space | Detects narrow no-break spaces (U+202F) | ✅ |
| vuoto/em-space | Detects em spaces (U+2003) | ✅ |
| vuoto/en-space | Detects en spaces (U+2002) | ✅ |
| vuoto/ideographic-space | Detects ideographic spaces (U+3000) | ✅ |
| vuoto/visible-misc-spaces | Detects other visible Unicode spaces | ✅ |

$3

| Rule | Description | Fixable |
| ----------------------- | ---------------------------------------- | ------- |
| vuoto/byte-order-mark | Detects byte order mark (BOM) characters | ✅ |
| vuoto/form-feed | Detects form feed characters (U+000C) | ✅ |
| vuoto/vertical-tab | Detects vertical tab characters (U+000B) | ✅ |

Building

Run nx build eslint-plugin-vuoto` to build the library.

---

License

This project is licensed under the MIT License.

Copyright (c) 2025 Davide Di Criscito

For the full details, see the LICENSE file.