refactor: improve and standardize import order (#933)

refactor: improve import order

.prettierrc

@@ -14,6 +14,15 @@
   "endOfLine": "auto",
   "embeddedLanguageFormatting": "auto",
   "singleAttributePerLine": false,
+  "plugins": ["@ianvs/prettier-plugin-sort-imports"],
+  "importOrder": [
+    "<TYPES>^(node:)",
+    "<TYPES>",
+    "<TYPES>^[.]",
+    "<BUILTIN_MODULES>",
+    "<THIRD_PARTY_MODULES>",
+    "^[.]"
+  ],
   "overrides": [
     {
       "files": "*.jsonc",

package.json

@@ -51,6 +51,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
+    "@ianvs/prettier-plugin-sort-imports": "^4.4.1",
     "@types/node": "^22.12.0",
     "c8": "^10.1.3",
     "jsonc.min": "^1.1.0",

src/@types/poku.ts

@@ -1,8 +1,8 @@
 import type { AssertionError } from 'node:assert';
 import type { results } from '../configs/poku.js';
-import type { Configs as ListFilesConfigs } from './list-files.js';
 import type { ProcessAssertionOptions } from './assert.js';
 import type { DescribeOptions } from './describe.js';
+import type { Configs as ListFilesConfigs } from './list-files.js';
 
 type CustomString = string & NonNullable<unknown>;
 

src/bin/help.ts

@@ -1,5 +1,5 @@
 import { format } from '../services/format.js';
-import { log, hr } from '../services/write.js';
+import { hr, log } from '../services/write.js';
 
 const b = (text: string) => `${format(text).bold()}`;
 const i = (text: string) => `${format(text).italic()}`;

src/bin/index.ts

@@ -1,14 +1,13 @@
 #! /usr/bin/env node
-import { escapeRegExp } from '../modules/helpers/list-files.js';
-import { getArg, getPaths, hasArg, argToArray } from '../parsers/get-arg.js';
-import { states } from '../configs/poku.js';
-import { format } from '../services/format.js';
-import { kill } from '../modules/helpers/kill.js';
-import { envFile } from '../modules/helpers/env.js';
+import { GLOBAL, states, VERSION } from '../configs/poku.js';
 import { poku } from '../modules/essentials/poku.js';
-import { log, hr } from '../services/write.js';
+import { envFile } from '../modules/helpers/env.js';
+import { kill } from '../modules/helpers/kill.js';
+import { escapeRegExp } from '../modules/helpers/list-files.js';
+import { argToArray, getArg, getPaths, hasArg } from '../parsers/get-arg.js';
 import { getConfigs } from '../parsers/options.js';
-import { GLOBAL, VERSION } from '../configs/poku.js';
+import { format } from '../services/format.js';
+import { hr, log } from '../services/write.js';
 
 (async () => {
   /* c8 ignore next 4 */ // Version is tested during build process: "../../tools/build/version.ts"

src/bin/watch.ts

@@ -1,13 +1,14 @@
-import { mapTests, normalizePath } from '../services/map-tests.js';
-import { watch, type Watcher } from '../services/watch.js';
-import { onSigint, poku } from '../modules/essentials/poku.js';
-import { log, hr } from '../services/write.js';
+import type { Watcher } from '../services/watch.js';
 import process from 'node:process';
-import { format } from '../services/format.js';
+import { GLOBAL } from '../configs/poku.js';
+import { onSigint, poku } from '../modules/essentials/poku.js';
 import { getArg } from '../parsers/get-arg.js';
 import { availableParallelism } from '../polyfills/os.js';
-import { GLOBAL } from '../configs/poku.js';
+import { format } from '../services/format.js';
+import { mapTests, normalizePath } from '../services/map-tests.js';
 import { errors } from '../services/reporters/poku.js';
+import { watch } from '../services/watch.js';
+import { hr, log } from '../services/write.js';
 
 export const startWatch = async (dirs: string[]) => {
   let isRunning = false;

src/builders/assert.ts

@@ -1,6 +1,6 @@
-import type { ProcessAssertionOptions } from '../@types/assert.js';
 import type assert from 'node:assert';
 import type { AssertPredicate } from 'node:assert';
+import type { ProcessAssertionOptions } from '../@types/assert.js';
 import { processAssert, processAsyncAssert } from '../services/assert.js';
 
 export const createAssert = (nodeAssert: typeof assert) => {