kreftjs 0.0.19-beta → 0.0.20-beta
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -0
- package/bin/build.js +13 -2
- package/bin/kreftjs.js +1 -0
- package/book/ar/01-getting-started.md +169 -0
- package/book/ar/02-language.md +330 -0
- package/book/ar/03-components-and-state.md +258 -0
- package/book/ar/04-router-data-forms.md +333 -0
- package/book/ar/05-arabic-rtl.md +175 -0
- package/book/ar/06-backend.md +247 -0
- package/book/ar/07-auth-and-security.md +157 -0
- package/book/ar/08-background-work.md +250 -0
- package/book/ar/09-testing-and-deploy.md +234 -0
- package/book/ar/10-electron-desktop.md +258 -0
- package/book/ar/11-advanced-blog.md +370 -0
- package/book/ar/12-advanced-shop.md +426 -0
- package/book/ar/13-advanced-ui.md +440 -0
- package/book/ar/14-advanced-ops.md +167 -0
- package/book/ar/15-appendix.md +81 -0
- package/book/ar/README.md +62 -0
- package/book/kreft-book-ar.docx +0 -0
- package/docs/README.md +2 -2
- package/kreftjs.d.ts +1 -1
- package/kreftjs.js +436 -74
- package/package.json +4 -3
- package/templates/app/frontend/errors/ErrorMonitor.kreft +2 -2
- package/templates/app/frontend/kreftjs.d.ts +1 -1
- package/templates/app/frontend/kreftjs.js +436 -74
- package/templates/app/frontend/pages/Dashboard.kreft +1 -1
- package/templates/errors/ErrorMonitor.kreft +1 -1
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
# الملحق: مرجع سريع وأخطاء شائعة ومصطلحات
|
|
2
|
+
|
|
3
|
+
## ورقة الغش
|
|
4
|
+
|
|
5
|
+
| أريد… | في `.kreft` | في JavaScript |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| قيمة تتغير | `state n = 0` | `Kreftjs.signal(0)` |
|
|
8
|
+
| قيمة محسوبة | `derive d = n * 2` | `Kreftjs.derived(() => n.value * 2)` |
|
|
9
|
+
| دالة | `action add() { n++ }` | دالة عادية |
|
|
10
|
+
| رد فعل على تغيّر | `watch n { … }` | `Kreftjs.watch(n, fn)` |
|
|
11
|
+
| عند تحقق شرط | `when n > 5 { … }` | `Kreftjs.effect(...)` |
|
|
12
|
+
| قيمة محفوظة | `saved n = 0` | `Kreftjs.saved('n', 0)` |
|
|
13
|
+
| جلب بيانات | `load x = api.get('/api/x')` | `await api.get('/api/x')` |
|
|
14
|
+
| مخزن مشترك | `use cart` | `Kreftjs.store('cart', {…})` |
|
|
15
|
+
| قيمة للأبناء | `share t = 'dark'` / `receive t` | `app.share('t', v)` |
|
|
16
|
+
| رسالة عامة | `bus.send('x', v)` / `bus.on('x', fn)` | نفسه |
|
|
17
|
+
| تنقّل | `$router.go('/x')` | `router.go('/x')` |
|
|
18
|
+
| ترجمة | `{$t('messages.hello')}` | `Kreftjs.locale('ar')` |
|
|
19
|
+
|
|
20
|
+
## الواجهة الخلفية بسرعة
|
|
21
|
+
|
|
22
|
+
| المهمة | الشيفرة |
|
|
23
|
+
|---|---|
|
|
24
|
+
| مسار | `Route.get('/x', [Controller, 'method'])` |
|
|
25
|
+
| مجموعة بوسيط | `Route.middleware('auth').group(() => {…})` |
|
|
26
|
+
| تحقق | `await req.validate({ f: 'required\|email' })` |
|
|
27
|
+
| إنشاء | `await Model.create({…})` |
|
|
28
|
+
| استعلام | `Model.query().scope().with('rel').paginate(15, page)` |
|
|
29
|
+
| معاملة | `await DB.transaction(async () => {…})` |
|
|
30
|
+
| حدث | `await event(new Something(x))` |
|
|
31
|
+
| مهمة | `await Job.dispatch(x).delay(60)` |
|
|
32
|
+
| بريد | `await Mail.to(u).queue(new M(x))` |
|
|
33
|
+
| ذاكرة مؤقتة | `await Cache.remember('k', 60, fn)` |
|
|
34
|
+
| قفل | `await Cache.lock('k', 15, fn)` |
|
|
35
|
+
| جدولة | `Schedule.job(new J()).dailyAt('08:00')` |
|
|
36
|
+
|
|
37
|
+
## أخطاء شائعة وعلاجها
|
|
38
|
+
|
|
39
|
+
| الخطأ | العَرَض | العلاج |
|
|
40
|
+
|---|---|---|
|
|
41
|
+
| استعمال `const`/`let` لشيء تحتاجه الصفحة | الصفحة فارغة بلا أي خطأ | `state` أو `derive` أو `action` |
|
|
42
|
+
| `{total()}` على `derive` | خطأ أو قيمة غريبة | `{total}` بلا أقواس |
|
|
43
|
+
| نسيان `await` على `dispatch` | المهمة لا تُرسل | `await Job.dispatch(...)` |
|
|
44
|
+
| `type="email"` يمنع الإرسال | لا تظهر رسائل Kreft | أضف `novalidate` للنموذج |
|
|
45
|
+
| `<` ملاصقة لحرف في قالب | `{a<b}` تُفهم كوسم | اكتب `{a < b}` |
|
|
46
|
+
| `no such table` | بعد إضافة ترحيل | `kreft migrate` |
|
|
47
|
+
| صفحة بيضاء بعد النشر | `<base href>` خاطئ | `kreft build --base /` |
|
|
48
|
+
| فتح `.kreft` من `file://` | لا يعمل | استعمل `npm run dev` أو خادمًا |
|
|
49
|
+
| `/docs` 404 عند التحديث | `.htaccess` لم يُرفع | ارفعه وأظهر الملفات المخفية |
|
|
50
|
+
| `Str.slug` مع العربية | `ا-ول` بدل `أول` | اكتب `slugify` يُبقي `\p{L}` |
|
|
51
|
+
| الاسم الخام في رسالة التحقق | "اكتب author…" | أضف `attributes` في `lang/ar/validation.json` |
|
|
52
|
+
| تكرار الحدث/البريد عند إعادة الإرسال | بريدان | أطلق الحدث بعد النجاح فقط (`fresh`) |
|
|
53
|
+
|
|
54
|
+
## مصطلحات
|
|
55
|
+
|
|
56
|
+
| المصطلح | المعنى |
|
|
57
|
+
|---|---|
|
|
58
|
+
| **State (حالة)** | قيمة تتغير؛ عند تغيّرها تتحدث الصفحة. |
|
|
59
|
+
| **Derived (مشتقة)** | قيمة تُحسب من قيم أخرى وتتحدث وحدها. |
|
|
60
|
+
| **Action (فعل)** | دالة تغيّر الحالة أو تنفّذ عملًا. |
|
|
61
|
+
| **Store (مخزن)** | حالة مشتركة بين مكوّنات كثيرة. |
|
|
62
|
+
| **Slot (فتحة)** | مكان في المكوّن يملؤه من يستعمله. |
|
|
63
|
+
| **Portal (بوابة)** | رسم محتوى في مكان آخر من الصفحة (كالنافذة المنبثقة). |
|
|
64
|
+
| **Directive (توجيه)** | سمة خاصة على عنصر مثل `k-if` و`k-each`. |
|
|
65
|
+
| **Hot reload** | تبديل المكوّن المعدَّل دون تحديث الصفحة. |
|
|
66
|
+
| **Migration (ترحيل)** | وصف لتغيير في بنية قاعدة البيانات. |
|
|
67
|
+
| **Seeder (بذرة)** | ملء بيانات البداية. |
|
|
68
|
+
| **Factory (مصنع)** | صنع بيانات وهمية للاختبار. |
|
|
69
|
+
| **Middleware (وسيط)** | شيفرة تعمل قبل المتحكم. |
|
|
70
|
+
| **Policy (سياسة)** | قواعد تحدد من يستطيع فعل ماذا بأي نموذج. |
|
|
71
|
+
| **Job (مهمة)** | عمل يُنفَّذ في الخلفية على طابور. |
|
|
72
|
+
| **Idempotency (عدم التكرار)** | تنفيذ الطلب نفسه مرتين له أثر مرة واحدة. |
|
|
73
|
+
| **Prerender** | توليد HTML جاهز لكل صفحة وقت البناء. |
|
|
74
|
+
| **CSP** | سياسة أمان المحتوى؛ تقيّد ما يجوز للصفحة تحميله وتنفيذه. |
|
|
75
|
+
| **RTL** | الكتابة من اليمين إلى اليسار. |
|
|
76
|
+
|
|
77
|
+
## أين تتعمق؟
|
|
78
|
+
|
|
79
|
+
- التوثيق الكامل بالإنجليزية: `docs/README.md` (وفي الموقع: kreftjs.com/docs).
|
|
80
|
+
- `kreft help` و`kreft list` و`kreft electron:help` في الطرفية.
|
|
81
|
+
- أدوات المطوّر: الزر **S** في التطبيق أثناء `kreft dev`.
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# كتاب Kreft بالعربية: من الأساسيات إلى الأمثلة المتقدمة جدًا
|
|
2
|
+
|
|
3
|
+
كتاب عملي لتتعلم **Kreft (`kreftjs`)**، الإطار التفاعلي ذو لغة المكوّنات `.kreft` والواجهة الخلفية المتكاملة على Node.js، وبناء تطبيقات الويب وسطح المكتب به.
|
|
4
|
+
|
|
5
|
+
> **ملاحظة عن الدقة:** الأمثلة المتقدمة (الفصول 11 إلى 14) **جُرِّبت فعلًا**: شُغّل خادم Kreft، وأُرسلت طلبات حقيقية، وفُتحت الصفحات في متصفح. وما لم نستطع التحقق منه ذكرناه صراحة في موضعه. الإطار ما زال تجريبيًا (`0.0.x-beta`)، فراجع `docs/README.md` (بالإنجليزية) عند أي اختلاف مع إصدارك.
|
|
6
|
+
|
|
7
|
+
## الفهرس
|
|
8
|
+
|
|
9
|
+
### الجزء الأول: الأساسيات
|
|
10
|
+
|
|
11
|
+
1. [البداية](01-getting-started.md): التثبيت وأول تطبيق وبنية المشروع.
|
|
12
|
+
2. [لغة Kreft](02-language.md): `state` و`derive` و`action` و`watch` والقوالب والتوجيهات والحركات.
|
|
13
|
+
3. [المكوّنات ومشاركة الحالة](03-components-and-state.md): props والأحداث والفتحات وkeep وwait والمخازن وsaved.
|
|
14
|
+
4. [الموجِّه والبيانات والنماذج](04-router-data-forms.md): المسارات والتخطيطات و`load` و`api` و`form()`.
|
|
15
|
+
5. [العربية والترجمة والاتجاه RTL](05-arabic-rtl.md): `$t` و`$choice` والجمع العربي وCSS المنطقي.
|
|
16
|
+
|
|
17
|
+
### الجزء الثاني: الواجهة الخلفية والتشغيل
|
|
18
|
+
|
|
19
|
+
6. [الواجهة الخلفية](06-backend.md): المسارات والمتحكمات والنماذج والترحيلات.
|
|
20
|
+
7. [المصادقة والوسطاء والأمان](07-auth-and-security.md): تسجيل الدخول والسياسات وقائمة الإنتاج.
|
|
21
|
+
8. [العمل في الخلفية](08-background-work.md): الطوابير والأحداث والبريد والذاكرة المؤقتة والأقفال والجدولة.
|
|
22
|
+
9. [الاختبار والبناء والنشر](09-testing-and-deploy.md): الاختبار وSEO والنشر وقاعدة `<base>`.
|
|
23
|
+
10. [تطبيقات سطح المكتب](10-electron-desktop.md): Electron والقائمة والأيقونة والمثبّتات.
|
|
24
|
+
|
|
25
|
+
### الجزء الثالث: أمثلة متقدمة جدًا (مختبَرة)
|
|
26
|
+
|
|
27
|
+
11. [مدونة كاملة](11-advanced-blog.md): علاقات متعددة لمتعدد وscopes وقاعدة تحقق عربية وبحث بتأخير وSEO.
|
|
28
|
+
12. [متجر إلكتروني كامل](12-advanced-shop.md): معاملات وعدم تكرار وأقفال وأحداث وبريد على الطابور.
|
|
29
|
+
13. [واجهات متقدمة ومكتبة مكوّنات](13-advanced-ui.md): نافذة منبثقة وجدول عام وتوجيهات خاصة وتراجع/إعادة وتحديث متفائل واستطلاع حي.
|
|
30
|
+
14. [تقارير مجدولة وتشغيل حقيقي](14-advanced-ops.md): مهام موثوقة وجدولة وMCP ورموز API.
|
|
31
|
+
|
|
32
|
+
### الملحق
|
|
33
|
+
|
|
34
|
+
15. [مرجع سريع وأخطاء شائعة ومصطلحات](15-appendix.md).
|
|
35
|
+
|
|
36
|
+
## كيف تقرأ هذا الكتاب؟
|
|
37
|
+
|
|
38
|
+
- **مبتدئ:** الفصول 1 إلى 5 بالترتيب، ونفّذ التمارين في نهاية كل فصل.
|
|
39
|
+
- **تعرف JavaScript وتريد تطبيقًا كاملًا:** 4 ثم 6 ثم 7 ثم 11 و12.
|
|
40
|
+
- **تريد النشر:** 9 (وانتبه إلى قسم `<base>`).
|
|
41
|
+
- **تريد سطح المكتب:** 10.
|
|
42
|
+
|
|
43
|
+
## ما الذي سنبنيه؟
|
|
44
|
+
|
|
45
|
+
من فصل لفصل ننتقل من عدّاد صغير إلى:
|
|
46
|
+
|
|
47
|
+
- مدونة بوسوم وتعليقات وبحث وSEO.
|
|
48
|
+
- متجر بسلة ودفع آمن لا يكرر الطلبات ولا يبيع ما نفد.
|
|
49
|
+
- مكتبة مكوّنات (نافذة وجدول وتوجيهات).
|
|
50
|
+
- لوحة أرقام حيّة وتقرير يومي مجدول.
|
|
51
|
+
|
|
52
|
+
## تشغيل أمثلة الكتاب
|
|
53
|
+
|
|
54
|
+
أنشئ مشروعًا تجريبيًا وانسخ إليه الملفات المذكورة في كل فصل:
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
kreft new lab --no-auth --db sqlite
|
|
58
|
+
cd lab
|
|
59
|
+
npm run dev
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
وبعد إضافة ترحيل جديد شغّل `kreft migrate`.
|
|
Binary file
|
package/docs/README.md
CHANGED
|
@@ -82,7 +82,7 @@ npx kreftjs dev
|
|
|
82
82
|
### Check that it works
|
|
83
83
|
|
|
84
84
|
```bash
|
|
85
|
-
kreft --version # for example 0.0.
|
|
85
|
+
kreft --version # for example 0.0.20-beta
|
|
86
86
|
kreft about # Kreft and Node.js versions, this project's settings and drivers
|
|
87
87
|
kreft list # every command your version has
|
|
88
88
|
```
|
|
@@ -1732,7 +1732,7 @@ What you get:
|
|
|
1732
1732
|
- **A strict Content-Security-Policy works.** Every expression becomes a real function, so the built app never uses `eval` or `new Function`.
|
|
1733
1733
|
- **Errors before you deploy.** A mistake in any `.kreft` file stops the build and names the file and line.
|
|
1734
1734
|
|
|
1735
|
-
Options: `kreft build ./site --out public` builds another folder, and `--base /` changes `<base href>`. `--no-htaccess` skips the `.htaccess` file described below.
|
|
1735
|
+
Options: `kreft build ./site --out public` builds another folder, and `--base /` changes `<base href>`. `--no-htaccess` skips the `.htaccess` file described below. If esbuild is installed (`kreft add -D esbuild`), `kreftjs.js` is minified in the output (about 44 kB gzipped instead of 69 kB); `--no-minify` copies it as it is.
|
|
1736
1736
|
|
|
1737
1737
|
### Upload to a host
|
|
1738
1738
|
|
package/kreftjs.d.ts
CHANGED