@sideid/id-profanity-filter 1.9.5 → 1.9.6

package/README.md

@@ -12,6 +12,8 @@ Library JavaScript/TypeScript untuk mendeteksi, menyensor, dan menganalisis kata
 - ⚠️ **Analisis Konten** - Menganalisis tingkat keparahan dan kategori kata kotor
 - 🔒 **Penyensoran** - Menyensor kata-kata kotor dengan berbagai opsi kustomisasi
 - 🗺️ **Dukungan Bahasa Daerah** - Mencakup kata-kata dari berbagai daerah di Indonesia (Jawa, Sunda, Batak, dll)
+- 🧠 **Deteksi Cerdas** - Mendeteksi variasi ejaan, kata terpisah, dan kesamaan kata
+- 🛡️ **Preset** - Preset filter siap pakai untuk berbagai kebutuhan
 - 🔧 **Kustomisasi** - Opsi untuk menambahkan whitelist dan daftar kata kustom
 
 ## Instalasi
@@ -42,7 +44,7 @@ console.log(hasProfanity); // Output: true
 
 // Filter kata kotor (sensorisasi)
 const hasil = filter.filter(teks);
-console.log(hasil.filtered); // Output: "Dasar **** kamu, jangan banyak ****!"
+console.log(hasil.filtered); // Output: "Dasar ***** kamu, jangan banyak *****!"
 console.log(hasil.censored); // Output: 2 (jumlah kata yang disensor)
 
 // Analisis konten
@@ -51,6 +53,26 @@ console.log(analisis.severityScore); // Output: 0.65 (contoh skor keparahan)
 console.log(analisis.categories); // Output: ["profanity", "insult"]
 ```
 
+### Menggunakan Preset
+
+```typescript
+import IDProfanityFilter from '@sideid/id-profanity-filter';
+
+// Buat instance filter dengan preset
+const filter = new IDProfanityFilter();
+filter.usePreset('strict');
+
+// Atau dengan opsi tambahan
+filter.usePreset('childSafe', {
+  replaceWith: '#',
+  useRandomGrawlix: true,
+});
+
+const teks = 'Dasar anjing kamu, jangan banyak bacot!';
+const hasil = filter.filter(teks);
+console.log(hasil.filtered); // Output: "Dasar #@$%& kamu, jangan banyak $!@#%!"
+```
+
 ### Utilitas Langsung
 
 Anda juga dapat menggunakan fungsi utilitas langsung tanpa membuat instance:
@@ -60,7 +82,13 @@ import { idFilter } from '@sideid/id-profanity-filter';
 
 const teks = 'Dasar anjing kamu, jangan banyak bacot!';
 const hasil = idFilter.filter(teks);
-console.log(hasil.filtered); // Output: "Dasar **** kamu, jangan banyak ****!"
+console.log(hasil.filtered); // Output: "Dasar ***** kamu, jangan banyak *****!"
+
+// Menggunakan preset dengan API fungsi statis
+const presetResult = idFilter.filter(
+  teks,
+  idFilter.getPresetOptions('moderate'),
+);
 ```
 
 ## Dokumentasi API
@@ -103,6 +131,7 @@ Menganalisis teks untuk mendapatkan informasi detail tentang kata kotor yang dit
   - `categories`: Kategori kata kotor yang ditemukan
   - `regions`: Daerah asal kata kotor yang ditemukan
   - `severityScore`: Skor keparahan (0-1)
+  - `similarWords`: Kata-kata yang mirip dengan kata kotor (jika deteksi kesamaan diaktifkan)
 
 ##### `batchAnalyze(texts: string[])`
 
@@ -122,6 +151,13 @@ Menganalisis teks dengan konteks di sekitar kata kotor.
 
 - **Hasil**: Array dari kata kotor dengan konteks di sekitarnya
 
+##### `usePreset(presetName: string, additionalOptions?: Partial<FilterOptions>)`
+
+Menggunakan preset filter yang telah ditentukan.
+
+- **presetName**: Nama preset ('strict', 'moderate', 'light', 'childSafe', dll)
+- **additionalOptions**: Opsi tambahan untuk override preset (opsional)
+
 ##### `setOptions(options: Partial<FilterOptions>)`
 
 Mengubah opsi filter.
@@ -138,10 +174,25 @@ Menambahkan kata ke whitelist (akan diabaikan dalam filter).
 
 Menghapus kata dari whitelist.
 
