# @textguard/fa 🇮🇷

> **پلاگین و دایره واژگان رسمی زبان فارسی برای سیستم فیلترینگ هوشمند و مدرن `textguard`.**

این پکیج به صورت اختصاصی برای زبان فارسی بهینه‌سازی شده است و الگوهای پیچیده متنی، کاراکترهای یونیکد هم‌شکل (نیم‌فاصله، ی و ک عربی) و کلمات نامناسب متداول در پلتفرم‌های فارسی را با بالاترین دقت و سرعت پردازش می‌کند.

---

### ✨ ویژگی‌های کلیدی نسخه فارسی

- 🛠️ **پشتیبانی کامل از ساختارهای یونیکد:** شناسایی متونی که تلاش دارند فیلتر را با تغییر ساختار حروف یا چسباندن کلمات دور بزنند.
- ⌨️ **سازگاری با کیبوردهای مختلف:** یکپارچه‌سازی خودکار تفاوت‌های میان کیبورد فارسی و عربی.
- ⚡ **عملکرد بسیار سریع (High Performance):** بدون ایجاد کوچک‌ترین سربار روی سرورهای Node.js یا فرانت‌اند.

---

### 🚀 نصب

```bash
pnpm add @textguard/core @textguard/fa
💻 نحوه استفاده و مثال‌های واقعی
به کمک پکیج اصلی و این واژه‌نامه فارسی، می‌توانید کامنت‌ها، چت‌ها و نام‌های کاربری سیستم خود را در سریع‌ترین زمان ممکن پایش کنید:

TypeScript
import { createFilter } from '@textguard/core';
import { faRules } from '@textguard/fa';

const filter = createFilter({
  languages: [faRules]
});

// نمونه اول: تشخیص کلمات نامناسب استاندارد
const checkText = filter.hasProfanity("خواهش می‌کنم کارهای احمقانه انجام ندهید.");
console.log(checkText); // true

// نمونه دوم: سانسور هوشمند و جایگزینی با کاراکتر امن
const sanitized = filter.clean("لطفاً این رفتار احمق را گزارش کنید.");
console.log(sanitized); // "لطفاً این رفتار **** را گزارش کنید."

// نمونه سوم: هوشمندی در قبال انواع ساختارهای نگارشی فارسی
// سیستم به خوبی متوجه تفاوت‌ها یا فواصل کلمات می‌شود
console.log(filter.hasProfanity("او یک احمق_است")); // true
📄 لایسنس
MIT © Ashkan Ahmadi
```