Security News
ESLint is Now Language-Agnostic: Linting JSON, Markdown, and Beyond
ESLint has added JSON and Markdown linting support with new officially-supported plugins, expanding its versatility beyond JavaScript.
@plasmohq/prettier-plugin-sort-imports
Advanced tools
A prettier plugins to sort imports in provided RegEx order
A prettier plugin to sort import declarations by provided Regular Expression order.
This was forked from IanVS/prettier-plugin-sort-imports, which was a fork of @trivago/prettier-plugin-sort-imports.
// prettier-ignore
import { environment } from "./misguided-module-with-side-effects.js";
import "core-js/stable"
import "regenerator-runtime/runtime"
import { initializeApp } from "@core/app"
import { logger } from "@core/logger"
import { createConnection } from "@server/database"
import { createServer } from "@server/node"
import { Alert } from "@ui/Alert"
import { Popup } from "@ui/Popup"
import { debounce, reduce } from "lodash"
import React, { ChangeEvent, FC, KeyboardEvent, useEffect, useRef } from "react"
import { Message } from "../Message"
import { add, filter, repeat } from "../utils"
// prettier-ignore
import { environment } from "./misguided-module-with-side-effects.js";
import "core-js/stable"
import "regenerator-runtime/runtime"
import { initializeApp } from "@core/app"
import { logger } from "@core/logger"
import { createConnection } from "@server/database"
import { createServer } from "@server/node"
import { Alert } from "@ui/Alert"
import { Popup } from "@ui/Popup"
import { debounce, reduce } from "lodash"
import React, { ChangeEvent, FC, KeyboardEvent, useEffect, useRef } from "react"
import { Message } from "../Message"
import { add, filter, repeat } from "../utils"
pnpm install --save-dev @plasmohq/prettier-plugin-sort-imports
Add your preferred settings in your prettier config file.
/**
* @type {import('prettier').Options}
*/
module.exports = {
printWidth: 80,
tabWidth: 2,
useTabs: false,
semi: false,
singleQuote: false,
trailingComma: "none",
bracketSpacing: true,
bracketSameLine: true,
plugins: [require("./dist/index.js")],
importOrder: ["^@plasmo/(.*)$", "^@plasmohq/(.*)$", "^~(.*)$", "^[./]"],
importOrderSeparation: true,
importOrderSortSpecifiers: true,
importOrderBuiltinModulesToTop: true,
importOrderCaseInsensitive: true,
importOrderParserPlugins: ["typescript", "jsx", "decorators-legacy"],
importOrderMergeDuplicateImports: true
}
Note: all flags are off by default, so explore your options below
This plugin supports standard prettier ignore comments. By default, side-effect imports (like
import "core-js/stable";
) are not sorted, so in most cases things should just work. But if you ever need to, you can
prevent an import from getting sorted like this:
// prettier-ignore
import { cars } from "austria";
import { goods } from "zealand"
This will keep the zealand
import at the top instead of moving it below the austria
import. Note that since only
entire import statements can be ignored, line comments (// prettier-ignore
) are recommended over inline comments
(/* prettier-ignore */
).
importOrder
type: Array<string>
A collection of Regular expressions in string format.
"importOrder": ["^@core/(.*)$", "^@server/(.*)$", "^@ui/(.*)$", "^[./]"],
Default: []
By default, this plugin will not move any imports. To separate third party from relative imports, use ["^[./]"]
. This will become the default in the next major version.
The plugin moves the third party imports to the top which are not part of the importOrder
list.
To move the third party imports at desired place, you can use <THIRD_PARTY_MODULES>
to assign third party imports to the appropriate position:
"importOrder": ["^@core/(.*)$", "<THIRD_PARTY_MODULES>", "^@server/(.*)$", "^@ui/(.*)$", "^[./]"],
importOrderSeparation
type: boolean
default value: false
A boolean value to enable or disable the new line separation
between sorted import declarations group. The separation takes place according to the importOrder
.
"importOrderSeparation": true,
Note: If you want greater control over which groups are separated from others, you can add an empty string to your importOrder
array to signify newlines. For example:
"importOrderSeparation": false,
"importOrder": [
"^react", // React will be placed at the top of third-party modules
"<THIRD_PARTY_MODULES>",
"", // use empty strings to separate groups with empty lines
"^[./]"
],
importOrderSortSpecifiers
type: boolean
default value: false
A boolean value to enable or disable sorting of the specifiers in an import declarations.
importOrderGroupNamespaceSpecifiers
type: boolean
default value: false
A boolean value to enable or disable sorting the namespace specifiers to the top of the import group.
importOrderCaseInsensitive
type: boolean
default value: false
A boolean value to enable case-insensitivity in the sorting algorithm used to order imports within each match group.
For example, when false (or not specified):
import ExampleView from "./ExampleView"
import ExamplesList from "./ExamplesList"
compared with "importOrderCaseInsensitive": true
:
import ExampleView from "./ExampleView"
import ExamplesList from "./ExamplesList"
importOrderMergeDuplicateImports
type: boolean
default value: false
When true
, multiple import statements from the same module will be combined into a single import.
importOrderParserPlugins
type: Array<string>
default value: ["typescript", "jsx"]
Previously known as experimentalBabelParserPluginsList
.
A collection of plugins for babel parser. The plugin passes this list to babel parser, so it can understand the syntaxes used in the file being formatted. The plugin uses prettier itself to figure out the parser it needs to use but if that fails, you can use this field to enforce the usage of the plugins' babel parser needs.
To pass the plugins to babel parser:
"importOrderParserPlugins" : ["classProperties", "decorators-legacy"]
To pass the options to the babel parser plugins: Since prettier options are limited to string, you can pass plugins
with options as a JSON string of the plugin array:
"[\"plugin-name\", { \"pluginOption\": true }]"
.
"importOrderParserPlugins" : ["classProperties", "[\"decorators\", { \"decoratorsBeforeExport\": true }]"]
To disable default plugins for babel parser, pass an empty array:
"importOrderParserPlugins": []
importOrderBuiltinModulesToTop
type: boolean
default value: false
A boolean value to enable sorting of node builtins
to the top of all import groups.
The plugin extracts the imports which are defined in importOrder
. These imports are considered as local imports.
The imports which are not part of the importOrder
is considered as third party imports.
First, the plugin checks for
side effect imports,
such as import 'mock-fs'
. These imports often modify the global scope or apply some patches to the current
environment, which may affect other imports. To preserve potential side effects, these kind of side effect imports are
classified as unsortable. They also behave as a barrier that other imports may not cross during the sort. So for
example, let's say you've got these imports:
import D from "d"
import E from "e"
import F from "f"
import "c"
import A from "a"
import B from "b"
Then the first three imports are sorted and the last two imports are sorted, but all imports above c
stay above c
and all imports below c
stay below c
, resulting in:
import D from "d"
import E from "e"
import F from "f"
import "c"
import A from "a"
import B from "b"
Additionally, any import statements lines that are preceded by a // prettier-ignore
comment are also classified as
unsortable. This can be used for edge-cases, such as when you have a named import with side-effects.
Next, the plugin sorts the local imports and third party imports using natural sort algorithm.
In the end, the plugin returns final imports with third party imports on top and local imports at the end.
The third party imports position (it's top by default) can be overridden using the <THIRD_PARTY_MODULES>
special word in the importOrder
.
Having some trouble or an issue? You can check FAQ / Troubleshooting section.
Framework | Supported | Note |
---|---|---|
JS with ES Modules | ✅ Everything | - |
NodeJS with ES Modules | ✅ Everything | - |
React | ✅ Everything | - |
Angular | ✅ Everything | Supported through importOrderParserPlugins API |
Vue | ⚠️ Soon to be supported. | Any contribution is welcome. |
Svelte | ⚠️ Soon to be supported. | Any contribution is welcome. |
For more information regarding contribution, please check the Contributing Guidelines. If you are trying to debug some code in the plugin, check Debugging Guidelines
This plugin modifies the AST which is against the rules of prettier.
FAQs
A prettier plugins to sort imports in provided RegEx order
The npm package @plasmohq/prettier-plugin-sort-imports receives a total of 1,117 weekly downloads. As such, @plasmohq/prettier-plugin-sort-imports popularity was classified as popular.
We found that @plasmohq/prettier-plugin-sort-imports demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
ESLint has added JSON and Markdown linting support with new officially-supported plugins, expanding its versatility beyond JavaScript.
Security News
Members Hub is conducting large-scale campaigns to artificially boost Discord server metrics, undermining community trust and platform integrity.
Security News
NIST has failed to meet its self-imposed deadline of clearing the NVD's backlog by the end of the fiscal year. Meanwhile, CVE's awaiting analysis have increased by 33% since June.