oxentescript/README.md

🌴 A Linguagem de Programação dos Baianos com Tokens Coloquiais Brasileiros + Syntax Highlighting Colorido!

# 🌴 **OxenteScript**

A **primeira linguagem de programação brasileira** que mistura a cultura baiana com tokens coloquiais de todo o Brasil! 

## 🎨 **NOVIDADE: Syntax Highlighting Colorido!**

OxenteScript agora tem **cores lindas** em vários editores e ambientes:

- 🔴 **Tokens Baianos** (vermelho): `bora`, `massa`, `falaai`
- 🟢 **Tokens Brasileiros** (verde): `botaAí`, `fazAí`, `seLiga` 
- 🟡 **Strings** (amarelo): `"texto"`
- 🟣 **Números** (roxo): `123`
- ⚫ **Comentários** (cinza): `// comentário`

## 🚀 **Instalação**

```bash
# CLI global com cores
npm install -g oxentescript

# Ver tokens coloridos
oxente tokens

# Executar com código colorido
oxente run meu-programa.oxe
```

## 🎨 **Ambientes com Cores**

| Ambiente | Status | Como Usar |
|----------|--------|-----------|
| **VS Code** | ✅ | Copie `oxentescript-vscode/` para extensions |
| **Editor Web** | ✅ | Abra `oxentescript-web.html` |
| **Terminal** | ✅ | Use `oxente tokens`, `oxente exemplos` |
| **Vim/Neovim** | ✅ | Veja `CORES.md` |
| **Sublime** | ✅ | Veja `CORES.md` |

## 📖 **Sintaxe**

### **Tokens Baianos (Originais)**
- `bora` = function *(declarar função)*
- `massa` = let *(declarar variável)*
- `falaai` = console.log *(imprimir)*
- `seliga` = if *(condicional se)*
- `senao` = else *(condicional senão)*
- `laele` = for *(loop for)*
- `oxe` = while *(loop while)*
- `volta` = return *(retornar)*

### **Tokens Brasileiros (Novos)**
- `botaAí/botaAi` = let *(variável)*
- `éIssoMemo/issoMemo` = const *(constante)*
- `tantoFaz` = var *(variável var)*
- `fazAí/fazAi` = function *(função)*
- `tomaEssa` = return *(retornar)*
- `seLiga` = if *(se)*
- `oxente` = else *(senão)*
- `repeteco` = for *(repetir)*
- `ateQuando` = while *(enquanto)*
- `fazLogo` = do *(fazer)*

### **Operadores Coloquiais**
- `somaLogo` = + *(somar)*
- `tiraAí/tiraAi` = - *(subtrair)*
- `multiplica` = * *(multiplicar)*
- `parteMeio` = / *(dividir)*

## ✨ **Exemplo Colorido**

```oxentescript
// Exemplo básico baiano
bora exemplo() {
    falaai("🌴 Oxente! Bem-vindo!");
    
    massa nome = "Baiano";
    falaai("Olá,", nome);
    
    laele (massa i = 1; i <= 3; i++) {
        falaai("Contando:", i);
    }
}

// Exemplo com tokens brasileiros
fazAí calculadora() {
    botaAí a = 10;
    botaAí b = 5;
    
    seLiga (a > b) {
        falaai("A é maior!");
    } oxente {
        falaai("B é maior ou igual!");
    }
    
    tomaEssa a somaLogo b;
}

// Chamando as funções
exemplo();
falaai("Resultado:", calculadora());
```

## 🌐 **Editor Web Online**

Abra `oxentescript-web.html` no navegador para:
- ✅ **Syntax highlighting em tempo real**
- ✅ **Exemplos interativos**
- ✅ **Transpilação e execução**
- ✅ **Referência completa de tokens**

## 📱 **Uso em Editores Online**

### **Replit (Recomendado)**
```bash
# Criar projeto Node.js
npm install oxentescript

# Criar arquivo exemplo.oxe
bora teste() {
    falaai("Funcionando no Replit!");
}

# Executar
npx oxente run exemplo.oxe
```

### **CodeSandbox**
1. Template HTML/JavaScript
2. Cole o código de `oxentescript-web.html`
3. Ou use Node.js + `npm install oxentescript`

## 🛠️ **CLI Comandos**

```bash
# Ver todos os tokens com cores
oxente tokens

# Exemplos coloridos
oxente exemplos

# Executar arquivo
oxente run programa.oxe

# Ajuda
oxente ajuda

# Versão
oxente versao
```

## 🎯 **Teste Rápido**

```bash
# Teste as cores agora mesmo!
node teste-cores.js
```

## 📚 **Documentação Completa**

- **CORES.md** - Guia completo de syntax highlighting
- **src/examples/** - Exemplos de código
- **oxentescript-vscode/** - Extensão VS Code

## 🌍 **Links**

- **GitHub**: https://github.com/devxandef/oxentescript
- **NPM**: https://npmjs.com/package/oxentescript  
- **Demo Online**: Abra `oxentescript-web.html`

## 🤝 **Contribuindo**

1. Fork o projeto
2. Crie uma branch: `git checkout -b minha-feature`
3. Commit: `git commit -m 'Adicionando nova feature'`
4. Push: `git push origin minha-feature`
5. Abra um Pull Request

## 📄 **Licença**

MIT License - veja LICENSE para detalhes.

---

**Feito com 💚 pelos Baianos para o Brasil! 🇧🇷🌴**

*"Oxente, que linguagem massa!"* 😄