user-interface.html
api/sleela/3.1/version-004/package/user-interface.html · 2446 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 user-interface — 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> › <a href="../packages.html">Packages</a> › user-interface</div>
<h1>Package <code>user-interface</code></h1>
<div class="lead">This package contains <strong>89</strong> source unit(s) defining <strong>90</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="astrophysics">astrophysics <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/example/science/astrophysics.sleela)</span></h2>
<div data-u="astrophysics scienceastrophysics">
<h3 id="ScienceAstrophysics">ScienceAstrophysics <span class="pill">class</span></h3>
<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>banner</code></td><td><span class="sig">void banner(String t)</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">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="chemistry">chemistry <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/example/science/chemistry.sleela)</span></h2>
<div data-u="chemistry sciencechemistry">
<h3 id="ScienceChemistry">ScienceChemistry <span class="pill">class</span></h3>
<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>banner</code></td><td><span class="sig">void banner(String t)</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">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="gui-app-demo">gui-app-demo <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/gui-app-demo.sleela)</span></h2>
<div data-u="gui-app-demo guiappdemo">
<h3 id="GuiAppDemo">GuiAppDemo <span class="pill">class</span></h3>
<p class="desc">Runnable demonstrator for the /lib/gui support structure. It boots an SLGuiApp (application + window + DOM + reconciler + host adapter + script engine), builds a small interface in the SLeeLa DOM, binds an onClick callback, drives part of the UI from a script, refreshes once to project the DOM onto real SleelaUI widgets, and (on a display) hands control to the run loop. On a headless host boot() returns false and it exits cleanly, like gui-demo.sleela. This proves the architectural wiring end to end: DOM -> reconcile -> widgets, and widget activations -> events -> handlers. Family: user-interface. SLeeLa owns the document and dispatch; SleelaUI renders it.</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>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>boolToStr</code></td><td><span class="sig">String boolToStr(boolean b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>banner</code></td><td><span class="sig">void banner(String t)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>run</code></td><td><span class="sig">int run()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="gui-dual-media-studio">gui-dual-media-studio <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/example/dual/gui-dual-media-studio.sleela)</span></h2>
<div data-u="gui-dual-media-studio guidualmediastudio">
<h3 id="GuiDualMediaStudio">GuiDualMediaStudio <span class="pill">class</span></h3>
<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>ALLOW_HORIZONTAL_OVERFLOW</code></td><td><span class="sig">static final int ALLOW_HORIZONTAL_OVERFLOW = 0</span></td><td class="desc">SLUITheme preset ordinals (mirror SLUIThemeId in the toolkit C ABI). Static build policy: default keeps the normal layout within its parent width. Set to 1 only in builds that intentionally permit horizontal overflow.</td></tr>
<tr><td><code>SCROLL_AUTO</code></td><td><span class="sig">int SCROLL_AUTO = 0</span></td><td class="desc">Scroll-policy ordinal (mirror the toolkit C ABI: 0=auto on overflow).</td></tr>
<tr><td><code>btnPlay</code></td><td><span class="sig">int btnPlay</span></td><td class="desc">Live handles the event loop reacts on/to.</td></tr>
<tr><td><code>btnPause</code></td><td><span class="sig">int btnPause</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>btnStop</code></td><td><span class="sig">int btnStop</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>btnRec</code></td><td><span class="sig">int btnRec</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>btnRecStop</code></td><td><span class="sig">int btnRecStop</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>statusLabel</code></td><td><span class="sig">int statusLabel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiButton</code></td><td><span class="sig">int wifiButton</span></td><td class="desc">Lower-right status-bar connectivity control and its dismissible menu.</td></tr>
<tr><td><code>wifiPanel</code></td><td><span class="sig">int wifiPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiStatusLabel</code></td><td><span class="sig">int wifiStatusLabel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiScanButton</code></td><td><span class="sig">int wifiScanButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiConnectButton</code></td><td><span class="sig">int wifiConnectButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiDisconnectButton</code></td><td><span class="sig">int wifiDisconnectButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiSettingsButton</code></td><td><span class="sig">int wifiSettingsButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiInfoButton</code></td><td><span class="sig">int wifiInfoButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiProfileEntry</code></td><td><span class="sig">int wifiProfileEntry</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiCloseButton</code></td><td><span class="sig">int wifiCloseButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>openMenuIndex</code></td><td><span class="sig">int openMenuIndex = -1</span></td><td class="desc">Menubar strip and its dropdown panels (built from existing ui* widgets).</td></tr>
<tr><td><code>menuFileButton</code></td><td><span class="sig">int menuFileButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuFilePanel</code></td><td><span class="sig">int menuFilePanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuFileItem1</code></td><td><span class="sig">int menuFileItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuFileItem2</code></td><td><span class="sig">int menuFileItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuMediaButton</code></td><td><span class="sig">int menuMediaButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuMediaPanel</code></td><td><span class="sig">int menuMediaPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuMediaItem1</code></td><td><span class="sig">int menuMediaItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuMediaItem2</code></td><td><span class="sig">int menuMediaItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuPlaybackButton</code></td><td><span class="sig">int menuPlaybackButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuPlaybackPanel</code></td><td><span class="sig">int menuPlaybackPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuPlaybackItem1</code></td><td><span class="sig">int menuPlaybackItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuPlaybackItem2</code></td><td><span class="sig">int menuPlaybackItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpButton</code></td><td><span class="sig">int menuHelpButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpPanel</code></td><td><span class="sig">int menuHelpPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpItem1</code></td><td><span class="sig">int menuHelpItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpItem2</code></td><td><span class="sig">int menuHelpItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>THEME_GRAY</code></td><td><span class="sig">int THEME_GRAY = 7</span></td><td class="desc">A cool "glass" studio theme for the DUAL line. Shared SLeeLa family palette: chrome/title bar #1D2025, Standard Pattern ordinal (mirror SLUIThemeId): 7=GRAY. dual uses GRAY.</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>rgba</code></td><td><span class="sig">int rgba(int r, int g, int b, int a)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>rgb</code></td><td><span class="sig">int rgb(int r, int g, int b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clamp</code></td><td><span class="sig">int clamp(int v, int lo, int hi)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>intToStr</code></td><td><span class="sig">String intToStr(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>canPlayType</code></td><td><span class="sig">boolean canPlayType(String mime)</span></td><td class="desc">Codec gate: the studio consults the registry before offering a control.</td></tr>
<tr><td><code>playMedia</code></td><td><span class="sig">void playMedia()</span></td><td class="desc">Shared action helpers keep menu commands and transport buttons consistent.</td></tr>
<tr><td><code>pauseMedia</code></td><td><span class="sig">void pauseMedia()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>stopMedia</code></td><td><span class="sig">void stopMedia()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>startRecording</code></td><td><span class="sig">void startRecording()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>stopRecording</code></td><td><span class="sig">void stopRecording()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>glassTheme</code></td><td><span class="sig">int glassTheme()</span></td><td class="desc">dual is the GRAY Standard Pattern: neutral mid-gray surfaces with light text, supplied by the toolkit preset (no per-colour overrides); metrics only.</td></tr>
<tr><td><code>openMenu</code></td><td><span class="sig">void openMenu(int which)</span></td><td class="desc">Show one dropdown at a time; selecting the open menu closes it.</td></tr>
<tr><td><code>wifiActionUnavailable</code></td><td><span class="sig">void wifiActionUnavailable(String action)</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">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="gui-events-demo">gui-events-demo <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/gui-events-demo.sleela)</span></h2>
<div data-u="gui-events-demo guieventsdemo">
<h3 id="GuiEventsDemo">GuiEventsDemo <span class="pill">class</span></h3>
<p class="desc">Runnable demonstrator for the /lib/gui event + DHTML + scripting layer. It builds a small document (a window with a button and an entry), binds callbacks (onClick / onInput) the DHTML way, raises events and shows the dispatcher routing them to operations with the take-the-latch latch, demonstrates preventDefault/stopPropagation, mutates the DOM live (setText/setStyle/hide), and finally drives the SAME interface from an SLGuiScript command list — proving the UI can be authored and driven by scripting. Self-contained (inline flow + main), in the style of gui-demo.sleela. Family: user-interface. SLeeLa owns dispatch and the meaning of events; a host only raises them and mirrors the DOM onto widgets.</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>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>boolToStr</code></td><td><span class="sig">String boolToStr(boolean b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>banner</code></td><td><span class="sig">void banner(String t)</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">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="gui-gual-settings-console">gui-gual-settings-console <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/example/gual/gui-gual-settings-console.sleela)</span></h2>
<div data-u="gui-gual-settings-console guigualsettingsconsole">
<h3 id="GuiGualSettingsConsole">GuiGualSettingsConsole <span class="pill">class</span></h3>
<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>ALLOW_HORIZONTAL_OVERFLOW</code></td><td><span class="sig">static final int ALLOW_HORIZONTAL_OVERFLOW = 0</span></td><td class="desc">SLUITheme preset ordinals (mirror SLUIThemeId in the toolkit C ABI). Static build policy: default keeps the normal layout within its parent width. Set to 1 only in builds that intentionally permit horizontal overflow.</td></tr>
<tr><td><code>SCROLL_AUTO</code></td><td><span class="sig">int SCROLL_AUTO = 0</span></td><td class="desc">Scroll-policy ordinal (mirror the toolkit C ABI: 0=auto on overflow).</td></tr>
<tr><td><code>btnJfx</code></td><td><span class="sig">int btnJfx</span></td><td class="desc">Live handles the event loop reacts on/to.</td></tr>
<tr><td><code>btnSwing</code></td><td><span class="sig">int btnSwing</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>btnNative</code></td><td><span class="sig">int btnNative</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>btnQt</code></td><td><span class="sig">int btnQt</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>statusLabel</code></td><td><span class="sig">int statusLabel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiButton</code></td><td><span class="sig">int wifiButton</span></td><td class="desc">Lower-right status-bar connectivity control and its dismissible menu.</td></tr>
<tr><td><code>wifiPanel</code></td><td><span class="sig">int wifiPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiStatusLabel</code></td><td><span class="sig">int wifiStatusLabel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiScanButton</code></td><td><span class="sig">int wifiScanButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiConnectButton</code></td><td><span class="sig">int wifiConnectButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiDisconnectButton</code></td><td><span class="sig">int wifiDisconnectButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiSettingsButton</code></td><td><span class="sig">int wifiSettingsButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiInfoButton</code></td><td><span class="sig">int wifiInfoButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiProfileEntry</code></td><td><span class="sig">int wifiProfileEntry</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiCloseButton</code></td><td><span class="sig">int wifiCloseButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>openMenuIndex</code></td><td><span class="sig">int openMenuIndex = -1</span></td><td class="desc">Menubar strip and its dropdown panels (built from existing ui* widgets).</td></tr>
<tr><td><code>menuFileButton</code></td><td><span class="sig">int menuFileButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuFilePanel</code></td><td><span class="sig">int menuFilePanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuFileItem1</code></td><td><span class="sig">int menuFileItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuFileItem2</code></td><td><span class="sig">int menuFileItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuSettingsButton</code></td><td><span class="sig">int menuSettingsButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuSettingsPanel</code></td><td><span class="sig">int menuSettingsPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuSettingsItem1</code></td><td><span class="sig">int menuSettingsItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuSettingsItem2</code></td><td><span class="sig">int menuSettingsItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuBackendButton</code></td><td><span class="sig">int menuBackendButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuBackendPanel</code></td><td><span class="sig">int menuBackendPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuBackendItem1</code></td><td><span class="sig">int menuBackendItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuBackendItem2</code></td><td><span class="sig">int menuBackendItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpButton</code></td><td><span class="sig">int menuHelpButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpPanel</code></td><td><span class="sig">int menuHelpPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpItem1</code></td><td><span class="sig">int menuHelpItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpItem2</code></td><td><span class="sig">int menuHelpItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>THEME_BLACK</code></td><td><span class="sig">int THEME_BLACK = 5</span></td><td class="desc">A hardened, neutral "settings" theme. Shared SLeeLa family palette: chrome/title bar #1D2025, Standard Pattern ordinal (mirror SLUIThemeId): 5=BLACK. gual uses BLACK.</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>rgba</code></td><td><span class="sig">int rgba(int r, int g, int b, int a)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>rgb</code></td><td><span class="sig">int rgb(int r, int g, int b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>selectBackend</code></td><td><span class="sig">void selectBackend(int which)</span></td><td class="desc">Mark one accepted backend button as selected (fail-closed: qt stays off).</td></tr>
<tr><td><code>clamp</code></td><td><span class="sig">int clamp(int v, int lo, int hi)</span></td><td class="desc">Clamp an int into [lo, hi] — the heart of GUAL's settings discipline.</td></tr>
<tr><td><code>intToStr</code></td><td><span class="sig">String intToStr(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>settingsTheme</code></td><td><span class="sig">int settingsTheme()</span></td><td class="desc">gual is the BLACK Standard Pattern: deep black surfaces with light text, supplied by the toolkit preset (no per-colour overrides); metrics only.</td></tr>
<tr><td><code>openMenu</code></td><td><span class="sig">void openMenu(int which)</span></td><td class="desc">Show one dropdown at a time; selecting the open menu closes it.</td></tr>
<tr><td><code>wifiActionUnavailable</code></td><td><span class="sig">void wifiActionUnavailable(String action)</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">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="gui-menubar-expandable">gui-menubar-expandable <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/example/menus/gui-menubar-expandable.sleela)</span></h2>
<div data-u="gui-menubar-expandable guimenubarexpandable">
<h3 id="GuiMenubarExpandable">GuiMenubarExpandable <span class="pill">class</span></h3>
<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>PAD</code></td><td><span class="sig">int PAD = 10</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>GAP</code></td><td><span class="sig">int GAP = 6</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>VERTICAL</code></td><td><span class="sig">int VERTICAL = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>HORIZONTAL</code></td><td><span class="sig">int HORIZONTAL = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>statusLabel</code></td><td><span class="sig">int statusLabel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>openMenuIndex</code></td><td><span class="sig">int openMenuIndex = -1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>recentOpen</code></td><td><span class="sig">boolean recentOpen = false</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>panelsOpen</code></td><td><span class="sig">boolean panelsOpen = false</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fileButton</code></td><td><span class="sig">int fileButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>editButton</code></td><td><span class="sig">int editButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>viewButton</code></td><td><span class="sig">int viewButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>helpButton</code></td><td><span class="sig">int helpButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>filePanel</code></td><td><span class="sig">int filePanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>editPanel</code></td><td><span class="sig">int editPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>viewPanel</code></td><td><span class="sig">int viewPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>helpPanel</code></td><td><span class="sig">int helpPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>recentToggle</code></td><td><span class="sig">int recentToggle</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>recentPanel</code></td><td><span class="sig">int recentPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>recentOne</code></td><td><span class="sig">int recentOne</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>recentTwo</code></td><td><span class="sig">int recentTwo</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>recentThree</code></td><td><span class="sig">int recentThree</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>panelsToggle</code></td><td><span class="sig">int panelsToggle</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>panelsPanel</code></td><td><span class="sig">int panelsPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>panelEditor</code></td><td><span class="sig">int panelEditor</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>panelInspector</code></td><td><span class="sig">int panelInspector</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fileNew</code></td><td><span class="sig">int fileNew</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fileSave</code></td><td><span class="sig">int fileSave</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>editUndo</code></td><td><span class="sig">int editUndo</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>editSelectAll</code></td><td><span class="sig">int editSelectAll</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>viewZoomIn</code></td><td><span class="sig">int viewZoomIn</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>viewZoomOut</code></td><td><span class="sig">int viewZoomOut</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>helpAbout</code></td><td><span class="sig">int helpAbout</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>setStatus</code></td><td><span class="sig">void setStatus(String message)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>openMenu</code></td><td><span class="sig">void openMenu(int which)</span></td><td class="desc">Exactly one top-level dropdown is open at a time. Clicking its heading again collapses it; choosing another heading switches directly to it.</td></tr>
<tr><td><code>toggleRecentFiles</code></td><td><span class="sig">void toggleRecentFiles()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>togglePanels</code></td><td><span class="sig">void togglePanels()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>closeMenus</code></td><td><span class="sig">void closeMenus()</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">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="gui-military-command-console">gui-military-command-console <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/example/military/gui-military-command-console.sleela)</span></h2>
<div data-u="gui-military-command-console guimilitarycommandconsole">
<h3 id="GuiMilitaryCommandConsole">GuiMilitaryCommandConsole <span class="pill">class</span></h3>
<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>THEME_CUSTOM</code></td><td><span class="sig">int THEME_CUSTOM = 2</span></td><td class="desc">SLUITheme preset ordinals (mirror SLUIThemeId in the toolkit C ABI).</td></tr>
<tr><td><code>SCROLL_AUTO</code></td><td><span class="sig">int SCROLL_AUTO = 0</span></td><td class="desc">Scroll-policy ordinal (mirror the toolkit C ABI: 0=auto on overflow).</td></tr>
<tr><td><code>btnAuthorize</code></td><td><span class="sig">int btnAuthorize</span></td><td class="desc">Live handles the event loop reacts on/to.</td></tr>
<tr><td><code>btnRun</code></td><td><span class="sig">int btnRun</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>btnReset</code></td><td><span class="sig">int btnReset</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>statusLabel</code></td><td><span class="sig">int statusLabel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiMenuOpen</code></td><td><span class="sig">boolean wifiMenuOpen = false</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiButton</code></td><td><span class="sig">int wifiButton</span></td><td class="desc">Lower-right status-bar connectivity control and its dismissible menu.</td></tr>
<tr><td><code>wifiPanel</code></td><td><span class="sig">int wifiPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiStatusLabel</code></td><td><span class="sig">int wifiStatusLabel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiScanButton</code></td><td><span class="sig">int wifiScanButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiConnectButton</code></td><td><span class="sig">int wifiConnectButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiDisconnectButton</code></td><td><span class="sig">int wifiDisconnectButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiSettingsButton</code></td><td><span class="sig">int wifiSettingsButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiInfoButton</code></td><td><span class="sig">int wifiInfoButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiProfileEntry</code></td><td><span class="sig">int wifiProfileEntry</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiCloseButton</code></td><td><span class="sig">int wifiCloseButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>consoleMenuIndex</code></td><td><span class="sig">int consoleMenuIndex = -1</span></td><td class="desc">Reusable menu-bar interaction state for the command console.</td></tr>
<tr><td><code>menuFileButton</code></td><td><span class="sig">int menuFileButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuEditButton</code></td><td><span class="sig">int menuEditButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuViewButton</code></td><td><span class="sig">int menuViewButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpButton</code></td><td><span class="sig">int menuHelpButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuFilePanel</code></td><td><span class="sig">int menuFilePanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuEditPanel</code></td><td><span class="sig">int menuEditPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuViewPanel</code></td><td><span class="sig">int menuViewPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpPanel</code></td><td><span class="sig">int menuHelpPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuFileNew</code></td><td><span class="sig">int menuFileNew</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuFileSave</code></td><td><span class="sig">int menuFileSave</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuEditAudit</code></td><td><span class="sig">int menuEditAudit</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuEditClear</code></td><td><span class="sig">int menuEditClear</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuViewStatus</code></td><td><span class="sig">int menuViewStatus</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuViewCertificates</code></td><td><span class="sig">int menuViewCertificates</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpAbout</code></td><td><span class="sig">int menuHelpAbout</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>openConsoleMenu</code></td><td><span class="sig">void openConsoleMenu(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>closeConsoleMenus</code></td><td><span class="sig">void closeConsoleMenus()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>rgba</code></td><td><span class="sig">int rgba(int r, int g, int b, int a)</span></td><td class="desc">0xRRGGBBAA colours for the military "metal / blue-hue" palette.</td></tr>
<tr><td><code>rgb</code></td><td><span class="sig">int rgb(int r, int g, int b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>militaryTheme</code></td><td><span class="sig">int militaryTheme()</span></td><td class="desc">Build the hardened metal/blue military theme and return its handle. Shared SLeeLa family palette: chrome/title bar #1D2025, URL-entry surface #383C47; keep these tokens aligned across all five lines.</td></tr>
<tr><td><code>toggleWifiMenu</code></td><td><span class="sig">void toggleWifiMenu()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>closeWifiMenu</code></td><td><span class="sig">void closeWifiMenu()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiActionUnavailable</code></td><td><span class="sig">void wifiActionUnavailable(String action)</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">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="gui-mual-text-editor">gui-mual-text-editor <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/example/mual/gui-mual-text-editor.sleela)</span></h2>
<div data-u="gui-mual-text-editor guimualtexteditor">
<h3 id="GuiMualTextEditor">GuiMualTextEditor <span class="pill">class</span></h3>
<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>VERTICAL</code></td><td><span class="sig">int VERTICAL = 0</span></td><td class="desc">SLUITheme preset ordinals (mirror SLUIThemeId in the toolkit C ABI). Orientation + scroll-policy ordinals (mirror the toolkit C ABI).</td></tr>
<tr><td><code>HORIZONTAL</code></td><td><span class="sig">int HORIZONTAL = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SCROLL_AUTO</code></td><td><span class="sig">int SCROLL_AUTO = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiButton</code></td><td><span class="sig">int wifiButton</span></td><td class="desc">int aboutPanel; // panel: about/help int statusLabel; // the status line text Lower-right status-bar connectivity control and its dismissible menu.</td></tr>
<tr><td><code>wifiPanel</code></td><td><span class="sig">int wifiPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiStatusLabel</code></td><td><span class="sig">int wifiStatusLabel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiScanButton</code></td><td><span class="sig">int wifiScanButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiConnectButton</code></td><td><span class="sig">int wifiConnectButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiDisconnectButton</code></td><td><span class="sig">int wifiDisconnectButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiSettingsButton</code></td><td><span class="sig">int wifiSettingsButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiInfoButton</code></td><td><span class="sig">int wifiInfoButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiProfileEntry</code></td><td><span class="sig">int wifiProfileEntry</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiCloseButton</code></td><td><span class="sig">int wifiCloseButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>btnDocs</code></td><td><span class="sig">int btnDocs</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>btnAbout</code></td><td><span class="sig">int btnAbout</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>btnSave</code></td><td><span class="sig">int btnSave</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>btnNew</code></td><td><span class="sig">int btnNew</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>openMenuIndex</code></td><td><span class="sig">int openMenuIndex = -1</span></td><td class="desc">Menubar strip and its dropdown panels (built from existing ui* widgets).</td></tr>
<tr><td><code>menuFileButton</code></td><td><span class="sig">int menuFileButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuFilePanel</code></td><td><span class="sig">int menuFilePanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuFileItem1</code></td><td><span class="sig">int menuFileItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuFileItem2</code></td><td><span class="sig">int menuFileItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuEditButton</code></td><td><span class="sig">int menuEditButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuEditPanel</code></td><td><span class="sig">int menuEditPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuEditItem1</code></td><td><span class="sig">int menuEditItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuEditItem2</code></td><td><span class="sig">int menuEditItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuViewButton</code></td><td><span class="sig">int menuViewButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuViewPanel</code></td><td><span class="sig">int menuViewPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuViewItem1</code></td><td><span class="sig">int menuViewItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuViewItem2</code></td><td><span class="sig">int menuViewItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpButton</code></td><td><span class="sig">int menuHelpButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpPanel</code></td><td><span class="sig">int menuHelpPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpItem1</code></td><td><span class="sig">int menuHelpItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpItem2</code></td><td><span class="sig">int menuHelpItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>THEME_WHITE</code></td><td><span class="sig">int THEME_WHITE = 4</span></td><td class="desc">Standard Pattern ordinal (mirror SLUIThemeId in the toolkit C ABI): 4=WHITE, 5=BLACK, 6=BLUE, 7=GRAY. This line (mual) uses WHITE.</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>rgba</code></td><td><span class="sig">int rgba(int r, int g, int b, int a)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>rgb</code></td><td><span class="sig">int rgb(int r, int g, int b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>baselineTheme</code></td><td><span class="sig">int baselineTheme()</span></td><td class="desc">Build the baseline editor theme and return its handle. mual is the WHITE Standard Pattern: a light surface family with dark text and a blue accent, supplied by the toolkit preset (no per-colour overrides); only the family metrics are tuned here.</td></tr>
<tr><td><code>showPanel</code></td><td><span class="sig">void showPanel(int which)</span></td><td class="desc">Show exactly one panel; mark the active toolbar button as suggested.</td></tr>
<tr><td><code>openMenu</code></td><td><span class="sig">void openMenu(int which)</span></td><td class="desc">Show one dropdown at a time; selecting the open menu closes it.</td></tr>
<tr><td><code>wifiActionUnavailable</code></td><td><span class="sig">void wifiActionUnavailable(String action)</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">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="gui-thual-effects-showcase">gui-thual-effects-showcase <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/example/thual/gui-thual-effects-showcase.sleela)</span></h2>
<div data-u="gui-thual-effects-showcase guithualeffectsshowcase">
<h3 id="GuiThualEffectsShowcase">GuiThualEffectsShowcase <span class="pill">class</span></h3>
<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>SCROLL_AUTO</code></td><td><span class="sig">int SCROLL_AUTO = 0</span></td><td class="desc">SLUITheme preset ordinals (mirror SLUIThemeId in the toolkit C ABI). Scroll-policy ordinal (mirror the toolkit C ABI: 0=auto on overflow).</td></tr>
<tr><td><code>btnConfirm</code></td><td><span class="sig">int btnConfirm</span></td><td class="desc">Live handles the event loop reacts on/to.</td></tr>
<tr><td><code>btnFade</code></td><td><span class="sig">int btnFade</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>statusLabel</code></td><td><span class="sig">int statusLabel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiButton</code></td><td><span class="sig">int wifiButton</span></td><td class="desc">Lower-right status-bar connectivity control and its dismissible menu.</td></tr>
<tr><td><code>wifiPanel</code></td><td><span class="sig">int wifiPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiStatusLabel</code></td><td><span class="sig">int wifiStatusLabel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiScanButton</code></td><td><span class="sig">int wifiScanButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiConnectButton</code></td><td><span class="sig">int wifiConnectButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiDisconnectButton</code></td><td><span class="sig">int wifiDisconnectButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiSettingsButton</code></td><td><span class="sig">int wifiSettingsButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiInfoButton</code></td><td><span class="sig">int wifiInfoButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiProfileEntry</code></td><td><span class="sig">int wifiProfileEntry</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiCloseButton</code></td><td><span class="sig">int wifiCloseButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>openMenuIndex</code></td><td><span class="sig">int openMenuIndex = -1</span></td><td class="desc">Menubar strip and its dropdown panels (built from existing ui* widgets).</td></tr>
<tr><td><code>menuFileButton</code></td><td><span class="sig">int menuFileButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuFilePanel</code></td><td><span class="sig">int menuFilePanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuFileItem1</code></td><td><span class="sig">int menuFileItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuFileItem2</code></td><td><span class="sig">int menuFileItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuEffectsButton</code></td><td><span class="sig">int menuEffectsButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuEffectsPanel</code></td><td><span class="sig">int menuEffectsPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuEffectsItem1</code></td><td><span class="sig">int menuEffectsItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuEffectsItem2</code></td><td><span class="sig">int menuEffectsItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuViewButton</code></td><td><span class="sig">int menuViewButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuViewPanel</code></td><td><span class="sig">int menuViewPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuViewItem1</code></td><td><span class="sig">int menuViewItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuViewItem2</code></td><td><span class="sig">int menuViewItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpButton</code></td><td><span class="sig">int menuHelpButton</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpPanel</code></td><td><span class="sig">int menuHelpPanel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpItem1</code></td><td><span class="sig">int menuHelpItem1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuHelpItem2</code></td><td><span class="sig">int menuHelpItem2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>THEME_BLUE</code></td><td><span class="sig">int THEME_BLUE = 6</span></td><td class="desc">A bright, dimensional "studio" theme for the effects line. Shared SLeeLa family palette: chrome/title bar #1D2025, Standard Pattern ordinal (mirror SLUIThemeId): 6=BLUE. thual uses BLUE.</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>rgba</code></td><td><span class="sig">int rgba(int r, int g, int b, int a)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>rgb</code></td><td><span class="sig">int rgb(int r, int g, int b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clamp</code></td><td><span class="sig">int clamp(int v, int lo, int hi)</span></td><td class="desc">Every effect knob clamps to a safe window (the THUAL discipline).</td></tr>
<tr><td><code>intToStr</code></td><td><span class="sig">String intToStr(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>studioTheme</code></td><td><span class="sig">int studioTheme()</span></td><td class="desc">thual is the BLUE Standard Pattern: blue-tinted surfaces with light text, supplied by the toolkit preset (no per-colour overrides); metrics only.</td></tr>
<tr><td><code>openMenu</code></td><td><span class="sig">void openMenu(int which)</span></td><td class="desc">Show one dropdown at a time; selecting the open menu closes it.</td></tr>
<tr><td><code>wifiActionUnavailable</code></td><td><span class="sig">void wifiActionUnavailable(String action)</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">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="guide-chain-syntax">guide-chain-syntax <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/example/science/guide-chain-syntax.sleela)</span></h2>
<div data-u="guide-chain-syntax perfect">
<h3 id="Perfect">Perfect <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>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>growth</code></td><td><span class="sig">int growth</span></td><td class="desc">the seated growth, accumulated as each Guide fires</td></tr>
<tr><td><code>trail</code></td><td><span class="sig">String trail</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>create</code></td><td><span class="sig">void create()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>patch</code></td><td><span class="sig">void patch()</span></td><td class="desc">--- the Guides: each a zero-argument method, seated via :: ---</td></tr>
<tr><td><code>seed</code></td><td><span class="sig">void seed()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>aim</code></td><td><span class="sig">void aim()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>guide</code></td><td><span class="sig">void guide()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>total</code></td><td><span class="sig">int total()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>chain</code></td><td><span class="sig">String chain()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<div data-u="guide-chain-syntax guidechainsyntax">
<h3 id="GuideChainSyntax">GuideChainSyntax <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>
</table>
</div>
<h2 class="section" data-u="math">math <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/example/science/math.sleela)</span></h2>
<div data-u="math sciencemath">
<h3 id="ScienceMath">ScienceMath <span class="pill">class</span></h3>
<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>banner</code></td><td><span class="sig">void banner(String t)</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">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="philosophers-constructor">philosophers-constructor <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/example/science/philosophers-constructor.sleela)</span></h2>
<div data-u="philosophers-constructor philosophersconstructorexample">
<h3 id="PhilosophersConstructorExample">PhilosophersConstructorExample <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>buildOne</code></td><td><span class="sig">void buildOne(String title, int quorum, int seconds)</span></td><td class="desc">Build one Constructor, run it for a duration, and print its report.</td></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>
</table>
</div>
<h2 class="section" data-u="physics">physics <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/example/science/physics.sleela)</span></h2>
<div data-u="physics sciencephysics">
<h3 id="SciencePhysics">SciencePhysics <span class="pill">class</span></h3>
<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>banner</code></td><td><span class="sig">void banner(String t)</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">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slavatar">SLAvatar <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLAvatar.sleela)</span></h2>
<div data-u="slavatar slavatar">
<h3 id="SLAvatar">SLAvatar <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLAvatar — a SleelaUI round avatar: an accent disc of a fixed diameter showing a centred initial, used to represent a person or account. The constructor bottoms out in the `uiAvatar` built-in (SleelaUI C ABI slui_avatar()); the initial is updated through the inherited setText(). An SLAvatar IS an SLWidget but is non-interactive. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String initial, int diameter)</span></td><td class="desc">Create an avatar inside `parent` with an initial and a diameter (px).</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String initial, int diameter)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slbadge">SLBadge <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLBadge.sleela)</span></h2>
<div data-u="slbadge slbadge">
<h3 id="SLBadge">SLBadge <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLBadge — a SleelaUI count/status pill: a small rounded accent pill with centred text, used to annotate a control with a count or short status (e.g. an unread count next to a title). The constructor bottoms out in the `uiBadge` built-in (SleelaUI C ABI slui_badge()); the text is updated through the inherited setText(). An SLBadge IS an SLWidget but is non-interactive. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String text)</span></td><td class="desc">Create a badge inside `parent` with text (often a small number).</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String text)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slbox">SLBox <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLBox.sleela)</span></h2>
<div data-u="slbox slbox">
<h3 id="SLBox">SLBox <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLBox — the primary SleelaUI container: a horizontal or vertical box that lays its children out with the GTK/CSS box model (natural sizes first, surplus split among expanding children, then cross-axis alignment). Children are added by constructing control classes against this box's handle. The constructor bottoms out in the `uiBox` built-in, which calls the SleelaUI C ABI slui_box(). A box IS an SLWidget, so it carries the full margin/align/expand surface and can itself be nested inside another box to build rich layouts. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, int orientation, int spacing)</span></td><td class="desc">Create a box inside `parent` (an SLWidget). orientation is ORIENT_VERTICAL or ORIENT_HORIZONTAL; spacing is the gap between children in pixels.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, int orientation, int spacing)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>vertical</code></td><td><span class="sig">void vertical(SLWidget parent, int spacing)</span></td><td class="desc">Convenience constructors for the two orientations.</td></tr>
<tr><td><code>horizontal</code></td><td><span class="sig">void horizontal(SLWidget parent, int spacing)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slbutton">SLButton <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLButton.sleela)</span></h2>
<div data-u="slbutton slbutton">
<h3 id="SLButton">SLButton <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLButton — a SleelaUI push button: a rounded surface with centred text, a 1px hairline, a hover/active tint, and an accent focus ring when keyboard-focused. Mark it suggested() to make it the one accent action in its group, or destructive() to turn it red on hover. The constructor bottoms out in the `uiButton` built-in (SleelaUI C ABI slui_button()); clicks (and Enter/Space while focused) raise an activate event the host polls through the application's event loop. An SLButton IS an SLWidget and is keyboard-focusable. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String label)</span></td><td class="desc">Create a button inside `parent` with a label.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String label)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>createInWithIcon</code></td><td><span class="sig">void createInWithIcon(SLWidget parent, String label, SLIcon icon)</span></td><td class="desc">Create a labelled button and attach an icon descriptor in one operation.</td></tr>
<tr><td><code>createInHandleWithIcon</code></td><td><span class="sig">void createInHandleWithIcon(int parentHandle, String label, SLIcon icon)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setIcon</code></td><td><span class="sig">void setIcon(SLIcon icon)</span></td><td class="desc">Attach a JPEG icon plus a named fallback symbol (for example, Wifi).</td></tr>
<tr><td><code>setIconPath</code></td><td><span class="sig">void setIconPath(String assetPath, String symbolName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clicked</code></td><td><span class="sig">boolean clicked()</span></td><td class="desc">True if this button has an activation pending since the last check; the VM clears the latch on read, so each click is observed exactly once.</td></tr>
<tr><td><code>hovered</code></td><td><span class="sig">boolean hovered()</span></td><td class="desc">True while the pointer is over the button.</td></tr>
<tr><td><code>takePressed</code></td><td><span class="sig">boolean takePressed()</span></td><td class="desc">One-shot pointer press/release and hover transition events.</td></tr>
<tr><td><code>takeReleased</code></td><td><span class="sig">boolean takeReleased()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>takeHoverEntered</code></td><td><span class="sig">boolean takeHoverEntered()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>takeHoverLeft</code></td><td><span class="sig">boolean takeHoverLeft()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slcalculus8">SLCalculus8 <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLCalculus8.sleela)</span></h2>
<div data-u="slcalculus8 slcalculus8">
<h3 id="SLCalculus8">SLCalculus8 <span class="pill">class</span></h3>
<p class="desc">Defines SLCalculus8 — the careful 8-stage calculus with 100 differentiable inputs that maps a SleelaUI light's control points directly into a MOOD. Each of the 100 inputs is a "differentiable" the host nudges in [0,1]; eight smooth, analytically-differentiable basis stages (identity, quadratic, smoothstep, sine, cosine, logistic, gaussian, tanh) combine them into a mood scalar in [0,1]. Because every stage is differentiable, eval returns both the mood and the slope d(mood)/d(input) so an adjuster can walk the gradient into a mood. Each method bottoms out in a `calc8*` SLVM built-in that calls the genuine C ABI (sleela_ui_mood.h). A calculus is a VM-local handle (-1 = none). Attach it to an SLMood with SLMood.setCalculus to drive where the mood's wash is sampled. Family: user-interface. Native VM/UI work crosses the explicit `calc8*` SLVM bridge.</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>INPUTS</code></td><td><span class="sig">static final int INPUTS = 100</span></td><td class="desc">the 100 differentiables</td></tr>
<tr><td><code>STAGES</code></td><td><span class="sig">static final int STAGES = 8</span></td><td class="desc">the careful 8 stages</td></tr>
<tr><td><code>calc</code></td><td><span class="sig">int calc</span></td><td class="desc">VM-local handle (-1 = none)</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>create</code></td><td><span class="sig">void create()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>handle</code></td><td><span class="sig">int handle()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>valid</code></td><td><span class="sig">boolean valid()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>destroy</code></td><td><span class="sig">void destroy()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>set</code></td><td><span class="sig">void set(int index, double value)</span></td><td class="desc">Set/get one of the 100 differentiables (index 0..99), each in [0,1].</td></tr>
<tr><td><code>get</code></td><td><span class="sig">double get(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>mood</code></td><td><span class="sig">double mood()</span></td><td class="desc">Evaluate: the mood scalar in [0,1].</td></tr>
<tr><td><code>slope</code></td><td><span class="sig">double slope(int wrtIndex)</span></td><td class="desc">The slope d(mood)/d(input) along a given differentiable (differentiable calculus: nudging that input moves the mood by this slope).</td></tr>
</table>
</div>
<h2 class="section" data-u="slcanvasview">SLCanvasView <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLCanvasView.sleela)</span></h2>
<div data-u="slcanvasview slcanvasview">
<h3 id="SLCanvasView">SLCanvasView <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLCanvasView — a SleelaUI general animated drawing surface. It owns a double-buffered draw context sized to its bounds and, on every frame, invokes a developer draw routine that paints into that context with the comprehensive SleelaUI Draw API (see SLDrawContext), then presents and blits the result into the window. It is the host for custom visualisations and the substrate the SLThrobber is built on. The constructor bottoms out in the `uiCanvasView` built-in (SleelaUI C ABI slui_canvas_view()). The native toolkit drives the draw routine through a C function pointer each frame. From SLeeLa a draw routine is registered with the VM as a `ui*` draw handler keyed to this view's handle; the VM calls back into SLeeLa with an SLDrawContext bound to the view's per-frame surface, the animation time, and the per-frame delta. Set the refresh rate with setFps. An SLCanvasView IS an SLWidget and is an animated widget. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, int width, int height)</span></td><td class="desc">Create a canvas view inside `parent` with an initial pixel size.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, int width, int height)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setFps</code></td><td><span class="sig">void setFps(double fps)</span></td><td class="desc">The target refresh rate (frames per second) the window loop honours while this view is visible (0 = the window's default).</td></tr>
<tr><td><code>setDrawHandler</code></td><td><span class="sig">void setDrawHandler(int handlerId)</span></td><td class="desc">Register the draw routine for this view. `handlerId` is a VM draw-handler ordinal the host has bound to a SLeeLa method; the VM invokes it each frame with an SLDrawContext, the animation time, and the per-frame delta.</td></tr>
</table>
</div>
<h2 class="section" data-u="slcard">SLCard <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLCard.sleela)</span></h2>
<div data-u="slcard slcard">
<h3 id="SLCard">SLCard <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLCard — a SleelaUI raised surface panel: a rounded surface fill with a 1px hairline, padding, and a vertical stack of children. Use it to lift a related cluster of content off the window floor. The constructor bottoms out in the `uiCard` built-in (SleelaUI C ABI slui_card()); children are added by constructing control classes against this card's handle. An SLCard IS an SLWidget container. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent)</span></td><td class="desc">Create a card inside `parent`.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slcheckbox">SLCheckBox <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLCheckBox.sleela)</span></h2>
<div data-u="slcheckbox slcheckbox">
<h3 id="SLCheckBox">SLCheckBox <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLCheckBox — a SleelaUI labelled check box: a rounded square that shows an accent tick when on, with a trailing label. Flipping it (click, or Space/Enter while focused) toggles the boolean state and raises an activate event. The constructor bottoms out in the `uiCheckBox` built-in (SleelaUI C ABI slui_check_box()); the state is read/written through isChecked()/setChecked(). An SLCheckBox IS an SLWidget and is keyboard-focusable. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String label, boolean checked)</span></td><td class="desc">Create a check box inside `parent` with a label and initial state.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String label, boolean checked)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isChecked</code></td><td><span class="sig">boolean isChecked()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setChecked</code></td><td><span class="sig">void setChecked(boolean checked)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>changed</code></td><td><span class="sig">boolean changed()</span></td><td class="desc">True if the check box flipped since the last check (latch cleared on read).</td></tr>
</table>
</div>
<h2 class="section" data-u="slchip">SLChip <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLChip.sleela)</span></h2>
<div data-u="slchip slchip">
<h3 id="SLChip">SLChip <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLChip — a SleelaUI chip / tag: a rounded surface pill with a 1px hairline and text, used for filters, tags, or compact selections. The constructor bottoms out in the `uiChip` built-in (SleelaUI C ABI slui_chip()); the text is updated through the inherited setText(). An SLChip IS an SLWidget. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String text)</span></td><td class="desc">Create a chip inside `parent` with a label.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String text)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slcolor">SLColor <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLColor.sleela)</span></h2>
<div data-u="slcolor slcolor">
<h3 id="SLColor">SLColor <span class="pill">class</span></h3>
<p class="desc">Defines SLColor — a straight-alpha colour value for SleelaUI, packed as a single 0xRRGGBBAA word exactly as the toolkit's C ABI uses (SLUIColor). It provides the rgb()/rgba() builders (mirroring slui_rgb / slui_rgba) and channel accessors, so a SLeeLa program can compose a custom theme palette without touching native code. SLColor is a pure value helper — it holds no VM handle and makes no `ui*` calls; it only packs/unpacks the integer the theme built-ins consume. Family: user-interface.</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>packed</code></td><td><span class="sig">int packed</span></td><td class="desc">0xRRGGBBAA</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>rgb</code></td><td><span class="sig">void rgb(int r, int g, int b)</span></td><td class="desc">Opaque colour from 8-bit channels.</td></tr>
<tr><td><code>rgba</code></td><td><span class="sig">void rgba(int r, int g, int b, int a)</span></td><td class="desc">Colour with explicit alpha. Channels are masked to 0..255.</td></tr>
<tr><td><code>value</code></td><td><span class="sig">int value()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setValue</code></td><td><span class="sig">void setValue(int word)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>red</code></td><td><span class="sig">int red()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>green</code></td><td><span class="sig">int green()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>blue</code></td><td><span class="sig">int blue()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>alpha</code></td><td><span class="sig">int alpha()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slcombobox">SLComboBox <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLComboBox.sleela)</span></h2>
<div data-u="slcombobox slcombobox">
<h3 id="SLComboBox">SLComboBox <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLComboBox — a SleelaUI drop-down selection control: a rounded surface showing the current option and a chevron. Options are added with addOption(); clicking (or arrow keys while focused) advances the selection and raises an activate event. The constructor bottoms out in the `uiComboBox` built-in (SleelaUI C ABI slui_combo_box()); options are added via `uiComboBoxAdd` and the selected index is read/written through selectedIndex()/setSelectedIndex(). An SLComboBox IS an SLWidget and is keyboard-focusable. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent)</span></td><td class="desc">Create a combo box inside `parent`; add options afterwards.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>addOption</code></td><td><span class="sig">void addOption(String option)</span></td><td class="desc">Append a selectable option.</td></tr>
<tr><td><code>selectedIndex</code></td><td><span class="sig">double selectedIndex()</span></td><td class="desc">The currently-selected option index (0-based), as a value. The VM carries the index as a numeric; callers typically use selected() for the text.</td></tr>
<tr><td><code>setSelectedIndex</code></td><td><span class="sig">void setSelectedIndex(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>selected</code></td><td><span class="sig">String selected()</span></td><td class="desc">The currently-selected option text.</td></tr>
<tr><td><code>changed</code></td><td><span class="sig">boolean changed()</span></td><td class="desc">True if the selection changed since the last check (latch cleared on read).</td></tr>
</table>
</div>
<h2 class="section" data-u="sldrawcontext">SLDrawContext <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLDrawContext.sleela)</span></h2>
<div data-u="sldrawcontext sldrawcontext">
<h3 id="SLDrawContext">SLDrawContext <span class="pill">class</span></h3>
<p class="desc">Defines SLDrawContext — the SLeeLa binding of the comprehensive SleelaUI Draw API (user-interface/include/sleela_ui_draw.h). It is an owned RGBA pixel surface with an optional back buffer, giving a SLeeLa program the PIXELS: clear/present buffering, pixel-level get/set/blend, a blend mode and layer opacity, a clip stack, and the full primitive set — rects, rounded rects, lines, polylines, circles, ellipses, arcs, triangles, linear/radial gradients, text, and surface-to-surface blits. Every method bottoms out in a `draw*` SLVM built-in that calls the genuine Draw API, which renders with the toolkit's own software rasterizer (identical pixels on every OS). A draw context can be free-standing (an image you render and read back) or handed to you by an SLCanvasView's per-frame draw routine. It is a VM-local handle (-1 = none). Colours are 0xRRGGBBAA words (see SLColor). Family: user-interface. Native VM/UI work crosses the explicit `draw*` SLVM bridge.</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>BUFFER_SINGLE</code></td><td><span class="sig">static final int BUFFER_SINGLE = 0</span></td><td class="desc">Buffer-mode ordinals (mirror SLUIBufferMode).</td></tr>
<tr><td><code>BUFFER_DOUBLE</code></td><td><span class="sig">static final int BUFFER_DOUBLE = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>BLEND_OVER</code></td><td><span class="sig">static final int BLEND_OVER = 0</span></td><td class="desc">Blend-mode ordinals (mirror SLUIBlendMode).</td></tr>
<tr><td><code>BLEND_COPY</code></td><td><span class="sig">static final int BLEND_COPY = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>BLEND_ADD</code></td><td><span class="sig">static final int BLEND_ADD = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>BLEND_MULTIPLY</code></td><td><span class="sig">static final int BLEND_MULTIPLY = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>BLEND_SCREEN</code></td><td><span class="sig">static final int BLEND_SCREEN = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>BLEND_MAX</code></td><td><span class="sig">static final int BLEND_MAX = 5</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ORIENT_VERTICAL</code></td><td><span class="sig">static final int ORIENT_VERTICAL = 0</span></td><td class="desc">Orientation ordinals (mirror SLUIOrientation), for linear gradients.</td></tr>
<tr><td><code>ORIENT_HORIZONTAL</code></td><td><span class="sig">static final int ORIENT_HORIZONTAL = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dc</code></td><td><span class="sig">int dc</span></td><td class="desc">VM-local draw-context handle (-1 = none)</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>create</code></td><td><span class="sig">void create(int width, int height, int bufferMode)</span></td><td class="desc">Create a free-standing context of width x height device pixels.</td></tr>
<tr><td><code>adopt</code></td><td><span class="sig">void adopt(int handle)</span></td><td class="desc">Adopt a context handed in by an SLCanvasView draw routine.</td></tr>
<tr><td><code>handle</code></td><td><span class="sig">int handle()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>valid</code></td><td><span class="sig">boolean valid()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>destroy</code></td><td><span class="sig">void destroy()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>resize</code></td><td><span class="sig">void resize(int width, int height)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>width</code></td><td><span class="sig">int width()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>height</code></td><td><span class="sig">int height()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setBlend</code></td><td><span class="sig">void setBlend(int mode)</span></td><td class="desc">---- state --------------------------------------------------------------</td></tr>
<tr><td><code>setOpacity</code></td><td><span class="sig">void setOpacity(double value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clipPush</code></td><td><span class="sig">void clipPush(int x, int y, int w, int h)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clipPop</code></td><td><span class="sig">void clipPop()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clipReset</code></td><td><span class="sig">void clipReset()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clear</code></td><td><span class="sig">void clear(int color)</span></td><td class="desc">---- buffering ----------------------------------------------------------</td></tr>
<tr><td><code>present</code></td><td><span class="sig">void present()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setPixel</code></td><td><span class="sig">void setPixel(int x, int y, int color)</span></td><td class="desc">---- pixel-level control ------------------------------------------------</td></tr>
<tr><td><code>getPixel</code></td><td><span class="sig">int getPixel(int x, int y)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>blendPixel</code></td><td><span class="sig">void blendPixel(int x, int y, int color, double coverage)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fillRect</code></td><td><span class="sig">void fillRect(int x, int y, int w, int h, int color)</span></td><td class="desc">---- primitives ---------------------------------------------------------</td></tr>
<tr><td><code>fillRoundRect</code></td><td><span class="sig">void fillRoundRect(int x, int y, int w, int h, double radius, int color)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>strokeRect</code></td><td><span class="sig">void strokeRect(int x, int y, int w, int h, double thickness, int color)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>strokeRoundRect</code></td><td><span class="sig">void strokeRoundRect(int x, int y, int w, int h, double radius,</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>line</code></td><td><span class="sig">void line(double x0, double y0, double x1, double y1, double thickness,</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fillCircle</code></td><td><span class="sig">void fillCircle(double cx, double cy, double radius, int color)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>strokeCircle</code></td><td><span class="sig">void strokeCircle(double cx, double cy, double radius, double thickness,</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fillEllipse</code></td><td><span class="sig">void fillEllipse(double cx, double cy, double rx, double ry, int color)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>arc</code></td><td><span class="sig">void arc(double cx, double cy, double radius, double startRad,</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fillTriangle</code></td><td><span class="sig">void fillTriangle(double x0, double y0, double x1, double y1, double x2,</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>linearGradient</code></td><td><span class="sig">void linearGradient(int x, int y, int w, int h, int axis, int c0, int c1)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>radialGradient</code></td><td><span class="sig">void radialGradient(double cx, double cy, double radius, int inner, int outer)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>text</code></td><td><span class="sig">void text(String utf8, int x, int baseline, int color)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>blit</code></td><td><span class="sig">void blit(SLDrawContext src, int dx, int dy)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slentry">SLEntry <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLEntry.sleela)</span></h2>
<div data-u="slentry slentry">
<h3 id="SLEntry">SLEntry <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLEntry — a SleelaUI single-line text field: a rounded surface with a hairline (accent when focused), placeholder text when empty, a blinking-free caret, and full UTF-8 editing (insert, backspace, Home/End, left/right). The constructor bottoms out in the `uiEntry` built-in (SleelaUI C ABI slui_entry()); the committed text is read/written through the inherited text()/setText(), and Enter raises an activate event. An SLEntry IS an SLWidget and is keyboard-focusable. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String placeholder)</span></td><td class="desc">Create an entry inside `parent` with placeholder text (shown when empty).</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String placeholder)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>submitted</code></td><td><span class="sig">boolean submitted()</span></td><td class="desc">True if Enter was pressed since the last check (latch cleared on read).</td></tr>
</table>
</div>
<h2 class="section" data-u="slfont">SLFont <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLFont.sleela)</span></h2>
<div data-u="slfont slfont">
<h3 id="SLFont">SLFont <span class="pill">class</span></h3>
<p class="desc">Defines SLFont — a SleelaUI font for Sleela and her UI. A font bundles a face (family, size, weight, slant, letter spacing, line height) with an ordered stack of SLFontEffect entries — drop/inner shadows, a soft glow, a directional light sheen, an EMITTER (text that radiates light into a scene), an outline, a relief emboss/engrave, and a gradient fill — plus a QUALITY level (draft .. ultra) that trades samples for smoothness, so a program can "choose many quality effects". Each method bottoms out in a `font*` SLVM built-in that calls the SleelaUI Font C ABI (sleela_ui_font.h); the look comes from the toolkit's own rasterizer, so a styled string is pixel-identical on every OS. A font is a VM-local handle (-1 = none). Attach it to a text widget with SLWidget.setFont (uiWidgetSetFont) to render that widget's label with the font's effects, or draw directly into an SLDrawContext. Family: user-interface. Native VM/UI work crosses the explicit `font*` SLVM bridge.</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>THIN</code></td><td><span class="sig">static final int THIN = 100</span></td><td class="desc">Weight ordinals (mirror SLUIFontWeight).</td></tr>
<tr><td><code>LIGHT</code></td><td><span class="sig">static final int LIGHT = 300</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>REGULAR</code></td><td><span class="sig">static final int REGULAR = 400</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MEDIUM</code></td><td><span class="sig">static final int MEDIUM = 500</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEMIBOLD</code></td><td><span class="sig">static final int SEMIBOLD = 600</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>BOLD</code></td><td><span class="sig">static final int BOLD = 700</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>BLACK</code></td><td><span class="sig">static final int BLACK = 900</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>UPRIGHT</code></td><td><span class="sig">static final int UPRIGHT = 0</span></td><td class="desc">Slant ordinals (mirror SLUIFontSlant).</td></tr>
<tr><td><code>ITALIC</code></td><td><span class="sig">static final int ITALIC = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>OBLIQUE</code></td><td><span class="sig">static final int OBLIQUE = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>QUALITY_DRAFT</code></td><td><span class="sig">static final int QUALITY_DRAFT = 0</span></td><td class="desc">Quality ordinals (mirror SLUIFontQuality).</td></tr>
<tr><td><code>QUALITY_LOW</code></td><td><span class="sig">static final int QUALITY_LOW = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>QUALITY_MEDIUM</code></td><td><span class="sig">static final int QUALITY_MEDIUM = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>QUALITY_HIGH</code></td><td><span class="sig">static final int QUALITY_HIGH = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>QUALITY_ULTRA</code></td><td><span class="sig">static final int QUALITY_ULTRA = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>font</code></td><td><span class="sig">int font</span></td><td class="desc">VM-local font handle (-1 = none)</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>create</code></td><td><span class="sig">void create(String family, double sizePt)</span></td><td class="desc">Create a font with a family ("system"/"mono"/a real face) and point size.</td></tr>
<tr><td><code>handle</code></td><td><span class="sig">int handle()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>valid</code></td><td><span class="sig">boolean valid()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>destroy</code></td><td><span class="sig">void destroy()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setFamily</code></td><td><span class="sig">void setFamily(String family)</span></td><td class="desc">---- face attributes ----------------------------------------------------</td></tr>
<tr><td><code>setSize</code></td><td><span class="sig">void setSize(double sizePt)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setWeight</code></td><td><span class="sig">void setWeight(int weight)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setSlant</code></td><td><span class="sig">void setSlant(int slant)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setLetterSpacing</code></td><td><span class="sig">void setLetterSpacing(double px)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setLineHeight</code></td><td><span class="sig">void setLineHeight(double multiple)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setQuality</code></td><td><span class="sig">void setQuality(int quality)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>size</code></td><td><span class="sig">double size()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>addEffect</code></td><td><span class="sig">void addEffect(SLFontEffect e)</span></td><td class="desc">---- effect stack ------------------------------------------------------- Add an effect (applied back-to-front in add order).</td></tr>
<tr><td><code>clearEffects</code></td><td><span class="sig">void clearEffects()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>effectCount</code></td><td><span class="sig">int effectCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>measure</code></td><td><span class="sig">double measure(String utf8)</span></td><td class="desc">---- measuring ----------------------------------------------------------</td></tr>
<tr><td><code>ascent</code></td><td><span class="sig">double ascent()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>descent</code></td><td><span class="sig">double descent()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lineHeight</code></td><td><span class="sig">double lineHeight()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>draw</code></td><td><span class="sig">void draw(SLDrawContext dc, String utf8, int x, int baseline, int color)</span></td><td class="desc">---- drawing ------------------------------------------------------------ Draw into an SLDrawContext with the full effect stack at (x, baseline).</td></tr>
<tr><td><code>emitInto</code></td><td><span class="sig">int emitInto(SLLightScene scene, int x, int baseline, String utf8)</span></td><td class="desc">If this font carries an EMITTER effect, register that emission into a light scene for text drawn at (x, baseline). A pure emitter reserves nothing; an anchored one binds as a source. Returns the light index or an error.</td></tr>
</table>
</div>
<h2 class="section" data-u="slfonteffect">SLFontEffect <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLFontEffect.sleela)</span></h2>
<div data-u="slfonteffect slfonteffect">
<h3 id="SLFontEffect">SLFontEffect <span class="pill">class</span></h3>
<p class="desc">Defines SLFontEffect — one entry in an SLFont's effect stack. An effect is a drop/inner shadow, a soft glow, a directional light sheen, an EMITTER (the text radiates light into a scene — reserving nothing as an emitter, or binding as a source on an anchor), an outline, a relief emboss/engrave, or a gradient fill. It is a pure value object the host fills with the builder methods and adds to an SLFont; the font applies the stack back-to-front when drawing. Mirrors SLUIFontEffect in the SleelaUI Font C ABI (sleela_ui_font.h). Family: user-interface.</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>DROP_SHADOW</code></td><td><span class="sig">static final int DROP_SHADOW = 0</span></td><td class="desc">Effect-type ordinals (mirror SLUIFontEffectType).</td></tr>
<tr><td><code>INNER_SHADOW</code></td><td><span class="sig">static final int INNER_SHADOW = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>GLOW</code></td><td><span class="sig">static final int GLOW = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>LIGHT</code></td><td><span class="sig">static final int LIGHT = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>EMITTER</code></td><td><span class="sig">static final int EMITTER = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>OUTLINE</code></td><td><span class="sig">static final int OUTLINE = 5</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>RELIEF</code></td><td><span class="sig">static final int RELIEF = 6</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>GRADIENT_FILL</code></td><td><span class="sig">static final int GRADIENT_FILL= 7</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>EMBOSSED</code></td><td><span class="sig">static final int EMBOSSED = 0</span></td><td class="desc">Relief direction (mirror SLUIFontRelief).</td></tr>
<tr><td><code>ENGRAVED</code></td><td><span class="sig">static final int ENGRAVED = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>type</code></td><td><span class="sig">int type</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>color</code></td><td><span class="sig">int color</span></td><td class="desc">shadow/glow/light/outline/emitter colour (0xRRGGBBAA)</td></tr>
<tr><td><code>color2</code></td><td><span class="sig">int color2</span></td><td class="desc">gradient bottom colour</td></tr>
<tr><td><code>blur</code></td><td><span class="sig">double blur</span></td><td class="desc">shadow/glow softness radius (px)</td></tr>
<tr><td><code>size</code></td><td><span class="sig">double size</span></td><td class="desc">outline width / relief depth / emitter radius (px)</td></tr>
<tr><td><code>intensity</code></td><td><span class="sig">double intensity</span></td><td class="desc">0..N strength (glow/light/emitter/relief)</td></tr>
<tr><td><code>opacity</code></td><td><span class="sig">double opacity</span></td><td class="desc">0..1 effect opacity</td></tr>
<tr><td><code>relief</code></td><td><span class="sig">int relief</span></td><td class="desc">EMBOSSED / ENGRAVED for a RELIEF effect</td></tr>
<tr><td><code>reservedAnchor</code></td><td><span class="sig">int reservedAnchor</span></td><td class="desc">EMITTER: -1 reserve nothing; >=0 bind as a source</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>base</code></td><td><span class="sig">void base(int t)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dropShadow</code></td><td><span class="sig">void dropShadow(double ox, double oy, double softness, int c)</span></td><td class="desc">An offset, blurred, dark copy behind the glyph.</td></tr>
<tr><td><code>innerShadow</code></td><td><span class="sig">void innerShadow(double ox, double oy, double softness, int c)</span></td><td class="desc">Shadow inside the glyph (a pressed-in look).</td></tr>
<tr><td><code>glow</code></td><td><span class="sig">void glow(double radius, double i, int c)</span></td><td class="desc">A soft coloured halo around the glyph.</td></tr>
<tr><td><code>light</code></td><td><span class="sig">void light(double ux, double uy, double i, int c)</span></td><td class="desc">A directional sheen lighting the glyph face.</td></tr>
<tr><td><code>emitter</code></td><td><span class="sig">void emitter(double radius, double i, int c, int anchor)</span></td><td class="desc">The text radiates light into a scene. anchor < 0 => a pure emitter (reserves nothing); anchor >= 0 => bind as a light SOURCE on that anchor.</td></tr>
<tr><td><code>outline</code></td><td><span class="sig">void outline(double width, int c)</span></td><td class="desc">A stroked edge of a chosen width + colour.</td></tr>
<tr><td><code>reliefEffect</code></td><td><span class="sig">void reliefEffect(int direction, double depth, double i)</span></td><td class="desc">Emboss/engrave the glyph using lighting normals.</td></tr>
<tr><td><code>gradientFill</code></td><td><span class="sig">void gradientFill(int top, int bottom)</span></td><td class="desc">Fill the glyph with a vertical gradient.</td></tr>
</table>
</div>
<h2 class="section" data-u="slframe">SLFrame <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLFrame.sleela)</span></h2>
<div data-u="slframe slframe">
<h3 id="SLFrame">SLFrame <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLFrame — a SleelaUI titled, bordered group container: a 1px hairline rectangle with an optional dim title in the top-left, holding a vertical stack of children. Use it to visually group related controls. The constructor bottoms out in the `uiFrame` built-in (SleelaUI C ABI slui_frame()); children are added by constructing control classes against this frame's handle, and the title is updated through the inherited setText(). An SLFrame IS an SLWidget container. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String title)</span></td><td class="desc">Create a frame inside `parent` with a title (pass "" for no title).</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String title)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slframeclock">SLFrameClock <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLFrameClock.sleela)</span></h2>
<div data-u="slframeclock slframeclock">
<h3 id="SLFrameClock">SLFrameClock <span class="pill">class</span></h3>
<p class="desc">Defines SLFrameClock — the SLeeLa binding of the SleelaUI Draw API's refresh-rate controller. It paces a render loop: a target rate (FPS), a per-frame delta time, an elapsed animation clock, a smoothed measured rate, a sleep hint so the loop idles instead of busy-spinning, and a fixed-timestep accumulator for deterministic field/physics updates regardless of frame rate. Every method bottoms out in a `draw*` SLVM built-in that calls the genuine frame-clock API. Typical loop: SLFrameClock fc = new SLFrameClock(); fc.create(60.0); while (running) { double dt = fc.tick(); update(dt); draw(dc); dc.present(); int ms = fc.sleepHint(); if (ms > 0) host.sleep(ms); } A frame clock is a VM-local handle (-1 = none). Family: user-interface. Native VM/UI work crosses the explicit `draw*` SLVM bridge.</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>fc</code></td><td><span class="sig">int fc</span></td><td class="desc">VM-local frame-clock handle (-1 = none)</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>create</code></td><td><span class="sig">void create(double targetFps)</span></td><td class="desc">Create a frame clock with a target refresh rate (0 = unthrottled).</td></tr>
<tr><td><code>handle</code></td><td><span class="sig">int handle()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>valid</code></td><td><span class="sig">boolean valid()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>destroy</code></td><td><span class="sig">void destroy()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setFps</code></td><td><span class="sig">void setFps(double targetFps)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fps</code></td><td><span class="sig">double fps()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tick</code></td><td><span class="sig">double tick()</span></td><td class="desc">Advance one frame; returns the delta time in seconds since the last tick.</td></tr>
<tr><td><code>elapsed</code></td><td><span class="sig">double elapsed()</span></td><td class="desc">Seconds since the clock was created (monotonic animation time).</td></tr>
<tr><td><code>measuredFps</code></td><td><span class="sig">double measuredFps()</span></td><td class="desc">The smoothed frames-per-second actually being achieved.</td></tr>
<tr><td><code>sleepHint</code></td><td><span class="sig">int sleepHint()</span></td><td class="desc">Milliseconds the caller should idle to hit the target rate (0 if behind).</td></tr>
<tr><td><code>fixedStep</code></td><td><span class="sig">boolean fixedStep(double step)</span></td><td class="desc">Fixed-timestep drain: after tick(), call repeatedly, running one fixed `step`-second update each time it returns true, until it returns false.</td></tr>
</table>
</div>
<h2 class="section" data-u="slgallerydemo">SLGalleryDemo <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLGalleryDemo.sleela)</span></h2>
<div data-u="slgallerydemo slgallerydemo">
<h3 id="SLGalleryDemo">SLGalleryDemo <span class="pill">class</span></h3>
<p class="desc">Defines SLGalleryDemo — a worked, runnable example that builds a complete Slick Black window from pure SLeeLa source using the /lib/user-interface classes. It opens an application, raises a window with a header bar and the full control set (label, entry, suggested/destructive buttons, toggle, slider, separator, a disabled button, a status line), and runs the toolkit's event loop. It is the SLeeLa-source twin of the native C gallery in /user-interface/examples/gallery.c, proving the toolkit is fully usable from the language itself. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>ui</code></td><td><span class="sig">SLUserInterface ui</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>win</code></td><td><span class="sig">SLWindow win</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>save</code></td><td><span class="sig">SLButton save</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dark</code></td><td><span class="sig">SLToggle dark</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>opacity</code></td><td><span class="sig">SLSlider opacity</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>run</code></td><td><span class="sig">int run()</span></td><td class="desc">Build the whole interface and return the application exit code.</td></tr>
</table>
</div>
<h2 class="section" data-u="slgrid">SLGrid <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLGrid.sleela)</span></h2>
<div data-u="slgrid slgrid">
<h3 id="SLGrid">SLGrid <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLGrid — a SleelaUI fixed row/column grid container. Children fill cells in row-major order across a fixed number of columns; the grid sizes every cell to the largest child and spreads them to fill the available width. Use it for form layouts and tiles. The constructor bottoms out in the `uiGrid` built-in (SleelaUI C ABI slui_grid()); children are added by constructing control classes against this grid's handle. An SLGrid IS an SLWidget container. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, int columns, int spacing)</span></td><td class="desc">Create a grid inside `parent` with a column count and a spacing (px) applied between both rows and columns.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, int columns, int spacing)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slguiapp">SLGuiApp <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLGuiApp.sleela)</span></h2>
<div data-u="slguiapp slguiapp">
<h3 id="SLGuiApp">SLGuiApp <span class="pill">class</span></h3>
<p class="desc">Defines SLGuiApp — the top-level support structure that ties the whole /lib/gui dynamic stack together into one object: it opens a SleelaUI application and window (via /lib/user-interface), owns the SLeeLa DOM (SLGuiDom), the reconciler (SLGuiMount) that projects the DOM onto widgets, the host adapter (SLGuiHostAdapter) that raises widget activations back as events, and an optional script engine (SLGuiScript). Its run loop pumps the toolkit event loop, polls widget activations into the event bus, re-mounts any newly-created nodes, and reconciles dirty nodes each turn. This is the "basic support structure" a program (or the IDE) builds on: construct the DOM declaratively or by script, bind callbacks, and call run(). Family: user-interface. SLeeLa owns the DOM, dispatch, and script execution; SleelaUI owns presentation; this object is the wiring between them.</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>ui</code></td><td><span class="sig">SLUserInterface ui</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>window</code></td><td><span class="sig">SLWindow window</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dom</code></td><td><span class="sig">SLGuiDom dom</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>mount</code></td><td><span class="sig">SLGuiMount mount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>host</code></td><td><span class="sig">SLGuiHostAdapter host</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>script</code></td><td><span class="sig">SLGuiScript script</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ready</code></td><td><span class="sig">int ready</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>boot</code></td><td><span class="sig">boolean boot(String appId, String title, int width, int height)</span></td><td class="desc">Open the application + window and stand up the DOM/mount/host wiring. Returns true when the toolkit came up (false on a headless host).</td></tr>
<tr><td><code>isReady</code></td><td><span class="sig">boolean isReady()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>document</code></td><td><span class="sig">SLGuiDom document()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>scripting</code></td><td><span class="sig">SLGuiScript scripting()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hostWindow</code></td><td><span class="sig">SLWindow hostWindow()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>add</code></td><td><span class="sig">SLGuiNode add(String parentId, String tag, String id)</span></td><td class="desc">Convenience: append an element to a parent in the DOM (then mount+show on the next loop turn, or immediately via refresh()).</td></tr>
<tr><td><code>onClick</code></td><td><span class="sig">SLGuiHandler onClick(String id, String operation)</span></td><td class="desc">Bind a click callback (DHTML onClick) by node id.</td></tr>
<tr><td><code>runScript</code></td><td><span class="sig">int runScript()</span></td><td class="desc">Run a UI script against the DOM (build + bind + fire), then refresh.</td></tr>
<tr><td><code>run</code></td><td><span class="sig">int run()</span></td><td class="desc">Mount everything, show the window, then run the toolkit event loop: pump -> poll activations -> mount new nodes -> reconcile. Returns the process-style exit code.</td></tr>
<tr><td><code>refresh</code></td><td><span class="sig">void refresh()</span></td><td class="desc">A single synchronous refresh (mount new + reconcile) without the loop, for building a UI up front or driving it from a test/host step.</td></tr>
<tr><td><code>step</code></td><td><span class="sig">int step(boolean block)</span></td><td class="desc">Pump one turn (pump + poll + refresh); returns events raised this turn.</td></tr>
<tr><td><code>quit</code></td><td><span class="sig">void quit(int code)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>shutdown</code></td><td><span class="sig">void shutdown()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slguidom">SLGuiDom <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLGuiDom.sleela)</span></h2>
<div data-u="slguidom slguidom">
<h3 id="SLGuiDom">SLGuiDom <span class="pill">class</span></h3>
<p class="desc">Defines SLGuiDom — the DHTML-style document model for /lib/gui: a flat registry of SLGuiNode elements forming a tree, plus the manipulation API a browser DOM exposes — createElement, getElementById, appendChild, removeChild, setText/setAttribute/setStyle on an id, show/hide, and a simple getElementsByTag / querySelector-by-attribute lookup. It owns an SLGuiEventBus so handlers bind to node ids (onClick, onInput, on(type,...), addEventListener) and raised events route to SLeeLa operations. The DOM is the single SLeeLa-owned source of truth; a host walks the dirty nodes and mirrors them onto real SleelaUI widgets. Family: user-interface. SLeeLa owns the document and dispatch; the host mounts and paints it.</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>MAX_NODES</code></td><td><span class="sig">static final int MAX_NODES = 65536</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>nodes</code></td><td><span class="sig">SLGuiNode[] nodes</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"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>rootId</code></td><td><span class="sig">String rootId</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">SLGuiEventBus bus</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>types</code></td><td><span class="sig">SLGuiEventType types</span></td><td class="desc">name<->ordinal helper</td></tr>
<tr><td><code>idSeq</code></td><td><span class="sig">int idSeq</span></td><td class="desc">auto-id counter for createElement without an id</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>init</code></td><td><span class="sig">void init()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>events</code></td><td><span class="sig">SLGuiEventBus events()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>size</code></td><td><span class="sig">int size()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>createElement</code></td><td><span class="sig">SLGuiNode createElement(String tag, String id)</span></td><td class="desc">createElement(tag, id): id "" generates a stable auto id ("n<seq>").</td></tr>
<tr><td><code>createRoot</code></td><td><span class="sig">SLGuiNode createRoot(String tag, String id)</span></td><td class="desc">The document root (the window element). Created once.</td></tr>
<tr><td><code>root</code></td><td><span class="sig">SLGuiNode root()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getElementById</code></td><td><span class="sig">SLGuiNode getElementById(String id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>indexOfId</code></td><td><span class="sig">int indexOfId(String id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>appendChild</code></td><td><span class="sig">boolean appendChild(String parentId, String childId)</span></td><td class="desc">appendChild(parentId, childId): link child under parent in both directions.</td></tr>
<tr><td><code>appendElement</code></td><td><span class="sig">SLGuiNode appendElement(String parentId, String tag, String id)</span></td><td class="desc">Convenience: create a child element already appended to a parent.</td></tr>
<tr><td><code>removeChild</code></td><td><span class="sig">boolean removeChild(String childId)</span></td><td class="desc">removeChild: detach from parent, remove its handlers, and drop the node (and recursively its subtree).</td></tr>
<tr><td><code>setText</code></td><td><span class="sig">void setText(String id, String text)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setAttribute</code></td><td><span class="sig">void setAttribute(String id, String name, String value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setStyle</code></td><td><span class="sig">void setStyle(String id, String prop, String value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>show</code></td><td><span class="sig">void show(String id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hide</code></td><td><span class="sig">void hide(String id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setEnabled</code></td><td><span class="sig">void setEnabled(String id, boolean on)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getElementsByTag</code></td><td><span class="sig">int getElementsByTag(String tag, String[] out, int cap)</span></td><td class="desc">Fill `out` with the ids of every node with the given tag; returns the count.</td></tr>
<tr><td><code>querySelectorByAttr</code></td><td><span class="sig">String querySelectorByAttr(String name, String value)</span></td><td class="desc">Return the first node id whose attribute `name` equals `value` (or null).</td></tr>
<tr><td><code>addEventListener</code></td><td><span class="sig">SLGuiHandler addEventListener(String id, String eventName, String operation)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>removeEventListener</code></td><td><span class="sig">boolean removeEventListener(String id, String eventName, String operation)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>onClick</code></td><td><span class="sig">SLGuiHandler onClick(String id, String operation)</span></td><td class="desc">Shorthands mirroring onclick=/oninput= style bindings.</td></tr>
<tr><td><code>onInput</code></td><td><span class="sig">SLGuiHandler onInput(String id, String operation)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>onChange</code></td><td><span class="sig">SLGuiHandler onChange(String id, String operation)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>onKeyDown</code></td><td><span class="sig">SLGuiHandler onKeyDown(String id, String operation)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>onSubmit</code></td><td><span class="sig">SLGuiHandler onSubmit(String id, String operation)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dispatchEvent</code></td><td><span class="sig">int dispatchEvent(SLGuiEvent event)</span></td><td class="desc">The host raises an activation on a node; dispatch it through the bus. Returns how many handlers fired.</td></tr>
<tr><td><code>fire</code></td><td><span class="sig">int fire(int eventType, String targetId, String value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dirtyCount</code></td><td><span class="sig">int dirtyCount()</span></td><td class="desc">The number of nodes needing a host re-sync (dirty), for the mount walk.</td></tr>
<tr><td><code>nodeAt</code></td><td><span class="sig">SLGuiNode nodeAt(int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>autoId</code></td><td><span class="sig">String autoId()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>removeSubtree</code></td><td><span class="sig">void removeSubtree(String id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>removeNode</code></td><td><span class="sig">void removeNode(String id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slguievent">SLGuiEvent <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLGuiEvent.sleela)</span></h2>
<div data-u="slguievent slguievent">
<h3 id="SLGuiEvent">SLGuiEvent <span class="pill">class</span></h3>
<p class="desc">Defines SLGuiEvent — one dispatched GUI event, the DHTML-style event object a handler receives. It names the event type (an SLGuiEventType ordinal), the target node id it was raised on, and the payload the kind carries: a string value (entry text / changed value), a key name (for key events), pointer coordinates (for pointer events), and a toggle state. It also carries the two propagation controls a handler can set — preventDefault() and stopPropagation() — exactly like a browser event, so SLeeLa handlers can cancel the host's default action or halt bubbling. Family: user-interface. The host raises the activation; SLeeLa reads this event and decides what it means.</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>type</code></td><td><span class="sig">int type</span></td><td class="desc">SLGuiEventType ordinal</td></tr>
<tr><td><code>targetId</code></td><td><span class="sig">String targetId</span></td><td class="desc">the node id the event was raised on</td></tr>
<tr><td><code>value</code></td><td><span class="sig">String value</span></td><td class="desc">string payload (entry text, changed value, custom data)</td></tr>
<tr><td><code>key</code></td><td><span class="sig">String key</span></td><td class="desc">key name for KEYDOWN/KEYUP (e.g. "Enter", "a")</td></tr>
<tr><td><code>x</code></td><td><span class="sig">int x</span></td><td class="desc">pointer x within the target (pointer events)</td></tr>
<tr><td><code>y</code></td><td><span class="sig">int y</span></td><td class="desc">pointer y within the target (pointer events)</td></tr>
<tr><td><code>toggleState</code></td><td><span class="sig">int toggleState</span></td><td class="desc">1/0 for TOGGLE events</td></tr>
<tr><td><code>defaultPrevented</code></td><td><span class="sig">int defaultPrevented</span></td><td class="desc">1 once preventDefault() is called</td></tr>
<tr><td><code>propagationStopped</code></td><td><span class="sig">int propagationStopped</span></td><td class="desc">1 once stopPropagation() is called</td></tr>
<tr><td><code>timestamp</code></td><td><span class="sig">int timestamp</span></td><td class="desc">host-supplied monotonic tick (0 if unknown)</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 eventType, String target)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getType</code></td><td><span class="sig">int getType()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>target</code></td><td><span class="sig">String target()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setValue</code></td><td><span class="sig">void setValue(String v)</span></td><td class="desc">Payload setters (the host fills in what the kind carries).</td></tr>
<tr><td><code>getValue</code></td><td><span class="sig">String getValue()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setKey</code></td><td><span class="sig">void setKey(String k)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getKey</code></td><td><span class="sig">String getKey()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setPointer</code></td><td><span class="sig">void setPointer(int px, int py)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pointerX</code></td><td><span class="sig">int pointerX()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pointerY</code></td><td><span class="sig">int pointerY()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setToggle</code></td><td><span class="sig">void setToggle(int on)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>toggledOn</code></td><td><span class="sig">boolean toggledOn()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setTimestamp</code></td><td><span class="sig">void setTimestamp(int t)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>when</code></td><td><span class="sig">int when()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>preventDefault</code></td><td><span class="sig">void preventDefault()</span></td><td class="desc">DHTML-style propagation controls.</td></tr>
<tr><td><code>isDefaultPrevented</code></td><td><span class="sig">boolean isDefaultPrevented()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>stopPropagation</code></td><td><span class="sig">void stopPropagation()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isPropagationStopped</code></td><td><span class="sig">boolean isPropagationStopped()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slguieventbus">SLGuiEventBus <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLGuiEventBus.sleela)</span></h2>
<div data-u="slguieventbus slguieventbus">
<h3 id="SLGuiEventBus">SLGuiEventBus <span class="pill">class</span></h3>
<p class="desc">Defines SLGuiEventBus — the event dispatcher and listener table for the /lib/gui event layer. It is the engine behind addEventListener / removeEventListener and the onClick/onInput shorthands: handlers register against a (type, target) pair, and dispatch(event) delivers a raised SLGuiEvent to every matching SLGuiHandler, honouring the DHTML-style phase order (capture handlers first, then target/bubble), stopPropagation() to halt delivery, and once handlers that auto-remove after firing. The bus is the SLeeLa-owned meaning layer: the host raises typed activations, the bus routes them to the bound operations. Family: user-interface. SLeeLa owns dispatch and the meaning of events; the host only raises them.</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>MAX_HANDLERS</code></td><td><span class="sig">static final int MAX_HANDLERS = 8192</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>handlers</code></td><td><span class="sig">SLGuiHandler[] handlers</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"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lastDelivered</code></td><td><span class="sig">int lastDelivered</span></td><td class="desc">how many handlers the last dispatch fired</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>init</code></td><td><span class="sig">void init()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>size</code></td><td><span class="sig">int size()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>addListener</code></td><td><span class="sig">SLGuiHandler addListener(String targetId, int eventType, String operation)</span></td><td class="desc">addEventListener(target, type, operation): register a handler and return it.</td></tr>
<tr><td><code>addListenerEx</code></td><td><span class="sig">SLGuiHandler addListenerEx(String targetId, int eventType, String operation,</span></td><td class="desc">addEventListener with options (once / capture).</td></tr>
<tr><td><code>removeListener</code></td><td><span class="sig">boolean removeListener(String targetId, int eventType, String operation)</span></td><td class="desc">removeEventListener: drop the first handler matching (target, type, op).</td></tr>
<tr><td><code>removeTarget</code></td><td><span class="sig">int removeTarget(String targetId)</span></td><td class="desc">Remove every handler bound to a target (used when a node is destroyed).</td></tr>
<tr><td><code>dispatch</code></td><td><span class="sig">int dispatch(SLGuiEvent event)</span></td><td class="desc">Dispatch a raised event: capture-phase handlers first, then bubble-phase, stopping early if a handler calls stopPropagation(). once handlers are removed after they fire. Returns the number of handlers that fired.</td></tr>
<tr><td><code>deliverPhase</code></td><td><span class="sig">void deliverPhase(SLGuiEvent event, boolean capturePhase)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>raise</code></td><td><span class="sig">int raise(int eventType, String targetId, String value)</span></td><td class="desc">Convenience: build and dispatch a simple typed event with a string value.</td></tr>
<tr><td><code>poll</code></td><td><span class="sig">boolean poll(SLGuiHandler handler)</span></td><td class="desc">Poll a handler's latch (for hosts that poll rather than get called back).</td></tr>
<tr><td><code>deliveredLast</code></td><td><span class="sig">int deliveredLast()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>removeAt</code></td><td><span class="sig">void removeAt(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>sweepOnce</code></td><td><span class="sig">void sweepOnce()</span></td><td class="desc">Remove handlers flagged once that have fired at least once.</td></tr>
</table>
</div>
<h2 class="section" data-u="slguieventtype">SLGuiEventType <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLGuiEventType.sleela)</span></h2>
<div data-u="slguieventtype slguieventtype">
<h3 id="SLGuiEventType">SLGuiEventType <span class="pill">class</span></h3>
<p class="desc">Defines SLGuiEventType — the catalogue of GUI event kinds the /lib/gui event layer understands. These are the SLeeLa-facing names a handler binds to (the DHTML-style "click", "input", "change", "keydown", ...). The host raises one of these on a target; SLeeLa decides what it means. Each kind has a stable ordinal (used by the dispatch tables) and a canonical lowercase name (the string an onX binding or addEventListener uses), mirroring the activation model already in SLGuiAction. Family: user-interface. Java/native raise typed activations; SLeeLa owns their meaning.</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>CLICK</code></td><td><span class="sig">static final int CLICK = 0</span></td><td class="desc">Ordinals (stable; used as table indices). a primary activation (click / Enter / Space)</td></tr>
<tr><td><code>DBLCLICK</code></td><td><span class="sig">static final int DBLCLICK = 1</span></td><td class="desc">a double activation</td></tr>
<tr><td><code>INPUT</code></td><td><span class="sig">static final int INPUT = 2</span></td><td class="desc">live text input (per keystroke)</td></tr>
<tr><td><code>CHANGE</code></td><td><span class="sig">static final int CHANGE = 3</span></td><td class="desc">a committed value change (blur/Enter)</td></tr>
<tr><td><code>FOCUS</code></td><td><span class="sig">static final int FOCUS = 4</span></td><td class="desc">the target gained focus</td></tr>
<tr><td><code>BLUR</code></td><td><span class="sig">static final int BLUR = 5</span></td><td class="desc">the target lost focus</td></tr>
<tr><td><code>KEYDOWN</code></td><td><span class="sig">static final int KEYDOWN = 6</span></td><td class="desc">a key went down while focused</td></tr>
<tr><td><code>KEYUP</code></td><td><span class="sig">static final int KEYUP = 7</span></td><td class="desc">a key came up while focused</td></tr>
<tr><td><code>POINTERDOWN</code></td><td><span class="sig">static final int POINTERDOWN= 8</span></td><td class="desc">a pointer press began on the target</td></tr>
<tr><td><code>POINTERUP</code></td><td><span class="sig">static final int POINTERUP = 9</span></td><td class="desc">a pointer press ended on the target</td></tr>
<tr><td><code>POINTERMOVE</code></td><td><span class="sig">static final int POINTERMOVE=10</span></td><td class="desc">the pointer moved over the target</td></tr>
<tr><td><code>SCROLL</code></td><td><span class="sig">static final int SCROLL =11</span></td><td class="desc">the target scrolled</td></tr>
<tr><td><code>SUBMIT</code></td><td><span class="sig">static final int SUBMIT =12</span></td><td class="desc">a form-like submit (Enter in an entry)</td></tr>
<tr><td><code>TOGGLE</code></td><td><span class="sig">static final int TOGGLE =13</span></td><td class="desc">a toggle/checkbox flipped</td></tr>
<tr><td><code>CUSTOM</code></td><td><span class="sig">static final int CUSTOM =14</span></td><td class="desc">a host- or script-defined event</td></tr>
<tr><td><code>COUNT</code></td><td><span class="sig">static final int COUNT =15</span></td><td class="desc">number of defined event kinds</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>nameOf</code></td><td><span class="sig">String nameOf(int type)</span></td><td class="desc">The canonical lowercase name for an ordinal (the addEventListener string).</td></tr>
<tr><td><code>typeOf</code></td><td><span class="sig">int typeOf(String name)</span></td><td class="desc">The ordinal for a canonical name (-1 when the name is not recognised).</td></tr>
<tr><td><code>valid</code></td><td><span class="sig">boolean valid(int type)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slguihandler">SLGuiHandler <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLGuiHandler.sleela)</span></h2>
<div data-u="slguihandler slguihandler">
<h3 id="SLGuiHandler">SLGuiHandler <span class="pill">class</span></h3>
<p class="desc">Defines SLGuiHandler — one registered event callback: the triple (event type, target node id, SLeeLa operation). It is the /lib/gui generalisation of SLGuiAction from a single click to any SLGuiEventType, and it is what addEventListener(target, type, operation) and the onClick/onInput shorthands create. When the dispatcher matches a raised SLGuiEvent to this handler it invokes the bound operation; the handler latches each fire so a host that polls (rather than calls back) still observes each activation exactly once, the same take-the-latch discipline as SLGuiAction. Family: user-interface. The host raises activations; this binding maps them to a SLeeLa operation whose meaning SLeeLa owns.</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>type</code></td><td><span class="sig">int type</span></td><td class="desc">SLGuiEventType ordinal this handler listens for</td></tr>
<tr><td><code>targetId</code></td><td><span class="sig">String targetId</span></td><td class="desc">node id it is bound to ("*" matches any target)</td></tr>
<tr><td><code>operation</code></td><td><span class="sig">String operation</span></td><td class="desc">the SLeeLa operation invoked when it fires</td></tr>
<tr><td><code>once</code></td><td><span class="sig">int once</span></td><td class="desc">1 = auto-remove after the first fire</td></tr>
<tr><td><code>capture</code></td><td><span class="sig">int capture</span></td><td class="desc">1 = fire during capture phase, 0 = bubble phase</td></tr>
<tr><td><code>enabled</code></td><td><span class="sig">int enabled</span></td><td class="desc">1 while active</td></tr>
<tr><td><code>pending</code></td><td><span class="sig">int pending</span></td><td class="desc">activation latch (set on fire, cleared on take)</td></tr>
<tr><td><code>fired</code></td><td><span class="sig">int fired</span></td><td class="desc">total times fired</td></tr>
<tr><td><code>lastValue</code></td><td><span class="sig">String lastValue</span></td><td class="desc">the value carried by the most recent matching event</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 eventType, String target, String op)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getType</code></td><td><span class="sig">int getType()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getTarget</code></td><td><span class="sig">String getTarget()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getOperation</code></td><td><span class="sig">String getOperation()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>bound</code></td><td><span class="sig">boolean bound()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setOnce</code></td><td><span class="sig">void setOnce(boolean on)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isOnce</code></td><td><span class="sig">boolean isOnce()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setCapture</code></td><td><span class="sig">void setCapture(boolean on)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isCapture</code></td><td><span class="sig">boolean isCapture()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setEnabled</code></td><td><span class="sig">void setEnabled(boolean on)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isEnabled</code></td><td><span class="sig">boolean isEnabled()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>matches</code></td><td><span class="sig">boolean matches(SLGuiEvent event)</span></td><td class="desc">Does this handler match the given event? "*" target is a wildcard.</td></tr>
<tr><td><code>fire</code></td><td><span class="sig">void fire(SLGuiEvent event)</span></td><td class="desc">Fire against a matching event: record it and raise the latch. The dispatcher calls this; a host that polls then reads it with take().</td></tr>
<tr><td><code>take</code></td><td><span class="sig">boolean take()</span></td><td class="desc">Take-the-latch read: true once per fire, then cleared.</td></tr>
<tr><td><code>activations</code></td><td><span class="sig">int activations()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>value</code></td><td><span class="sig">String value()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slguihostadapter">SLGuiHostAdapter <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLGuiHostAdapter.sleela)</span></h2>
<div data-u="slguihostadapter slguihostadapter">
<h3 id="SLGuiHostAdapter">SLGuiHostAdapter <span class="pill">class</span></h3>
<p class="desc">Defines SLGuiHostAdapter — the toolkit->SLeeLa half of the loop. Where SLGuiMount pushes DOM state onto widgets, the host adapter reads the widgets back: once per frame it polls each mounted interactive node's widget activation latch (uiWidgetTakeActivated, the same latch SLButton and SLEntry expose) and, when a widget fired, builds the matching SLGuiEvent (CLICK for a button, SUBMIT for an entry, TOGGLE for a toggle — carrying the widget's current text/toggle state as the event value) and dispatches it through the DOM's SLGuiEventBus so the bound onClick/onSubmit/onToggle handlers fire. This is what turns a real user interaction into a SLeeLa event; the DOM stays authoritative for what the event means. Family: user-interface. The adapter crosses the `ui*` SLVM bridge inbound; dispatch and meaning stay SLeeLa-owned.</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>dom</code></td><td><span class="sig">SLGuiDom dom</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>mount</code></td><td><span class="sig">SLGuiMount mount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>factory</code></td><td><span class="sig">SLGuiWidgetFactory factory</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tick</code></td><td><span class="sig">int tick</span></td><td class="desc">monotonic frame counter stamped onto events</td></tr>
<tr><td><code>raisedLast</code></td><td><span class="sig">int raisedLast</span></td><td class="desc">events raised on the last poll pass</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>init</code></td><td><span class="sig">void init(SLGuiDom document, SLGuiMount mountEngine)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>poll</code></td><td><span class="sig">int poll()</span></td><td class="desc">Poll every mounted interactive node once; raise an SLGuiEvent for each that fired since the last poll. Returns the number of events dispatched.</td></tr>
<tr><td><code>raiseFor</code></td><td><span class="sig">void raiseFor(SLGuiNode node, int widgetHandle)</span></td><td class="desc">Build and dispatch the event a fired widget implies.</td></tr>
<tr><td><code>raiseInput</code></td><td><span class="sig">int raiseInput(String nodeId, String text)</span></td><td class="desc">Also feed a synthetic input event (per-keystroke) for an entry, used by a host that wants live INPUT handlers in addition to the committed SUBMIT.</td></tr>
<tr><td><code>raisedCount</code></td><td><span class="sig">int raisedCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>frame</code></td><td><span class="sig">int frame()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slguimount">SLGuiMount <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLGuiMount.sleela)</span></h2>
<div data-u="slguimount slguimount">
<h3 id="SLGuiMount">SLGuiMount <span class="pill">class</span></h3>
<p class="desc">Defines SLGuiMount — the reconciler that reflects the SLeeLa-owned DOM (SLGuiDom / SLGuiNode) onto real SleelaUI widgets. It mounts the tree depth-first (a parent is constructed before its children so each child has a real parent handle), records an id->widget-handle map, and on each pass applies every dirty node's state to its widget through the `ui*` built-ins: text (uiWidgetSetText), visibility (uiWidgetVisible), sensitivity (uiWidgetSensitive), and the style-derived accents (suggested/destructive) and minimum size. This is the one-way SLeeLa->toolkit half of the loop (SLGuiHostAdapter is the toolkit->SLeeLa half). The DOM stays the single source of truth; the widgets are its projection. Family: user-interface. The reconciler crosses the `ui*` SLVM bridge; SLeeLa owns the document it mirrors.</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>MAX_NODES</code></td><td><span class="sig">static final int MAX_NODES = 65536</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dom</code></td><td><span class="sig">SLGuiDom dom</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>factory</code></td><td><span class="sig">SLGuiWidgetFactory factory</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ids</code></td><td><span class="sig">String[] ids</span></td><td class="desc">id -> widget handle map (parallel arrays).</td></tr>
<tr><td><code>handles</code></td><td><span class="sig">int[] handles</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>mapCount</code></td><td><span class="sig">int mapCount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>rootHandle</code></td><td><span class="sig">int rootHandle</span></td><td class="desc">the host-supplied root container the window gives us</td></tr>
<tr><td><code>mounted</code></td><td><span class="sig">int mounted</span></td><td class="desc">total nodes mounted so far</td></tr>
<tr><td><code>applied</code></td><td><span class="sig">int applied</span></td><td class="desc">dirty nodes applied on the last reconcile pass</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>init</code></td><td><span class="sig">void init(SLGuiDom document, int windowRootHandle)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>handleOf</code></td><td><span class="sig">int handleOf(String id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>record</code></td><td><span class="sig">void record(String id, int handle)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>indexOf</code></td><td><span class="sig">int indexOf(String id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isMounted</code></td><td><span class="sig">boolean isMounted(String id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>mountAll</code></td><td><span class="sig">void mountAll()</span></td><td class="desc">Mount the whole document under the window root, depth-first.</td></tr>
<tr><td><code>mountChildren</code></td><td><span class="sig">void mountChildren(SLGuiNode parent)</span></td><td class="desc">Recursively construct and mount every child of `parent`.</td></tr>
<tr><td><code>mountNew</code></td><td><span class="sig">void mountNew()</span></td><td class="desc">Mount any nodes added since the last pass (nodes the DOM grew via script or SLeeLa after the initial mountAll).</td></tr>
<tr><td><code>reconcile</code></td><td><span class="sig">int reconcile()</span></td><td class="desc">Push every dirty node's state onto its widget, then clear the dirty flag. Returns how many nodes were applied this pass.</td></tr>
<tr><td><code>apply</code></td><td><span class="sig">void apply(SLGuiNode node)</span></td><td class="desc">Apply one node's state to its live widget via the `ui*` built-ins.</td></tr>
<tr><td><code>mountedCount</code></td><td><span class="sig">int mountedCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>appliedLast</code></td><td><span class="sig">int appliedLast()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>labelFor</code></td><td><span class="sig">String labelFor(SLGuiNode node)</span></td><td class="desc">The construction label for a node: its text, or its "placeholder" attr for entries, or empty.</td></tr>
<tr><td><code>intAttr</code></td><td><span class="sig">int intAttr(String s)</span></td><td class="desc">Parse a non-negative integer from a decimal string ("" / null -> 0).</td></tr>
<tr><td><code>digit</code></td><td><span class="sig">int digit(String ch)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slguinode">SLGuiNode <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLGuiNode.sleela)</span></h2>
<div data-u="slguinode slguinode">
<h3 id="SLGuiNode">SLGuiNode <span class="pill">class</span></h3>
<p class="desc">Defines SLGuiNode — a DHTML-style element node in the /lib/gui document model. Like a DOM element it has a tag (e.g. "window", "box", "button", "label", "entry"), a unique id, text content, a parent id, an ordered list of child ids, a flat attribute map, a flat style map, and a visibility/enabled state. SLeeLa code (or a script) manipulates the tree through these — setAttribute, setStyle, show/hide, enable/disable, setText — and the host reflects the node onto a real SleelaUI widget. A node carries an optional widget handle so a change can be pushed to the live control, but the node itself is the SLeeLa-owned source of truth. Family: user-interface. The DOM is SLeeLa-owned; the host mirrors it onto widgets.</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>MAX_CHILDREN</code></td><td><span class="sig">static final int MAX_CHILDREN = 4096</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MAX_PAIRS</code></td><td><span class="sig">static final int MAX_PAIRS = 64</span></td><td class="desc">attributes / style entries per node</td></tr>
<tr><td><code>id</code></td><td><span class="sig">String id</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tag</code></td><td><span class="sig">String tag</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>textContent</code></td><td><span class="sig">String textContent</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>parentId</code></td><td><span class="sig">String parentId</span></td><td class="desc">"" for the root</td></tr>
<tr><td><code>childIds</code></td><td><span class="sig">String[] childIds</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>childCount</code></td><td><span class="sig">int childCount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>attrNames</code></td><td><span class="sig">String[] attrNames</span></td><td class="desc">Attribute map (name -> value).</td></tr>
<tr><td><code>attrValues</code></td><td><span class="sig">String[] attrValues</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>attrCount</code></td><td><span class="sig">int attrCount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>styleProps</code></td><td><span class="sig">String[] styleProps</span></td><td class="desc">Style map (property -> value), the DHTML inline-style equivalent.</td></tr>
<tr><td><code>styleValues</code></td><td><span class="sig">String[] styleValues</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>styleCount</code></td><td><span class="sig">int styleCount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>visible</code></td><td><span class="sig">int visible</span></td><td class="desc">1 = shown</td></tr>
<tr><td><code>enabled</code></td><td><span class="sig">int enabled</span></td><td class="desc">1 = sensitive</td></tr>
<tr><td><code>widget</code></td><td><span class="sig">int widget</span></td><td class="desc">live SleelaUI widget handle (-1 = not mounted)</td></tr>
<tr><td><code>dirty</code></td><td><span class="sig">int dirty</span></td><td class="desc">1 when the host must re-sync this node</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 nodeId, String nodeTag, String parent)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getId</code></td><td><span class="sig">String getId()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getTag</code></td><td><span class="sig">String getTag()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getParent</code></td><td><span class="sig">String getParent()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setParent</code></td><td><span class="sig">void setParent(String p)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>appendChild</code></td><td><span class="sig">boolean appendChild(String childId)</span></td><td class="desc">---- children -----------------------------------------------------------</td></tr>
<tr><td><code>removeChild</code></td><td><span class="sig">boolean removeChild(String childId)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>children</code></td><td><span class="sig">int children()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>childAt</code></td><td><span class="sig">String childAt(int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setText</code></td><td><span class="sig">void setText(String t)</span></td><td class="desc">---- text ---------------------------------------------------------------</td></tr>
<tr><td><code>text</code></td><td><span class="sig">String text()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setAttribute</code></td><td><span class="sig">void setAttribute(String name, String value)</span></td><td class="desc">---- attributes ---------------------------------------------------------</td></tr>
<tr><td><code>getAttribute</code></td><td><span class="sig">String getAttribute(String name)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasAttribute</code></td><td><span class="sig">boolean hasAttribute(String name)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>attrIndex</code></td><td><span class="sig">int attrIndex(String name)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setStyle</code></td><td><span class="sig">void setStyle(String prop, String value)</span></td><td class="desc">---- style (DHTML inline style) -----------------------------------------</td></tr>
<tr><td><code>getStyle</code></td><td><span class="sig">String getStyle(String prop)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>styleIndex</code></td><td><span class="sig">int styleIndex(String prop)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>styleEntries</code></td><td><span class="sig">int styleEntries()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>show</code></td><td><span class="sig">void show()</span></td><td class="desc">---- visibility / enabled -----------------------------------------------</td></tr>
<tr><td><code>hide</code></td><td><span class="sig">void hide()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isVisible</code></td><td><span class="sig">boolean isVisible()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setEnabled</code></td><td><span class="sig">void setEnabled(boolean on)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isEnabled</code></td><td><span class="sig">boolean isEnabled()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>mount</code></td><td><span class="sig">void mount(int widgetHandle)</span></td><td class="desc">---- host mount ---------------------------------------------------------</td></tr>
<tr><td><code>widgetHandle</code></td><td><span class="sig">int widgetHandle()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>mounted</code></td><td><span class="sig">boolean mounted()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isDirty</code></td><td><span class="sig">boolean isDirty()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clearDirty</code></td><td><span class="sig">void clearDirty()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slguiscript">SLGuiScript <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLGuiScript.sleela)</span></h2>
<div data-u="slguiscript slguiscript">
<h3 id="SLGuiScript">SLGuiScript <span class="pill">class</span></h3>
<p class="desc">Defines SLGuiScript — the scripting engine for /lib/gui. It holds an ordered list of SLGuiScriptCommands and runs them against an SLGuiDom (and, for the `call` verb, across the native boundary via SLGuiBridge). This is the "support for scripting" layer: a UI can be described and driven by a command list rather than hand-written SLeeLa, which is what makes DHTML-style authoring and tooling (serialising a UI, replaying interactions, data-driven screens) possible. The engine is deliberately NOT a general interpreter — it is a bounded, auditable verb list that only touches the SLeeLa-owned DOM/event bus and the documented operation bridge, so a script can never do more than the DOM API already allows. Family: user-interface. SLeeLa owns execution; scripts express UI intent declaratively.</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>MAX_COMMANDS</code></td><td><span class="sig">static final int MAX_COMMANDS = 65536</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>commands</code></td><td><span class="sig">SLGuiScriptCommand[] commands</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"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dom</code></td><td><span class="sig">SLGuiDom dom</span></td><td class="desc">the document the script manipulates</td></tr>
<tr><td><code>bridge</code></td><td><span class="sig">SLGuiBridge bridge</span></td><td class="desc">native boundary for the `call` verb (may be null)</td></tr>
<tr><td><code>types</code></td><td><span class="sig">SLGuiEventType types</span></td><td class="desc">event-name -> ordinal</td></tr>
<tr><td><code>pc</code></td><td><span class="sig">int pc</span></td><td class="desc">program counter of the last executed command</td></tr>
<tr><td><code>executed</code></td><td><span class="sig">int executed</span></td><td class="desc">total commands executed</td></tr>
<tr><td><code>lastError</code></td><td><span class="sig">String lastError</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>init</code></td><td><span class="sig">void init(SLGuiDom document)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>attachBridge</code></td><td><span class="sig">void attachBridge(SLGuiBridge b)</span></td><td class="desc">Attach a created native bridge so `call` can cross to a SLeeLa operation.</td></tr>
<tr><td><code>size</code></td><td><span class="sig">int size()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>add</code></td><td><span class="sig">SLGuiScriptCommand add(int verb, String a, String b, String c, String d)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>create</code></td><td><span class="sig">void create(String tag, String id, String parentId)</span></td><td class="desc">Typed builders (the common verbs) for readable script assembly.</td></tr>
<tr><td><code>append</code></td><td><span class="sig">void append(String parentId, String childId)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>text</code></td><td><span class="sig">void text(String id, String value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>attr</code></td><td><span class="sig">void attr(String id, String name, String value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>style</code></td><td><span class="sig">void style(String id, String prop, String value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>show</code></td><td><span class="sig">void show(String id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hide</code></td><td><span class="sig">void hide(String id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>enable</code></td><td><span class="sig">void enable(String id, boolean on)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>on</code></td><td><span class="sig">void on(String id, String eventName, String op)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fire</code></td><td><span class="sig">void fire(String id, String eventName, String value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>call</code></td><td><span class="sig">void call(String operation, String arguments)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>remove</code></td><td><span class="sig">void remove(String id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>run</code></td><td><span class="sig">int run()</span></td><td class="desc">Run the whole script top-down against the DOM. Returns the number of commands that executed successfully; stops and records lastError on the first command that fails.</td></tr>
<tr><td><code>step</code></td><td><span class="sig">boolean step(SLGuiScriptCommand cmd)</span></td><td class="desc">Execute one command against the DOM / bridge. Returns false on failure.</td></tr>
<tr><td><code>programCounter</code></td><td><span class="sig">int programCounter()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>executedCount</code></td><td><span class="sig">int executedCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>error</code></td><td><span class="sig">String error()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ok</code></td><td><span class="sig">boolean ok()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slguiscriptcommand">SLGuiScriptCommand <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLGuiScriptCommand.sleela)</span></h2>
<div data-u="slguiscriptcommand slguiscriptcommand">
<h3 id="SLGuiScriptCommand">SLGuiScriptCommand <span class="pill">class</span></h3>
<p class="desc">Defines SLGuiScriptCommand — one instruction of a /lib/gui UI script. The scripting support is a small, safe, declarative command list (not an arbitrary interpreter): each command is a verb plus up to four string operands. The verbs mirror the DOM/event API so a script can build and drive an interface without native code — create, append, text, attr, style, show, hide, enable, on (bind a handler), fire (raise an event), and call (cross the native bridge to a SLeeLa operation). An ordinal verb keeps dispatch cheap; the operands are interpreted per verb by SLGuiScript. Family: user-interface. Scripts describe UI intent; SLeeLa (via SLGuiScript) executes it against the SLeeLa-owned DOM and event bus.</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>CREATE</code></td><td><span class="sig">static final int CREATE = 0</span></td><td class="desc">Verb ordinals. create <tag> <id> [parentId]</td></tr>
<tr><td><code>APPEND</code></td><td><span class="sig">static final int APPEND = 1</span></td><td class="desc">append <parentId> <childId></td></tr>
<tr><td><code>TEXT</code></td><td><span class="sig">static final int TEXT = 2</span></td><td class="desc">text <id> <value></td></tr>
<tr><td><code>ATTR</code></td><td><span class="sig">static final int ATTR = 3</span></td><td class="desc">attr <id> <name> <value></td></tr>
<tr><td><code>STYLE</code></td><td><span class="sig">static final int STYLE = 4</span></td><td class="desc">style <id> <prop> <value></td></tr>
<tr><td><code>SHOW</code></td><td><span class="sig">static final int SHOW = 5</span></td><td class="desc">show <id></td></tr>
<tr><td><code>HIDE</code></td><td><span class="sig">static final int HIDE = 6</span></td><td class="desc">hide <id></td></tr>
<tr><td><code>ENABLE</code></td><td><span class="sig">static final int ENABLE = 7</span></td><td class="desc">enable <id> <"1"|"0"></td></tr>
<tr><td><code>ON</code></td><td><span class="sig">static final int ON = 8</span></td><td class="desc">on <id> <eventName> <operation></td></tr>
<tr><td><code>FIRE</code></td><td><span class="sig">static final int FIRE = 9</span></td><td class="desc">fire <id> <eventName> [value]</td></tr>
<tr><td><code>CALL</code></td><td><span class="sig">static final int CALL =10</span></td><td class="desc">call <operation> [arguments]</td></tr>
<tr><td><code>REMOVE</code></td><td><span class="sig">static final int REMOVE =11</span></td><td class="desc">remove <id></td></tr>
<tr><td><code>NOP</code></td><td><span class="sig">static final int NOP =12</span></td><td class="desc">no-op / comment</td></tr>
<tr><td><code>verb</code></td><td><span class="sig">int verb</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>a</code></td><td><span class="sig">String a</span></td><td class="desc">operand 1</td></tr>
<tr><td><code>b</code></td><td><span class="sig">String b</span></td><td class="desc">operand 2</td></tr>
<tr><td><code>c</code></td><td><span class="sig">String c</span></td><td class="desc">operand 3</td></tr>
<tr><td><code>d</code></td><td><span class="sig">String d</span></td><td class="desc">operand 4</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 v, String o1, String o2, String o3, String o4)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getVerb</code></td><td><span class="sig">int getVerb()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>op1</code></td><td><span class="sig">String op1()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>op2</code></td><td><span class="sig">String op2()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>op3</code></td><td><span class="sig">String op3()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>op4</code></td><td><span class="sig">String op4()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>verbOf</code></td><td><span class="sig">int verbOf(String word)</span></td><td class="desc">Map a verb keyword to its ordinal (-1 when unknown).</td></tr>
<tr><td><code>valid</code></td><td><span class="sig">boolean valid()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slguiwidgetfactory">SLGuiWidgetFactory <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLGuiWidgetFactory.sleela)</span></h2>
<div data-u="slguiwidgetfactory slguiwidgetfactory">
<h3 id="SLGuiWidgetFactory">SLGuiWidgetFactory <span class="pill">class</span></h3>
<p class="desc">Defines SLGuiWidgetFactory — the single place that knows how a DOM tag maps to a real SleelaUI widget. Given a node's tag and a parent widget handle it calls the matching `ui*` built-in (uiBox / uiButton / uiLabel / uiEntry / uiToggle / uiHeaderBar / uiStatusBar / ...) and returns the new widget handle, so the reconciler (SLGuiMount) never hard-codes toolkit knowledge. Tags mirror the SleelaUI vocabulary; an unknown tag falls back to a vertical box so an unrecognised element still has a container to hold children. This is the DOM->toolkit construction seam. Family: user-interface. The factory crosses the `ui*` SLVM bridge to the real toolkit; SLeeLa still owns the node that the widget mirrors.</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>ORIENT_VERTICAL</code></td><td><span class="sig">static final int ORIENT_VERTICAL = 0</span></td><td class="desc">Orientation ordinals (mirror SLUIOrientation / SLWidget).</td></tr>
<tr><td><code>ORIENT_HORIZONTAL</code></td><td><span class="sig">static final int ORIENT_HORIZONTAL = 1</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>construct</code></td><td><span class="sig">int construct(int parentHandle, String tag, String label)</span></td><td class="desc">Construct the widget for `node` inside `parentHandle`. Returns the new widget handle, or -1 when it could not be created. `label` is the node's initial text/placeholder (empty string when it has none).</td></tr>
<tr><td><code>interactive</code></td><td><span class="sig">boolean interactive(String tag)</span></td><td class="desc">Is this tag an interactive control the host should poll for activations?</td></tr>
<tr><td><code>activationEvent</code></td><td><span class="sig">int activationEvent(String tag)</span></td><td class="desc">Which SLGuiEventType an activation on this tag should raise. Buttons -> CLICK; entries -> SUBMIT (Enter); toggles -> TOGGLE.</td></tr>
<tr><td><code>isContainer</code></td><td><span class="sig">boolean isContainer(String tag)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slheaderbar">SLHeaderBar <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLHeaderBar.sleela)</span></h2>
<div data-u="slheaderbar slheaderbar">
<h3 id="SLHeaderBar">SLHeaderBar <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLHeaderBar — a SleelaUI title-bar strip: a horizontal box that also paints the chrome fill and a 1px bottom hairline, the quiet frame edge of a window. It is where a brand label, a spacer, and action buttons (e.g. a settings gear) typically live. The constructor bottoms out in the `uiHeaderBar` built-in, which calls the SleelaUI C ABI slui_header_bar(). An SLHeaderBar IS an SLWidget and behaves like a horizontal SLBox for the purpose of adding children. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent)</span></td><td class="desc">Create a header bar inside `parent` (normally the window root).</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slheading">SLHeading <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLHeading.sleela)</span></h2>
<div data-u="slheading slheading">
<h3 id="SLHeading">SLHeading <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLHeading — a SleelaUI title label drawn at a larger point size than body text, used for section and page headings. The constructor bottoms out in the `uiHeading` built-in (SleelaUI C ABI slui_heading()); the text is updated through the inherited setText(). An SLHeading IS an SLWidget but is non-interactive. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String text, int sizePt)</span></td><td class="desc">Create a heading inside `parent` with text at a point size (e.g. 16, 20).</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String text, int sizePt)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slicon">SLIcon <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLIcon.sleela)</span></h2>
<div data-u="slicon slicon">
<h3 id="SLIcon">SLIcon <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>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>pathValue</code></td><td><span class="sig">String pathValue</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>symbolValue</code></td><td><span class="sig">String symbolValue</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 assetPath, String symbolName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>assetPath</code></td><td><span class="sig">String assetPath()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>symbolName</code></td><td><span class="sig">String symbolName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slimage">SLImage <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLImage.sleela)</span></h2>
<div data-u="slimage slimage">
<h3 id="SLImage">SLImage <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLImage — a SleelaUI image/icon tile: a rounded surface of a fixed size with a centred glyph, used as a picture or icon placeholder in a layout. The constructor bottoms out in the `uiImage` built-in (SleelaUI C ABI slui_image()); the glyph is updated through the inherited setText(). An SLImage IS an SLWidget but is non-interactive. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String glyph, int width, int height)</span></td><td class="desc">Create an image tile inside `parent` with a centred glyph and a size.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String glyph, int width, int height)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slinfobar">SLInfoBar <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLInfoBar.sleela)</span></h2>
<div data-u="slinfobar slinfobar">
<h3 id="SLInfoBar">SLInfoBar <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLInfoBar — a SleelaUI inline notice bar: a tinted, rounded surface strip with a left severity bar and a message, used for non-modal feedback (info, warning, error). The constructor bottoms out in the `uiInfoBar` built-in (SleelaUI C ABI slui_info_bar()); the message is updated through the inherited setText(). An SLInfoBar IS an SLWidget but is non-interactive. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>INFO</code></td><td><span class="sig">static final int INFO = 0</span></td><td class="desc">Severity ordinals (mirror InfoBar::Severity in the toolkit).</td></tr>
<tr><td><code>WARNING</code></td><td><span class="sig">static final int WARNING = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ERROR</code></td><td><span class="sig">static final int ERROR = 2</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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String text, int severity)</span></td><td class="desc">Create an info bar inside `parent` with a message and a severity.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String text, int severity)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>info</code></td><td><span class="sig">void info(SLWidget parent, String text)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>warning</code></td><td><span class="sig">void warning(SLWidget parent, String text)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>error</code></td><td><span class="sig">void error(SLWidget parent, String text)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sllabel">SLLabel <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLLabel.sleela)</span></h2>
<div data-u="sllabel sllabel">
<h3 id="SLLabel">SLLabel <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLLabel — a SleelaUI text label: a non-interactive run of text drawn in the theme's primary (or dim, when insensitive) colour. The constructor bottoms out in the `uiLabel` built-in, which calls the SleelaUI C ABI slui_label(); the text is updated through the inherited setText(). An SLLabel IS an SLWidget, so it carries margin and alignment; set its horizontal alignment to START/CENTER/END to place the text within its cell. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String text)</span></td><td class="desc">Create a label inside `parent` with initial text.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String text)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sllayout">SLLayout <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLLayout.sleela)</span></h2>
<div data-u="sllayout sllayout">
<h3 id="SLLayout">SLLayout <span class="pill">class</span></h3>
<p class="desc">Defines SLLayout — a flow/layout manager for the SleelaUI. It treats a UI as an ORTHOGONAL CONFLATION of unit parts (what each item measures) and organizations (how items are grouped and flowed): items have NAMES, groups have NAMES, and you adjust a single named item, a whole named group, or an N-ARY selection (any subset of a group of some size). Several flow solutions arrange a group: STACK, WRAP, GRID, DOCK, and CENTRAL (weight/mass packing). Placement is Named for the ergonomics of publics — MEDIUM implies CENTER and CENTRAL implies weight/mass — and named ergonomic presets tune a group for a common public use. Each method bottoms out in a `layout*` SLVM built-in calling the C ABI (sleela_ui_layout.h). A layout is a VM-local handle (-1 = none). Sizes are SLMeasure values (US/metric/px). After adjustment call arrange(), then read item rects. Family: user-interface. Native VM/UI work crosses the explicit `layout*` SLVM bridge.</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>FLOW_STACK</code></td><td><span class="sig">static final int FLOW_STACK = 0</span></td><td class="desc">Flow ordinals (mirror SLUIFlowKind) — several layout solutions. one row/column (the box model)</td></tr>
<tr><td><code>FLOW_WRAP</code></td><td><span class="sig">static final int FLOW_WRAP = 1</span></td><td class="desc">wraps to new lines when full</td></tr>
<tr><td><code>FLOW_GRID</code></td><td><span class="sig">static final int FLOW_GRID = 2</span></td><td class="desc">fixed-column grid</td></tr>
<tr><td><code>FLOW_DOCK</code></td><td><span class="sig">static final int FLOW_DOCK = 3</span></td><td class="desc">edges dock, centre fills</td></tr>
<tr><td><code>FLOW_CENTRAL</code></td><td><span class="sig">static final int FLOW_CENTRAL = 4</span></td><td class="desc">weight/mass packing</td></tr>
<tr><td><code>AXIS_HORIZONTAL</code></td><td><span class="sig">static final int AXIS_HORIZONTAL = 0</span></td><td class="desc">Axis ordinals (mirror SLUIAxis).</td></tr>
<tr><td><code>AXIS_VERTICAL</code></td><td><span class="sig">static final int AXIS_VERTICAL = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>START</code></td><td><span class="sig">static final int START = 0</span></td><td class="desc">Placement ordinals (mirror SLUIPlacement). The ergonomics of publics, Named: MEDIUM is center; CENTRAL is weight/mass.</td></tr>
<tr><td><code>MEDIUM</code></td><td><span class="sig">static final int MEDIUM = 1</span></td><td class="desc">implies CENTER</td></tr>
<tr><td><code>END</code></td><td><span class="sig">static final int END = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>FILL</code></td><td><span class="sig">static final int FILL = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CENTRAL</code></td><td><span class="sig">static final int CENTRAL = 4</span></td><td class="desc">implies weight/mass</td></tr>
<tr><td><code>ERGO_READING</code></td><td><span class="sig">static final int ERGO_READING = 0</span></td><td class="desc">Named ergonomic presets (mirror SLUIErgonomics).</td></tr>
<tr><td><code>ERGO_GALLERY</code></td><td><span class="sig">static final int ERGO_GALLERY = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ERGO_DASHBOARD</code></td><td><span class="sig">static final int ERGO_DASHBOARD = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ERGO_CONSOLE</code></td><td><span class="sig">static final int ERGO_CONSOLE = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ERGO_PORTRAIT</code></td><td><span class="sig">static final int ERGO_PORTRAIT = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ERGO_TOOLBAR</code></td><td><span class="sig">static final int ERGO_TOOLBAR = 5</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>layout</code></td><td><span class="sig">int layout</span></td><td class="desc">VM-local handle (-1 = none)</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>create</code></td><td><span class="sig">void create()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>handle</code></td><td><span class="sig">int handle()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>valid</code></td><td><span class="sig">boolean valid()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>destroy</code></td><td><span class="sig">void destroy()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setDpi</code></td><td><span class="sig">void setDpi(double dpi)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setEm</code></td><td><span class="sig">void setEm(double emPx)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>group</code></td><td><span class="sig">int group(String groupName, int flow, int axis)</span></td><td class="desc">---- groups (named) -----------------------------------------------------</td></tr>
<tr><td><code>groupCount</code></td><td><span class="sig">int groupCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setFlow</code></td><td><span class="sig">void setFlow(String groupName, int flow, int axis)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setSpacing</code></td><td><span class="sig">void setSpacing(String groupName, SLMeasure spacing)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setPadding</code></td><td><span class="sig">void setPadding(String groupName, SLMeasure padding)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setAlign</code></td><td><span class="sig">void setAlign(String groupName, int mainAlign, int crossAlign)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setColumns</code></td><td><span class="sig">void setColumns(String groupName, int columns)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setErgonomics</code></td><td><span class="sig">void setErgonomics(String groupName, int ergo)</span></td><td class="desc">A named ergonomic preset for the ergonomics of publics.</td></tr>
<tr><td><code>item</code></td><td><span class="sig">int item(String groupName, String itemName, int widgetHandle, SLMeasure size)</span></td><td class="desc">---- items (named) ------------------------------------------------------ Add a named item (an optional widget handle, -1 for a pure placeholder) into a named group, with a main-axis size (fr makes it flexible).</td></tr>
<tr><td><code>itemCount</code></td><td><span class="sig">int itemCount(String groupName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setItemSize</code></td><td><span class="sig">void setItemSize(String itemName, SLMeasure size)</span></td><td class="desc">---- adjustment: single ------------------------------------------------</td></tr>
<tr><td><code>setItemMass</code></td><td><span class="sig">void setItemMass(String itemName, double mass)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setItemAlign</code></td><td><span class="sig">void setItemAlign(String itemName, int crossAlign)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setGroupSize</code></td><td><span class="sig">void setGroupSize(String groupName, SLMeasure size)</span></td><td class="desc">---- adjustment: whole group -------------------------------------------</td></tr>
<tr><td><code>setGroupMass</code></td><td><span class="sig">void setGroupMass(String groupName, double mass)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setNarySize</code></td><td><span class="sig">void setNarySize(String[] itemNames, int count, SLMeasure size)</span></td><td class="desc">---- adjustment: n-ary (a subset of a group of some size) -------------- `itemNames` is an array of the names to adjust; count its length.</td></tr>
<tr><td><code>setNaryMass</code></td><td><span class="sig">void setNaryMass(String[] itemNames, int count, double mass)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setNaryAlign</code></td><td><span class="sig">void setNaryAlign(String[] itemNames, int count, int crossAlign)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>arrange</code></td><td><span class="sig">void arrange(String groupName, int x, int y, int w, int h)</span></td><td class="desc">---- resolution --------------------------------------------------------- Lay a named group out within a device-pixel rectangle; then read item rects with itemX/itemY/itemWidth/itemHeight.</td></tr>
<tr><td><code>itemX</code></td><td><span class="sig">int itemX(String itemName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>itemY</code></td><td><span class="sig">int itemY(String itemName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>itemWidth</code></td><td><span class="sig">int itemWidth(String itemName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>itemHeight</code></td><td><span class="sig">int itemHeight(String itemName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sllevelbar">SLLevelBar <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLLevelBar.sleela)</span></h2>
<div data-u="sllevelbar sllevelbar">
<h3 id="SLLevelBar">SLLevelBar <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLLevelBar — a SleelaUI segmented level indicator (battery/volume style): a row of ten segments, the leading ones lit in the accent colour in proportion to a fraction in [0,1]. Use it for a discrete "how full / how strong" reading. The constructor bottoms out in the `uiLevelBar` built-in (SleelaUI C ABI slui_level_bar()); the fraction is read/written through level()/setLevel(). An SLLevelBar IS an SLWidget but is non-interactive. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, double level)</span></td><td class="desc">Create a level bar inside `parent` with an initial level in [0,1].</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, double level)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>level</code></td><td><span class="sig">double level()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setLevel</code></td><td><span class="sig">void setLevel(double level)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sllight">SLLight <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLLight.sleela)</span></h2>
<div data-u="sllight sllight">
<h3 id="SLLight">SLLight <span class="pill">class</span></h3>
<p class="desc">Defines SLLight — a SleelaUI light descriptor used to light and relieve Canvas-aware objects. A light has a KIND (point, directional, ambient), a ROLE, a POLARITY, a position/direction, a reach, an intensity, a softness (penumbra width), and a colour. It is a pure value object the host fills and hands to an SLLightScene; the scene decides whether it is a SOURCE (reserves an anchor object — the object is used as the light) or an EMITTER (reserves nothing, reusable). Both light and shadow come from either a source or an emitter: the POLARITY decides whether the emission brightens (light) or darkens (shadow/umbra). Family: user-interface. Mirrors SLUILight in the SleelaUI Lighting C ABI (sleela_ui_light.h).</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>POINT</code></td><td><span class="sig">static final int POINT = 0</span></td><td class="desc">Kind ordinals (mirror SLUILightKind).</td></tr>
<tr><td><code>DIRECTIONAL</code></td><td><span class="sig">static final int DIRECTIONAL = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>AMBIENT</code></td><td><span class="sig">static final int AMBIENT = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SOURCE</code></td><td><span class="sig">static final int SOURCE = 0</span></td><td class="desc">Role ordinals (mirror SLUILightRole). reserves its anchor object (object USED)</td></tr>
<tr><td><code>EMITTER</code></td><td><span class="sig">static final int EMITTER = 1</span></td><td class="desc">reserves nothing; reusable</td></tr>
<tr><td><code>LIGHT</code></td><td><span class="sig">static final int LIGHT = 0</span></td><td class="desc">Polarity ordinals (mirror SLUIPolarity). brightens</td></tr>
<tr><td><code>SHADOW</code></td><td><span class="sig">static final int SHADOW = 1</span></td><td class="desc">darkens (umbra emission)</td></tr>
<tr><td><code>kind</code></td><td><span class="sig">int kind</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>role</code></td><td><span class="sig">int role</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>polarity</code></td><td><span class="sig">int polarity</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>radius</code></td><td><span class="sig">double radius</span></td><td class="desc">point reach in px (0 = infinite)</td></tr>
<tr><td><code>intensity</code></td><td><span class="sig">double intensity</span></td><td class="desc">0..N emission multiplier</td></tr>
<tr><td><code>softness</code></td><td><span class="sig">double softness</span></td><td class="desc">0..1 penumbra width for cast shadows</td></tr>
<tr><td><code>color</code></td><td><span class="sig">int color</span></td><td class="desc">0xRRGGBBAA emission (shadow colour if SHADOW)</td></tr>
<tr><td><code>anchor</code></td><td><span class="sig">int anchor</span></td><td class="desc">for a SOURCE: the reserved anchor id</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>point</code></td><td><span class="sig">void point(double px, double py, double reach, double i, int c)</span></td><td class="desc">A point light at (x,y) reaching `radius` px, with an intensity + colour.</td></tr>
<tr><td><code>directional</code></td><td><span class="sig">void directional(double ux, double uy, double i, int c)</span></td><td class="desc">A directional "sun" travelling along (ux,uy).</td></tr>
<tr><td><code>ambient</code></td><td><span class="sig">void ambient(double i, int c)</span></td><td class="desc">A uniform ambient fill.</td></tr>
<tr><td><code>asShadow</code></td><td><span class="sig">void asShadow()</span></td><td class="desc">Turn this light into a shadow (negative-polarity) emission.</td></tr>
<tr><td><code>asLight</code></td><td><span class="sig">void asLight()</span></td><td class="desc">Turn this light into a light (positive-polarity) emission.</td></tr>
</table>
</div>
<h2 class="section" data-u="sllightscene">SLLightScene <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLLightScene.sleela)</span></h2>
<div data-u="sllightscene sllightscene">
<h3 id="SLLightScene">SLLightScene <span class="pill">class</span></h3>
<p class="desc">Defines SLLightScene — a collection of SleelaUI lights applied to a draw context to light and relieve Canvas-aware objects. The scene owns the SOURCE RESERVATION table: an anchor object can be used as a source at most once (addSource refuses a second), while EMITTERS reserve nothing and may be added freely and reused. It also holds the base ambient illumination so even an unlit object is not pure black. Each method bottoms out in a `light*` SLVM built-in that calls the SleelaUI Lighting C ABI (sleela_ui_light.h). A scene is a VM-local handle (-1 = none). An SLLight is passed by its descriptor fields through the built-ins. Family: user-interface. Native VM/UI work crosses the explicit `light*` SLVM bridge.</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>scene</code></td><td><span class="sig">int scene</span></td><td class="desc">VM-local scene handle (-1 = none)</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>create</code></td><td><span class="sig">void create()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>handle</code></td><td><span class="sig">int handle()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>valid</code></td><td><span class="sig">boolean valid()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>destroy</code></td><td><span class="sig">void destroy()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clear</code></td><td><span class="sig">void clear()</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"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>addEmitter</code></td><td><span class="sig">int addEmitter(SLLight l)</span></td><td class="desc">Add an EMITTER (reserves nothing). Returns its index (>=0), reusable.</td></tr>
<tr><td><code>addSource</code></td><td><span class="sig">int addSource(int anchor, SLLight l)</span></td><td class="desc">Add a SOURCE bound to `anchor` (reserves it; the object is USED as a source). Returns the light index (>=0), or a negative error if `anchor` is already reserved by another source in this scene.</td></tr>
<tr><td><code>anchorReserved</code></td><td><span class="sig">boolean anchorReserved(int anchor)</span></td><td class="desc">True if `anchor` is currently reserved as a source in this scene.</td></tr>
<tr><td><code>releaseSource</code></td><td><span class="sig">void releaseSource(int anchor)</span></td><td class="desc">Release a source's reservation so the anchor can be a source again.</td></tr>
<tr><td><code>setAmbient</code></td><td><span class="sig">void setAmbient(double intensity, int color)</span></td><td class="desc">The base ambient illumination applied before any light.</td></tr>
</table>
</div>
<h2 class="section" data-u="sllinkbutton">SLLinkButton <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLLinkButton.sleela)</span></h2>
<div data-u="sllinkbutton sllinkbutton">
<h3 id="SLLinkButton">SLLinkButton <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLLinkButton — a SleelaUI hyperlink-style button: accent-coloured text that underlines on hover/focus and activates like a button (click, or Enter/Space while focused). Use it for navigation and "learn more" affordances where a full button would be too heavy. The constructor bottoms out in the `uiLinkButton` built-in (SleelaUI C ABI slui_link_button()); the text is updated through the inherited setText(). An SLLinkButton IS an SLWidget and is keyboard-focusable. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String label)</span></td><td class="desc">Create a link button inside `parent` with a label.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String label)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clicked</code></td><td><span class="sig">boolean clicked()</span></td><td class="desc">True if the link was activated since the last check (latch cleared on read).</td></tr>
</table>
</div>
<h2 class="section" data-u="slloadingdemo">SLLoadingDemo <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLLoadingDemo.sleela)</span></h2>
<div data-u="slloadingdemo slloadingdemo">
<h3 id="SLLoadingDemo">SLLoadingDemo <span class="pill">class</span></h3>
<p class="desc">Defines SLLoadingDemo — a worked, runnable example that builds a Slick Black window from pure SLeeLa source showing the activity family: a flowing SLThrobber, an arc SLSpinner, a determinate SLProgressBar, and the unified SLLoadingIndicator stepping from an indeterminate "Resolving…" phase into a determinate "Compiling… NN%" phase and finally done(). It is the SLeeLa-source twin of the gallery, proving the loading indicators are fully usable from the language itself. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>ui</code></td><td><span class="sig">SLUserInterface ui</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>win</code></td><td><span class="sig">SLWindow win</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>loader</code></td><td><span class="sig">SLLoadingIndicator loader</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>run</code></td><td><span class="sig">int run()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slloadingindicator">SLLoadingIndicator <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLLoadingIndicator.sleela)</span></h2>
<div data-u="slloadingindicator slloadingindicator">
<h3 id="SLLoadingIndicator">SLLoadingIndicator <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLLoadingIndicator — a SleelaUI composite "loading" widget that unifies the three activity primitives behind one caption, with no new C ABI. It is a horizontal row of {activity visual, caption label} that switches between two modes: - INDETERMINATE (unknown length): shows an SLThrobber (the water-flow field) or an SLSpinner (the accent arc), advanced each frame by the window loop / a host phase; - DETERMINATE (known length): shows an SLProgressBar filled to a fraction in [0,1], with the caption optionally carrying a percentage. A task begins indeterminate ("Resolving…"), may switch to determinate once a total is known ("Compiling… 60%"), and ends with done()/fail() which hide the activity visual and set a final caption. This is the IDE-friendly loading indicator built from SLThrobber + SLSpinner + SLProgressBar. An SLLoadingIndicator IS an SLWidget container (its handle is the row box). Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>MODE_IDLE</code></td><td><span class="sig">static final int MODE_IDLE = 0</span></td><td class="desc">Mode ordinals.</td></tr>
<tr><td><code>MODE_INDETERMINATE</code></td><td><span class="sig">static final int MODE_INDETERMINATE = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MODE_DETERMINATE</code></td><td><span class="sig">static final int MODE_DETERMINATE = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MODE_DONE</code></td><td><span class="sig">static final int MODE_DONE = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MODE_FAILED</code></td><td><span class="sig">static final int MODE_FAILED = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>STYLE_THROBBER</code></td><td><span class="sig">static final int STYLE_THROBBER = 0</span></td><td class="desc">Which indeterminate visual to use. the water-flow field (default)</td></tr>
<tr><td><code>STYLE_SPINNER</code></td><td><span class="sig">static final int STYLE_SPINNER = 1</span></td><td class="desc">the accent arc on a ring</td></tr>
<tr><td><code>row</code></td><td><span class="sig">SLBox row</span></td><td class="desc">horizontal: [visual] [caption]</td></tr>
<tr><td><code>throbber</code></td><td><span class="sig">SLThrobber throbber</span></td><td class="desc">indeterminate (STYLE_THROBBER)</td></tr>
<tr><td><code>spinner</code></td><td><span class="sig">SLSpinner spinner</span></td><td class="desc">indeterminate (STYLE_SPINNER)</td></tr>
<tr><td><code>bar</code></td><td><span class="sig">SLProgressBar bar</span></td><td class="desc">determinate</td></tr>
<tr><td><code>caption</code></td><td><span class="sig">SLLabel caption</span></td><td class="desc">the status text</td></tr>
<tr><td><code>style</code></td><td><span class="sig">int style</span></td><td class="desc">STYLE_THROBBER | STYLE_SPINNER</td></tr>
<tr><td><code>mode</code></td><td><span class="sig">int mode</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fraction</code></td><td><span class="sig">double fraction</span></td><td class="desc">current determinate fraction [0,1]</td></tr>
<tr><td><code>phase</code></td><td><span class="sig">double phase</span></td><td class="desc">current indeterminate phase [0,1]</td></tr>
<tr><td><code>showPercent</code></td><td><span class="sig">boolean showPercent</span></td><td class="desc">append " NN%" to the caption in determinate mode</td></tr>
<tr><td><code>baseCaption</code></td><td><span class="sig">String baseCaption</span></td><td class="desc">the caption text without any appended percentage</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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, int style0, int visualWidth)</span></td><td class="desc">Create the indicator inside `parent`. style picks the indeterminate visual; visualWidth sizes the throbber (ignored for the spinner).</td></tr>
<tr><td><code>beginIndeterminate</code></td><td><span class="sig">void beginIndeterminate(String text)</span></td><td class="desc">Begin an indeterminate task of unknown length.</td></tr>
<tr><td><code>beginDeterminate</code></td><td><span class="sig">void beginDeterminate(String text, double initial)</span></td><td class="desc">Begin (or switch to) a determinate task; `initial` is the starting [0,1].</td></tr>
<tr><td><code>setFraction</code></td><td><span class="sig">void setFraction(double value)</span></td><td class="desc">Update determinate progress; clamps to [0,1] and refreshes the caption.</td></tr>
<tr><td><code>getFraction</code></td><td><span class="sig">double getFraction()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tick</code></td><td><span class="sig">void tick(double delta)</span></td><td class="desc">Advance the indeterminate visual (host calls this each frame; phase wraps).</td></tr>
<tr><td><code>done</code></td><td><span class="sig">void done(String text)</span></td><td class="desc">Finish successfully: hide the activity visual, set a final caption.</td></tr>
<tr><td><code>fail</code></td><td><span class="sig">void fail(String text)</span></td><td class="desc">Finish with an error: hide the activity visual, set a failure caption.</td></tr>
<tr><td><code>reset</code></td><td><span class="sig">void reset()</span></td><td class="desc">Reset to idle (hidden).</td></tr>
<tr><td><code>currentMode</code></td><td><span class="sig">int currentMode()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>busy</code></td><td><span class="sig">boolean busy()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>finished</code></td><td><span class="sig">boolean finished()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>failed</code></td><td><span class="sig">boolean failed()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setStyle</code></td><td><span class="sig">void setStyle(int style0)</span></td><td class="desc">Choose the indeterminate visual (throbber vs spinner) at any time.</td></tr>
<tr><td><code>setShowPercent</code></td><td><span class="sig">void setShowPercent(boolean on)</span></td><td class="desc">Whether to append a percentage to the determinate caption.</td></tr>
<tr><td><code>setCaption</code></td><td><span class="sig">void setCaption(String text)</span></td><td class="desc">Set the base caption text (without any appended percentage).</td></tr>
<tr><td><code>applyMode</code></td><td><span class="sig">void applyMode()</span></td><td class="desc">Show exactly the visual the current mode needs; hide the rest.</td></tr>
<tr><td><code>refreshCaption</code></td><td><span class="sig">void refreshCaption()</span></td><td class="desc">Rebuild the caption, appending " NN%" in determinate mode when enabled.</td></tr>
<tr><td><code>percentText</code></td><td><span class="sig">String percentText(double f)</span></td><td class="desc">fraction[0,1] -> integer percent 0..100 without a float->int cast.</td></tr>
<tr><td><code>clamp01</code></td><td><span class="sig">double clamp01(double v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slmaterial">SLMaterial <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLMaterial.sleela)</span></h2>
<div data-u="slmaterial slmaterial">
<h3 id="SLMaterial">SLMaterial <span class="pill">class</span></h3>
<p class="desc">Defines SLMaterial — how a Canvas-aware object catches light. The RELIEF profile is a height model the lighting uses to compute surface normals, which is what produces the raised/recessed "quality relief": a smooth dome (ROUNDED), a crisp chamfer (BEVEL), an inset the shape reads as pressed INTO the floor (ENGRAVED), or a raised plateau standing OFF the floor (EMBOSSED). It also carries depth (how pronounced), gloss (specular sheen), occlusion (how much darkness pools in the creases), and the edge band width. It is a pure value object passed to SLLightScene painting helpers and to a canvas widget's light attachment. Family: user-interface. Mirrors SLUIMaterial in the SleelaUI Lighting C ABI.</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>FLAT</code></td><td><span class="sig">static final int FLAT = 0</span></td><td class="desc">Relief-profile ordinals (mirror SLUIReliefProfile).</td></tr>
<tr><td><code>ROUNDED</code></td><td><span class="sig">static final int ROUNDED = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>BEVEL</code></td><td><span class="sig">static final int BEVEL = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ENGRAVED</code></td><td><span class="sig">static final int ENGRAVED = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>EMBOSSED</code></td><td><span class="sig">static final int EMBOSSED = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>profile</code></td><td><span class="sig">int profile</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>depth</code></td><td><span class="sig">double depth</span></td><td class="desc">relief height in px</td></tr>
<tr><td><code>gloss</code></td><td><span class="sig">double gloss</span></td><td class="desc">0 matte .. 1 mirror (specular sheen)</td></tr>
<tr><td><code>occlusion</code></td><td><span class="sig">double occlusion</span></td><td class="desc">0..1 ambient-occlusion darkening in the creases</td></tr>
<tr><td><code>edgePx</code></td><td><span class="sig">double edgePx</span></td><td class="desc">bevel/edge band width in px</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>of</code></td><td><span class="sig">void of(int reliefProfile, double reliefDepth)</span></td><td class="desc">Fill a material for a profile at a given relief depth, with sensible defaults for gloss/occlusion/edge the host may then tune.</td></tr>
<tr><td><code>rounded</code></td><td><span class="sig">void rounded(double depth)</span></td><td class="desc">Common relief shorthands.</td></tr>
<tr><td><code>bevel</code></td><td><span class="sig">void bevel(double depth)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>engraved</code></td><td><span class="sig">void engraved(double depth)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>embossed</code></td><td><span class="sig">void embossed(double depth)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slmeasure">SLMeasure <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLMeasure.sleela)</span></h2>
<div data-u="slmeasure slmeasure">
<h3 id="SLMeasure">SLMeasure <span class="pill">class</span></h3>
<p class="desc">Defines SLMeasure — a standardized unit of measurement for the SleelaUI layout system, spanning US customary (inch, foot, point, pica), Eurasian metric (mm, cm, m), device pixels (px), and relative units (percent, flexible fraction fr, em). A measure is a (value, unit) pair that resolves to device pixels at a DPI — one vocabulary across US and Eurasian countries, with px available of course. It is a pure value helper mirroring SLUIMeasure in the SleelaUI Layout C ABI (sleela_ui_layout.h). Family: user-interface.</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>PX</code></td><td><span class="sig">static final int PX = 0</span></td><td class="desc">Unit ordinals (mirror SLUIUnitKind). device pixels</td></tr>
<tr><td><code>MM</code></td><td><span class="sig">static final int MM = 1</span></td><td class="desc">millimetre (metric)</td></tr>
<tr><td><code>CM</code></td><td><span class="sig">static final int CM = 2</span></td><td class="desc">centimetre (metric)</td></tr>
<tr><td><code>M</code></td><td><span class="sig">static final int M = 3</span></td><td class="desc">metre (metric)</td></tr>
<tr><td><code>IN</code></td><td><span class="sig">static final int IN = 4</span></td><td class="desc">inch (US)</td></tr>
<tr><td><code>FT</code></td><td><span class="sig">static final int FT = 5</span></td><td class="desc">foot (US)</td></tr>
<tr><td><code>PT</code></td><td><span class="sig">static final int PT = 6</span></td><td class="desc">typographic point (US, 1/72in)</td></tr>
<tr><td><code>PICA</code></td><td><span class="sig">static final int PICA = 7</span></td><td class="desc">pica (US, 12pt)</td></tr>
<tr><td><code>PCT</code></td><td><span class="sig">static final int PCT = 8</span></td><td class="desc">percent of the reference extent</td></tr>
<tr><td><code>FR</code></td><td><span class="sig">static final int FR = 9</span></td><td class="desc">flexible fraction / weight share</td></tr>
<tr><td><code>EM</code></td><td><span class="sig">static final int EM = 10</span></td><td class="desc">multiples of the base font size</td></tr>
<tr><td><code>value</code></td><td><span class="sig">double value</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>unit</code></td><td><span class="sig">int unit</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>of</code></td><td><span class="sig">void of(double v, int u)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>px</code></td><td><span class="sig">void px(double v)</span></td><td class="desc">US customary + metric + device + relative builders.</td></tr>
<tr><td><code>mm</code></td><td><span class="sig">void mm(double v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cm</code></td><td><span class="sig">void cm(double v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>meters</code></td><td><span class="sig">void meters(double v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>inch</code></td><td><span class="sig">void inch(double v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>feet</code></td><td><span class="sig">void feet(double v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>points</code></td><td><span class="sig">void points(double v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pica</code></td><td><span class="sig">void pica(double v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>percent</code></td><td><span class="sig">void percent(double v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fraction</code></td><td><span class="sig">void fraction(double v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>em</code></td><td><span class="sig">void em(double v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>toPixels</code></td><td><span class="sig">double toPixels(double dpi, double referencePx, double emPx)</span></td><td class="desc">Resolve to device pixels at `dpi`, with a reference extent (for percent) and em size (for em).</td></tr>
<tr><td><code>isFlexible</code></td><td><span class="sig">boolean isFlexible()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slmm">SLMm <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLMm.sleela)</span></h2>
<div data-u="slmm slmm">
<h3 id="SLMm">SLMm <span class="pill">class</span></h3>
<p class="desc">Defines SLMm — a millimetre placement for a SleelaUI light/dark/ shadow emitter, relative to the text's font-paint location. It holds a left/right offset, an up/down offset, and a HEIGHT the light shines down from, all in millimetres, and converts to device pixels at a DPI. This is the mm-precise placement the lighting design calls for: the light shines down from some mm of height, and left/right/up/down are all supported. Mirrors SLUIMm in the SleelaUI Mood/Light C ABI (sleela_ui_mood.h). SLMm is a pure value helper (no VM handle); feed it to SLMood.placeLight or the `light*` built-ins. Family: user-interface.</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>rightMm</code></td><td><span class="sig">double rightMm</span></td><td class="desc">+right, -left</td></tr>
<tr><td><code>downMm</code></td><td><span class="sig">double downMm</span></td><td class="desc">+down, -up</td></tr>
<tr><td><code>heightMm</code></td><td><span class="sig">double heightMm</span></td><td class="desc">above the plane the light shines down from</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>of</code></td><td><span class="sig">void of(double right, double down, double height)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>left</code></td><td><span class="sig">void left(double mm, double height)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>right</code></td><td><span class="sig">void right(double mm, double height)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>up</code></td><td><span class="sig">void up(double mm, double height)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>down</code></td><td><span class="sig">void down(double mm, double height)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>toPixels</code></td><td><span class="sig">double toPixels(double mm, double dpi)</span></td><td class="desc">Millimetres to device pixels at `dpi` (25.4 mm per inch).</td></tr>
</table>
</div>
<h2 class="section" data-u="slmood">SLMood <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLMood.sleela)</span></h2>
<div data-u="slmood slmood">
<h3 id="SLMood">SLMood <span class="pill">class</span></h3>
<p class="desc">Defines SLMood — a named, adjustable SleelaUI mood: an Excellent Wash + a natural tanor + a Calculus-8, together. The mood's colour is the wash sampled at the calculus's mood scalar, freshened over time by the tanor's refresh and its gentle "a little left" bias. A tanor is a soft, portrait-quality ambient glow for "lightless bulbs" (light-of-effect with no hard source). Applying a mood to a light sets its colour and folds in the tanor's portrait softness/depth — so inputs flow into direct moods in one call. Each method bottoms out in a `mood*`/`light*` SLVM built-in calling the C ABI (sleela_ui_mood.h). A mood is a VM-local handle (-1 = none). Family: user-interface. Native VM/UI work crosses the explicit `mood*` SLVM bridge.</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>CALM</code></td><td><span class="sig">static final int CALM = 0</span></td><td class="desc">Mood-kind ordinals (mirror SLUIMoodKind).</td></tr>
<tr><td><code>WARM</code></td><td><span class="sig">static final int WARM = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>COOL</code></td><td><span class="sig">static final int COOL = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>VIVID</code></td><td><span class="sig">static final int VIVID = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SOMBER</code></td><td><span class="sig">static final int SOMBER = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>TENDER</code></td><td><span class="sig">static final int TENDER = 5</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>RADIANT</code></td><td><span class="sig">static final int RADIANT = 6</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CUSTOM</code></td><td><span class="sig">static final int CUSTOM = 7</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SOURCE</code></td><td><span class="sig">static final int SOURCE = 0</span></td><td class="desc">Role/polarity ordinals (mirror the Lighting C ABI) for placeLight.</td></tr>
<tr><td><code>EMITTER</code></td><td><span class="sig">static final int EMITTER = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>LIGHT</code></td><td><span class="sig">static final int LIGHT = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SHADOW</code></td><td><span class="sig">static final int SHADOW = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>mood</code></td><td><span class="sig">int mood</span></td><td class="desc">VM-local handle (-1 = none)</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>create</code></td><td><span class="sig">void create(int kind)</span></td><td class="desc">Create a mood from a built-in kind (pre-filled tasteful wash + tanor) or CUSTOM to set your own.</td></tr>
<tr><td><code>handle</code></td><td><span class="sig">int handle()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>valid</code></td><td><span class="sig">boolean valid()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>destroy</code></td><td><span class="sig">void destroy()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setWash</code></td><td><span class="sig">void setWash(SLWash wash)</span></td><td class="desc">Give the mood an Excellent Wash and a Calculus-8 (borrowed).</td></tr>
<tr><td><code>setCalculus</code></td><td><span class="sig">void setCalculus(SLCalculus8 calc)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setTanor</code></td><td><span class="sig">void setTanor(double warmth, double diffusion, double refreshHz,</span></td><td class="desc">Configure the natural tanor (lightless-bulb glow): warmth 0 cool..1 warm, diffusion 0..1 portrait softness, refreshHz pattern refresh, leftBias "a little left", depth 0..1, tone 0xRRGGBBAA.</td></tr>
<tr><td><code>color</code></td><td><span class="sig">int color(double timeS)</span></td><td class="desc">The mood's current colour, freshened at time_s seconds (0xRRGGBBAA).</td></tr>
<tr><td><code>placeLight</code></td><td><span class="sig">int placeLight(SLLightScene scene, double fontX, double fontBaseline,</span></td><td class="desc">Build a mm-placed, mood-coloured light for text painted at (fontX, fontBaseline). mm places it (height it shines down from, plus left/right/up/down); dpi resolves mm to pixels; role/polarity choose source vs emitter and light vs shadow. Adds it to `scene` and returns the light index (or a negative error).</td></tr>
</table>
</div>
<h2 class="section" data-u="slnotebook">SLNotebook <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLNotebook.sleela)</span></h2>
<div data-u="slnotebook slnotebook">
<h3 id="SLNotebook">SLNotebook <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLNotebook — a browser-style horizontal tab strip and page stack. It uses themed native buttons, selected accent, quiet inactive tabs, a compact strip, and a clearly separated content region. A dirty marker can be shown per tab (e.g. an unsaved editor). Pointer hover/press visuals are provided by the native Button widget; clicked() is the one-shot release-on- target activation latch. This stays in SLeeLa over SleelaUI primitives. An SLNotebook IS an SLWidget container. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>MAX_PAGES</code></td><td><span class="sig">static final int MAX_PAGES = 4096</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>column</code></td><td><span class="sig">SLBox column</span></td><td class="desc">vertical: tab strip over the content area</td></tr>
<tr><td><code>strip</code></td><td><span class="sig">SLBox strip</span></td><td class="desc">horizontal tab strip</td></tr>
<tr><td><code>stack</code></td><td><span class="sig">SLBox stack</span></td><td class="desc">the content area (one page visible at a time)</td></tr>
<tr><td><code>tabs</code></td><td><span class="sig">SLButton[] tabs</span></td><td class="desc">one tab button per page</td></tr>
<tr><td><code>pages</code></td><td><span class="sig">SLBox[] pages</span></td><td class="desc">one content container per page</td></tr>
<tr><td><code>titles</code></td><td><span class="sig">String[] titles</span></td><td class="desc">base tab titles (without the dirty marker)</td></tr>
<tr><td><code>dirty</code></td><td><span class="sig">boolean[] dirty</span></td><td class="desc">per-page dirty flag (adds a '*' to the tab)</td></tr>
<tr><td><code>count</code></td><td><span class="sig">int count</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>active</code></td><td><span class="sig">int active</span></td><td class="desc">active page index, -1 when empty</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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>addPage</code></td><td><span class="sig">int addPage(String title)</span></td><td class="desc">Add a page with a tab title; returns the page index. The returned page's content() is the container child widgets attach to.</td></tr>
<tr><td><code>pageContent</code></td><td><span class="sig">SLWidget pageContent(int index)</span></td><td class="desc">The content container for page `index` (attach children with createIn).</td></tr>
<tr><td><code>select</code></td><td><span class="sig">void select(int index)</span></td><td class="desc">Show page `index`, hide the rest, accent its tab.</td></tr>
<tr><td><code>activeIndex</code></td><td><span class="sig">int activeIndex()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>selectPrevious</code></td><td><span class="sig">void selectPrevious()</span></td><td class="desc">Browser-style convenience: activate the previous or next tab.</td></tr>
<tr><td><code>selectNext</code></td><td><span class="sig">void selectNext()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>takeClickedTab</code></td><td><span class="sig">int takeClickedTab()</span></td><td class="desc">Poll the tab strip: if a tab was clicked since the last check, make it active and return its index; otherwise return -1.</td></tr>
<tr><td><code>setDirty</code></td><td><span class="sig">void setDirty(int index, boolean isDirty)</span></td><td class="desc">Mark a page dirty/clean; refreshes its tab label with a '*' suffix.</td></tr>
<tr><td><code>isDirty</code></td><td><span class="sig">boolean isDirty(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setTitle</code></td><td><span class="sig">void setTitle(int index, String title)</span></td><td class="desc">Rename a tab (keeps the current dirty marker).</td></tr>
<tr><td><code>pageCount</code></td><td><span class="sig">int pageCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slpackage">SLPackage <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLPackage.sleela)</span></h2>
<div data-u="slpackage slpackage">
<h3 id="SLPackage">SLPackage <span class="pill">class</span></h3>
<p class="desc">Defines the SLeeLa standard-library package for user-interface.</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>packageName</code></td><td><span class="sig">String packageName</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 name)</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>available</code></td><td><span class="sig">boolean available()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slpasswordentry">SLPasswordEntry <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLPasswordEntry.sleela)</span></h2>
<div data-u="slpasswordentry slpasswordentry">
<h3 id="SLPasswordEntry">SLPasswordEntry <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLPasswordEntry — a SleelaUI password field: a single-line entry that renders a bullet dot for each character instead of the character itself, used for secret input. It behaves like SLEntry otherwise (UTF-8 editing, caret, Enter raises an activate event); the underlying text is still readable through text() so the host can submit it. The constructor bottoms out in the `uiPasswordEntry` built-in (SleelaUI C ABI slui_password_entry()). An SLPasswordEntry IS an SLWidget and is keyboard-focusable. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String placeholder)</span></td><td class="desc">Create a password entry inside `parent` (placeholder defaults to "Password").</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String placeholder)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>submitted</code></td><td><span class="sig">boolean submitted()</span></td><td class="desc">True if Enter was pressed since the last check (latch cleared on read).</td></tr>
</table>
</div>
<h2 class="section" data-u="slprogressbar">SLProgressBar <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLProgressBar.sleela)</span></h2>
<div data-u="slprogressbar slprogressbar">
<h3 id="SLProgressBar">SLProgressBar <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLProgressBar — a SleelaUI determinate progress bar: a rounded trough with an accent fill proportional to a fraction in [0,1]. Use it to show how far a known-length task has advanced. The constructor bottoms out in the `uiProgressBar` built-in (SleelaUI C ABI slui_progress_bar()); the fraction is read/written through fraction()/setFraction(). An SLProgressBar IS an SLWidget but is non-interactive. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, double fraction)</span></td><td class="desc">Create a progress bar inside `parent` with an initial fraction in [0,1].</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, double fraction)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fraction</code></td><td><span class="sig">double fraction()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setFraction</code></td><td><span class="sig">void setFraction(double fraction)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slradiobutton">SLRadioButton <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLRadioButton.sleela)</span></h2>
<div data-u="slradiobutton slradiobutton">
<h3 id="SLRadioButton">SLRadioButton <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLRadioButton — a SleelaUI labelled radio button: a circle with an accent dot when selected. Radio buttons that share a group ordinal AND the same parent are mutually exclusive — selecting one clears the others in its group. Selecting (click, or Space/Enter while focused) raises an activate event. The constructor bottoms out in the `uiRadioButton` built-in (SleelaUI C ABI slui_radio_button()); the state is read through isSelected(). An SLRadioButton IS an SLWidget and is keyboard-focusable. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String label, int group, boolean selected)</span></td><td class="desc">Create a radio inside `parent`, in exclusivity `group`, with a label and initial selected state.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String label, int group,</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isSelected</code></td><td><span class="sig">boolean isSelected()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>select</code></td><td><span class="sig">void select()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>changed</code></td><td><span class="sig">boolean changed()</span></td><td class="desc">True if this radio was just selected since the last check (latch cleared).</td></tr>
</table>
</div>
<h2 class="section" data-u="slscrollbar">SLScrollBar <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLScrollBar.sleela)</span></h2>
<div data-u="slscrollbar slscrollbar">
<h3 id="SLScrollBar">SLScrollBar <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLScrollBar — a SleelaUI scroll bar indicator: a thin rounded track with a draggable thumb. The thumb covers a `page` fraction of the track and sits at a `value` position in [0,1]; dragging it reports a new value. The constructor bottoms out in the `uiScrollBar` built-in (SleelaUI C ABI slui_scroll_bar()); the position is read/written through position()/setPosition(). An SLScrollBar IS an SLWidget and is keyboard-focusable. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, int orientation, double value, double page)</span></td><td class="desc">Create a scroll bar inside `parent`. orientation is ORIENT_VERTICAL or ORIENT_HORIZONTAL; value is the initial position in [0,1]; page is the visible fraction the thumb covers (0..1).</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, int orientation, double value,</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>position</code></td><td><span class="sig">double position()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setPosition</code></td><td><span class="sig">void setPosition(double value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>changed</code></td><td><span class="sig">boolean changed()</span></td><td class="desc">True if the position changed since the last check (latch cleared on read).</td></tr>
</table>
</div>
<h2 class="section" data-u="slscrollview">SLScrollView <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLScrollView.sleela)</span></h2>
<div data-u="slscrollview slscrollview">
<h3 id="SLScrollView">SLScrollView <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLScrollView — a SleelaUI scrollable viewport. It is a composite SleelaUI widget (it adds no new C ABI): a vertical content box held inside a clipping frame, with an SLScrollBar on the needed axes. The content box is the parent handle children attach to; the view tracks the content's natural extent against the viewport extent and only shows a bar when the content overflows. Scroll position is reported in [0,1] by the bars and converted to a pixel offset the toolkit applies to the content. An SLScrollView IS an SLWidget container built from SLFrame + SLBox + SLScrollBar, so any widget set (a tree, a list, a text view) becomes scrollable by being built into its content(). Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>clip</code></td><td><span class="sig">SLFrame clip</span></td><td class="desc">the clipping viewport</td></tr>
<tr><td><code>layout</code></td><td><span class="sig">SLBox layout</span></td><td class="desc">horizontal: content column + vertical scrollbar</td></tr>
<tr><td><code>content</code></td><td><span class="sig">SLBox content</span></td><td class="desc">the vertical content column children attach to</td></tr>
<tr><td><code>vbar</code></td><td><span class="sig">SLScrollBar vbar</span></td><td class="desc">vertical scrollbar (shown only when overflowing)</td></tr>
<tr><td><code>hbar</code></td><td><span class="sig">SLScrollBar hbar</span></td><td class="desc">horizontal scrollbar (optional)</td></tr>
<tr><td><code>contentExtent</code></td><td><span class="sig">int contentExtent</span></td><td class="desc">natural content height in pixels</td></tr>
<tr><td><code>viewportExtent</code></td><td><span class="sig">int viewportExtent</span></td><td class="desc">visible viewport height in pixels</td></tr>
<tr><td><code>horizontal</code></td><td><span class="sig">boolean horizontal</span></td><td class="desc">whether a horizontal bar is enabled</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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, boolean horizontalBar)</span></td><td class="desc">Create a scroll view inside `parent`. horizontalBar enables the x-axis bar.</td></tr>
<tr><td><code>contentArea</code></td><td><span class="sig">SLWidget contentArea()</span></td><td class="desc">The container children attach to (via createIn(scroll.content(), ...)).</td></tr>
<tr><td><code>setExtents</code></td><td><span class="sig">void setExtents(int content_px, int viewport_px)</span></td><td class="desc">Tell the view how tall its content and viewport are so it can size the thumb (page fraction) and decide whether the bar is needed.</td></tr>
<tr><td><code>overflowing</code></td><td><span class="sig">boolean overflowing()</span></td><td class="desc">Whether the content currently overflows the viewport (bar is meaningful).</td></tr>
<tr><td><code>scrollOffset</code></td><td><span class="sig">int scrollOffset()</span></td><td class="desc">Current vertical scroll offset in pixels, derived from the bar position. The position is a [0,1] double; we convert through a permille integer so the result stays in integer pixel space with no float->int cast.</td></tr>
<tr><td><code>positionPermille</code></td><td><span class="sig">int positionPermille()</span></td><td class="desc">The bar position in integer permille (0..1000), i.e. floor(position*1000).</td></tr>
<tr><td><code>scrollToPixel</code></td><td><span class="sig">void scrollToPixel(int y)</span></td><td class="desc">Scroll so the pixel row `y` is visible (used by tree/list/text to follow the caret or selection).</td></tr>
<tr><td><code>scrolled</code></td><td><span class="sig">boolean scrolled()</span></td><td class="desc">True if the user moved either bar since the last check.</td></tr>
<tr><td><code>clamp01</code></td><td><span class="sig">double clamp01(double v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slsearchentry">SLSearchEntry <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLSearchEntry.sleela)</span></h2>
<div data-u="slsearchentry slsearchentry">
<h3 id="SLSearchEntry">SLSearchEntry <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLSearchEntry — a SleelaUI search field: a single-line entry with a leading magnifier glyph and a "Search" placeholder, used for filter/search inputs. It behaves like SLEntry otherwise (UTF-8 editing, caret, Enter raises an activate event). The constructor bottoms out in the `uiSearchEntry` built-in (SleelaUI C ABI slui_search_entry()); the committed text is read/written through the inherited text()/setText(). An SLSearchEntry IS an SLWidget and is keyboard-focusable. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String placeholder)</span></td><td class="desc">Create a search entry inside `parent` (placeholder defaults to "Search").</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String placeholder)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>submitted</code></td><td><span class="sig">boolean submitted()</span></td><td class="desc">True if Enter was pressed since the last check (latch cleared on read).</td></tr>
</table>
</div>
<h2 class="section" data-u="slseparator">SLSeparator <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLSeparator.sleela)</span></h2>
<div data-u="slseparator slseparator">
<h3 id="SLSeparator">SLSeparator <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLSeparator — a SleelaUI 1px hairline rule in the theme's border colour, used to divide sections of a layout. It can be horizontal (a full-width rule in a vertical box) or vertical (a full-height rule in a horizontal box). The constructor bottoms out in the `uiSeparator` built-in, which calls the SleelaUI C ABI slui_separator(). An SLSeparator IS an SLWidget but is non-interactive and non-focusable. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, int orientation)</span></td><td class="desc">Create a separator inside `parent`. orientation is ORIENT_HORIZONTAL (a horizontal rule) or ORIENT_VERTICAL (a vertical rule).</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, int orientation)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>horizontal</code></td><td><span class="sig">void horizontal(SLWidget parent)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>vertical</code></td><td><span class="sig">void vertical(SLWidget parent)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slslider">SLSlider <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLSlider.sleela)</span></h2>
<div data-u="slslider slslider">
<h3 id="SLSlider">SLSlider <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLSlider — a SleelaUI horizontal slider: a thin trough with an accent fill up to the current value and a round knob, draggable with the pointer or nudgeable with the arrow keys when focused. The constructor bottoms out in the `uiSlider` built-in (SleelaUI C ABI slui_slider()); the value is read/written through value()/setValue(), clamped to the [min, max] range given at construction. An SLSlider IS an SLWidget and is keyboard-focusable. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, double min, double max, double value)</span></td><td class="desc">Create a slider inside `parent` spanning [min, max] with an initial value.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, double min, double max, double value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>value</code></td><td><span class="sig">double value()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setValue</code></td><td><span class="sig">void setValue(double value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>changed</code></td><td><span class="sig">boolean changed()</span></td><td class="desc">True if the value changed since the last check (latch cleared on read).</td></tr>
</table>
</div>
<h2 class="section" data-u="slspacer">SLSpacer <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLSpacer.sleela)</span></h2>
<div data-u="slspacer slspacer">
<h3 id="SLSpacer">SLSpacer <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLSpacer — a SleelaUI flexible gap: an invisible, zero-natural-size child that expands to absorb surplus space along its box's main axis. It is the idiom for pushing a control to the far edge of a box (e.g. a settings gear to the right of a header bar). The constructor bottoms out in the `uiSpacer` built-in, which calls the SleelaUI C ABI slui_spacer(). An SLSpacer IS an SLWidget but has no painted content; it only consumes space. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent)</span></td><td class="desc">Create a flexible spacer inside `parent`.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slspinbutton">SLSpinButton <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLSpinButton.sleela)</span></h2>
<div data-u="slspinbutton slspinbutton">
<h3 id="SLSpinButton">SLSpinButton <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLSpinButton — a SleelaUI numeric spin button: a value between two steppers (minus / plus) that increment by a fixed step, clamped to a [min, max] range (arrow keys also step while focused). Use it for bounded numeric input. The constructor bottoms out in the `uiSpinButton` built-in (SleelaUI C ABI slui_spin_button()); the value is read/written through value()/setValue(). An SLSpinButton IS an SLWidget and is keyboard-focusable. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, double min, double max, double step,</span></td><td class="desc">Create a spin button inside `parent` spanning [min, max], stepping by `step`, with an initial value.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, double min, double max, double step,</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>value</code></td><td><span class="sig">double value()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setValue</code></td><td><span class="sig">void setValue(double value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>changed</code></td><td><span class="sig">boolean changed()</span></td><td class="desc">True if the value changed since the last check (latch cleared on read).</td></tr>
</table>
</div>
<h2 class="section" data-u="slspinner">SLSpinner <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLSpinner.sleela)</span></h2>
<div data-u="slspinner slspinner">
<h3 id="SLSpinner">SLSpinner <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLSpinner — a SleelaUI indeterminate activity spinner: an accent arc riding a faint ring, used while a task of unknown length runs. The host advances the arc by setting a phase in [0,1] each frame (the toolkit draws the arc at that position). The constructor bottoms out in the `uiSpinner` built-in (SleelaUI C ABI slui_spinner()); the phase is set through setPhase(). An SLSpinner IS an SLWidget but is non-interactive. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent)</span></td><td class="desc">Create a spinner inside `parent`.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setPhase</code></td><td><span class="sig">void setPhase(double phase)</span></td><td class="desc">Advance the bright arc; phase wraps over [0,1].</td></tr>
<tr><td><code>phase</code></td><td><span class="sig">double phase()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slstatusbar">SLStatusBar <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLStatusBar.sleela)</span></h2>
<div data-u="slstatusbar slstatusbar">
<h3 id="SLStatusBar">SLStatusBar <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLStatusBar — a SleelaUI footer status strip: a chrome band with a 1px top hairline that lays its children out horizontally. Use it for a resting status line (e.g. "Ready", a spacer, the version). The constructor bottoms out in the `uiStatusBar` built-in (SleelaUI C ABI slui_status_bar()); children are added by constructing control classes against this status bar's handle. An SLStatusBar IS an SLWidget container (horizontal). Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent)</span></td><td class="desc">Create a status bar inside `parent` (normally the window root).</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sltabbar">SLTabBar <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLTabBar.sleela)</span></h2>
<div data-u="sltabbar sltabbar">
<h3 id="SLTabBar">SLTabBar <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">A reusable horizontal browser-style tab bar. It uses the existing native SLButton visual states and current window theme, with a clear selected accent, consistent inactive tabs, compact spacing, and one-shot click activation. Page content is deliberately left to the caller. Family: user-interface.</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>MAX_TABS</code></td><td><span class="sig">static final int MAX_TABS = 512</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>strip</code></td><td><span class="sig">SLBox strip</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tabs</code></td><td><span class="sig">SLButton[] tabs</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>titles</code></td><td><span class="sig">String[] titles</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dirty</code></td><td><span class="sig">boolean[] dirty</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"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>active</code></td><td><span class="sig">int active</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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>addTab</code></td><td><span class="sig">int addTab(String title)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>select</code></td><td><span class="sig">void select(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>selectedIndex</code></td><td><span class="sig">int selectedIndex()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tabCount</code></td><td><span class="sig">int tabCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>takeClickedTab</code></td><td><span class="sig">int takeClickedTab()</span></td><td class="desc">Poll after the UI event loop has dispatched input. Returns index or -1.</td></tr>
<tr><td><code>selectPrevious</code></td><td><span class="sig">void selectPrevious()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>selectNext</code></td><td><span class="sig">void selectNext()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setTitle</code></td><td><span class="sig">void setTitle(int index, String title)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setDirty</code></td><td><span class="sig">void setDirty(int index, boolean value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isDirty</code></td><td><span class="sig">boolean isDirty(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>refreshTitle</code></td><td><span class="sig">void refreshTitle(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sltextview">SLTextView <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLTextView.sleela)</span></h2>
<div data-u="sltextview sltextview">
<h3 id="SLTextView">SLTextView <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLTextView — a competent SleelaUI multi-line editable text / code editor, written entirely in SLeeLa. It owns the text model (a line buffer, a caret at line/column, and an optional selection span) and renders it onto an SLCanvasView via the SleelaUI Draw API: a gutter with 1-based line numbers, the text lines in a monospace metric, the current-line highlight, the selection band, and a block caret. It exposes real editing operations — insert text, newline, backspace, delete, and caret movement — and a dirty flag that distinguishes a load from user edits. This is the code editor an IDE needs, with no new C ABI: it composes SLCanvasView + SLDrawContext. An SLTextView IS an SLWidget (its handle is the canvas view's handle). Family: user-interface. Native VM/UI work crosses the explicit `ui*`/`draw*` SLVM bridges.</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>MAX_LINES</code></td><td><span class="sig">static final int MAX_LINES = 1048576</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>LINE_HEIGHT</code></td><td><span class="sig">static final int LINE_HEIGHT = 18</span></td><td class="desc">px per text row</td></tr>
<tr><td><code>CHAR_WIDTH</code></td><td><span class="sig">static final int CHAR_WIDTH = 9</span></td><td class="desc">px per monospace cell</td></tr>
<tr><td><code>GUTTER_W</code></td><td><span class="sig">static final int GUTTER_W = 52</span></td><td class="desc">px line-number gutter</td></tr>
<tr><td><code>PAD_X</code></td><td><span class="sig">static final int PAD_X = 8</span></td><td class="desc">px left padding inside the text area</td></tr>
<tr><td><code>COL_BG</code></td><td><span class="sig">static final int COL_BG = 0x151515FF</span></td><td class="desc">Slick Black palette (0xRRGGBBAA), consistent with the SleelaUI theme.</td></tr>
<tr><td><code>COL_GUTTER_BG</code></td><td><span class="sig">static final int COL_GUTTER_BG = 0x1E1E1EFF</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>COL_GUTTER_FG</code></td><td><span class="sig">static final int COL_GUTTER_FG = 0x6A6A6AFF</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>COL_TEXT</code></td><td><span class="sig">static final int COL_TEXT = 0xE6E6E6FF</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>COL_CARET</code></td><td><span class="sig">static final int COL_CARET = 0x3BE07AFF</span></td><td class="desc">brand green</td></tr>
<tr><td><code>COL_SELECT</code></td><td><span class="sig">static final int COL_SELECT = 0x294C38FF</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>COL_CURLINE</code></td><td><span class="sig">static final int COL_CURLINE = 0x1C1C1CFF</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>canvas</code></td><td><span class="sig">SLCanvasView canvas</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lines</code></td><td><span class="sig">String[] lines</span></td><td class="desc">Text model.</td></tr>
<tr><td><code>lineCount</code></td><td><span class="sig">int lineCount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>caretLine</code></td><td><span class="sig">int caretLine</span></td><td class="desc">Caret and selection (line/column are 0-based).</td></tr>
<tr><td><code>caretCol</code></td><td><span class="sig">int caretCol</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>anchorLine</code></td><td><span class="sig">int anchorLine</span></td><td class="desc">selection anchor; equal to caret when there is no selection</td></tr>
<tr><td><code>anchorCol</code></td><td><span class="sig">int anchorCol</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dirty</code></td><td><span class="sig">boolean dirty</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>topLine</code></td><td><span class="sig">int topLine</span></td><td class="desc">first visible line (vertical scroll in lines)</td></tr>
<tr><td><code>viewportRows</code></td><td><span class="sig">int viewportRows</span></td><td class="desc">visible text rows (set from the canvas height)</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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, int width, int height)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setDrawHandler</code></td><td><span class="sig">void setDrawHandler(int handlerId)</span></td><td class="desc">Register the SLeeLa draw-handler ordinal the VM calls each frame; the handler body should call render(ctx) with its SLDrawContext.</td></tr>
<tr><td><code>loadLines</code></td><td><span class="sig">void loadLines(String[] newLines, int n)</span></td><td class="desc">Replace the whole buffer from a list of lines (a load, not an edit).</td></tr>
<tr><td><code>getLineCount</code></td><td><span class="sig">int getLineCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lineAt</code></td><td><span class="sig">String lineAt(int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isDirty</code></td><td><span class="sig">boolean isDirty()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>markSaved</code></td><td><span class="sig">void markSaved()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clearSelection</code></td><td><span class="sig">void clearSelection()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasSelection</code></td><td><span class="sig">boolean hasSelection()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>moveTo</code></td><td><span class="sig">void moveTo(int line, int col, boolean extend)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>moveLeft</code></td><td><span class="sig">void moveLeft(boolean extend)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>moveRight</code></td><td><span class="sig">void moveRight(boolean extend)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>moveUp</code></td><td><span class="sig">void moveUp(boolean extend)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>moveDown</code></td><td><span class="sig">void moveDown(boolean extend)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>moveHome</code></td><td><span class="sig">void moveHome(boolean extend)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>moveEnd</code></td><td><span class="sig">void moveEnd(boolean extend)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clickAt</code></td><td><span class="sig">void clickAt(int px, int py, boolean extend)</span></td><td class="desc">Map a pixel click inside the text area to a caret position.</td></tr>
<tr><td><code>insert</code></td><td><span class="sig">void insert(String s)</span></td><td class="desc">Insert a run of text with no newlines at the caret.</td></tr>
<tr><td><code>newline</code></td><td><span class="sig">void newline()</span></td><td class="desc">Split the current line at the caret (Enter).</td></tr>
<tr><td><code>backspace</code></td><td><span class="sig">void backspace()</span></td><td class="desc">Backspace: delete the selection, else the char before the caret, else join with the previous line.</td></tr>
<tr><td><code>deleteForward</code></td><td><span class="sig">void deleteForward()</span></td><td class="desc">Forward delete.</td></tr>
<tr><td><code>deleteSelection</code></td><td><span class="sig">void deleteSelection()</span></td><td class="desc">Delete the current selection and place the caret at its start. Only the single-line and whole-line-span common cases are modeled here; a full multi-line splice is a host-assisted operation.</td></tr>
<tr><td><code>render</code></td><td><span class="sig">void render(SLDrawContext ctx)</span></td><td class="desc">Paint the editor into `ctx` (an SLDrawContext bound to the canvas frame).</td></tr>
<tr><td><code>paintSelectionBand</code></td><td><span class="sig">void paintSelectionBand(SLDrawContext ctx, int line, int y, int w)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>paintCaret</code></td><td><span class="sig">void paintCaret(SLDrawContext ctx)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>followCaret</code></td><td><span class="sig">void followCaret()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>insertLineAt</code></td><td><span class="sig">void insertLineAt(int index, String value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>removeLineAt</code></td><td><span class="sig">void removeLineAt(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clampLine</code></td><td><span class="sig">int clampLine(int line)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clampCol</code></td><td><span class="sig">int clampCol(int line, int col)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>selectionForward</code></td><td><span class="sig">boolean selectionForward()</span></td><td class="desc">Normalized selection bounds (start precedes end in document order).</td></tr>
<tr><td><code>selStartLine</code></td><td><span class="sig">int selStartLine()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>selStartCol</code></td><td><span class="sig">int selStartCol()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>selEndLine</code></td><td><span class="sig">int selEndLine()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>selEndCol</code></td><td><span class="sig">int selEndCol()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>len</code></td><td><span class="sig">int len(String s)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>substr</code></td><td><span class="sig">String substr(String s, int from, int to)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sltheme">SLTheme <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLTheme.sleela)</span></h2>
<div data-u="sltheme sltheme">
<h3 id="SLTheme">SLTheme <span class="pill">class</span></h3>
<p class="desc">Defines SLTheme — a SleelaUI palette handle. A theme is the single source of truth for a window's look: a flat set of named role colours plus a corner radius, spacing unit, control height, and font. This class wraps the toolkit's theme built-ins: uiThemePreset (fill from a built-in preset), the role setters (uiThemeSet*), metric/font setters, and the base-colour hooks. Each bottoms out in the SleelaUI C ABI (slui_theme_preset + the SLUITheme fields). The DEFAULT is a cool graphite/charcoal palette with a steel-blue accent. White, blue, black and gray are selectable named presets. Apps may choose a preset directly in source or explicitly load a named theme from a key=value configuration file. Configuration is never silently auto-loaded. A theme is a VM-local handle (-1 = none). Pass handle() to SLUserInterface.openWindow() or SLWindow.setTheme(); pass -1 anywhere a theme is expected to get the default. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>SLICK_BLACK</code></td><td><span class="sig">static final int SLICK_BLACK = 0</span></td><td class="desc">Preset ordinals mirror SLUIThemeId in the toolkit C ABI.</td></tr>
<tr><td><code>GRAPHITE</code></td><td><span class="sig">static final int GRAPHITE = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CUSTOM</code></td><td><span class="sig">static final int CUSTOM = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SLEELA_BASE</code></td><td><span class="sig">static final int SLEELA_BASE = 3</span></td><td class="desc">DEFAULT is the coordinated graphite/charcoal + steel-blue palette.</td></tr>
<tr><td><code>DEFAULT</code></td><td><span class="sig">static final int DEFAULT = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>WHITE</code></td><td><span class="sig">static final int WHITE = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>BLACK</code></td><td><span class="sig">static final int BLACK = 5</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>BLUE</code></td><td><span class="sig">static final int BLUE = 6</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>GRAY</code></td><td><span class="sig">static final int GRAY = 7</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>BASE_COLOR_DEFAULT</code></td><td><span class="sig">static final int BASE_COLOR_DEFAULT = 0x1D2025FF</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>theme</code></td><td><span class="sig">int theme</span></td><td class="desc">VM-local theme handle (-1 = none)</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>preset</code></td><td><span class="sig">void preset(int presetId)</span></td><td class="desc">Select one preset directly in source: DEFAULT, WHITE, BLUE, BLACK, or GRAY.</td></tr>
<tr><td><code>sleelaBase</code></td><td><span class="sig">void sleelaBase()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>defaultTheme</code></td><td><span class="sig">void defaultTheme()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>white</code></td><td><span class="sig">void white()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>blue</code></td><td><span class="sig">void blue()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>black</code></td><td><span class="sig">void black()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>gray</code></td><td><span class="sig">void gray()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>slickBlack</code></td><td><span class="sig">void slickBlack()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>handle</code></td><td><span class="sig">int handle()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>valid</code></td><td><span class="sig">boolean valid()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setBaseColor</code></td><td><span class="sig">void setBaseColor(int baseColor)</span></td><td class="desc">Re-derive a neutral/cool palette from a custom base colour (0xRRGGBBAA).</td></tr>
<tr><td><code>loadConfig</code></td><td><span class="sig">boolean loadConfig(String path)</span></td><td class="desc">Load theme=default|white|blue|black|gray plus optional overrides from a key=value config file. Returns true on success. Config is never auto-loaded.</td></tr>
<tr><td><code>setBackground</code></td><td><span class="sig">void setBackground(int color)</span></td><td class="desc">---- Role colours (each takes an SLColor word, 0xRRGGBBAA) -------------</td></tr>
<tr><td><code>setSurface</code></td><td><span class="sig">void setSurface(int color)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setSurfaceHi</code></td><td><span class="sig">void setSurfaceHi(int color)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setChrome</code></td><td><span class="sig">void setChrome(int color)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setBorder</code></td><td><span class="sig">void setBorder(int color)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setForeground</code></td><td><span class="sig">void setForeground(int color)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setForegroundDim</code></td><td><span class="sig">void setForegroundDim(int color)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setAccent</code></td><td><span class="sig">void setAccent(int color)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setAccentForeground</code></td><td><span class="sig">void setAccentForeground(int color)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setDanger</code></td><td><span class="sig">void setDanger(int color)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setRadius</code></td><td><span class="sig">void setRadius(int px)</span></td><td class="desc">---- Metrics and typography --------------------------------------------</td></tr>
<tr><td><code>setControlHeight</code></td><td><span class="sig">void setControlHeight(int px)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setFont</code></td><td><span class="sig">void setFont(String family, int sizePt)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setAccentColor</code></td><td><span class="sig">void setAccentColor(SLColor c)</span></td><td class="desc">Convenience: set a role colour from an SLColor object.</td></tr>
<tr><td><code>close</code></td><td><span class="sig">void close()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slthrobber">SLThrobber <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLThrobber.sleela)</span></h2>
<div data-u="slthrobber slthrobber">
<h3 id="SLThrobber">SLThrobber <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLThrobber — a SleelaUI width-adjustable, full-motion, colour-predictive, water-like flowing activity throbber. Unlike a spinning ring, it is a fluid field: crests travel, disperse, and recombine like ripples on water, their colour arriving slightly AHEAD of the motion (the hue leads the local velocity), with latent hues surfacing on the brightest crests under strong flow and receding as it calms. The width is adjustable at any time and the field rescales while keeping the same physical feel. The constructor bottoms out in the `uiThrobber` built-in (SleelaUI C ABI slui_throbber()); it is an animated widget — while visible the window's frame loop advances it and repaints it at its refresh rate. An SLThrobber IS an SLWidget. Height follows setSizeRequest (a slim seam by default); set the width with setWidth, the flow vigour with setIntensity, and the base hue with setHue. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, int widthPx)</span></td><td class="desc">Create a throbber inside `parent` with an initial pixel width.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, int widthPx)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setWidth</code></td><td><span class="sig">void setWidth(int widthPx)</span></td><td class="desc">Adjust the width in pixels; the water field rescales to fit.</td></tr>
<tr><td><code>setIntensity</code></td><td><span class="sig">void setIntensity(double intensity)</span></td><td class="desc">Flow vigour in [0,1]: 0 = a calm trickle, 1 = vigorous flow. Drives both the speed and the colour spread of the field.</td></tr>
<tr><td><code>setHue</code></td><td><span class="sig">void setHue(double hueDegrees)</span></td><td class="desc">Base hue in degrees the predictive colouring flows around (205 ~ water; 150 ~ green water; 30 ~ warm). The actual rendered hue leads this by the local flow velocity.</td></tr>
</table>
</div>
<h2 class="section" data-u="sltoggle">SLToggle <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLToggle.sleela)</span></h2>
<div data-u="sltoggle sltoggle">
<h3 id="SLToggle">SLToggle <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLToggle — a SleelaUI toggle switch: a pill track with a sliding knob and a trailing label. On uses the theme accent; off uses a neutral surface with a hairline. Flipping it (click, or Enter/Space while focused) raises an activate event and updates the boolean state. The constructor bottoms out in the `uiToggle` built-in (SleelaUI C ABI slui_toggle()); the state is read/written through isOn()/setOn(). An SLToggle IS an SLWidget and is keyboard-focusable. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String label, boolean initialOn)</span></td><td class="desc">Create a toggle inside `parent` with a label and initial state.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String label, boolean initialOn)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isOn</code></td><td><span class="sig">boolean isOn()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setOn</code></td><td><span class="sig">void setOn(boolean on)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>changed</code></td><td><span class="sig">boolean changed()</span></td><td class="desc">True if the toggle flipped since the last check (latch cleared on read).</td></tr>
</table>
</div>
<h2 class="section" data-u="sltooltip">SLTooltip <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLTooltip.sleela)</span></h2>
<div data-u="sltooltip sltooltip">
<h3 id="SLTooltip">SLTooltip <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLTooltip — a SleelaUI tooltip bubble: a small raised surface with a 1px hairline and short explanatory text, used to annotate a control. The constructor bottoms out in the `uiTooltip` built-in (SleelaUI C ABI slui_tooltip()); the text is updated through the inherited setText(). An SLTooltip IS an SLWidget but is non-interactive. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, String text)</span></td><td class="desc">Create a tooltip inside `parent` with a message.</td></tr>
<tr><td><code>createInHandle</code></td><td><span class="sig">void createInHandle(int parentHandle, String text)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sltreeview">SLTreeView <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLTreeView.sleela)</span></h2>
<div data-u="sltreeview sltreeview">
<h3 id="SLTreeView">SLTreeView <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">Defines SLTreeView — a competent SleelaUI hierarchical tree. It is a composite widget (no new C ABI): an SLScrollView whose content column holds one SLLabel row per *visible* node, indented by depth and prefixed with a disclosure marker. Nodes carry a stable id, a display label, a parent id, a depth, an expanded flag, and a leaf flag. Expanding/collapsing a branch recomputes the visible row set; clicking a row selects it and reports the selected node id. This is the data widget an IDE project explorer needs, written entirely in SLeeLa over the SleelaUI primitives. An SLTreeView IS an SLWidget (its handle is the scroll view's frame). Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>MAX_NODES</code></td><td><span class="sig">static final int MAX_NODES = 65536</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ROW_HEIGHT</code></td><td><span class="sig">static final int ROW_HEIGHT = 22</span></td><td class="desc">pixels per row (for scroll math)</td></tr>
<tr><td><code>scroll</code></td><td><span class="sig">SLScrollView scroll</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ids</code></td><td><span class="sig">String[] ids</span></td><td class="desc">Node model (parallel arrays keyed by node index).</td></tr>
<tr><td><code>labels</code></td><td><span class="sig">String[] labels</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>parents</code></td><td><span class="sig">int[] parents</span></td><td class="desc">index of parent node, -1 for a root</td></tr>
<tr><td><code>depths</code></td><td><span class="sig">int[] depths</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>expanded</code></td><td><span class="sig">boolean[] expanded</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>leaf</code></td><td><span class="sig">boolean[] leaf</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"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>visible</code></td><td><span class="sig">int[] visible</span></td><td class="desc">Visible-row projection (indices into the node arrays, in display order).</td></tr>
<tr><td><code>visibleCount</code></td><td><span class="sig">int visibleCount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>rows</code></td><td><span class="sig">SLLabel[] rows</span></td><td class="desc">One reusable label row per visible slot.</td></tr>
<tr><td><code>rowCapacity</code></td><td><span class="sig">int rowCapacity</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>selectedRow</code></td><td><span class="sig">int selectedRow</span></td><td class="desc">index into `visible`, -1 when nothing selected</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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent, int visibleRows)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>addNode</code></td><td><span class="sig">int addNode(String id, String label, String parentId, boolean isLeaf)</span></td><td class="desc">Add a node under `parentId` ("" / null for a root). Returns its index.</td></tr>
<tr><td><code>indexOfId</code></td><td><span class="sig">int indexOfId(String id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>rebuild</code></td><td><span class="sig">void rebuild()</span></td><td class="desc">Recompute the visible rows: a node is visible when every ancestor is expanded. Walks nodes in insertion order (parents precede children).</td></tr>
<tr><td><code>ancestorsExpanded</code></td><td><span class="sig">boolean ancestorsExpanded(int node)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>paint</code></td><td><span class="sig">void paint()</span></td><td class="desc">Repaint the visible slice into the reusable row labels.</td></tr>
<tr><td><code>firstVisibleRow</code></td><td><span class="sig">int firstVisibleRow()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>rowText</code></td><td><span class="sig">String rowText(int node)</span></td><td class="desc">" > Branch" / " file.sleela" — indent by depth, disclosure marker.</td></tr>
<tr><td><code>indent</code></td><td><span class="sig">String indent(int depth)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>toggle</code></td><td><span class="sig">void toggle(String id)</span></td><td class="desc">Toggle a branch open/closed by node id; leaves are ignored.</td></tr>
<tr><td><code>selectRow</code></td><td><span class="sig">void selectRow(int visibleIndex)</span></td><td class="desc">Select a visible row (0-based into the visible projection).</td></tr>
<tr><td><code>selectedId</code></td><td><span class="sig">String selectedId()</span></td><td class="desc">The selected node id, or null when nothing is selected.</td></tr>
<tr><td><code>selectionIsLeaf</code></td><td><span class="sig">boolean selectionIsLeaf()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>nodeCount</code></td><td><span class="sig">int nodeCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>visibleRowCount</code></td><td><span class="sig">int visibleRowCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sluserinterface">SLUserInterface <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLUserInterface.sleela)</span></h2>
<div data-u="sluserinterface sluserinterface">
<h3 id="SLUserInterface">SLUserInterface <span class="pill">class</span></h3>
<p class="desc">Defines SLUserInterface — the capstone facade of the /lib/user-interface family. It is the single object a developer reaches for to open a window and build a graphical interface from SLeeLa source using SleelaUI™, SLeeLa's OWN original cross-platform UI toolkit (not GTK/Qt). Every method bottoms out in a `ui*` SLVM built-in that calls the GENUINE SleelaUI C ABI (include/sleela_ui.h) — which in turn drives the real host window system: X11 on Linux/Unix, Cocoa on macOS, Win32 on Windows 10+. So the same SLeeLa program raises a real window on whichever platform runs it, with the signature Slick Black look identical on all three. This is the general entry point: create the application, open a window, hand back its root container, then run the toolkit's event loop. The individual widget classes (SLButton, SLLabel, …) build on the same `ui*` built-ins. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge, the same discipline as /lib/os's `os*` bridge.</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>BACKEND_UNKNOWN</code></td><td><span class="sig">static final int BACKEND_UNKNOWN = 0</span></td><td class="desc">Backend ordinals (mirror SLUIBackend in the toolkit C ABI).</td></tr>
<tr><td><code>BACKEND_WIN32</code></td><td><span class="sig">static final int BACKEND_WIN32 = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>BACKEND_COCOA</code></td><td><span class="sig">static final int BACKEND_COCOA = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>BACKEND_X11</code></td><td><span class="sig">static final int BACKEND_X11 = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>appId</code></td><td><span class="sig">String appId</span></td><td class="desc">application identifier, e.g. "com.mearvk.App"</td></tr>
<tr><td><code>app</code></td><td><span class="sig">int app</span></td><td class="desc">VM-local application handle (-1 = none)</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 id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>open</code></td><td><span class="sig">boolean open()</span></td><td class="desc">Create the SleelaUI application connection (opens the host display). Returns true if the toolkit came up (false if, e.g., no display on X11).</td></tr>
<tr><td><code>active</code></td><td><span class="sig">boolean active()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>backend</code></td><td><span class="sig">String backend()</span></td><td class="desc">The window-system backend driving this process: "x11" / "cocoa" / "win32".</td></tr>
<tr><td><code>backendId</code></td><td><span class="sig">int backendId()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>version</code></td><td><span class="sig">String version()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isLinux</code></td><td><span class="sig">boolean isLinux()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isMac</code></td><td><span class="sig">boolean isMac()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isWindows</code></td><td><span class="sig">boolean isWindows()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>screenWidth</code></td><td><span class="sig">int screenWidth()</span></td><td class="desc">The primary screen / display size in pixels, straight from the host window system (uiScreenWidth / uiScreenHeight bottom out in slui_screen_size). Returns 0 when the toolkit cannot report a size — e.g. a headless host, or before open() has connected the display — so callers can fall back to a modeled resolution (see SLGuiScreenFit). Needs an open application.</td></tr>
<tr><td><code>screenHeight</code></td><td><span class="sig">int screenHeight()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>screenKnown</code></td><td><span class="sig">boolean screenKnown()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>openWindow</code></td><td><span class="sig">SLWindow openWindow(String title, int width, int height, int themeHandle)</span></td><td class="desc">Open a window on this application. title/width/height describe the content area; theme is an SLTheme handle (pass -1 for the Slick Black default). Returns an SLWindow bound to the new native window.</td></tr>
<tr><td><code>run</code></td><td><span class="sig">int run()</span></td><td class="desc">Run the toolkit's own event loop until every window closes (or quit()). Returns the process-style exit code.</td></tr>
<tr><td><code>pump</code></td><td><span class="sig">int pump(boolean block)</span></td><td class="desc">Process pending host events once; block != 0 waits for at least one. Returns the number of events dispatched, or a negative error.</td></tr>
<tr><td><code>quit</code></td><td><span class="sig">void quit(int exitCode)</span></td><td class="desc">Ask the event loop to stop; run() returns exitCode.</td></tr>
<tr><td><code>close</code></td><td><span class="sig">void close()</span></td><td class="desc">Release the application and all its windows.</td></tr>
</table>
</div>
<h2 class="section" data-u="slverticaltabs">SLVerticalTabs <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLVerticalTabs.sleela)</span></h2>
<div data-u="slverticaltabs slverticaltabs">
<h3 id="SLVerticalTabs">SLVerticalTabs <span class="pill">class</span> <span class="muted">extends <code>SLWidget</code></span></h3>
<p class="desc">A vertical navigation-tabs composite for settings, tool panels, and application sections. A narrow themed button rail sits beside a page stack; selecting a rail item reveals exactly one content container. Uses existing native button states and the active theme without fixed colors. Family: user-interface.</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>MAX_PAGES</code></td><td><span class="sig">static final int MAX_PAGES = 512</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>layout</code></td><td><span class="sig">SLBox layout</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>rail</code></td><td><span class="sig">SLBox rail</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>stack</code></td><td><span class="sig">SLBox stack</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tabs</code></td><td><span class="sig">SLButton[] tabs</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pages</code></td><td><span class="sig">SLBox[] pages</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>titles</code></td><td><span class="sig">String[] titles</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dirty</code></td><td><span class="sig">boolean[] dirty</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"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>active</code></td><td><span class="sig">int active</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>createIn</code></td><td><span class="sig">void createIn(SLWidget parent)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>addPage</code></td><td><span class="sig">int addPage(String title)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pageContent</code></td><td><span class="sig">SLWidget pageContent(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>select</code></td><td><span class="sig">void select(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>selectedIndex</code></td><td><span class="sig">int selectedIndex()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pageCount</code></td><td><span class="sig">int pageCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>takeClickedTab</code></td><td><span class="sig">int takeClickedTab()</span></td><td class="desc">Poll after the UI event loop has dispatched input. Returns index or -1.</td></tr>
<tr><td><code>setTitle</code></td><td><span class="sig">void setTitle(int index, String title)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setDirty</code></td><td><span class="sig">void setDirty(int index, boolean value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isDirty</code></td><td><span class="sig">boolean isDirty(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>refreshTitle</code></td><td><span class="sig">void refreshTitle(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slwash">SLWash <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLWash.sleela)</span></h2>
<div data-u="slwash slwash">
<h3 id="SLWash">SLWash <span class="pill">class</span></h3>
<p class="desc">Defines SLWash — an "Excellent Wash": a soft, multi-stop graded colour field (up to 8 stops) that paints a SleelaUI mood. Stops are sampled with smoothstep so the wash reads as a gentle gradient, not hard bands. Light colours are known and adjustable; the wash is how a mood colours the light. It is a VM-local handle built up stop by stop and handed to an SLMood. Each method bottoms out in a `wash*` SLVM built-in calling the C ABI (sleela_ui_mood.h). Family: user-interface. Native VM/UI work crosses the explicit `wash*` SLVM bridge.</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>wash</code></td><td><span class="sig">int wash</span></td><td class="desc">VM-local handle (-1 = none)</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>begin</code></td><td><span class="sig">void begin()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>handle</code></td><td><span class="sig">int handle()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>valid</code></td><td><span class="sig">boolean valid()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>destroy</code></td><td><span class="sig">void destroy()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>stop</code></td><td><span class="sig">void stop(double position, int color)</span></td><td class="desc">Add a colour stop at position in [0,1]. Softness (0..1) extra-blurs between stops for a gentler wash.</td></tr>
<tr><td><code>setSoftness</code></td><td><span class="sig">void setSoftness(double softness)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>linear</code></td><td><span class="sig">void linear(int a, int b)</span></td><td class="desc">Two- and three-stop shortcuts for the common washes.</td></tr>
<tr><td><code>triad</code></td><td><span class="sig">void triad(int a, int b, int c)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>sample</code></td><td><span class="sig">int sample(double t)</span></td><td class="desc">Sample the wash at t in [0,1] -> colour (0xRRGGBBAA).</td></tr>
</table>
</div>
<h2 class="section" data-u="slwidget">SLWidget <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLWidget.sleela)</span></h2>
<div data-u="slwidget slwidget">
<h3 id="SLWidget">SLWidget <span class="pill">class</span></h3>
<p class="desc">Defines SLWidget — the base class for every SleelaUI control and container reached from SLeeLa source. It holds the VM-local widget handle and the common configuration the toolkit exposes on all widgets: margins, alignment, expansion, a minimum size request, sensitivity (grey-out), visibility, text, and the suggested/destructive accents. Each setter bottoms out in a `ui*` built-in that calls the SleelaUI C ABI. Subclasses (SLBox, SLHeaderBar, SLLabel, SLButton, SLToggle, SLEntry, SLSlider, SLSeparator, SLSpacer) are constructed against a parent handle and then inherit all of this common configuration surface. Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>ALIGN_START</code></td><td><span class="sig">static final int ALIGN_START = 0</span></td><td class="desc">Alignment ordinals (mirror SLUIAlign in the toolkit C ABI).</td></tr>
<tr><td><code>ALIGN_CENTER</code></td><td><span class="sig">static final int ALIGN_CENTER = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ALIGN_END</code></td><td><span class="sig">static final int ALIGN_END = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ALIGN_FILL</code></td><td><span class="sig">static final int ALIGN_FILL = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ORIENT_VERTICAL</code></td><td><span class="sig">static final int ORIENT_VERTICAL = 0</span></td><td class="desc">Orientation ordinals (mirror SLUIOrientation).</td></tr>
<tr><td><code>ORIENT_HORIZONTAL</code></td><td><span class="sig">static final int ORIENT_HORIZONTAL = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>widget</code></td><td><span class="sig">int widget</span></td><td class="desc">VM-local widget handle (-1 = none)</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>adopt</code></td><td><span class="sig">void adopt(int handle)</span></td><td class="desc">Adopt an existing handle (used for the window's root container).</td></tr>
<tr><td><code>handle</code></td><td><span class="sig">int handle()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>valid</code></td><td><span class="sig">boolean valid()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setMargin</code></td><td><span class="sig">void setMargin(int top, int right, int bottom, int left)</span></td><td class="desc">---- Box model: margin, alignment, expansion, minimum size -------------</td></tr>
<tr><td><code>setMarginAll</code></td><td><span class="sig">void setMarginAll(int all)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setAlign</code></td><td><span class="sig">void setAlign(int horizontal, int vertical)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setExpand</code></td><td><span class="sig">void setExpand(boolean horizontal, boolean vertical)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setSizeRequest</code></td><td><span class="sig">void setSizeRequest(int minWidth, int minHeight)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setSensitive</code></td><td><span class="sig">void setSensitive(boolean sensitive)</span></td><td class="desc">---- State -------------------------------------------------------------</td></tr>
<tr><td><code>setVisible</code></td><td><span class="sig">void setVisible(boolean visible)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setText</code></td><td><span class="sig">void setText(String text)</span></td><td class="desc">---- Text (label / button / entry) -------------------------------------</td></tr>
<tr><td><code>text</code></td><td><span class="sig">String text()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>createPopupPanel</code></td><td><span class="sig">int createPopupPanel()</span></td><td class="desc">---- Accents ----------------------------------------------------------- Create a reusable hidden popup panel within a parent layout. The caller should place it in a stack/overlay-capable container and manage visibility.</td></tr>
<tr><td><code>setPopupOpen</code></td><td><span class="sig">void setPopupOpen(int popupHandle, boolean open)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isPopupOpen</code></td><td><span class="sig">boolean isPopupOpen(int popupHandle)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiScan</code></td><td><span class="sig">int wifiScan()</span></td><td class="desc">---- Native Wi-Fi provider (shared wifi-common C/C++ core) ------------- Scan returns WIFI_STATUS_OK on success; query the bounded result cache with wifiNetworkCount/SSID/BSSID/signal/security. Indexes are zero-based.</td></tr>
<tr><td><code>wifiNetworkCount</code></td><td><span class="sig">int wifiNetworkCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiNetworkSsid</code></td><td><span class="sig">String wifiNetworkSsid(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiNetworkBssid</code></td><td><span class="sig">String wifiNetworkBssid(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiNetworkSignal</code></td><td><span class="sig">int wifiNetworkSignal(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiNetworkSecurity</code></td><td><span class="sig">String wifiNetworkSecurity(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiConnect</code></td><td><span class="sig">int wifiConnect(int index, String profileName)</span></td><td class="desc">Connect through OS-managed authentication or a trusted saved profile. The bridge never accepts raw passwords from Sleela source or places credentials on command lines.</td></tr>
<tr><td><code>wifiDisconnect</code></td><td><span class="sig">int wifiDisconnect()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wifiStatusName</code></td><td><span class="sig">String wifiStatusName(int status)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setSuggested</code></td><td><span class="sig">void setSuggested(boolean suggested)</span></td><td class="desc">Mark this as the SINGLE suggested (accent) action in its group.</td></tr>
<tr><td><code>setDestructive</code></td><td><span class="sig">void setDestructive(boolean destructive)</span></td><td class="desc">Mark this as destructive (uses the danger colour on hover).</td></tr>
<tr><td><code>setFont</code></td><td><span class="sig">void setFont(SLFont font)</span></td><td class="desc">Give this text widget a styled SLFont so its label renders with the font's effects (shadows, glow, outline, relief, gradient). The widget borrows the font. Pass null to revert to plain theme text.</td></tr>
</table>
</div>
<h2 class="section" data-u="slwindow">SLWindow <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/SLWindow.sleela)</span></h2>
<div data-u="slwindow slwindow">
<h3 id="SLWindow">SLWindow <span class="pill">class</span></h3>
<p class="desc">Defines SLWindow — a top-level SleelaUI window opened from SLeeLa source. It wraps the toolkit's window built-ins: uiWindowCreate (bound to an application + theme), uiWindowShow/Hide, uiWindowSetTitle, uiWindowRoot (the root container to add widgets to), uiWindowSetTheme, and uiWindowRedraw. Underneath, the VM calls the SleelaUI C ABI, which creates a real native window (X11/Cocoa/Win32) and paints it with the toolkit's own software rasterizer, so the window looks identical on every platform. Lifecycle: configureOn(app, title, w, h, theme) is called by SLUserInterface; then show(), set the title, add widgets to root(), and the application's run loop drives it. A window is a VM-local handle (-1 = none). Family: user-interface. Native VM/UI work crosses the explicit `ui*` SLVM bridge.</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>window</code></td><td><span class="sig">int window</span></td><td class="desc">VM-local window handle (-1 = none)</td></tr>
<tr><td><code>root</code></td><td><span class="sig">int root</span></td><td class="desc">VM-local handle of the window's root container widget</td></tr>
<tr><td><code>title</code></td><td><span class="sig">String title</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MIN_WINDOW_W</code></td><td><span class="sig">static final int MIN_WINDOW_W = 160</span></td><td class="desc">---- assumed starting size + full-screen intent ------------------------- Absolute assumed floor for a usable native window, mirroring the pure-SLeeLa lib/ui/SLLayoutFrame floor so both UI systems agree on "at least so large".</td></tr>
<tr><td><code>MIN_WINDOW_H</code></td><td><span class="sig">static final int MIN_WINDOW_H = 120</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>FULLSCREEN</code></td><td><span class="sig">static final int FULLSCREEN = 100000</span></td><td class="desc">A very large extent treated as "fill the screen" when a real screen size is not known. A native host that knows its monitor passes the true pixels to configureFullscreen() instead of relying on this sentinel.</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>configureOn</code></td><td><span class="sig">void configureOn(int app, String windowTitle, int width, int height,</span></td><td class="desc">Called by SLUserInterface.openWindow(). themeHandle -1 selects the built-in Slick Black default theme.</td></tr>
<tr><td><code>valid</code></td><td><span class="sig">boolean valid()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>rootWidget</code></td><td><span class="sig">SLWidget rootWidget()</span></td><td class="desc">The root container widget. Add boxes/controls to this to build the UI.</td></tr>
<tr><td><code>rootHandle</code></td><td><span class="sig">int rootHandle()</span></td><td class="desc">Raw root handle, for widget constructors that attach to a parent handle.</td></tr>
<tr><td><code>show</code></td><td><span class="sig">void show()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hide</code></td><td><span class="sig">void hide()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setTitle</code></td><td><span class="sig">void setTitle(String t)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>windowTitle</code></td><td><span class="sig">String windowTitle()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setTheme</code></td><td><span class="sig">void setTheme(int themeHandle)</span></td><td class="desc">Swap the whole palette live (pass an SLTheme handle).</td></tr>
<tr><td><code>requestRedraw</code></td><td><span class="sig">void requestRedraw()</span></td><td class="desc">Ask the toolkit to repaint this window on the next turn.</td></tr>
<tr><td><code>setBuffering</code></td><td><span class="sig">void setBuffering(int mode)</span></td><td class="desc">Presentation buffering: how a painted frame reaches the screen. 0 = single (direct blit; may tear on resize) 1 = double (one off-screen back buffer; frame lands atomically) 2 = triple (two back buffers; default for SLeeLa GUI setup) Programs can override this with setBuffering(mode).</td></tr>
<tr><td><code>buffering</code></td><td><span class="sig">int buffering()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setMinSize</code></td><td><span class="sig">int setMinSize(int width, int height)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setMaxSize</code></td><td><span class="sig">int setMaxSize(int width, int height)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setSizeLimits</code></td><td><span class="sig">int setSizeLimits(int minWidth, int minHeight, int maxWidth, int maxHeight)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>minWidth</code></td><td><span class="sig">int minWidth()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>minHeight</code></td><td><span class="sig">int minHeight()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>maxWidth</code></td><td><span class="sig">int maxWidth()</span></td><td class="desc">Maximum getters return 0 for unbounded and -1 when the window is invalid.</td></tr>
<tr><td><code>maxHeight</code></td><td><span class="sig">int maxHeight()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>assumeSize</code></td><td><span class="sig">int assumeSize(int assumedW, int assumedH)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configureAssumed</code></td><td><span class="sig">void configureAssumed(int app, String windowTitle, int assumedW, int assumedH,</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configureFullscreen</code></td><td><span class="sig">void configureFullscreen(int app, String windowTitle, int screenW, int screenH,</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>handle</code></td><td><span class="sig">int handle()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sociology">sociology <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/user-interface/example/science/sociology.sleela)</span></h2>
<div data-u="sociology sciencesociology">
<h3 id="ScienceSociology">ScienceSociology <span class="pill">class</span></h3>
<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>banner</code></td><td><span class="sig">void banner(String t)</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">void main()</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-13 18:08 UTC.
SleelaDoc — the SLeeLa documentation brand. SLeeLa — MEARVK LLC · Max Rupplin · UNCW, NCSU, Harvard · 2026 · George Soros 2507-2608.
</footer>
</main>
</div>
</body>
</html>