thoth-markup-lang 10.5.0 → 12.0.0

package/README.md

@@ -1,42 +1,242 @@
-# THOTH: The Sovereign Intelligence Suite (v10.5.0)
+# 🧠 THOTH: The Sovereign Intelligence Suite
+### v12.0.0 — Sovereign Cloud 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" />
+  <img src="https://img.shields.io/badge/Architecture-Sovereign-f59e0b?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/Built%20In-Egypt%20🇪🇬-020617?style=for-the-badge" />
 </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.
+<p align="center">
+  <b>Not a framework. Not a library. This is a new way to think.</b>
+</p>
+
+---
+
+## ⚡ What is THOTH?
+
+THOTH is an **Asynchronous Reactive Web Engine** built to eliminate the chaos of traditional web development.
+
+No closing tags.  
+No JS dependency for core logic.  
+No unnecessary complexity.  
+
+Just **pure architecture**.
+
+> You don’t write code with THOTH… you *define systems*.
+
+---
+
+## 🧠 Why THOTH Exists
+
+Modern web development is bloated:
+- Too many frameworks
+- Too much boilerplate
+- Too much mental overhead
+
+THOTH flips the table:
+
+✔ Indentation instead of tags  
+✔ Native state instead of external stores  
+✔ Built-in routing instead of config hell  
+✔ Direct API binding without JavaScript  
+
+---
+
+## 💎 Core Features
+
+### ☁️ Sovereign Cloud Engine
+Fetch APIs natively:
+```text
+API users="https://jsonplaceholder.typicode.com/users"
+```
+
+---
+
+### ⚡ Native State System
+```text
+State counter: 0
+```
+
+Reactive updates — no re-render hacks.
 
 ---
 
-## 🏛️ Architectural Philosophy
+### 🌐 Smart SPA Routing
+```text
+Route "/":
+Route "/dashboard":
+```
 
-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.
+Zero config. Zero libraries.
 
-- **Official Website:** [thoth-lang.com](https://honeydew-pigeon-679592.hostingersite.com/)
-- **Architected by:** [Engineer Abdelfatah Abdelhamed](mailto:abdelfatahabdelhamed.kfs@gmail.com)
+---
+
+### 📐 Flex Layout Engine
+```text
+Row gap="20px" align="center":
+Column width="300px":
+```
+
+Responsive by design.
+
+---
+
+### 🧩 Component System
+```text
+Define Card:
+    Box:
+        Text: @{{title}}
+```
+
+Reusable. Clean. No duplication.
+
+---
+
+### 🔗 Data Binding
+```text
+Text: @{{name}}
+```
+
+Direct binding. No middle layers.
 
 ---
 
-## 💎 Intelligence Suite Features (v10.5.0)
+### 🔐 Auth Guards
+```text
+Header Auth="admin":
+```
 
-* **🛡️ 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).
+Security built into structure.
 
 ---
 
-## 🚀 Technical Implementation
+### 🐞 Smart Tracebacks
+Errors actually help you:
 
-### Global Installation
-Install the THOTH CLI via NPM:
+```text
+File "app.thoth", line 12
+APIError: Failed to fetch data
+```
+
+---
+
+## 🚀 Quick Start
+
+### 1. Install
 
 ```bash
-npm install -g thoth-markup-lang
+npm install -g thoth-markup-lang
+```
+
+---
+
+### 2. Create App
+
+**app.thoth**
+```text
+TYPE THOTH
+
+Define UserCard:
+    Column width="300px":
+        Box class="card":
+            Sub: @{{name}}
+            Text: "Email: @{{email}}"
+
+State active_users: 0
+
+API users="https://jsonplaceholder.typicode.com/users"
+
+Container:
+    Route "/":
+        Row gap="20px":
+            Repeat Over="users":
+                UserCard name="@{{name}}", email="@{{email}}"
+
+        Row:
+            Text: "Users: @{{active_users}}"
+            Button action="set:active_users=active_users+1": "Ping"
+```
+
+---
+
+### 3. Run
+
+```bash
+thoth serve app.thoth
+```
+
+---
+
+### 4. Build
+
+```bash
+thoth build app.thoth
+```
+
+---
+
+## 🏛️ Philosophy
+
+THOTH is built on one idea:
+
+> **Structure is more important than syntax.**
+
+Everything else is noise.
+
+---
+
+## 🔥 What Makes THOTH Different?
+
+| Traditional Web | THOTH |
+|------|--------|
+| HTML + CSS + JS | One unified system |
+| Manual state | Native state |
+| React/Vue routing | Built-in routing |
+| API via JS | Native API binding |
+| JSX / Templates | Pure indentation |
+
+---
+
+## 🧪 Example Output
+
+From this:
+```text
+Text: "Hello World"
+```
+
+To clean HTML — instantly.
+
+---
+
+## 🛡️ Sovereign Rules
+
+Every file MUST start with:
+
+```text
+TYPE THOTH
+```
+
+No exceptions.
+
+---
+
+## 🌍 Vision
+
+THOTH is not trying to compete with frameworks.
+
+It’s trying to **replace the need for them**.
+
+---
+
+## 👑 Final Word
+
+> “Sovereignty is not writing code…  
+> it is controlling how code is written.”
+
+---
+
+<p align="center">
+  <b>Engineered by Abdelfatah Abdelhamed</b><br>
+  <i>Cairo, Egypt 🇪🇬</i>
+</p>