<< lib/sldocument/SLDocumentConverter.sleela SLeeLa Standard Library Definition. Definition: Defines SLDocumentConverter, which converts an ordered .sldocument into a .sleela program for safekeeping, naming any anonymous steps. When an engineer wants to keep an .sldocument as ordinary .sleela source, each ordered step must become a named method of a class, because .sleela is class/method shaped. The converter: 1. walks the document's steps in resolved order; 2. gives every step a stable .sleela method name via SLDocumentNaming (keeping explicit names, deriving from @function roles, or synthesizing "step003"-style names for anonymous steps); 3. checks the resulting names do not collide (via SLSourceNameComparison); 4. emits a .sleela class whose methods call the steps in a run() method, in the same top-down order, preserving the single-binary-value contract. The conversion is fail-closed: a name collision aborts rather than silently overwriting a method. The round trip preserves order and the veritable-and- kind return discipline. Family: sldocument. Native VM/OS work crosses an explicit bridge. >> #sleela 2.5 material; < Unified SLeeLa standard-library front-end object. > class SLDocumentConverter { < ---- Descriptive metadata (version 1.11 nested-friendly accessors) ---- > << Eleven catalogued attributes with getter/setter pairs, so a GUI, loader, or catalog can read and (where appropriate) override this record. Values are faithful to the subject's real origin where publicly known. >> String metaVersion = "1.0.0"; int metaId = 10071; String metaAuthor = "Kiro Agent"; String metaDate = "2026-10-16"; String metaCopyright = "SLeeLa project"; String metaTrademark = "none"; String metaCorporation = "none"; < metaOrigin: National | | International | Galactic > String metaOrigin = "International"; String metaBirthDate = "2026-10-05"; < metaScienceRating: maturity/robustness on a 1..10 scale > int metaScienceRating = 9; < metaNationalSchedule: a real, citable instrument or "none" > String metaNationalSchedule = "none"; String getMetaVersion() { return metaVersion; } void setMetaVersion(String v) { metaVersion = v; } int getMetaId() { return metaId; } void setMetaId(int v) { metaId = v; } String getAuthor() { return metaAuthor; } void setAuthor(String v) { metaAuthor = v; } String getDate() { return metaDate; } void setDate(String v) { metaDate = v; } String getCopyright() { return metaCopyright; } void setCopyright(String v) { metaCopyright = v; } String getTrademark() { return metaTrademark; } void setTrademark(String v) { metaTrademark = v; } String getCorporation() { return metaCorporation; } void setCorporation(String v) { metaCorporation = v; } String getOrigin() { return metaOrigin; } void setOrigin(String v) { metaOrigin = v; } String getBirthDate() { return metaBirthDate; } void setBirthDate(String v) { metaBirthDate = v; } int getScienceRating() { return metaScienceRating; } void setScienceRating(int v) { metaScienceRating = v; } String getNationalSchedule() { return metaNationalSchedule; } void setNationalSchedule(String v) { metaNationalSchedule = v; } SLDocumentNaming naming; SLSourceNameComparison comparison; < the .sleela class the document becomes > String className; int state; String lastError; void configure(String targetClassName) { naming = new SLDocumentNaming(); naming.configure(); comparison = new SLSourceNameComparison(); comparison.init(naming); className = targetClassName; state = 1; lastError = ""; } boolean active() { return state == 1; } < Build the naming comparison for a whole document (does not emit yet). > boolean plan(SLDocument doc) { if (!active() || doc == null || !doc.valid()) { lastError = "no document to convert"; return false; } doc.arrange(); for (int i = 0; i < doc.size(); i = i + 1) { SLDocumentStep step = doc.steps[i]; comparison.compareStep(step.annotation, i + 1); } if (!comparison.convertible()) { lastError = "cannot convert: synthesized/explicit names collide"; return false; } return true; } int synthesizedCount() { return comparison == null ? 0 : comparison.synthesizedCount(); } < Emit the .sleela class text. Each step becomes a named method; run() calls > < them in order. Returns the emitted .sleela source, or "" on failure. > String toSleela(SLDocument doc) { if (!plan(doc)) { return ""; } return native sleela_sldocument_emit_sleela(className, doc.title, doc.size()); } < Convert and write the .sleela to a path for safekeeping. Returns true on > < success. The path should carry the .sleela extension. > boolean convertToFile(SLDocument doc, String sleelaPath) { String source = toSleela(doc); if (source == null || source.length() == 0) { return false; } boolean ok = native sleela_sldocument_write(sleelaPath, source); if (!ok) { lastError = "failed to write .sleela for safekeeping"; } return ok; } SLSourceNameComparison names() { return comparison; } String error() { return lastError; } }