@neurocode-ai/web 1.18.8

package/src/content/docs/ar/custom-tools.mdx

@@ -0,0 +1,196 @@
+---
+title: الأدوات المخصصة
+description: أنشئ أدوات يمكن لـ LLM استدعاؤها في opencode.
+---
+
+الأدوات المخصصة هي دوال تنشئها يمكن لـ LLM استدعاؤها أثناء المحادثات. تعمل جنبا إلى جنب مع [الأدوات المدمجة](/docs/tools) في opencode مثل `read` و`write` و`bash`.
+
+---
+
+## إنشاء أداة
+
+تُعرّف الأدوات كملفات **TypeScript** أو **JavaScript**. لكن تعريف الأداة يمكنه استدعاء سكربتات مكتوبة **بأي لغة** — إذ تُستخدم TypeScript أو JavaScript فقط لتعريف الأداة نفسه.
+
+---
+
+### الموقع
+
+يمكن تعريفها:
+
+- محليا بوضعها في مجلد `.opencode/tools/` داخل مشروعك.
+- أو عالميا بوضعها في `~/.config/opencode/tools/`.
+
+---
+
+### البنية
+
+أسهل طريقة لإنشاء أدوات هي استخدام المساعد `tool()` الذي يوفر أمان الأنواع والتحقق.
+
+```ts title=".opencode/tools/database.ts" {1}
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Query the project database",
+  args: {
+    query: tool.schema.string().describe("SQL query to execute"),
+  },
+  async execute(args) {
+    // Your database logic here
+    return `Executed query: ${args.query}`
+  },
+})
+```
+
+يصبح **اسم الملف** هو **اسم الأداة**. المثال أعلاه ينشئ أداة باسم `database`.
+
+---
+
+#### عدة أدوات في ملف واحد
+
+يمكنك أيضا تصدير عدة أدوات من ملف واحد. يصبح كل تصدير **أداة مستقلة** باسم **`<filename>_<exportname>`**:
+
+```ts title=".opencode/tools/math.ts"
+import { tool } from "@opencode-ai/plugin"
+
+export const add = tool({
+  description: "Add two numbers",
+  args: {
+    a: tool.schema.number().describe("First number"),
+    b: tool.schema.number().describe("Second number"),
+  },
+  async execute(args) {
+    return args.a + args.b
+  },
+})
+
+export const multiply = tool({
+  description: "Multiply two numbers",
+  args: {
+    a: tool.schema.number().describe("First number"),
+    b: tool.schema.number().describe("Second number"),
+  },
+  async execute(args) {
+    return args.a * args.b
+  },
+})
+```
+
+ينشئ هذا أداتين: `math_add` و`math_multiply`.
+
+---
+
+#### تضارب الأسماء مع الأدوات المدمجة
+
+تُصنّف الأدوات المخصصة حسب اسم الأداة. إذا استخدمت أداة مخصصة نفس اسم أداة مدمجة، فإن الأداة المخصصة تأخذ الأولوية.
+
+على سبيل المثال، يستبدل هذا الملف أداة `bash` المدمجة:
+
+```ts title=".opencode/tools/bash.ts"
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Restricted bash wrapper",
+  args: {
+    command: tool.schema.string(),
+  },
+  async execute(args) {
+    return `blocked: ${args.command}`
+  },
+})
+```
+
+:::note
+فضّل استخدام أسماء فريدة ما لم تكن تريد استبدال أداة مدمجة عمدا. إذا كنت تريد تعطيل أداة مدمجة ولكن لا تريد استبدالها، استخدم [الأذونات](/docs/permissions).
+:::
+
+---
+
+### الوسائط
+
+يمكنك استخدام `tool.schema`، وهو في الأساس [Zod](https://zod.dev)، لتعريف أنواع الوسائط.
+
+```ts "tool.schema"
+args: {
+  query: tool.schema.string().describe("SQL query to execute")
+}
+```
+
+يمكنك أيضا استيراد [Zod](https://zod.dev) مباشرة وإرجاع كائن عادي:
+
+```ts {6}
+import { z } from "zod"
+
+export default {
+  description: "Tool description",
+  args: {
+    param: z.string().describe("Parameter description"),
+  },
+  async execute(args, context) {
+    // Tool implementation
+    return "result"
+  },
+}
+```
+
+---
+
+### السياق
+
+تستقبل الأدوات سياقا حول الجلسة الحالية:
+
+```ts title=".opencode/tools/project.ts" {8}
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Get project information",
+  args: {},
+  async execute(args, context) {
+    // Access context information
+    const { agent, sessionID, messageID, directory, worktree } = context
+    return `Agent: ${agent}, Session: ${sessionID}, Message: ${messageID}, Directory: ${directory}, Worktree: ${worktree}`
+  },
+})
+```
+
+استخدم `context.directory` لدليل العمل الخاص بالجلسة.
+استخدم `context.worktree` لجذر شجرة العمل (worktree) في git.
+
+---
+
+## أمثلة
+
+### كتابة أداة بلغة Python
+
+يمكنك كتابة أدواتك بأي لغة تريدها. إليك مثالا يجمع رقمين باستخدام Python.
+
+أولا، أنشئ الأداة كسكربت Python:
+
+```python title=".opencode/tools/add.py"
+import sys
+
+a = int(sys.argv[1])
+b = int(sys.argv[2])
+print(a + b)
+```
+
+ثم أنشئ تعريف الأداة الذي يستدعيه:
+
+```ts title=".opencode/tools/python-add.ts" {10}
+import { tool } from "@opencode-ai/plugin"
+import path from "path"
+
+export default tool({
+  description: "Add two numbers using Python",
+  args: {
+    a: tool.schema.number().describe("First number"),
+    b: tool.schema.number().describe("Second number"),
+  },
+  async execute(args, context) {
+    const script = path.join(context.worktree, ".opencode/tools/add.py")
+    const result = await Bun.$`python3 ${script} ${args.a} ${args.b}`.text()
+    return result.trim()
+  },
+})
+```
+
+هنا نستخدم أداة [`Bun.$`](https://bun.com/docs/runtime/shell) لتشغيل سكربت Python.

package/src/content/docs/ar/ecosystem.mdx

@@ -0,0 +1,78 @@
+---
+title: النظام البيئي
+description: مشاريع وتكاملات مبنية باستخدام OpenCode.
+---
+
+مجموعة من مشاريع المجتمع المبنية على OpenCode.
+
+:::note
+هل تريد إضافة مشروعك المتعلق بـ OpenCode إلى هذه القائمة؟ أرسل طلب سحب (PR).
+:::
+
+يمكنك أيضًا الاطلاع على [awesome-opencode](https://github.com/awesome-opencode/awesome-opencode) و [opencode.cafe](https://opencode.cafe)، وهو مجتمع يجمع النظام البيئي والمجتمع.
+
+---
+
+## الإضافات
+
+| الاسم                                                                                              | الوصف                                                                                                          |
+| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| [opencode-daytona](https://github.com/daytonaio/daytona/tree/main/libs/opencode-plugin)            | تشغيل جلسات OpenCode تلقائيًا في صناديق حماية Daytona معزولة مع مزامنة git ومعاينات حية                        |
+| [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session)                  | حقن ترويسات جلسة Helicone تلقائيًا لتجميع الطلبات                                                              |
+| [opencode-type-inject](https://github.com/nick-vi/opencode-type-inject)                            | حقن أنواع TypeScript/Svelte تلقائيًا في عمليات قراءة الملفات باستخدام أدوات البحث                              |
+| [opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth)             | استخدام اشتراك ChatGPT Plus/Pro الخاص بك بدلاً من أرصدة API                                                    |
+| [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth)                            | استخدام خطة Gemini الحالية الخاصة بك بدلاً من فوترة API                                                        |
+| [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth)                | استخدام نماذج Antigravity المجانية بدلاً من فوترة API                                                          |
+| [opencode-devcontainers](https://github.com/athal7/opencode-devcontainers)                         | عزل devcontainer متعدد الفروع مع نسخ shallow ومنافذ معينة تلقائيًا                                             |
+| [opencode-google-antigravity-auth](https://github.com/shekohex/opencode-google-antigravity-auth)   | إضافة Google Antigravity OAuth، مع دعم بحث Google، ومعالجة API أكثر قوة                                        |
+| [opencode-dynamic-context-pruning](https://github.com/Tarquinen/opencode-dynamic-context-pruning)  | تحسين استخدام التوكنات عن طريق تقليم مخرجات الأدوات القديمة                                                    |
+| [opencode-vibeguard](https://github.com/inkdust2021/opencode-vibeguard)                            | تنقيح الأسرار/بيانات التعريف الشخصي (PII) إلى نصوص بديلة بأسلوب VibeGuard قبل استدعاءات LLM؛ واستعادتها محليًا |
+| [opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git)                 | إضافة دعم بحث الويب الأصلي للموفرين المدعومين بأسلوب Google grounded                                           |
+| [opencode-pty](https://github.com/shekohex/opencode-pty.git)                                       | تمكين وكلاء الذكاء الاصطناعي من تشغيل عمليات الخلفية في PTY، وإرسال مدخلات تفاعلية إليها.                      |
+| [opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy)                     | تعليمات لأوامر shell غير التفاعلية - تمنع التعليق الناتج عن العمليات المعتمدة على TTY                          |
+| [opencode-wakatime](https://github.com/angristan/opencode-wakatime)                                | تتبع استخدام OpenCode باستخدام Wakatime                                                                        |
+| [opencode-md-table-formatter](https://github.com/franlol/opencode-md-table-formatter/tree/main)    | تنظيف جداول markdown التي تنتجها LLMs                                                                          |
+| [opencode-morph-plugin](https://github.com/morphllm/opencode-morph-plugin)                         | تحرير Fast Apply وبحث WarpGrep في قاعدة الكود وضغط السياق عبر Morph                                            |
+| [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode)                                   | وكلاء الخلفية، وأدوات LSP/AST/MCP المعدة مسبقًا، ووكلاء مختارون، متوافق مع Claude Code                         |
+| [opencode-notificator](https://github.com/panta82/opencode-notificator)                            | إشعارات سطح المكتب وتنبيهات صوتية لجلسات OpenCode                                                              |
+| [opencode-notifier](https://github.com/mohak34/opencode-notifier)                                  | إشعارات سطح المكتب وتنبيهات صوتية لأحداث الإذن والاكتمال والخطأ                                                |
+| [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer)                            | تسمية جلسات Zellij تلقائيًا بدعم الذكاء الاصطناعي بناءً على سياق OpenCode                                      |
+| [opencode-skillful](https://github.com/zenobi-us/opencode-skillful)                                | السماح لوكلاء OpenCode بتحميل المطالبات (prompts) بشكل كسول عند الطلب مع اكتشاف المهارات وحقنها                |
+| [opencode-supermemory](https://github.com/supermemoryai/opencode-supermemory)                      | ذاكرة مستمرة عبر الجلسات باستخدام Supermemory                                                                  |
+| [@plannotator/opencode](https://github.com/backnotprop/plannotator/tree/main/apps/opencode-plugin) | مراجعة تفاعلية للخطة مع تعليقات توضيحية مرئية ومشاركة خاصة/بدون اتصال                                          |
+| [@openspoon/subtask2](https://github.com/spoons-and-mirrors/subtask2)                              | توسيع opencode /commands إلى نظام تنسيق قوي مع تحكم دقيق في التدفق                                             |
+| [opencode-scheduler](https://github.com/different-ai/opencode-scheduler)                           | جدولة الوظائف المتكررة باستخدام launchd (Mac) أو systemd (Linux) بصيغة cron                                    |
+| [micode](https://github.com/vtemian/micode)                                                        | سير عمل منظم: عصف ذهني ← تخطيط ← تنفيذ مع استمرارية الجلسة                                                     |
+| [octto](https://github.com/vtemian/octto)                                                          | واجهة مستخدم تفاعلية للمتصفح للعصف الذهني بالذكاء الاصطناعي مع نماذج متعددة الأسئلة                            |
+| [opencode-background-agents](https://github.com/kdcokenny/opencode-background-agents)              | وكلاء خلفية بأسلوب Claude Code مع تفويض غير متزامن واستمرارية السياق                                           |
+| [opencode-notify](https://github.com/kdcokenny/opencode-notify)                                    | إشعارات نظام التشغيل الأصلية لـ OpenCode – اعرف متى تكتمل المهام                                               |
+| [opencode-workspace](https://github.com/kdcokenny/opencode-workspace)                              | حزمة تنسيق متعددة الوكلاء – 16 مكونًا، تثبيت واحد                                                              |
+| [opencode-worktree](https://github.com/kdcokenny/opencode-worktree)                                | أشجار عمل git (worktrees) خالية من الاحتكاك لـ OpenCode                                                        |
+| [opencode-sentry-monitor](https://github.com/stolinski/opencode-sentry-monitor)                    | تتبع وتصحيح أخطاء وكلاء الذكاء الاصطناعي باستخدام Sentry AI Monitoring                                         |
+
+---
+
+## المشاريع
+
+| الاسم                                                                                      | الوصف                                                                     |
+| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- |
+| [kimaki](https://github.com/remorses/kimaki)                                               | بوت Discord للتحكم في جلسات OpenCode، مبني على SDK                        |
+| [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim)                              | إضافة Neovim للمطالبات المدركة للمحرر، مبنية على API                      |
+| [portal](https://github.com/hosenur/portal)                                                | واجهة ويب مخصصة للجوال لـ OpenCode عبر Tailscale/VPN                      |
+| [opencode plugin template](https://github.com/zenobi-us/opencode-plugin-template/)         | قالب لبناء إضافات OpenCode                                                |
+| [opencode.nvim](https://github.com/sudo-tee/opencode.nvim)                                 | واجهة Neovim لـ opencode - وكيل برمجة بالذكاء الاصطناعي يعتمد على الطرفية |
+| [ai-sdk-provider-opencode-sdk](https://github.com/ben-vargas/ai-sdk-provider-opencode-sdk) | موفر Vercel AI SDK لاستخدام OpenCode عبر @opencode-ai/sdk                 |
+| [OpenChamber](https://github.com/btriapitsyn/openchamber)                                  | تطبيق ويب / سطح مكتب وامتداد VS Code لـ OpenCode                          |
+| [OpenCode-Obsidian](https://github.com/mtymek/opencode-obsidian)                           | إضافة Obsidian تدمج OpenCode في واجهة مستخدم Obsidian                     |
+| [OpenWork](https://github.com/different-ai/openwork)                                       | بديل مفتوح المصدر لـ Claude Cowork، مدعوم بواسطة OpenCode                 |
+| [ocx](https://github.com/kdcokenny/ocx)                                                    | مدير امتدادات OpenCode مع ملفات تعريف محمولة ومعزولة.                     |
+| [CodeNomad](https://github.com/NeuralNomadsAI/CodeNomad)                                   | تطبيق عميل لسطح المكتب والويب والجوال وعن بعد لـ OpenCode                 |
+
+---
+
+## الوكلاء
+
+| الاسم                                                             | الوصف                                            |
+| ----------------------------------------------------------------- | ------------------------------------------------ |
+| [Agentic](https://github.com/Cluster444/agentic)                  | وكلاء ذكاء اصطناعي وأوامر معيارية للتطوير المنظم |
+| [opencode-agents](https://github.com/darrenhinde/opencode-agents) | تكوينات، ومطالبات، ووكلاء، وإضافات لسير عمل محسن |

package/src/content/docs/ar/enterprise.mdx

@@ -0,0 +1,165 @@
+---
+title: المؤسسات
+description: استخدام OpenCode بأمان داخل مؤسستك.
+---
+
+import config from "../../../../config.mjs"
+export const email = `mailto:${config.email}`
+
+OpenCode Enterprise مخصص للمؤسسات التي تريد التأكد من أن الشيفرة والبيانات لا تغادر بنيتها التحتية مطلقا. ويمكن تحقيق ذلك عبر استخدام إعدادات مركزية تتكامل مع SSO وبوابة AI الداخلية لديك.
+
+:::note
+لا يقوم OpenCode بتخزين أي من شيفرتك أو بيانات السياق.
+:::
+
+لبدء استخدام OpenCode Enterprise:
+
+1. أجرِ تجربة داخلية مع فريقك.
+2. **<a href={email}>اتصل بنا</a>** لمناقشة التسعير وخيارات التنفيذ.
+
+---
+
+## تجربة
+
+OpenCode مفتوح المصدر ولا يخزن أي من شيفرتك أو بيانات السياق، لذا يمكن للمطورين لديك ببساطة [البدء](/docs/) وإجراء تجربة.
+
+---
+
+### التعامل مع البيانات
+
+**لا يقوم OpenCode بتخزين شيفرتك أو بيانات السياق.** تتم جميع المعالجة محليا أو عبر استدعاءات API مباشرة إلى مزود AI لديك.
+
+وهذا يعني أنه طالما أنك تستخدم مزودا تثق به، أو بوابة AI داخلية، يمكنك استخدام OpenCode بأمان.
+
+الاستثناء الوحيد هنا هو ميزة `/share` الاختيارية.
+
+---
+
+#### مشاركة المحادثات
+
+إذا فعّل المستخدم ميزة `/share`، فسيتم إرسال المحادثة والبيانات المرتبطة بها إلى الخدمة التي نستخدمها لاستضافة صفحات المشاركة هذه على opencode.ai.
+
+يتم تقديم البيانات حاليا عبر شبكة الحافة الخاصة بـ CDN لدينا، وتُخزّن مؤقتا على الحافة بالقرب من مستخدميك.
+
+نوصي بتعطيل ذلك أثناء التجربة.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "disabled"
+}
+```
+
+[تعرّف على المزيد حول المشاركة](/docs/share).
+
+---
+
+### ملكية الشيفرة
+
+**أنت تملك كل الشيفرة التي ينتجها OpenCode.** لا توجد قيود ترخيص أو مطالبات بالملكية.
+
+---
+
+## التسعير
+
+نستخدم نموذج تسعير لكل مقعد في OpenCode Enterprise. إذا كانت لديك بوابة LLM خاصة بك، فلن نفرض رسوما على الرموز (tokens) المستخدمة. لمزيد من التفاصيل حول التسعير وخيارات التنفيذ، **<a href={email}>اتصل بنا</a>**.
+
+---
+
+## النشر
+
+بعد إكمال التجربة وعندما تكون جاهزا لاستخدام OpenCode داخل مؤسستك، يمكنك **<a href={email}>الاتصال بنا</a>** لمناقشة التسعير وخيارات التنفيذ.
+
+---
+
+### الإعدادات المركزية
+
+يمكننا إعداد OpenCode لاستخدام إعدادات مركزية واحدة لكامل مؤسستك.
+
+يمكن لهذه الإعدادات المركزية أن تتكامل مع مزود SSO لديك، وتضمن أن جميع المستخدمين يصلون فقط إلى بوابة AI الداخلية لديك.
+
+---
+
+### تكامل SSO
+
+عبر الإعدادات المركزية، يمكن لـ OpenCode التكامل مع مزود SSO في مؤسستك لأغراض المصادقة.
+
+يتيح ذلك لـ OpenCode الحصول على بيانات الاعتماد لبوابة AI الداخلية لديك عبر نظام إدارة الهوية الحالي لديك.
+
+---
+
+### بوابة AI الداخلية
+
+مع الإعدادات المركزية، يمكن أيضا تهيئة OpenCode لاستخدام بوابة AI الداخلية لديك فقط.
+
+يمكنك أيضا تعطيل جميع مزودي AI الآخرين، لضمان مرور جميع الطلبات عبر البنية التحتية المعتمدة في مؤسستك.
+
+---
+
+### الاستضافة الذاتية
+
+بينما نوصي بتعطيل صفحات المشاركة لضمان ألا تغادر بياناتك مؤسستك مطلقا، يمكننا أيضا مساعدتك على استضافتها ذاتيا على بنيتك التحتية.
+
+هذا موجود حاليا على خارطة طريقنا. إذا كنت مهتما، **<a href={email}>أخبرنا</a>**.
+
+---
+
+## الأسئلة الشائعة
+
+<details>
+<summary>ما هو OpenCode Enterprise؟</summary>
+
+OpenCode Enterprise مخصص للمؤسسات التي تريد التأكد من أن الشيفرة والبيانات لا تغادر بنيتها التحتية مطلقا. ويمكن تحقيق ذلك عبر استخدام إعدادات مركزية تتكامل مع SSO وبوابة AI الداخلية لديك.
+
+</details>
+
+<details>
+<summary>كيف أبدأ باستخدام OpenCode Enterprise؟</summary>
+
+ابدأ ببساطة بتجربة داخلية مع فريقك. لا يقوم OpenCode افتراضيا بتخزين شيفرتك أو بيانات السياق، مما يجعل البدء سهلا.
+
+ثم **<a href={email}>اتصل بنا</a>** لمناقشة التسعير وخيارات التنفيذ.
+
+</details>
+
+<details>
+<summary>كيف يعمل تسعير المؤسسات؟</summary>
+
+نقدم تسعيرا للمؤسسات لكل مقعد. إذا كانت لديك بوابة LLM خاصة بك، فلن نفرض رسوما على الرموز (tokens) المستخدمة. لمزيد من التفاصيل، **<a href={email}>اتصل بنا</a>** للحصول على عرض سعر مخصص بناء على احتياجات مؤسستك.
+
+</details>
+
+<details>
+<summary>هل بياناتي آمنة مع OpenCode Enterprise؟</summary>
+
+نعم. لا يقوم OpenCode بتخزين شيفرتك أو بيانات السياق. تتم جميع المعالجة محليا أو عبر استدعاءات API مباشرة إلى مزود AI لديك. ومع الإعدادات المركزية وتكامل SSO، تظل بياناتك آمنة داخل البنية التحتية لمؤسستك.
+
+</details>
+
+<details>
+<summary>هل يمكننا استخدام سجل NPM خاص بنا؟</summary>
+
+يدعم OpenCode سجلات npm الخاصة عبر دعم Bun الأصلي لملف `.npmrc`. إذا كانت مؤسستك تستخدم سجلا خاصا مثل JFrog Artifactory أو Nexus أو ما شابه ذلك، فتأكد من مصادقة المطورين قبل تشغيل OpenCode.
+
+لإعداد المصادقة مع السجل الخاص بك:
+
+```bash
+npm login --registry=https://your-company.jfrog.io/api/npm/npm-virtual/
+```
+
+سيؤدي ذلك إلى إنشاء `~/.npmrc` مع تفاصيل المصادقة. سيلتقط OpenCode هذا تلقائيا.
+
+:::caution
+يجب أن تكون مسجلا الدخول إلى السجل الخاص قبل تشغيل OpenCode.
+:::
+
+بدلا من ذلك، يمكنك تهيئة ملف `.npmrc` يدويا:
+
+```bash title="~/.npmrc"
+registry=https://your-company.jfrog.io/api/npm/npm-virtual/
+//your-company.jfrog.io/api/npm/npm-virtual/:_authToken=${NPM_AUTH_TOKEN}
+```
+
+يجب أن يكون المطورون مسجلين الدخول إلى السجل الخاص قبل تشغيل OpenCode لضمان إمكانية تثبيت الحزم من سجل مؤسستك.
+
+</details>

package/src/content/docs/ar/formatters.mdx

@@ -0,0 +1,131 @@
+---
+title: المُنسِّقات
+description: يستخدم OpenCode مُنسِّقات خاصة بكل لغة.
+---
+
+يُنسِّق OpenCode الملفات تلقائيا بعد كتابتها أو تعديلها باستخدام مُنسِّقات خاصة بكل لغة. يضمن ذلك أن الشيفرة التي يتم توليدها تتبع أساليب التنسيق المعتمدة في مشروعك.
+
+---
+
+## مُضمَّنة
+
+يأتي OpenCode مع عدة مُنسِّقات مُضمَّنة للغات وأطر العمل الشائعة. فيما يلي قائمة بالمُنسِّقات وامتدادات الملفات المدعومة والأوامر أو خيارات الإعداد التي تحتاجها.
+
+| المُنسِّق            | الامتدادات                                                                                               | المتطلبات                                                                               |
+| -------------------- | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
+| gofmt                | .go                                                                                                      | يتوفر أمر `gofmt`                                                                       |
+| mix                  | .ex, .exs, .eex, .heex, .leex, .neex, .sface                                                             | يتوفر أمر `mix`                                                                         |
+| prettier             | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml، و[غير ذلك](https://prettier.io/docs/en/index.html) | وجود اعتماد `prettier` في `package.json`                                                |
+| biome                | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml، و[غير ذلك](https://biomejs.dev/)                   | ملف إعداد `biome.json(c)`                                                               |
+| zig                  | .zig, .zon                                                                                               | يتوفر أمر `zig`                                                                         |
+| clang-format         | .c, .cpp, .h, .hpp, .ino، و[غير ذلك](https://clang.llvm.org/docs/ClangFormat.html)                       | ملف إعداد `.clang-format`                                                               |
+| ktlint               | .kt, .kts                                                                                                | يتوفر أمر `ktlint`                                                                      |
+| ruff                 | .py, .pyi                                                                                                | يتوفر أمر `ruff` مع إعداد                                                               |
+| rustfmt              | .rs                                                                                                      | يتوفر أمر `rustfmt`                                                                     |
+| cargofmt             | .rs                                                                                                      | يتوفر أمر `cargo fmt`                                                                   |
+| uv                   | .py, .pyi                                                                                                | يتوفر أمر `uv`                                                                          |
+| rubocop              | .rb, .rake, .gemspec, .ru                                                                                | يتوفر أمر `rubocop`                                                                     |
+| standardrb           | .rb, .rake, .gemspec, .ru                                                                                | يتوفر أمر `standardrb`                                                                  |
+| htmlbeautifier       | .erb, .html.erb                                                                                          | يتوفر أمر `htmlbeautifier`                                                              |
+| air                  | .R                                                                                                       | يتوفر أمر `air`                                                                         |
+| dart                 | .dart                                                                                                    | يتوفر أمر `dart`                                                                        |
+| dfmt                 | .d                                                                                                       | يتوفر أمر `dfmt`                                                                        |
+| ocamlformat          | .ml, .mli                                                                                                | يتوفر أمر `ocamlformat` وملف إعداد `.ocamlformat`                                       |
+| terraform            | .tf, .tfvars                                                                                             | يتوفر أمر `terraform`                                                                   |
+| gleam                | .gleam                                                                                                   | يتوفر أمر `gleam`                                                                       |
+| nixfmt               | .nix                                                                                                     | يتوفر أمر `nixfmt`                                                                      |
+| shfmt                | .sh, .bash                                                                                               | يتوفر أمر `shfmt`                                                                       |
+| pint                 | .php                                                                                                     | وجود اعتماد `laravel/pint` في `composer.json`                                           |
+| oxfmt (Experimental) | .js, .jsx, .ts, .tsx                                                                                     | وجود اعتماد `oxfmt` في `package.json` و[علم متغير بيئة تجريبي](/docs/cli/#experimental) |
+| ormolu               | .hs                                                                                                      | يتوفر أمر `ormolu`                                                                      |
+
+لذا إذا كان مشروعك يتضمن `prettier` ضمن `package.json`، فسيستخدمه OpenCode تلقائيا.
+
+---
+
+## كيف يعمل
+
+عندما يكتب OpenCode ملفا أو يحرره، فإنه:
+
+1. يتحقق من امتداد الملف مقابل جميع المُنسِّقات المفعّلة.
+2. يشغّل أمر المُنسِّق المناسب على الملف.
+3. يطبق تغييرات التنسيق تلقائيا.
+
+تتم هذه العملية في الخلفية لضمان الحفاظ على أساليب تنسيق الشيفرة دون أي خطوات يدوية.
+
+---
+
+## الإعداد
+
+يمكنك تخصيص المُنسِّقات عبر قسم `formatter` في إعدادات OpenCode.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": {}
+}
+```
+
+يدعم إعداد كل مُنسِّق ما يلي:
+
+| الخاصية       | النوع    | الوصف                                                  |
+| ------------- | -------- | ------------------------------------------------------ |
+| `disabled`    | boolean  | اضبطها على `true` لتعطيل المُنسِّق                     |
+| `command`     | string[] | الأمر الذي سيتم تشغيله للتنسيق                         |
+| `environment` | object   | متغيرات البيئة التي يتم ضبطها عند تشغيل المُنسِّق      |
+| `extensions`  | string[] | امتدادات الملفات التي يجب أن يتعامل معها هذا المُنسِّق |
+
+لنلقِ نظرة على بعض الأمثلة.
+
+---
+
+### تعطيل المُنسِّقات
+
+لتعطيل **جميع** المُنسِّقات على مستوى عام، اضبط `formatter` على `false`:
+
+```json title="opencode.json" {3}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": false
+}
+```
+
+لتعطيل مُنسِّق **محدد**، اضبط `disabled` على `true`:
+
+```json title="opencode.json" {5}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": {
+    "prettier": {
+      "disabled": true
+    }
+  }
+}
+```
+
+---
+
+### مُنسِّقات مخصّصة
+
+يمكنك تجاوز المُنسِّقات المُضمَّنة أو إضافة مُنسِّقات جديدة عبر تحديد الأمر ومتغيرات البيئة وامتدادات الملفات:
+
+```json title="opencode.json" {4-14}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": {
+    "prettier": {
+      "command": ["npx", "prettier", "--write", "$FILE"],
+      "environment": {
+        "NODE_ENV": "development"
+      },
+      "extensions": [".js", ".ts", ".jsx", ".tsx"]
+    },
+    "custom-markdown-formatter": {
+      "command": ["deno", "fmt", "$FILE"],
+      "extensions": [".md"]
+    }
+  }
+}
+```
+
+سيتم استبدال **العنصر النائب `$FILE`** في الأمر بمسار الملف الذي يجري تنسيقه.