@belt/prettier-plugin weekly downloads statistics

@belt/prettier-plugin

Prettier plugin for standardizing line breaks and multi-line formatting.

Installation

npm install -D @belt/prettier-plugin

Usage

Add the plugin to your Prettier configuration:

// prettier.config.mjs
export default {
  plugins: ['@belt/prettier-plugin'],
};

What it does

This plugin enforces consistent multi-line formatting to stabilize diffs and improve readability.

Rules

1. Arrays - Forces multi-line when elements exceed threshold
2. Objects - Forces multi-line when properties exceed threshold
3. TypeScript type literals - Forces multi-line when members exceed threshold
4. Function parameters - Forces multi-line when parameter count exceeds 3
5. If statements - Enforces braces when condition length exceeds threshold

Before

const config = {
  a: 1,
  b: 2,
  c: 3,
};
const items = [1, 2, 3, 4, 5];
function process(a: string, b: number, c: boolean, d: object) {}

After

const config = {
  a: 1,
  b: 2,
  c: 3,
};
const items = [1, 2, 3, 4, 5];
function process(a: string, b: number, c: boolean, d: object) {}

Options

Option	Default	Description
multilineWrapThreshold	1	Base threshold for multi-line wrapping
objectWrapThreshold	inherits from multilineWrapThreshold	Threshold for objects
arrayWrapThreshold	inherits from objectWrapThreshold	Threshold for arrays
paramsPrintWidth	50	Max length before forcing braces in if statements

License

MIT