mowascript/docs/east/00_intro.md

MowaScript language implementation

[[🌀Interslavic](../../00_intro.md)  ·  [🇺🇸 English](../en/00_intro.md)]


# Вступ (Introduction)

**MowaJS** — це експериментальна мова програмування з природним, слов’янським синтаксисом, що компілюється у JavaScript.

Його мета — зробити код ближчим до людської мови для носіїв слов’янських мов, зберігаючи при цьому всю потужність екосистеми JavaScript.

---

## ✨ Що таке MowaJS?

MowaJS – это транслятор (transpiler), позволяющий писать код с использованием украиноязычного, белорусскоязычного, русскоязычного или интерславянского синтаксиса. Он превращает `.mowa` файлы в обычный `.js` код.

> Наприклад:
> ```mowa
> функція привітати(ім’я) {
>   друкувати("Привіт, " + ім’я);
> }
> ```

> Компілюється у:
> ```js
> function привітати(ім’я) {
>   console.log("Привіт, " + ім’я);
> }
> ```

---

## 🎯 Мета проєкту

- Надати можливість писати код рідною мовою.
- Дослідити, як природна мова впливає на логіку та стиль програмування.
- Створити міст між мовами та культурами через синтаксис.
- по фану 🍄

---

## 🧭 Зашто JavaScript?

- JavaScript — основа модерного веба.
- Велика екосистема (npm, прегледачи, Node.js).
- Легка інтеграція з існуючими проєктами.
- MowaJS не замінює JS — він надбудова, яка додає новий "голос".

---

## 🌍 За кого је сей проект?

- Для початківців, яким важко освоїти англомовний синтаксис.
- Для викладачів, які хочуть пояснювати програмування зрозумілою мовою.
- Для розробників, які цікавляться лінгвістикою, синтаксисами та DSL.
- Для фанатів експериментальних мов програмування.

---

## 🚀 Актуалный статус

- [x] Підтримка базових конструкцій (`якщо`, `інакше`, `поки`, `функція`, `друкувати`)
- [x] Компіляція у JS
- [ ] Падтрымка ўсіх дыялектаў
- [ ] Глибока інтеграція з типами / TS
- [ ] Интерактивный playground
- [ ] Веб-редактор
- [x] npm-пакет `mowa`

---

## 🛠️ Прыклады выкарыстання

```mowa
функція квадрат(число) {
  повернути число * число;
}

друкувати(квадрат(5));