tz-clean 2.0.0 → 2.0.2

package/.dependency-cruiser.cjs

@@ -1,94 +1,94 @@
-/** @type {import('dependency-cruiser').IConfiguration} */
-module.exports = {
-  forbidden: [
-    {
-      comment: 'This dependency is part of a circular relationship.',
-      from: {},
-      name: 'no-circular',
-      severity: 'error',
-      to: { circular: true },
-    },
-    {
-      comment: "This is an orphan module - it's likely not used.",
-      from: { orphan: true },
-      name: 'no-orphans',
-      severity: 'info',
-      to: {},
-    },
-    {
-      comment: 'A module depends on a node core module that has been deprecated.',
-      from: {},
-      name: 'no-deprecated-core',
-      severity: 'warn',
-      to: {
-        dependencyTypes: ['core'],
-        path: [
-          '^v8/tools/codemap$',
-          '^v8/tools/consarray$',
-          '^v8/tools/csvparser$',
-          '^v8/tools/logreader$',
-          '^v8/tools/profile_view$',
-          '^v8/tools/profile$',
-          '^v8/tools/SourceMap$',
-          '^v8/tools/splaytree$',
-          '^v8/tools/tickprocessor-driver$',
-          '^v8/tools/tickprocessor$',
-          '^node-inspect/lib/_inspect$',
-          '^node-inspect/lib/internal/inspect_client$',
-          '^node-inspect/lib/internal/inspect_repl$',
-          '^async_hooks$',
-          '^assert$',
-          '^punycode$',
-          '^domain$',
-          '^constants$',
-          '^sys$',
-          '^_linklist$',
-          '^_stream_wrap$',
-        ],
-      },
-    },
-    {
-      comment: 'This module depends on a module that cannot be found.',
-      from: {},
-      name: 'not-to-unresolvable',
-      severity: 'error',
-      to: { couldNotResolve: true },
-    },
-    {
-      comment:
-        'Likely this module depends on an external npm package that occurs more than once in your package.json i.e. bot as a devDependencies and in dependencies.',
-      from: {},
-      name: 'no-duplicate-dep-types',
-      severity: 'warn',
-      to: { dependencyTypesNot: ['type-only'], moreThanOneDependencyType: true },
-    },
-    {
-      comment:
-        "This module depends on a spec (test) file. The sole responsibility of a spec file is to test code. If there's something in a spec that's of use to other modules, it doesn't belong in that spec. Please move it to a safe utility module elsewhere.",
-      from: {},
-      name: 'not-to-spec',
-      severity: 'error',
-      to: { path: '\\.(spec|test)\\.(js|mjs|cjs|ts|ls|coffee|litcoffee|coffee\\.md)$' },
-    },
-    {
-      comment:
-        'This module depends on an npm package from the "devDependencies" section of your package.json. It looks like something that ships to production, though.',
-      from: { path: '^(src|index\\.js)' },
-      name: 'not-to-dev-dep',
-      severity: 'error',
-      to: { dependencyTypes: ['npm-dev'] },
-    },
-  ],
-  options: {
-    doNotFollow: { path: 'node_modules' },
-    enhancedResolveOptions: {
-      conditionNames: ['import', 'require', 'node', 'default'],
-      exportsFields: ['exports'],
-    },
-    reporterOptions: {
-      archi: { collapsePattern: '^(packages|src|lib|app|bin|test(s?)|__tests__|__mocks__)/[^/]+' },
-      dot: { collapsePattern: 'node_modules/[^/]+' },
-    },
-    tsPreCompilationDeps: true,
-  },
-};
+/** @type {import('dependency-cruiser').IConfiguration} */
+module.exports = {
+  forbidden: [
+    {
+      comment: 'This dependency is part of a circular relationship.',
+      from: {},
+      name: 'no-circular',
+      severity: 'error',
+      to: { circular: true },
+    },
+    {
+      comment: "This is an orphan module - it's likely not used.",
+      from: { orphan: true },
+      name: 'no-orphans',
+      severity: 'info',
+      to: {},
+    },
+    {
+      comment: 'A module depends on a node core module that has been deprecated.',
+      from: {},
+      name: 'no-deprecated-core',
+      severity: 'warn',
+      to: {
+        dependencyTypes: ['core'],
+        path: [
+          '^v8/tools/codemap$',
+          '^v8/tools/consarray$',
+          '^v8/tools/csvparser$',
+          '^v8/tools/logreader$',
+          '^v8/tools/profile_view$',
+          '^v8/tools/profile$',
+          '^v8/tools/SourceMap$',
+          '^v8/tools/splaytree$',
+          '^v8/tools/tickprocessor-driver$',
+          '^v8/tools/tickprocessor$',
+          '^node-inspect/lib/_inspect$',
+          '^node-inspect/lib/internal/inspect_client$',
+          '^node-inspect/lib/internal/inspect_repl$',
+          '^async_hooks$',
+          '^assert$',
+          '^punycode$',
+          '^domain$',
+          '^constants$',
+          '^sys$',
+          '^_linklist$',
+          '^_stream_wrap$',
+        ],
+      },
+    },
+    {
+      comment: 'This module depends on a module that cannot be found.',
+      from: {},
+      name: 'not-to-unresolvable',
+      severity: 'error',
+      to: { couldNotResolve: true },
+    },
+    {
+      comment:
+        'Likely this module depends on an external npm package that occurs more than once in your package.json i.e. bot as a devDependencies and in dependencies.',
+      from: {},
+      name: 'no-duplicate-dep-types',
+      severity: 'warn',
+      to: { dependencyTypesNot: ['type-only'], moreThanOneDependencyType: true },
+    },
+    {
+      comment:
+        "This module depends on a spec (test) file. The sole responsibility of a spec file is to test code. If there's something in a spec that's of use to other modules, it doesn't belong in that spec. Please move it to a safe utility module elsewhere.",
+      from: {},
+      name: 'not-to-spec',
+      severity: 'error',
+      to: { path: '\\.(spec|test)\\.(js|mjs|cjs|ts|ls|coffee|litcoffee|coffee\\.md)$' },
+    },
+    {
+      comment:
+        'This module depends on an npm package from the "devDependencies" section of your package.json. It looks like something that ships to production, though.',
+      from: { path: '^(src|index\\.js)' },
+      name: 'not-to-dev-dep',
+      severity: 'error',
+      to: { dependencyTypes: ['npm-dev'] },
+    },
+  ],
+  options: {
+    doNotFollow: { path: 'node_modules' },
+    enhancedResolveOptions: {
+      conditionNames: ['import', 'require', 'node', 'default'],
+      exportsFields: ['exports'],
+    },
+    reporterOptions: {
+      archi: { collapsePattern: '^(packages|src|lib|app|bin|test(s?)|__tests__|__mocks__)/[^/]+' },
+      dot: { collapsePattern: 'node_modules/[^/]+' },
+    },
+    tsPreCompilationDeps: true,
+  },
+};

