🚀 CDev Language

پشتیبانی رسمی CDev برای VS Code

---

🎯 CDev چیه؟

CDev یه زبان برنامه‌نویسیه که برای سادگی طراحی شده. با CDev می‌تونی:

• 🌐 وب‌سایت بسازی
• 💻 برنامه کنسولی بسازی
• 🎮 بازی 2D بسازی
• 📱 اپ موبایل بسازی (با خروجی APK)
• 🔌 REST API بسازی

---

✨ ویژگی‌های افزونه

• 🎨 Syntax Highlighting — رنگ‌بندی کامل کد CDev
• 🔮 Autocomplete — پیشنهاد خودکار تگ‌ها، توابع و کلمات کلیدی
• 📖 Hover Documentation — توضیح روی هر تگ یا تابع
• ⚠️ Diagnostics — خطایابی زنده (تگ بسته نشده، سینتکس اشتباه)
• ✂️ Snippets — قطعه‌کدهای آماده
• ▶️ Run — اجرای فایل با Ctrl+F5
• 🎯 آیکون اختصاصی — کنار فایل‌های .cv

---

🚀 شروع سریع

۱. یه فایل hello.cv بساز

<program>
    print("👋 سلام دنیا!");
</program>

۲. Ctrl+F5 بزن تا اجرا بشه

۳. یا توی ترمینال

cdev hello.cv

خروجی:

👋 سلام دنیا!

---

🏷️ پنج هدف CDev

تگ	کاربرد	خروجی
<web>	وب‌سایت	localhost:3000
<program>	برنامه کنسولی	ترمینال
<game>	بازی 2D	localhost:3000
<mobile>	اپ موبایل	APK
<api>	REST API	localhost:8080

---

📝 آموزش زبان CDev

۱. متغیرها

<program>
    name = "علی";
    age = 25;
    height = 1.75;
    isActive = true;
    empty = null;
</program>

انواع داده:

نوع	مثال
Number	x = 25
String	name = "علی"
Boolean	isActive = true
Null	x = null
Array	[1, 2, 3]
Object	{ name: "علی" }

۲. چاپ در کنسول

<program>
    print("سلام");
    print(123);
    
    name = "علی";
    age = 25;
    
    print("اسم من " + name + " است");
    print("سن من " + age + " ساله");
</program>

۳. عملیات ریاضی

<program>
    a = 10;
    b = 3;
    
    print(a + b);    // 13
    print(a - b);    // 7
    print(a * b);    // 30
    print(a / b);    // 3.333...
    print(a % b);    // 1
</program>

عملگرهای مقایسه:

<program>
    print(5 == 5);    // true
    print(5 != 3);    // true
    print(5 > 3);     // true
    print(5 < 3);     // false
    print(5 >= 5);    // true
    print(5 <= 3);    // false
</program>

عملگرهای منطقی:

<program>
    print(true && false);   // false
    print(true || false);   // true
    print(!true);           // false
</program>

۴. شرط‌ها

<program>
    age = 20;
    
    if age >= 18 {
        print("بزرگسال");
    } else {
        print("کودک");
    }
</program>

if / else if / else:

<program>
    score = 85;
    
    if score >= 90 {
        print("عالی");
    } else if score >= 70 {
        print("خوب");
    } else if score >= 50 {
        print("متوسط");
    } else {
        print("ضعیف");
    }
</program>

۵. حلقه‌ها

for ... in:

<program>
    fruits = ["سیب", "موز", "پرتقال"];
    
    for fruit in fruits {
        print(fruit);
    }
</program>

for با range:

<program>
    for i in 1..5 {
        print(i);
    }
    // 1, 2, 3, 4, 5
</program>

while:

<program>
    i = 0;
    while i < 5 {
        print(i);
        i = i + 1;
    }
</program>

break و continue:

<program>
    for i in 1..10 {
        if i == 5 {
            break;      // خروج
        }
        print(i);
    }
    
    for i in 1..5 {
        if i == 3 {
            continue;   // رد کردن
        }
        print(i);
    }
</program>

۶. توابع

<program>
    fun add(a, b) {
        return a + b;
    }
    
    fun greet(name) {
        print("سلام " + name);
    }
    
    print(add(5, 3));   // 8
    greet("علی");       // سلام علی
</program>

تابع بازگشتی:

<program>
    fun factorial(n) {
        if n <= 1 {
            return 1;
        }
        return n * factorial(n - 1);
    }
    
    print(factorial(5));   // 120
</program>

۷. آرایه‌ها

<program>
    nums = [1, 2, 3, 4, 5];
    
    print(nums[0]);       // 1
    print(len(nums));     // 5
    
    push(nums, 6);
    print(nums);          // [1,2,3,4,5,6]
    
    pop(nums);
    print(nums);          // [1,2,3,4,5]
    
    print(sort([3,1,4,1,5]));    // [1,1,3,4,5]
    print(reverse([1,2,3]));     // [3,2,1]
</program>

۸. آبجکت‌ها

<program>
    user = {
        name: "علی",
        age: 25,
        email: "ali@example.com"
    };
    
    print(user.name);       // علی
    print(user.age);        // 25
    
    user.age = 26;
    print(user.age);        // 26
    
    print(keys(user));      // ["name", "age", "email"]
</program>

---

🎯 مثال‌های کامل

💻 ماشین‌حساب (<program>)

