# Foxmayn Frappe Types: TypeScript لتطبيقات Frappe

> ابنوا شيفرة TypeScript في تطبيقات Frappe وراقبوها وافحصوا أنواعها، وولّدوا أنواع DocType من موقع حي. متاح على npm باسم @foxmayn/fft.

Updated: 2026-10-27

- **التفاصيل:** Foxmayn Frappe Types (fft)
- **آخر إصدار:** v1.2.0 (2026-07-30) https://github.com/nasroykh/foxmayn_frappe_types/releases/tag/v1.2.0
- **الرخصة:** MIT
- **لغة البرمجة:** TypeScript
- **روابط:** https://github.com/nasroykh/foxmayn_frappe_types

ليس مشروعاً رسمياً من Frappe. ولا ارتباط له بشركة Frappe Technologies.

## ماذا يفعل

يتيح لكم `fft` كتابة شيفرة الواجهة في تطبيق Frappe بلغة TypeScript. يترجم ملفاتكم، ويراقبها أثناء العمل، ويشغّل فاحص الأنواع، ويولّد أنواع TypeScript لـ DocTypes لديكم من موقع يعمل على البيئة المحلية لديكم (bench). هو لمطوري Frappe الذين يريدون أن يعرف المحرر اسم الحقل ونوع قيمته.

## الميزات

- **`fft build`** يترجم شيفرة TypeScript لتطبيق Frappe.
- **`fft watch`** يعيد البناء عند كل تغيير. أضيفوا `--typecheck` لفحص الأنواع أثناء العمل.
- **`fft typecheck`** يشغّل فاحص الأنواع وحده.
- **`fft generate`** يقرأ DocTypes من موقع على البيئة المحلية لديكم (bench) ويكتب الأنواع. يقبل `--site` و`--doctypes` و`--out`.
- **متغيرات عامة مكتوبة الأنواع للواجهة.** تتضمن الحزمة أنواع المتغيرات العامة في واجهة Frappe، مثل `frappe` و`cur_frm`.

## التثبيت

تحتاجون إلى Node 18 أو أحدث. أضيفوا `fft` إلى تطبيق Frappe كاعتمادية تطوير:

```bash
pnpm add -D @foxmayn/fft
```

ولّدوا الأنواع من موقعكم:

```bash
pnpm fft generate --site acme.localhost --doctypes "Sales Invoice,Customer" --out myapp/types/generated
```

شغّلوا المراقب أثناء التطوير:

```bash
pnpm fft watch --typecheck
```

إصدار npm الحالي هو 1.2.0، نُشر في 30 يوليو 2026. نشغّل مجموعة الاختبارات بـ vitest قبل كل نشر. لا يوجد CI عند الدفع، والحزمة غير موقَّعة.

## لماذا بنيناه

سكربت نموذج Frappe شيفرة JavaScript تشير إلى الحقول بنصوص. خطأ إملائي في اسم حقل يفشل وقت التشغيل، على شاشة المستخدم. ومع الأنواع المولَّدة، يفشل الخطأ نفسه في المحرر. نكتب شيفرة الواجهة بـ TypeScript في كل [تطبيق Frappe مخصص](https://foxmayn.com/ar/services) نبنيه، و`fft` هي الأداة التي كتبناها لنجعل ذلك عملياً.

الشيفرة المصدرية والإصدارات والمشكلات على [GitHub](https://github.com/nasroykh/foxmayn_frappe_types). الرخصة MIT. أدوات ذات صلة: [Foxmayn Frappe CLI](https://foxmayn.com/ar/open-source/ffc) و[Foxmayn Frappe Manager](https://foxmayn.com/ar/open-source/ffm).

---
تواصل معنا: foxmayn@protonmail.com · https://foxmayn.com/ar#contact
HTML: https://foxmayn.com/ar/open-source/fft · [en](https://foxmayn.com/en/open-source/fft.md) · [fr](https://foxmayn.com/fr/open-source/fft.md)