ImplementadoContrato Normativo 0.1.0
Documentação Técnica — RFLang 0.1
Referência estruturada do subconjunto inicial congelado da RFLang 0.1 (aplicações console para windows-x86_64) e da arquitetura interna do compilador rfc.
1. Identidade de Arquivos, Projeto .rfp e Cabeçalhos
Todo projeto RFLang 0.1 é descrito por um arquivo .rfp (RF Project) com sintaxe própria (sem depender de JSON, YAML ou TOML). Todo arquivo-fonte .rfdeve iniciar obrigatoriamente com program Nome; (no entry point) oumodule caminho; (nos demais módulos).
project
{
name = "demo";
version = "0.1.0";
language = "RFLang-0.1";
};
application
{
kind = "console";
entry = "src/main.rf";
output = "dist/demo.exe";
};
target windows-x86_64
{
subsystem = "console";
};program Demo;
import std.io;
function Result<Int32, String> dividir(a: Int32, b: Int32)
{
if b == 0
{
return Err("divisão por zero");
};
return Ok(a \ b);
};
procedure main()
{
defer writeln("encerrando com cleanup LIFO");
valor: Int32 = dividir(84, 2)?;
writeln("Resultado:", valor);
exit(0);
};2. Matriz de Status do Compilador rfc (Pipeline 0.1)
A tabela abaixo reflete o estado real das fases do pipeline no repositório oficial:
| Fase | Componente / Pacote Go | Responsabilidade Técnica | Status |
|---|---|---|---|
| Fases 0 e 1 | internal/cli, source, diagnostics | CLI rfc, SourceManager, Spans 1-based e diagnósticos RFxxxx sem panic | Implementado |
| Fase 2 | internal/lexer | Tokenização case-insensitive das 33 palavras reservadas, literais e operadores (incluindo \ e **) | Implementado |
| Fase 3 | internal/ast, internal/parser | Pratt Parser com 14 níveis de precedência, validação de program/module, { em nova linha e ; | Implementado |
| Fases 4 e 5 | internal/project, symbols, resolver | Parser .rfp, grafo de módulos, detecção de ciclos (RF2004) e tabela de símbolos case-insensitive | Implementado |
| Fase 6 | internal/types, internal/sema | TypeArena internada por TypeID, inferência local, Option<T>, Result<T, E> e checagem semântica | Implementado |
| Fases 7 e 8 | internal/hir, mir, ownership | Desugaring HIR, checagem de move/borrow/escape e inserção determinística de defer e drop em ordem LIFO | Implementado |
| Fases 9 e 10 | internal/ir, internal/interpreter | RFLang IR em BasicBlocks, Verifier obrigatório, emissão .ir e Interpretador em memória (rfc run) | Implementado |
| Fases 11 a 16 | optimizer, backend/x86_64, coff, pe, runtime | Otimizador conservador, Machine IR Win64, emissor COFF interno, linker PE32+ e runtime nativo | Planejamento |
3. Comandos do Compilador rfc
rfc version
rfc new faturador
rfc check faturador
rfc run faturador
rfc emit ir --out=build/audit faturador
rfc explain types faturador
rfc explain ownership faturadorOs documentos normativos completos (docs/implementation-contract.md,docs/memory-model.md, docs/implementation-roadmap.md edocs/technical-references.md) estão versionados no repositório oficial no GitHub.