<program>
    name = "ماشین‌حساب";
    
    fun add(a, b) { return a + b; }
    fun sub(a, b) { return a - b; }
    fun mul(a, b) { return a * b; }
    fun div(a, b) {
        if b == 0 { return "خطا"; }
        return a / b;
    }
    
    print("=== " + name + " ===");
    print("10 + 5 = " + add(10, 5));
    print("10 - 5 = " + sub(10, 5));
    print("10 × 5 = " + mul(10, 5));
    print("10 ÷ 5 = " + div(10, 5));
</program>

🌐 وب‌سایت فروشگاه (<web>)

<web>
    title = "فروشگاه من";
    port = 3000;
    
    products = [
        { name: "لپ‌تاپ", price: 12000000 },
        { name: "موبایل", price: 8000000 }
    ];
    
    <header>
        <text value="🛍️ فروشگاه" size=32 color="#ffffff"></text>
    </header>
    
    <body>
        for product in products {
            <card>
                <text value="product.name" size=20 color="#6366f1"></text>
                <text value="product.price" size=16></text>
                <button value="خرید" color="#10b981"></button>
            </card>
        }
    </body>
    
    <footer>
        <text value="© 2025" size=14></text>
    </footer>
</web>

🎮 بازی توپ متحرک (<game>)

<game>
    title = "بازی من";
    width = 800;
    height = 600;
    
    ball = { x: 400, y: 300, vx: 5, vy: 3, radius: 30 };
    
    fun update() {
        ball.x = ball.x + ball.vx;
        ball.y = ball.y + ball.vy;
        
        if ball.x > 770 || ball.x < 30 {
            ball.vx = -ball.vx;
        }
        if ball.y > 570 || ball.y < 30 {
            ball.vy = -ball.vy;
        }
    }
    
    fun draw() {
        circle(ball.x, ball.y, ball.radius, "#6366f1");
    }
</game>

📱 اپ یادداشت (<mobile>)

<mobile>
    name = "یادداشت‌بردار";
    notes = ["خرید شیر", "تماس با علی", "مطالعه کتاب"];
    
    fun addNote() {
        push(notes, "یادداشت جدید");
    }
    
    fun deleteNote(note) {
        remove(notes, note);
    }
    
    <screen>
        <text value="📝 یادداشت‌ها" size=24></text>
        
        <list>
            for note in notes {
                <row>
                    <text value="note" size=16></text>
                    <button value="❌" color="#ef4444"></button>
                </row>
            }
        </list>
        
        <button value="➕ جدید" color="#10b981"></button>
    </screen>
</mobile>

🔌 REST API (<api>)

<api>
    port = 8080;
    base = "/api";
    
    users = [
        { id: 1, name: "علی" },
        { id: 2, name: "مریم" }
    ];
    
    route GET "/users" {
        return users;
    }
    
    route GET "/users/1" {
        return users[0];
    }
    
    route POST "/users" {
        return { ok: true, message: "موفق" };
    }
    
    route DELETE "/users/1" {
        return { ok: true };
    }
</api>

---

🛠️ توابع داخلی

آرایه:

len(arr)                 // طول
push(arr, value)         // اضافه
pop(arr)                 // حذف آخرین
remove(arr, value)       // حذف مقدار
sort(arr)                // مرتب‌سازی
reverse(arr)             // برعکس
slice(arr, start, end)   // برش
concat(a, b)             // ادغام
range(start, end)        // ساخت آرایه

آبجکت:

keys(obj)                // کلیدها
values(obj)              // مقدارها

تبدیل نوع:

str(123)                 // "123"
num("123")               // 123
type(value)              // "number" | "string" | "array" | "object"

رشته:

split("a,b", ",")        // ["a", "b"]
join(["a","b"], ",")     // "a,b"
upper("hi")              // "HI"
lower("HI")              // "hi"
trim("  hi  ")           // "hi"
replace("hi", "h", "H")  // "Hi"
contains("hello", "ell") // true

ریاضی:

Math.abs(-5)             // 5
Math.floor(3.7)          // 3
Math.ceil(3.2)           // 4
Math.round(3.5)          // 4
Math.random()            // عدد تصادفی
Math.max(1, 2, 3)        // 3
Math.min(1, 2, 3)        // 1
Math.pow(2, 3)           // 8
Math.sqrt(16)            // 4
Math.PI                  // 3.14159...

---

⌨️ کلیدهای میانبر

کلید	کار
Ctrl+F5	اجرای فایل CDev
Ctrl+Space	Autocomplete
F12	Go to Definition
Ctrl+Shift+P → CDev: Run File	اجرا از Command Palette

---

📦 نصب CLI

برای اجرای فایل‌ها از ترمینال، CLI CDev رو نصب کن:

npm install -g cdev-lang

چک نصب:

cdev --help

---

📚 آموزش کامل

آموزش کامل زبان CDev (از صفر تا پیشرفته):

👉 مشاهده آموزش کامل

---

🤝 مشارکت

خوشحال می‌شیم که کمک کنی!

1. ⭐ Star کن
2. 🐛 Bug Report بده
3. 💡 Feature Request بده
4. 🔧 Pull Request بفرست

---

📞 ارتباط

• 🐛 گزارش باگ: GitHub Issues
• 💬 بحث و سوال: GitHub Discussions
• 📧 ایمیل: alarm.kian@hotmail.com
• 🎯 Marketplace: CDev Language

---

📄 لایسنس

MIT © 2025 ZeroStudio

---

🌟 اگه CDev رو دوست داری، یه ⭐ بده! 🌟

ساخته شده با ❤️ توسط ZeroStudio