package/.github/workflows/ci.yml

@@ -1,42 +1,42 @@
-name: CI
-
-on:
-  push:
-    branches: ['main']
-  pull_request:
-    branches: ['main']
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version: [18.x, 20.x, 22.x]
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: 'npm'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Run Typecheck
-        run: npm run typecheck
-
-      - name: Run Linter
-        run: npm run lint
-
-      - name: Run Architecture Validation (Dependency Cruiser)
-        run: npm run cruise
-
-      - name: Run Code Spell Checker
-        run: npm run spellcheck
-
-      - name: Run Tests
-        run: npm run test
+name: CI
+
+on:
+  push:
+    branches: ['main']
+  pull_request:
+    branches: ['main']
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x, 22.x]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run Typecheck
+        run: npm run typecheck
+
+      - name: Run Linter
+        run: npm run lint
+
+      - name: Run Architecture Validation (Dependency Cruiser)
+        run: npm run cruise
+
+      - name: Run Code Spell Checker
+        run: npm run spellcheck
+
+      - name: Run Tests
+        run: npm run test

package/.husky/commit-msg

@@ -1 +1 @@
-npx --no-install commitlint --edit "$1"
+npx --no-install commitlint --edit "$1"

package/.husky/pre-commit

@@ -1 +1 @@
-npx lint-staged
+npx lint-staged

