@1adybug/prettier-plugin-sort-imports 0.0.26 → 0.0.28

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?: boolean
 }
 ```
 
@@ -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: true, // Add node: prefix for Node.js builtin modules (false to remove)
 }
 ```
 
@@ -198,6 +201,7 @@ export default {
             groupSeparator: "\n",
             sortSideEffect: true,
             removeUnusedImports: false,
+            nodeProtocol: true,
         }),
     ],
 }
@@ -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).
+
+- `true`: add `node:` prefix
+- `false`: remove `node:` prefix
+
+```ts
+// Before
+// nodeProtocol: false
+import fs from "fs"
+// nodeProtocol: true
+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?: boolean
 }
 ```
 
@@ -166,6 +168,7 @@ export default {
     sortSideEffect: false, // 是否对副作用导入排序
     groupSeparator: "", // 分组分隔符
     removeUnusedImports: false, // 是否删除未使用的导入
+    nodeProtocol: true, // 为 Node.js 内置模块添加 node: 前缀（false 为移除）
 }
 ```
 
@@ -194,6 +197,7 @@ export default {
             groupSeparator: "",
             sortSideEffect: true,
             removeUnusedImports: false,
+            nodeProtocol: true,
         }),
     ],
 }
@@ -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`（不处理）。
+
+- `true`：自动添加 `node:` 前缀
+- `false`：自动移除 `node:` 前缀
+
+```ts
+// 排序前
+// nodeProtocol: false
+import fs from "fs"
+// nodeProtocol: true
+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.
+     * true: add, false: remove, undefined: no change.
+     * @default undefined
+     */
+    nodeProtocol?: boolean;
     /**
      * 自定义获取分组名称。
      */

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";
@@ -209,7 +209,7 @@ function parseImports(code, filepath) {
         const statement = parseImportNode(node, ast.comments ?? [], usedComments, code, isFirstImport, filepath);
         importStatements.push(statement);
         isFirstImport = false;
-    } else break;
+    }
     return importStatements;
 }
 function parseImportNode(node, comments, usedComments, code, isFirstImport, filepath) {
@@ -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,51 @@ 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 (nodeProtocol) return hasNodePrefix ? modulePath : `node:${modulePath}`;
+    return hasNodePrefix ? normalizedPath : modulePath;
+}
+function getImportRanges(imports) {
+    const ranges = imports.map((statement)=>({
+            start: statement.start ?? 0,
+            end: statement.end ?? 0
+        })).filter((range)=>range.end > range.start).sort((a, b)=>a.start - b.start);
+    const merged = [];
+    for (const range of ranges){
+        const last = merged[merged.length - 1];
+        if (last && range.start <= last.end) {
+            last.end = Math.max(last.end, range.end);
+            continue;
+        }
+        merged.push({
+            ...range
+        });
+    }
+    return merged;
+}
+function removeRangesFromText(text, ranges) {
+    if (0 === ranges.length) return text;
+    let result = "";
+    let cursor = 0;
+    for (const range of ranges){
+        result += text.slice(cursor, range.start);
+        cursor = range.end;
+    }
+    result += text.slice(cursor);
+    return result;
+}
 function preprocessImports(text, options, config = {}) {
     try {
         const parser = options.parser;
@@ -603,14 +649,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) {
-            const lastImport = imports[imports.length - 1];
-            const codeAfterImports = text.slice(lastImport.end ?? 0);
-            processedImports = removeUnusedImportsFromStatements(imports, codeAfterImports);
-        }
+        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;
@@ -620,13 +669,12 @@ function preprocessImports(text, options, config = {}) {
             formattedImports = formatGroups(sortedGroups, finalConfig, options.trailingComma);
         } else formattedImports = formatImportStatements(mergedImports, options.trailingComma);
         const firstImport = imports[0];
-        const lastImport = imports[imports.length - 1];
         const startIndex = firstImport.start ?? 0;
-        const endIndex = lastImport.end ?? text.length;
-        const beforeImports = text.slice(0, startIndex);
-        const afterImports = text.slice(endIndex);
+        const beforeImports = textWithoutImports.slice(0, startIndex);
+        let afterImports = textWithoutImports.slice(startIndex);
+        if (afterImports) afterImports = afterImports.replace(/^\n+/, "\n");
         const needsExtraNewline = afterImports && !afterImports.startsWith("\n");
-        const separator = needsExtraNewline ? "\n\n" : "\n";
+        const separator = afterImports ? needsExtraNewline ? "\n\n" : "\n" : "";
         return beforeImports + formattedImports + separator + afterImports;
     } catch (error) {
         return text;
@@ -676,6 +724,11 @@ function createPluginInstance(config = {}) {
             category: "Import Sort",
             description: "�Ƿ�ɾ��δʹ�õĵ���",
             default: false
+        },
+        nodeProtocol: {
+            type: "boolean",
+            category: "Import Sort",
+            description: "Use 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?: boolean;
 }
 /** 对导入语句进行排序 */
 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?: boolean;
     /** 要合并的其他 Prettier 插件，按传入顺序执行 */
     otherPlugins?: Plugin[];
     /** 传递给其他插件的 Prettier 配置选项 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1adybug/prettier-plugin-sort-imports",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "description": "一个 Prettier 插件，用于对 JavaScript/TypeScript 文件的导入语句进行分组和排序",
   "keywords": [
     "prettier",
@@ -41,23 +41,23 @@
     "registry": "https://registry.npmjs.com/"
   },
   "dependencies": {
-    "@babel/core": "^7.28.4",
-    "@babel/parser": "^7.28.4",
-    "@babel/traverse": "^7.28.5",
-    "@babel/types": "^7.28.4"
+    "@babel/core": "^7.28.6",
+    "@babel/parser": "^7.28.6",
+    "@babel/traverse": "^7.28.6",
+    "@babel/types": "^7.28.6"
   },
   "devDependencies": {
-    "@rslib/core": "^0.15.0",
+    "@rslib/core": "^0.15.1",
     "@types/babel__core": "^7.20.5",
     "@types/babel__traverse": "^7.28.0",
     "@types/bun": "latest",
-    "@types/node": "^22.18.6",
+    "@types/node": "^24.10.8",
     "json5": "^2.2.3",
     "supports-color": "^10.2.2",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "prettier": "^3.7.3"
+    "prettier": "^3.8.0"
   },
   "scripts": {
     "build": "rslib build",