TechScript Language

╔═════════════════════════════════════════════════════════════════════════╗
║                                                                         ║
║   No semicolons. No brackets. No confusing symbols.                     ║
║   No Python runtime. No dependencies. Just pure speed.                  ║
║   Powered by a Native Rust VM.  — Tcode-Motion ⚡                       ║
╚═════════════════════════════════════════════════════════════════════════╝

🤔 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:

const x = document.getElementById('name');
if (x !== null && x.value.length > 0) { ... }

TechScript makes that feel like writing a sentence:

make name = ask "What is your name? "
say f"Hello, {name}!"

That's it. No semicolons. No brackets. No confusing symbols. Just simple words that make sense.

TechScript is:

• 🟢 A programming language — you can write code that runs natively on your computer
• 🌐 A web builder — you can build full websites with it (no HTML or CSS needed!)
• 🎮 A 3D engine — build real-time 3D scenes with use three_d (new in v1.0.5!)
• 🦀 Powered by Native Rust — blazing fast, completely independent of Python
• 📦 One command — tech run yourfile.txs and your program runs instantly

✨ What's New in v1.0.5 — Cinema Edition

This is a milestone release that transitions TechScript to a fully native Rust ecosystem.

• 🦀 Native Rust Engine — A complete rewrite of the runtime for blazing performance
• 🌟 Enhanced Visual Identity — New glowing, production-quality logo with neon "bloom" effects
• 📦 Standalone Binaries — Zero-dependency TechScript_TX.exe for seamless distribution
• ⌨️ Pro CLI Experience — New ASCII "TX" banner and refined interactive REPL
• 🎨 Visual Overhaul — Glowing icons for VS Code and enhanced file association visuals
• 🎮 use three_d module — Build full 3D scenes in 5 lines of TechScript
• 🛠️ New Developer Toolchain — tech fmt, tech lint, tech build, tech test

🚀 What Can TechScript Do?

📦 Installation

🏁 Quick Platform Reference

🪟 Install on Windows (Easy — No Terminal Needed!)

Option 1: Setup Wizard (Recommended)

1. Go to the 📥 Releases page
2. Download TechScript_v1.0.5_Setup.exe
3. Double-click it — it will install everything automatically!
4. Open PowerShell (Win + X → "Windows PowerShell") and type:

tech version

You should see: TechScript v1.0.5 🎉

What the installer does automatically:

• ✅ Puts TechScript_TX.exe on your computer
• ✅ Makes the tech command available everywhere in your terminal
• ✅ Registers .txs files so they know they belong to TechScript
• ✅ Installs the VS Code extension for syntax highlighting

Option 2: Using pip (Cross-Platform Wrapper)

pip install techscript-lang

🐧 Install on Linux (Ubuntu, Kali, Debian, Arch)

No Python required to install or run!

One-line installer:

curl -fsSL https://raw.githubusercontent.com/Tcode-Motion/techscript/main/scripts/install.sh | bash

Using APT (Debian/Ubuntu):

sudo apt update
sudo apt install techscript

🍎 Install on macOS

# Using Homebrew:
brew install tcode-motion/techscript/techscript

# OR use the one-line installer:
curl -fsSL https://raw.githubusercontent.com/Tcode-Motion/techscript/main/scripts/install.sh | bash

📱 Install on Android (Termux)

pkg update && pkg upgrade -y
pkg install python -y
pip install techscript-lang
tech version

Update:

pip install --upgrade techscript-lang

📖 See docs/TERMUX.md for the full Android guide.

🌍 Platform Support

✏️ Your First TechScript Program

Create a new file called hello.txs:

# This is a comment — the computer ignores it
say "Hello, World!"
say "I am learning TechScript!"
say "It is very easy to read 😊"

Run it:

tech run hello.txs

Output:

Hello, World!
I am learning TechScript!
It is very easy to read 😊

📖 Language Guide — From 0 to 100 🚀

🟢 Level 1: Core Basics

📦 Variables — Storing Information

A variable is like a box where you put something to use later.

# 'make' creates a new box called 'name' and puts "Alice" inside
make name = "Alice"

# 'keep' creates a CONSTANT — a box you can NEVER change
keep PI = 3.14159

# You can store numbers, text, lists, anything!
make age = 25
make items = [1, 2, 3, 4, 5]      # A list (like a shopping list)
make info = { "city": "Delhi" }    # A dictionary (like a phone book)

🖨️ Output — Talking to the User

say "Hello!"                        # Prints: Hello!
say "Name:", name                   # Prints: Name: Alice
say f"My name is {name}!"          # f-strings insert variables: My name is Alice!
say 10 + 5                          # Prints: 15

💬 Input — Asking the User a Question

make name = ask "What is your name? "
say f"Nice to meet you, {name}!"

🟡 Level 2: Logic & Control Flow

🔀 Conditions — Making Decisions

make age = 20

