thoth-markup-lang 12.0.0 → 12.0.1

package/README.md

@@ -1,242 +1,304 @@
-# 🧠 THOTH: The Sovereign Intelligence Suite
-### v12.0.0 — Sovereign Cloud Edition
+# 𓂀 THOTH: The Sovereign Web Intelligence Engine
+### v12.0.0 — Sovereign Cloud • Async Core • Reactive Architecture
 
 <p align="center">
   <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/Core-Async%20Non--Blocking-0ea5e9?style=for-the-badge" />
   <img src="https://img.shields.io/badge/Architecture-Sovereign-f59e0b?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/Rendering-Reactive%20Engine-22c55e?style=for-the-badge" />
   <img src="https://img.shields.io/badge/Built%20In-Egypt%20🇪🇬-020617?style=for-the-badge" />
 </p>
 
 <p align="center">
-  <b>Not a framework. Not a library. This is a new way to think.</b>
+  <b>Structure is Truth • Logic is Indentation • Control is Sovereignty</b>
 </p>
 
 ---
 
-## ⚡ What is THOTH?
+## 🧠 What is THOTH?
 
-THOTH is an **Asynchronous Reactive Web Engine** built to eliminate the chaos of traditional web development.
+**THOTH** is a next-generation **Asynchronous Reactive Web Engine** designed to eliminate the structural and cognitive overhead of modern frontend development.
 
-No closing tags.  
-No JS dependency for core logic.  
-No unnecessary complexity.  
+It is not:
+- ❌ A framework  
+- ❌ A wrapper  
+- ❌ A templating engine  
 
-Just **pure architecture**.
+It is:
+- ✅ A **unified architecture layer**
+- ✅ A **runtime + syntax + philosophy**
+- ✅ A **replacement for fragmented stacks**
 
-> You don’t write code with THOTH… you *define systems*.
+> You don’t “build UI” with THOTH… you **define systems**.
 
 ---
 
-## 🧠 Why THOTH Exists
+## 🚨 The Problem THOTH Solves
 
-Modern web development is bloated:
-- Too many frameworks
-- Too much boilerplate
-- Too much mental overhead
+Modern web stacks suffer from:
 
-THOTH flips the table:
+- Dependency hell (React, Vite, Redux, Axios…)
+- Boilerplate explosion
+- Context switching (HTML + CSS + JS)
+- Manual state wiring
+- Routing complexity
+- API integration overhead
 
-✔ Indentation instead of tags  
-✔ Native state instead of external stores  
-✔ Built-in routing instead of config hell  
-✔ Direct API binding without JavaScript  
+### THOTH Response:
+
+✔ Zero-bracket syntax  
+✔ Native state engine  
+✔ Built-in SPA routing  
+✔ Direct API binding  
+✔ No external JS required for core logic  
+✔ Single unified architecture file  
+
+---
+
+## 🏗️ Sovereign Scaffolding System [REVOLUTION]
+
+```bash
+thoth create my-app
+```
+
+### Instantly Generates:
+
+```
+/my-app
+ ├── index.thoth
+ ├── /components
+ ├── /data
+ ├── /pages
+ ├── thoth.config.json
+```
+
+### Built for:
+- Rapid prototyping
+- Enterprise architecture
+- Scalable systems
 
 ---
 
-## 💎 Core Features
+## 💎 Core Engine Capabilities
 
-### ☁️ Sovereign Cloud Engine
-Fetch APIs natively:
+### ☁️ Sovereign Cloud Engine (Native API Layer)
 ```text
-API users="https://jsonplaceholder.typicode.com/users"
+API users="https://api.example.com/users"
 ```
 
+- Async by default
+- Non-blocking rendering
+- Auto binding to UI nodes
+
 ---
 
-### ⚡ Native State System
+### ⚡ Native Reactive State Engine
 ```text
-State counter: 0
+State energy: 0
 ```
 
-Reactive updates — no re-render hacks.
+- Instant UI updates
+- No virtual DOM diffing
+- No hooks / reducers
 
 ---
 
-### 🌐 Smart SPA Routing
+### 🌐 Smart SPA Routing Engine
 ```text
 Route "/":
 Route "/dashboard":
+Route "/system":
 ```
 
-Zero config. Zero libraries.
+- History API handled internally
+- Zero configuration
+- Automatic DOM hydration
 
 ---
 
-### 📐 Flex Layout Engine
+### 📐 Native Layout System (Flex Engine)
 ```text
 Row gap="20px" align="center":
 Column width="300px":
 ```
 
-Responsive by design.
+- No Tailwind
+- No Bootstrap
+- Pure structural layout logic
 
 ---
 
-### 🧩 Component System
+### 🧩 Sovereign Component System
 ```text
 Define Card:
     Box:
         Text: @{{title}}
 ```
 
-Reusable. Clean. No duplication.
+- Reusable
+- Stateless or stateful
+- Fully isolated
 
 ---
 
-### 🔗 Data Binding
+### 🔗 Recursive Data Binding Engine
 ```text
-Text: @{{name}}
+Text: @{{username}}
 ```
 
-Direct binding. No middle layers.
+- JSON / API binding
+- Deep nesting support
+- Zero transformation layer
 
 ---
 
-### 🔐 Auth Guards
+### 🔐 Structural Security (Auth Guards)
 ```text
 Header Auth="admin":
 ```
 
-Security built into structure.
+- Built-in access control
+- DOM-level protection
 
 ---
 
