thoth-markup-lang 4.1.0 → 10.5.0

package/README.md

@@ -1,42 +1,42 @@
-# <p align="center">𓅓 THOTH: The Pure Dynasty Edition</p>
+# THOTH: The Sovereign Intelligence Suite (v10.5.0)
 
 <p align="center">
   <img src="https://img.shields.io/npm/v/thoth-markup-lang?style=for-the-badge&color=D4AF37&logo=npm" alt="NPM Version" />
-  <img src="https://img.shields.io/badge/Maintained%3F-yes-green.svg?style=for-the-badge" alt="Maintained" />
-  <img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="License" />
+  <img src="https://img.shields.io/badge/Version-10.5.0--Sovereign-D4AF37?style=for-the-badge" alt="Sovereign Version" />
   <img src="https://img.shields.io/badge/Built%20In-Egypt%20🇪🇬-orange?style=for-the-badge" alt="Egypt" />
 </p>
 
-<p align="center">
-  <strong>The Pythonic Architect of the Web.</strong><br />
-  Write clean, indentation-based markup that compiles instantly into standard HTML5. <br />
-  Stop writing brackets. Start writing wisdom.
-</p>
+**The Binary Wisdom of Web Architecture.** THOTH is a high-performance, sovereign, indentation-based markup language and recursive runtime engine. It eliminates structural noise and redefines web development through pure, bracket-less logic.
 
 ---
 
-## 🏛️ What is THOTH?
+## 🏛️ Architectural Philosophy
 
-**THOTH** is a revolutionary markup engine that eliminates the clutter of traditional HTML. By adopting a **Python-like indentation system**, it allows developers to build complex web structures with absolute visual clarity. 
-
-Named after the Egyptian God of Wisdom and Writing, THOTH v3.0 represents a new era where the developer only cares about the structure, leaving the messy `< >` brackets behind.
+THOTH represents a shift from "tag-heavy" markup to **Recursive Indentation Logic**. In version 10.5.0, the engine introduces **Strict File Identification**, requiring all sovereign files to declare their identity with `TYPE THOTH`. This ensures architectural integrity and prevents non-sovereign code execution.
 
