implements PR003

This commit is contained in:
2026-03-24 13:42:19 +00:00
parent 9ddfa19bf2
commit 96c5505c04
9 changed files with 531 additions and 137 deletions
@@ -1,35 +0,0 @@
# PR-002 - PBS AST Contract V1
## Briefing
Hoje o AST representa apenas funcoes, `let/return` e expressoes basicas.
A spec exige familias obrigatorias de declaracoes e metadados estaveis para parser, diagnosticos e lowering.
Este PR fecha o contrato estrutural do AST sem ainda resolver todas as regras semanticas.
## Target
- Specs:
- `docs/pbs/specs/11. AST Specification.md` (secoes 6, 7, 8, 9, 10)
- `docs/pbs/specs/3. Core Syntax Specification.md` (secoes 6, 7, 8, 9, 10)
- Codigo:
- `prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/ast/PbsAst.java`
- `prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/parser/PbsParser.java`
## Method
1. Remodelar o root para conter imports e uma lista de `TopDecl` em ordem de fonte.
2. Introduzir familias obrigatorias de declaracao (`fn`, `struct`, `contract`, `service`, `error`, `enum`, `callback`, `declare const`, `implements`).
3. Adicionar estruturas de tipo (unit, simple, optional, tuple nomeada, `Self`) e retorno (`plain`, `result`).
4. Garantir `file/start/end` em todos os nos consumidos por diagnostico/lowering.
5. Definir nos de erro/recovery explicitos para evitar AST permissivo.
## Acceptance Criteria
- Existe exatamente um root por arquivo com filhos em ordem deterministica.
- AST preserva identidade de declaracoes sem colapsar overload cedo.
- Cada declaracao obrigatoria possui nome, assinatura/superficie e span.
- Parser recovery nao fabrica semantica valida; erros ficam marcados no AST.
- Precedencia e associatividade continuam observaveis pelo shape da arvore.
## Tests
- `PbsParserTest`:
- validacao de shape do root (`imports + topDecls`);
- cobertura de todas as familias de declaracao obrigatorias no AST;
- asserts de spans (`file/start/end`) em nos principais;
- fixture com erro e recovery garantindo estrutura coerente.
@@ -1,35 +0,0 @@
# PR-003 - PBS Parser Declarations and Type Surfaces
## Briefing
A sintaxe de declaracoes e tipos da spec e significativamente maior que o parser atual.
Este PR implementa a fatia de parser para declaracoes top-level e superficies de tipo/retorno, mantendo rejeicao deterministica das formas reservadas fora do contexto permitido.
## Target
- Specs:
- `docs/pbs/specs/3. Core Syntax Specification.md` (secoes 6.2, 7.1-7.6, 8)
- `docs/pbs/specs/11. AST Specification.md` (secao 8)
- Codigo:
- `prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/parser/PbsParser.java`
- `prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/parser/ParseErrors.java`
- `prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/ast/PbsAst.java`
## Method
1. Implementar parser de `declare struct/service/contract/error/enum/callback/const` e `implements`.
2. Trocar assinatura de funcao para retorno via `->` com normalizacao de unit e single-slot.
3. Implementar parser de `TypeRef` com `optional`, tuple nomeada e `Self`.
4. Rejeitar no parser formas reservadas de `declare host` e `declare builtin type` em modulos ordinarios.
5. Melhorar sincronizacao de recovery por contexto de declaracao.
## Acceptance Criteria
- Top-level parseia todas as declaracoes previstas em `TopDecl`.
- Retornos seguem formato normativo (`->`, `result<Err>`, `void`/`()`).
- `optional` e tuple nomeada em tipo sao parseados com shape correto.
- Formas invalidas de declaracao geram erro deterministico e parser continua.
- `declare host`/`declare builtin type` em codigo comum sao rejeitados explicitamente.
## Tests
- `PbsParserDeclarationsTest` novo cobrindo:
- cada declaracao valida (struct, service, contract, error, enum, callback, const, implements);
- erros de shape (enum misto implicito/explicito, retorno mal formado, optional invalido);
- rejeicao de `declare host` fora de superficie reservada;
- spans e recovery em declaracoes quebradas.