-### 🐞 Smart Tracebacks
-Errors actually help you:
-
+### 🐞 Intelligent Traceback System
 ```text
-File "app.thoth", line 12
-APIError: Failed to fetch data
+File "app.thoth", line 22
+APIError: Invalid endpoint
 ```
 
----
-
-## 🚀 Quick Start
-
-### 1. Install
-
-```bash
-npm install -g thoth-markup-lang
-```
+- Precise debugging
+- Developer-friendly errors
+- Runtime + overlay support
 
 ---
 
-### 2. Create App
+## 🚀 Master Example (Full System)
 
-**app.thoth**
 ```text
 TYPE THOTH
 
-Define UserCard:
-    Column width="300px":
-        Box class="card":
-            Sub: @{{name}}
-            Text: "Email: @{{email}}"
-
-State active_users: 0
+# Data & Imports
+DataSource: data/config.json
+Import: components/Navbar.thoth
 
+# API Layer
 API users="https://jsonplaceholder.typicode.com/users"
 
-Container:
-    Route "/":
-        Row gap="20px":
-            Repeat Over="users":
-                UserCard name="@{{name}}", email="@{{email}}"
+# State Layer
+State clicks: 0
 
-        Row:
-            Text: "Users: @{{active_users}}"
-            Button action="set:active_users=active_users+1": "Ping"
-```
+# Root Architecture
+Container class="app-shell":
 
----
+    Navbar title="THOTH Engine"
 
-### 3. Run
+    Route "/":
+        Column align="center":
 
-```bash
-thoth serve app.thoth
-```
+            Title: "Sovereign Cloud Interface"
 
----
+            Row gap="20px":
+                Repeat Over="users":
+                    Box class="card":
+                        Sub: @{{name}}
+                        Text: @{{email}}
 
-### 4. Build
+            Row:
+                Text: "Clicks: @{{clicks}}"
+                Button action="set:clicks=clicks+1":
+                    "Inject Signal"
 
-```bash
-thoth build app.thoth
+    Route "/system":
+        Column:
+            Sub: "Diagnostics"
+            Text: "All systems operational."
 ```
 
 ---
 
-## 🏛️ Philosophy
+## ⚙️ CLI Commands
 
-THOTH is built on one idea:
+### Install Engine
+```bash
+npm install -g thoth-markup-lang
+```
 
-> **Structure is more important than syntax.**
+### Run Dev Server
+```bash
+thoth serve index.thoth
+```
 
-Everything else is noise.
+### Build Production
+```bash
+thoth build index.thoth
+```
 
 ---
 
-## 🔥 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 |
+## 🧬 Architecture Keywords (SEO + Indexing)
+
+Asynchronous Web Engine  
+Reactive UI Engine  
+No-JavaScript Framework Alternative  
+Zero-Bracket Markup Language  
+Indentation-Based Syntax Engine  
+SPA Without React  
+Native State Management Engine  
+API-First Frontend Architecture  
+Unified Web Stack  
+Declarative Web Systems  
+Non-Blocking Rendering Engine  
+Component-Based Architecture  
+Modern Web Engine 2026  
+Frontend Without Frameworks  
+Alternative to React / Vue / Angular  
+Sovereign Architecture System  
 
 ---
 
-## 🧪 Example Output
+## 🔥 Competitive Comparison
 
-From this:
-```text
-Text: "Hello World"
-```
-
-To clean HTML — instantly.
+| Feature | React / Vue | THOTH |
+|--------|------------|-------|
+| Setup Complexity | High | **Minimal** |
+| State Management | External | **Native** |
+| Routing | Library-based | **Built-in** |
+| API Calls | Manual | **Native** |
+| Syntax | JSX / Templates | **Indentation Logic** |
+| Performance | Virtual DOM | **Direct Render Engine** |
 
 ---
 
-## 🛡️ Sovereign Rules
-
-Every file MUST start with:
+## 🏛️ Core Philosophy
 
-```text
-TYPE THOTH
-```
+> “The web is not broken…  
+> developers just built too many layers on top of it.”
 
-No exceptions.
+THOTH removes the layers.
 
 ---
 
 ## 🌍 Vision
 
-THOTH is not trying to compete with frameworks.
+THOTH aims to:
 
-It’s trying to **replace the need for them**.
+- Replace frontend frameworks
+- Simplify web architecture
+- Reduce dev time by 70%+
+- Enable true system-level thinking
 
 ---
 
-## 👑 Final Word
+## 👑 Final Statement
 
-> “Sovereignty is not writing code…  
-> it is controlling how code is written.”
+> “You don’t scale code…  
+> you scale architecture.”
 
 ---
 
 <p align="center">
-  <b>Engineered by Abdelfatah Abdelhamed</b><br>
-  <i>Cairo, Egypt 🇪🇬</i>
+  <b>Architected by Abdelfatah Abdelhamed</b><br>
+  <i>Egypt 🇪🇬 • Sovereign Systems Engineering</i>
 </p>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thoth-markup-lang",
-  "version": "12.0.0",
+  "version": "12.0.1",
   "description": "THOTH Sovereign Suite v12.0.0 (The Sovereign Cloud): The ultimate indentation-based reactive web engine. Features native API Fetch Engine, Smart Routing (SPA builder), Native Layouts (Flexbox), Sovereign Components, State Management, Python-style tracebacks, and an ultra-high-performance runtime. Engineered by Engineer Abdelfatah Abdelhamed.",
   "main": "thoth.js",
   "bin": {
@@ -72,4 +72,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}