+##### `enableIndonesianVariations()`
+
+Mengaktifkan deteksi variasi ejaan Bahasa Indonesia.
+
+##### `enableSplitWordDetection()`
+
+Mengaktifkan deteksi kata yang dipisah.
+
+##### `enableSimilarityDetection(threshold: number = 0.8)`
+
+Mengaktifkan deteksi berdasarkan kesamaan kata.
+
+- **threshold**: Ambang batas kesamaan (0-1, default: 0.8)
+
 ### Opsi Filter
 
 ```typescript
 interface FilterOptions {
+  // Opsi dasar
   wordList?: string[]; // List kata yang ingin difilter
   replaceWith?: string; // Karakter pengganti untuk kata yang disensor
   fullWordCensor?: boolean; // Apakah menyensor seluruh kata atau sebagian
@@ -151,9 +202,42 @@ interface FilterOptions {
   categories?: ProfanityCategory[]; // Kategori kata yang difilter
   regions?: Region[]; // Daerah asal kata yang difilter
   severityThreshold?: number; // Tingkat keparahan minimum (0-1)
+
+  // Opsi lanjutan
+  useRandomGrawlix?: boolean; // Gunakan karakter acak untuk sensor (#@$%&!)
+  keepFirstAndLast?: boolean; // Simpan huruf pertama dan terakhir (a***g)
+  indonesianVariation?: boolean; // Deteksi variasi ejaan Bahasa Indonesia
+  detectSimilarity?: boolean; // Deteksi kata berdasarkan kesamaan
+  similarityThreshold?: number; // Ambang batas kesamaan (0-1)
+  detectSplit?: boolean; // Deteksi kata yang dipisah (a-n-j-i-n-g)
 }
 ```
 
+## Preset Filter
+
+Library ini menyediakan beberapa preset yang dapat digunakan:
+
+### Preset Filter
+
+- **strict**: Filter paling ketat, mendeteksi semua jenis kata kotor
+- **moderate**: Filter tingkat menengah, mengabaikan kata-kata dengan tingkat keparahan rendah
+- **light**: Filter ringan, hanya untuk kata-kata paling sensitif
+- **childSafe**: Filter untuk konten anak-anak, sangat ketat
+
+### Preset Kategori
+
+- **sexual**: Hanya memfilter kata-kata berbau seksual
+- **insults**: Hanya memfilter kata-kata penghinaan
+- **profanity**: Hanya memfilter umpatan umum
+
+### Preset Regional
+
+- **general**: Hanya memfilter kata-kata umum di Indonesia
+- **jawa**: Hanya memfilter kata-kata dari Jawa
+- **sunda**: Hanya memfilter kata-kata dari Sunda
+- **betawi**: Hanya memfilter kata-kata dari Betawi
+- **batak**: Hanya memfilter kata-kata dari Batak
+
 ## Contoh Penggunaan Lanjutan
 
 ### Kustomisasi Opsi Filter
@@ -166,12 +250,14 @@ const filter = new IDProfanityFilter({
   categories: ['sexual', 'slur'], // Hanya filter kategori tertentu
   regions: ['jawa', 'general'], // Hanya filter dari daerah tertentu
   severityThreshold: 0.7, // Hanya filter kata dengan tingkat keparahan ≥ 0.7
-});
 
-// Atau mengubah opsi setelah inisialisasi
-filter.setOptions({
-  replaceWith: '@',
-  fullWordCensor: true,
+  // Opsi lanjutan
+  useRandomGrawlix: true, // Gunakan #@$%&! sebagai karakter pengganti
+  keepFirstAndLast: true, // Simpan huruf pertama dan terakhir (a***g)
+  indonesianVariation: true, // Deteksi variasi ejaan Indonesia
+  detectSimilarity: true, // Deteksi kata yang mirip
+  similarityThreshold: 0.8, // Ambang batas kesamaan
+  detectSplit: true, // Deteksi kata yang dipisah
 });
 ```
 
@@ -191,6 +277,74 @@ console.log(hasil.filtered);
 // Output: "Anjing itu hewan peliharaan yang setia, tidak seperti ******* itu"
 ```
 
