@sideid/id-profanity-filter 1.9.6 → 1.10.2

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);

package/jest.config.mjs

@@ -1,10 +1,10 @@
-module.exports = {
-  preset: 'ts-jest',
-  testEnvironment: 'node',
-  roots: ['<rootDir>/test'],
-  transform: {
-    '^.+\\.tsx?$': 'ts-jest',
-  },
-  testRegex: '(/__tests__/.*|(\\.|/)(test|spec))\\.tsx?$',
-  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
-};
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/test'],
+  transform: {
+    '^.+\\.tsx?$': 'ts-jest',
+  },
+  testRegex: '(/__tests__/.*|(\\.|/)(test|spec))\\.tsx?$',
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sideid/id-profanity-filter",
-  "version": "1.9.6",
+  "version": "1.10.2",
   "description": "Library filter kata kotor dalam Bahasa Indonesia",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -8,7 +8,7 @@
   "scripts": {
     "build": "rollup -c",
     "test": "jest",
-    "lint": "eslint src/**/*.ts",
+    "lint": "eslint --ext .ts src/",
     "format": "prettier --write \"src/**/*.ts\""
   },
   "keywords": [
@@ -45,6 +45,7 @@
     "rollup": "^4.39.0",
     "rollup-plugin-dts": "^6.2.1",
     "ts-jest": "^29.3.1",
+    "tslib": "^2.8.1",
     "typescript": "^5.8.3"
   }
 }

package/prettierrc

@@ -1,7 +1,7 @@
-{
-  "singleQuote": true,
-  "trailingComma": "es5",
-  "printWidth": 100,
-  "tabWidth": 2,
-  "semi": true
+{
+  "singleQuote": true,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "semi": true
 }

package/rollup.config.mjs

@@ -1,35 +1,35 @@
-import resolve from '@rollup/plugin-node-resolve';
-import commonjs from '@rollup/plugin-commonjs';
-import typescript from '@rollup/plugin-typescript';
-import json from '@rollup/plugin-json';
-import dts from 'rollup-plugin-dts';
-import pkg from './package.json' assert { type: 'json' };
-
-export default [
-  {
-    input: 'src/index.ts',
-    output: [
-      {
-        file: pkg.main,
-        format: 'cjs',
-        sourcemap: true,
-      },
-      {
-        file: pkg.module,
-        format: 'esm',
-        sourcemap: true,
-      },
-    ],
-    plugins: [
-      resolve(),
-      commonjs(),
-      typescript({ tsconfig: './tsconfig.json' }),
-      json(),
-    ],
-  },
-  {
-    input: 'dist/types/index.d.ts',
-    output: [{ file: 'dist/index.d.ts', format: 'es' }],
-    plugins: [dts()],
-  },
-];
+import resolve from '@rollup/plugin-node-resolve';
+import commonjs from '@rollup/plugin-commonjs';
+import typescript from '@rollup/plugin-typescript';
+import json from '@rollup/plugin-json';
+import dts from 'rollup-plugin-dts';
+import pkg from './package.json' assert { type: 'json' };
+
+export default [
+  {
+    input: 'src/index.ts',
+    output: [
+      {
+        file: pkg.main,
+        format: 'cjs',
+        sourcemap: true,
+      },
+      {
+        file: pkg.module,
+        format: 'esm',
+        sourcemap: true,
+      },
+    ],
+    plugins: [
+      resolve(),
+      commonjs(),
+      typescript({ tsconfig: './tsconfig.json' }),
+      json(),
+    ],
+  },
+  {
+    input: 'dist/types/index.d.ts',
+    output: [{ file: 'dist/index.d.ts', format: 'es' }],
+    plugins: [dts()],
+  },
+];

package/src/config/options.ts

@@ -7,6 +7,8 @@ export const DEFAULT_OPTIONS: FilterOptions = {
   checkSubstring: false,
   whitelist: [],
   severityThreshold: 0,
+  useLevenshtein: false,
+  maxLevenshteinDistance: 2,
 };
 
 export const FILTER_PRESETS = {

package/src/constants/categories/blasphemy.ts

@@ -0,0 +1,25 @@
+import { ProfanityWord } from "../../types";
+import { general } from "../regions/general";
+import { jawa } from "../regions/jawa";
+import { sunda } from "../regions/sunda";
+import { betawi } from "../regions/betawi";
+
+export const blasphemy: ProfanityWord[] = [
+  ...general.filter((word) => word.category === "blasphemy"),
+  ...jawa.filter((word) => word.category === "blasphemy"),
+  ...sunda.filter((word) => word.category === "blasphemy"),
+  ...betawi.filter((word) => word.category === "blasphemy"),
+
+  {
+    word: "kafir",
+    category: "blasphemy",
+    region: "general",
+    severity: 0.6,
+    aliases: ["kapir", "kafur"],
+    description: "Istilah untuk orang yang tidak percaya pada Islam",
+    context: "Dapat bersifat merendahkan ketika digunakan terhadap non-Muslim",
+  },
+];
+
+export const blasphemyWords = blasphemy.map((item) => item.word);
+export default blasphemy;