@1adybug/prettier-plugin-sort-imports 0.0.27 → 0.0.29

package/README.md

@@ -152,6 +152,8 @@ interface PluginConfig {
     sortSideEffect?: boolean
     /** Whether to remove unused imports, defaults to false */
     removeUnusedImports?: boolean
+    /** Whether to add/remove the node: prefix for Node.js builtin modules */
+    nodeProtocol?: "add" | "remove"
 }
 ```
 
@@ -167,6 +169,7 @@ export default {
     sortSideEffect: false, // Whether to sort side effect imports
     groupSeparator: "", // Group separator
     removeUnusedImports: false, // Whether to remove unused imports
+    nodeProtocol: "add", // "add" to add node: prefix ("remove" to remove)
 }
 ```
 
@@ -198,6 +201,7 @@ export default {
             groupSeparator: "\n",
             sortSideEffect: true,
             removeUnusedImports: false,
+            nodeProtocol: "add",
         }),
     ],
 }
@@ -347,7 +351,8 @@ Whether to remove unused imports, defaults to `false`.
 
 ```tsx
 // Before sorting
-import { useState } from "react"
+// After sorting (with removeUnusedImports enabled)
+import React, { useState } from "react"
 
 import { Button } from "antd"
 
@@ -356,10 +361,6 @@ function MyComponent() {
     return <Button>Click me</Button>
 }
 
-// After sorting (with removeUnusedImports enabled)
-import React, { useState } from "react"
-import { Button } from "antd"
-
 function MyComponent() {
     const [count, setCount] = useState(0)
     return <Button>Click me</Button>
@@ -373,6 +374,23 @@ function MyComponent() {
 - Analysis is AST-based and identifies actually used identifiers in code
 - Supports identifying JSX components, TypeScript type references, etc.
 
+### nodeProtocol
+
+Whether to add/remove the `node:` prefix for Node.js builtin modules. Defaults to `undefined` (no change).
+
+- `"add"`: add `node:` prefix
+- `"remove"`: remove `node:` prefix
+
+```ts
+// Before
+// nodeProtocol: "remove"
+import fs from "fs"
+// nodeProtocol: "add"
+import fs from "node:fs"
+import path from "node:path"
+import path from "path"
+```
+
 ### sortSideEffect
 
 Whether to sort side effect imports, defaults to `false`.

package/README.zh-CN.md

@@ -151,6 +151,8 @@ interface PluginConfig {
     sortSideEffect?: boolean
     /** 是否删除未使用的导入，默认为 false */
     removeUnusedImports?: boolean
+    /** 是否为 Node.js 内置模块自动添加/移除 node: 前缀 */
+    nodeProtocol?: "add" | "remove"
 }
 ```
 
@@ -166,6 +168,7 @@ export default {
     sortSideEffect: false, // 是否对副作用导入排序
     groupSeparator: "", // 分组分隔符
     removeUnusedImports: false, // 是否删除未使用的导入
+    nodeProtocol: "add", // "add" 为添加 node: 前缀（"remove" 为移除）
 }
 ```
 
@@ -194,6 +197,7 @@ export default {
             groupSeparator: "",
             sortSideEffect: true,
             removeUnusedImports: false,
+            nodeProtocol: "add",
         }),
     ],
 }
@@ -343,7 +347,8 @@ export default {
 
 ```tsx
 // 排序前
-import { useState } from "react"
+// 排序后（开启 removeUnusedImports）
+import React, { useState } from "react"
 
 import { Button } from "antd"
 
@@ -352,10 +357,6 @@ function MyComponent() {
     return <Button>Click me</Button>
 }
 
