# СомонСкрипт

<div align="center">
  <img src="https://raw.githubusercontent.com/lindentechde/Somon-Script/main/images/somon-script-banner.png" alt="СомонСкрипт Баннер" width="500" style="max-width: 100%; height: auto;" />
</div>

**Забони барномарезии синфи истеҳсолот бо синтаксиси тоҷикӣ**

[![Версия](https://img.shields.io/npm/v/@lindentech/somon-script)](https://www.npmjs.com/package/@lindentech/somon-script)
[![Ҳолати Сохтан](https://img.shields.io/github/actions/workflow/status/lindentechde/Somon-Script/version-release.yml?branch=main&label=build)](https://github.com/lindentechde/Somon-Script/actions)
[![Пӯшиши Тест](https://img.shields.io/codecov/c/github/lindentechde/Somon-Script)](https://codecov.io/gh/lindentechde/Somon-Script)
[![Муваффақияти Намунаҳо](https://img.shields.io/github/actions/workflow/status/lindentechde/Somon-Script/version-release.yml?branch=main&label=examples&job=test)](https://github.com/lindentechde/Somon-Script/actions)
[![Иҷозатнома](https://img.shields.io/badge/license-Proprietary-red.svg)](LICENSE)

Забони барномарезии пурра бо хусусиятҳои муосири бехатарии навъ ва синтаксиси
кирилликаи тоҷикӣ, ки ба JavaScript-и беҳинашуда компил мешавад. Дар ҳоли ҳозир
дар мархилаи бета бо пӯшиши аъло ва хусусиятҳои ҳамаҷонибаи забон қарор дорад.

## 🗣️ **Забонҳои дигар**

- 🇺🇸 [English](README.md) - Забони асосӣ
- 🇹🇯 **Тоҷикӣ** - Забони модарӣ
- 🇷🇺 [Русский](README.ru.md) - Забони русӣ

---

## **Нест кардани монеаҳои забонӣ дар рушди нармафзор**

СомонСкрипт махсусан барои нест кардани монеаи забонӣ сохта шудааст, ки бисёре
аз барномарезони истеъдоднокро аз ифода кардани пурраи қобилиятҳои барномарезии
онҳо боздоштааст. Бо таъмини муҳити пурраи барномарезӣ дар хати кирилликаи
тоҷикӣ, СомонСкрипт ба барномарезон имкон медиҳад, ки дар забони модариашон фикр
кунанд, код нависанд ва ҳамкорӣ намоянд ва дар айни ҳол аз қувваи пурраи
парадигмаҳои муосири барномарезӣ истифода баранд.

Ин муносибати инноватсионӣ на танҳо фаҳмиши кодро беҳтар мекунад ва боркунии
когнитивиро кам мекунад, балки дарвозаҳоро барои насли навини барномарезон
мекушояд, ки акнун метавонанд ба экосистемаи ҷаҳонии нармафзор саҳм гузоранд, бе
он ки аз синтаксиси забони хориҷӣ маҳдуд шаванд.

---

## ✨ Чаро СомонСкриптро интихоб кунед?

### 🌍 **Нест кардани монеаҳои забонӣ дар барномарезӣ**

**Тавонманд кардани рушди забони модарӣ**

СомонСкрипт рушди нармафзорро инқилоб мекунад бо нест кардани монеаи асосии
забонӣ:

- **Табиӣ фикр кардан**: Алгоритмҳо ва мантиқи мураккабро дар шаклҳои забони
  модарӣ ифода кунед
- **Кам кардани боркунии когнитивӣ**: Қабати тарҷумаи ақлиро байни концепсия ва
  код нест кунед
- **Беҳтар кардани фаҳмиши код**: Коди худмуаррифшударо нависед, ки барои
  дастаҳои тоҷикзабон фавран хондашаванда аст
- **Суръат додан ба омӯхтан**: Барномарезони нав метавонанд ба консепсияҳои
  барномарезӣ тамаркуз кунанд, на ба синтаксиси хориҷӣ

### 🔒 **Бехатарии навъи синфи касбӣ**

Системи пешрафтаи таҳлили статикӣ бо хусусиятҳои бехатарии сатҳи TypeScript:

- Навъҳои иттиҳод ва буриш
- Навъҳои tuple бо хулосаи дарозӣ
- Мерос ва таркиби интерфейс
- Параметрҳои навъи умумӣ
- Ифодаҳои навъи шартӣ

### ⚡ **Ҳолати рушд**

- **100% Муваффақияти намунаҳо** - Ҳамаи 39 намуна бе хато компил ва иҷро
  мешаванд
- **98% Пӯшиши тест** - Маҷмӯи ҳамаҷонибаи тест бо 326+ ҳолати тест
- **Сифр хатои linting** - Кодбейси нигоҳдошташуда бо риоя кардани стандартҳои
  соҳавӣ
- **Архитектураи муосир** - Бо нақшаҳои архитектураи тоза сохта шудааст
- **Сифати бета** - Барои баҳогирӣ ва лоиҳаҳои ғайриҳассос омода

---

## 🚀 Шурӯъи зуд

### Насб

```bash
# NPM (тавсияшуда барои аксари корбарон)
npm install -g @lindentech/somon-script

# JSR (тавсияшуда барои лоиҳаҳои TypeScript)
npx jsr add @lindentechde/somon-script

# Ё дар лоиҳа истифода баред
npm install @lindentech/somon-script --save-dev
```

### Барномаи аввалини шумо

```bash
# Намунаи Салом ҷаҳон
echo 'чоп.сабт("Салом, ҷаҳон!");' > hello.som
somon run hello.som

# Мантиқи тиҷоратӣ бо бехатарии навъ
cat > calculator.som << 'EOF'
функсия ҷамъ(а: рақам, б: рақам): рақам {
    бозгашт а + б;
}

тағйирёбанда натиҷа = ҷамъ(5, 3);
чоп.сабт("Натиҷа: " + натиҷа);
EOF

somon run calculator.som
```

---

## 🎯 Хусусиятҳои забон

### **Забони асосӣ** ✅ 100% Пурра

```som
// Тағйирёбандаҳо бо хулосаи навъ
тағйирёбанда ном = "Дониёр";
собит МАКС_СИННУ_СОЛ: рақам = 120;

// Функсияҳо бо аннотсияҳои навъ
функсия ҳисоб_кардан(а: рақам, б: рақам): рақам {
    бозгашт а + б;
}
```

### **Барномарезии объектно-йӯналиш** ✅ 100% Пурра

```som
синф Ҳайвон {
    хосусӣ ном: сатр;

    конструктор(ном: сатр) {
        ин.ном = ном;
    }

    ҷамъиятӣ овоз_додан(): сатр {
        бозгашт "Садои умумӣ";
    }
}
```

---

## 🌍 Дастгирии касбӣ

### Хидматҳои техникӣ

- 💬
  [Муҳокимаҳои GitHub](https://github.com/lindentechde/Somon-Script/discussions) -
  Муҳокимаҳо ва саволу ҷавоб
- 🐛 [Мушкилот](https://github.com/lindentechde/Somon-Script/issues) -
  Гузоришҳои хатогӣ ва дархостҳои хусусият
- 📧 Почтаи электронӣ: **info@lindentech.de**

### Иштироки ҷомеа

СомонСкрипт таҳти иҷозатномаи хусусӣ амал мекунад ва саҳмгузориҳои мустақими код
қабул намекунад, аммо шумо метавонед:

- **🐛 Гузориш диҳед** дар бораи хатоҳо тавассути масъалаҳои GitHub
- **💡 Пешниҳод кунед** беҳбудиҳо ва хусусиятҳои нав
- **🤝 Кӯмак расонед** ба корбарони дигар
- **📚 Намунаҳо созед** ва дастурҳо нависед

---

## 📄 Иҷозатнома

**Иҷозатномаи хусусӣ** - [LICENSE](LICENSE) файлро барои тафсилот бинед.

СомонСкрипт нармафзори хусусии LindenTech IT Consulting мебошад. Истифода барои
мақсадҳои шахсӣ, таълимӣ ва тиҷоратӣ дар доираи шартҳои иҷозатнома иҷозат дода
мешавад.

---

## 🏢 Шарикии корхона

### **Дар ҳамкорӣ бо LindenTech IT Consulting сохта шудааст**

СомонСкрипт дар ҳамкорӣ бо [**LindenTech IT Consulting**](https://lindentech.de)
сохта шудааст - консалтинги пешбари технологияи корхона.

**Веб-сайт**: [lindentech.de](https://lindentech.de)  
**Тамос**: info@lindentech.de

---

<div align="center">

**СомонСкрипт** - _Барномарезии касбӣ бо синтаксиси маҳаллӣ_

[Веб-сайт](https://somoni-script.org) _(дар рушд)_ •
[GitHub](https://github.com/lindentechde/Somon-Script) • [Ҳуҷҷатгузорӣ](docs/) •
[Дастгирӣ](https://github.com/lindentechde/Somon-Script/discussions)

</div>
