raizcode-ofc 1.10.0 → 1.10.2

package/README.md

@@ -1,13 +1,654 @@
-# 🌱 Raizcode (.rc)
-> A linguagem de programação brasileira, feita para quem pensa em português.
+<div align="center">
 
-![Raizcode Icon](https://raw.githubusercontent.com/SEU_USUARIO/raizcode/main/icons/raizcode-icon.png)
+# 🌱 Raizcode
 
-O **Raizcode** é uma linguagem independente, limpa e poderosa. Ela foi criada para eliminar as barreiras da programação, utilizando uma sintaxe intuitiva em português, sem a necessidade de chaves `{}` ou ponto e vírgula `;`.
+### A linguagem de programação brasileira, feita para quem pensa em português.
 
-## 🚀 Instalação
+[![npm](https://img.shields.io/npm/v/raizcode-ofc?label=npm&logo=npm)](https://www.npmjs.com/package/raizcode-ofc)
+[![downloads](https://img.shields.io/npm/dw/raizcode-ofc?label=downloads&logo=npm)](https://www.npmjs.com/package/raizcode-ofc)
+[![license](https://img.shields.io/npm/l/raizcode-ofc?label=licen%C3%A7a)](https://www.npmjs.com/package/raizcode-ofc)
 
-Instale o ecossistema Raizcode globalmente:
+**Simples para começar. Poderosa para evoluir. Brasileira desde a raiz.**
+
+</div>
+
+---
+
+## Sobre o projeto
+
+O **Raizcode** é uma linguagem de programação em português que transforma código `.rc` em JavaScript.
+
+Ela foi criada para reduzir a barreira de entrada na programação, usando comandos fáceis de ler, sem exigir chaves `{}` ou ponto e vírgula `;`.
+
+```rc
+mostrar "Olá, mundo!"
+```
+
+Resultado:
+
+```text
+Olá, mundo!
+```
+
+> **Pacote no npm:** `raizcode-ofc`  
+> **Comando no terminal:** `raizcode`
+
+---
+
+## Instalação
+
+É necessário ter o [Node.js](https://nodejs.org/) e o npm instalados.
+
+### Windows, Linux e macOS
+
+```bash
+npm install -g raizcode-ofc
+```
+
+No PowerShell, caso o comando `npm` seja bloqueado, use:
+
+```powershell
+npm.cmd install -g raizcode-ofc
+```
+
+Confira a instalação:
+
+```bash
+raizcode --version
+```
+
+Atualizar para a versão mais recente:
+
+```bash
+npm install -g raizcode-ofc@latest
+```
+
+---
+
+## Primeiro programa
+
+Crie um arquivo chamado `teste.rc`:
+
+```rc
+mostrar "Iniciando sistema Raizcode..."
+
+variavel criador = "Riquefla"
+
+se 10 > 5
+    mostrar "O criador é " + criador
+fim
+```
+
+Execute:
+
+```bash
+raizcode teste.rc
+```
+
+Saída esperada:
+
+```text
+Iniciando sistema Raizcode...
+O criador é Riquefla
+```
+
+---
+
+## Instalação no Termux
+
+Instale o Node.js:
+
+```bash
+pkg update
+pkg install nodejs
+```
+
+Instale o Raizcode:
+
+```bash
+npm install -g raizcode-ofc
+```
+
+Crie uma pasta para testar:
+
+```bash
+mkdir -p ~/raizcode
+cd ~/raizcode
+```
+
+Crie o arquivo com várias linhas:
+
+```bash
+cat > teste.rc <<'EOF'
+mostrar "Iniciando sistema Raizcode..."
+
+variavel criador = "Riquefla"
+
+se 10 > 5
+    mostrar "O criador é " + criador
+fim
+EOF
+```
+
+Confira as linhas:
+
+```bash
+cat -n teste.rc
+```
+
+Execute:
 
 ```bash
-npm install -g raizcode
+raizcode teste.rc
+```
+
+Para abrir projetos web no Termux sem tentar iniciar o navegador automaticamente:
+
+```bash
+raizcode app.rc --no-open
+```
+
+Depois acesse no navegador:
+
+```text
+http://127.0.0.1:3000
+```
+
+---
+
+## Sintaxe básica
+
+### Variáveis
+
+```rc
+variavel nome = "Rique"
+variavel idade = 35
+
+mostrar nome
+mostrar idade
+```
+
+Também é aceito sem o sinal `=`:
+
+```rc
+variavel nome "Rique"
+```
+
+### Constantes
+
+```rc
+constante PAIS = "Brasil"
+mostrar PAIS
+```
+
+### Alterar um valor
+
+```rc
+variavel pontos = 10
+definir pontos = 25
+
+mostrar pontos
+```
+
+### Condições
+
+```rc
+variavel idade = 18
+
+se idade >= 18
+    mostrar "Maior de idade"
+senao
+    mostrar "Menor de idade"
+fim
+```
+
+Com mais de uma condição:
+
+```rc
+variavel nota = 8
+
+se nota >= 9
+    mostrar "Excelente"
+senaose nota >= 7
+    mostrar "Aprovado"
+senao
+    mostrar "Reprovado"
+fim
+```
+
+### Valores lógicos
+
+```rc
+variavel ativo = verdadeiro
+variavel bloqueado = falso
+
+se ativo e nao bloqueado
+    mostrar "Acesso permitido"
+fim
+```
+
+Palavras disponíveis:
+
+| Raizcode | Significado |
+|---|---|
+| `verdadeiro` | verdadeiro |
+| `falso` | falso |
+| `nulo` | valor vazio |
+| `e` | condição AND |
+| `ou` | condição OR |
+| `nao` | negação |
+
+### Repetições
+
+```rc
+repetir 3 vezes
+    mostrar "Raizcode!"
+fim
+```
+
+```rc
+variavel contador = 0
+
+enquanto contador < 3
+    mostrar contador
+    definir contador = contador + 1
+fim
+```
+
+### Listas
+
+```rc
+lista linguagens = ["Raizcode", "JavaScript", "Python"]
+
+para cada linguagem em linguagens
+    mostrar linguagem
+fim
+```
+
+### Funções
+
+```rc
+funcao somar(a, b)
+    retornar a + b
+fim
+
+mostrar somar(5, 7)
+```
+
+### Comentários
+
+```rc
+// Esta linha é um comentário
+mostrar "Esta linha será executada"
+```
+
+---
+
+## Comandos disponíveis
+
+| Comando | Exemplo |
+|---|---|
+| Mostrar no terminal | `mostrar "Olá"` |
+| Criar variável | `variavel nome = "Rique"` |
+| Criar constante | `constante PI = 3.14` |
+| Alterar valor | `definir pontos = 20` |
+| Criar lista | `lista nomes = ["Ana", "Rique"]` |
+| Condição | `se idade >= 18` |
+| Condição alternativa | `senaose nota >= 7` |
+| Alternativa final | `senao` |
+| Repetição | `repetir 5 vezes` |
+| Enquanto | `enquanto contador < 10` |
+| Percorrer lista | `para cada item em lista` |
+| Criar função | `funcao somar(a, b)` |
+| Retornar valor | `retornar resultado` |
+| Parar repetição | `parar` |
+| Continuar repetição | `continuar` |
+| Fechar bloco | `fim` |
+
+---
+
+# Criando páginas web
+
+O Raizcode usa três arquivos com o mesmo nome:
+
+```text
+meu-site/
+├── app.rc     # lógica
+├── app.rcx    # estrutura
+└── app.rcc    # estilo
+```
+
+## 1. Estrutura — `app.rcx`
+
+```rc
+titulo "Meu primeiro site com Raizcode"
+subtitulo "Programação em português"
+texto "Clique no botão para testar."
+
+botao "Clique aqui" id "botaoTeste"
+botao "Aguardando clique..." id "resultado"
+```
+
+## 2. Estilo — `app.rcc`
+
+```rc
+estilo corpo
+    fundo: #0d0d0d
+    cor-texto: branco
+fim
+
+estilo raiz
+    largura-maxima: 700px
+    margem-interna: 32px
+    arredondado: 16px
+fim
+
+ao-passar-mouse elemento button
+    opacidade: 0.8
+fim
+```
+
+## 3. Lógica — `app.rc`
+
+```rc
+pagina "Meu primeiro site"
+
+ao_clicar "botaoTeste"
+    mostrar_tela "Raizcode funcionando!" em "resultado"
+fim
+```
+
+Execute:
+
+```bash
+raizcode app.rc
+```
+
+O Raizcode gera `app.html`, inicia um servidor local e mostra o endereço:
+
+```text
+http://127.0.0.1:3000
+```
+
+Usar outra porta:
+
+```bash
+raizcode app.rc 4000
+```
+
+Não abrir o navegador automaticamente:
+
+```bash
+raizcode app.rc --no-open
+```
+
+---
+
+## Estrutura visual `.rcx`
+
+| Comando | Exemplo |
+|---|---|
+| Título | `titulo "Minha página"` |
+| Subtítulo | `subtitulo "Bem-vindo"` |
+| Texto | `texto "Conteúdo da página"` |
+| Link | `link "Visitar" url "https://exemplo.com"` |
+| Imagem | `imagem "imagem.png"` |
+| Botão | `botao "Entrar" id "botaoEntrar"` |
+| Entrada | `entrada id "nome" dica "Digite seu nome"` |
+| Caixa | `caixa "cartao"` |
+| Fechar caixa | `fim` |
+
+Exemplo com caixa:
+
+```rc
+caixa "cartao"
+    titulo "Raizcode"
+    texto "Código em português."
+fim
+```
+
+---
+
+## Estilos `.rcc`
+
+Seletores disponíveis:
+
+```rc
+estilo corpo
+fim
+
+estilo raiz
+fim
+
+estilo classe cartao
+fim
+
+estilo id botaoEntrar
+fim
+
+estilo elemento button
+fim
+```
+
+Algumas propriedades em português:
+
+| Raizcode | CSS gerado |
+|---|---|
+| `fundo` | `background` |
+| `cor-texto` | `color` |
+| `tamanho-texto` | `font-size` |
+| `familia-fonte` | `font-family` |
+| `peso-fonte` | `font-weight` |
+| `margem` | `margin` |
+| `margem-interna` | `padding` |
+| `borda` | `border` |
+| `arredondado` | `border-radius` |
+| `largura` | `width` |
+| `altura` | `height` |
+| `exibir` | `display` |
+| `alinhar-itens` | `align-items` |
+| `justificar` | `justify-content` |
+| `espaco` | `gap` |
+| `sombra` | `box-shadow` |
+| `opacidade` | `opacity` |
+| `transicao` | `transition` |
+
+Cores nomeadas:
+
+```text
+preto
+branco
+cinza
+vermelho
+verde
+azul
+transparente
+verde-neon
+amarelo-neon
+azul-neon
+vermelho-neon
+```
+
+---
+
+## Integração com VS Code
+
+Instale o suporte aos arquivos `.rc`, `.rcx` e `.rcc`:
+
+```bash
+raizcode --setup
+```
+
+Depois reinicie o VS Code.
+
+A extensão adiciona:
+
+- Reconhecimento dos arquivos Raizcode.
+- Destaque de sintaxe disponível no pacote.
+- Tema de ícones do Raizcode.
+
+---
+
+## Opções da linha de comando
+
+```text
+raizcode arquivo.rc
+raizcode arquivo.rc 3000
+raizcode arquivo.rc --no-open
+raizcode arquivo.rc --estrito
+raizcode arquivo.rc --permitir-js
+raizcode --setup
+raizcode --version
+raizcode --help
+```
+
+### Modo estrito
+
+Recusa comandos que não fazem parte da linguagem:
+
+```bash
+raizcode teste.rc --estrito
+```
+
+### JavaScript avançado
+
+Para usar uma linha de JavaScript explicitamente:
+
+```rc
+js console.log("Executado pelo JavaScript");
+```
+
+O modo abaixo permite JavaScript puro sem o prefixo `js`, sendo recomendado apenas para testes:
+
+```bash
+raizcode teste.rc --permitir-js
+```
+
+---
+
+## Solução de problemas
+
+### `raizcode: command not found`
+
+Reinstale globalmente:
+
+```bash
+npm install -g raizcode-ofc
+```
+
+No Termux, atualize os comandos disponíveis:
+
+```bash
+hash -r
+```
+
+### PowerShell bloqueia o npm
+
+Use:
+
+```powershell
+npm.cmd install -g raizcode-ofc
+```
+
+### Arquivo não encontrado
+
+Entre na pasta correta:
+
+```bash
+cd caminho/do/projeto
+raizcode teste.rc
+```
+
+Ou use o caminho completo:
+
+```bash
+raizcode /sdcard/raizcode/teste.rc
+```
+
+### `SyntaxError: missing ) after argument list`
+
+Confira se cada comando está em uma linha separada:
+
+```bash
+cat -n teste.rc
+```
+
+O arquivo deve aparecer assim:
+
+```text
+1  mostrar "Iniciando..."
+2  variavel criador = "Riquefla"
+3  mostrar criador
+```
+
+---
+
+## Filosofia
+
+O Raizcode nasceu no Brasil para mostrar que programação também pode ser ensinada e escrita na nossa língua.
+
+Nossa missão é criar uma linguagem:
+
+- Fácil para quem está começando.
+- Útil para projetos reais.
+- Aberta para estudantes e desenvolvedores.
+- Preparada para web, aplicativos e jogos.
+- Capaz de representar a tecnologia brasileira no mundo.
+
+---
+
+## Próximos passos
+
+- [ ] Parser e árvore de sintaxe próprios.
+- [ ] Mensagens de erro ainda mais inteligentes.
+- [ ] Formatador automático.
+- [ ] Autocomplete no VS Code.
+- [ ] Playground online.
+- [ ] Gerenciador de pacotes.
+- [ ] Ferramentas para aplicativos e jogos.
+- [ ] Documentação em outros idiomas.
+
+---
+
+## Contribuindo
+
+Sugestões, correções e novas ideias são bem-vindas.
+
+Antes de enviar uma alteração:
+
+```bash
+npm test
+```
+
+Ao relatar um erro, informe:
+
+1. Sistema operacional.
+2. Versão do Node.js.
+3. Versão do Raizcode.
+4. Código `.rc` usado.
+5. Mensagem completa do erro.
+
+Confira as versões:
+
+```bash
+node --version
+raizcode --version
+```
+
+---
+
+## Licença
+
+Distribuído sob a licença **MIT**.
+
+---
+
+<div align="center">
+
+### 🌱 Raizcode
+
+**Programe do seu jeito. Pense na sua língua.**
+
+Criado no Brasil por **Riquefla**.
+
+</div>