@sideid/id-profanity-filter 1.9.5 → 1.10.2

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/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.5",
+  "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;

package/src/constants/categories/disgusting.ts

@@ -0,0 +1,82 @@
+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 disgusting: ProfanityWord[] = [
+  ...general.filter((word) => word.category === "disgusting"),
+  ...jawa.filter((word) => word.category === "disgusting"),
+  ...sunda.filter((word) => word.category === "disgusting"),
+  ...betawi.filter((word) => word.category === "disgusting"),
+
+  {
+    word: "muntah",
+    category: "disgusting",
+    region: "general",
+    severity: 0.4,
+    aliases: ["muntaber", "memuntahkan"],
+    description: "Muntahan atau tindakan muntah",
+    context:
+      "Digunakan untuk mengekspresikan rasa jijik atau menggambarkan tindakan tersebut",
+  },
+  {
+    word: "ingus",
+    category: "disgusting",
+    region: "general",
+    severity: 0.4,
+    aliases: ["ingusan", "beringus"],
+    description: "Lendir hidung",
+    context: "Digunakan untuk menggambarkan lendir hidung atau sebagai hinaan",
+  },
+  {
+    word: "tai",
+    category: "disgusting",
+    region: "general",
+    severity: 0.8,
+    aliases: ["tahi", "kotoran"],
+    description: "Kotoran manusia",
+    context: "Istilah vulgar untuk kotoran, sering digunakan sebagai hinaan",
+  },
+  {
+    word: "jembut",
+    category: "disgusting",
+    region: "general",
+    severity: 1.0,
+    aliases: ["jembud", "rambut kemaluan"],
+    description: "Rambut kemaluan",
+    context:
+      "Istilah vulgar untuk rambut kemaluan, dianggap sangat tidak pantas",
+  },
+  {
+    word: "pecret",
+    category: "disgusting",
+    region: "sunda",
+    severity: 0.8,
+    aliases: ["mencret", "diare"],
+    description: "Diare dalam bahasa Sunda",
+    context: "Dianggap vulgar ketika disebutkan di depan umum",
+  },
+  {
+    word: "bacot",
+    category: "disgusting",
+    region: "betawi",
+    severity: 0.8,
+    aliases: ["cicing", "berisik"],
+    description: "Mulut atau omongan berisik dalam konteks vulgar",
+    context: "Istilah kasar yang digunakan untuk menyuruh seseorang diam",
+  },
+  {
+    word: "lendir",
+    category: "disgusting",
+    region: "general",
+    severity: 0.3,
+    aliases: ["berlendir", "cairan lengket"],
+    description: "Lendir atau cairan lengket",
+    context:
+      "Dapat digunakan dalam konteks vulgar untuk menggambarkan cairan tubuh",
+  },
+];
+
+export const disgustingWords = disgusting.map((item) => item.word);
+export default disgusting;

package/src/constants/categories/drugs.ts

@@ -0,0 +1,72 @@
+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 drugs: ProfanityWord[] = [
+  ...general.filter((word) => word.category === "drugs"),
+  ...jawa.filter((word) => word.category === "drugs"),
+  ...sunda.filter((word) => word.category === "drugs"),
+  ...betawi.filter((word) => word.category === "drugs"),
+
+  {
+    word: "ganja",
+    category: "drugs",
+    region: "general",
+    severity: 0.6,
+    aliases: ["cimeng", "kanabis", "marijuana"],
+    description: "Tanaman yang mengandung zat psikoaktif",
+    context: "Digunakan untuk merujuk pada narkotika jenis cannabis",
+  },
+  {
+    word: "sabu",
+    category: "drugs",
+    region: "general",
+    severity: 0.8,
+    aliases: ["crystal", "meth", "ss"],
+    description: "Narkotika jenis metamfetamin",
+    context: "Istilah untuk metamfetamin yang merupakan narkotika berbahaya",
+  },
+  {
+    word: "inex",
+    category: "drugs",
+    region: "general",
+    severity: 0.7,
+    aliases: ["ekstasi", "pil"],
+    description: "Obat terlarang yang mengandung MDMA",
+    context: "Nama slang untuk obat terlarang ecstasy",
+  },
+  {
+    word: "sakaw",
+    category: "drugs",
+    region: "general",
+    severity: 0.5,
+    aliases: ["ketagihan", "menarik"],
+    description: "Gejala putus obat pada pecandu",
+    context:
+      "Menggambarkan kondisi pecandu yang sedang mengalami gejala putus obat",
+  },
+  {
+    word: "ngepil",
+    category: "drugs",
+    region: "jawa",
+    severity: 0.3,
+    aliases: ["minum pil", "telan pil"],
+    description: "Mengkonsumsi obat-obatan terlarang dalam bentuk pil",
+    context:
+      "Istilah dalam bahasa gaul untuk mengkonsumsi obat terlarang jenis tablet",
+  },
+  {
+    word: "nyimeng",
+    category: "drugs",
+    region: "sunda",
+    severity: 0.6,
+    aliases: ["nyimang", "isap ganja"],
+    description: "Mengisap ganja atau marijuana",
+    context: "Istilah sunda untuk aktivitas mengkonsumsi ganja",
+  },
+];
+
+export const drugsWords = drugs.map((item) => item.word);
+export default drugs;

