نظرة عامّة على الطبقات
ماذا ستتعلّم: الطبقات الكبرى للغة ص ومسؤوليّة كلٍّ منها والحدود بينها.
المكوّنات
| المكوّن | المجلد | الدور |
|---|---|---|
| النواة المشتركة | shared/ | معجمي، نحوي، AST، نظام الأنواع Value، نظام الأخطاء |
| المفسّر | interpreter/ | مفسّر شجريّ؛ InterpreterCore يدير المتغيّرات والدوال والنطاقات والتقييم |
| المترجم | compiler/ | AST → SIR → LLVM IR → ملفّ تنفيذيّ (SIR يدعم تعليمات ملكية) |
| الخلفيّة الأصليّة | compiler/include/backend/native/ | SIR → شيفرة آلة → ELF64 ساكن بلا LLVM ولا رابطٍ أجنبيّ — الفصل |
| — | vm/ أُزيل من الشجرة بالإيداع bcf0a746 («ستُعاد كتابتها من الصفر») — لا فصل له حتّى تُكتب | |
| المكتبة القياسية | stdlib/ | ثماني وحدات .ص عربيّة في الجذر + سبعةَ عشرَ مجلّدَ دعمٍ C++ — التعدادُ في خريطة المستودع |
| الرسومات | features/graphics/ | SadUI: محرّك التخطيط ومفاتيح الخصائص — ليست في stdlib/ — الفصل |
| الأدوات | tools/ | ١٥ مجلّدًا على dev؛ منها compiler (واجهة sad-build) وhub (موزِّع sad) — التعدادُ في خريطة المستودع |
| مصدر الحقيقة | language-truth/ | YAML SoT لكل بيانات اللغة + القواعد |
القاعدة الطبقيّة (CW-02)
الترتيب صارم: Lexer → Parser → AST → SIR → LLVM. كل طبقة تعتمد فقط على
الطبقة التي تحتها. يُمنع الاعتماد العكسيّ أو القفز بين الطبقات. هذا يضمن:
- عزل الأخطاء: خطأ معجميّ يُصلَح في المعجمي، خطأ ترتيب حقول في
SIRBuilder، إلخ (BF-10). - قابليّة الاستبدال: يمكن تغيير الواجهة الخلفيّة (مفسّر/مترجم) دون مسّ الأماميّة.
مخطّط الطبقات
flowchart TD SRC["مصدر .ص (UTF-8)"] --> LEX["LexerCore<br/>shared/lexer"] LEX --> PAR["ParserCore<br/>shared/parser"] PAR --> AST["AST<br/>shared/ast"] AST --> INT["InterpreterCore<br/>(تنفيذ فوريّ)"] AST --> SIR["SIRBuilder<br/>compiler/src/frontend"] SIR --> OPT["SIROptimizer"] OPT --> LLVM["LLVMCodeGen<br/>compiler/src/backend/llvm"] LLVM --> EXE["ملفّ تنفيذيّ أصليّ"] SOT["language-truth/ (SoT)"] -. "توليد" .-> LEX SOT -. "توليد" .-> PAR SOT -. "توليد" .-> ERR["نظام الأخطاء"]
مبدأان عابران للطبقات
- مصدر الحقيقة أولًا: أي بيان لغويّ (كلمة/عامل/نوع/خطأ/دالة مضمنة) يبدأ من
language-truth/ثم يُولَّد. راجع الجزء الثالث. - التنفيذ المزدوج: كل ميزة تعمل في المفسّر والمترجم؛ إن عملت في أحدهما فقط فالمشكلة في SIR/LLVM (BF-08).
اقرأ بعده: خطّ الأنابيب.