# 🕌 UrduScript Programming Language

UrduScript brings the beauty of Urdu to coding — write expressive, native-language code with ease and elegance.

🎉 **Developed by: Atikin Verse**

---

## 📦 File Info

* **File Extension**: `.us`
* **CLI Tool**: `urduscript`
* **Based On**: JavaScript (internally)
* **Runs Using**: UrduScript interpreter
* **Native Output**: Urdu-only messages and logs

---

## 🌐 Urdu Keywords Translation

| 🧠 Urdu Keyword | 💻 JavaScript Equivalent |
| --------------- | ------------------------ |
| `کام`           | `function`               |
| `چھاپو()`       | `console.log()`          |
| `چلو`           | `let`                    |
| `مستقل`         | `const`                  |
| `اگر`           | `if`                     |
| `ورنہ اگر`      | `else if`                |
| `ورنہ`          | `else`                   |
| `جب تک`         | `while`                  |
| `کے لیے`        | `for`                    |
| `واپس کرو`      | `return`                 |
| `کلاس`          | `class`                  |
| `نیا`           | `new`                    |
| `آوائٹ کرو`     | `await`                  |
| `وعدہ`          | `Promise`                |
| `حل کرو`        | `resolve`                |
| `ناکام کرو`     | `reject`                 |

---

## 🚀 Features

| 🌟 خصوصیت          | وضاحت                                        |
| ------------------ | -------------------------------------------- |
| مکمل اردو نحو      | تمام کوڈ اردو زبان میں لکھا جاتا ہے۔         |
| اردو CLI           | `urduscript` CLI کے ذریعے .us فائلیں چلائیں۔ |
| تعلیمی دوستانہ     | نئے پروگرامرز کے لیے آسان اور سادہ۔          |
| JavaScript پر مبنی | اندرونی سطح پر JS پر مبنی مگر نظر نہیں آتا۔  |
| اردو میں نتائج     | تمام آؤٹ پٹ اردو میں ظاہر ہوتی ہے۔           |

---

## ✨ مثالیں

### 📄 hello.us

```us
کام شروع() {
  چھاپو("ہیلو دنیا!");
}
شروع();
```

### 🔢 variables.us

```us
کام شروع() {
  چلو پہلا = 5;
  چلو دوسرا = 10;
  چلو کل = پہلا + دوسرا;
  چھاپو("کل: " + کل);
}
شروع();
```

### 🔁 loop.us

```us
کام شروع() {
  چلو شمار = 1;
  جب تک (شمار <= 5) {
    چھاپو("شمار: " + شمار);
    شمار = شمار + 1;
  }
}
شروع();
```

### 📘 if-else.us

```us
کام شروع() {
  چلو نمبر = 80;
  اگر (نمبر >= 90) {
    چھاپو("بہترین!");
  } ورنہ اگر (نمبر >= 60) {
    چھاپو("اچھا!");
  } ورنہ {
    چھاپو("پاس!");
  }
}
شروع();
```

---

## ⚙️ انسٹالیشن

```bash
npm install -g urduscript
```

---

## 🧪 استعمال

### CLI کے ذریعے اردو اسکرپٹ فائل چلائیں:

```bash
urduscript path/to/file.us
```

مثال:

```bash
urduscript samples/hello.us
```

---

## 🔖 لائسنس

MIT License کے تحت فراہم کردہ۔

---

## 🧑‍💻 تخلیق کار

**Atikin Verse**
دل سے بنایا گیا — صرف برائے تعلیم اور زبان سے محبت کے لیے ❤️

---

## FOLLOW US ON For more information:

Join our social media for exciting updates, news, and insights! Follow us on :

<!--Table-->
| ACCOUNTS                 | USERNAME          |
|------------              | --------------    |
| FACEBOOK                 | atikinverse       |
| INSTAGRAM                | atikinverse       |
| LINKEDIN                 | atikinverse       |
| TWITTER (X)              | atikinverse       |
| THREADS                  | atikinverse       |
| PINTREST                 | atikinverse       |
| QUORA                    | atikinverse       |
| REDDIT                   | atikinverse       |
| TUMBLR                   | atikinverse       |
| SNAPCHAT                 | atikinverse       |
| SKYPE                    | atikinverse       |
| GITHUB                   | atikinverse       |

---

📬 کسی بھی رائے، مشورے یا تعاون کے لیے رابطہ کریں۔

**UrduScript — اردو اسکرپٹ زبان کے ساتھ خوشگوار کوڈنگ! 🚀**