+### Deteksi Variasi Ejaan dan Kata Terpisah
+
+```typescript
+// Aktifkan deteksi variasi ejaan dan kata terpisah
+const filter = new IDProfanityFilter({
+  indonesianVariation: true,
+  detectSplit: true,
+  detectLeetSpeak: true,
+});
+
+// Uji dengan variasi ejaan
+const teks1 = 'Dasar kamu ini sangat bodoh, benar-benar b0d0h dan b-o-d-o-h!';
+const hasil1 = filter.filter(teks1);
+console.log(hasil1.filtered);
+// Output: "Dasar kamu ini sangat *****, benar-benar ***** dan *********!"
+
+// Uji dengan ejaan Indonesia yang berbeda
+const teks2 = 'Dia sangat djail dan djudes dengan temannya';
+const hasil2 = filter.filter(teks2);
+console.log(hasil2.filtered);
+// Output: "Dia sangat ***** dan ****** dengan temannya"
+```
+
+### Deteksi Berdasarkan Kesamaan
+
+```typescript
+// Aktifkan deteksi kesamaan
+const filter = new IDProfanityFilter();
+filter.enableSimilarityDetection(0.75); // Set threshold kesamaan ke 0.75
+
+const teks = 'Dia benar-benar anjiing dan gooblok!';
+const analisis = filter.analyze(teks);
+
+console.log(analisis.similarWords);
+/* Output:
+[
+  { word: "anjiing", original: "anjing", similarity: 0.83 },
+  { word: "gooblok", original: "goblok", similarity: 0.85 }
+]
+*/
+
+const hasil = filter.filter(teks);
+console.log(hasil.filtered);
+// Output: "Dia benar-benar ****** dan *******!"
+```
+
+### Variasi Sensor Kata
+
+```typescript
+// Sensor standar (asterisk)
+const filter1 = new IDProfanityFilter();
+console.log(filter1.filter('Dasar anjing kamu!').filtered);
+// Output: "Dasar ***** kamu!"
+
+// Sensor dengan grawlix random
+const filter2 = new IDProfanityFilter({ useRandomGrawlix: true });
+console.log(filter2.filter('Dasar anjing kamu!').filtered);
+// Output: "Dasar #@$%& kamu!"
+
+// Sensor dengan menyimpan huruf pertama dan terakhir
+const filter3 = new IDProfanityFilter({
+  fullWordCensor: false,
+  keepFirstAndLast: true,
+});
+console.log(filter3.filter('Dasar anjing kamu!').filtered);
+// Output: "Dasar a***g kamu!"
+```
+
 ### Analisis Konten Mendalam
 
 ```typescript
@@ -217,6 +371,57 @@ console.log(analisis);
 */
 ```
 
