prettier-plugin-package2

An opinionated package.json formatter plugin for Prettier

Usage no npm install needed!

<script type="module">
  import prettierPluginPackage2 from 'https://cdn.skypack.dev/prettier-plugin-package2';
</script>

README

banner

prettier-plugin-package2 size libera manifesto

An opinionated package.json formatter plugin for Prettier

Prettier is an opinionated code formatter. It enforces a consistent style by parsing your code and re-printing, taking various rules into account.

This plugin adds support for package.json files used within NPM modules.

Requirements

prettier-plugin-package2 is an evergreen module. 🌲 This module requires an LTS Node version (v8.0.0+), and prettier v2.0.0+.

Install

Using npm:

yarn add prettier prettier-plugin-package2 --dev

Usage

Once installed, Prettier plugins should be automatically recognised by Prettier. To use this plugin, confirm that it's installed and run Prettier using your preferred method. For example:

$ npx prettier --write package.json

Rules

This plugin enforces its own set of opinionated rules:

Engines

Keys in engines are ordered alphabetically.

Files

Keys in files are ordered alphabetically (keeping the negations below), followed by README.md and LICENSE if they exist in the array.

Scripts

Keys in scripts are ordered alphabetically. Use prefixes wisely to properly order child scripts. e.g. lint, lint:ts.

Sorting

Top-level keys are sorted according to a style commonly seen in the packages of @sindresorhus. Known keys, and their order are:

[
  // meta
  'name',
  'version',
  'flat',
  'private',
  'publishConfig',
  'description',
  'license',
  'repository',
  'author',
  'homepage',
  'bugs',

  // entry
  'bin',
  'main',
  'module',
  'browser',
  'types',
  'typings',
  'style',
  'svelte',

  // constraints
  'engines',
  'cpu',
  'os',

  // content and util
  'scripts',
  'files',
  'keywords',

  // dependencies
  'workspaces',
  'bundledDependencies',
  'optionalDependencies',
  'peerDependencies',
  'peerDependenciesMeta',
  'dependencies',
  'devDependencies',
  'resolutions',

  // types
  'types',
  'typings'
]

Unknown keys, or keys not part of the list above, will be alphabetically sorted and added to the end of the file. Note that this list takes into account both npm and yarn keys.

Meta

CONTRIBUTING

LICENSE (Mozilla Public License)