package/.husky/pre-push

@@ -1,3 +1,3 @@
-npm run test
-npm run cruise
-npm run spellcheck
+npm run test
+npm run cruise
+npm run spellcheck

package/.prettierrc

@@ -1,9 +1,9 @@
-{
-  "semi": true,
-  "trailingComma": "all",
-  "singleQuote": true,
-  "printWidth": 120,
-  "tabWidth": 2,
-  "bracketSameLine": true,
-  "htmlWhitespaceSensitivity": "ignore"
-}
+{
+  "semi": true,
+  "trailingComma": "all",
+  "singleQuote": true,
+  "printWidth": 120,
+  "tabWidth": 2,
+  "bracketSameLine": true,
+  "htmlWhitespaceSensitivity": "ignore"
+}

package/README-DEV.md

@@ -1,123 +1,123 @@
-# Developer Guide: tz-clean 🛠️
-
-This guide is for developers who want to contribute to the `tz-clean` project, test it locally, or publish it to the npm registry.
-
-## Local Development (For Contributors)
-
-If you are modifying this tool and want to test it locally, clone the repository and install dependencies:
-
-```bash
-npm install
-```
-
-### Available Scripts
-
-You can run the individual scripts locally within this repository:
-
-- `npm run format`: Runs Prettier.
-- `npm run lint`: Runs ESLint without auto-fixing.
-- `npm run lint:fix`: Runs ESLint with auto-fixing.
-- `npm run typecheck`: Runs TypeScript type validation.
-- `npm run fix`: Runs format, lint:fix, and typecheck sequentially.
-
-## Testing the CLI Locally
-
-Before publishing, you should test the global CLI command locally on your computer.
-
-1. Open a terminal inside this project folder (`tz-clean`).
-2. Run this command to install your package globally from the local folder:
-   ```bash
-   npm install -g .
-   ```
-   _(Alternatively, you can use `npm link`)_
-3. Open another folder/repo in your terminal, and type the command:
-   ```bash
-   tz-clean
-   ```
-   If it runs successfully, your configuration is correct.
-
-## Publishing to the NPM Registry
-
-To make the package available via `npm install -g tz-clean` on any computer, you must publish it to the NPM Registry.
-
-1. **Create an NPM account**: If you don't have one, register at [npmjs.com](https://www.npmjs.com/).
-2. **Login via Terminal**: Run `npm login` and enter your account credentials.
-3. **Publish**: Run the `npm publish` command inside your project folder.
-
-### Important Note on Package Names
-
-The package name `tz-clean` is very common and likely already taken in the NPM registry. If it is, `npm publish` will fail with a `403 Forbidden` or `Conflict` error.
-
-If this happens, use a **Scoped Package**:
-
-1. Change `"name"` in `package.json` to `@your-npm-username/tz-clean` (example: `@terzogenito/tz-clean`).
-2. Run `npm publish --access public`.
-3. The install command will become `npm install -g @your-username/tz-clean`.
-4. The executable command in the terminal will remain `tz-clean`, as defined in the `"bin"` property of `package.json`.
-
-## Future Development / Roadmap
-
-To further improve code quality and the development workflow, the following features are planned for future integration into this tool or as recommendations for target projects:
-
-1. **Git Hooks & `lint-staged` (Husky)**: Automating `tz-clean` to run only on staged files before every `git commit`, preventing dirty code from entering the repository.
-2. **Testing Framework (Vitest / Jest)**: Adding unit and integration tests to ensure the CLI itself and target applications function correctly.
-3. **Commitlint**: Enforcing _Conventional Commits_ to standardize git history and enable automated `CHANGELOG.md` generation.
-4. **CI/CD Pipelines (GitHub Actions)**: Setting up automated workflows to run linting, formatting, and tests on every Push or Pull Request.
-5. **CSpell**: Integrating a code spelling checker to catch typos in variables, comments, and strings.
-6. **Security & Dependency Audit**: Incorporating automated security checks (like `npm audit` or Dependabot) to keep dependencies secure and up-to-date.
-
-### Advanced Static Code Analysis (Code Smells & Architecture)
-
-Untuk mendeteksi _spaghetti code_, fungsi berulang, dan pelanggaran prinsip _clean code_ (seperti SOLID), fitur berikut dapat ditambahkan di masa depan:
-
-1. **SonarJS (`eslint-plugin-sonarjs`)**: Mendeteksi kode yang terlalu kompleks (_spaghetti code_), _bug_ tersembunyi, dan logika yang tidak efisien berdasarkan standar SonarQube.
-2. **Knip**: Alat khusus untuk mendeteksi _unused files_, _unused exports_, dan _unused dependencies_. Sangat ampuh untuk membersihkan _boilerplate_ dan definisi yang tidak pernah dipakai.
-3. **Copy/Paste Detector (`jscpd`)**: Secara programatis mendeteksi blok kode atau fungsi yang diduplikasi/di- _copy-paste_ di berbagai file (mencegah _un-reusable function_).
-4. **Cyclomatic Complexity Limits**: Menerapkan batasan kompleksitas maksimum pada fungsi (via ESLint `complexity` rule) untuk memastikan penerapan _Single Responsibility Principle_ (SRP) dari SOLID.
-
-### The "Ultimate Perfection" (Architecture & Reliability)
-
-Untuk mencapai level "sempurna" secara rekayasa perangkat lunak (Software Engineering), beberapa lapisan validasi tingkat lanjut ini dapat diterapkan:
-
-1. **Dependency Cruiser**: Mengamankan arsitektur proyek (seperti _Clean Architecture_). Mencegah pelanggaran aturan dependensi (contoh: _UI layer_ dilarang _import_ langsung dari _Database layer_) dan mendeteksi dependensi melingkar (_circular dependencies_).
-2. **Mutation Testing (Stryker)**: "Menguji unit test Anda". Tool ini secara sengaja menyuntikkan _bug_ kecil ke dalam kode (mutasi). Jika _unit test_ Anda tetap berstatus "Lulus" (Pass) padahal ada _bug_, berarti test Anda lemah. Ini menjamin kualitas _test suite_ yang absolut.
-3. **Bundle Size Limit (`size-limit`)**: Terutama untuk aplikasi Frontend atau Library, ini akan membatalkan _commit/build_ jika perubahan kode membuat ukuran aplikasi melebihi batas performa kilobyte yang diizinkan.
-4. **Documentation Enforcement (`eslint-plugin-jsdoc`)**: Memaksa agar setiap _function_, parameter, dan tipe data memiliki komentar penjelasan (JSDoc/TSDoc) yang standar, sehingga kode 100% terdokumentasi dengan baik.
-
-### Micro-level Formatting & Strict Conventions
-
-Untuk mencapai keteraturan tingkat mikroskopis (penamaan, pengurutan, dan struktur file), fitur-fitur ini sangat direkomendasikan:
-
-1. **Strict Naming Conventions (`@typescript-eslint/naming-convention`)**: Memaksa aturan penamaan yang mutlak. Contoh: _Class_ wajib `PascalCase`, variabel `camelCase`, konstanta `UPPER_CASE`. Juga dapat digunakan untuk melarang penggunaan nama variabel yang tidak jelas seperti `data`, `temp`, `info`, atau `val`.
-2. **Absolute Sorting (`eslint-plugin-perfectionist` / `simple-import-sort`)**: Alat ini akan secara otomatis (via `--fix`) mengurutkan semua baris kode Anda sesuai abjad atau logika:
-   - Mengurutkan dan mengelompokkan `import` di bagian atas file.
-   - Mengurutkan _keys_ (kunci) di dalam suatu _Object_ atau _Interface_.
-   - Mengurutkan urutan _method/function_ di dalam sebuah _Class_ (misal: _constructor_ di atas, fungsi _public_ di tengah, _private_ di bawah).
-3. **File Structure & Boundaries (`eslint-plugin-project-structure`)**: Memaksa konsistensi struktur folder proyek. Misalnya, memaksa agar semua file test (`*.test.js`) wajib berada di folder `__tests__`, atau komponen _frontend_ dilarang berada di luar folder `components/`. Ini membuat proses _refactoring_ file menjadi sangat tertib.
-
-### Dependency Management & Security Monitoring
-
-Untuk memastikan paket (_packages/libraries_) yang Anda gunakan selalu stabil, aman dari _hacker_ (bebas _vulnerability_), dan mutakhir (_up-to-date_):
-
-1. **`npm-check-updates` (ncu)**: Alat CLI interaktif untuk mengecek secara spesifik mana saja _library_ di `package.json` yang sudah usang (_outdated_), lalu membantu Anda meng-upgrade versinya ke versi stabil terbaru tanpa merusak proyek.
-2. **Dependabot / Renovate Bot**: Bot otomatis (biasanya di GitHub/GitLab) yang bekerja 24/7 di latar belakang. Jika ada versi _library_ baru atau jika ada _bug_ keamanan yang baru ditemukan pada versi yang Anda gunakan, bot ini akan langsung membuatkan _Pull Request_ otomatis untuk memperbaruinya.
-3. **Snyk**: Standar industri tingkat _Enterprise_ untuk keamanan _open-source_. Snyk akan memindai seluruh rantai _dependencies_ Anda (bahkan _library_ di dalam _library_), menemukan kerentanan (_vulnerabilities_), dan mendeteksi apakah lisensi _library_ tersebut legal untuk digunakan.
-4. **`npm audit`**: Fitur bawaan NPM yang akan memberikan peringatan (dan solusi `npm audit fix`) apabila terdapat _library_ yang terjangkit laporan cacat keamanan (CVE - _Common Vulnerabilities and Exposures_).
-
-### UI Dashboards & Visual Reports
-
-Jika Anda ingin alat CLI Anda tidak hanya mencetak teks di terminal, tetapi juga menghasilkan laporan visual berbasis web (UI) yang indah mengenai kesehatan kode:
-
-1. **Plato (Code Complexity Dashboard)**: Tool ini membaca kode JavaScript/TypeScript Anda dan menghasilkan laporan HTML statis yang indah. Anda bisa melihat grafik _maintainability_ (skor kemudahan _maintenance_), ukuran file, dan kompleksitas per file dalam bentuk grafik interaktif.
-2. **SonarQube / SonarCloud Dashboard**: Jika Anda menghubungkan proyek Anda ke SonarCloud, Anda akan mendapatkan sebuah _Dashboard UI_ profesional yang melacak _Technical Debt_ (Berapa hari/jam yang dibutuhkan untuk memperbaiki semua kode buruk), jumlah _code smells_, dan tingkat keandalan kode dari waktu ke waktu.
-3. **Istanbul / NYC (Test Coverage UI)**: Menghasilkan sebuah _website_ HTML mini di komputer pengguna yang menampilkan secara persis baris kode mana saja yang berwarna merah (belum dites) dan baris mana yang berwarna hijau (sudah dilewati oleh _Unit Test_).
-4. **Webpack Bundle Analyzer / Statoscope**: Menghasilkan UI berupa peta interaktif (TreeMap) yang memperlihatkan _library_ mana saja yang menyedot kapasitas memori aplikasi Anda paling besar, sehingga memudahkan pengguna untuk memangkas _library_ yang berat.
-
-### Custom UI Reporting Architecture (No 3rd Party UI Modules)
-
-Jika Anda ingin membangun UI analisis kode 100% buatan sendiri (tanpa modul pihak ketiga seperti Plato/SonarQube), CLI `tz-clean` dapat merakit laporannya sendiri dengan arsitektur berikut:
-
-1. **Data Extraction (Node.js API)**: CLI mengeksekusi ESLint API dan TypeScript Compiler API secara internal (_programmatically_), lalu menangkap _output error/warnings/complexity_ dalam format JSON asli, bukan teks string ke terminal.
-2. **Template Injector**: Anda membuat template `index.html`, `style.css`, dan `app.js` mentah di dalam _source code_ CLI Anda.
-3. **HTML Generation**: CLI akan membaca file JSON hasil analisis, lalu "menyuntikkannya" (inject) ke dalam tag `<script> const reportData = {...} </script>` di dalam template HTML buatan Anda.
-4. **Auto-Launch Browser**: CLI kemudian menyimpan `report.html` tersebut di folder sementara (sementara/lokal) pengguna, lalu menggunakan modul Node.js (misal: eksekusi command `start` di Windows atau `open` di Mac) untuk otomatis membuka _file_ HTML tersebut di browser bawaan pengguna.
+# Developer Guide: tz-clean 🛠️
+
+This guide is for developers who want to contribute to the `tz-clean` project, test it locally, or publish it to the npm registry.
+
+## Local Development (For Contributors)
+
+If you are modifying this tool and want to test it locally, clone the repository and install dependencies:
+
+```bash
+npm install
+```
+
+### Available Scripts
+
+You can run the individual scripts locally within this repository:
+
+- `npm run format`: Runs Prettier.
+- `npm run lint`: Runs ESLint without auto-fixing.
+- `npm run lint:fix`: Runs ESLint with auto-fixing.
+- `npm run typecheck`: Runs TypeScript type validation.
+- `npm run fix`: Runs format, lint:fix, and typecheck sequentially.
+
+## Testing the CLI Locally
+
+Before publishing, you should test the global CLI command locally on your computer.
+
+1. Open a terminal inside this project folder (`tz-clean`).
+2. Run this command to install your package globally from the local folder:
+   ```bash
+   npm install -g .
+   ```
+   _(Alternatively, you can use `npm link`)_
+3. Open another folder/repo in your terminal, and type the command:
+   ```bash
+   tz-clean
+   ```
+   If it runs successfully, your configuration is correct.
+
+## Publishing to the NPM Registry
+
+To make the package available via `npm install -g tz-clean` on any computer, you must publish it to the NPM Registry.
+
+1. **Create an NPM account**: If you don't have one, register at [npmjs.com](https://www.npmjs.com/).
+2. **Login via Terminal**: Run `npm login` and enter your account credentials.
+3. **Publish**: Run the `npm publish` command inside your project folder.
+
+### Important Note on Package Names
+
+The package name `tz-clean` is very common and likely already taken in the NPM registry. If it is, `npm publish` will fail with a `403 Forbidden` or `Conflict` error.
+
+If this happens, use a **Scoped Package**:
+
+1. Change `"name"` in `package.json` to `@your-npm-username/tz-clean` (example: `@terzogenito/tz-clean`).
+2. Run `npm publish --access public`.
+3. The install command will become `npm install -g @your-username/tz-clean`.
+4. The executable command in the terminal will remain `tz-clean`, as defined in the `"bin"` property of `package.json`.
+
+## Future Development / Roadmap
+
+To further improve code quality and the development workflow, the following features are planned for future integration into this tool or as recommendations for target projects:
+
+1. **Git Hooks & `lint-staged` (Husky)**: Automating `tz-clean` to run only on staged files before every `git commit`, preventing dirty code from entering the repository.
+2. **Testing Framework (Vitest / Jest)**: Adding unit and integration tests to ensure the CLI itself and target applications function correctly.
+3. **Commitlint**: Enforcing _Conventional Commits_ to standardize git history and enable automated `CHANGELOG.md` generation.
+4. **CI/CD Pipelines (GitHub Actions)**: Setting up automated workflows to run linting, formatting, and tests on every Push or Pull Request.
+5. **CSpell**: Integrating a code spelling checker to catch typos in variables, comments, and strings.
+6. **Security & Dependency Audit**: Incorporating automated security checks (like `npm audit` or Dependabot) to keep dependencies secure and up-to-date.
+
+### Advanced Static Code Analysis (Code Smells & Architecture)
+
+Untuk mendeteksi _spaghetti code_, fungsi berulang, dan pelanggaran prinsip _clean code_ (seperti SOLID), fitur berikut dapat ditambahkan di masa depan:
+
+1. **SonarJS (`eslint-plugin-sonarjs`)**: Mendeteksi kode yang terlalu kompleks (_spaghetti code_), _bug_ tersembunyi, dan logika yang tidak efisien berdasarkan standar SonarQube.
+2. **Knip**: Alat khusus untuk mendeteksi _unused files_, _unused exports_, dan _unused dependencies_. Sangat ampuh untuk membersihkan _boilerplate_ dan definisi yang tidak pernah dipakai.
+3. **Copy/Paste Detector (`jscpd`)**: Secara programatis mendeteksi blok kode atau fungsi yang diduplikasi/di- _copy-paste_ di berbagai file (mencegah _un-reusable function_).
+4. **Cyclomatic Complexity Limits**: Menerapkan batasan kompleksitas maksimum pada fungsi (via ESLint `complexity` rule) untuk memastikan penerapan _Single Responsibility Principle_ (SRP) dari SOLID.
+
+### The "Ultimate Perfection" (Architecture & Reliability)
+
+Untuk mencapai level "sempurna" secara rekayasa perangkat lunak (Software Engineering), beberapa lapisan validasi tingkat lanjut ini dapat diterapkan:
+
+1. **Dependency Cruiser**: Mengamankan arsitektur proyek (seperti _Clean Architecture_). Mencegah pelanggaran aturan dependensi (contoh: _UI layer_ dilarang _import_ langsung dari _Database layer_) dan mendeteksi dependensi melingkar (_circular dependencies_).
+2. **Mutation Testing (Stryker)**: "Menguji unit test Anda". Tool ini secara sengaja menyuntikkan _bug_ kecil ke dalam kode (mutasi). Jika _unit test_ Anda tetap berstatus "Lulus" (Pass) padahal ada _bug_, berarti test Anda lemah. Ini menjamin kualitas _test suite_ yang absolut.
+3. **Bundle Size Limit (`size-limit`)**: Terutama untuk aplikasi Frontend atau Library, ini akan membatalkan _commit/build_ jika perubahan kode membuat ukuran aplikasi melebihi batas performa kilobyte yang diizinkan.
+4. **Documentation Enforcement (`eslint-plugin-jsdoc`)**: Memaksa agar setiap _function_, parameter, dan tipe data memiliki komentar penjelasan (JSDoc/TSDoc) yang standar, sehingga kode 100% terdokumentasi dengan baik.
+
+### Micro-level Formatting & Strict Conventions
+
+Untuk mencapai keteraturan tingkat mikroskopis (penamaan, pengurutan, dan struktur file), fitur-fitur ini sangat direkomendasikan:
+
+1. **Strict Naming Conventions (`@typescript-eslint/naming-convention`)**: Memaksa aturan penamaan yang mutlak. Contoh: _Class_ wajib `PascalCase`, variabel `camelCase`, konstanta `UPPER_CASE`. Juga dapat digunakan untuk melarang penggunaan nama variabel yang tidak jelas seperti `data`, `temp`, `info`, atau `val`.
+2. **Absolute Sorting (`eslint-plugin-perfectionist` / `simple-import-sort`)**: Alat ini akan secara otomatis (via `--fix`) mengurutkan semua baris kode Anda sesuai abjad atau logika:
+   - Mengurutkan dan mengelompokkan `import` di bagian atas file.
+   - Mengurutkan _keys_ (kunci) di dalam suatu _Object_ atau _Interface_.
+   - Mengurutkan urutan _method/function_ di dalam sebuah _Class_ (misal: _constructor_ di atas, fungsi _public_ di tengah, _private_ di bawah).
+3. **File Structure & Boundaries (`eslint-plugin-project-structure`)**: Memaksa konsistensi struktur folder proyek. Misalnya, memaksa agar semua file test (`*.test.js`) wajib berada di folder `__tests__`, atau komponen _frontend_ dilarang berada di luar folder `components/`. Ini membuat proses _refactoring_ file menjadi sangat tertib.
+
+### Dependency Management & Security Monitoring
+
+Untuk memastikan paket (_packages/libraries_) yang Anda gunakan selalu stabil, aman dari _hacker_ (bebas _vulnerability_), dan mutakhir (_up-to-date_):
+
+1. **`npm-check-updates` (ncu)**: Alat CLI interaktif untuk mengecek secara spesifik mana saja _library_ di `package.json` yang sudah usang (_outdated_), lalu membantu Anda meng-upgrade versinya ke versi stabil terbaru tanpa merusak proyek.
+2. **Dependabot / Renovate Bot**: Bot otomatis (biasanya di GitHub/GitLab) yang bekerja 24/7 di latar belakang. Jika ada versi _library_ baru atau jika ada _bug_ keamanan yang baru ditemukan pada versi yang Anda gunakan, bot ini akan langsung membuatkan _Pull Request_ otomatis untuk memperbaruinya.
+3. **Snyk**: Standar industri tingkat _Enterprise_ untuk keamanan _open-source_. Snyk akan memindai seluruh rantai _dependencies_ Anda (bahkan _library_ di dalam _library_), menemukan kerentanan (_vulnerabilities_), dan mendeteksi apakah lisensi _library_ tersebut legal untuk digunakan.
+4. **`npm audit`**: Fitur bawaan NPM yang akan memberikan peringatan (dan solusi `npm audit fix`) apabila terdapat _library_ yang terjangkit laporan cacat keamanan (CVE - _Common Vulnerabilities and Exposures_).
+
+### UI Dashboards & Visual Reports
+
+Jika Anda ingin alat CLI Anda tidak hanya mencetak teks di terminal, tetapi juga menghasilkan laporan visual berbasis web (UI) yang indah mengenai kesehatan kode:
+
+1. **Plato (Code Complexity Dashboard)**: Tool ini membaca kode JavaScript/TypeScript Anda dan menghasilkan laporan HTML statis yang indah. Anda bisa melihat grafik _maintainability_ (skor kemudahan _maintenance_), ukuran file, dan kompleksitas per file dalam bentuk grafik interaktif.
+2. **SonarQube / SonarCloud Dashboard**: Jika Anda menghubungkan proyek Anda ke SonarCloud, Anda akan mendapatkan sebuah _Dashboard UI_ profesional yang melacak _Technical Debt_ (Berapa hari/jam yang dibutuhkan untuk memperbaiki semua kode buruk), jumlah _code smells_, dan tingkat keandalan kode dari waktu ke waktu.
+3. **Istanbul / NYC (Test Coverage UI)**: Menghasilkan sebuah _website_ HTML mini di komputer pengguna yang menampilkan secara persis baris kode mana saja yang berwarna merah (belum dites) dan baris mana yang berwarna hijau (sudah dilewati oleh _Unit Test_).
+4. **Webpack Bundle Analyzer / Statoscope**: Menghasilkan UI berupa peta interaktif (TreeMap) yang memperlihatkan _library_ mana saja yang menyedot kapasitas memori aplikasi Anda paling besar, sehingga memudahkan pengguna untuk memangkas _library_ yang berat.
+
+### Custom UI Reporting Architecture (No 3rd Party UI Modules)
+
+Jika Anda ingin membangun UI analisis kode 100% buatan sendiri (tanpa modul pihak ketiga seperti Plato/SonarQube), CLI `tz-clean` dapat merakit laporannya sendiri dengan arsitektur berikut:
+
+1. **Data Extraction (Node.js API)**: CLI mengeksekusi ESLint API dan TypeScript Compiler API secara internal (_programmatically_), lalu menangkap _output error/warnings/complexity_ dalam format JSON asli, bukan teks string ke terminal.
+2. **Template Injector**: Anda membuat template `index.html`, `style.css`, dan `app.js` mentah di dalam _source code_ CLI Anda.
+3. **HTML Generation**: CLI akan membaca file JSON hasil analisis, lalu "menyuntikkannya" (inject) ke dalam tag `<script> const reportData = {...} </script>` di dalam template HTML buatan Anda.
+4. **Auto-Launch Browser**: CLI kemudian menyimpan `report.html` tersebut di folder sementara (sementara/lokal) pengguna, lalu menggunakan modul Node.js (misal: eksekusi command `start` di Windows atau `open` di Mac) untuk otomatis membuka _file_ HTML tersebut di browser bawaan pengguna.