YaarScript

A slang-infused Urdu styled programming language that turns regular code into cool slang

Try Online Playground • Documentation • Examples • Actual Compiler

📖 Overview

YaarScript is a modern, professional programming language that brings the warmth and familiarity of the Urdu language to software development. Built with Rust and compiled to WebAssembly, YaarScript offers a unique blend of cultural accessibility and cutting-edge technology.

🎯 Key Highlights

🌍 Urdu-Inspired Syntax – Natural keywords like agar, warna, dohrao, bolo make coding intuitive for Urdu speakers
⚡ Lightning Fast – Entire compiler runs in the browser via WebAssembly (wasm32-unknown-unknown)
🔧 Industrial-Grade – Multi-pass compiler with fixed-point optimization, constant folding, and dead code elimination
🎨 Modern IDE – Professional web-based editor with syntax highlighting and real-time execution
🔒 Strong Type System – Strict typing with no implicit coercion for safer code
🚀 Zero Installation – Run directly in your browser with our online playground

✨ Features

🛠️ Compiler Architecture

YaarScript features a sophisticated multi-pass compilation pipeline:

Lexical Analysis – Tokenization with full Unicode support
Syntax Analysis – Top-Down Operator Precedence (Pratt) Parser
Semantic Analysis – Comprehensive scope management and type checking
IR Generation – Three-Address Code (TAC) intermediate representation
Optimization – Fixed-point optimization passes
Execution – High-performance WASM virtual machine

💡 Language Features

✅ Strong Type System – number, float, double, char, lafz (string), faisla (boolean)
✅ Control Flow – agar/warna (if/else), dohrao (for), jabtak (while), karo-jabtak (do-while)
✅ Switch Statements – intekhab with agar_ho cases
✅ Functions – First-class functions with return types
✅ Enumerations – qism for defining custom enums
✅ Constants – pakka for immutable values, sab_ke_liye for globals
✅ Operators – Full arithmetic, logical, and comparison operations
✅ Loop Control – bas_kar (break), aagay_baro (continue)

🚀 Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

Node.js (v18 or higher) – Download
Rust (for building compiler) – Install via rustup
wasm-pack (for WebAssembly compilation) – cargo install wasm-pack

Installation

Step 1: Build the WASM Compiler

# Clone the compiler repository (wasm-compiler branch)
git clone -b wasm-compiler https://github.com/YourUsername/YaarScript-Compiler.git
cd YaarScript-Compiler

# Build the WASM package
wasm-pack build --target web

# This generates a 'pkg' folder with the compiled WASM files

Step 2: Setup the Web Interface

# Clone the web client repository
git clone https://github.com/BazilSuhail/YaarScript-Client.git
cd YaarScript-Client

# Copy the compiled WASM package
# Copy the 'pkg' folder from the compiler to the client root directory

# Install dependencies
npm install

# Run the development server
npm run dev

Open http://localhost:3000 in your browser to see the application.

Directory Structure

YaarScript-Client/
├── pkg/                      # WASM compiled files (from compiler)
│   ├── compiler.js
│   ├── compiler_bg.wasm
│   └── ...
├── app/
│   ├── page.jsx             # Home page
│   ├── editor/              # Online code editor
│   └── docs/                # Documentation pages
├── components/
│   ├── home-page/           # Landing page components
│   ├── editor/              # Editor components
│   └── docs/                # Documentation components
├── public/                  # Static assets
└── package.json

📝 Quick Examples

Hello World

yaar {
    bolo("Assalam-o-Alaikum, World!\n");
}

Variables and Types

yaar {
    number age = 25;
    float price = 99.99;
    lafz name = "Ahmed";
    faisla is_valid = sahi;
    
    bolo("Name: ", name, "\n");
    bolo("Age: ", age, "\n");
}

Conditionals (agar/warna)

yaar {
    number score = 85;
    
    agar (score >= 90) {
        bolo("Grade: A\n");
    } warna agar (score >= 80) {
        bolo("Grade: B\n");
    } warna agar (score >= 70) {
        bolo("Grade: C\n");
    } warna {
        bolo("Grade: F\n");
    }
}

