feat(studio): integrate memcard persistence and headless controls
Persist cartridge identity and slot configuration, add MemcardBoot and the MemcardBuffer SDK, and consume the runtime's negotiated memcard host controls with protected teardown. Qualify save/reopen and version upgrades through distinct configured runtime processes. Include specs, examples, regression evidence and the consolidated discussion lesson.
This commit is contained in:
+2
-1
@@ -21,7 +21,8 @@ public record HostAdmissionContext(
|
||||
"fs",
|
||||
"log",
|
||||
"asset",
|
||||
"bank"));
|
||||
"bank",
|
||||
"memcard"));
|
||||
|
||||
public HostAdmissionContext {
|
||||
knownCapabilities = knownCapabilities == null || knownCapabilities.isEmpty()
|
||||
|
||||
+6
-2
@@ -250,7 +250,8 @@ public class IRBackend implements IRBackendReader {
|
||||
declaration.fileId(),
|
||||
remapLifecycleCallable(declaration.fileInitFragment(), moduleRemap, callableRemap),
|
||||
remapLifecycleCallable(declaration.projectInit(), moduleRemap, callableRemap),
|
||||
remapLifecycleCallable(declaration.frameRoot(), moduleRemap, callableRemap));
|
||||
remapLifecycleCallable(declaration.frameRoot(), moduleRemap, callableRemap),
|
||||
declaration.bootstrapCalls());
|
||||
}
|
||||
|
||||
private IRLifecycleCallableReference remapLifecycleCallable(
|
||||
@@ -349,6 +350,7 @@ public class IRBackend implements IRBackendReader {
|
||||
final var modules = new ArrayList<IRLifecycleModuleDeclaration>();
|
||||
IRLifecycleCallableReference projectInit = null;
|
||||
IRLifecycleCallableReference frameRoot = null;
|
||||
final var bootstrapCalls = new java.util.LinkedHashSet<IRBackendExecutableFunction.HostCallMetadata>();
|
||||
for (final var moduleId : lifecycleModuleOrder) {
|
||||
final var fragments = new ArrayList<IRLifecycleCallableReference>();
|
||||
var hasLifecycleContribution = false;
|
||||
@@ -357,6 +359,7 @@ public class IRBackend implements IRBackendReader {
|
||||
continue;
|
||||
}
|
||||
hasLifecycleContribution = true;
|
||||
bootstrapCalls.addAll(lifecycleFile.bootstrapCalls().asList());
|
||||
if (lifecycleFile.fileInitFragment() != null) {
|
||||
fragments.add(lifecycleFile.fileInitFragment());
|
||||
}
|
||||
@@ -371,7 +374,8 @@ public class IRBackend implements IRBackendReader {
|
||||
modules.add(new IRLifecycleModuleDeclaration(moduleId, ReadOnlyList.wrap(fragments)));
|
||||
}
|
||||
}
|
||||
return new IRLifecycleDeclaration(ReadOnlyList.wrap(modules), projectInit, frameRoot);
|
||||
return new IRLifecycleDeclaration(ReadOnlyList.wrap(modules), projectInit, frameRoot,
|
||||
ReadOnlyList.wrap(new ArrayList<>(bootstrapCalls)));
|
||||
}
|
||||
|
||||
private boolean sameModuleId(final ModuleId left, final ModuleId right) {
|
||||
|
||||
+7
-1
@@ -5,8 +5,14 @@ import p.studio.utilities.structures.ReadOnlyList;
|
||||
public record IRLifecycleDeclaration(
|
||||
ReadOnlyList<IRLifecycleModuleDeclaration> modules,
|
||||
IRLifecycleCallableReference projectInit,
|
||||
IRLifecycleCallableReference frameRoot) {
|
||||
IRLifecycleCallableReference frameRoot,
|
||||
ReadOnlyList<IRBackendExecutableFunction.HostCallMetadata> bootstrapCalls) {
|
||||
public IRLifecycleDeclaration(ReadOnlyList<IRLifecycleModuleDeclaration> modules,
|
||||
IRLifecycleCallableReference projectInit, IRLifecycleCallableReference frameRoot) {
|
||||
this(modules, projectInit, frameRoot, ReadOnlyList.empty());
|
||||
}
|
||||
public IRLifecycleDeclaration {
|
||||
modules = modules == null ? ReadOnlyList.empty() : modules;
|
||||
bootstrapCalls = bootstrapCalls == null ? ReadOnlyList.empty() : bootstrapCalls;
|
||||
}
|
||||
}
|
||||
|
||||
+10
-2
@@ -10,13 +10,21 @@ public record IRLifecycleFileDeclaration(
|
||||
FileId fileId,
|
||||
IRLifecycleCallableReference fileInitFragment,
|
||||
IRLifecycleCallableReference projectInit,
|
||||
IRLifecycleCallableReference frameRoot) {
|
||||
IRLifecycleCallableReference frameRoot,
|
||||
p.studio.utilities.structures.ReadOnlyList<IRBackendExecutableFunction.HostCallMetadata> bootstrapCalls) {
|
||||
public IRLifecycleFileDeclaration(ModuleId moduleId, FileId fileId,
|
||||
IRLifecycleCallableReference fileInitFragment, IRLifecycleCallableReference projectInit,
|
||||
IRLifecycleCallableReference frameRoot) {
|
||||
this(moduleId, fileId, fileInitFragment, projectInit, frameRoot,
|
||||
p.studio.utilities.structures.ReadOnlyList.empty());
|
||||
}
|
||||
public IRLifecycleFileDeclaration {
|
||||
moduleId = Objects.requireNonNull(moduleId, "moduleId");
|
||||
fileId = Objects.requireNonNull(fileId, "fileId");
|
||||
bootstrapCalls = bootstrapCalls == null ? p.studio.utilities.structures.ReadOnlyList.empty() : bootstrapCalls;
|
||||
}
|
||||
|
||||
public boolean isEmpty() {
|
||||
return fileInitFragment == null && projectInit == null && frameRoot == null;
|
||||
return fileInitFragment == null && projectInit == null && frameRoot == null && bootstrapCalls.isEmpty();
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user