vladx 1.0.0

package/README.md

@@ -0,0 +1,256 @@
+# VladX
+
+Мощный интерпретируемый язык программирования с русским синтаксисом.
+
+## Особенности
+
+- 🚀 Высокая производительность с JIT компиляцией
+- 🔒 Безопасность с изоляцией песочницы
+- 🏗️ Расширенная система типов
+- ⚡ Мощная асинхронность
+- 🧩 Современная модульная система
+- 🧪 Встроенная поддержка тестирования
+- 🔬 Отладчик и профилировщик
+- 📦 Управление пакетами через vladpm
+
+## Установка
+
+```bash
+npm install -g vladx
+```
+
+## Использование
+
+### Базовый пример
+
+```vlad
+пусть x = 10 + 5;
+печать("Результат:", x);
+```
+
+### Функции
+
+```vlad
+функция добавить(a, b) {
+    вернуть a + b;
+}
+
+печать("5 + 3 =", добавить(5, 3));
+```
+
+### Условия
+
+```vlad
+пусть возраст = 18;
+
+если (возраст >= 18) {
+    печать("Совершеннолетний");
+} иначе {
+    печать("Несовершеннолетний");
+}
+```
+
+### Циклы
+
+```vlad
+пока (возраст < 21) {
+    печать("Возраст:", возраст);
+    возраст = возраст + 1;
+}
+
+для (пусть i = 0; i < 5; i = i + 1) {
+    печать("Итерация:", i);
+}
+```
+
+### Асинхронность
+
+```vlad
+асинхронная функция fetchData() {
+    позволить ждать(1000);
+    вернуть "данные";
+}
+
+пусть данные = ждать fetchData();
+печать("Данные:", данные);
+```
+
+### Функциональное программирование
+
+```vlad
+пусть удвоить = (x) => x * 2;
+пусть утроить = (x) => x * 3;
+
+пусть составить = композиция(удвоить, утроить);
+печать("Составить(5) =", составить(5));
+```
+
+### Структуры данных
+
+```vlad
+пусть стек = Стек();
+стек.пуш(1);
+стек.пуш(2);
+печать("Pop:", стек.pop());
+
+пусть очередь = Очередь();
+очередь.enqueue(1);
+печать("Dequeue:", очередь.dequeue());
+```
+
+## Встроенные функции
+
+### Математика
+
+- `максимум(...)` - максимум
+- `минимум(...)` - минимум
+- `случайный()` - случайное число [0, 1]
+- `случайноеЦелое(min, max)` - случайное целое
+- `abs(n)` - модуль
+- `округлить(n)` - округление
+- `корень(n)` - квадратный корень
+- `пи()` - число π
+
+### Строки
+
+- `длина(str)` - длина строки
+- `нижнийРегистр(str)` - нижний регистр
+- `верхнийРегистр(str)` - верхний регистр
+- `обрезка(str)` - обрезать пробелы
+- `заменить(str, old, new)` - замена
+- `разделить(str, delimiter)` - разделение
+
+### Массивы
+
+- `создатьМассив(...)` - создать массив
+- `объединить(...arrays)` - объединение
+- `фильтр(arr, callback)` - фильтрация
+- `отобразить(arr, callback)` - map
+- `уменьшить(arr, callback, initial)` - reduce
+
+### Объекты
+
+- `объект(obj)` - создать объект
+- `ключи(obj)` - ключи
+- `значения(obj)` - значения
+- `пары(obj)` - пары
+- `слить(...objects)` - слияние
+
+### Система
+
+- `печать(...)` - вывод с новой строкой
+- `вывод(...)` - вывод без новой строки
+- `время()` - текущее время
+- `дата()` - текущая дата
+
+### Файлы
+
+- `файлЧитать(path)` - прочитать файл
+- `файлЗаписать(path, content)` - записать файл
+- `файлСуществует(path)` - проверка существования
+
+### Кэш
+
+- `кэшУстановить(key, value)` - установить в кэш
+- `кэшПолучить(key)` - получить из кэша
+- `кэшУдалить(key)` - удалить из кэша
+- `кэшОчистить()` - очистить кэш
+- `кэшСтатистика()` - статистика кэша
+
+### Функциональное программирование
+
+- `каррировать(fn)` - каррирование
+- `композиция(...fns)` - композиция
+- `труба(...fns)` - pipe
+- `мемоизировать(fn)` - мемоизация
+- `частично(fn, ...args)` - частичное применение
+
+### Структуры данных
+
+- `Стек()` - создать стек
+- `Очередь()` - создать очередь
+- `СвязныйСписок()` - создать связный список
+- `ПриоритетнаяОчередь(comparator)` - приоритетная очередь
+- `Множество()` - создать множество
+- `Карта()` - создать карту
+- `Дерево()` - создать trie
+- `БинарноеДерево(compareFn)` - бинарное дерево поиска
+
+### Асинхронность
+
+- `параллельно(tasks)` - параллельное выполнение
+- `последовательно(tasks)` - последовательное выполнение
+- `гонка(tasks)` - race
+- `всеSettled(tasks)` - allSettled
+- `любой(tasks)` - any
+
+## CLI
+
+```bash
+# Выполнить файл
+vladx run main.vx
+
+# REPL режим
+vladx repl
+
+# Компилировать в JavaScript
+vladx compile main.vx --output main.js
+
+# Линтинг
+vladx lint src/
+vladx lint main.vx --fix
+
+# Форматирование
+vladx format src/
+vladx format main.vx --indent 2
+
+# Тесты
+vladx test
+vladx test tests/
+
+# Сборка модулей
+vladx bundle main.vx --format iife --minify
+
+# Watch режим
+vladx watch main.vx
+
+# Отладка
+vladx debug main.vx
+```
+
+## Менеджер пакетов (vladpm)
+
+```bash
+# Инициализация проекта
+vladpm init
+
+# Установка пакета
+vladpm установить пакет
+vladpm установить пакет@1.0.0
+
+# Глобальная установка
+vladpm установить -g пакет
+
+# Удаление пакета
+vladpm удалить пакет
+
+# Обновление пакетов
+vladpm обновить
+
+# Поиск пакетов
+vladpm поиск пакет
+
+# Информация о пакете
+vladpm информация пакет
+
+# Список пакетов
+vladpm список
+
+# Публикация
+vladpm опубликовать
+```
+
+## Лицензия
+
+MIT
+