treste 2.0.0

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+All notable changes to Trest Language will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.0.0] - 2024-11-01
+
+**Desenvolvido por:** PoktWeb  
+**Documentação:** https://trest-site.vercel.app
+
+### Added
+- ✨ Enhanced npm package configuration with proper installation scripts
+- 🛠️ Pre-install and post-install validation scripts
+- 📝 Improved CLI with verbose and debug modes
+- 🔍 Better error handling and logging
+- 📦 Proper .npmignore configuration
+- 📄 LICENSE file (MIT)
+- 🎯 Engine requirements validation (Node >= 18, npm >= 9)
+- 🌍 Multi-platform support (Windows, Linux, macOS)
+- 🏷️ Version management scripts
+
+### Changed
+- 📚 Updated README with comprehensive installation instructions
+- 🔧 Improved CLI error messages with emoji indicators
+- 📊 Enhanced compiler output with detailed statistics
+- 🎨 Better user experience with colored output
+
+### Fixed
+- 🐛 Fixed bin paths in package.json
+- 🔧 Corrected post-build script paths
+- ✅ Improved TypeScript compilation
+
+## [1.0.0] - Initial Release
+
+### Added
+- 🎉 Initial release of Trest Language
+- 🔤 Cyrillic support for keywords
+- 🌐 Web compilation (JavaScript output)
+- 💻 Executable compilation (.exe output)
+- 📚 Standard library (Math, String, Array, IO)
+- 📦 Module system (import/export)
+- 🔄 Error handling (try/catch/throw)
+- 🎯 Variables, functions, loops, conditions
+- 📖 Complete documentation
+

package/INSTALL.md

