TechScript v1.0.5 — Total Release Restructure & Ultimate 0-to-100 Guide

Author: Tanmoy

README.md

@@ -1,7 +1,7 @@
 # 🐉 TechScript — Cinema Edition (v1.0.5)
 
 <p align="center">
-  <img src="assets/icons/master_1024_enhanced.png" alt="TechScript Dragon Logo" width="220">
+  <img src="assets/logo.png" alt="TechScript Dragon Logo" width="220">
 </p>
 
 <p align="center">
@@ -17,15 +17,6 @@
 
 </div>
 
-<div align="center">
-
-![deps](https://img.shields.io/badge/dependencies-NONE-00ff88?style=for-the-badge)
-![stdlib](https://img.shields.io/badge/stdlib-180%2B_functions-7c3aed?style=for-the-badge)
-![vscode](https://img.shields.io/badge/VS_Code-Extension_v1.0.5-007ACC?style=for-the-badge&logo=visualstudiocode&logoColor=white)
-[![Author](https://img.shields.io/badge/Made_by-Tcode--Motion-181717?style=for-the-badge&logo=github)](https://github.com/Tcode-Motion/techscript)
-
-</div>
-
 ---
 
 ## ✨ What's New in v1.0.5
@@ -40,94 +31,172 @@ This is a milestone release that transitions TechScript to a **fully native Rust
 
 ---
 
-<div align="center">
+## 📖 Learn TechScript: From 0 to 100 🚀
 
-```
-╔═════════════════════════════════════════════════════════════════════════╗
-║                                                                         ║
-║   No semicolons. No brackets. No confusing symbols.                     ║
-║   Universal Support — Windows, Linux, Mac, & Termux!                    ║
-║   Blazing Fast Native Rust VM + Premium 3D Animation Studio! ⚡        ║
-╚═════════════════════════════════════════════════════════════════════════╝
-```
+TechScript is designed to be **human-first**. No semicolons, no brackets, just pure logic. This guide will take you from your first "Hello" to building professional 3D simulations.
 
-</div>
+### 🏁 Step 0: Installation
 
----
+| Platform | Recommended Method | Get Started |
+|:---|:---|:---|
+| **🪟 Windows** | **Full Setup Wizard** | [Download Setup](bin/TechScript_v1.0.5_Setup.exe) |
+| **🪟 Windows** | Standalone Binary | [Download (.exe)](bin/TechScript_TX.exe) |
+| **🐧 Linux** | One-Liner Install | `curl -fS scripts/install.sh | bash` |
+| **🍎 macOS** | One-Liner Install | `curl -fS scripts/install.sh | bash` |
+| **📱 Android** | Termux Engine | `pkg install python && pip install techscript-lang` |
 
-## 🤔 What is TechScript? (Explain Like I'm 10)
+---
 
-Imagine you want to tell a computer to do something. Normally, computers only understand confusing code like this:
+### 🟢 Level 1: Core Basics
 
-```javascript
-const x = document.getElementById('name');
-if (x !== null && x.value.length > 0) { ... }
+#### 1. Hello World
+The simplest command in the language.
+```techscript
+say "Hello World!"
 ```
 
-**TechScript makes that feel like writing a sentence:**
+#### 2. Variables & Constants
+Use `make` for values that change and `keep` for fixed ones.
+```techscript
+make score = 0
+keep PI = 3.14159
 
-```
-make name = ask "What is your name? "
-say f"Hello, {name}!"
+score = score + 10    # Works!
+PI = 3.15              # FAIL! Constants are protected.
 ```
 
-TechScript is:
-- 🟢 **A programming language** — writes code that runs natively.
-- 🌐 **A web builder** — build full interactive websites without HTML/CSS.
-- 🦀 **Powered by Native Rust** — blazing speed on Windows (Native x64).
-- 📦 **Zero Logic Bloat** — No semicolons. No brackets. Just pure logic.
+#### 3. Data Types
+TechScript handles numbers, text, and collections naturally.
+```techscript
+make name = "Dragon"       # String
+make age = 5               # Number
+make powers = ["Fire", "Flight"]  # List
+make stats = {"hp": 100}   # Map (Dictionary)
+```
 
 ---
 
-## 🚀 Key Features
+### 🟡 Level 2: Logic & Control Flow
+
+#### 1. Decisions (If/Else)
+We use `when` instead of `if`.
+```techscript
+make temp = 30
+
+when temp > 35 {
+    say "It's scorching!"
+} or when temp > 20 {
+    say "Nice weather."
+} else {
+    say "Brrr... cold."
+}
+```
 
-| Feature | Description | Support |
-|:---|:---|---|
-| **Cinema Studio** | **Advanced 3D Motion Design & Accretion Disk Simulation** | ✅ v7.0 |
-| **Transpilation** | Auto-convert TechScript to clean Python for production | ✅ YES |
-| **Web Module** | Build UIs with `page.h1()`, `page.style()`, and `page.run()` | ✅ YES |
-| **180+ Functions** | Rich StdLib (Math, Crypto, OS, FS, JSON, Date, etc.) | ✅ YES |
-| **Native Binary** | Runs without any dependencies on Windows | ✅ YES |
-| **Termux Force** | Optimized for Android development with built-in examples | ✅ YES |
+#### 2. Repeating Work (Loops)
+```techscript
+# Loop through a list
+each skill in ["Sprinting", "Jumping"] {
+    say f"Leveling up {skill}..."
+}
+
+# Counting with a range
+each i in 1..5 {
+    say f"Lap {i}"
+}
+
+# Loop until a condition is met
+make fuel = 3
+repeat fuel > 0 {
+    say "Flying!"
+    fuel -= 1
+}
+```
 
 ---
 
-## 📦 Installation
+### 🟠 Level 3: Reusing Logic (Functions)
 
-| Platform | Architecture | Type | Download / Install |
-|:---|:---|:---|:---|
-| **🪟 Windows** | x64 (64-bit) | Standalone EXE | **[Download](TechScript_TX.exe)** |
-| **🪟 Windows** | x64 (64-bit) | Full Setup Bundle | **[Download](TechScript_v1.0.5_Windows_Bundle.zip)** |
-| **🐧 Linux** | x86_64 | Native Binary | **[Download](https://github.com/Tcode-Motion/techscript/releases/latest)** |
-| **🍎 macOS** | Intel / M1 / M2 | Native Binary | **[Download](https://github.com/Tcode-Motion/techscript/releases/latest)** |
-| **📱 Android** | ARM / x64 | Termux Engine | **[Install via Pip](README.md#android-termux)** |
-| **🎨 Editor** | All | VS Code Extension | **[Download](techscript-1.0.5.vsix)** |
-*(v1.0.5+ is fully optimized for Termux with automatic Python-engine fallback)*
+Functions are defined with `build`.
+```techscript
+build greet(name, time = "Morning") {
+    say f"Good {time}, {name}!"
+}
 
----
+greet("Tanmoy")           # Good Morning, Tanmoy!
+greet("Tanmoy", "Night")  # Good Night, Tanmoy!
+```
 
-## 📖 Learn the Language
+---
 
-- **Variables**: `make count = 10`
-- **Constants**: `keep PI = 3.14`
-- **Logic**: `when score > 90 { say "Perfect!" }`
-- **Loops**: `each item in [1, 2, 3] { say item }`
-- **Functions**: `build greet(name) { say f"Hi {name}" }`
-- **Web**: `use web`, `make p = WebPage()`, `p.run()`
+### 🔴 Level 4: Pro Features (OOP & Error Handling)
+
+#### 1. Models (Classes)
+Create blueprints for your objects.
+```techscript
+model Robot {
+    build init(self, name) {
+        self.name = name
+    }
+    build wave(self) {
+        say f"{self.name} waves at you! 👋"
+    }
+}
+
+make bot = Robot("R2D2")
+bot.wave()
+```
 
-Check out the **[Full Reference Guide](docs/REFERENCE.md)** for more.
+#### 2. Handling Crashes
+Protect your app with `attempt`.
+```techscript
+attempt {
+    make result = 10 / 0
+} catch err {
+    say f"Caught a mistake: {err.message}"
+}
+```
 
 ---
 
-## 🎨 VS Code Extension
+### 💎 Level 5: The Ecosystem (Special Modules)
+
+#### 🎮 use three_d — 3D Graphics
+```techscript
+use three_d
+make s = scene.scene()
+s.objects.append(scene.box("#e94560", 1.0))
+scene.render(s)
 ```
-code --install-extension techscript-1.0.5.vsix
+
+#### 🌐 use web — Build Sites
+```techscript
+use web
+make p = web.page("My App")
+p.body.append(web.h1("Welcome!"))
+web.open(p)
 ```
 
 ---
 
+### 🛠️ Developer Tooling
+TechScript comes with a full Rust-native toolchain:
+- **`tech fmt`**: Automatically prettify your code.
+- **`tech lint`**: Find errors before you run.
+- **`tech build`**: Compile to fast bytecode (`.txc`).
+- **`tech test`**: Run your built-in unit tests.
+
+---
+
+### 📂 Folder Structure
+- `bin/`: Executables and installers.
+- `docs/`: Full Language Spec & Reference. [Language Reference](docs/REFERENCE.md)
+- `examples/`: Ready-to-run sample projects.
+- `assets/`: Official icons and logos.
+
+---
+
 <p align="center">
-  <img src="logo.png" alt="TechScript Dragon" width="80">
+  <img src="assets/logo.png" alt="TechScript Dragon" width="80">
   <br>
-  <strong>Made with 🐉 and 🦀 by Tcode-Motion</strong>
+  <strong>Crafted with 🐉 and 🦀 by Tcode-Motion</strong>
 </p>