impsortjs

impsortjs adalah alat CLI yang secara otomatis mengurutkan pernyataan import (ESM) dan require (CommonJS) dalam file JavaScript dan TypeScript. Alat ini membantu menjaga konsistensi kode dengan mengurutkan impor berdasarkan kategori:

1. Core Modules → Modul bawaan Node.js (misal: fs, path).
2. Third-Party Modules → Modul dari node_modules (misal: express, chalk).
3. Local Modules → File lokal (./ atau ../).

Fitur

• Mendukung ESM (import) dan CommonJS (require).
• Bekerja untuk file .js, .cjs, .mjs, .jsx, .ts, dan .tsx.
• Memproses semua file dalam direktori kerja secara rekursif.
• Secara otomatis memperbarui file jika urutan impor tidak sesuai.

Instalasi

npm install -g impsortjs

Penggunaan

Jalankan perintah berikut di direktori proyek Anda:

impsort

Alat ini akan secara otomatis menemukan dan mengurutkan semua file yang cocok.

Catatan: Alat ini memerlukan alat lain untuk memformat kode sebelum dan sesudah menggunakan impsortjs agar kode tetap rapi.

Misalnya menggunakan prettier:

prettier -w . && impsort && prettier -w .

Contoh Sebelum & Sesudah

ESM

Sebelum: (berantakan)

import fs from 'fs';
import express from 'express';
import path from 'path';
import chalk from 'chalk';
import utils from './utils.js';
import myModule from './myModule.js';

Sesudah: (lebih rapi)

import fs from 'fs';
import path from 'path';
import chalk from 'chalk';
import express from 'express';
import myModule from './myModule.js';
import utils from './utils.js';

CommonJS

Sebelum: (berantakan)

const fs = require('fs');
const express = require('express');
const path = require('path');
const chalk = require('chalk');
const utils = require('./utils.js');
const myModule = require('./myModule.js');

Sesudah: (lebih rapi)

const fs = require('fs');
const path = require('path');
const chalk = require('chalk');
const express = require('express');
const myModule = require('./myModule.js');
const utils = require('./utils.js');

Bagaimana Cara Kerjanya?

1. Baca package.json untuk mengetahui dependensi yang digunakan dalam proyek.
2. Menganalisis setiap baris kode untuk mendeteksi import dan require.
3. Mengategorikan impor berdasarkan:
   • Core Modules: Modul bawaan Node.js.
   • Third-Party Modules: Modul dari node_modules.
   • Local Modules: File yang dimulai dengan ./ atau ../.
4. Mengurutkan masing-masing kategori secara alfabetis.
5. Menimpa file asli jika ada perubahan.

Konfigurasi

Secara default, alat ini mengabaikan direktori node_modules dan dist.