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