Loops (dohrao)

yaar {
    dohrao (number i = 0; i < 5; i++) {
        bolo("Iteration: ", i, "\n");
    }
}

Functions

number add(number a, number b) {
    wapsi a + b;
}

khaali greet(lafz name) {
    bolo("Hello, ", name, "!\n");
}

yaar {
    number sum = add(10, 20);
    bolo("Sum: ", sum, "\n");
    
    greet("YaarScript");
}

Switch Statement (intekhab)

yaar {
    number day = 3;
    
    intekhab (day) {
        agar_ho 1:
            bolo("Monday\n");
            bas_kar;
        agar_ho 2:
            bolo("Tuesday\n");
            bas_kar;
        agar_ho 3:
            bolo("Wednesday\n");
            bas_kar;
        aakhir:
            bolo("Other day\n");
    }
}

📚 Documentation

Data Types

Type	Description	Example
`number`	Integer values	`42`
`float`	Single precision	`3.14`
`double`	Double precision	`2.718281828`
`char`	Single character	`'A'`
`lafz`	String values	`"Hello"`
`faisla`	Boolean	`sahi`, `galat`
`khaali`	Void/Empty	Function return type

Keywords Reference

Keyword	English Equivalent	Usage
`yaar`	main	Main function entry point
`bolo`	print	Output to console
`agar`	if	Conditional statement
`warna`	else	Alternative branch
`dohrao`	for	For loop
`jabtak`	while	While loop
`karo`	do	Do-while loop
`intekhab`	switch	Switch statement
`agar_ho`	case	Case in switch
`aakhir`	default	Default case
`wapsi`	return	Return from function
`bas_kar`	break	Break loop/switch
`aagay_baro`	continue	Continue loop
`pakka`	const	Constant declaration
`sab_ke_liye`	global	Global scope
`qism`	enum	Enumeration
`sahi`	true	Boolean true
`galat`	false	Boolean false

Operators

Arithmetic: +, -, *, /, %
Comparison: ==, !=, >, <, >=, <=
Logical: &&, ||, !
Increment/Decrement: ++, --

🎮 Online Playground

Visit our Online Editor to start coding immediately without any installation. The playground features:

🎨 Syntax Highlighting – Clean, readable code editor
⚡ Instant Compilation – Real-time compilation and execution
📺 Live Terminal – See output as you code
💾 Auto-Save – Your code is saved automatically
🌙 Dark Theme – Easy on the eyes

🛠️ Development

Available Scripts

# Start development server
npm run dev

# Build for production
npm run build

# Start production server
npm start

# Lint code
npm run lint

Tech Stack

Frontend: Next.js 16.1, React 19.2, Tailwind CSS 4
Animations: Framer Motion
Backend Compiler: Rust (compiled to WASM)
Icons: React Icons
Code Editor: Custom implementation

🤝 Contributing

We welcome contributions from the community! Here's how you can help:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Areas for Contribution

🐛 Bug fixes and improvements
📝 Documentation enhancements
🎨 UI/UX improvements
🌐 Translations and localization
✨ New language features
🧪 Test coverage

🎯 Roadmap

📄 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

Built with ❤️ for the Urdu-speaking developer community
Powered by Rust and WebAssembly
UI framework by Next.js and React
Special thanks to all contributors and supporters

📧 Contact & Support

Website: YaarScript Official
GitHub Issues: Report a bug
Discussions: Join the conversation

Made with ❤️ by the YaarScript Team

⭐ Star this repo if you find it helpful! ⭐

Name		Name	Last commit message	Last commit date
Latest commit History 58 Commits
app		app
components		components
pkg		pkg
public		public
.gitignore		.gitignore
README.md		README.md
eslint.config.mjs		eslint.config.mjs
jsconfig.json		jsconfig.json
next.config.mjs		next.config.mjs
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs

BazilSuhail/YaarScript-Client

Folders and files

Latest commit

History

Repository files navigation