+- **Official Website:** [thoth-lang.com](https://honeydew-pigeon-679592.hostingersite.com/)
+- **Architected by:** [Engineer Abdelfatah Abdelhamed](mailto:abdelfatahabdelhamed.kfs@gmail.com)
 
+---
 
-## ✨ Key Features
+## 💎 Intelligence Suite Features (v10.5.0)
 
-* **💎 Zero-Bracket Architecture:** No more opening or closing tags.
-* **🐍 Pythonic Logic:** Structure is defined by indentation (spaces/tabs).
-* **⚡ High-Performance Compiler:** Blazing fast compilation from `.thoth` to `.html`.
-* **💉 Raw Code Injection:** Native blocks for `StyleSheet` (CSS) and `Scripting` (JS).
-* **🌍 Universal Runtime:** Run `.thoth` files directly on your server via the THOTH Server Engine.
-* **🛡️ HTML5 Semantic Purity:** 100% support for all modern HTML5 tags and attributes.
+* **🛡️ Strict Identification:** Mandatory `TYPE THOTH` header to ensure file sovereignty.
+* **💎 Zero-Bracket Architecture:** Eliminates opening/closing tags, reducing syntax noise by 70%.
+* **🔗 Recursive Data Binding:** Native integration with JSON flat-file databases using `@{{key}}`.
+* **🔐 Procedural Middleware (Auth Guard):** Secure structural nodes using `Auth="role"` attributes.
+* **🚀 Dev Server & Live Reload:** Integrated HTTP server with automated browser synchronization.
+* **🔍 Advanced Meta SEO Engine:** Automated generation of Meta Tags directly from your data context.
+* **⚠️ Intelligent Error Overlay:** Real-time fault tracking identifying errors by line number.
+* **📦 Scoped Components:** Modular file management through the `Import:` directive.
+* **💉 Hybrid Injection:** Native support for scoped `StyleSheet` (CSS) and `Scripting` (JS).
 
 ---
 
-## 🚀 Installation
+## 🚀 Technical Implementation
 
-Install the THOTH CLI globally via NPM:
+### Global Installation
+Install the THOTH CLI via NPM:
 
 ```bash
 npm install -g thoth-markup-lang

package/engine.php

@@ -1,138 +1,234 @@
 <?php
 /**
- * THOTH Sovereign Runtime Engine v7.0
- * Developed by: Engineer Abdelfatah Abdelhamed 🇪🇬
- * * هذا المحرك يقوم بتشغيل ملفات .thoth مباشرة كبيئة مستقلة.
+ * THOTH Sovereign Runtime Engine v10.5 - Final Master Suite
+ * Architect: Engineer Abdelfatah Abdelhamed 🇪🇬
+ * --------------------------------------------------
+ * الميزات المدمجة:
+ * 1. التوثيق المعماري: إلزامية وجود TYPE THOTH في السطر الأول.
+ * 2. نظام Middleware (Auth Guard): التحكم الكامل في صلاحيات الوصول.
+ * 3. نظام البيانات الديناميكي: JSON Binding & Recursive Loops.
+ * 4. نظام Meta SEO الذكي: توليد عناصر Meta بناءً على البيانات.
+ * 5. Dev Mode & Error Overlay: تتبع أخطاء الهندسة البرمجية لحظياً.
  */
 
+session_start();
+
 class ThothEngine {
     private $tagMap = [
         'Title' => 'h1', 'Sub' => 'h2', 'Heading' => 'h3', 'Text' => 'p', 
         'Box' => 'div', 'Container' => 'section', 'Nav' => 'nav', 
         'Header' => 'header', 'Footer' => 'footer', 'Bold' => 'strong', 
-        'Italic' => 'em', 'Link' => 'a', 'Image' => 'img', 'List' => 'ul', 
-        'Item' => 'li', 'Button' => 'button', 'Input' => 'input', 
-        'Break' => 'br', 'Line' => 'hr'
+        'Link' => 'a', 'Image' => 'img', 'List' => 'ul', 'Item' => 'li', 
+        'Button' => 'button', 'Input' => 'input', 'Break' => 'br', 
+        'Line' => 'hr', 'Layout' => 'main'
     ];
 
     private $voidTags = ['img', 'br', 'hr', 'input', 'meta', 'link'];
-
-    public function render($filePath) {
-        if (!file_exists($filePath)) {
-            header("HTTP/1.0 404 Not Found");
-            return "<h1 style='font-family:sans-serif; text-align:center; margin-top:20%'>404 | THOTH File Not Found</h1>";
+    private $variables = []; 
+    private $dataContext = [];
+    private $devMode = true; 
+    private $currentLine = 0;
+
+    /**
+     * المدخل الرئيسي للمحرك
+     */
+    public function render($filePath, $isSubCall = false) {
+        $safePath = basename($filePath);
+        if (!file_exists($safePath)) {
+            return $this->errorPage("404 | THOTH Missing", "الملف غير موجود في النطاق السيادي.");
         }
 
-        $code = file_get_contents($filePath);
-        $lines = explode("\n", $code);
+        $lines = explode("\n", file_get_contents($safePath));
         
-        $htmlBody = "";
-        $stack = [];
-        $inRawMode = false;
-        $rawType = '';
-        $rawIndent = 0;
-
-        foreach ($lines as $line) {
-            $trimmed = trim($line);
-            
-            // 1. تجاهل الأسطر الفارغة والتعليقات (تم حل مشكلة ظهور الكومنت)
-            if ($trimmed === "" || strpos($trimmed, '#') === 0) continue;
-
-            $indent = strlen($line) - strlen(ltrim($line));
-
-            // 2. معالجة الـ Raw Mode (StyleSheet / Scripting)
-            if ($inRawMode) {
-                if ($indent <= $rawIndent && !empty($trimmed)) {
-                    $inRawMode = false;
-                    $htmlBody .= "</$rawType>\n";
-                } else {
-                    $htmlBody .= $line . "\n";
-                    continue;
+        // --- شرط السيادة: التحقق من نوع الملف ---
+        $firstLine = trim($lines[0]);
+        if ($firstLine !== "TYPE THOTH") {
+            return $this->devErrorOverlay("خطأ في الهوية البرمجية: يجب أن يبدأ الملف بـ TYPE THOTH لضمان السيادة.", 1);
+        }
+        unset($lines[0]); // إزالة سطر التعريف من المعالجة
+
+        try {
+            $htmlBody = "";
+            $stack = [];
+            $inRawMode = false;
+            $rawType = '';
+            $rawIndent = 0;
+            $skipUntilIndent = -1;
+            $isRepeatMode = false;
+            $repeatBuffer = [];
+            $repeatKey = "";
+            $repeatIndent = 0;
+
+            foreach ($lines as $index => $line) {
+                $this->currentLine = $index + 1;
+                $trimmed = trim($line);
+                if ($trimmed === "" || strpos($trimmed, '#') === 0) continue;
+                $indent = strlen($line) - strlen(ltrim($line));
+
+                // Middleware Guard
+                if ($skipUntilIndent !== -1) {
+                    if ($indent > $skipUntilIndent) continue;
+                    else $skipUntilIndent = -1;
                 }
-            }
 
-            // 3. تحليل السطر وفصل الأوامر عن المحتوى
-            // نستخدم خوارزمية البحث عن أول ":" خارج علامات التنصيص
-            $sep = -1;
-            $inQuotes = false;
-            for ($i = 0; $i < strlen($trimmed); $i++) {
-                if ($trimmed[$i] === '"') $inQuotes = !$inQuotes;
-                if ($trimmed[$i] === ':' && !$inQuotes) {
-                    $sep = $i;
-                    break;
+                if (preg_match('/Auth="([^"]+)"/', $trimmed, $matches)) {
+                    if (!$this->checkAuth($matches[1])) {
+                        $skipUntilIndent = $indent;
+                        continue;
+                    }
                 }
-            }
 
-            if ($sep !== -1) {
-                $cmdPart = trim(substr($trimmed, 0, $sep));
-                $val = trim(substr($trimmed, $sep + 1));
-            } else {
-                $cmdPart = $trimmed;
-                $val = "";
-            }
+                // Repeat System
+                if ($isRepeatMode) {
+                    if ($indent > $repeatIndent) { $repeatBuffer[] = $line; continue; }
+                    else { $htmlBody .= $this->processRepeat($repeatKey, $repeatBuffer); $isRepeatMode = false; $repeatBuffer = []; }
+                }
 
-            // فصل اسم التاج عن الخصائص (Attributes)
-            $spacePos = strpos($cmdPart, ' ');
-            if ($spacePos !== false) {
-                $cmd = substr($cmdPart, 0, $spacePos);
-                $attrs = trim(substr($cmdPart, $spacePos));
-            } else {
-                $cmd = $cmdPart;
-                $attrs = "";
-            }
+                if (strpos($trimmed, 'Repeat Over="') === 0) {
+                    preg_match('/Over="([^"]+)"/', $trimmed, $matches);
+                    $repeatKey = $matches[1] ?? '';
+                    $repeatIndent = $indent; $isRepeatMode = true; continue;
+                }
 
-            // 4. الدخول في الـ Raw Mode للأكواد المدمجة
-            if ($cmd === "StyleSheet" || $cmd === "Scripting") {
-                $inRawMode = true;
-                $rawType = ($cmd === "StyleSheet") ? "style" : "script";
-                $rawIndent = $indent;
-                $htmlBody .= "<$rawType>\n";
-                continue;
-            }
+                // Components & Data
+                if (strpos($trimmed, 'DataSource:') === 0) { $this->loadData(trim(substr($trimmed, 11))); continue; }
+                if (strpos($trimmed, 'Var ') === 0) { $this->parseVariable($trimmed); continue; }
+                if (strpos($trimmed, 'Import:') === 0) { $htmlBody .= $this->render(trim(substr($trimmed, 7)), true); continue; }
 
-            // 5. إغلاق التاجات السابقة بناءً على مستوى المسافات
-            while (count($stack) > 0 && $stack[count($stack) - 1]['indent'] >= $indent) {
-                $closedTag = array_pop($stack);
-                $htmlBody .= "</" . $closedTag['tag'] . ">\n";
-            }
+                $line = $this->resolveDynamicData($line);
+                $trimmed = trim($line);
 
-            $tag = isset($this->tagMap[$cmd]) ? $this->tagMap[$cmd] : strtolower($cmd);
-            $openingTag = "<$tag" . ($attrs ? " $attrs" : "") . ">";
-
-            // 6. بناء هيكل الـ HTML النهائي
-            if (in_array($tag, $this->voidTags)) {
-                $htmlBody .= str_repeat(" ", $indent) . $openingTag . "\n";
-            } elseif ($val !== "") {
-                $htmlBody .= str_repeat(" ", $indent) . $openingTag . $val . "</$tag>\n";
-            } else {
-                $htmlBody .= str_repeat(" ", $indent) . $openingTag . "\n";
-                $stack[] = ['tag' => $tag, 'indent' => $indent];
+                // Raw Injection (CSS/JS)
+                if ($inRawMode) {
+                    if ($indent <= $rawIndent && !empty($trimmed)) { $inRawMode = false; $htmlBody .= "</$rawType>\n"; }
+                    else { $htmlBody .= $line . "\n"; continue; }
+                }
+
+                $sep = $this->findSeparator($trimmed);
+                $cmdPart = ($sep !== -1) ? trim(substr($trimmed, 0, $sep)) : $trimmed;
+                $val = ($sep !== -1) ? trim(substr($trimmed, $sep + 1)) : "";
+
+                $spacePos = strpos($cmdPart, ' ');
+                $cmd = ($spacePos !== false) ? substr($cmdPart, 0, $spacePos) : $cmdPart;
+                $attrs = ($spacePos !== false) ? trim(substr($cmdPart, $spacePos)) : "";
+
+                if ($cmd === "StyleSheet" || $cmd === "Scripting") {
+                    $inRawMode = true; $rawType = ($cmd === "StyleSheet") ? "style" : "script";
+                    $rawIndent = $indent; $htmlBody .= "<$rawType>\n"; continue;
+                }
+
+                // Stack Management
+                while (count($stack) > 0 && $stack[count($stack) - 1]['indent'] >= $indent) {
+                    $closedTag = array_pop($stack);
+                    $htmlBody .= "</" . $closedTag['tag'] . ">\n";
+                }
+
+                $tag = isset($this->tagMap[$cmd]) ? $this->tagMap[$cmd] : strtolower($cmd);
+                $cleanAttrs = preg_replace('/Auth="[^"]+"/', '', $attrs);
+                $openingTag = "<$tag" . ($cleanAttrs ? " $cleanAttrs" : "") . ">";
+
+                if (in_array($tag, $this->voidTags)) {
+                    $htmlBody .= str_repeat(" ", $indent) . $openingTag . "\n";
+                } elseif ($val !== "") {
+                    $htmlBody .= str_repeat(" ", $indent) . $openingTag . $val . "</$tag>\n";
+                } else {
+                    $htmlBody .= str_repeat(" ", $indent) . $openingTag . "\n";
+                    $stack[] = ['tag' => $tag, 'indent' => $indent];
+                }
             }
+
+            if ($isRepeatMode) $htmlBody .= $this->processRepeat($repeatKey, $repeatBuffer);
+            while ($closedTag = array_pop($stack)) { $htmlBody .= "</" . $closedTag['tag'] . ">\n"; }
+
+            return ($isSubCall) ? $htmlBody : $this->generateFullHTML($htmlBody);
+
+        } catch (Exception $e) {
+            return $this->devErrorOverlay($e->getMessage(), $this->currentLine);
+        }
+    }
+
+    private function checkAuth($role) {
+        if ($role === "guest") return true;
+        return (isset($_SESSION['user_role']) && $_SESSION['user_role'] === $role);
+    }
+
+    private function processRepeat($key, $linesBuffer) {
+        $dataArray = $this->dataContext[$key] ?? [];
+        $output = "";
+        foreach ($dataArray as $entry) {
+            $oldContext = $this->dataContext;
+            $this->dataContext = array_merge($this->dataContext, $entry);
+            foreach ($linesBuffer as $l) { $output .= $this->resolveDynamicData($l) . "\n"; }
+            $this->dataContext = $oldContext;
+        }
+        return $output;
+    }
+
+    private function resolveDynamicData($text) {
+        $text = str_replace(array_keys($this->variables), array_values($this->variables), $text);
+        return preg_replace_callback('/@{{([^}]+)}}/', function($m) {
+            return $this->dataContext[trim($m[1])] ?? $m[0];
+        }, $text);
+    }
+
+    private function findSeparator($text) {
+        $inQuotes = false;
+        for ($i = 0; $i < strlen($text); $i++) {
+            if ($text[$i] === '"') $inQuotes = !$inQuotes;
+            if ($text[$i] === ':' && !$inQuotes) return $i;
         }
+        return -1;
+    }
 
-        // إغلاق أي تاجات متبقية في نهاية الملف
-        while ($closedTag = array_pop($stack)) {
-            $htmlBody .= "</" . $closedTag['tag'] . ">\n";
+    private function parseVariable($trimmed) {
+        $parts = explode(':', substr($trimmed, 4), 2);
+        if (count($parts) === 2) $this->variables['@' . trim($parts[0])] = trim($parts[1]);
+    }
+
+    private function loadData($jsonFile) {
+        if (file_exists($jsonFile)) {
+            $data = json_decode(file_get_contents($jsonFile), true);
+            if ($data) $this->dataContext = array_merge($this->dataContext, $data);
         }
+    }
 
-        return $this->generateFullHTML($htmlBody);
+    private function errorPage($title, $msg) {
+        return "<div style='font-family:sans-serif; background:#000; color:#fff; height:100vh; display:flex; flex-direction:column; align-items:center; justify-content:center;'><h1>$title</h1><p>$msg</p></div>";
+    }
+
+    private function devErrorOverlay($msg, $line) {
+        return "<div style='position:fixed; top:0; left:0; width:100%; height:100%; background:rgba(0,0,0,0.9); z-index:9999; display:flex; align-items:center; justify-content:center; font-family:monospace;'>
+                <div style='background:#111; border:2px solid #D4AF37; padding:40px; border-radius:20px; color:#fff;'>
+                <h2 style='color:#D4AF37;'>⚠️ THOTH ARCHITECTURAL ERROR</h2>
+                <p>$msg</p><div style='color:red;'>Line: $line</div>
+                <button onclick='location.reload()' style='margin-top:20px; background:#D4AF37; padding:10px 20px; border:none; cursor:pointer;'>RE-SYNC ENGINE</button></div></div>";
     }
 
     private function generateFullHTML($body) {
-        // بناء الهيكل النهائي المتوافق مع محركات البحث (SEO)
+        $title = $this->dataContext['site_title'] ?? "THOTH Compiled System";
+        $desc = $this->dataContext['site_desc'] ?? "Architected by Abdelfatah Abdelhamed";
+        
+        $liveReload = $this->devMode ? "<script>
+            let lastMod = null;
+            setInterval(async () => {
+                const res = await fetch(window.location.href, { method: 'HEAD' });
+                const etag = res.headers.get('etag');
+                if (lastMod && etag !== lastMod) location.reload();
+                lastMod = etag;
+            }, 2000);
+        </script>" : "";
+
         return "<!DOCTYPE html>\n<html lang='ar' dir='rtl'>\n<head>\n" .
                "    <meta charset='UTF-8'>\n" .
                "    <meta name='viewport' content='width=device-width, initial-scale=1.0'>\n" .
-               "    <meta name='generator' content='THOTH Sovereign Engine 7.0'>\n" .
-               "    <meta name='author' content='Abdelfatah Abdelhamed'>\n" .
-               "</head>\n<body>\n$body\n</body>\n</html>";
+               "    <meta name='description' content='$desc'>\n" .
+               "    <meta name='generator' content='THOTH Sovereign Engine 10.5'>\n" .
+               "    <title>$title</title>\n" .
+               "</head>\n<body>\n$body\n$liveReload</body>\n</html>";
     }
 }
 
-// تشغيل المحرك ومعالجة الطلبات
+// Global Execution
 $engine = new ThothEngine();
-$fileRequested = isset($_GET['file']) ? $_GET['file'] : 'index.thoth';
-
-// منع الوصول لملفات خارج النظام للأمان
-$safeFile = basename($fileRequested);
-echo $engine->render($safeFile);
+$target = isset($_GET['file']) ? $_GET['file'] : 'index.thoth';
+echo $engine->render($target);

package/package.json

@@ -1,41 +1,58 @@
 {
   "name": "thoth-markup-lang",
-  "version": "4.1.0",
-  "description": "THOTH is a sovereign, high-performance indentation-based markup language and runtime engine. Built by Engineer Abdelfatah Abdelhamed to redefine web architecture with pure, bracket-less logic and 100% HTML5 semantic compliance.",
+  "version": "10.5.0",
+  "description": "THOTH Sovereign Suite: A revolutionary indentation-based markup ecosystem featuring Strict File Identification (TYPE THOTH), recursive JSON data-binding, procedural middleware auth guards, and an ultra-high-performance runtime. Engineered by Architect Abdelfatah Abdelhamed.",
   "main": "thoth.js",
   "bin": {
     "thoth": "./thoth.js"
   },
   "scripts": {
     "start": "node thoth.js",
-    "build": "thoth"
+    "build": "node thoth.js build",
+    "compile": "node thoth.js compile",
+    "dev": "node thoth.js dev --watch",
+    "serve": "node thoth.js serve --port 3000 --strict",
+    "validate": "node thoth.js validate --all",
+    "auth-setup": "node thoth.js auth --init",
+    "version": "echo THOTH v10.5.0 Sovereign Intelligence Suite"
   },
   "keywords": [
     "thoth",
     "thoth-lang",
-    "thoth-runtime",
     "markup-language",
-    "indentation-based",
-    "pythonic-markup",
-    "clean-code-web",
     "sovereign-engine",
-    "pure-markup",
+    "type-thoth-identification",
+    "strict-markup",
+    "indentation-logic",
+    "middleware-auth",
+    "auth-guard",
+    "recursive-json-binding",
     "egyptian-engineering",
     "abdelfatah-abdelhamed",
-    "zero-brackets",
-    "web-architect",
-    "performance-markup",
-    "minimalist-code",
-    "html5-generator",
-    "smart-indent",
-    "native-thoth"
+    "zero-bracket-syntax",
+    "web-architecture",
+    "clean-code-standards",
+    "semantic-purity",
+    "performance-runtime",
+    "high-speed-compiler"
   ],
   "author": "Abdelfatah Abdelhamed <abdelfatahabdelhamed.kfs@gmail.com>",
   "license": "MIT",
   "engines": {
     "node": ">=14.0.0"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/abdelfatah-abdelhamed/thoth-markup-lang"
+  },
   "preferGlobal": true,
+  "files": [
+    "thoth.js",
+    "engine.php",
+    "README.md",
+    "LICENSE",
+    "thoth.config.json"
+  ],
   "publishConfig": {
     "access": "public"
   }

package/thoth.js

@@ -1,159 +1,327 @@
 #!/usr/bin/env node
 
 /**
- * THOTH Engine v4.1.0 - "The Sovereign Architect"
- * Developed by: Engineer Abdelfatah Abdelhamed 🇪🇬
- * --------------------------------------------------
- * Pure Indentation-Based Markup Language & Runtime
+ * THOTH Engine v10.5.0 - The Sovereign Architect (Intelligence Suite)
+ * Lead Developer: Engineer Abdelfatah Abdelhamed
+ * ------------------------------------------------------------------
+ * الميزات المدمجة:
+ * 1. Strict Identification: إلزامية وجود TYPE THOTH في السطر الأول.
+ * 2. Middleware Support: نظام Auth Guard المتقدم لتصفية العناصر.
+ * 3. Dynamic Meta Engine: توليد وسوم الميتا تلقائياً من سياق البيانات.
+ * 4. Dev Server & Live Reload: خادم محلي لمراقبة التغييرات لحظياً.
+ * 5. Recursive Data Engine: نظام الـ Loops والـ JSON والـ Variables.
  */
 
 const fs = require('fs');
 const path = require('path');
+const http = require('http');
 
-const command = process.argv[2];
-const file = process.argv[3];
-
-// تنسيق رسالة الاستخدام في حالة الخطأ
-if (!command || (command !== 'build' && !command.endsWith('.thoth'))) {
-    console.log('\x1b[33m%s\x1b[0m', '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    console.log('\x1b[1m\x1b[32m 𓅓 THOTH ENGINE v4.1.0 \x1b[0m');
-    console.log('\x1b[33m%s\x1b[0m', ' Developed by Engineer Abdelfatah Abdelhamed');
-    console.log('\x1b[33m%s\x1b[0m', '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    console.log(' Usage:');
-    console.log('  thoth build file.thoth    \x1b[90m(Create a standalone HTML5 file)\x1b[0m');
-    console.log('  thoth file.thoth          \x1b[90m(Fast Internal Compilation)\x1b[0m');
-    process.exit(1);
-}
-
-const targetFile = command === 'build' ? file : command;
-
-// القاموس الهندسي الشامل لجميع وسوم HTML5
-const MAP = {
+// --- القاموس المعماري الشامل ---
+const TAG_MAP = {
     'Title': 'h1', 'Sub': 'h2', 'Heading': 'h3', 'Text': 'p', 'Bold': 'strong',
     'Italic': 'em', 'Box': 'div', 'Container': 'section', 'Nav': 'nav',
     'Header': 'header', 'Footer': 'footer', 'Article': 'article', 'Aside': 'aside',
     'Link': 'a', 'Image': 'img', 'Button': 'button', 'List': 'ul', 'Item': 'li',
-    'Input': 'input', 'Form': 'form', 'Label': 'label', 'Break': 'br', 'Line': 'hr'
+    'Input': 'input', 'Form': 'form', 'Label': 'label', 'Break': 'br', 'Line': 'hr',
+    'Main': 'main', 'Layout': 'section'
 };
 
-const VOID_TAGS = ['img', 'br', 'hr', 'input', 'meta', 'link'];
+const VOID_ELEMENTS = ['img', 'br', 'hr', 'input', 'meta', 'link'];
 
-function compile(filePath) {
-    if (!fs.existsSync(filePath)) {
-        console.error('\x1b[31m%s\x1b[0m', `❌ Error: File "${filePath}" not found.`);
-        process.exit(1);
+// --- سياق التشغيل السيادي ---
+let dataContext = {};
+let config = {
+    devMode: process.argv.includes('--dev') || process.argv.includes('serve'),
+    port: 3000,
+    currentUserRole: 'admin', // القيمة الافتراضية لمحاكاة الميدلوير
+    strictMode: true
+};
+
+const args = process.argv.slice(2);
+const command = args[0];
+const target = args.find(a => a.endsWith('.thoth'));
+
+if (!command || (!target && command !== 'serve')) {
+    displayUsage();
+    process.exit(1);
+}
+
+/**
+ * عرض إرشادات الاستخدام التقنية
+ */
+function displayUsage() {
+    const yellow = '\x1b[33m';
+    const reset = '\x1b[0m';
+    console.log(yellow + '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━' + reset);
+    console.log('\x1b[1m\x1b[32m THOTH INTELLIGENCE SUITE v10.5.0 \x1b[0m');
+    console.log(yellow + ' Lead Architect: Abdelfatah Abdelhamed' + reset);
+    console.log(yellow + '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━' + reset);
+    console.log(' Usage:');
+    console.log('   thoth build [file].thoth    (Production Compilation)');
+    console.log('   thoth serve [file].thoth    (Live Dev Server + Reload)');
+}
+
+/**
+ * معالجة البيانات الديناميكية @{{key}} و @Variable
+ */
+function resolveData(text, context, variables = {}) {
+    // 1. استبدال المتغيرات @Var
+    let resolved = text;
+    for (const [key, val] of Object.entries(variables)) {
+        resolved = resolved.replace(new RegExp(key, 'g'), val);
+    }
+    // 2. استبدال بيانات JSON @{{key}}
+    return resolved.replace(/@\{\{([^}]+)\}\}/g, (match, key) => {
+        const val = context[key.trim()];
+        return val !== undefined ? val : match;
+    });
+}
+
+/**
+ * محرك التجميع المعماري
+ */
+function compileThoth(inputPath, isDev = false) {
+    if (!fs.existsSync(inputPath)) throw new Error(`Source Integrity Error: "${inputPath}" not found.`);
+
+    const source = fs.readFileSync(inputPath, 'utf8');
+    const lines = source.split(/\r?\n/);
+    
+    // --- التحقق من شرط السيادة الأول ---
+    if (lines[0].trim() !== "TYPE THOTH") {
+        throw new Error("Architectural Identity Error: File must start with 'TYPE THOTH' to ensure sovereignty.");
     }
 
-    const code = fs.readFileSync(filePath, 'utf8');
-    const lines = code.split(/\r?\n/);
-    let htmlBody = "";
+    let htmlContent = "";
     let stack = [];
-    let inRaw = false, rawType = '', rawIndent = 0;
+    let variables = {};
+    let rawScope = { active: false, type: '', indent: 0 };
+    let skipIndent = -1;
+    let repeatScope = { active: false, key: '', indent: 0, buffer: [] };
 
-    lines.forEach(line => {
+    for (let i = 1; i < lines.length; i++) { // نبدأ من 1 لتجاوز سطر النوع
+        let line = lines[i];
         const trimmed = line.trim();
-        
-        // 1. تجاهل الأسطر الفارغة والتعليقات تماماً
-        if (!trimmed || trimmed.startsWith('#')) return;
-
         const indent = line.search(/\S/);
 
-        // 2. نظام الـ Raw Mode للأكواد المدمجة (CSS/JS)
-        if (inRaw) {
-            if (indent <= rawIndent && trimmed !== "") {
-                inRaw = false;
-                htmlBody += `</${rawType}>\n`;
+        if (!trimmed || trimmed.startsWith('#')) continue;
+
+        // --- 1. Middleware / Auth Guard ---
+        if (skipIndent !== -1) {
+            if (indent > skipIndent) continue;
+            else skipIndent = -1;
+        }
+
+        const authMatch = trimmed.match(/Auth="([^"]+)"/);
+        if (authMatch) {
+            if (authMatch[1] !== config.currentUserRole && authMatch[1] !== 'guest') {
+                skipIndent = indent;
+                continue;
+            }
+        }
+
+        // --- 2. Repeat Logic (Recursive) ---
+        if (repeatScope.active) {
+            if (indent > repeatScope.indent) {
+                repeatScope.buffer.push(line);
+                continue;
             } else {
-                htmlBody += line + '\n';
-                return;
+                const list = dataContext[repeatScope.key] || [];
+                list.forEach(item => {
+                    htmlContent += processBuffer(repeatScope.buffer, item, variables);
+                });
+                repeatScope.active = false;
+                repeatScope.buffer = [];
             }
         }
 
-        // 3. خوارزمية الفصل الذكية (لحل مشكلة النقطتين داخل الـ Styles)
-        let sepIndex = -1;
-        let inQuotes = false;
-        for (let i = 0; i < trimmed.length; i++) {
-            if (trimmed[i] === '"') inQuotes = !inQuotes;
-            if (trimmed[i] === ':' && !inQuotes) {
-                sepIndex = i;
-                break;
+        if (trimmed.startsWith('Repeat Over="')) {
+            repeatScope.key = trimmed.match(/Over="([^"]+)"/)[1];
+            repeatScope.active = true;
+            repeatScope.indent = indent;
+            continue;
+        }
+
+        // --- 3. Data Ingestion & Variables ---
+        if (trimmed.startsWith('DataSource:')) {
+            const dPath = path.resolve(path.dirname(inputPath), trimmed.split(':')[1].trim());
+            if (fs.existsSync(dPath)) dataContext = JSON.parse(fs.readFileSync(dPath, 'utf8'));
+            continue;
+        }
+
+        if (trimmed.startsWith('Var ')) {
+            const vParts = trimmed.substring(4).split(':');
+            if (vParts.length === 2) variables['@' + vParts[0].trim()] = vParts[1].trim();
+            continue;
+        }
+
+        line = resolveData(line, dataContext, variables);
+        const processedTrimmed = line.trim();
+
+        // --- 4. Raw Code Injection (CSS/JS) ---
+        if (rawScope.active) {
+            if (indent <= rawScope.indent && processedTrimmed !== "") {
+                rawScope.active = false;
+                htmlContent += `</${rawScope.type}>\n`;
+            } else {
+                htmlContent += line + '\n';
+                continue;
             }
         }
 
-        let cmdPart, val;
-        if (sepIndex !== -1) {
-            cmdPart = trimmed.substring(0, sepIndex).trim();
-            val = trimmed.substring(sepIndex + 1).trim();
-        } else {
-            cmdPart = trimmed;
-            val = "";
+        // --- خوارزمية تحليل الفصل الذكي ---
+        let colonIdx = -1;
+        let inQuotes = false;
+        for (let j = 0; j < processedTrimmed.length; j++) {
+            if (processedTrimmed[j] === '"') inQuotes = !inQuotes;
+            if (processedTrimmed[j] === ':' && !inQuotes) { colonIdx = j; break; }
         }
 
-        // فصل اسم التاج عن الخصائص (Attributes)
-        const spacePos = cmdPart.indexOf(' ');
-        let cmd = spacePos !== -1 ? cmdPart.substring(0, spacePos) : cmdPart;
-        let attrs = spacePos !== -1 ? cmdPart.substring(spacePos).trim() : "";
-
-        // 4. الدخول في الـ Raw Mode
-        if (cmd === "StyleSheet" || cmd === "Scripting") {
-            inRaw = true;
-            rawType = (cmd === "StyleSheet") ? "style" : "script";
-            rawIndent = indent;
-            htmlBody += `<${rawType}>\n`;
-            return;
+        let instr = colonIdx !== -1 ? processedTrimmed.substring(0, colonIdx).trim() : processedTrimmed;
+        let val = colonIdx !== -1 ? processedTrimmed.substring(colonIdx + 1).trim() : "";
+
+        const firstSpace = instr.indexOf(' ');
+        const tagName = firstSpace !== -1 ? instr.substring(0, firstSpace) : instr;
+        const attrs = firstSpace !== -1 ? instr.substring(firstSpace).trim() : "";
+
+        if (tagName === "StyleSheet" || tagName === "Scripting") {
+            rawScope.active = true;
+            rawScope.type = tagName === "StyleSheet" ? "style" : "script";
+            rawScope.indent = indent;
+            htmlContent += `<${rawScope.type}>\n`;
+            continue;
         }
 
-        // 5. إدارة قفل التاجات حسب مستوى المسافات
+        // إدارة المكدس (Stack Indentation)
         while (stack.length > 0 && stack[stack.length - 1].indent >= indent) {
-            htmlBody += `</${stack.pop().name}>\n`;
+            htmlContent += `</${stack.pop().name}>\n`;
         }
 
-        let tag = MAP[cmd] || cmd.toLowerCase();
-        let openTag = `<${tag}${attrs ? ' ' + attrs : ''}>`;
+        const tag = TAG_MAP[tagName] || tagName.toLowerCase();
+        const cleanAttrs = attrs.replace(/Auth="[^"]+"/, '').trim();
+        const open = `<${tag}${cleanAttrs ? ' ' + cleanAttrs : ''}>`;
 
-        if (VOID_TAGS.includes(tag)) {
-            htmlBody += openTag + '\n';
+        if (VOID_ELEMENTS.includes(tag)) {
+            htmlContent += open + '\n';
         } else if (val) {
-            htmlBody += `${openTag}${val}</${tag}>\n`;
+            htmlContent += `${open}${val}</${tag}>\n`;
         } else {
-            htmlBody += openTag + '\n';
+            htmlContent += open + '\n';
             stack.push({ name: tag, indent: indent });
         }
-    });
+    }
 
-    // إغلاق أي تاجات متبقية
-    while (stack.length > 0) {
-        htmlBody += `</${stack.pop().name}>\n`;
+    // إغلاق أي تكرار متبقي
+    if (repeatScope.active) {
+        const list = dataContext[repeatScope.key] || [];
+        list.forEach(item => { htmlContent += processBuffer(repeatScope.buffer, item, variables); });
     }
 
-    // بناء الهيكل النهائي مع تحسينات SEO
+    while (stack.length > 0) htmlContent += `</${stack.pop().name}>\n`;
+
+    return generateBoilerplate(htmlContent, isDev);
+}
+
+/**
+ * معالجة الـ Buffer داخل الـ Loop
+ */
+function processBuffer(buffer, item, variables) {
+    let res = "";
+    let bStack = [];
+    buffer.forEach(l => {
+        const ind = l.search(/\S/);
+        let pLine = resolveData(l, item, variables);
+        const t = pLine.trim();
+        let cIdx = t.indexOf(':');
+        let cmdStr = cIdx !== -1 ? t.substring(0, cIdx).trim() : t;
+        let valStr = cIdx !== -1 ? t.substring(cIdx + 1).trim() : "";
+        
+        const space = cmdStr.indexOf(' ');
+        const tag = TAG_MAP[cmdStr.substring(0, space === -1 ? cmdStr.length : space)] || cmdStr.toLowerCase();
+        
+        while (bStack.length > 0 && bStack[bStack.length - 1].indent >= ind) res += `</${bStack.pop().name}>\n`;
+        
+        const op = `<${tag}${space !== -1 ? ' ' + cmdStr.substring(space).trim() : ''}>`;
+        if (VOID_ELEMENTS.includes(tag)) res += op + '\n';
+        else if (valStr) res += `${op}${valStr}</${tag}>\n`;
+        else { res += op + '\n'; bStack.push({ name: tag, indent: ind }); }
+    });
+    while (bStack.length > 0) res += `</${bStack.pop().name}>\n`;
+    return res;
+}
+
+/**
+ * توليد هيكل HTML5 المعياري مع الـ Meta Tags
+ */
+function generateBoilerplate(content, isDev) {
+    const title = dataContext.site_title || "THOTH Sovereign Architecture";
+    const desc = dataContext.site_desc || "Engineered by Abdelfatah Abdelhamed";
+    
+    const liveReload = isDev ? `
+    <script>
+        console.log('%c THOTH DEV MODE: ACTIVE ', 'background:#D4AF37;color:#000;font-weight:bold;');
+        let lastMod = null;
+        setInterval(async () => {
+            try {
+                const r = await fetch(window.location.href, {method:'HEAD'});
+                const etag = r.headers.get('etag') || r.headers.get('last-modified');
+                if(lastMod && etag !== lastMod) location.reload();
+                lastMod = etag;
+            } catch(e) {}
+        }, 1500);
+    </script>` : "";
+
     return `<!DOCTYPE html>
 <html lang="ar" dir="rtl">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <meta name="generator" content="THOTH Sovereign Engine v4.1.0">
+    <meta name="description" content="${desc}">
+    <meta name="generator" content="THOTH Sovereign Engine v10.5.0">
     <meta name="author" content="Abdelfatah Abdelhamed">
-    <title>Compiled by THOTH</title>
+    <title>${title}</title>
 </head>
-<body>
-${htmlBody}
+<body style="margin:0; background:#050505; color:#fff;">
+${content}
+${liveReload}
 </body>
 </html>`;
 }
 
-// تنفيذ عملية التجميع
-try {
-    const result = compile(targetFile);
-    const output = targetFile.replace('.thoth', '.html');
-    fs.writeFileSync(output, result);
-
-    console.log('\x1b[32m%s\x1b[0m', `──────────────────────────────────────────`);
-    console.log('\x1b[1m\x1b[32m ✔ SUCCESS: \x1b[0m THOTH Engine has spoken.');
-    console.log('\x1b[37m Output:\x1b[0m', output);
-    console.log('\x1b[37m Author:\x1b[0m Engineer Abdelfatah Abdelhamed 🇪🇬');
-    console.log('\x1b[32m%s\x1b[0m', `──────────────────────────────────────────`);
-} catch (err) {
-    console.error('\x1b[31m%s\x1b[0m', `❌ Compilation Error: ${err.message}`);
-    process.exit(1);
+// --- طبقة التنفيذ ---
+if (command === 'serve') {
+    const server = http.createServer((req, res) => {
+        try {
+            const html = compileThoth(target, true);
+            res.writeHead(200, { 
+                'Content-Type': 'text/html',
+                'Cache-Control': 'no-cache',
+                'ETag': Date.now().toString() 
+            });
+            res.end(html);
+        } catch (e) {
+            res.writeHead(500, { 'Content-Type': 'text/html' });
+            res.end(`<body style="background:#000;color:#ff5555;padding:50px;font-family:monospace">
+                <h2 style="border-bottom:2px solid #ff5555;padding-bottom:10px">SOVEREIGN COMPILATION ERROR</h2>
+                <p style="font-size:18px">${e.message}</p>
+                <button onclick="location.reload()" style="background:#ff5555;color:#fff;border:none;padding:10px 20px;cursor:pointer">RETRY</button>
+            </body>`);
+        }
+    });
+
+    server.listen(config.port, () => {
+        console.log('\x1b[32m%s\x1b[0m', `──────────────────────────────────────────`);
+        console.log(` ✔ SERVER ACTIVE: http://localhost:${config.port}`);
+        console.log(` ✔ ARCHITECTURE: ${target}`);
+        console.log(` ✔ MODE: Intelligence Suite v10.5.0`);
+        console.log('\x1b[32m%s\x1b[0m', `──────────────────────────────────────────`);
+    });
+} else {
+    try {
+        const out = compileThoth(target, false);
+        fs.writeFileSync(target.replace('.thoth', '.html'), out);
+        console.log(`\x1b[32m [SUCCESS] Architecture materialized: ${target.replace('.thoth', '.html')}\x1b[0m`);
+    } catch (e) {
+        console.error(`\x1b[31m [ERROR] ${e.message}\x1b[0m`);
+        process.exit(1);
+    }
 }

package/.htaccess

@@ -1,9 +0,0 @@
-# THOTH Server Configuration
-RewriteEngine On
-
-# توجيه أي طلب لملف ينتهي بـ .thoth إلى محرك المهندس عبد الفتاح
-RewriteCond %{REQUEST_FILENAME} !-f
-RewriteRule ^(.*)\.thoth$ engine.php?file=$1.thoth [L,QSA]
-
-# جعل index.thoth هو الملف الرئيسي للموقع
-DirectoryIndex index.thoth