when age >= 18 {
    say "You are an adult!"
} or when age >= 13 {
    say "You are a teenager!"
} else {
    say "You are a child!"
}

🔁 Loops — Doing Things Repeatedly

each loop — do something for every item in a list:

# Count from 1 to 5
each i in 1..5 {
    say f"Count: {i}"
}

# Go through each item in a list
each fruit in ["apple", "banana", "mango"] {
    say f"I like {fruit}!"
}

repeat loop — keep doing something while a condition is true:

make x = 1
repeat x <= 5 {
    say x
    x = x + 1
}

stop and skip — fixed in v1.0.3!

each i in 1..10 {
    when i == 5 { stop }   # break out of the loop
    when i == 3 { skip }   # skip this iteration (continue)
    say i
}

🔍 New Operators — in and typeof (New in v1.0.3)

# 'in' operator — check if something is inside a list, string, map, or range
make fruits = ["apple", "banana", "mango"]
when "apple" in fruits {
    say "Found it!"
}
when "ello" in "Hello" {
    say "Substring found!"
}

# 'typeof' operator — get the type of any value
make x = 42
say typeof x         # int
make name = "Alice"
say typeof name      # str
make items = [1, 2]
say typeof items     # list

🟠 Level 3: Reusing Logic (Functions)

# 'build' creates a function. 'name' is the input it receives.
build greet(name, greeting = "Hello") {
    say f"{greeting}, {name}!"
}

# Call the function:
greet("Alice")             # Prints: Hello, Alice!
greet("Bob", "Hi there")  # Prints: Hi there, Bob!
greet("Charlie", "Hey")   # Prints: Hey, Charlie!

🔴 Level 4: Pro Features (OOP & Error Handling)

🏗️ Classes — Blueprints for Objects

model Dog {
    build init(self, name, breed) {
        self.name = name      # Every dog has a name
        self.breed = breed    # Every dog has a breed
    }
    build speak(self) {
        say f"{self.name} says: Woof! Woof!"
    }
    build info(self) {
        say f"{self.name} is a {self.breed}"
    }
}

make rex = Dog("Rex", "German Shepherd")
make buddy = Dog("Buddy", "Golden Retriever")

rex.speak()     # Rex says: Woof! Woof!
rex.info()      # Rex is a German Shepherd
buddy.speak()   # Buddy says: Woof! Woof!

⚠️ Error Handling — Catching Mistakes Gracefully

attempt {
    # Try to do this risky thing
    make result = 10 / 0      # Division by zero!
} catch err {
    # If anything goes wrong, come here instead of crashing
    say f"Oops! Something went wrong: {err.message}"
}

say "Program continues normally after the error!"

💎 Level 5: The Ecosystem (Special Modules)

🌐 use web — Build Full Websites

use web

make page = WebPage("My First Website")

page.style("body", {
    "background": "#0f0f11",
    "color": "#eeeeee",
    "font-family": "sans-serif",
    "text-align": "center",
    "padding": "60px"
})

page.script("""
    function sayHello() {
        alert('Hello from TechScript! 🐉');
    }
""")

page.body([
    page.h1("Welcome to My Website! 🐉"),
    page.p("This website was built 100% in TechScript."),
    page.p("No HTML. No CSS files. No React. Just TechScript!"),
    page.button("Click Me!", { "onclick": "sayHello()" })
])

page.run()

Run it:

tech run my_website.txs

Your browser opens automatically! Press Ctrl+C to stop the server.

🎮 use three_d — 3D Graphics (New in v1.0.5!)

use three_d

make s = scene.scene()
s.objects.append(scene.box("#e94560", 1.0))
scene.render(s)

That's all — a 3D scene in 5 lines. No OpenGL setup. No shader code.

⚡ Standard Library — 150+ Built-in Functions (New in v1.0.3)

TechScript v1.0.3+ ships with a massive built-in standard library. No internet imports needed — everything is baked into the binary.

🔢 math.* — 38+ Advanced Math Functions

say math.sin(3.14159)          # Sine
say math.cos(0)                # Cosine
say math.log(100, 10)          # Logarithm
say math.factorial(10)         # 3628800
say math.gcd(48, 18)           # 6
say math.mean([1, 2, 3, 4, 5]) # 3.0
say math.sqrt(144)             # 12.0
say math.TAU                   # 6.283185...

🔐 crypto.* — Real Cryptography

say crypto.sha256("hello")              # FIPS 180-4 SHA-256
say crypto.md5("hello")                 # MD5 hash
say crypto.base64_encode("TechScript")  # Base64 encode
say crypto.base64_decode("VGVjaFNjcmlwdA==") # Base64 decode

📄 json.* — JSON Encode / Decode

make data = { "name": "Alice", "age": 25 }
say json.encode(data)           # {"name":"Alice","age":25}
say json.encode_pretty(data)    # Pretty-printed JSON
make parsed = json.decode('{"x": 1}')
say parsed["x"]                 # 1

