TirotirLang برای VS Code

اکستنشن مستقل VS Code برای زبان فارسی تیروتیر با شناسهٔ tirotirLang است. پسوند رسمی فایل‌ها .t است؛ فایل‌های قدیمی .tirotir در CLI برای سازگاری پذیرفته می‌شوند.

امکانات

• شناسایی فایل‌های .t به‌عنوان پسوند رسمی
• رنگ‌بندی کلیدواژه‌ها، اعداد فارسی، متن و کامنت
• تنظیم تورفتگی بلوک‌ها
• فرمان اجرای فایل
• اجرای تعاملی غیرمسدودکننده با stdin واقعی برای دستور بخوان
• فرمان بررسی نحوی
• نمایش AST در ترمینال VS Code
• پنل خروجی فارسی راست‌به‌چپ با WebView
• نمایش زندهٔ SVG در WebView پس از هر اجرا، بدون ساخت فایل دائمی کنار source
• اجرای برنامه‌های Creative Mode و تولید SVG
• فرمان‌های جداگانهٔ Graphics، Audio و GUI
• پشتیبانی از شناسه‌های فارسی
• ۱۴ اسنیپت آموزشی فارسی؛ با نوشتن prefix و فشردن Tab

تنظیمات زبان و یک completion provider پشتیبان، نمایش اسنیپت‌ها و Tab completion را برای فایل‌های .t فعال می‌کند. اگر نسخهٔ قبلی افزونه نصب است، ابتدا آن را از Extensions حذف کنید، VSIX نسخهٔ 2.0.6 را نصب کنید و سپس Developer: Reload Window را اجرا کنید. در فایل .t باید language mode پایین پنجره TirotirLang باشد؛ سپس با Ctrl+Space نیز می‌توان فهرست پیشنهادها را باز کرد.

نصب از کد منبع

در پوشهٔ این اکستنشن اجرا کنید:

npm install -g @vscode/vsce
vsce package

سپس فایل .vsix ساخته‌شده را در VS Code نصب کنید:

1. Ctrl+Shift+P
2. انتخاب Extensions: Install from VSIX...
3. انتخاب فایل tirotirlang-2.0.6.vsix

یا از خط فرمان:

code --install-extension tirotirlang-2.0.6.vsix

پیش‌نیاز اجرای برنامه

باید CLI تیروتیر نصب و در PATH باشد:

py -3.11 -m pip install tirotir==2.0.1
tirotir version

اگر فرمان tirotir در PATH نیست، در تنظیمات VS Code مقدار زیر را به مسیر کامل فایل اجرایی تغییر دهید:

{
  "tirotirLang.command": "C:\\Users\\YOUR_USER\\AppData\\Local\\Programs\\Python\\Python313\\Scripts\\tirotir.exe"
}

روی فایل .t راست‌کلیک کنید و یکی از فرمان‌های زیر را انتخاب کنید:

• TirotirLang: اجرای فایل
• TirotirLang: بررسی فایل
• TirotirLang: نمایش AST
• TirotirLang: اجرای زنده در پنل فارسی راست‌به‌چپ
• TirotirLang: نمایش Graphics زنده
• TirotirLang: پخش Audio
• TirotirLang: اجرای GUI

ساخت فایل جدید از Status Bar

وقتی یک فایل ذخیره‌شدهٔ .t فعال باشد، دکمهٔ فایل .t جدید فقط در Status Bar پایین VS Code نمایش داده می‌شود. با کلیک روی آن، افزونه فایل جدید را در همان پوشه روی دیسک می‌سازد و باز می‌کند.

شماره‌گذاری از اولین نام آزاد ادامه پیدا می‌کند:

program-001.t
program-002.t
program-003.t

فایل‌های قبلی حذف یا بازنویسی نمی‌شوند. این دکمه در WebView، منوی راست‌کلیک و نوار عنوان قرار ندارد.

فرمان «اجرای زنده در پنل فارسی راست‌به‌چپ» برنامه را در یک فرایند جداگانه و غیرمسدودکننده با spawn اجرا می‌کند. stdout و stderr به‌صورت زنده در WebView نمایش داده می‌شوند و هر خطی که در کادر ورودی ارسال شود با UTF-8 به stdin همان فرایند می‌رود. برای دریافت و استفاده از پاسخ، از نحو واقعی expression استفاده کنید:

چاپ -نامت چیست؟-
بگذار نام برابر بخوان
چاپ نام

خودِ statement بخوان ورودی را مصرف می‌کند و مقدار را برنمی‌گرداند؛ برای ذخیرهٔ پاسخ باید آن را در expression مانند مثال بالا به متغیر نسبت دهید. بستن پنل یا دکمهٔ «توقف» فرایند را لغو می‌کند. Graphics با پروتکل JSON داخلی --live-scene از اجرای همان لحظه دریافت می‌شود و SVG مستقیماً در WebView render می‌شود؛ در اجرای معمول، فایل SVG کنار source ساخته نمی‌شود. فایل export فقط با اجرای CLI و گزینهٔ --scene تولید می‌شود.