thoth-markup-lang 10.5.0 → 11.0.0

package/README.md

@@ -1,42 +1,43 @@
-# THOTH: The Sovereign Intelligence Suite (v10.5.0)
+# THOTH: The Sovereign Intelligence Suite (v11.0.0 Pulse Edition)
 
 <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/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" />
+  <img src="https://img.shields.io/npm/v/thoth-markup-lang?style=for-the-badge&color=06b6d4&logo=npm" alt="NPM Version" />
+  <img src="https://img.shields.io/badge/Version-11.0.0--Pulse-f59e0b?style=for-the-badge" alt="Pulse Version" />
+  <img src="https://img.shields.io/badge/Engineered_In-Egypt_🇪🇬-020617?style=for-the-badge&logo=code" alt="Egypt" />
 </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.
+**The Binary Wisdom of Web Architecture.** THOTH is a high-performance, sovereign, indentation-based markup language and recursive runtime engine. It eliminates structural noise, removes bracket chaos, and redefines web development through pure, architectural logic.
 
 ---
 
 ## 🏛️ Architectural Philosophy
 
-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.
+THOTH represents a monumental paradigm shift from "tag-heavy" legacy markup to **Recursive Indentation Logic**. With the release of **v11.0.0 (Pulse Edition)**, the engine introduces an ultra-fast parsing core and Python-style error handling, enforcing absolute structural purity. It requires all sovereign files to declare their identity with the `TYPE THOTH` protocol, ensuring architectural integrity and preventing unauthorized code execution.
 