📁 fs.* — File System (20+ Functions)

fs.write("hello.txt", "Hello, World!")
say fs.read("hello.txt")         # Hello, World!
say fs.exists("hello.txt")       # true
fs.append("hello.txt", "\nMore!")
say fs.size("hello.txt")         # file size in bytes
say fs.list_dir(".")             # list files in current directory
fs.copy("hello.txt", "copy.txt")

💻 os.* — OS Integration (10+ Functions)

say os.name()                   # windows / linux / macos
say os.arch()                   # x86_64
say os.pid()                    # process ID
say os.env_get("PATH")          # read environment variable
os.system("echo Hello from OS!")
make result = os.popen("dir")   # capture command output

🎲 random.* — Random & UUID

say random.random()              # float between 0.0 and 1.0
say random.randint(1, 100)       # random integer
say random.uuid()                # UUID4 string
say random.choice(["a","b","c"]) # random item from list
make shuffled = random.sample([1,2,3,4,5], 3)

📅 date.* — Date & Time

say date.now()    # 2025-03-12 14:30:00
say date.year()   # 2025
say date.month()  # 3
say date.day()    # 12
say date.hour()   # 14
say date.minute() # 30
say date.unix()   # unix timestamp in seconds

🛠️ All CLI Commands

📋 All Example Programs

🎨 VS Code / Cursor Editor Extension

Get syntax highlighting, code snippets, and the 🐉 dragon file icon for .txs files:

Method 1 — Command line (fastest):

code --install-extension vscode-extension/techscript-1.0.5.vsix

Method 2 — Using the GUI:

1. Open VS Code
2. Press Ctrl+Shift+X to open Extensions
3. Click the ··· menu (top right of the Extensions panel)
4. Select "Install from VSIX..."
5. Choose vscode-extension/techscript-1.0.5.vsix

After installing, all your .txs files will have the dragon icon and coloured syntax! 🎨

📂 Folder Structure

techscript/
├── bin/              # Executables and installers (TechScript_TX.exe)
├── docs/             # Full Language Spec & Reference
├── examples/         # Ready-to-run sample projects (17+ files)
├── assets/           # Official icons and logos
├── scripts/          # install.sh for Linux/macOS
└── vscode-extension/ # techscript-1.0.5.vsix

🔄 The Evolution of TechScript: v1.0.1 → v1.0.2 → v1.0.3 → v1.0.5

✨ v1.0.5 Changelog — Cinema Edition

🚀 New Features

• use three_d module — Build real-time 3D scenes in 5 lines. scene.box(), scene.render(), and more
• Standalone Binary — TechScript_TX.exe, zero-dependency, no installer needed
• Pro CLI — New ASCII "TX" banner on startup, refined REPL experience
• Developer Toolchain:
  • tech fmt — Auto-prettify your code
  • tech lint — Find errors before you run
  • tech build — Compile to fast bytecode (.txc)
  • tech test — Run built-in unit tests
• Visual Overhaul — Glowing neon logo, enhanced VS Code file icons

✨ v1.0.3 Changelog — Security & Power Overhaul

🔐 Critical Safety Fixes

• Eliminated unsafe UB — The VM's bytecode decoder now uses safe TryFrom<u8> instead of unsafe { mem::transmute }. Corrupt bytecode produces a clean error, not a crash.
• Fixed Windows installer — setup.bat no longer destroys your PATH if it's over 1,024 characters. Now uses PowerShell's .NET API with no size limit.

✅ Language Features Fixed

• stop and skip now actually work — Previously break compiled to a return statement (completely wrong). Now emits a proper forward jump patched at loop end.
• in operator — x in list, x in map, "sub" in str, x in range now all work correctly.
• typeof x — Returns the actual type name string ("int", "str", "list", etc.)

⚡ New Features

• Inline Execution — tech eval "say 42" or tech "[[[say 42]]]" runs code instantly without a file
• 150+ Built-in Functions — Expanded stdlib: math.*, fs.*, os.*, json.*, crypto.*, date.*, random.*
• Android/Termux Guide — See docs/TERMUX.md

✨ v1.0.2 Changelog — The Rust Rebuild

The v1.0.1 version was built on top of a Python wrapper. While this made development easy, it introduced massive flaws:

1. The Python Flaw — Required users to install heavy Python environments just to run basic scripts.
2. The Speed Flaw — Python's dynamic interpretation caused severe bottlenecks. A 1,000,000-loop would choke natively.
3. The Crash Flaw — Basic errors like dividing by zero (10 / 0) would completely crash the transpiler instantly without warning.

The v1.0.2 Solution: We entirely deleted the Python runtime and rewrote the entire core architecture natively in Rust.

✨ v1.0.1 Changelog — What's New vs v1.0.0

📚 Documentation

👨‍💻 Made by Tcode-Motion

📄 License

MIT License — free to use, share, and modify. See LICENSE.

Crafted with 🐉 and 🦀 by Tcode-Motion