@sideid/id-profanity-filter 1.11.0 → 1.11.5

package/examples/advanced.ts

@@ -1,120 +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);
+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,71 +1,71 @@
-import { IDProfanityFilter, idFilter } from '../src/index';
-
-/**
- * Contoh Penggunaan Dasar ID-Profanity-Filter
- * ==========================================
- * File ini menunjukkan fungsi dasar dari library.
- */
-
-console.log('=== Contoh Penggunaan Dasar ID-Profanity-Filter ===\n');
-
-// ===== Contoh 1: Inisialisasi dasar =====
-const filter = new IDProfanityFilter();
-
-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: '*',
-  fullWordCensor: false,
-  keepFirstAndLast: true,
-});
-console.log(
-  '\nTeks disensor sebagian (first & last):',
-  filter.filter(teks).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);
-
-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(', ')}`);
-  }
-});
+import { IDProfanityFilter, idFilter } from '../src/index';
+
+/**
+ * Contoh Penggunaan Dasar ID-Profanity-Filter
+ * ==========================================
+ * File ini menunjukkan fungsi dasar dari library.
+ */
+
+console.log('=== Contoh Penggunaan Dasar ID-Profanity-Filter ===\n');
+
+// ===== Contoh 1: Inisialisasi dasar =====
+const filter = new IDProfanityFilter();
+
+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: '*',
+  fullWordCensor: false,
+  keepFirstAndLast: true,
+});
+console.log(
+  '\nTeks disensor sebagian (first & last):',
+  filter.filter(teks).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);
+
+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

@@ -1,140 +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);
+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);