@sideid/id-profanity-filter 1.9.6 → 1.10.4

package/.eslintrc.js

@@ -1,16 +1,44 @@
 module.exports = {
   parser: '@typescript-eslint/parser',
-  extends: ['plugin:@typescript-eslint/recommended', 'prettier'],
   parserOptions: {
     ecmaVersion: 2020,
     sourceType: 'module',
+    project: './tsconfig.json',
   },
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'prettier', // Disables ESLint rules that might conflict with Prettier
+  ],
+  plugins: ['@typescript-eslint'],
   env: {
     node: true,
     jest: true,
   },
   rules: {
+    // Enforce consistent code style
     '@typescript-eslint/explicit-function-return-type': 'off',
-    '@typescript-eslint/no-explicit-any': 'off',
+    '@typescript-eslint/no-explicit-any': 'warn',
+    '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+
+    // Allow certain TypeScript patterns
+    '@typescript-eslint/no-non-null-assertion': 'off',
+
+    // General ESLint rules
+    'no-console': ['warn', { allow: ['warn', 'error'] }],
+    'prefer-const': 'warn',
+    'no-var': 'error',
+
+    // Make sure imports are properly sorted
+    'sort-imports': [
+      'off',
+      {
+        ignoreCase: false,
+        ignoreDeclarationSort: true,
+        ignoreMemberSort: false,
+        memberSyntaxSortOrder: ['none', 'all', 'multiple', 'single'],
+      },
+    ],
   },
+  ignorePatterns: ['dist/', 'node_modules/', '*.js', '*.d.ts'],
 };

package/README.md

@@ -13,6 +13,7 @@ Library JavaScript/TypeScript untuk mendeteksi, menyensor, dan menganalisis kata
 - 🔒 **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
+- 🔠 **Deteksi Levenshtein** - Mendeteksi kata kotor yang dimodifikasi dengan typo atau sengaja disamarkan
 - 🛡️ **Preset** - Preset filter siap pakai untuk berbagai kebutuhan
 - 🔧 **Kustomisasi** - Opsi untuk menambahkan whitelist dan daftar kata kustom
 
@@ -182,11 +183,20 @@ Mengaktifkan deteksi variasi ejaan Bahasa Indonesia.
 
 Mengaktifkan deteksi kata yang dipisah.
 
-##### `enableSimilarityDetection(threshold: number = 0.8)`
+##### `enableSimilarityDetection(threshold: number = 0.8, useLevenshtein: boolean = false, maxLevenshteinDistance: number = 2)`
 
 Mengaktifkan deteksi berdasarkan kesamaan kata.
 
 - **threshold**: Ambang batas kesamaan (0-1, default: 0.8)
+- **useLevenshtein**: Gunakan algoritma Levenshtein untuk deteksi (default: false)
+- **maxLevenshteinDistance**: Jarak edit maksimum yang diizinkan (default: 2)
+
+##### `enableLevenshteinDetection(threshold: number = 0.8, maxDistance: number = 2)`
+
+Mengaktifkan deteksi berbasis jarak Levenshtein.
+
+- **threshold**: Ambang batas kesamaan (0-1, default: 0.8)
+- **maxDistance**: Jarak edit maksimum yang diizinkan (default: 2)
 
 ### Opsi Filter
 
@@ -210,6 +220,8 @@ interface FilterOptions {
   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)
+  useLevenshtein?: boolean; // Gunakan algoritma Levenshtein untuk deteksi kesamaan
+  maxLevenshteinDistance?: number; // Jarak edit maksimum untuk deteksi Levenshtein
 }
 ```
 
@@ -258,6 +270,8 @@ const filter = new IDProfanityFilter({
   detectSimilarity: true, // Deteksi kata yang mirip
   similarityThreshold: 0.8, // Ambang batas kesamaan
   detectSplit: true, // Deteksi kata yang dipisah
+  useLevenshtein: true, // Gunakan algoritma Levenshtein
+  maxLevenshteinDistance: 2, // Jarak Levenshtein maksimum
 });
 ```
 
@@ -300,10 +314,10 @@ console.log(hasil2.filtered);
 // Output: "Dia sangat ***** dan ****** dengan temannya"
 ```
 
-### Deteksi Berdasarkan Kesamaan
+### Deteksi Berdasarkan Kesamaan (Similarity Detection)
 
 ```typescript
-// Aktifkan deteksi kesamaan
+// Aktifkan deteksi kesamaan standar
 const filter = new IDProfanityFilter();
 filter.enableSimilarityDetection(0.75); // Set threshold kesamaan ke 0.75
 
@@ -323,6 +337,34 @@ console.log(hasil.filtered);
 // Output: "Dia benar-benar ****** dan *******!"
 ```
 
+### Deteksi dengan Algoritma Levenshtein Distance
+
+```typescript
+// Aktifkan deteksi menggunakan algoritma Levenshtein Distance
+const filter = new IDProfanityFilter();
+filter.enableLevenshteinDetection(0.85, 2);
+// Threshold 0.85, maksimal 2 karakter berbeda
+
+const teks = 'Dia benar-benar konntol dan anjiing sekali!';
+const hasil = filter.filter(teks);
+
+console.log(hasil.filtered);
+// Output: "Dia benar-benar ******* dan ****** sekali!"
+
+// Atau menggunakan opsi langsung:
+const filterCustom = new IDProfanityFilter({
+  detectSimilarity: true,
+  useLevenshtein: true,
+  similarityThreshold: 0.85,
+  maxLevenshteinDistance: 2,
+});
+
+// Mendeteksi typo atau variasi disengaja
+const teksVariasi = 'kontool kamu kwontol anjiing';
+console.log(filterCustom.filter(teksVariasi).filtered);
+// Output: "******* kamu ******* ******"
+```
+
 ### Variasi Sensor Kata
 
 ```typescript

