Home /Modules/api/xlt.html

xlt.html

api/sleela/3.1/version-031/package/xlt.html · 357 line(s) · html

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Package xlt — SleelaDoc API</title>
<link rel="stylesheet" href="../style.css">

</head>
<body>
<header class="top">
  <div class="brand"><a href="../index.html">SleelaDoc API</a></div>
  <div class="tag">HTML documentation for the SLeeLa standard library (/lib)</div>
</header>
<div class="wrap">
<nav class="side">
  <a href="../index.html"><strong>Home</strong></a>
  <a href="../packages.html"><strong>All packages</strong></a>
  <a href="../glossary.html"><strong>Glossary</strong></a>
  <a href="../authorship.html"><strong>Authorship</strong></a>
  <h2>Packages</h2><ul>
<li><a href="../package/advantage.html">advantage</a></li>
<li><a href="../package/alphabet.html">alphabet</a></li>
<li><a href="../package/antivirus.html">antivirus</a></li>
<li><a href="../package/api.html">api</a></li>
<li><a href="../package/array.html">array</a></li>
<li><a href="../package/audio.html">audio</a></li>
<li><a href="../package/autocad.html">autocad</a></li>
<li><a href="../package/ballum.html">ballum</a></li>
<li><a href="../package/bash.html">bash</a></li>
<li><a href="../package/boolean.html">boolean</a></li>
<li><a href="../package/cdma.html">cdma</a></li>
<li><a href="../package/char.html">char</a></li>
<li><a href="../package/character.html">character</a></li>
<li><a href="../package/character-recognition.html">character-recognition</a></li>
<li><a href="../package/churn.html">churn</a></li>
<li><a href="../package/citizen.html">citizen</a></li>
<li><a href="../package/codecs.html">codecs</a></li>
<li><a href="../package/collections.html">collections</a></li>
<li><a href="../package/common-rails.html">common-rails</a></li>
<li><a href="../package/compiler.html">compiler</a></li>
<li><a href="../package/compression.html">compression</a></li>
<li><a href="../package/config.html">config</a></li>
<li><a href="../package/connector.html">connector</a></li>
<li><a href="../package/coorenagraph.html">coorenagraph</a></li>
<li><a href="../package/core.html">core</a></li>
<li><a href="../package/cpu.html">cpu</a></li>
<li><a href="../package/crypto.html">crypto</a></li>
<li><a href="../package/data.html">data</a></li>
<li><a href="../package/data-structures.html">data-structures</a></li>
<li><a href="../package/database.html">database</a></li>
<li><a href="../package/debugger.html">debugger</a></li>
<li><a href="../package/decompiler.html">decompiler</a></li>
<li><a href="../package/deliberation.html">deliberation</a></li>
<li><a href="../package/drivers.html">drivers</a></li>
<li><a href="../package/examples.html">examples</a></li>
<li><a href="../package/filesystem.html">filesystem</a></li>
<li><a href="../package/gameplay.html">gameplay</a></li>
<li><a href="../package/governance.html">governance</a></li>
<li><a href="../package/gui.html">gui</a></li>
<li><a href="../package/guidoc.html">guidoc</a></li>
<li><a href="../package/hotlink.html">hotlink</a></li>
<li><a href="../package/html.html">html</a></li>
<li><a href="../package/http.html">http</a></li>
<li><a href="../package/http-1.0.html">http-1.0</a></li>
<li><a href="../package/http-2.0.html">http-2.0</a></li>
<li><a href="../package/http-3.0.html">http-3.0</a></li>
<li><a href="../package/http-4.0.html">http-4.0</a></li>
<li><a href="../package/http-5.0.html">http-5.0</a></li>
<li><a href="../package/http-6.0.html">http-6.0</a></li>
<li><a href="../package/http-7.0.html">http-7.0</a></li>
<li><a href="../package/http-8.0.html">http-8.0</a></li>
<li><a href="../package/http-9.0.html">http-9.0</a></li>
<li><a href="../package/http-servers.html">http-servers</a></li>
<li><a href="../package/ide.html">ide</a></li>
<li><a href="../package/ide-workbench.html">ide-workbench</a></li>
<li><a href="../package/idea.html">idea</a></li>
<li><a href="../package/inference-model.html">inference-model</a></li>
<li><a href="../package/inputs.html">inputs</a></li>
<li><a href="../package/international-criminal-court.html">international-criminal-court</a></li>
<li><a href="../package/io.html">io</a></li>
<li><a href="../package/java.html">java</a></li>
<li><a href="../package/java28.html">java28</a></li>
<li><a href="../package/journey.html">journey</a></li>
<li><a href="../package/languages.html">languages</a></li>
<li><a href="../package/large-language-models.html">large-language-models</a></li>
<li><a href="../package/ledger.html">ledger</a></li>
<li><a href="../package/linux-editors.html">linux-editors</a></li>
<li><a href="../package/manifesto.html">manifesto</a></li>
<li><a href="../package/math.html">math</a></li>
<li><a href="../package/memory.html">memory</a></li>
<li><a href="../package/modules.html">modules</a></li>
<li><a href="../package/moral-capacitor.html">moral-capacitor</a></li>
<li><a href="../package/munction.html">munction</a></li>
<li><a href="../package/native.html">native</a></li>
<li><a href="../package/net.html">net</a></li>
<li><a href="../package/neural-nets.html">neural-nets</a></li>
<li><a href="../package/nordshrift.html">nordshrift</a></li>
<li><a href="../package/observer.html">observer</a></li>
<li><a href="../package/opcodes.html">opcodes</a></li>
<li><a href="../package/operating-system.html">operating-system</a></li>
<li><a href="../package/os-level-support.html">os-level-support</a></li>
<li><a href="../package/philosophers.html">philosophers</a></li>
<li><a href="../package/philosophy.html">philosophy</a></li>
<li><a href="../package/politico.html">politico</a></li>
<li><a href="../package/process.html">process</a></li>
<li><a href="../package/psychiatry.html">psychiatry</a></li>
<li><a href="../package/public.html">public</a></li>
<li><a href="../package/reflection.html">reflection</a></li>
<li><a href="../package/regex.html">regex</a></li>
<li><a href="../package/registry.html">registry</a></li>
<li><a href="../package/rmi.html">rmi</a></li>
<li><a href="../package/rrs.html">rrs</a></li>
<li><a href="../package/runtime.html">runtime</a></li>
<li><a href="../package/security.html">security</a></li>
<li><a href="../package/server-edition.html">server-edition</a></li>
<li><a href="../package/signal-processing.html">signal-processing</a></li>
<li><a href="../package/sldocument.html">sldocument</a></li>
<li><a href="../package/sleela.html">sleela</a></li>
<li><a href="../package/sleela-sql.html">sleela-sql</a></li>
<li><a href="../package/sleela-terminal.html">sleela-terminal</a></li>
<li><a href="../package/sleeladoc.html">sleeladoc</a></li>
<li><a href="../package/slrtp.html">slrtp</a></li>
<li><a href="../package/social-model.html">social-model</a></li>
<li><a href="../package/softlisten.html">softlisten</a></li>
<li><a href="../package/sommeliers.html">sommeliers</a></li>
<li><a href="../package/spatial.html">spatial</a></li>
<li><a href="../package/sst.html">sst</a></li>
<li><a href="../package/synchro.html">synchro</a></li>
<li><a href="../package/systems.html">systems</a></li>
<li><a href="../package/telephony-skya.html">telephony-skya</a></li>
<li><a href="../package/terminal.html">terminal</a></li>
<li><a href="../package/terminal_pixel.html">terminal_pixel</a></li>
<li><a href="../package/text.html">text</a></li>
<li><a href="../package/ui.html">ui</a></li>
<li><a href="../package/us-infrastructure.html">us-infrastructure</a></li>
<li><a href="../package/user-interface.html">user-interface</a></li>
<li><a href="../package/video.html">video</a></li>
<li><a href="../package/vm.html">vm</a></li>
<li><a href="../package/web-server-technology.html">web-server-technology</a></li>
<li><a href="../package/website.html">website</a></li>
<li><a href="../package/wifi.html">wifi</a></li>
<li><a href="../package/xlt.html">xlt</a></li>
<li><a href="../package/xml.html">xml</a></li>
</ul>
</nav>
<main>
<div class="crumbs"><a href="../index.html">Home</a> &rsaquo; <a href="../packages.html">Packages</a> &rsaquo; xlt</div>
<h1>Package <code>xlt</code></h1>
<div class="lead">This package contains <strong>6</strong> source unit(s) defining <strong>6</strong> class(es) / struct(s). Each unit below lists its fields (the values it stores) and methods (the actions it performs), with a plain explanation of each.</div>
<input class="search" placeholder="Filter on this page (Ctrl+F also works)…" oninput="flt(this.value)">
<h2 class="section" data-u="compile-xlt-models">compile-xlt-models <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/xlt/examples/compile-xlt-models.sleela)</span></h2>
<div data-u="compile-xlt-models compilexltmodelsexample">
<h3 id="CompileXltModelsExample">CompileXltModelsExample <span class="pill">class</span></h3>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>main</code></td><td><span class="sig">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>printResult</code></td><td><span class="sig">void printResult(SLXltBuildResult r)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slxltbuildresult">SLXltBuildResult <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/xlt/SLXltBuildResult.sleela)</span></h2>
<div data-u="slxltbuildresult slxltbuildresult">
<h3 id="SLXltBuildResult">SLXltBuildResult <span class="pill">class</span></h3>
<p class="desc">Defines SLXltBuildResult — the outcome of compiling an .xlt CPU-model sheet. Per the format&#x27;s contract, compilation yields exactly one of two things: (a) SUCCESS: the model was built, with a list of what was built (the CPU SKU and each part that resolved and was installed), or (b) a CONGRUENCE report: an ordered list of reasons the model could NOT be built — a missing part (a declared ref resolved to nothing) or a part that is &quot;not agreeable to design&quot; (resolves, but does not agree with another declared part, e.g. memory channels exceeding the board). The result is deliberately like a diagnostics bag: structured, ordered, and human-readable, so the author sees precisely why integrity failed, in the document order the parts were declared. Family: xlt. Produced by SLXltCompiler. Mirrors the role of Nordshrift&#x27;s diagnostics + component manifest for the SST path.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>modelName</code></td><td><span class="sig">String modelName</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>success</code></td><td><span class="sig">int success</span></td><td class="desc">1 = built; 0 = congruence failure</td></tr>
<tr><td><code>builtCount</code></td><td><span class="sig">int builtCount</span></td><td class="desc">What was built (success path) — one line per installed part, in order.</td></tr>
<tr><td><code>reasonCount</code></td><td><span class="sig">int reasonCount</span></td><td class="desc">Why it could not be built (failure path) — one reason per line, in order.</td></tr>
<tr><td><code>MAX_LINES</code></td><td><span class="sig">static final int MAX_LINES = 6</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>REASON_MISSING</code></td><td><span class="sig">static final int REASON_MISSING     = 1</span></td><td class="desc">Reason kinds, so a consumer can distinguish the two failure classes. a declared part resolved to nothing</td></tr>
<tr><td><code>REASON_DISAGREES</code></td><td><span class="sig">static final int REASON_DISAGREES   = 2</span></td><td class="desc">a part is not agreeable to design</td></tr>
<tr><td><code>ranProgram</code></td><td><span class="sig">int ranProgram</span></td><td class="desc">Optional program-run outcome (set when the model declared a `program`). 1 = a workload was run on the built CPU</td></tr>
<tr><td><code>programOutput</code></td><td><span class="sig">int programOutput</span></td><td class="desc">the program&#x27;s observable output</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String name)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>recordBuilt</code></td><td><span class="sig">void recordBuilt(String line)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>recordReason</code></td><td><span class="sig">void recordReason(int kind, String detail)</span></td><td class="desc">Record a congruence reason. `kind` is REASON_MISSING or REASON_DISAGREES; the recorded line is prefixed so the report reads clearly.</td></tr>
<tr><td><code>setRun</code></td><td><span class="sig">void setRun(int output)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>programRan</code></td><td><span class="sig">boolean programRan()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>output</code></td><td><span class="sig">int output()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>seal</code></td><td><span class="sig">void seal()</span></td><td class="desc">Seal the outcome: success iff at least one part was built AND no congruence reason was recorded (every declared part resolved and agreed).</td></tr>
<tr><td><code>built</code></td><td><span class="sig">boolean built()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>builtLines</code></td><td><span class="sig">int builtLines()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>reasonLines</code></td><td><span class="sig">int reasonLines()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>builtLine</code></td><td><span class="sig">String builtLine(int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>reasonLine</code></td><td><span class="sig">String reasonLine(int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>model</code></td><td><span class="sig">String model()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slxltcompiler">SLXltCompiler <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/xlt/SLXltCompiler.sleela)</span></h2>
<div data-u="slxltcompiler slxltcompiler">
<h3 id="SLXltCompiler">SLXltCompiler <span class="pill">class</span></h3>
<p class="desc">Defines SLXltCompiler — the compiler for the XLT (.xlt) CPU-model</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>parts</code></td><td><span class="sig">SLComponentCatalog parts</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>registry</code></td><td><span class="sig">SLXltProducerRegistry registry</span></td><td class="desc">what refs are recognized, per slot</td></tr>
<tr><td><code>build</code></td><td><span class="sig">SLExecutorBuild build</span></td><td class="desc">the real assembly produced on success</td></tr>
<tr><td><code>memChannelsWanted</code></td><td><span class="sig">int memChannelsWanted</span></td><td class="desc">channels the declared memory needs (for agreement)</td></tr>
<tr><td><code>boardChannels</code></td><td><span class="sig">int boardChannels</span></td><td class="desc">channels the declared board routes (0 = no board)</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>registerProducer</code></td><td><span class="sig">void registerProducer(int slot, String ref, int attr)</span></td><td class="desc">Allow callers to register additional producers before compiling, so a new part becomes recognizable without editing the compiler.</td></tr>
<tr><td><code>compile</code></td><td><span class="sig">SLXltBuildResult compile(SLXltSource src)</span></td><td class="desc">Compile an .xlt source to a build result. Ordered, orthogonal, congruent.</td></tr>
<tr><td><code>assembled</code></td><td><span class="sig">SLExecutorBuild assembled()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>languageOf</code></td><td><span class="sig">int languageOf(String lang)</span></td><td class="desc">Map an .xlt language token to the SLWorkload.LANG_* id (-1 if unknown).</td></tr>
<tr><td><code>runProgram</code></td><td><span class="sig">void runProgram(SLXltSource src, int lang, SLXltBuildResult res)</span></td><td class="desc">Assemble the machine and politely run the declared program on it: a grant, an SLWorkload, and SleelaVMCreator.run on build.processor(). The capability flags (nativeram/gpu/dma) are requested on the creator so the run honors what the model declared.</td></tr>
<tr><td><code>memoryFor</code></td><td><span class="sig">SLMemoryModule memoryFor(String ref, int capMiB)</span></td><td class="desc">---------------- ref -&gt; real catalog producer mappings ------------------ Recognition and channel attributes come from SLXltProducerRegistry; these methods only map an already-recognized ref to the concrete catalog call (the surface language cannot `new` a type from a runtime string).</td></tr>
<tr><td><code>boardFor</code></td><td><span class="sig">SLMotherboard boardFor(String ref)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>storageFor</code></td><td><span class="sig">SLStorageDevice storageFor(String ref)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>busFor</code></td><td><span class="sig">SLSystemBus busFor(String ref)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slxltproducerregistry">SLXltProducerRegistry <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/xlt/SLXltProducerRegistry.sleela)</span></h2>
<div data-u="slxltproducerregistry slxltproducerregistry">
<h3 id="SLXltProducerRegistry">SLXltProducerRegistry <span class="pill">class</span></h3>
<p class="desc">Defines SLXltProducerRegistry — the explicit registry of part producers the XLT compiler resolves declared refs against. Instead of the compiler hardcoding &quot;is this a known ref&quot; tables inline, each recognizable part ref (CPU SKU, memory preset, board, cadence, storage, bus) is REGISTERED here under its slot, and the compiler asks the registry whether a ref is known and (for memory/board) what channel count it implies for the agreement check. A new part becomes recognizable by registering it, not by editing the compiler — the open/closed seam the SST symbol tables have. A registered entry carries: the slot it belongs to, the ref string, and an integer attribute (memory channel count, or board routed channels; 0/1 otherwise). Registration order does not matter; lookup is by (slot, ref). Family: xlt. Consulted by SLXltCompiler; mirrors the resolution role of lib/sst/SSTSymbolTable for the CPU-model format.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>SLOT_CPU</code></td><td><span class="sig">static final int SLOT_CPU     = 1</span></td><td class="desc">Slot ids the parts divide into (orthogonal document slots).</td></tr>
<tr><td><code>SLOT_MEMORY</code></td><td><span class="sig">static final int SLOT_MEMORY  = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SLOT_BOARD</code></td><td><span class="sig">static final int SLOT_BOARD   = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SLOT_CADENCE</code></td><td><span class="sig">static final int SLOT_CADENCE = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SLOT_STORAGE</code></td><td><span class="sig">static final int SLOT_STORAGE = 5</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SLOT_BUS</code></td><td><span class="sig">static final int SLOT_BUS     = 6</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>count</code></td><td><span class="sig">int count</span></td><td class="desc">Registered entries, stored over an SLRAM-free parallel-array shape: each entry is (slot, ref, attr). Bounded; grown by register().</td></tr>
<tr><td><code>MAX</code></td><td><span class="sig">static final int MAX = 64</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>slots</code></td><td><span class="sig">SLRAM slots</span></td><td class="desc">Parallel stores (no arrays in the surface language: use a small fixed bank backed by an SLRAM-less scheme is awkward, so we page into an SLRAM pair). slot id per entry</td></tr>
<tr><td><code>attrs</code></td><td><span class="sig">SLRAM attrs</span></td><td class="desc">integer attribute per entry (channels, etc.)</td></tr>
<tr><td><code>refsLo</code></td><td><span class="sig">SLRAM refsLo</span></td><td class="desc">ref string handles are not storable in SLRAM; see refs bank</td></tr>
<tr><td><code>refs</code></td><td><span class="sig">SLXltRefBank refs</span></td><td class="desc">string bank holding the ref per entry</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>register</code></td><td><span class="sig">boolean register(int slot, String ref, int attr)</span></td><td class="desc">Register one producer: its slot, ref string, and integer attribute.</td></tr>
<tr><td><code>known</code></td><td><span class="sig">boolean known(int slot, String ref)</span></td><td class="desc">Is `ref` a registered producer for `slot`?</td></tr>
<tr><td><code>attrOf</code></td><td><span class="sig">int attrOf(int slot, String ref)</span></td><td class="desc">The integer attribute registered for (slot, ref); 0 if not found.</td></tr>
<tr><td><code>entries</code></td><td><span class="sig">int entries()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>loadDefaults</code></td><td><span class="sig">void loadDefaults()</span></td><td class="desc">The default roster: every ref the SLComponentCatalog + CPU folders expose, with memory/board channel attributes for the agreement check.</td></tr>
</table>
</div>
<h2 class="section" data-u="slxltrefbank">SLXltRefBank <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/xlt/SLXltRefBank.sleela)</span></h2>
<div data-u="slxltrefbank slxltrefbank">
<h3 id="SLXltRefBank">SLXltRefBank <span class="pill">class</span></h3>
<p class="desc">Defines SLXltRefBank — a small fixed-capacity bank of String values indexed by integer position, used by SLXltProducerRegistry to hold the ref string of each registered producer (SLRAM stores words, not strings, so the registry pages its integer attributes into SLRAM and its ref strings into this bank at the same index). The surface language has no arrays, so the bank is a bounded set of explicit slots selected by index, the same idiom SLVMClass uses for its f0..f7 / m0..m7 members. Family: xlt. Internal helper for SLXltProducerRegistry.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>cap</code></td><td><span class="sig">int cap</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(int capacity)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>put</code></td><td><span class="sig">void put(int i, String v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>get</code></td><td><span class="sig">String get(int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slxltsource">SLXltSource <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/xlt/SLXltSource.sleela)</span></h2>
<div data-u="slxltsource slxltsource">
<h3 id="SLXltSource">SLXltSource <span class="pill">class</span></h3>
<p class="desc">Defines SLXltSource — the canonical source-time representation of</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>path</code></td><td><span class="sig">String path</span></td><td class="desc">the .xlt file path</td></tr>
<tr><td><code>modelName</code></td><td><span class="sig">String modelName</span></td><td class="desc">the `model Name { ... }` identifier</td></tr>
<tr><td><code>target</code></td><td><span class="sig">String target</span></td><td class="desc">`target sleela;`</td></tr>
<tr><td><code>libraryRoot</code></td><td><span class="sig">String libraryRoot</span></td><td class="desc">the /lib root parts resolve against</td></tr>
<tr><td><code>cpuRef</code></td><td><span class="sig">String cpuRef</span></td><td class="desc">The declared parts, one per orthogonal slot (each may be set at most once). CPU SKU class name, e.g. &quot;SLAMDEPYC9575F&quot;</td></tr>
<tr><td><code>boardRef</code></td><td><span class="sig">String boardRef</span></td><td class="desc">SLMotherboard preset, e.g. &quot;wrx90&quot; (empty = none)</td></tr>
<tr><td><code>memoryRef</code></td><td><span class="sig">String memoryRef</span></td><td class="desc">SLMemoryModule preset, e.g. &quot;ddr2_800&quot;</td></tr>
<tr><td><code>memoryCapMiB</code></td><td><span class="sig">int    memoryCapMiB</span></td><td class="desc">capacity argument for the memory preset</td></tr>
<tr><td><code>cadenceRef</code></td><td><span class="sig">String cadenceRef</span></td><td class="desc">cadence to present, e.g. &quot;DDR2&quot; (empty = native)</td></tr>
<tr><td><code>storageRef</code></td><td><span class="sig">String storageRef</span></td><td class="desc">SLStorageDevice preset (empty = none)</td></tr>
<tr><td><code>busRef</code></td><td><span class="sig">String busRef</span></td><td class="desc">SLSystemBus preset (empty = none)</td></tr>
<tr><td><code>gpuFlag</code></td><td><span class="sig">int gpuFlag</span></td><td class="desc">Capability directives: bare orthogonal flags (declared at most once each). `gpu;` -&gt; build.enableGPU()</td></tr>
<tr><td><code>dmaFlag</code></td><td><span class="sig">int dmaFlag</span></td><td class="desc">`dma;` -&gt; build.enableDMA()</td></tr>
<tr><td><code>nativeRamFlag</code></td><td><span class="sig">int nativeRamFlag</span></td><td class="desc">`nativeram;` -&gt; declare the NATIVE_RAM feature bit</td></tr>
<tr><td><code>usualTierRef</code></td><td><span class="sig">String usualTierRef</span></td><td class="desc">Memory-tier designation: the model may split memory into a &quot;usual&quot; tier (for usual activities) and an &quot;accurate&quot; tier (for competency/accuracy), and name which is the default (main) tier. Each memory preset slot below. memory preset for the usual tier, e.g. &quot;ddr2_800&quot;</td></tr>
<tr><td><code>accurateTierRef</code></td><td><span class="sig">String accurateTierRef</span></td><td class="desc">memory preset for the accurate tier, e.g. &quot;ddr5_6400&quot;</td></tr>
<tr><td><code>mainTier</code></td><td><span class="sig">String mainTier</span></td><td class="desc">&quot;usual&quot; or &quot;accurate&quot; — which the main program uses</td></tr>
<tr><td><code>programPath</code></td><td><span class="sig">String programPath</span></td><td class="desc">Optional workload: the program this model should politely run on the built CPU (source path + language), and the resource grant it is admitted under. e.g. &quot;app.sleela&quot; (empty = build hardware only)</td></tr>
<tr><td><code>programLang</code></td><td><span class="sig">String programLang</span></td><td class="desc">&quot;sleela&quot; | &quot;c&quot; | &quot;cpp&quot; | &quot;java&quot;</td></tr>
<tr><td><code>grantWords</code></td><td><span class="sig">int    grantWords</span></td><td class="desc">memory words requested (0 = compiler default)</td></tr>
<tr><td><code>grantBudget</code></td><td><span class="sig">int    grantBudget</span></td><td class="desc">cycle budget requested (0 = compiler default)</td></tr>
<tr><td><code>validated</code></td><td><span class="sig">int validated</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String sourcePath, String root)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setModelName</code></td><td><span class="sig">void setModelName(String name)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setTarget</code></td><td><span class="sig">void setTarget(String t)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>declareCpu</code></td><td><span class="sig">boolean declareCpu(String ref)</span></td><td class="desc">Orthogonal part declarations: each returns false if the slot was already filled (a duplicate breaks document orthogonality and must be reported).</td></tr>
<tr><td><code>declareBoard</code></td><td><span class="sig">boolean declareBoard(String ref)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>declareMemory</code></td><td><span class="sig">boolean declareMemory(String ref, int capMiB)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>declareCadence</code></td><td><span class="sig">boolean declareCadence(String ref)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>declareStorage</code></td><td><span class="sig">boolean declareStorage(String ref)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>declareBus</code></td><td><span class="sig">boolean declareBus(String ref)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>declareGpu</code></td><td><span class="sig">boolean declareGpu()</span></td><td class="desc">Capability directives: each may be declared at most once (orthogonal).</td></tr>
<tr><td><code>declareDma</code></td><td><span class="sig">boolean declareDma()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>declareNativeRam</code></td><td><span class="sig">boolean declareNativeRam()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>declareUsualTier</code></td><td><span class="sig">boolean declareUsualTier(String ref)</span></td><td class="desc">Memory-tier designation (orthogonal: each tier declared at most once).</td></tr>
<tr><td><code>declareAccurateTier</code></td><td><span class="sig">boolean declareAccurateTier(String ref)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>declareMainTier</code></td><td><span class="sig">boolean declareMainTier(String which)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>declareProgram</code></td><td><span class="sig">boolean declareProgram(String path, String lang)</span></td><td class="desc">Workload + grant (each declared at most once; orthogonal).</td></tr>
<tr><td><code>declareGrant</code></td><td><span class="sig">boolean declareGrant(int words, int budget)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>validate</code></td><td><span class="sig">boolean validate()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>sourcePath</code></td><td><span class="sig">String sourcePath()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>name</code></td><td><span class="sig">String name()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>targetName</code></td><td><span class="sig">String targetName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cpu</code></td><td><span class="sig">String cpu()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>board</code></td><td><span class="sig">String board()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>memory</code></td><td><span class="sig">String memory()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>memoryCapacity</code></td><td><span class="sig">int    memoryCapacity()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cadence</code></td><td><span class="sig">String cadence()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>storage</code></td><td><span class="sig">String storage()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>bus</code></td><td><span class="sig">String bus()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasBoard</code></td><td><span class="sig">boolean hasBoard()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasCadence</code></td><td><span class="sig">boolean hasCadence()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasStorage</code></td><td><span class="sig">boolean hasStorage()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasBus</code></td><td><span class="sig">boolean hasBus()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wantsGpu</code></td><td><span class="sig">boolean wantsGpu()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wantsDma</code></td><td><span class="sig">boolean wantsDma()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wantsNativeRam</code></td><td><span class="sig">boolean wantsNativeRam()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>usualTier</code></td><td><span class="sig">String usualTier()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>accurateTier</code></td><td><span class="sig">String accurateTier()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>main</code></td><td><span class="sig">String main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasTiers</code></td><td><span class="sig">boolean hasTiers()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>program</code></td><td><span class="sig">String program()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>programLanguage</code></td><td><span class="sig">String programLanguage()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasProgram</code></td><td><span class="sig">boolean hasProgram()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>grantWordsRequested</code></td><td><span class="sig">int grantWordsRequested()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>grantBudgetRequested</code></td><td><span class="sig">int grantBudgetRequested()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<script>function flt(q){q=q.toLowerCase();document.querySelectorAll('[data-u]').forEach(function(el){el.style.display = el.getAttribute('data-u').indexOf(q)>=0||q==''?'':'none';});}</script>
<footer>
Generated by <code>tools/generate-sleeladoc-api.py</code> from the live
<code>/lib</code> tree on 2026-11-16 00:48 UTC.
SleelaDoc — the SLeeLa documentation brand. SLeeLa — MEARVK LLC · Max Rupplin · UNCW, NCSU, Harvard · 2026 · George Soros 2507-2608.
</footer>
</main>
</div>
</body>
</html>