implements PR003
This commit is contained in:
@@ -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.
|
||||
Reference in New Issue
Block a user