مقدّمة

لغة ص (Sad) لغة برمجة عربيّة حديثة، أغراضها عامّة، مكتوبة بـ C++17، وملفّات مصدرها بامتداد .ص. صُمِّمت لتكون عربيّةً في صميمها — كلماتها المفتاحيّة ورموزها ورسائل أخطائها بالعربية — مع دعم كامل لـ UTF-8 يسمح بمزج العربية والإنجليزية في الأسماء والنصوص.

تأتي اللغة بمنظومة تنفيذ متكاملة:

• مفسّر شجريّ (sad-run) لتشغيل البرامج مباشرةً.
• مترجم (sad-build) يحوّل المصدر عبر LLVM إلى تنفيذيّ أصليّ.
• خادم LSP، مدير حِزَم، فاحص ساكن، ومنسّق — راجع فصل الأدوات.

ملاحظة قناة: كانت المنظومة تضمّ أيضًا آلة بايت كود (VM) — ما تزال في الإصدار المستقرّ، وأُزيلت في القناة القادمة لإعادة بنائها على أساس أمتن؛ المحرّكان المعتمَدان هما المفسّر والمترجم.

ماذا يغطّي هذا التوثيق؟

هذا الكتاب هو المرجع التقنيّ الموجَّه لمن يكتب برامج بلغة ص. يأخذك من أوّل برنامج حتى الميزات المتقدّمة، ثم يقدّم مرجعًا دقيقًا للنحو والكلمات والأنواع والعوامل.

لمحة سريعة

# أوّل برنامج بلغة ص
دالة رئيسية()
    اطبع("أهلًا يا عالم")
نهاية

أبرز ملامح النحو (التفصيل في المرجع):

• 40 كلمة محجوزة فقط + 3 عوامل منطقيّة تُلفظ كلمات: و، أو، ليس.
• الكتل تُفتَح بكلمتها (دالة، إذا، بينما…) وتُغلَق دائمًا بـنهاية.
• الفاصلة ، و, متكافئتان، وكذلك المنقوطة ؛ و;.
• التعليقات: سطريّ #، كتليّ #* ... *#، توثيقيّ ##.
• أسماء الأنواع (رقم، نص، عشري…) ليست محجوزة — يمكن استعمالها أسماءً خارج سياق النوع.

مصدر الحقيقة

الحقيقة الرسمية لكلّ قاعدة وكلمة ونوع تعيش في language-truth/ داخل المستودع الأساسيّ. هذا الكتاب يَعرِض تلك الحقيقة بصورة مقروءة ولا يخترع غيرها؛ عند أيّ تعارض فـlanguage-truth/ هو الفيصل. راجع مصدر الحقيقة الموحّد.