+### Analisis Konteks
+
+```typescript
+const filter = new IDProfanityFilter();
+const teks =
+  'Saya sangat marah dengan sikapnya, dia benar-benar anjing dan bajingan!';
+
+// Analisis konteks
+const konteks = filter.analyzeWithContext(teks, 3);
+console.log(konteks);
+
+/* Output:
+[
+  {
+    word: "anjing",
+    context: "benar-benar anjing dan bajingan",
+    position: { start: 43, end: 62 }
+  },
+  {
+    word: "bajingan",
+    context: "anjing dan bajingan!",
+    position: { start: 54, end: 63 }
+  }
+]
+*/
+```
+
+### Analisis Per-Kalimat
+
+```typescript
+const filter = new IDProfanityFilter();
+const teks =
+  'Filmnya bagus sekali. Tetapi pemainnya seperti anjing, sangat buruk aktingnya.';
+
+// Analisis per-kalimat
+const kalimat = filter.analyzeBySentence(teks);
+console.log(
+  kalimat.map(
+    (k) =>
+      k.sentence + (k.hasProfanity ? ' (Mengandung kata kotor)' : ' (Bersih)'),
+  ),
+);
+
+/* Output:
+[
+  "Filmnya bagus sekali. (Bersih)",
+  "Tetapi pemainnya seperti anjing, sangat buruk aktingnya. (Mengandung kata kotor)"
+]
+*/
+```
+
 ### Analisis Batch
 
 ```typescript
@@ -258,8 +463,6 @@ Library ini mendukung kata-kata kotor dari berbagai daerah di Indonesia:
 - 🏙️ **Betawi** - Kata-kata dari bahasa Betawi
 - 🌋 **Batak** - Kata-kata dari bahasa Batak
 
-Dan daerah lainnya yang terus bertambah.
-
 ## Kategori Kata
 
 Kata-kata dikelompokkan berdasarkan kategori:
@@ -276,6 +479,24 @@ Kata-kata dikelompokkan berdasarkan kategori:
 
 Kami sangat menghargai kontribusi Anda! Untuk berkontribusi, silakan lihat [panduan kontribusi](CONTRIBUTING.md).
 
+### Menambahkan Kata Baru
+
+Jika Anda ingin menambahkan kata baru ke database, silakan buat pull request dengan mengubah file yang sesuai di `src/constants/categories/` atau `src/constants/regions/`.
+
+Format untuk menambahkan kata baru:
+
+```json
+{
+  "word": "kata_kotor", // Kata yang akan difilter
+  "category": "insult", // Kategori kata
+  "region": "general", // Daerah asal kata
+  "severity": 0.7, // Tingkat keparahan (0-1)
+  "aliases": ["k4t4_kotor", "kata_k0t0r"], // Alias atau variasi umum
+  "description": "Deskripsi tentang kata", // Penjelasan tentang kata (opsional)
+  "context": "Konteks penggunaan kata" // Konteks penggunaan (opsional)
+}
+```
+
 ## Lisensi
 
 Proyek ini dilisensikan di bawah [MIT License](LICENSE).

package/dist/constants/categories/index.d.ts

@@ -0,0 +1,9 @@
+import { sexual } from './sexual';
+import { insult } from './insult';
+export declare const categories: {
+    sexual: import("../..").ProfanityWord[];
+    insult: import("../..").ProfanityWord[];
+};
+export { sexual, insult };
+export declare const allCategoryWords: import("../..").ProfanityWord[];
+export default allCategoryWords;

package/dist/constants/regions/index.d.ts

@@ -0,0 +1,8 @@
+import { general } from './general';
+import { jawa } from './jawa';
+import { sunda } from './sunda';
+import { betawi } from './betawi';
+import { batak } from './batak';
+export { general, jawa, sunda, betawi, batak, };
+export declare const allRegionWords: import("../..").ProfanityWord[];
+export default allRegionWords;

package/examples/advanced.ts

@@ -0,0 +1,120 @@
+import { IDProfanityFilter, idFilter } from '../src/index';
+
+/**
+ * Contoh Penggunaan Lanjutan ID-Profanity-Filter
+ * ============================================
+ * File ini menunjukkan fitur-fitur lanjutan dari library.
+ */
+
+console.log('=== Contoh Penggunaan Lanjutan ID-Profanity-Filter ===\n');
+
+// ===== Contoh 1: Menggunakan preset filter =====
+const filter = new IDProfanityFilter();
+filter.usePreset('strict');
+
+console.log('=== Contoh Preset ===\n');
+
+const teks1 = 'Saya sangat kesal dengan dia, benar-benar anjing!';
+console.log('Teks asli:', teks1);
+console.log('Preset Strict:', filter.filter(teks1).filtered);
+
+// Ganti ke preset childSafe dengan grawlix random
+filter.usePreset('childSafe', { useRandomGrawlix: true });
+console.log('Preset ChildSafe + Grawlix:', filter.filter(teks1).filtered);
+
+// Ganti ke preset light (hanya filter kata paling sensitif)
+filter.usePreset('light');
+console.log('Preset Light:', filter.filter(teks1).filtered);
+
+// ===== Contoh 2: Deteksi Variasi Penulisan =====
+console.log('\n=== Contoh Deteksi Variasi Penulisan ===\n');
+
+filter.setOptions({
+  detectLeetSpeak: true,
+  indonesianVariation: true,
+  detectSplit: true,
+});
+
+const teks2 =
+  'b4b1 adalah binatang yang kotor, sama seperti a-n-j-i-n-g dan d-j-a-r-i-k.';
+console.log('Teks dengan variasi:', teks2);
+console.log('Hasil filter:', filter.filter(teks2).filtered);
+
+const leetAnalisis = filter.analyze(teks2);
+console.log('Kata terdeteksi:', leetAnalisis.matches);
+
+// ===== Contoh 3: Deteksi Kesamaan Kata =====
+console.log('\n=== Contoh Deteksi Kesamaan Kata ===\n');
+
+filter.enableSimilarityDetection(0.8);
+
+const teks3 = 'Dia benar-benar anjiing dan gooblok!';
+console.log('Teks dengan typo:', teks3);
+
+const similarAnalisis = filter.analyze(teks3);
+console.log('Kata terdeteksi:', similarAnalisis.matches);
+console.log('Analisis kesamaan:', similarAnalisis.similarWords);
+console.log('Hasil filter:', filter.filter(teks3).filtered);
+
+// ===== Contoh 4: Analisis dengan Konteks =====
+console.log('\n=== Contoh Analisis dengan Konteks ===\n');
+
+const teks4 =
+  'Para kritikus film sangat marah dengan kualitas filmnya, mereka menyebut sutradara itu anjing karena mengecewakan penonton dan membuang-buang anggaran.';
+console.log('Teks panjang:', teks4);
+
+const konteksAnalisis = filter.analyzeWithContext(teks4, 4);
+console.log('Analisis konteks:');
+konteksAnalisis.forEach((item) => {
+  console.log(`- Kata: ${item.word}`);
+  console.log(`  Konteks: "${item.context}"`);
+  console.log(`  Posisi: ${item.position.start}-${item.position.end}`);
+});
+
+// ===== Contoh 5: Batch Analisis =====
+console.log('\n=== Contoh Batch Analisis ===\n');
+
+const tekstBatch = [
+  'Film ini sangat bagus, ceritanya menarik sekali!',
+  'Dasar goblok, sialan kamu!',
+  'Anjing emang filmnya, sampah banget.',
+  'Saya setuju dengan pendapat kritikus tentang film tersebut.',
+];
+
+console.log('Batch teks untuk dianalisis:');
+tekstBatch.forEach((t, i) => console.log(`${i + 1}. ${t}`));
+
+const batchHasil = filter.batchAnalyze(tekstBatch);
+console.log('\nHasil Batch Analisis:');
+console.log(`- Total teks: ${batchHasil.totalTexts}`);
+console.log(`- Teks dengan kata kotor: ${batchHasil.profaneTexts}`);
+console.log(`- Teks bersih: ${batchHasil.cleanTexts}`);
+console.log(`- Rata-rata keparahan: ${batchHasil.averageSeverity.toFixed(2)}`);
+console.log(`- Kategori terbanyak: ${batchHasil.topCategories.join(', ')}`);
+console.log(`- Daerah terbanyak: ${batchHasil.topRegions.join(', ')}`);
+console.log('- Kata-kata terbanyak:');
+batchHasil.mostFrequentWords.forEach((word) => {
+  console.log(`  * ${word.word}: ${word.count} kali`);
+});
+
+// ===== Contoh 6: Opsi Kustomisasi Lengkap =====
+console.log('\n=== Contoh Kustomisasi Lengkap ===\n');
+
+filter.setOptions({
+  replaceWith: '@',
+  fullWordCensor: false,
+  keepFirstAndLast: true,
+  detectLeetSpeak: true,
+  indonesianVariation: true,
+  detectSimilarity: true,
+  similarityThreshold: 0.75,
+  detectSplit: true,
+  useRandomGrawlix: false,
+  categories: ['sexual', 'profanity'],
+  regions: ['general', 'jawa'],
+  severityThreshold: 0.5,
+});
+
+const teks6 = 'Dasar b4b1 sialan, kamu ini memang anjiing ya!';
+console.log('Teks asli:', teks6);
+console.log('Hasil kustomisasi lengkap:', filter.filter(teks6).filtered);

package/examples/basic.ts

@@ -1,52 +1,71 @@
+import { IDProfanityFilter, idFilter } from '../src/index';
+
 /**
- * Contoh penggunaan dasar ID-Profanity-Filter
+ * Contoh Penggunaan Dasar ID-Profanity-Filter
+ * ==========================================
+ * File ini menunjukkan fungsi dasar dari library.
  */
-import IDProfanityFilter from '../src/index';
 
-// Contoh penggunaan sederhana
+console.log('=== Contoh Penggunaan Dasar ID-Profanity-Filter ===\n');
 
-// 1. Buat instance filter
+// ===== Contoh 1: Inisialisasi dasar =====
 const filter = new IDProfanityFilter();
 
-// 2. Contoh teks dengan kata kasar
-const text = 'Dasar anjing kamu, jangan banyak bacot!';
-
-// 3. Cek apakah teks mengandung kata kotor
-const hasProfanity = filter.isProfane(text);
-console.log('Teks mengandung kata kotor:', hasProfanity);
-
-// 4. Filter kata kotor
-const filteredResult = filter.filter(text);
-console.log('Teks asli:', text);
-console.log('Teks tersensor:', filteredResult.filtered);
-console.log('Jumlah kata yang disensor:', filteredResult.censored);
-console.log('Kata-kata yang disensor:', filteredResult.replacements);
-
-// 5. Analisis teks
-const analysis = filter.analyze(text);
-console.log('\nHasil Analisis:');
-console.log('- Mengandung kata kotor:', analysis.hasProfanity);
-console.log('- Kata kotor yang ditemukan:', analysis.matches);
-console.log('- Kategori kata kotor:', analysis.categories);
-console.log('- Daerah asal kata kotor:', analysis.regions);
-console.log('- Skor keparahan:', analysis.severityScore);
-
-// 6. Gunakan opsi kustom
+const teks = 'Dasar anjing kamu, jangan banyak bacot!';
+console.log('Teks asli:', teks);
+
+// Cek apakah teks mengandung kata kotor
+const hasProfanity = filter.isProfane(teks);
+console.log('Mengandung kata kotor?', hasProfanity);
+
+// Filter kata kotor (sensorisasi)
+const hasil = filter.filter(teks);
+console.log('Teks disensor:', hasil.filtered);
+console.log('Jumlah kata disensor:', hasil.censored);
+console.log('Detail penggantian:', hasil.replacements);
+
+console.log('\n=== Contoh Analisis Dasar ===\n');
+
+// Analisis konten
+const analisis = filter.analyze(teks);
+console.log('Mengandung kata kotor?', analisis.hasProfanity);
+console.log('Kata-kata kotor yang ditemukan:', analisis.matches);
+console.log('Kategori kata kotor:', analisis.categories);
+console.log('Daerah asal kata:', analisis.regions);
+console.log('Tingkat keparahan:', analisis.severityScore.toFixed(2));
+
+console.log('\n=== Contoh Fungsi Statis ===\n');
+
+// Menggunakan fungsi statis
+const staticResult = idFilter.filter(teks);
+console.log('Teks disensor (fungsi statis):', staticResult.filtered);
+
+// ===== Contoh 2: Mengubah karakter pengganti =====
+filter.setOptions({ replaceWith: '#' });
+console.log('\nTeks disensor dengan #:', filter.filter(teks).filtered);
+
+// ===== Contoh 3: Hanya menyensor sebagian kata =====
 filter.setOptions({
-  replaceWith: '#',
+  replaceWith: '*',
   fullWordCensor: false,
+  keepFirstAndLast: true,
 });
+console.log(
+  '\nTeks disensor sebagian (first & last):',
+  filter.filter(teks).filtered,
+);
 
-console.log('\nHasil filter dengan opsi kustom:');
-console.log(filter.filter(text).filtered);
+// ===== Contoh 4: Metode analisis lain =====
+const kalimat =
+  'Saya sangat suka filmnya. Tapi pemainnya seperti anjing, aktingnya buruk.';
+console.log('\nContoh kalimat untuk analisis per-kalimat:', kalimat);
 
-// 7. Tambahkan kata ke whitelist (pengecualian)
-filter.addToWhitelist('anjing');
-console.log('\nHasil filter setelah "anjing" di-whitelist:');
-console.log(filter.filter(text).filtered);
-
-// 8. Gunakan fungsi utilitas langsung
-import { idFilter } from '../src/index';
-
-console.log('\nPenggunaan utilitas langsung:');
-console.log(idFilter.filter(text, { replaceWith: '@' }).filtered);
+const kalimatAnalisis = filter.analyzeBySentence(kalimat);
+console.log('\nAnalisis per-kalimat:');
+kalimatAnalisis.forEach((hasil, index) => {
+  console.log(`Kalimat ${index + 1}: ${hasil.sentence}`);
+  console.log(`- Mengandung kata kotor: ${hasil.hasProfanity}`);
+  if (hasil.hasProfanity) {
+    console.log(`- Kata kotor: ${hasil.matches.join(', ')}`);
+  }
+});

package/examples/custom-list.ts

@@ -0,0 +1,140 @@
+import { IDProfanityFilter, idFilter, FilterOptions } from '../src/index';
+
+/**
+ * Contoh Penggunaan ID-Profanity-Filter dengan Daftar Kustom
+ * =======================================================
+ * File ini menunjukkan cara menggunakan library dengan daftar kata kustom.
+ */
+
+console.log('=== Contoh Penggunaan dengan Daftar Kata Kustom ===\n');
+
+// ===== Contoh 1: Menggunakan daftar kata kustom =====
+// Daftar kata kotor kustom
+const customBadWords = ['jelek', 'buruk', 'sampah', 'payah', 'lemah', 'amatir'];
+
+// Buat instance dengan daftar kata kustom
+const filter = new IDProfanityFilter({
+  wordList: customBadWords,
+  replaceWith: '#',
+});
+
+const teks1 = 'Film itu sangat jelek dan payah, sepertinya dibuat oleh amatir.';
+console.log('Teks asli:', teks1);
+console.log('Hasil filter kustom:', filter.filter(teks1).filtered);
+
+// ===== Contoh 2: Menggabungkan daftar kata kustom dengan daftar bawaan =====
+console.log('\n=== Menggabungkan Daftar Kata ===\n');
+
+// Reset filter ke pengaturan default
+filter.setOptions({});
+
+// Tambahkan kata-kata kustom tapi tetap deteksi kata-kata bawaan
+const teks2 = 'Film itu sangat jelek dan payah, dibuat oleh anjing amatir.';
+console.log('Teks asli:', teks2);
+
+// Analisis hanya dengan kata bawaan
+console.log('Analisis standar:');
+const standarAnalisis = filter.analyze(teks2);
+console.log('- Kata terdeteksi:', standarAnalisis.matches);
+
+// Tambahkan kata kustom
+filter.setWordList([...customBadWords]);
+console.log('\nAnalisis dengan kata kustom ditambahkan:');
+const customAnalisis = filter.analyze(teks2);
+console.log('- Kata terdeteksi:', customAnalisis.matches);
+
+// ===== Contoh 3: Whitelist untuk pengecualian kontekstual =====
+console.log('\n=== Penggunaan Whitelist ===\n');
+
+// Kita ingin kata "anjing" diperbolehkan jika dalam konteks binatang
+filter.setOptions({});
+filter.addToWhitelist('anjing');
+
+const teks3a = 'Anjing adalah hewan peliharaan yang setia.';
+const teks3b = 'Dasar anjing kamu, tidak punya perasaan!';
+
+console.log('Teks dengan konteks binatang:', teks3a);
+console.log('Terdeteksi sebagai kata kotor?', filter.isProfane(teks3a));
+
+// Tambahkan kembali "anjing" ke daftar kata kotor
+filter.removeFromWhitelist('anjing');
+console.log('\nSetelah dihapus dari whitelist:');
+console.log('Terdeteksi sebagai kata kotor?', filter.isProfane(teks3a));
+
+// ===== Contoh 4: Membuat preset kustom =====
+console.log('\n=== Membuat Preset Kustom ===\n');
+
+// Kita bisa membuat preset filter kustom
+const myCustomPreset: FilterOptions = {
+  replaceWith: '●', // Karakter pengganti
+  fullWordCensor: false,
+  keepFirstAndLast: true,
+  detectLeetSpeak: true,
+  indonesianVariation: true,
+  detectSplit: false,
+  useRandomGrawlix: false,
+  categories: ['insult', 'profanity'],
+  severityThreshold: 0.3,
+  whitelist: ['anjing'], // Untuk konteks binatang
+};
+
+const teks4 = 'Anjing itu lucu, tidak seperti si goblok dan bego itu.';
+console.log('Teks asli:', teks4);
+
+// Gunakan preset kustom
+filter.setOptions(myCustomPreset);
+console.log('Hasil preset kustom:', filter.filter(teks4).filtered);
+
+// ===== Contoh 5: Filter berdasarkan kategori atau daerah saja =====
+console.log('\n=== Filter Berdasarkan Kategori atau Daerah ===\n');
+
+// Filter hanya kata dari kategori "sexual"
+filter.setOptions({
+  categories: ['sexual'],
+  wordList: [], // Reset daftar kata kustom
+});
+
+const teks5 =
+  'Ngewe dan bokep itu kata kotor, bego dan anjing tidak terfilter.';
+console.log('Teks asli:', teks5);
+console.log('Filter hanya kategori sexual:', filter.filter(teks5).filtered);
+
+// Filter hanya kata dari daerah "jawa"
+filter.setOptions({
+  categories: [],
+  regions: ['jawa'],
+});
+
+const teks5b = 'Kata jancuk dan cuk dari Jawa, anjing adalah kata umum.';
+console.log('\nTeks asli:', teks5b);
+console.log('Filter hanya daerah jawa:', filter.filter(teks5b).filtered);
+
+// ===== Contoh 6: Custom wordList dengan metadata =====
+console.log('\n=== Custom wordList dengan Metadata ===\n');
+
+// Ini contoh jika Anda ingin membuat daftar kata lengkap dengan metadata
+const customWordsWithMetadata = [
+  {
+    word: 'jelek',
+    category: 'insult' as any,
+    region: 'general' as any,
+    severity: 0.4,
+    aliases: ['jelex', 'jlk'],
+  },
+  {
+    word: 'payah',
+    category: 'insult' as any,
+    region: 'general' as any,
+    severity: 0.3,
+    aliases: ['pyh', 'payaah'],
+  },
+];
+
+// Namun untuk filter sederhana, cukup gunakan kata-kata saja
+filter.setOptions({
+  wordList: customWordsWithMetadata.map((w) => w.word),
+});
+
+const teks6 = 'Performanya sangat jelek dan payah sekali.';
+console.log('Teks asli:', teks6);
+console.log('Filter dengan wordList kustom:', filter.filter(teks6).filtered);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sideid/id-profanity-filter",
-  "version": "1.9.5",
+  "version": "1.9.6",
   "description": "Library filter kata kotor dalam Bahasa Indonesia",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",

package/src/constants/categories/index.ts

@@ -1,31 +1,31 @@
-// import { sexual } from './sexual';
-// import { insult } from './insult';
+import { sexual } from './sexual';
+import { insult } from './insult';
 // import { profanity } from './profanity';
 // import { slur } from './slur';
 // import { drugs } from './drugs';
 // import { disgusting } from './disgusting';
 // import { blasphemy } from './blasphemy';
 
-// export const categories = {
-//   sexual, // Kata-kata berbau seksual
-//   insult, // Kata-kata penghinaan
-//   profanity, // Umpatan umum
-//   slur, // Perkataan merendahkan berdasarkan identitas
-//   drugs, // Terkait narkoba
-//   disgusting, // Kata-kata menjijikkan
-//   blasphemy, // Penistaan agama
-// };
+export const categories = {
+  sexual, // Kata-kata berbau seksual
+  insult, // Kata-kata penghinaan
+  // profanity, // Umpatan umum
+  // slur, // Perkataan merendahkan berdasarkan identitas
+  // drugs, // Terkait narkoba
+  // disgusting, // Kata-kata menjijikkan
+  // blasphemy, // Penistaan agama
+};
 
-// export { sexual, insult, profanity, slur, drugs, disgusting, blasphemy };
+export { sexual, insult };
 
-// export const allCategoryWords = [
-//   ...sexual,
-//   ...insult,
-//   ...profanity,
-//   ...slur,
-//   ...drugs,
-//   ...disgusting,
-//   ...blasphemy,
-// ];
+export const allCategoryWords = [
+  ...sexual,
+  ...insult,
+  // ...profanity,
+  // ...slur,
+  // ...drugs,
+  // ...disgusting,
+  // ...blasphemy,
+];
 
-// export default allCategoryWords;
+export default allCategoryWords;

package/src/constants/regions/index.ts

@@ -1,8 +1,8 @@
-// import { general } from './general';
-// import { jawa } from './jawa';
-// import { sunda } from './sunda';
-// import { betawi } from './betawi';
-// import { batak } from './batak';
+import { general } from './general';
+import { jawa } from './jawa';
+import { sunda } from './sunda';
+import { betawi } from './betawi';
+import { batak } from './batak';
 // import { minang } from './minang';
 // import { bali } from './bali';
 // import { madura } from './madura';
@@ -17,46 +17,46 @@
 // import { ntt } from './ntt';
 // import { ntb } from './ntb';
 
-// export {
-//   general,
-//   jawa,
-//   sunda,
-//   betawi,
-//   batak,
-//   minang,
-//   bali,
-//   madura,
-//   bugis,
-//   aceh,
-//   ambon,
-//   papua,
-//   manado,
-//   banjar,
-//   palembang,
-//   lampung,
-//   ntt,
-//   ntb,
-// };
+export {
+  general,
+  jawa,
+  sunda,
+  betawi,
+  batak,
+  // minang,
+  // bali,
+  // madura,
+  // bugis,
+  // aceh,
+  // ambon,
+  // papua,
+  // manado,
+  // banjar,
+  // palembang,
+  // lampung,
+  // ntt,
+  // ntb,
+};
 
-// export const allRegionWords = [
-//   ...general,
-//   ...jawa,
-//   ...sunda,
-//   ...betawi,
-//   ...batak,
-//   ...minang,
-//   ...bali,
-//   ...madura,
-//   ...bugis,
-//   ...aceh,
-//   ...ambon,
-//   ...papua,
-//   ...manado,
-//   ...banjar,
-//   ...palembang,
-//   ...lampung,
-//   ...ntt,
-//   ...ntb,
-// ];
+export const allRegionWords = [
+  ...general,
+  ...jawa,
+  ...sunda,
+  ...betawi,
+  ...batak,
+  // ...minang,
+  // ...bali,
+  // ...madura,
+  // ...bugis,
+  // ...aceh,
+  // ...ambon,
+  // ...papua,
+  // ...manado,
+  // ...banjar,
+  // ...palembang,
+  // ...lampung,
+  // ...ntt,
+  // ...ntb,
+];
 
-// export default allRegionWords;
+export default allRegionWords;