eslint-config-ardelint

Shareable ESLint config untuk proyek Next.js + TypeScript. Fokus pada:

• Konsistensi impor/ekspor dan penghapusan import/variabel yang tidak terpakai
• Dukungan React Hooks dan aturan Next.js yang relevan
• Siap pakai untuk aplikasi produksi (ignore build output)

Fitur Utama

• Base presets

  • eslint:recommended untuk aturan dasar JavaScript
  • next/core-web-vitals untuk praktik Next.js dan React terbaik
  • prettier untuk menghindari konflik dengan format Prettier

• TypeScript support

  • parser: @typescript-eslint/parser agar ESLint memahami sintaks TS/TSX
  • Override untuk file *.ts/*.tsx:
    • no-undef: off agar tidak ada false positive di proyek TS
    • @typescript-eslint/no-explicit-any: off bila perlu menggunakan any
    • react-hooks/exhaustive-deps: warn agar dependency Hooks tetap diawasi
    • no-unused-vars: ["error", { "argsIgnorePattern": "^_" }] untuk argumen yang sengaja diabaikan

• React Hooks

  • react-hooks/rules-of-hooks: error (tersedia via Next plugin)
  • react-hooks/exhaustive-deps: off secara global, dan warn di TS override untuk fleksibilitas

• Unused imports & variables (bersih otomatis)

  • unused-imports/no-unused-imports: error menghapus import yang tidak dipakai
  • unused-imports/no-unused-vars: ["error", { "vars": "all", "varsIgnorePattern": "^_", "args": "after-used", "argsIgnorePattern": "^_" }]
    • Memaklumi pola _ sebagai variabel/argumen yang diabaikan

• Import/Export sorting (rapi dan konsisten)

  • simple-import-sort/imports: error dengan grup khusus:
    • React & packages: ^react, ^@?\\w
    • Parent: ^\\.\\.(?!/?$), ^\\.\\./?$
    • Relative & same-folder: ^\\./(?=.*/)(?!/?$), ^\\.(?!/?$), ^\\./?$
    • Internal: ^(@/|components)(/.*|$)
    • Side-effect: ^\\u0000
    • Style: ^.+\\.?(scss)$
  • simple-import-sort/exports: error untuk ekspor yang rapi

• Aturan Next spesifik

  • @next/next/no-sync-scripts: off (mengizinkan penggunaan script sinkron saat diperlukan)
  • @next/next/no-html-link-for-pages: off di TS override (berguna jika routing tidak menggunakan heuristik default)

• Lingkungan & ignore

  • env: es6, browser, node
  • ignorePatterns: .next/**, dist/**, build/**, coverage/**, node_modules/**

Instalasi

Pilih salah satu pendekatan berikut (tergantung bagaimana paket ini Anda publish):

• Jika paket ini membundel plugin sebagai dependencies:

  yarn add -D eslint-config-ardelint eslint

  Cukup install eslint di proyek konsumen; plugin akan ikut terpasang.

• Jika paket ini mendeklarasikan plugin sebagai peerDependencies:

  yarn add -D eslint-config-ardelint eslint eslint-config-next prettier eslint-plugin-import eslint-plugin-simple-import-sort eslint-plugin-unused-imports @typescript-eslint/parser @typescript-eslint/eslint-plugin

Pemakaian

Tambahkan di ./.eslintrc.json proyek Anda:

{
  "extends": ["ardelint"]
}

Opsional: pastikan .eslintignore mengabaikan output build:

.next
dist
build
coverage
node_modules