-- **Official Website:** [thoth-lang.com](https://honeydew-pigeon-679592.hostingersite.com/)
-- **Architected by:** [Engineer Abdelfatah Abdelhamed](mailto:abdelfatahabdelhamed.kfs@gmail.com)
+- **Official Website:** [THOTH Language Portal](https://honeydew-pigeon-679592.hostingersite.com/)
+- **Lead Architect:** Engineer Abdelfatah Abdelhamed
 
 ---
 
-## 💎 Intelligence Suite Features (v10.5.0)
+## 💎 Intelligence Suite Features (v11.0.0 Pulse)
 
-* **🛡️ 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).
+* **⚡ Ultra-Fast Parser Core [NEW]:** Upgraded O(n) string manipulation algorithms for blazing-fast indentation computation and rendering.
+* **🐞 Python-Style Tracebacks [NEW]:** Intelligent error handling that pinpoints exact file, line number, and syntax faults in both Terminal and a Browser Overlay.
+* **🛡️ Strict Identification:** Mandatory `TYPE THOTH` protocol header to ensure uncompromised file sovereignty.
+* **💎 Zero-Bracket Architecture:** Eliminates opening/closing DOM tags, reducing syntax noise by up to 70%.
+* **🔗 Recursive Data Binding:** Native integration with JSON flat-file databases using `@{{key}}` syntax.
+* **🔐 Procedural Middleware (Auth Guard):** Secure structural DOM nodes natively using `Auth="role"` attributes.
+* **🚀 Pulse Dev Server & Live Reload:** Integrated HTTP server with automated browser synchronization and state tracking.
+* **🔍 Advanced Meta SEO Engine:** Automated generation of HTML5 Meta Tags directly from your JSON data context.
+* **📦 Scoped Components:** Modular file architecture and management through the `Import:` directive.
+* **💉 Hybrid Injection:** Native support for scoped `StyleSheet` (Raw CSS) and `Scripting` (Raw JS) inside the `.thoth` environment.
 
 ---
 
 ## 🚀 Technical Implementation
 
-### Global Installation
-Install the THOTH CLI via NPM:
+### 1. Global Installation
+Install the THOTH Engine globally via NPM to access the sovereign CLI:
 
 ```bash
 npm install -g thoth-markup-lang

package/engine.php

@@ -1,18 +1,30 @@
 <?php
 /**
- * THOTH Sovereign Runtime Engine v10.5 - Final Master Suite
+ * THOTH Sovereign Runtime Engine v11.0 - Pulse Edition
  * 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: تتبع أخطاء الهندسة البرمجية لحظياً.
+ * 5. Python-Style Traceback: متتبع أخطاء ذكي يحدد السطر ونوع الخطأ بدقة.
+ * 6. High-Performance Core: تسريع التحليل باستخدام دوال PHP الحديثة.
  */
 
 session_start();
 
+/**
+ * كلاس استثناءات مخصص للغة تحوت لتتبع الأخطاء بذكاء
+ */
+class ThothSyntaxError extends Exception {
+    public $lineContent;
+    public function __construct($message, $code = 0, $lineContent = "", Throwable $previous = null) {
+        $this->lineContent = $lineContent;
+        parent::__construct($message, $code, $previous);
+    }
+}
+
 class ThothEngine {
     private $tagMap = [
         'Title' => 'h1', 'Sub' => 'h2', 'Heading' => 'h3', 'Text' => 'p', 
@@ -28,12 +40,15 @@ class ThothEngine {
     private $dataContext = [];
     private $devMode = true; 
     private $currentLine = 0;
+    private $currentFile = "";
 
     /**
      * المدخل الرئيسي للمحرك
      */
     public function render($filePath, $isSubCall = false) {
         $safePath = basename($filePath);
+        $this->currentFile = $safePath;
+
         if (!file_exists($safePath)) {
             return $this->errorPage("404 | THOTH Missing", "الملف غير موجود في النطاق السيادي.");
         }
@@ -43,7 +58,7 @@ class ThothEngine {
         // --- شرط السيادة: التحقق من نوع الملف ---
         $firstLine = trim($lines[0]);
         if ($firstLine !== "TYPE THOTH") {
-            return $this->devErrorOverlay("خطأ في الهوية البرمجية: يجب أن يبدأ الملف بـ TYPE THOTH لضمان السيادة.", 1);
+            return $this->devErrorOverlay("SyntaxError: Missing Identity Protocol. File must begin with TYPE THOTH.", 1, $lines[0]);
         }
         unset($lines[0]); // إزالة سطر التعريف من المعالجة
 
@@ -62,7 +77,10 @@ class ThothEngine {
             foreach ($lines as $index => $line) {
                 $this->currentLine = $index + 1;
                 $trimmed = trim($line);
-                if ($trimmed === "" || strpos($trimmed, '#') === 0) continue;
+                
+                // تسريع معالجة الأسطر الفارغة والتعليقات باستخدام str_starts_with
+                if ($trimmed === "" || str_starts_with($trimmed, '#')) continue;
+                
                 $indent = strlen($line) - strlen(ltrim($line));
 
                 // Middleware Guard
@@ -84,16 +102,21 @@ class ThothEngine {
                     else { $htmlBody .= $this->processRepeat($repeatKey, $repeatBuffer); $isRepeatMode = false; $repeatBuffer = []; }
                 }
 
-                if (strpos($trimmed, 'Repeat Over="') === 0) {
+                if (str_starts_with($trimmed, 'Repeat Over="')) {
                     preg_match('/Over="([^"]+)"/', $trimmed, $matches);
+                    if(empty($matches[1])) throw new ThothSyntaxError("LoopError: Missing valid array key in Over statement.", $this->currentLine, $line);
                     $repeatKey = $matches[1] ?? '';
                     $repeatIndent = $indent; $isRepeatMode = true; 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; }
+                if (str_starts_with($trimmed, 'DataSource:')) { $this->loadData(trim(substr($trimmed, 11))); continue; }
+                if (str_starts_with($trimmed, 'Var ')) { $this->parseVariable($trimmed); continue; }
+                if (str_starts_with($trimmed, 'Import:')) { 
+                    $importFile = trim(substr($trimmed, 7));
+                    if(!file_exists($importFile)) throw new ThothSyntaxError("ImportError: Module '$importFile' not found.", $this->currentLine, $line);
+                    $htmlBody .= $this->render($importFile, true); continue; 
+                }
 
                 $line = $this->resolveDynamicData($line);
                 $trimmed = trim($line);
@@ -105,6 +128,11 @@ class ThothEngine {
                 }
 
                 $sep = $this->findSeparator($trimmed);
+                if($sep === -1 && !empty($trimmed) && !isset($this->tagMap[explode(' ', $trimmed)[0]]) && !in_array(strtolower(explode(' ', $trimmed)[0]), $this->voidTags) && $cmd !== "StyleSheet" && $cmd !== "Scripting"){
+                    // الذكاء الاصطناعي لاكتشاف الأخطاء المطبعية
+                    throw new ThothSyntaxError("ParseError: Invalid syntax or missing separator ':'.", $this->currentLine, $line);
+                }
+
                 $cmdPart = ($sep !== -1) ? trim(substr($trimmed, 0, $sep)) : $trimmed;
                 $val = ($sep !== -1) ? trim(substr($trimmed, $sep + 1)) : "";
 
@@ -142,8 +170,10 @@ class ThothEngine {
 
             return ($isSubCall) ? $htmlBody : $this->generateFullHTML($htmlBody);
 
+        } catch (ThothSyntaxError $e) {
+            return $this->devErrorOverlay($e->getMessage(), $this->currentLine, $e->lineContent);
         } catch (Exception $e) {
-            return $this->devErrorOverlay($e->getMessage(), $this->currentLine);
+            return $this->devErrorOverlay("RuntimeError: " . $e->getMessage(), $this->currentLine, "System Execution Error");
         }
     }
 
@@ -173,7 +203,8 @@ class ThothEngine {
 
     private function findSeparator($text) {
         $inQuotes = false;
-        for ($i = 0; $i < strlen($text); $i++) {
+        $len = strlen($text);
+        for ($i = 0; $i < $len; $i++) {
             if ($text[$i] === '"') $inQuotes = !$inQuotes;
             if ($text[$i] === ':' && !$inQuotes) return $i;
         }
@@ -193,15 +224,39 @@ class ThothEngine {
     }
 
     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>";
+        return "<div style='font-family:sans-serif; background:#020617; color:#fff; height:100vh; display:flex; flex-direction:column; align-items:center; justify-content:center;'><h1>$title</h1><p style='color:#06b6d4'>$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>";
+    /**
+     * Python-Style Traceback Overlay
+     * تصميم هندسي ذكي يحدد الخطأ والمكان والملف بالتفصيل
+     */
+    private function devErrorOverlay($msg, $line, $lineContent = "") {
+        $escapedContent = htmlspecialchars($lineContent);
+        return "
+        <div style='position:fixed; top:0; left:0; width:100%; height:100%; background:rgba(2,6,23,0.95); z-index:99999; display:flex; align-items:center; justify-content:center; font-family:\"Fira Code\", monospace;'>
+            <div style='background:#0f172a; border:1px solid #ef4444; width:80%; max-width:800px; padding:30px; border-radius:12px; box-shadow:0 0 30px rgba(239, 68, 68, 0.2); color:#e2e8f0;'>
+                
+                <div style='border-bottom: 1px solid #334155; padding-bottom:15px; mb-4;'>
+                    <h2 style='color:#ef4444; margin:0; font-size:1.5rem;'>⚠️ THOTH Traceback (most recent call last):</h2>
+                </div>
+                
+                <div style='padding: 20px 0;'>
+                    <p style='margin:0 0 10px 0; color:#94a3b8;'>File <span style='color:#06b6d4;'>\"{$this->currentFile}\"</span>, line <span style='color:#f59e0b; font-weight:bold;'>$line</span>, in &lt;module&gt;</p>
+                    
+                    <div style='background:#000; padding:15px; border-radius:8px; border-left:4px solid #ef4444; overflow-x:auto;'>
+                        <div style='color:#f87171;'>$line | <span style='color:#e2e8f0;'>$escapedContent</span></div>
+                        <div style='color:#ef4444; margin-top:5px;'>&nbsp;&nbsp;&nbsp;&nbsp;^</div>
+                    </div>
+                    
+                    <p style='margin:20px 0 0 0; color:#ef4444; font-weight:bold; font-size:1.1rem;'>$msg</p>
+                </div>
+
+                <div style='border-top: 1px solid #334155; padding-top:15px; text-align:right;'>
+                    <button onclick='location.reload()' style='background:#ef4444; color:#fff; padding:8px 24px; border:none; border-radius:6px; cursor:pointer; font-weight:bold; font-family:inherit;'>RESTART ENGINE</button>
+                </div>
+            </div>
+        </div>";
     }
 
     private function generateFullHTML($body) {
@@ -211,10 +266,12 @@ class ThothEngine {
         $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;
+                try {
+                    const res = await fetch(window.location.href, { method: 'HEAD' });
+                    const etag = res.headers.get('etag');
+                    if (lastMod && etag !== lastMod) location.reload();
+                    lastMod = etag;
+                } catch(e) {}
             }, 2000);
         </script>" : "";
 
@@ -222,7 +279,7 @@ class ThothEngine {
                "    <meta charset='UTF-8'>\n" .
                "    <meta name='viewport' content='width=device-width, initial-scale=1.0'>\n" .
                "    <meta name='description' content='$desc'>\n" .
-               "    <meta name='generator' content='THOTH Sovereign Engine 10.5'>\n" .
+               "    <meta name='generator' content='THOTH Sovereign Engine 11.0'>\n" .
                "    <title>$title</title>\n" .
                "</head>\n<body>\n$body\n$liveReload</body>\n</html>";
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "thoth-markup-lang",
-  "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.",
+  "version": "11.0.0",
+  "description": "THOTH Sovereign Suite (Pulse Edition): A revolutionary indentation-based markup ecosystem featuring Strict File Identification (TYPE THOTH), Python-style tracebacks, recursive JSON data-binding, procedural middleware auth guards, and an ultra-high-performance runtime. Engineered by Engineer Abdelfatah Abdelhamed.",
   "main": "thoth.js",
   "bin": {
     "thoth": "./thoth.js"
@@ -14,13 +14,16 @@
     "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"
+    "version": "echo THOTH v11.0.0 Pulse Edition Sovereign Intelligence Suite"
   },
   "keywords": [
     "thoth",
     "thoth-lang",
     "markup-language",
     "sovereign-engine",
+    "pulse-edition",
+    "python-style-traceback",
+    "smart-error-handling",
     "type-thoth-identification",
     "strict-markup",
     "indentation-logic",
@@ -36,7 +39,7 @@
     "performance-runtime",
     "high-speed-compiler"
   ],
-  "author": "Abdelfatah Abdelhamed <abdelfatahabdelhamed.kfs@gmail.com>",
+  "author": "Engineer Abdelfatah Abdelhamed <abdelfatahabdelhamed.kfs@gmail.com>",
   "license": "MIT",
   "engines": {
     "node": ">=14.0.0"

package/thoth.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 /**
- * THOTH Engine v10.5.0 - The Sovereign Architect (Intelligence Suite)
- * Lead Developer: Engineer Abdelfatah Abdelhamed
+ * THOTH Engine v11.0.0 - Pulse Edition (Sovereign Intelligence Suite)
+ * Lead Developer & Architect: Engineer Abdelfatah Abdelhamed 🇪🇬
  * ------------------------------------------------------------------
  * الميزات المدمجة:
  * 1. Strict Identification: إلزامية وجود TYPE THOTH في السطر الأول.
@@ -10,12 +10,25 @@
  * 3. Dynamic Meta Engine: توليد وسوم الميتا تلقائياً من سياق البيانات.
  * 4. Dev Server & Live Reload: خادم محلي لمراقبة التغييرات لحظياً.
  * 5. Recursive Data Engine: نظام الـ Loops والـ JSON والـ Variables.
+ * 6. Python-Style Traceback: متتبع أخطاء ذكي ودقيق جداً.
+ * 7. Ultra-Fast Parser: تسريع خوارزميات الـ Indentation والـ String manipulation.
  */
 
 const fs = require('fs');
 const path = require('path');
 const http = require('http');
 
+// --- كلاس تتبع الأخطاء الذكي (Python-Style Error Traceback) ---
+class ThothSyntaxError extends Error {
+    constructor(message, lineNum, lineContent, filePath) {
+        super(message);
+        this.name = 'ThothSyntaxError';
+        this.lineNum = lineNum;
+        this.lineContent = lineContent;
+        this.filePath = filePath;
+    }
+}
+
 // --- القاموس المعماري الشامل ---
 const TAG_MAP = {
     'Title': 'h1', 'Sub': 'h2', 'Heading': 'h3', 'Text': 'p', 'Bold': 'strong',
@@ -51,44 +64,46 @@ if (!command || (!target && command !== 'serve')) {
  */
 function displayUsage() {
     const yellow = '\x1b[33m';
+    const cyan = '\x1b[36m';
     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('\x1b[1m\x1b[32m THOTH INTELLIGENCE SUITE v11.0.0 (Pulse) \x1b[0m');
+    console.log(cyan + ' Lead Architect: Engineer 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)');
+    console.log('   thoth serve [file].thoth    (Live Dev Server + Traceback)');
 }
 
 /**
- * معالجة البيانات الديناميكية @{{key}} و @Variable
+ * معالجة البيانات الديناميكية @{{key}} و @Variable (Fast Regex)
  */
+const DATA_REGEX = /@\{\{([^}]+)\}\}/g;
 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) => {
+    return resolved.replace(DATA_REGEX, (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.`);
+    if (!fs.existsSync(inputPath)) {
+        throw new ThothSyntaxError(`Source Integrity Error: File not found.`, 0, "", inputPath);
+    }
 
     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.");