package/src/constants/categories/profanity.ts

@@ -0,0 +1,139 @@
+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 profanity: ProfanityWord[] = [
+  ...general.filter((word) => word.category === "profanity"),
+  ...jawa.filter((word) => word.category === "profanity"),
+  ...sunda.filter((word) => word.category === "profanity"),
+  ...betawi.filter((word) => word.category === "profanity"),
+
+  {
+    word: "anjing",
+    category: "profanity",
+    region: "general",
+    severity: 0.9,
+    aliases: ["anjir", "anying", "njing", "njir"],
+    description: "Kata umpatan yang mengacu pada hewan anjing",
+    context: "Digunakan sebagai ekspresi kemarahan atau frustasi",
+  },
+  {
+    word: "babi",
+    category: "profanity",
+    region: "general",
+    severity: 0.8,
+    aliases: ["babik", "khinzir"],
+    description: "Kata umpatan yang mengacu pada hewan babi",
+    context:
+      "Digunakan untuk mengekspresikan kemarahan atau menghina seseorang",
+  },
+  {
+    word: "bangsat",
+    category: "profanity",
+    region: "general",
+    severity: 0.8,
+    aliases: ["bgst", "bangst"],
+    description: "Kata umpatan kasar yang berarti kutu atau parasit",
+    context: "Digunakan untuk menunjukkan kemarahan atau menghina seseorang",
+  },
+  {
+    word: "kampret",
+    category: "profanity",
+    region: "general",
+    severity: 0.7,
+    aliases: ["kampret lu", "kampretot"],
+    description: "Kata umpatan yang mengacu pada jenis kelelawar kecil",
+    context: "Digunakan untuk mengungkapkan kekesalan atau menghina seseorang",
+  },
+  {
+    word: "sialan",
+    category: "profanity",
+    region: "general",
+    severity: 0.6,
+    aliases: ["sial", "siaal"],
+    description: "Kata umpatan yang menunjukkan nasib buruk",
+    context: "Digunakan untuk mengekspresikan kekesalan atau kemarahan",
+  },
+  {
+    word: "monyet",
+    category: "profanity",
+    region: "general",
+    severity: 0.7,
+    aliases: ["monyong", "munyuk"],
+    description: "Kata umpatan yang mengacu pada hewan primata",
+    context: "Digunakan untuk menghina atau mengekspresikan kemarahan",
+  },
+  {
+    word: "bajingan",
+    category: "profanity",
+    region: "general",
+    severity: 0.8,
+    aliases: ["bajinga", "bjngn"],
+    description: "Kata umpatan yang berarti penjahat atau orang jahat",
+    context:
+      "Digunakan untuk mengumpat seseorang yang dianggap buruk perilakunya",
+  },
+  {
+    word: "jancok",
+    category: "profanity",
+    region: "jawa",
+    severity: 0.9,
+    aliases: ["jancuk", "jancik", "dancok"],
+    description: "Kata umpatan kasar dalam bahasa Jawa",
+    context:
+      "Umpatan sangat kasar dalam budaya Jawa, menunjukkan kemarahan yang tinggi",
+  },
+  {
+    word: "cuk",
+    category: "profanity",
+    region: "jawa",
+    severity: 0.8,
+    aliases: ["cok", "cug"],
+    description: "Bentuk singkat dari jancok",
+    context:
+      "Versi pendek dari umpatan jancok, digunakan dalam percakapan sehari-hari",
+  },
+  {
+    word: "asu",
+    category: "profanity",
+    region: "jawa",
+    severity: 0.8,
+    aliases: ["asyu", "su"],
+    description: "Kata Jawa untuk anjing, digunakan sebagai umpatan",
+    context: "Ekspresi umpatan yang umum di masyarakat Jawa",
+  },
+  {
+    word: "sia",
+    category: "profanity",
+    region: "sunda",
+    severity: 0.6,
+    aliases: ["siah", "siaa"],
+    description: "Kata ganti orang kedua dalam bahasa Sunda yang kasar",
+    context:
+      "Menunjukkan ketidakhormatan pada lawan bicara dalam konteks Sunda",
+  },
+  {
+    word: "lu",
+    category: "profanity",
+    region: "betawi",
+    severity: 0.4,
+    aliases: ["elu", "lo"],
+    description: "Kata ganti orang kedua dalam dialek Betawi",
+    context:
+      "Dapat dianggap kasar dalam konteks formal atau saat berbicara dengan orang yang lebih tua",
+  },
+  {
+    word: "goblok",
+    category: "profanity",
+    region: "general",
+    severity: 0.7,
+    aliases: ["goblog", "goblokk", "bego", "bodoh"],
+    description: "Kata umpatan yang menunjukkan kebodohan",
+    context: "Digunakan untuk menghina kecerdasan seseorang",
+  },
+];
+
+export const profanityWords = profanity.map((item) => item.word);
+export default profanity;