prettier-plugin-sort-imports
v1.8.6
Published
A prettier plugin for sorting imports by length
Downloads
35,978
Maintainers
Readme
Prettier Plugin: Sort imports
A prettier plugin that sorts import statements by either their length or alphabetically.
Example:
Installation
npm install --save-dev prettier-plugin-sort-imports
Usage
The plugin will be loaded by Prettier automatically. No configuration needed. It will sort by import statement length by default.
Add to Prettier Config
- Create a file named
prettier.config.js
in your project's root directory. - Add the following contents:
module.exports = {
// For prettier 3
sortingMethod: 'lineLength',
plugins: ['./node_modules/prettier-plugin-sort-imports/dist/index.js'],
};
module.exports = {
// For prettier 2
sortingMethod: 'lineLength',
pluginSearchDirs: ['./node_modules'],
plugins: ['./node_modules/prettier-plugin-sort-imports/dist/index.2.js'],
};
Known issues
When using with certain other plugins
When combined with other prettier plugins that also modify the way JS/TS are formatted (such as prettier-plugin-tailwindcss
) some issues may occur. See this issue for more details and the fix.
Options:
sortingMethod
:'alphabetical' | 'lineLength' (default)
- What to sort the individual lines by.alphabetical
sorts by the import path andlineLength
sorts by the length of the import. Note that alphabetical sorting looks at the whole import path, so imports starting with../
are ranked lower.stripNewlines
:true | false (default)
. Determines whether newlines between blocks of imports are stripped. If the only thing between two blocks is whitespace or comments, the whitespace will be stripped and the blocks are sorted as one big one. The comment sticks to whichever import it was above initially.importTypeOrder
:('NPMPackages' | 'localImportsValue' | 'localImportsType' | 'localImports' | 'all')[]
. An array that determines the order in which different import types are sorted. The default is['all']
, which does no sorting of different import types. Import type are sorted according to the order in which they appear in this array. Note that, other than the'all'
type, you can not specify an imcomplete array. See different types for which other types they can be combined with. Explanations of different types:'NPMPackages'
: All NPM packges that are listed in yourpackage.json
fall into this category. If you have multiplepackage.json
files you can specify them using thepackageJSONFiles
option. Can only be used with one of the other local import types (either'localImportsValue', 'localImportsType'
or'localImports'
)'localImportsValue'
: All local imports that are declared with a valueimport foo from './foo'
falls into this category. Can only be used ifNPMPackages
is also specified and iflocalImportsType
is also specified.'localImportsType'
: All local imports that are imported as a type.import type foo from './foo'
falls into this category. Only available in typecript. Can only be used ifNPMPackages
is also specified and iflocalImportsValue
is also specified.'localImports'
: All local imports that are declared with a value or a type.import foo from './foo'
andimport type foo from './foo'
both fall into this category. Can only be used ifNPMPackages
is also specified.'all'
: All imports fall into this category.
packageJSONFiles
:string[]
. Set to['package.json']
by default. Lists thepackage.json
files to be used for the'NPMPackages'
import type. Note that if you specified['all']
for theimportTypeOrder
option (or specified none at all), this is not used.newlineBetweenTypes
:boolean
. Set tofalse
by default. Determines whether a newline should be inserted between different import types.
Files containing the string // sort-imports-ignore
are skipped. You can also ignore sections by using // sort-imports-begin-ignore
and // sort-imports-end-ignore
.
Changelog
1.8.6
- Add keywords to NPM package listing
1.8.5
- When sorting by line length, adjecent subgroups are also sorted together
1.8.4
- Add
.prettierrc.mjs
andprettier.config.mjs
to the list of possible config files
1.8.3
- Remove some logs from release
1.8.2
- Fix bug where
package.json
files were not resolved relative to prettier config file but only to CWD
1.8.1
- Fix bug where reading of
package.json
files was not try-catched
1.7.2
- Fix peer dependency version
1.7.0
- Rewrite newline re-ordering to be more robust