-// 排序后（开启 removeUnusedImports）
-import React, { useState } from "react"
-import { Button } from "antd"
-
 function MyComponent() {
     const [count, setCount] = useState(0)
     return <Button>Click me</Button>
@@ -369,6 +370,23 @@ function MyComponent() {
 - 分析基于 AST，会识别代码中实际使用的标识符
 - 支持识别 JSX 组件、TypeScript 类型引用等
 
+### nodeProtocol
+
+是否为 Node.js 内置模块自动添加/移除 `node:` 前缀，默认为 `undefined`（不处理）。
+
+- `"add"`：自动添加 `node:` 前缀
+- `"remove"`：自动移除 `node:` 前缀
+
+```ts
+// 排序前
+// nodeProtocol: "remove"
+import fs from "fs"
+// nodeProtocol: "add"
+import fs from "node:fs"
+import path from "node:path"
+import path from "path"
+```
+
 ### sortSideEffect
 
 是否对副作用导入进行排序，默认为 `false`。

package/dist/index.d.ts

@@ -17,6 +17,12 @@ export interface Options extends PrettierOptions {
      * @default false
      */
     removeUnusedImports?: boolean;
+    /**
+     * Whether to add/remove the node: prefix for Node.js builtin modules.
+     * "add": add, "remove": remove, undefined: no change.
+     * @default undefined
+     */
+    nodeProtocol?: "add" | "remove";
     /**
      * 自定义获取分组名称。
      */

package/dist/index.js

@@ -1,4 +1,4 @@
-import { createRequire } from "module";
+import { builtinModules, createRequire } from "module";
 import { format } from "prettier";
 import { parse as parser_parse } from "@babel/parser";
 import traverse from "@babel/traverse";
@@ -419,7 +419,8 @@ function mergeConfig(userConfig) {
         sortImportContent: userConfig.sortImportContent ?? DEFAULT_CONFIG.sortImportContent,
         groupSeparator: userConfig.groupSeparator,
         sortSideEffect: userConfig.sortSideEffect ?? DEFAULT_CONFIG.sortSideEffect,
-        removeUnusedImports: userConfig.removeUnusedImports ?? false
+        removeUnusedImports: userConfig.removeUnusedImports ?? false,
+        nodeProtocol: userConfig.nodeProtocol
     };
 }
 function sortImports(imports, userConfig) {
@@ -583,6 +584,23 @@ function mergeImports(imports) {
     return Array.from(mergedMap.values());
 }
 const src_require = createRequire(import.meta.url);
+const NODE_BUILTIN_MODULES = new Set(builtinModules.map((moduleName)=>moduleName.startsWith("node:") ? moduleName.slice(5) : moduleName));
+function isNodeBuiltinModule(modulePath) {
+    const normalizedPath = modulePath.startsWith("node:") ? modulePath.slice(5) : modulePath;
+    if (NODE_BUILTIN_MODULES.has(normalizedPath)) return true;
+    const slashIndex = normalizedPath.indexOf("/");
+    if (-1 === slashIndex) return false;
+    return NODE_BUILTIN_MODULES.has(normalizedPath.slice(0, slashIndex));
+}
+function applyNodeProtocol(modulePath, nodeProtocol) {
+    if (void 0 === nodeProtocol) return modulePath;
+    const hasNodePrefix = modulePath.startsWith("node:");
+    const normalizedPath = hasNodePrefix ? modulePath.slice(5) : modulePath;
+    if (!isNodeBuiltinModule(normalizedPath)) return modulePath;
+    if ("add" === nodeProtocol) return hasNodePrefix ? modulePath : `node:${modulePath}`;
+    if ("remove" === nodeProtocol) return hasNodePrefix ? normalizedPath : modulePath;
+    return modulePath;
+}
 function getImportRanges(imports) {
     const ranges = imports.map((statement)=>({
             start: statement.start ?? 0,
@@ -632,12 +650,17 @@ function preprocessImports(text, options, config = {}) {
             sortImportContent: config.sortImportContent ?? optionsConfig.sortImportContent,
             groupSeparator: config.groupSeparator ?? optionsConfig.groupSeparator,
             sortSideEffect: config.sortSideEffect ?? optionsConfig.sortSideEffect ?? false,
-            removeUnusedImports: config.removeUnusedImports ?? optionsConfig.removeUnusedImports ?? false
+            removeUnusedImports: config.removeUnusedImports ?? optionsConfig.removeUnusedImports ?? false,
+            nodeProtocol: config.nodeProtocol ?? optionsConfig.nodeProtocol
         };
         const importRanges = getImportRanges(imports);
         const textWithoutImports = removeRangesFromText(text, importRanges);
         let processedImports = imports;
         if (finalConfig.removeUnusedImports) processedImports = removeUnusedImportsFromStatements(imports, textWithoutImports);
+        if (void 0 !== finalConfig.nodeProtocol) processedImports = processedImports.map((statement)=>({
+                ...statement,
+                path: applyNodeProtocol(statement.path, finalConfig.nodeProtocol)
+            }));
         const sortedImports = sortImports(processedImports, finalConfig);
         const mergedImports = mergeImports(sortedImports);
         let formattedImports;
@@ -702,6 +725,11 @@ function createPluginInstance(config = {}) {
             category: "Import Sort",
             description: "�Ƿ�ɾ��δʹ�õĵ���",
             default: false
+        },
+        nodeProtocol: {
+            type: "string",
+            category: "Import Sort",
+            description: "Add/remove node: prefix for Node.js builtin modules"
         }
     };
     const otherPlugins = config.otherPlugins || [];

package/dist/sorter.d.ts

@@ -1,8 +1,9 @@
 import { Group, ImportContent, ImportStatement, PluginConfig } from "./types";
 /** 合并后的配置 */
-export interface MergedConfig extends Omit<Required<PluginConfig>, "groupSeparator" | "removeUnusedImports" | "otherPlugins" | "prettierOptions"> {
+export interface MergedConfig extends Omit<Required<PluginConfig>, "groupSeparator" | "removeUnusedImports" | "nodeProtocol" | "otherPlugins" | "prettierOptions"> {
     groupSeparator: PluginConfig["groupSeparator"];
     removeUnusedImports: boolean;
+    nodeProtocol?: PluginConfig["nodeProtocol"];
 }
 /** 对导入语句进行排序 */
 export declare function sortImports(imports: ImportStatement[], userConfig: PluginConfig): ImportStatement[];

package/dist/types.d.ts

@@ -76,6 +76,8 @@ export interface PluginConfig {
     sortSideEffect?: boolean;
     /** 是否删除未使用的导入，默认为 false */
     removeUnusedImports?: boolean;
+    /** Whether to add/remove the node: prefix for Node.js builtin modules */
+    nodeProtocol?: "add" | "remove";
     /** 要合并的其他 Prettier 插件，按传入顺序执行 */
     otherPlugins?: Plugin[];
     /** 传递给其他插件的 Prettier 配置选项 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1adybug/prettier-plugin-sort-imports",
-  "version": "0.0.27",
+  "version": "0.0.29",
   "description": "一个 Prettier 插件，用于对 JavaScript/TypeScript 文件的导入语句进行分组和排序",
   "keywords": [
     "prettier",