@kerkacem/pi-arabic-rtl

إضافة لمساعد التطوير Pi Coding Agent تسمح بعرض اللغة العربية والاتجاه من اليمين إلى اليسار (RTL) بشكل بصري دقيق على الطرفيات التي تفتقر لدعم BiDi.

Packages

Package details

extension

Install @kerkacem/pi-arabic-rtl from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@kerkacem/pi-arabic-rtl

Package: @kerkacem/pi-arabic-rtl
Version: 1.0.0
Published: Aug 6, 2026
Downloads: 91/mo · 8/wk
Author: kerkacem
License: MIT
Types: extension
Size: 9.7 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./arabic-rtl.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

🇩🇿 إضافة Pi Arabic RTL (معالجة عرض اللغة العربية والـ RTL في الطرفية)

اسم الحزمة على NPM: @kerkacem/pi-arabic-rtl
الإصدار الحالية: v1.0.0
المطور والناشر: Kerbani Belkacem DZ 🇩🇿
الترخيص: MIT License
المعرض الرسمي: pi.dev/packages

📌 نبذة عن الإضافة

إضافة مخصصة ومحترفة لـ Pi Coding Agent لحل مشكلة عدم دعم معالجة النصوص ثنائية الاتجاه (BiDi Support) وتنسيق الخطوط في محطات الطرفية (Terminals) المختلفة.

تسمح الإضافة بعرض اللغة العربية والاتجاه من اليمين إلى اليسار (RTL) بشكل بصري واضح ومقروء للمستخدمين بدون الحاجة لتغيير إعدادات الطرفية أو إعدادات النظام.

✨ المميزات الرئيسية (Features)

🎨 تعديل بصري 100% (Visual-Only Rendering): لا تقوم الإضافة بتغيير أو تحريف النص الأصلي المُرسل للنموذج الذكي (LLM) أو النص المحفوظ في سجل الجلسة (Session History)، مما يضمن عدم تأثير العرض البصري على الكود أو التعليمات.
🔄 معالجة اتجاه الأحرف والكلمات (RTL Characters & Word Runs): تعكس السلسلة البصرية لأحرف وكلمات الجمل العربية لتعرض من اليمين إلى اليسار بصرياً على طرفيات LTR.
📐 محاذاة يمين تلقائية (Right-Alignment): يتم محاذاة السطور التي تحتوي على كلمات عربية جهة اليمين في محرر الإدخال وشاشة المحادثة بحسب عرض الطرفية المتاح (availableWidth).
⚡ حماية أوامر السلاش والإنجليزية: يتم الحفاظ التام على السطور الإنجليزية، الكود البرمجي، وأوامر السلاش (/...) بنمط LTR الافتراضي دون مساس.
🖥️ تغطية شاملة للمكونات:
- محرر الإدخال التفاعلي (Input Editor Component).
- رسائل المستخدم المُرسلة (User Messages).
- مخرجات واستجابات المساعد الذكي (Assistant Responses & Markdown).

📁 هيكلية الحزمة (Package Structure)

pi-arabic-rtl-extension/
├── arabic-rtl.ts     # الكود البرمجي الأساسي للإضافة
├── package.json      # ملف تعريف الحزمة ووسوم pi-package
├── README.md         # الشرح والدليل التفصيلي الكامل
├── LICENSE           # ترخيص MIT مفتوح المصدر
└── .npmignore        # استثناء الملفات غير المطلوبة عند النشر على NPM

🚀 طريقة التثبيت والاستخدام

1️⃣ التثبيت عبر NPM (من المعرض الرسمي)

pi install npm:@kerkacem/pi-arabic-rtl

2️⃣ التثبيت عبر Git (GitHub)

pi install git:github.com/kerkacem/pi-arabic-rtl

3️⃣ التثبيت العام المحلي (Global Local)

نسخ ملف arabic-rtl.ts إلى مجلد الإضافات العام:

Windows: C:\Users\<USERNAME>\.pi\agent\extensions\arabic-rtl.ts
Linux/macOS: ~/.pi/agent/extensions/arabic-rtl.ts

4️⃣ التجربة السريعة (Temporary Test)

pi -e ./arabic-rtl.ts

📜 سجل الإصدارات (Changelog)

`v1.0.0` - 2026-04-06

🎉 الإصدار الأول للعموم.
✅ دعم كامل لمعالجة اتجاه الأحرف والكلمات العربية.
✅ المحاذاة لليمين التلقائية بحسب عرض محطة الطرفية.
✅ الحفاظ التام على سلامة النصوص البرمجية وأوامر السلاش.
✅ دعم الشاشات والمكونات التفاعلية ومحرر الإدخال.