@@ -0,0 +1,264 @@
+# 📦 Guia de Instalação - Trest Language
+
+Este guia fornece instruções detalhadas para instalar e usar o Trest Language em diferentes cenários.
+
+## 📋 Pré-requisitos
+
+Antes de instalar o Trest, certifique-se de ter:
+
+- **Node.js** >= 18.0.0
+- **npm** >= 9.0.0
+
+Verifique suas versões:
+```bash
+node --version
+npm --version
+```
+
+Se você não tem o Node.js instalado, baixe em: https://nodejs.org/
+
+## 🚀 Instalação
+
+### Opção 1: Instalação Global (Recomendado)
+
+Instale o Trest globalmente para ter acesso aos comandos `trest` e `trestc` em qualquer lugar:
+
+```bash
+npm install -g trest-language
+```
+
+**Verifique a instalação:**
+```bash
+trest --version
+trestc --version
+```
+
+**Uso:**
+```bash
+trest arquivo.trest
+trestc arquivo.trest --mode web
+```
+
+### Opção 2: Instalação Local em Projeto
+
+Para usar o Trest apenas em um projeto específico:
+
+```bash
+npm install trest-language
+```
+
+**Uso via npx:**
+```bash
+npx trest arquivo.trest
+npx trestc arquivo.trest --mode web
+```
+
+### Opção 3: Instalação a partir do Código Fonte
+
+Se você quer contribuir ou customizar o Trest:
+
+```bash
+# Clone o repositório
+git clone https://github.com/trest-language/trest.git
+cd trest
+
+# Instale as dependências
+npm install
+
+# Compile o projeto
+npm run build
+
+# (Opcional) Linke globalmente para testes
+npm link
+```
+
+## 🎯 Verificação da Instalação
+
+Após instalar, teste com um arquivo de exemplo:
+
+```bash
+# Verificar versão
+trest --version
+
+# Ver ajuda
+trest --help
+
+# Executar exemplo
+trest exemplos/hello_cyrillic.trest
+```
+
+## 🔧 Configuração
+
+### Arquivo de Configuração
+
+O Trest cria automaticamente um arquivo `.trestrc` na primeira execução:
+
+```json
+{
+  "version": "2.0.0",
+  "compiler": {
+    "web": {
+      "minify": false,
+      "bundle": true
+    },
+    "exe": {
+      "minify": false,
+      "standalone": true
+    }
+  },
+  "runtime": {
+    "strictMode": false,
+    "debugMode": false
+  }
+}
+```
+
+### Variáveis de Ambiente (Opcional)
+
+Você pode configurar variáveis de ambiente:
+
+```bash
+# Modo debug global
+export TREST_DEBUG=true
+
+# Caminho para módulos std customizados
+export TREST_STD_PATH=/caminho/para/std
+```
+
+## 🐛 Resolução de Problemas
+
+### Erro: "command not found: trest"
+
+**Causa:** Instalação global não funcionou ou PATH não está configurado.
+
+**Solução:**
+```bash
+# Reinstalar globalmente
+npm install -g trest-language
+
+# Verificar local de instalação global
+npm config get prefix
+
+# Adicionar ao PATH (Linux/Mac)
+export PATH=$PATH:$(npm config get prefix)/bin
+```
+
+### Erro: "Node version too old"
+
+**Causa:** Versão do Node.js é menor que 18.
+
+**Solução:** Atualize o Node.js:
+```bash
+# Usando nvm (recomendado)
+nvm install 18
+nvm use 18
+
+# Ou baixe do site oficial
+# https://nodejs.org/
+```
+
+### Erro: "Permission denied"
+
+**Causa:** Sem permissões para instalar globalmente.
+
+**Soluções:**
+
+**Linux/Mac:**
+```bash
+# Usar sudo (não recomendado)
+sudo npm install -g trest-language
+
+# Ou configurar npm para não usar sudo
+mkdir ~/.npm-global
+npm config set prefix '~/.npm-global'
+export PATH=~/.npm-global/bin:$PATH
+```
+
+**Windows:** Execute o PowerShell como Administrador
+
+### Binários não encontrados após build
+
+**Solução:**
+```bash
+# Limpar e reconstruir
+npm run clean
+npm run build
+
+# Verificar se os arquivos existem
+ls dist/cli.js dist/compiler.js
+```
+
+## 🔄 Atualização
+
+Para atualizar para a versão mais recente:
+
+```bash
+# Global
+npm update -g trest-language
+
+# Local
+npm update trest-language
+
+# Verificar versão
+trest --version
+```
+
+## 🗑️ Desinstalação
+
+Para remover o Trest:
+
+```bash
+# Desinstalar globalmente
+npm uninstall -g trest-language
+
+# Desinstalar localmente
+npm uninstall trest-language
+```
+
+## 📚 Próximos Passos
+
+Depois de instalar, consulte:
+
+- [README.md](README.md) - Visão geral do projeto
+- [docs/README.md](docs/README.md) - Documentação completa
+- [docs/guide.md](docs/guide.md) - Guia de início rápido
+- [docs/examples.md](docs/examples.md) - Exemplos de código
+
+## 💡 Dicas
+
+1. **Use `--verbose`** para ver detalhes da execução:
+   ```bash
+   trest arquivo.trest --verbose
+   ```
+
+2. **Use `--debug`** para debugging detalhado:
+   ```bash
+   trest arquivo.trest --debug
+   ```
+
+3. **Use `--strict`** para erros mais informativos:
+   ```bash
+   trest arquivo.trest --strict
+   ```
+
+4. **Para compilação de produção:**
+   ```bash
+   trestc app.trest --mode web --minify
+   ```
+
+## 🤝 Contribuindo
+
+Veja [CONTRIBUTING.md](CONTRIBUTING.md) para informações sobre como contribuir.
+
+## 📞 Suporte
+
+Se você encontrar problemas:
+
+1. Verifique a seção de resolução de problemas acima
+2. Consulte as [issues no GitHub](https://github.com/trest-language/trest/issues)
+3. Abra uma nova issue se necessário
+
+## 📄 Licença
+
+MIT - veja [LICENSE](LICENSE) para mais detalhes.
+

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Trest Language Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,388 @@
+# Trest - Язык программирования с поддержкой кириллицы
+
+Современный язык программирования, профессионально структурированный и компилируемый для **Web** и **Desktop (.exe)** с полной поддержкой кириллицы (русский алфавит).
+
+> **📖 Версия на португальском:** Для документации на португальском используйте ключевые слова на португальском (se, enquanto, funcao, и т.д.) или смотрите примеры в папке `exemplos/`.
+
+## 🚀 Основные возможности
+
+- ✅ **Компиляция для Web** - Генерирует оптимизированный JavaScript
+- ✅ **Компиляция для Desktop** - Создает нативные исполняемые файлы .exe
+- ✅ **Система модулей** - Импорт/Экспорт модулей
+- ✅ **Стандартная библиотека** - std с математическими функциями, строками, массивами и I/O
+- ✅ **Обработка ошибок** - Расширенный Try/Catch/Throw
+- ✅ **Синтаксис на кириллице** - Ключевые слова на русском языке
+- ✅ **Динамическая типизация** - Типы выводятся автоматически
+- ✅ **Система сборки** - Профессиональные инструменты компиляции
+
+## 📦 Установка
+
+### Установка через npm (рекомендуется)
+
+**Глобальная установка:**
+```bash
+npm install -g trest-language
+```
+
+После установки команды `trest` и `trestc` будут доступны глобально:
+```bash
+trest --version
+trestc --help
+```
+
+**Локальная установка в проект:**
+```bash
+npm install trest-language
+```
+
+Используйте через `npx`:
+```bash
+npx trest programa.trest
+npx trestc programa.trest --mode web
+```
+
+### Установка из исходников
+
+Если вы хотите установить из исходников или внести изменения:
+
+```bash
+# Клонировать репозиторий
+git clone https://github.com/trest-language/trest.git
+cd trest
+
+# Установить зависимости
+npm install
+
+# Собрать проект
+npm run build
+
+# (Опционально) Создать симлинки для глобального использования
+npm link
+```
+
+### Требования
+
+- **Node.js**: >= 18.0.0
+- **npm**: >= 9.0.0
+- **TypeScript**: 5.0+ (для разработки)
+
+Проверьте вашу версию:
+```bash
+node --version  # должно быть >= v18
+npm --version   # должно быть >= 9
+```
+
+## 🎯 Быстрый старт
+
+### Запуск напрямую (интерпретатор)
+```bash
+npm start exemplos/hello_cyrillic.trest
+# или
+trest exemplos/hello_cyrillic.trest
+```
+
+### Компиляция для Web (JavaScript)
+```bash
+npm run compile:web -- exemplos/hello_cyrillic.trest
+# или
+trestc exemplos/hello_cyrillic.trest --mode web --output app.js
+```
+
+### Компиляция для исполняемого файла (.exe)
+```bash
+npm run compile:exe -- exemplos/hello_cyrillic.trest
+# или
+trestc exemplos/hello_cyrillic.trest --mode exe --output app.exe
+```
+
+## 📚 Синтаксис языка
+
+### Переменные
+
+```trest
+перем имя = "Trest"
+пусть возраст = 25
+конст pi = 3.14159
+```
+
+### Функции
+
+```trest
+функция сложить(a, b) {
+    вернуть a + b
+}
+
+пусть результат = сложить(5, 3)
+печать(результат)
+```
+
+### Условия
+
+```trest
+если (возраст >= 18) {
+    печать("Совершеннолетний")
+} иначе {
+    печать("Несовершеннолетний")
+}
+```
+
+### Циклы
+
+**Пока:**
+```trest
+пусть i = 0
+пока (i < 10) {
+    печать(i)
+    i = i + 1
+}
+```
+
+**Для:**
+```trest
+для (пусть i = 0; i < 10; i = i + 1) {
+    печать(i)
+}
+```
+
+### Обработка ошибок
+
+```trest
+попытаться {
+    пусть результат = разделить(10, 0)
+} перехватить (ошибка) {
+    печать("Ошибка:", ошибка)
+} наконец {
+    печать("Операция завершена")
+}
+```
+
+### Модули
+
+**Импорт:**
+```trest
+импорт { max, min } из "std/math"
+импорт * как Math из "std/math"
+```
+
+**Экспорт:**
+```trest
+экспорт функция мояФункция() {
+    вернуть "Привет"
+}
+
+экспорт конст константа = 42
+```
+
+### Объекты
+
+```trest
+пусть человек = {
+    имя: "Иван",
+    возраст: 30,
+    город: "Москва"
+}
+
+печать(человек.имя)  # "Иван"
+```
+
+### Массивы
+
+```trest
+пусть числа = [1, 2, 3, 4, 5]
+печать(числа[0])  # 1
+
+числа[0] = 10
+печать(числа)  # [10, 2, 3, 4, 5]
+```
+
+## 📖 Стандартная библиотека (std)
+
+### Math
+
+```trest
+импорт * как Math из "std/math"
+
+пусть x = Math.abs(-5)      # 5
+пусть y = Math.max(10, 20)  # 20
+пусть z = Math.sqrt(16)     # 4
+пусть pi = Math.PI          # 3.14159...
+```
+
+### String
+
+```trest
+импорт * как String из "std/string"
+
+пусть текст = "Привет Мир"
+пусть размер = String.размер(текст)      # 11
+пусть верхний = String.верхний(текст)  # "ПРИВЕТ МИР"
+```
+
+### Array
+
+```trest
+импорт * как Array из "std/array"
+
+пусть arr = [1, 2, 3]
+Array.добавить(arr, 4)      # [1, 2, 3, 4]
+пусть обратный = Array.обратить(arr)  # [4, 3, 2, 1]
+пусть отсортированный = Array.отсортировать([3, 1, 2])  # [1, 2, 3]
+```
+
+### IO
+
+```trest
+импорт * как IO из "std/io"
+
+пусть содержимое = IO.читатьФайл("файл.txt")
+IO.писатьФайл("выход.txt", "Содержимое")
+пусть существует = IO.существуетФайл("файл.txt")
+```
+
+## 🏗️ Структура проекта
+
+```
+treste/
+├── src/
+│   ├── lexer.ts          # Лексический анализатор
+│   ├── parser.ts         # Синтаксический анализатор
+│   ├── ast.ts            # Определения AST
+│   ├── interpreter.ts   # Интерпретатор
+│   ├── compiler.ts      # CLI компилятора
+│   ├── compiler/
+│   │   ├── web.ts        # Компилятор для Web
+│   │   └── exe.ts        # Компилятор для исполняемого файла
+│   ├── std/              # Стандартная библиотека
+│   │   ├── math.trest
+│   │   ├── string.trest
+│   │   ├── array.trest
+│   │   └── io.trest
+│   ├── types.ts          # Система типов
+│   ├── errors.ts         # Обработка ошибок
+│   └── module.ts         # Система модулей
+├── exemplos/             # Примеры программ
+├── dist/                 # Скомпилированный код
+└── package.json
+```
+
+## 🔧 Доступные скрипты
+
+```bash
+npm run build          # Компилировать TypeScript
+npm run build:watch     # Компилировать в режиме наблюдения
+npm start <файл>       # Запустить файл Trest
+npm run compile:web    # Компилировать в JavaScript
+npm run compile:exe     # Компилировать в исполняемый файл
+npm run bundle         # Создать исполняемый bundle
+```
+
+## 📝 Ключевые слова
+
+### Кириллица (Русский) - Основной синтаксис
+| Trest | Эквивалент |
+|-------|------------|
+| `если` | if |
+| `иначе` | else |
+| `пока` | while |
+| `для` | for |
+| `функция` | function |
+| `вернуть` | return |
+| `перем`, `пусть`, `конст` | var, let, const |
+| `печать` | print/console.log |
+| `импорт` | import |
+| `экспорт` | export |
+| `из` | from |
+| `попытаться` | try |
+| `перехватить` | catch |
+| `бросить` | throw |
+| `наконец` | finally |
+| `прервать` | break |
+| `продолжить` | continue |
+| `истина` | true |
+| `ложь` | false |
+
+### Português (Latino) - Alternativa
+| Trest | Equivalente |
+|-------|-------------|
+| `se` | if |
+| `senao` | else |
+| `enquanto` | while |
+| `para` | for |
+| `funcao` | function |
+| `retorne` | return |
+| `var`, `let`, `const` | var, let, const |
+| `imprima` | print/console.log |
+| `importe` | import |
+| `exporte` | export |
+| `de` | from |
+| `tente` | try |
+| `capture` | catch |
+| `lance` | throw |
+| `finalmente` | finally |
+| `quebre` | break |
+| `continue` | continue |
+| `verdadeiro` | true |
+| `falso` | false |
+
+## 🌐 Компиляция для Web
+
+Компилятор для web генерирует современный JavaScript, который может использоваться в:
+- Браузерах (через `<script>` или bundler)
+- Node.js
+- React/Vue/Angular
+- Любой JavaScript-среде
+
+**Пример:**
+```bash
+trestc программа.trest --mode web --output app.js
+```
+
+## 💻 Компиляция для исполняемого файла
+
+Компилятор для исполняемого файла создает `.exe` файл, который:
+- Не требует установленного Node.js
+- Автономен (включает все зависимости)
+- Запускается напрямую в Windows
+
+**Пример:**
+```bash
+trestc программа.trest --mode exe --output app.exe
+```
+
+## 🎓 Примеры
+
+Смотрите папку `exemplos/` для полных программ, демонстрирующих:
+- Базовые операции
+- Функции и замыкания
+- Структуры управления
+- Массивы и объекты
+- Модули и импорты
+- Обработку ошибок
+
+**Примеры на кириллице:**
+- `exemplos/hello_cyrillic.trest` - Привет Мир
+- `exemplos/variaveis_cyrillic.trest` - Переменные
+- `exemplos/condicional_cyrillic.trest` - Условные операторы
+- `exemplos/loop_cyrillic.trest` - Циклы
+- `exemplos/funcao_cyrillic.trest` - Функции
+- `exemplos/completo_cyrillic.trest` - Полный пример
+
+**Примеры на португальском:**
+- `exemplos/hello.trest` - Olá Mundo
+- `exemplos/variaveis.trest` - Variáveis
+- И другие...
+
+## 📄 Лицензия
+
+MIT
+
+## 👤 Автор
+
+**PoktWeb**
+
+- Сайт документации: [https://trest-site.vercel.app](https://trest-site.vercel.app)
+- GitHub: [@poktweb](https://github.com/poktweb)
+
+## 🤝 Вклад
+
+Вклады приветствуются! Не стесняйтесь открывать issues и pull requests.