package/dist/config/options.d.ts

@@ -17,6 +17,8 @@ export declare const FILTER_PRESETS: {
         detectSimilarity?: boolean;
         similarityThreshold?: number;
         detectSplit?: boolean;
+        useLevenshtein?: boolean;
+        maxLevenshteinDistance?: number;
     };
     moderate: {
         severityThreshold: number;
@@ -34,6 +36,8 @@ export declare const FILTER_PRESETS: {
         detectSimilarity?: boolean;
         similarityThreshold?: number;
         detectSplit?: boolean;
+        useLevenshtein?: boolean;
+        maxLevenshteinDistance?: number;
     };
     light: {
         severityThreshold: number;
@@ -51,6 +55,8 @@ export declare const FILTER_PRESETS: {
         detectSimilarity?: boolean;
         similarityThreshold?: number;
         detectSplit?: boolean;
+        useLevenshtein?: boolean;
+        maxLevenshteinDistance?: number;
     };
     childSafe: {
         checkSubstring: boolean;
@@ -68,6 +74,8 @@ export declare const FILTER_PRESETS: {
         detectSimilarity?: boolean;
         similarityThreshold?: number;
         detectSplit?: boolean;
+        useLevenshtein?: boolean;
+        maxLevenshteinDistance?: number;
     };
 };
 export declare const CATEGORY_PRESETS: {
@@ -87,6 +95,8 @@ export declare const CATEGORY_PRESETS: {
         detectSimilarity?: boolean;
         similarityThreshold?: number;
         detectSplit?: boolean;
+        useLevenshtein?: boolean;
+        maxLevenshteinDistance?: number;
     };
     insults: {
         categories: ProfanityCategory[];
@@ -104,6 +114,8 @@ export declare const CATEGORY_PRESETS: {
         detectSimilarity?: boolean;
         similarityThreshold?: number;
         detectSplit?: boolean;
+        useLevenshtein?: boolean;
+        maxLevenshteinDistance?: number;
     };
     profanity: {
         categories: ProfanityCategory[];
@@ -121,6 +133,8 @@ export declare const CATEGORY_PRESETS: {
         detectSimilarity?: boolean;
         similarityThreshold?: number;
         detectSplit?: boolean;
+        useLevenshtein?: boolean;
+        maxLevenshteinDistance?: number;
     };
 };
 export declare const REGION_PRESETS: {
@@ -140,6 +154,8 @@ export declare const REGION_PRESETS: {
         detectSimilarity?: boolean;
         similarityThreshold?: number;
         detectSplit?: boolean;
+        useLevenshtein?: boolean;
+        maxLevenshteinDistance?: number;
     };
     jawa: {
         regions: Region[];
@@ -157,6 +173,8 @@ export declare const REGION_PRESETS: {
         detectSimilarity?: boolean;
         similarityThreshold?: number;
         detectSplit?: boolean;
+        useLevenshtein?: boolean;
+        maxLevenshteinDistance?: number;
     };
     sunda: {
         regions: Region[];
@@ -174,6 +192,8 @@ export declare const REGION_PRESETS: {
         detectSimilarity?: boolean;
         similarityThreshold?: number;
         detectSplit?: boolean;
+        useLevenshtein?: boolean;
+        maxLevenshteinDistance?: number;
     };
     betawi: {
         regions: Region[];
@@ -191,6 +211,8 @@ export declare const REGION_PRESETS: {
         detectSimilarity?: boolean;
         similarityThreshold?: number;
         detectSplit?: boolean;
+        useLevenshtein?: boolean;
+        maxLevenshteinDistance?: number;
     };
     batak: {
         regions: Region[];
@@ -208,6 +230,8 @@ export declare const REGION_PRESETS: {
         detectSimilarity?: boolean;
         similarityThreshold?: number;
         detectSplit?: boolean;
+        useLevenshtein?: boolean;
+        maxLevenshteinDistance?: number;
     };
 };
 export declare const REPLACEMENT_CHARS: {

package/dist/constants/wordList.d.ts

@@ -1,4 +1,4 @@
-import { ProfanityWord } from "../types";
+import { ProfanityWord } from '../types';
 export declare const wordCategories: {
     sexual: string[];
     insult: string[];

package/dist/core/analyzer.d.ts

@@ -1,4 +1,4 @@
-import { FilterOptions, AnalysisResult, ProfanityCategory, Region } from "../types";
+import { FilterOptions, AnalysisResult, ProfanityCategory, Region } from '../types';
 /**
  * Menganalisis teks untuk kata kotor
  *

package/dist/core/filter.d.ts

@@ -1,4 +1,4 @@
-import { FilterOptions, FilterResult } from "../types";
+import { FilterOptions, FilterResult } from '../types';
 /**
  * Menyensor kata kotor dalam teks
  *

package/dist/core/matcher.d.ts

@@ -1,4 +1,4 @@
-import { ProfanityWord, ProfanityCategory, Region, FilterOptions } from "../types";
+import { ProfanityWord, ProfanityCategory, Region, FilterOptions } from '../types';
 export declare function findProfanity(text: string, options?: FilterOptions): string[];
 /**
  * Mencari kata kotor lengkap dengan metadata

package/dist/index.d.ts

@@ -25,6 +25,8 @@ interface FilterOptions {
     detectSimilarity?: boolean;
     similarityThreshold?: number;
     detectSplit?: boolean;
+    useLevenshtein?: boolean;
+    maxLevenshteinDistance?: number;
 }
 interface FilterResult {
     filtered: string;