implements PR027

This commit is contained in:
2026-03-24 13:42:23 +00:00
parent 9fb8622ddb
commit bb5cc05c0b
12 changed files with 611 additions and 120 deletions
@@ -1,55 +0,0 @@
# PR-025 - PBS Interface-Module Semantics and Linking Rules
## Briefing
Depois de parsear forms reservadas, o frontend precisa validar regras semanticas especificas de interface modules e integrar host/builtin shells ao linking.
## Motivation
Sem essa etapa:
- declarations reservadas entram sem contrato semantico,
- host owners nao entram corretamente no namespace/linking,
- e o barrel contract para `host` nao fecha.
## Target
- Validadores semanticos (`declaration`, `flow` quando aplicavel).
- `PbsNamespaceBinder` e `PbsModuleVisibilityValidator`.
## Scope
- Validar restricoes declarativas de interface module (nao executavel, assinatura-only onde requerido).
- Validar posicionamento/shape de `Host`, `BuiltinType`, `BuiltinConst`, `IntrinsicCall`, `Slot`.
- Incluir host owners em namespace e linking (incluindo barrel host entry resolution).
## Method
- Adicionar caminho semantico para `SDK_INTERFACE` com regras de admissao dedicadas.
- Reusar estrutura de diagnosticos com codigos estaveis.
- Garantir ownership de fase para erros de linking vs static semantics.
## Acceptance Criteria
- `host` barrel entries resolvem quando `declare host` existe no modulo reservado.
- Violacoes de posicionamento/shape de attributes reservadas sao rejeitadas deterministicamente.
- Modulos ordinarios continuam com as regras atuais e sem regressao.
## Tests
- Fixtures positivos de interface module valido com host/builtin declarations.
- Fixtures negativos de attributes mal posicionadas e host/builtin invalido.
- Fixtures de linking para barrel host item resolvido e nao resolvido.
## Non-Goals
- Materializacao final de metadata no artifact/lowering.
- Politica completa de runtime capabilities.
## Affected Documents
- `docs/pbs/specs/4. Static Semantics Specification.md`
- `docs/pbs/specs/6.1. Intrinsics and Builtin Types Specification.md`
- `docs/pbs/specs/6.2. Host ABI Binding and Loader Resolution Specification.md`
- `docs/pbs/specs/12. Diagnostics Specification.md`
@@ -1,54 +0,0 @@
# PR-026 - PBS Minimal SDK Bootstrap with Core Color and Gfx Host Surface
## Briefing
Precisamos de um SDK minimo funcional para iniciar implementacao de builtins e validar o fluxo interface-module end-to-end.
Esta PR introduz um pacote minimo de modulos reservados com exemplo `Color` e `Gfx`.
## Motivation
Sem SDK minimo, o suporte a interface mode fica sem fixture real de uso.
Com ele, conseguimos exercitar import reservado, metadata, linking e base para lowering.
## Target
- Conteudo inicial do stdlib environment para linha v1.
- Modulos reservados `@core:*` e `@sdk:*` com superfícies declarativas minimas.
## Scope
- Criar modulo `@core:color` com shell builtin `Color` (e opcional `Pixel`) como exemplo.
- Criar modulo `@sdk:gfx` com `declare host Gfx` e assinatura anotada com `Host(...)`.
- Fornecer `mod.barrel` coerente para os modulos criados.
## Method
- Publicar fontes `.pbs` de interface module no armazenamento escolhido para stdlib bootstrap (ex.: resources).
- Manter tudo declarativo e nao executavel.
- Garantir nomes/cases/assinaturas pequenas, estaveis e didaticas para suite inicial.
## Acceptance Criteria
- Import de `Color` via `@core:color` resolve e participa do type namespace.
- Import de `Gfx` via `@sdk:gfx` resolve no host-owner namespace.
- Modulos do SDK minimo passam parser+semantica+linking de interface-module.
## Tests
- Fixture de compilacao que importa `Color` e usa em assinatura/tipo.
- Fixture de compilacao que importa `Gfx` e valida superficie host.
- Fixtures negativas de barrel inconsistente no SDK minimo.
## Non-Goals
- Cobertura completa de builtins do stdlib.
- Qualquer implementacao de comportamento runtime da API grafica.
## Affected Documents
- `docs/pbs/specs/5. Manifest, Stdlib, and SDK Resolution Specification.md`
- `docs/pbs/specs/6.1. Intrinsics and Builtin Types Specification.md`
- `docs/pbs/specs/6.2. Host ABI Binding and Loader Resolution Specification.md`
- `docs/pbs/specs/8. Stdlib Environment Packaging and Loading Specification.md`