Studio scene pack contract for runtime SCENE binary payload

This commit is contained in:
2026-05-01 06:59:42 +01:00
parent 1182d3ae1f
commit 822e892c82
61 changed files with 120404 additions and 685 deletions
@@ -1,4 +1,16 @@
declare host LowComposer {
[Host(module = "composer", name = "set_camera", version = 1)]
[Capability(name = "gfx")]
fn set_camera(x: int, y: int) -> void;
[Host(module = "composer", name = "bind_scene", version = 1)]
[Capability(name = "gfx")]
fn bind_scene(scene_bank_id: int) -> int;
[Host(module = "composer", name = "unbind_scene", version = 1)]
[Capability(name = "gfx")]
fn unbind_scene() -> int;
[Host(module = "composer", name = "emit_sprite", version = 1)]
[Capability(name = "gfx")]
fn emit_sprite(
@@ -16,6 +28,21 @@ declare host LowComposer {
declare service Composer
{
fn set_camera(x: int, y: int) -> void
{
LowComposer.set_camera(x, y);
}
fn bind_scene(scene_bank_id: int) -> int
{
return LowComposer.bind_scene(scene_bank_id);
}
fn unbind_scene() -> int
{
return LowComposer.unbind_scene();
}
fn emit_sprite(
glyph_id: int,
palette_id: int,
@@ -116,6 +116,16 @@ class PbsGateUSdkInterfaceConformanceTest {
&& h.abiModule().equals("gfx")
&& h.abiMethod().equals("clear")
&& h.abiVersion() == 1));
assertTrue(positive.irBackend().getReservedMetadata().hostMethodBindings().stream()
.anyMatch(h -> h.ownerName().equals("LowComposer")
&& h.abiModule().equals("composer")
&& h.abiMethod().equals("bind_scene")
&& h.abiVersion() == 1));
assertTrue(positive.irBackend().getReservedMetadata().hostMethodBindings().stream()
.anyMatch(h -> h.ownerName().equals("LowComposer")
&& h.abiModule().equals("composer")
&& h.abiMethod().equals("unbind_scene")
&& h.abiVersion() == 1));
assertTrue(positive.irBackend().getReservedMetadata().hostMethodBindings().stream()
.anyMatch(h -> h.ownerName().equals("LowComposer")
&& h.abiModule().equals("composer")
@@ -103,6 +103,14 @@ class InterfaceModuleLoaderTest {
"main.pbs",
"""
declare host LowComposer {
[Host(module = "composer", name = "bind_scene", version = 1)]
[Capability(name = "gfx")]
fn bind_scene(scene_bank_id: int) -> int;
[Host(module = "composer", name = "unbind_scene", version = 1)]
[Capability(name = "gfx")]
fn unbind_scene() -> int;
[Host(module = "composer", name = "emit_sprite", version = 1)]
[Capability(name = "gfx")]
fn emit_sprite(
@@ -119,6 +127,14 @@ class InterfaceModuleLoaderTest {
}
declare service Composer {
fn bind_scene(scene_bank_id: int) -> int {
return LowComposer.bind_scene(scene_bank_id);
}
fn unbind_scene() -> int {
return LowComposer.unbind_scene();
}
fn emit_sprite(
glyph_id: int,
palette_id: int,
@@ -1069,6 +1069,85 @@ class PBSFrontendPhaseServiceTest {
&& h.abiMethod().equals("emit_sprite")));
}
@Test
void shouldLowerSdkComposerSceneBindingFacadesUsingCanonicalComposerContract() throws IOException {
final var projectRoot = tempDir.resolve("project-bootstrap-sdk-composer-scene-binding");
final var sourceRoot = projectRoot.resolve("src");
final var modulePath = sourceRoot.resolve("app");
Files.createDirectories(modulePath);
final var sourceFile = modulePath.resolve("source.pbs");
final var modBarrel = modulePath.resolve("mod.barrel");
Files.writeString(sourceFile, """
import { Composer } from @sdk:composer;
fn bind_scene_now() -> int
{
return Composer.bind_scene(4);
}
fn unbind_scene_now() -> int
{
return Composer.unbind_scene();
}
[Frame]
fn frame() -> void
{
bind_scene_now();
unbind_scene_now();
return;
}
""");
Files.writeString(modBarrel, """
pub fn bind_scene_now() -> int;
pub fn unbind_scene_now() -> int;
pub fn frame() -> void;
""");
final var projectTable = new ProjectTable();
final var fileTable = new FileTable(1);
final var projectId = projectTable.register(ProjectDescriptor.builder()
.rootPath(projectRoot)
.name("app")
.version("1.0.0")
.sourceRoots(ReadOnlyList.wrap(List.of(sourceRoot)))
.build());
registerFile(projectId, projectRoot, sourceFile, fileTable);
registerFile(projectId, projectRoot, modBarrel, fileTable);
final var ctx = new FrontendPhaseContext(
projectTable,
fileTable,
new BuildStack(ReadOnlyList.wrap(List.of(projectId))),
1);
final var diagnostics = DiagnosticSink.empty();
final var irBackend = new PBSFrontendPhaseService().compile(
ctx,
diagnostics,
LogAggregator.empty(),
BuildingIssueSink.empty());
assertFalse(diagnostics.hasErrors(), diagnostics.stream()
.map(d -> d.getCode() + ":" + d.getMessage())
.toList()
.toString());
assertTrue(diagnostics.stream().noneMatch(d ->
d.getCode().equals(PbsSemanticsErrors.E_SEM_EXEC_LOWERING_UNRESOLVED_CALLEE.name())));
assertTrue(irBackend.getReservedMetadata().hostMethodBindings().stream()
.anyMatch(h -> h.ownerName().equals("LowComposer")
&& h.sourceMethodName().equals("bind_scene")
&& h.abiModule().equals("composer")
&& h.abiMethod().equals("bind_scene")));
assertTrue(irBackend.getReservedMetadata().hostMethodBindings().stream()
.anyMatch(h -> h.ownerName().equals("LowComposer")
&& h.sourceMethodName().equals("unbind_scene")
&& h.abiModule().equals("composer")
&& h.abiMethod().equals("unbind_scene")));
}
@Test
void shouldRejectLegacyGfxSetSpriteAfterComposerMigration() throws IOException {
final var projectRoot = tempDir.resolve("project-bootstrap-sdk-gfx-set-sprite-removed");