+        throw new ThothSyntaxError("Architectural Identity Error: Missing 'TYPE THOTH' protocol to ensure sovereignty.", 1, lines[0], inputPath);
     }
 
     let htmlContent = "";
@@ -98,12 +113,15 @@ function compileThoth(inputPath, isDev = false) {
     let skipIndent = -1;
     let repeatScope = { active: false, key: '', indent: 0, buffer: [] };
 
-    for (let i = 1; i < lines.length; i++) { // نبدأ من 1 لتجاوز سطر النوع
+    for (let i = 1; i < lines.length; i++) {
+        const lineNum = i + 1;
         let line = lines[i];
-        const trimmed = line.trim();
-        const indent = line.search(/\S/);
-
+        
+        // تسريع اكتشاف المسافات (أسرع من Regex search)
+        const trimmed = line.trimStart();
         if (!trimmed || trimmed.startsWith('#')) continue;
+        const indent = line.length - trimmed.length;
+        const fullyTrimmed = trimmed.trimEnd();
 
         // --- 1. Middleware / Auth Guard ---
         if (skipIndent !== -1) {
@@ -111,7 +129,7 @@ function compileThoth(inputPath, isDev = false) {
             else skipIndent = -1;
         }
 
-        const authMatch = trimmed.match(/Auth="([^"]+)"/);
+        const authMatch = fullyTrimmed.match(/Auth="([^"]+)"/);
         if (authMatch) {
             if (authMatch[1] !== config.currentUserRole && authMatch[1] !== 'guest') {
                 skipIndent = indent;
@@ -126,31 +144,45 @@ function compileThoth(inputPath, isDev = false) {
                 continue;
             } else {
                 const list = dataContext[repeatScope.key] || [];
+                if(!Array.isArray(list)) {
+                    throw new ThothSyntaxError(`DataMappingError: '${repeatScope.key}' is not a valid Array in Context.`, lineNum, line, inputPath);
+                }
                 list.forEach(item => {
-                    htmlContent += processBuffer(repeatScope.buffer, item, variables);
+                    htmlContent += processBuffer(repeatScope.buffer, item, variables, inputPath, lineNum);
                 });
                 repeatScope.active = false;
                 repeatScope.buffer = [];
             }
         }
 
-        if (trimmed.startsWith('Repeat Over="')) {
-            repeatScope.key = trimmed.match(/Over="([^"]+)"/)[1];
+        if (fullyTrimmed.startsWith('Repeat Over="')) {
+            const match = fullyTrimmed.match(/Over="([^"]+)"/);
+            if (!match) throw new ThothSyntaxError("LoopError: Invalid Repeat syntax.", lineNum, line, inputPath);
+            repeatScope.key = match[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'));
+        if (fullyTrimmed.startsWith('DataSource:')) {
+            const jsonFileName = fullyTrimmed.split(':')[1].trim();
+            const dPath = path.resolve(path.dirname(inputPath), jsonFileName);
+            if (!fs.existsSync(dPath)) {
+                throw new ThothSyntaxError(`MissingDataError: DataSource '${jsonFileName}' not found.`, lineNum, line, inputPath);
+            }
+            try {
+                dataContext = JSON.parse(fs.readFileSync(dPath, 'utf8'));
+            } catch(e) {
+                throw new ThothSyntaxError(`JSONParseError: Invalid JSON format in '${jsonFileName}'.`, lineNum, line, inputPath);
+            }
             continue;
         }
 
-        if (trimmed.startsWith('Var ')) {
-            const vParts = trimmed.substring(4).split(':');
+        if (fullyTrimmed.startsWith('Var ')) {
+            const vParts = fullyTrimmed.substring(4).split(':');
             if (vParts.length === 2) variables['@' + vParts[0].trim()] = vParts[1].trim();
+            else throw new ThothSyntaxError(`VariableError: Invalid Var syntax. Expected 'Var name: value'.`, lineNum, line, inputPath);
             continue;
         }
 
@@ -168,7 +200,7 @@ function compileThoth(inputPath, isDev = false) {
             }
         }
 
-        // --- خوارزمية تحليل الفصل الذكي ---
+        // --- خوارزمية تحليل الفصل الذكي (Strict Parser) ---
         let colonIdx = -1;
         let inQuotes = false;
         for (let j = 0; j < processedTrimmed.length; j++) {
@@ -201,11 +233,11 @@ function compileThoth(inputPath, isDev = false) {
         const open = `<${tag}${cleanAttrs ? ' ' + cleanAttrs : ''}>`;
 
         if (VOID_ELEMENTS.includes(tag)) {
-            htmlContent += open + '\n';
+            htmlContent += ' '.repeat(indent) + open + '\n';
         } else if (val) {
-            htmlContent += `${open}${val}</${tag}>\n`;
+            htmlContent += ' '.repeat(indent) + `${open}${val}</${tag}>\n`;
         } else {
-            htmlContent += open + '\n';
+            htmlContent += ' '.repeat(indent) + open + '\n';
             stack.push({ name: tag, indent: indent });
         }
     }
@@ -213,7 +245,7 @@ function compileThoth(inputPath, isDev = false) {
     // إغلاق أي تكرار متبقي
     if (repeatScope.active) {
         const list = dataContext[repeatScope.key] || [];
-        list.forEach(item => { htmlContent += processBuffer(repeatScope.buffer, item, variables); });
+        list.forEach(item => { htmlContent += processBuffer(repeatScope.buffer, item, variables, inputPath, lines.length); });
     }
 
     while (stack.length > 0) htmlContent += `</${stack.pop().name}>\n`;
@@ -224,14 +256,14 @@ function compileThoth(inputPath, isDev = false) {
 /**
  * معالجة الـ Buffer داخل الـ Loop
  */
-function processBuffer(buffer, item, variables) {
+function processBuffer(buffer, item, variables, filePath, baseLineNum) {
     let res = "";
     let bStack = [];
-    buffer.forEach(l => {
-        const ind = l.search(/\S/);
+    buffer.forEach((l, idx) => {
+        const ind = l.length - l.trimStart().length;
         let pLine = resolveData(l, item, variables);
         const t = pLine.trim();
-        let cIdx = t.indexOf(':');
+        let cIdx = t.indexOf(':'); // Fast path for loops
         let cmdStr = cIdx !== -1 ? t.substring(0, cIdx).trim() : t;
         let valStr = cIdx !== -1 ? t.substring(cIdx + 1).trim() : "";
         
@@ -241,9 +273,9 @@ function processBuffer(buffer, item, variables) {
         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 }); }
+        if (VOID_ELEMENTS.includes(tag)) res += ' '.repeat(ind) + op + '\n';
+        else if (valStr) res += ' '.repeat(ind) + `${op}${valStr}</${tag}>\n`;
+        else { res += ' '.repeat(ind) + op + '\n'; bStack.push({ name: tag, indent: ind }); }
     });
     while (bStack.length > 0) res += `</${bStack.pop().name}>\n`;
     return res;
@@ -258,7 +290,7 @@ function generateBoilerplate(content, isDev) {
     
     const liveReload = isDev ? `
     <script>
-        console.log('%c THOTH DEV MODE: ACTIVE ', 'background:#D4AF37;color:#000;font-weight:bold;');
+        console.log('%c THOTH PULSE DEV MODE: ACTIVE ', 'background:#06b6d4;color:#000;font-weight:bold;');
         let lastMod = null;
         setInterval(async () => {
             try {
@@ -276,17 +308,66 @@ function generateBoilerplate(content, isDev) {
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <meta name="description" content="${desc}">
-    <meta name="generator" content="THOTH Sovereign Engine v10.5.0">
-    <meta name="author" content="Abdelfatah Abdelhamed">
+    <meta name="generator" content="THOTH Sovereign Engine v11.0.0">
+    <meta name="author" content="Engineer Abdelfatah Abdelhamed">
     <title>${title}</title>
 </head>
-<body style="margin:0; background:#050505; color:#fff;">
+<body style="margin:0; background:#020617; color:#f8fafc;">
 ${content}
 ${liveReload}
 </body>
 </html>`;
 }
 
+/**
+ * دالة توليد واجهة تتبع الأخطاء (Browser Overlay)
+ */
+function getBrowserTracebackHTML(e) {
+    if (e.name === 'ThothSyntaxError') {
+        const escapedContent = e.lineContent.replace(/</g, '&lt;').replace(/>/g, '&gt;');
+        return `
+        <!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>THOTH Engine Error</title></head>
+        <body style="margin:0; background:#020617; font-family:'Fira Code', monospace; display:flex; align-items:center; justify-content:center; height:100vh;">
+            <div style="background:#0f172a; border:1px solid #ef4444; width:90%; max-width:800px; padding:30px; border-radius:12px; box-shadow:0 0 30px rgba(239, 68, 68, 0.2); color:#e2e8f0;">
+                <div style="border-bottom: 1px solid #334155; padding-bottom:15px; margin-bottom:20px;">
+                    <h2 style="color:#ef4444; margin:0; font-size:1.5rem;">⚠️ THOTH Traceback (most recent call last):</h2>
+                </div>
+                <div style="padding: 10px 0;">
+                    <p style="margin:0 0 10px 0; color:#94a3b8;">File <span style="color:#06b6d4;">"${e.filePath}"</span>, line <span style="color:#f59e0b; font-weight:bold;">${e.lineNum}</span>, in &lt;module&gt;</p>
+                    <div style="background:#000; padding:15px; border-radius:8px; border-left:4px solid #ef4444; overflow-x:auto;">
+                        <div style="color:#f87171;">${e.lineNum} | <span style="color:#e2e8f0;">${escapedContent}</span></div>
+                        <div style="color:#ef4444; margin-top:5px;">&nbsp;&nbsp;&nbsp;&nbsp;^</div>
+                    </div>
+                    <p style="margin:20px 0 0 0; color:#ef4444; font-weight:bold; font-size:1.1rem;">${e.message}</p>
+                </div>
+                <div style="border-top: 1px solid #334155; padding-top:15px; margin-top:20px; text-align:right;">
+                    <button onclick="location.reload()" style="background:#ef4444; color:#fff; padding:8px 24px; border:none; border-radius:6px; cursor:pointer; font-weight:bold; font-family:inherit;">RESTART ENGINE</button>
+                </div>
+            </div>
+        </body></html>`;
+    }
+    return `<body style="background:#000;color:#ff5555;padding:50px;font-family:monospace">
+        <h2 style="border-bottom:2px solid #ff5555;padding-bottom:10px">SOVEREIGN RUNTIME 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>`;
+}
+
+/**
+ * طباعة الأخطاء في التيرمينال
+ */
+function printTerminalError(e) {
+    if (e.name === 'ThothSyntaxError') {
+        console.error('\x1b[31m%s\x1b[0m', `\n⚠️  THOTH Traceback (most recent call last):`);
+        console.error('\x1b[90m%s\x1b[0m', `  File "${e.filePath}", line ${e.lineNum}, in <module>`);
+        console.error(`    ${e.lineContent}`);
+        console.error('\x1b[31m%s\x1b[0m', `    ^`);
+        console.error('\x1b[1m\x1b[31m%s\x1b[0m', `${e.message}\n`);
+    } else {
+        console.error(`\x1b[31m [ERROR] ${e.message}\x1b[0m`);
+    }
+}
+
 // --- طبقة التنفيذ ---
 if (command === 'serve') {
     const server = http.createServer((req, res) => {
@@ -299,21 +380,18 @@ if (command === 'serve') {
             });
             res.end(html);
         } catch (e) {
+            printTerminalError(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>`);
+            res.end(getBrowserTracebackHTML(e));
         }
     });
 
     server.listen(config.port, () => {
-        console.log('\x1b[32m%s\x1b[0m', `──────────────────────────────────────────`);
+        console.log('\x1b[36m%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', `──────────────────────────────────────────`);
+        console.log(` ✔ MODE: Pulse Edition v11.0.0`);
+        console.log('\x1b[36m%s\x1b[0m', `──────────────────────────────────────────`);
     });
 } else {
     try {
@@ -321,7 +399,7 @@ if (command === 'serve') {
         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`);
+        printTerminalError(e);
         process.exit(1);
     }
 }