@intlayer/docs 7.2.3 → 7.3.0-canary.0

package/docs/ar/cli/index.md

@@ -0,0 +1,163 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: CLI
+description: اكتشف كيفية استخدام واجهة الأوامر Intlayer CLI لإدارة موقعك متعدد اللغات. اتبع الخطوات في هذه الوثائق الإلكترونية لإعداد مشروعك في دقائق قليلة.
+keywords:
+  - CLI
+  - واجهة سطر الأوامر
+  - التدويل
+  - التوثيق
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - cli
+history:
+  - version: 7.2.3
+    date: 2025-11-22
+    changes: إضافة أمر transform
+  - version: 7.1.0
+    date: 2025-11-05
+    changes: إضافة خيار skipIfExists لأمر translate
+  - version: 6.1.4
+    date: 2025-01-27
+    changes: إضافة أسماء مستعارة لوسائط وأوامر CLI
+  - version: 6.1.3
+    date: 2025-10-05
+    changes: إضافة خيار build للأوامر
+  - version: 6.1.2
+    date: 2025-09-26
+    changes: إضافة أمر version
+  - version: 6.1.0
+    date: 2025-09-26
+    changes: تعيين خيار verbose ليكون true بشكل افتراضي باستخدام CLI
+  - version: 6.1.0
+    date: 2025-09-23
+    changes: إضافة أمر watch وخيار with
+  - version: 6.0.1
+    date: 2025-09-23
+    changes: إضافة أمر editor
+  - version: 6.0.0
+    date: 2025-09-17
+    changes: إضافة أمر content test و list
+  - version: 5.5.11
+    date: 2025-07-11
+    changes: تحديث توثيق معلمات أوامر CLI
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: بدء السجل
+---
+
+# Intlayer CLI
+
+---
+
+## جدول المحتويات
+
+<TOC/>
+
+---
+
+## تثبيت الحزمة
+
+قم بتثبيت الحزم اللازمة باستخدام npm:
+
+```bash packageManager="npm"
+npm install intlayer-cli -g
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-cli -g
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-cli -g
+```
+
+> إذا كانت حزمة `intlayer` مثبتة بالفعل، يتم تثبيت CLI تلقائيًا. يمكنك تخطي هذه الخطوة.
+
+## حزمة intlayer-cli
+
+تهدف حزمة `intlayer-cli` إلى تحويل [تصريحات intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/content_file.md) الخاصة بك إلى قواميس.
+
+ستقوم هذه الحزمة بتحويل جميع ملفات intlayer، مثل `src/**/*.content.{ts|js|mjs|cjs|json}`. [انظر كيفية إعلان ملفات تصريح Intlayer الخاصة بك](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+
+لتفسير قواميس intlayer يمكنك استخدام المفسرات، مثل [react-intlayer](https://www.npmjs.com/package/react-intlayer)، أو [next-intlayer](https://www.npmjs.com/package/next-intlayer)
+
+## دعم ملفات التكوين
+
+يقبل Intlayer عدة صيغ لملفات التكوين:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+لمعرفة كيفية تكوين اللغات المتاحة، أو معلمات أخرى، راجع [توثيق التكوين هنا](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md).
+
+## تشغيل أوامر intlayer
+
+### الأوامر الأساسية
+
+- **[بناء القواميس](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/build.md)** - بناء قواميسك من ملفات إعلان المحتوى
+- **[مراقبة القواميس](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/watch.md)** - مراقبة التغييرات وبناء القواميس تلقائيًا
+- **[التحقق من إصدار CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/version.md)** - التحقق من إصدار Intlayer CLI المثبت
+
+### إدارة القواميس
+
+- **[دفع القواميس](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/push.md)** - دفع القواميس إلى محرر Intlayer ونظام إدارة المحتوى
+- **[سحب القواميس](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/pull.md)** - سحب القواميس من محرر Intlayer ونظام إدارة المحتوى
+- **[ملء القواميس](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/fill.md)** - ملء، تدقيق، وترجمة القواميس باستخدام الذكاء الاصطناعي
+- **[اختبار الترجمات المفقودة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/test.md)** - اختبار وتحديد الترجمات المفقودة
+- **[قائمة ملفات إعلان المحتوى](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/list.md)** - سرد جميع ملفات إعلان المحتوى في مشروعك
+
+### إدارة المكونات
+
+- **[تحويل المكونات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/transform.md)** - تحويل المكونات الحالية لاستخدام Intlayer
+
+### التهيئة
+
+- **[إدارة التهيئة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/configuration.md)** - الحصول على تهيئة Intlayer الخاصة بك ودفعها إلى نظام إدارة المحتوى (CMS)
+
+### إدارة الوثائق
+
+- **[ترجمة الوثائق](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/doc-translate.md)** - ترجمة ملفات الوثائق تلقائيًا باستخدام الذكاء الاصطناعي
+- **[مراجعة الوثائق](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/doc-review.md)** - مراجعة ملفات الوثائق من حيث الجودة والاتساق
+
+### المحرر والمزامنة الحية
+
+- **[أوامر المحرر](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/editor.md)** - استخدم أوامر محرر Intlayer
+- **[أوامر المزامنة الحية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/live.md)** - استخدم المزامنة الحية لعكس تغييرات محتوى نظام إدارة المحتوى (CMS) أثناء وقت التشغيل
+
+### أدوات التطوير
+
+- **[SDK سطر الأوامر](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/sdk.md)** - استخدم SDK الخاص بـ Intlayer CLI في كودك الخاص
+- **[أمر تصحيح Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/debug.md)** - تصحيح واستكشاف مشكلات Intlayer CLI
+
+## استخدم أوامر intlayer في ملف `package.json` الخاص بك
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:build": "npx intlayer build",
+  "intlayer:watch": "npx intlayer build --watch",
+  "intlayer:push": "npx intlayer push",
+  "intlayer:pull": "npx intlayer pull",
+  "intlayer:fill": "npx intlayer fill",
+  "intlayer:list": "npx intlayer content list",
+  "intlayer:test": "npx intlayer content test",
+  "intlayer:transform": "npx intlayer transform",
+  "intlayer:doc:translate": "npx intlayer doc translate",
+  "intlayer:doc:review": "npx intlayer doc review"
+}
+```
+
+> **ملاحظة**: يمكنك أيضًا استخدام الأسماء المختصرة:
+>
+> - `npx intlayer list` بدلاً من `npx intlayer content list`
+> - `npx intlayer test` بدلاً من `npx intlayer content test`

package/docs/ar/cli/list.md

@@ -0,0 +1,53 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: قائمة ملفات إعلان المحتوى
+description: تعلّم كيفية سرد جميع ملفات إعلان المحتوى في مشروعك.
+keywords:
+  - قائمة
+  - إعلان المحتوى
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - list
+---
+
+# قائمة ملفات إعلان المحتوى
+
+```bash
+npx intlayer content list
+```
+
+## الأسماء المستعارة:
+
+- `npx intlayer list`
+
+يعرض هذا الأمر جميع ملفات إعلان المحتوى في مشروعك، مع عرض مفاتيح القاموس الخاصة بها ومسارات الملفات. وهو مفيد للحصول على نظرة عامة على جميع ملفات المحتوى الخاصة بك والتحقق من اكتشافها بشكل صحيح بواسطة Intlayer.
+
+## مثال:
+
+```bash
+npx intlayer content list
+```
+
+## مثال على الإخراج:
+
+```bash
+npx intlayer content list
+Content declaration files:
+ - home-page        - src/components/HomePage/homePage.content.ts
+ - server-component - src/components/ServerComponent/serverComponent.content.ts
+ - client-component - src/components/ClientComponent/clientComponent.content.ts
+
+إجمالي ملفات إعلان المحتوى: 3
+```
+
+سيقوم هذا الأمر بإخراج:
+
+- قائمة منسقة بجميع ملفات إعلان المحتوى مع مفاتيحها ومسارات الملفات النسبية
+- العدد الإجمالي لملفات إعلان المحتوى التي تم العثور عليها
+
+يساعدك الإخراج على التحقق من أن جميع ملفات المحتوى الخاصة بك مُعدة بشكل صحيح وقابلة للاكتشاف بواسطة نظام Intlayer.

package/docs/ar/cli/live.md

@@ -0,0 +1,41 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: أوامر المزامنة الحية
+description: تعلّم كيفية استخدام المزامنة الحية لعكس تغييرات محتوى CMS أثناء وقت التشغيل.
+keywords:
+  - المزامنة الحية
+  - CMS
+  - وقت التشغيل
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - live
+---
+
+# أوامر المزامنة الحية
+
+تتيح لك المزامنة الحية أن يعكس تطبيقك تغييرات محتوى CMS أثناء وقت التشغيل. لا حاجة لإعادة البناء أو إعادة النشر. عند التفعيل، يتم بث التحديثات إلى خادم المزامنة الحية الذي يقوم بتحديث القواميس التي يقرأها تطبيقك. راجع [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md) لمزيد من التفاصيل.
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:live:start": "npx intlayer live start --with 'next dev --turbopack'"
+}
+```
+
+## الوسائط:
+
+**خيارات التكوين:**
+
+- **`--base-dir`**: تحديد الدليل الأساسي للمشروع. لاسترجاع تكوين intlayer، سيبحث الأمر عن ملف `intlayer.config.{ts,js,json,cjs,mjs}` في الدليل الأساسي.
+
+- **`--no-cache`**: تعطيل التخزين المؤقت.
+
+  > مثال: `npx intlayer dictionary push --env-file .env.production.local`
+
+**خيارات السجل:**
+
+- **`--verbose`**: تفعيل تسجيل مفصل لأغراض التصحيح. (الإعداد الافتراضي هو true عند استخدام CLI)

package/docs/ar/cli/pull.md

@@ -0,0 +1,78 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: سحب القواميس
+description: تعلّم كيفية سحب القواميس من محرر Intlayer ونظام إدارة المحتوى.
+keywords:
+  - سحب
+  - قواميس
+  - CLI
+  - Intlayer
+  - محرر
+  - نظام إدارة المحتوى
+slugs:
+  - doc
+  - concept
+  - cli
+  - pull
+---
+
+# سحب القواميس البعيدة
+
+```bash
+npx intlayer pull
+```
+
+إذا كان [محرر intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md) مثبتًا، يمكنك أيضًا سحب القواميس من المحرر. بهذه الطريقة، يمكنك استبدال محتوى قواميسك حسب حاجة تطبيقك.
+
+## الأسماء المستعارة:
+
+- `npx intlayer dictionaries pull`
+- `npx intlayer dictionary pull`
+- `npx intlayer dic pull`
+
+## الوسائط:
+
+**خيارات القاموس:**
+
+- **`-d, --dictionaries`**: معرفات القواميس التي سيتم سحبها. إذا لم يتم تحديدها، سيتم سحب جميع القواميس.
+
+  > مثال: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
+
+- **`--dictionary`**: معرفات القواميس التي سيتم سحبها (اسم مستعار لـ --dictionaries).
+
+  > مثال: `npx intlayer dictionary pull --dictionary my-dictionary-id my-other-dictionary-id`
+
+**خيارات التكوين:**
+
+- **`--base-dir`**: تحديد الدليل الأساسي للمشروع. لاسترجاع تكوين intlayer، سيبحث الأمر عن ملف `intlayer.config.{ts,js,json,cjs,mjs}` في الدليل الأساسي.
+
+  > مثال: `npx intlayer dictionary push --env-file .env.production.local`
+
+- **`--no-cache`**: تعطيل التخزين المؤقت.
+
+  > مثال: `npx intlayer build --no-cache`
+
+**خيارات متغيرات البيئة:**
+
+- **`--env`**: تحديد البيئة (مثل `development`، `production`).
+- **`--env-file`**: توفير ملف بيئة مخصص لتحميل المتغيرات منه.
+- **`--base-dir`**: تحديد الدليل الأساسي للمشروع. لاسترجاع تكوين intlayer، سيبحث الأمر عن ملف `intlayer.config.{ts,js,json,cjs,mjs}` في الدليل الأساسي.
+
+  > مثال: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > مثال: `npx intlayer dictionary push --env production`
+
+**خيارات الإخراج:**
+
+- **`--new-dictionaries-path`** : مسار الدليل الذي سيتم حفظ القواميس الجديدة فيه. إذا لم يتم تحديده، فسيتم حفظ القواميس الجديدة في دليل `./intlayer-dictionaries` الخاص بالمشروع. إذا تم تحديد حقل `filePath` في محتوى القاموس الخاص بك، فلن تأخذ القواميس هذا الوسيط في الاعتبار وسيتم حفظها في الدليل المحدد في `filePath`.
+
+**خيارات السجل:**
+
+- **`--verbose`**: تمكين تسجيل مفصل لأغراض التصحيح. (القيمة الافتراضية هي true عند استخدام CLI)
+
+## مثال:
+
+```bash
+npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
+```

package/docs/ar/cli/push.md

@@ -0,0 +1,98 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: دفع القواميس
+description: تعلّم كيفية دفع القواميس الخاصة بك إلى محرر Intlayer ونظام إدارة المحتوى.
+keywords:
+  - دفع
+  - قواميس
+  - CLI
+  - Intlayer
+  - محرر
+  - نظام إدارة المحتوى
+slugs:
+  - doc
+  - concept
+  - cli
+  - push
+---
+
+# دفع القواميس
+
+```bash
+npx intlayer dictionary push
+```
+
+إذا تم تثبيت [محرر intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md)، يمكنك أيضًا دفع القواميس إلى المحرر. سيسمح هذا الأمر بجعل القواميس متاحة لـ [المحرر](https://intlayer.org/dashboard). بهذه الطريقة، يمكنك مشاركة قواميسك مع فريقك وتحرير المحتوى الخاص بك دون الحاجة إلى تعديل كود التطبيق الخاص بك.
+
+## الأسماء المستعارة:
+
+- `npx intlayer dictionaries push`
+- `npx intlayer dictionary push`
+- `npx intlayer dic push`
+
+## الوسائط:
+
+**خيارات القاموس:**
+
+- **`-d`, `--dictionaries`**: معرفات القواميس التي سيتم دفعها. إذا لم يتم تحديدها، سيتم دفع جميع القواميس.
+
+  > مثال: `npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id`
+
+- **`--dictionary`**: معرفات القواميس التي سيتم دفعها (اسم مستعار لـ --dictionaries).
+
+  > مثال: `npx intlayer dictionary push --dictionary my-dictionary-id my-other-dictionary-id`
+
+**خيارات التكوين:**
+
+- **`--base-dir`**: تحديد الدليل الأساسي للمشروع. لاسترجاع تكوين intlayer، سيبحث الأمر عن ملف `intlayer.config.{ts,js,json,cjs,mjs}` في الدليل الأساسي.
+
+  > مثال: `npx intlayer dictionary push --env-file .env.production.local`
+
+- **`--no-cache`**: تعطيل التخزين المؤقت.
+
+  > مثال: `npx intlayer build --no-cache`
+
+**خيارات متغيرات البيئة:**
+
+- **`--env`**: تحديد البيئة (مثل `development`، `production`). مفيد في حالة استخدام متغيرات البيئة في ملف تكوين intlayer الخاص بك.
+- **`--env-file`**: توفير ملف بيئة مخصص لتحميل المتغيرات منه. مفيد في حالة استخدام متغيرات البيئة في ملف تكوين intlayer الخاص بك.
+
+  > مثال: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > مثال: `npx intlayer dictionary push --env production`
+
+**خيارات الإخراج:**
+
+- **`-r`، `--delete-locale-dictionary`**: تخطي السؤال الذي يطلب حذف مجلدات اللغات بمجرد دفع القواميس، وحذفها. بشكل افتراضي، إذا تم تعريف القاموس محليًا، فسيتم استبدال محتوى القواميس البعيدة.
+
+  > مثال: `npx intlayer dictionary push -r`
+
+  > مثال: `npx intlayer dictionary push --delete-locale-dictionary`
+
+- **`-k`، `--keep-locale-dictionary`**: تخطي السؤال الذي يطلب حذف مجلدات اللغات بمجرد دفع القواميس، والاحتفاظ بها. بشكل افتراضي، إذا تم تعريف القاموس محليًا، فسيتم استبدال محتوى القواميس البعيدة.
+
+  > مثال: `npx intlayer dictionary push -k`
+
+  > مثال: `npx intlayer dictionary push --keep-locale-dictionary`
+
+**خيارات التحضير:**
+
+- **`--build`**: بناء القواميس قبل الدفع لضمان تحديث المحتوى. القيمة true ستجبر على البناء، false ستتخطى البناء، undefined ستسمح باستخدام ذاكرة التخزين المؤقت للبناء.
+
+**خيارات السجل:**
+
+- **`--verbose`**: تمكين تسجيل مفصل لأغراض التصحيح. (افتراضيًا true عند استخدام CLI)
+
+**خيارات Git:**
+
+- **`--git-diff`**: تشغيل فقط على القواميس التي تتضمن تغييرات من القاعدة (الافتراضية `origin/main`) إلى الفرع الحالي (الافتراضي: `HEAD`).
+- **`--git-diff-base`**: تحديد المرجع الأساسي لمقارنة git diff (الافتراضي `origin/main`).
+- **`--git-diff-current`**: تحديد المرجع الحالي لمقارنة git diff (الافتراضي: `HEAD`).
+- **`--uncommitted`**: تضمين التغييرات غير الملتزم بها.
+- **`--unpushed`**: تضمين التغييرات غير المدفوعة.
+- **`--untracked`**: تضمين الملفات غير المتتبعة.
+
+  > مثال: `npx intlayer dictionary push --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > مثال: `npx intlayer dictionary push --uncommitted --unpushed --untracked`

package/docs/ar/cli/sdk.md

@@ -0,0 +1,67 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: SDK سطر الأوامر
+description: تعلّم كيفية استخدام SDK سطر أوامر Intlayer في كودك الخاص.
+keywords:
+  - SDK
+  - CLI
+  - Intlayer
+  - برمجي
+slugs:
+  - doc
+  - concept
+  - cli
+  - sdk
+---
+
+# SDK سطر الأوامر
+
+SDK سطر الأوامر هو مكتبة تتيح لك استخدام سطر أوامر Intlayer في كودك الخاص.
+
+```bash packageManager="npm"
+npm install @intlayer/cli --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli --save-dev
+```
+
+مثال على الاستخدام:
+
+```ts
+import {
+  push,
+  pull,
+  fill,
+  build,
+  listContentDeclaration,
+  testMissingTranslations,
+  docTranslate,
+  docReview,
+  transform,
+} from "@intlayer/cli";
+
+push();
+// ...
+pull();
+// ...
+fill();
+// ...
+build();
+// ...
+listContentDeclaration();
+// ...
+testMissingTranslations();
+// ...
+docTranslate();
+// ...
+docReview();
+// ...
+transform();
+// ...
+```

package/docs/ar/cli/test.md

@@ -0,0 +1,76 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: اختبار الترجمات المفقودة
+description: تعلّم كيفية اختبار وتحديد الترجمات المفقودة في قواميسك.
+keywords:
+  - اختبار
+  - الترجمات المفقودة
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - test
+---
+
+# اختبار الترجمات المفقودة
+
+```bash
+npx intlayer content test
+```
+
+## الأسماء المستعارة:
+
+- `npx intlayer test`
+
+يقوم هذا الأمر بتحليل ملفات إعلان المحتوى الخاصة بك لتحديد الترجمات المفقودة عبر جميع اللغات المُعدة. ويوفر تقريرًا شاملاً يوضح مفاتيح الترجمة المفقودة لكل لغة، مما يساعدك في الحفاظ على التناسق عبر محتواك متعدد اللغات.
+
+## مثال على المخرجات:
+
+```bash
+pnpm intlayer content test
+Missing translations:
+ - home-page                      - tr         - src/components/HomePage/homePage.content.ts
+ - server-component               - es, tr     - src/components/ServerComponent/serverComponent.content.ts
+ - client-component               - pl, tr     - src/components/ClientComponent/clientComponent.content.ts
+Locales: en, ru, ja, fr, ko, zh, es, de, ar, it, en-GB, pt, hi, tr, pl
+Required locales: en
+Missing locales: pl, tr, es
+Missing required locales: -
+Total missing locales: 3
+Total missing required locales: 0
+```
+
+## الوسائط:
+
+**خيارات التكوين:**
+
+- **`--env`**: تحديد البيئة (مثل `development`، `production`).
+- **`--env-file [envFile]`**: توفير ملف بيئة مخصص لتحميل المتغيرات منه.
+- **`--base-dir`**: تحديد الدليل الأساسي للمشروع.
+
+  > مثال: `npx intlayer content test --base-dir ./src --env-file .env.production.local`
+
+- **`--no-cache`**: تعطيل التخزين المؤقت.
+
+  > مثال: `npx intlayer build --no-cache`
+
+**خيارات التحضير:**
+
+- **`--build`**: بناء القواميس قبل الدفع لضمان تحديث المحتوى. true ستجبر البناء، false ستتخطى البناء، undefined ستسمح باستخدام التخزين المؤقت للبناء.
+
+**خيارات السجل:**
+
+- **`--verbose`**: تمكين التسجيل التفصيلي لأغراض التصحيح. (افتراضيًا true عند استخدام CLI)
+
+  > مثال: `npx intlayer content test --verbose`
+
+## مثال:
+
+```bash
+npx intlayer content test --verbose
+```
+
+تساعدك النتيجة على تحديد الترجمات التي تحتاج إلى إكمال بسرعة لضمان عمل تطبيقك بشكل صحيح عبر جميع اللغات المكونة.

package/docs/ar/cli/transform.md

@@ -0,0 +1,65 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: تحويل المكونات
+description: تعلّم كيفية تحويل المكونات الحالية لاستخدام Intlayer.
+keywords:
+  - تحويل
+  - مكونات
+  - ترحيل
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - transform
+---
+
+# تحويل المكونات
+
+```bash
+npx intlayer transform
+```
+
+يقوم هذا الأمر بتحليل ملفات الكود الخاصة بك لمساعدتك في ترحيل المكونات الحالية لاستخدام Intlayer. يدعم اختيار الملفات بشكل تفاعلي أو استهداف ملفات محددة.
+
+## الأسماء المستعارة:
+
+- `npx intlayer trans`
+
+## الوسائط:
+
+**خيارات اختيار الملفات:**
+
+- **`-f, --file [files...]`**: قائمة بالملفات المحددة التي تريد تحويلها. إذا لم يتم توفيرها، سيقوم CLI بفحص الملفات المطابقة (`**/*.{tsx,jsx,vue,svelte,ts,js}`) ويطلب منك اختيار الملفات التي تريد تحويلها.
+
+  > مثال: `npx intlayer transform -f src/components/MyComponent.tsx`
+
+**خيارات الإخراج:**
+
+- **`-o, --output-content-declarations [outputContentDeclarations]`**: الدليل لحفظ ملفات إعلان المحتوى المُولدة.
+
+  > مثال: `npx intlayer transform -o src/content`
+
+- **`--code-only`**: تحويل كود المكون فقط (دون كتابة إعلان المحتوى).
+
+  > مثال: `npx intlayer transform --code-only`
+
+- **`--declaration-only`**: توليد إعلان المحتوى فقط (دون إعادة كتابة المكون).
+
+  > مثال: `npx intlayer transform --declaration-only`
+
+**خيارات التهيئة:**
+
+- **`--base-dir`**: تحديد الدليل الأساسي للمشروع.
+- **`--env`**: تحديد البيئة.
+- **`--env-file`**: توفير ملف بيئة مخصص.
+- **`--verbose`**: تمكين تسجيل الدخول التفصيلي.
+
+**الإضافات المطلوبة:**
+
+يعمل أمر التحويل بدون إضافات إضافية على ملفات TypeScript / JSX. ومع ذلك، يتطلب تثبيت الإضافات التالية لمشاريع Vue و Svelte:
+
+- **`@intlayer/vue-transformer`**: لملفات Vue.
+- **`@intlayer/svelte-transformer`**: لملفات Svelte.

package/docs/ar/cli/version.md

@@ -0,0 +1,24 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: التحقق من إصدار CLI
+description: تعلّم كيفية التحقق من إصدار Intlayer CLI المثبت.
+keywords:
+  - الإصدار
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - version
+---
+
+# التحقق من إصدار CLI
+
+```bash
+npx intlayer --version
+npx intlayer version
+```
+
+كلا الأمرين يعرضان إصدار Intlayer CLI المثبت.