Home /Modules/api/observer.html

observer.html

api/sleela/3.1/version-004/package/observer.html · 523 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 observer — SleelaDoc API</title>
<link rel="stylesheet" href="../style.css">

</head>
<body>
<header class="top">
  <div class="brand"><a href="../index.html">SleelaDoc API</a></div>
  <div class="tag">HTML documentation for the SLeeLa standard library (/lib)</div>
</header>
<div class="wrap">
<nav class="side">
  <a href="../index.html"><strong>Home</strong></a>
  <a href="../packages.html"><strong>All packages</strong></a>
  <a href="../glossary.html"><strong>Glossary</strong></a>
  <a href="../authorship.html"><strong>Authorship</strong></a>
  <h2>Packages</h2><ul>
<li><a href="../package/advantage.html">advantage</a></li>
<li><a href="../package/alphabet.html">alphabet</a></li>
<li><a href="../package/antivirus.html">antivirus</a></li>
<li><a href="../package/api.html">api</a></li>
<li><a href="../package/array.html">array</a></li>
<li><a href="../package/audio.html">audio</a></li>
<li><a href="../package/autocad.html">autocad</a></li>
<li><a href="../package/ballum.html">ballum</a></li>
<li><a href="../package/bash.html">bash</a></li>
<li><a href="../package/boolean.html">boolean</a></li>
<li><a href="../package/cdma.html">cdma</a></li>
<li><a href="../package/char.html">char</a></li>
<li><a href="../package/character.html">character</a></li>
<li><a href="../package/character-recognition.html">character-recognition</a></li>
<li><a href="../package/churn.html">churn</a></li>
<li><a href="../package/citizen.html">citizen</a></li>
<li><a href="../package/codecs.html">codecs</a></li>
<li><a href="../package/collections.html">collections</a></li>
<li><a href="../package/common-rails.html">common-rails</a></li>
<li><a href="../package/compiler.html">compiler</a></li>
<li><a href="../package/compression.html">compression</a></li>
<li><a href="../package/config.html">config</a></li>
<li><a href="../package/connector.html">connector</a></li>
<li><a href="../package/coorenagraph.html">coorenagraph</a></li>
<li><a href="../package/core.html">core</a></li>
<li><a href="../package/cpu.html">cpu</a></li>
<li><a href="../package/crypto.html">crypto</a></li>
<li><a href="../package/data.html">data</a></li>
<li><a href="../package/data-structures.html">data-structures</a></li>
<li><a href="../package/database.html">database</a></li>
<li><a href="../package/debugger.html">debugger</a></li>
<li><a href="../package/decompiler.html">decompiler</a></li>
<li><a href="../package/deliberation.html">deliberation</a></li>
<li><a href="../package/drivers.html">drivers</a></li>
<li><a href="../package/examples.html">examples</a></li>
<li><a href="../package/filesystem.html">filesystem</a></li>
<li><a href="../package/gameplay.html">gameplay</a></li>
<li><a href="../package/governance.html">governance</a></li>
<li><a href="../package/gui.html">gui</a></li>
<li><a href="../package/guidoc.html">guidoc</a></li>
<li><a href="../package/hotlink.html">hotlink</a></li>
<li><a href="../package/html.html">html</a></li>
<li><a href="../package/http.html">http</a></li>
<li><a href="../package/http-1.0.html">http-1.0</a></li>
<li><a href="../package/http-2.0.html">http-2.0</a></li>
<li><a href="../package/http-3.0.html">http-3.0</a></li>
<li><a href="../package/http-4.0.html">http-4.0</a></li>
<li><a href="../package/http-5.0.html">http-5.0</a></li>
<li><a href="../package/http-6.0.html">http-6.0</a></li>
<li><a href="../package/http-7.0.html">http-7.0</a></li>
<li><a href="../package/http-8.0.html">http-8.0</a></li>
<li><a href="../package/http-9.0.html">http-9.0</a></li>
<li><a href="../package/http-servers.html">http-servers</a></li>
<li><a href="../package/ide.html">ide</a></li>
<li><a href="../package/ide-workbench.html">ide-workbench</a></li>
<li><a href="../package/idea.html">idea</a></li>
<li><a href="../package/inference-model.html">inference-model</a></li>
<li><a href="../package/inputs.html">inputs</a></li>
<li><a href="../package/international-criminal-court.html">international-criminal-court</a></li>
<li><a href="../package/io.html">io</a></li>
<li><a href="../package/java.html">java</a></li>
<li><a href="../package/java28.html">java28</a></li>
<li><a href="../package/journey.html">journey</a></li>
<li><a href="../package/languages.html">languages</a></li>
<li><a href="../package/large-language-models.html">large-language-models</a></li>
<li><a href="../package/ledger.html">ledger</a></li>
<li><a href="../package/linux-editors.html">linux-editors</a></li>
<li><a href="../package/manifesto.html">manifesto</a></li>
<li><a href="../package/math.html">math</a></li>
<li><a href="../package/memory.html">memory</a></li>
<li><a href="../package/modules.html">modules</a></li>
<li><a href="../package/moral-capacitor.html">moral-capacitor</a></li>
<li><a href="../package/munction.html">munction</a></li>
<li><a href="../package/native.html">native</a></li>
<li><a href="../package/net.html">net</a></li>
<li><a href="../package/neural-nets.html">neural-nets</a></li>
<li><a href="../package/nordshrift.html">nordshrift</a></li>
<li><a href="../package/observer.html">observer</a></li>
<li><a href="../package/opcodes.html">opcodes</a></li>
<li><a href="../package/operating-system.html">operating-system</a></li>
<li><a href="../package/os-level-support.html">os-level-support</a></li>
<li><a href="../package/philosophers.html">philosophers</a></li>
<li><a href="../package/philosophy.html">philosophy</a></li>
<li><a href="../package/politico.html">politico</a></li>
<li><a href="../package/process.html">process</a></li>
<li><a href="../package/psychiatry.html">psychiatry</a></li>
<li><a href="../package/public.html">public</a></li>
<li><a href="../package/reflection.html">reflection</a></li>
<li><a href="../package/regex.html">regex</a></li>
<li><a href="../package/registry.html">registry</a></li>
<li><a href="../package/rmi.html">rmi</a></li>
<li><a href="../package/rrs.html">rrs</a></li>
<li><a href="../package/runtime.html">runtime</a></li>
<li><a href="../package/security.html">security</a></li>
<li><a href="../package/server-edition.html">server-edition</a></li>
<li><a href="../package/signal-processing.html">signal-processing</a></li>
<li><a href="../package/sldocument.html">sldocument</a></li>
<li><a href="../package/sleela.html">sleela</a></li>
<li><a href="../package/sleela-sql.html">sleela-sql</a></li>
<li><a href="../package/sleela-terminal.html">sleela-terminal</a></li>
<li><a href="../package/sleeladoc.html">sleeladoc</a></li>
<li><a href="../package/slrtp.html">slrtp</a></li>
<li><a href="../package/social-model.html">social-model</a></li>
<li><a href="../package/softlisten.html">softlisten</a></li>
<li><a href="../package/sommeliers.html">sommeliers</a></li>
<li><a href="../package/spatial.html">spatial</a></li>
<li><a href="../package/sst.html">sst</a></li>
<li><a href="../package/synchro.html">synchro</a></li>
<li><a href="../package/systems.html">systems</a></li>
<li><a href="../package/telephony-skya.html">telephony-skya</a></li>
<li><a href="../package/terminal.html">terminal</a></li>
<li><a href="../package/terminal_pixel.html">terminal_pixel</a></li>
<li><a href="../package/text.html">text</a></li>
<li><a href="../package/ui.html">ui</a></li>
<li><a href="../package/us-infrastructure.html">us-infrastructure</a></li>
<li><a href="../package/user-interface.html">user-interface</a></li>
<li><a href="../package/video.html">video</a></li>
<li><a href="../package/vm.html">vm</a></li>
<li><a href="../package/web-server-technology.html">web-server-technology</a></li>
<li><a href="../package/website.html">website</a></li>
<li><a href="../package/wifi.html">wifi</a></li>
<li><a href="../package/xlt.html">xlt</a></li>
<li><a href="../package/xml.html">xml</a></li>
</ul>
</nav>
<main>
<div class="crumbs"><a href="../index.html">Home</a> &rsaquo; <a href="../packages.html">Packages</a> &rsaquo; observer</div>
<h1>Package <code>observer</code></h1>
<div class="lead">This package contains <strong>10</strong> source unit(s) defining <strong>16</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="observer-demo">observer-demo <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/observer/observer-demo.sleela)</span></h2>
<div data-u="observer-demo observerdemo">
<h3 id="ObserverDemo">ObserverDemo <span class="pill">class</span></h3>
<p class="desc">Runnable, self-checking demonstrator for the dynamic document observer (lib/observer). It starts a standing document, then drops modules in (as nested classes) while the program is running, and verifies the safety envelope: proposals not mutations, optimistic concurrency, the proposal depth cap, hop-limited conversations, fault quarantine, sender stamping, admission refusals, and the cycle cap. Prints PASS/FAIL per check and a final tally.</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>
</div>
<div data-u="observer-demo stubborn">
<h3 id="Stubborn">Stubborn <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>port</code></td><td><span class="sig">SLObserverPort port</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tried</code></td><td><span class="sig">int tried</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>attach</code></td><td><span class="sig">void attach(String portName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>portOf</code></td><td><span class="sig">SLObserverPort portOf()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pump</code></td><td><span class="sig">int pump()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<div data-u="observer-demo faulty">
<h3 id="Faulty">Faulty <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>port</code></td><td><span class="sig">SLObserverPort port</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>attach</code></td><td><span class="sig">void attach(String portName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>portOf</code></td><td><span class="sig">SLObserverPort portOf()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pump</code></td><td><span class="sig">int pump()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="observer-gui-demo">observer-gui-demo <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/observer/observer-gui-demo.sleela)</span></h2>
<div data-u="observer-gui-demo observerguidemo">
<h3 id="ObserverGuiDemo">ObserverGuiDemo <span class="pill">class</span></h3>
<p class="desc">Runnable GUI demonstrator for the dynamic document observer. It drives SLObserverView, a retained widget tree, with scripted button clicks (append, replace, drop in a module, quit) and prints the rendered nodes, so the behavior is checkable without a display. The same view can be mounted on real widgets by any host.</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>doc</code></td><td><span class="sig">SLObserverDocument doc</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>obs</code></td><td><span class="sig">SLDocumentObserver obs</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>view</code></td><td><span class="sig">SLObserverView view</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dropStage</code></td><td><span class="sig">int dropStage</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>edits</code></td><td><span class="sig">int edits</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>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>pumpAll</code></td><td><span class="sig">void pumpAll()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>settle</code></td><td><span class="sig">int settle()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setup</code></td><td><span class="sig">void setup()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dropInNext</code></td><td><span class="sig">void dropInNext()</span></td><td class="desc">Each press of Drop in module admits the next module, mid-run.</td></tr>
<tr><td><code>act</code></td><td><span class="sig">boolean act(int action)</span></td><td class="desc">Turn one view action into the matching observer operation.</td></tr>
<tr><td><code>dump</code></td><td><span class="sig">void dump()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>scripted</code></td><td><span class="sig">void scripted()</span></td><td class="desc">Scripted clicks on a bare DOM through the view.</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="sldocumentobserver">SLDocumentObserver <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/observer/SLDocumentObserver.sleela)</span></h2>
<div data-u="sldocumentobserver sldocumentobserver">
<h3 id="SLDocumentObserver">SLDocumentObserver <span class="pill">class</span></h3>
<p class="desc">Defines SLDocumentObserver — a dynamic document observer. Modules are admitted through bounded ports WHILE THE PROGRAM IS RUNNING; when the standing document changes every active module is told, and may answer, converse with the others, or PROPOSE an edit. The observer is the only writer of the document, and it applies a proposal only if it is based on the current revision, within the per-cycle and depth budgets, and accepted by the document. Hop limits bound conversations, repeated faults quarantine a module, and everything is written to a bounded audit trail. Drive it as a cycle: edit(...) delivers the change; then while beginCycle() is true, pump every module, then endCycle() routes what they said. beginCycle() is false when nobody has mail or the cycle cap is hit.</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_PORTS</code></td><td><span class="sig">int MAX_PORTS = 14</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MAX_HOPS</code></td><td><span class="sig">int MAX_HOPS = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MAX_CYCLES</code></td><td><span class="sig">int MAX_CYCLES = 16</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MAX_PROPOSALS</code></td><td><span class="sig">int MAX_PROPOSALS = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MAX_DEPTH</code></td><td><span class="sig">int MAX_DEPTH = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MAX_FAULTS</code></td><td><span class="sig">int MAX_FAULTS = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MAX_TRAIL</code></td><td><span class="sig">int MAX_TRAIL = 64</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>doc</code></td><td><span class="sig">SLObserverDocument doc</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ports</code></td><td><span class="sig">SLObserverPort[] ports</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>portCount</code></td><td><span class="sig">int portCount</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">int busy</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cycles</code></td><td><span class="sig">int cycles</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>proposals</code></td><td><span class="sig">int proposals</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">int depth</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>applied</code></td><td><span class="sig">int applied</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>declined</code></td><td><span class="sig">int declined</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dropped</code></td><td><span class="sig">int dropped</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>quarantined</code></td><td><span class="sig">int quarantined</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>delivered</code></td><td><span class="sig">int delivered</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>frozen</code></td><td><span class="sig">int frozen</span></td><td class="desc">1 while frozen: no content may be added by edit() or by a proposal</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>
<tr><td><code>trailCount</code></td><td><span class="sig">int trailCount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>trailLost</code></td><td><span class="sig">int trailLost</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<div data-u="sldocumentobserver auditor">
<h3 id="Auditor">Auditor <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>port</code></td><td><span class="sig">SLObserverPort port</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>changes</code></td><td><span class="sig">int changes</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>questions</code></td><td><span class="sig">int questions</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>attach</code></td><td><span class="sig">void attach(String portName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>portOf</code></td><td><span class="sig">SLObserverPort portOf()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>changeCount</code></td><td><span class="sig">int changeCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pump</code></td><td><span class="sig">int pump()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slobserverdocument">SLObserverDocument <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/observer/SLObserverDocument.sleela)</span></h2>
<div data-u="slobserverdocument slobserverdocument">
<h3 id="SLObserverDocument">SLObserverDocument <span class="pill">class</span></h3>
<p class="desc">Defines SLObserverDocument — the standing document a dynamic observer watches: up to 64 text lines and a revision counter that moves by exactly one on every accepted edit. Every edit is validated first and a refused edit changes nothing (fail closed).</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">int MAX_LINES = 64</span></td><td class="desc"><span class="muted">No description in source.</span></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>lines</code></td><td><span class="sig">String[] lines</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>revision</code></td><td><span class="sig">int revision</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lastOp</code></td><td><span class="sig">int lastOp</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lastLine</code></td><td><span class="sig">int lastLine</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lastOld</code></td><td><span class="sig">String lastOld</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lastNew</code></td><td><span class="sig">String lastNew</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 docTitle)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getTitle</code></td><td><span class="sig">String getTitle()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>revisionNow</code></td><td><span class="sig">int revisionNow()</span></td><td class="desc"><span class="muted">No description in source.</span></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>capacity</code></td><td><span class="sig">int capacity()</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>getLastOp</code></td><td><span class="sig">int getLastOp()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getLastLine</code></td><td><span class="sig">int getLastLine()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getLastOld</code></td><td><span class="sig">String getLastOld()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getLastNew</code></td><td><span class="sig">String getLastNew()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>restore</code></td><td><span class="sig">boolean restore(String[] saved, int savedCount, int savedRevision)</span></td><td class="desc">Put back a saved state exactly: the lines, their count and the revision counter. Used by a host that rolls a session back (it bypasses the observer, so the host must tell its own listeners). Refused when the saved state does not fit.</td></tr>
<tr><td><code>canApply</code></td><td><span class="sig">boolean canApply(int op, int line)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>apply</code></td><td><span class="sig">int apply(int op, int line, String text)</span></td><td class="desc">Apply one edit. Returns the new revision, or -1 with NO change made.</td></tr>
</table>
</div>
<h2 class="section" data-u="slobserverguardmodule">SLObserverGuardModule <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/observer/SLObserverGuardModule.sleela)</span></h2>
<div data-u="slobserverguardmodule slobserverguardmodule">
<h3 id="SLObserverGuardModule">SLObserverGuardModule <span class="pill">class</span></h3>
<p class="desc">A drop-in module for the dynamic document observer. The nested class SLObserverGuardModule.Responder watches for a forbidden line (exact match) and PROPOSES replacing it with a redaction marker. It never edits the document itself: the observer decides, and tells the guard the result.</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>
</div>
<div data-u="slobserverguardmodule responder">
<h3 id="Responder">Responder <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>port</code></td><td><span class="sig">SLObserverPort port</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>forbidden</code></td><td><span class="sig">String forbidden</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>redactions</code></td><td><span class="sig">int redactions</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>declinedCount</code></td><td><span class="sig">int declinedCount</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>attach</code></td><td><span class="sig">void attach(String portName, String forbiddenLine)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>portOf</code></td><td><span class="sig">SLObserverPort portOf()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>redactionCount</code></td><td><span class="sig">int redactionCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>declinedTotal</code></td><td><span class="sig">int declinedTotal()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pump</code></td><td><span class="sig">int pump()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slobservermessage">SLObserverMessage <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/observer/SLObserverMessage.sleela)</span></h2>
<div data-u="slobservermessage slobservermessage">
<h3 id="SLObserverMessage">SLObserverMessage <span class="pill">class</span></h3>
<p class="desc">Defines SLObserverMessage — the one envelope the dynamic document observer and its modules speak. A message is a NOTE, QUESTION, ANSWER, PROPOSE, FAULT, or CHANGE; CHANGE is what the observer sends when the standing document moves, and the rest are how modules converse with the observer and with each other. The observer stamps the sender on routing so a module cannot impersonate another.</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>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>op</code></td><td><span class="sig">int op</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>from</code></td><td><span class="sig">String from</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>to</code></td><td><span class="sig">String to</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">String text</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>extra</code></td><td><span class="sig">String extra</span></td><td class="desc">CHANGE: the previous text of the line; otherwise free-form</td></tr>
<tr><td><code>tag</code></td><td><span class="sig">String tag</span></td><td class="desc">who caused a CHANGE (host, a module name)</td></tr>
<tr><td><code>line</code></td><td><span class="sig">int line</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>revision</code></td><td><span class="sig">int revision</span></td><td class="desc">CHANGE: the new revision. PROPOSE: the revision the proposal is based on</td></tr>
<tr><td><code>hops</code></td><td><span class="sig">int hops</span></td><td class="desc">conversation depth; the observer bounds it</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 k, String f, String t, String body)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getKind</code></td><td><span class="sig">int getKind()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getOp</code></td><td><span class="sig">int getOp()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setOp</code></td><td><span class="sig">void setOp(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getFrom</code></td><td><span class="sig">String getFrom()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setFrom</code></td><td><span class="sig">void setFrom(String v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getTo</code></td><td><span class="sig">String getTo()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getText</code></td><td><span class="sig">String getText()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getExtra</code></td><td><span class="sig">String getExtra()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setExtra</code></td><td><span class="sig">void setExtra(String v)</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>setTag</code></td><td><span class="sig">void setTag(String v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getLine</code></td><td><span class="sig">int getLine()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setLine</code></td><td><span class="sig">void setLine(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getRevision</code></td><td><span class="sig">int getRevision()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setRevision</code></td><td><span class="sig">void setRevision(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getHops</code></td><td><span class="sig">int getHops()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setHops</code></td><td><span class="sig">void setHops(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slobserverport">SLObserverPort <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/observer/SLObserverPort.sleela)</span></h2>
<div data-u="slobserverport slobserverport">
<h3 id="SLObserverPort">SLObserverPort <span class="pill">class</span></h3>
<p class="desc">Defines SLObserverPort — the bounded mailbox a module is admitted through. The observer delivers into the inbox and collects from the outbox; the module only ever reads its own inbox and writes its own outbox, so a misbehaving module can hurt nothing but itself (full inbox drops, outbox overflow and reported faults count toward quarantine).</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_IN</code></td><td><span class="sig">int MAX_IN = 16</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MAX_OUT</code></td><td><span class="sig">int MAX_OUT = 8</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>state</code></td><td><span class="sig">int state</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>faults</code></td><td><span class="sig">int faults</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lastFault</code></td><td><span class="sig">String lastFault</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>inbox</code></td><td><span class="sig">SLObserverMessage[] inbox</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>inCount</code></td><td><span class="sig">int inCount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>outbox</code></td><td><span class="sig">SLObserverMessage[] outbox</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>outCount</code></td><td><span class="sig">int outCount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>received</code></td><td><span class="sig">int received</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>sent</code></td><td><span class="sig">int sent</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dropped</code></td><td><span class="sig">int dropped</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wantInsert</code></td><td><span class="sig">int wantInsert</span></td><td class="desc">what this listener wants: which edit ops, and which line range</td></tr>
<tr><td><code>wantReplace</code></td><td><span class="sig">int wantReplace</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wantDelete</code></td><td><span class="sig">int wantDelete</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lineFirst</code></td><td><span class="sig">int lineFirst</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lineLast</code></td><td><span class="sig">int lineLast</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>missed</code></td><td><span class="sig">int missed</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>filtered</code></td><td><span class="sig">int filtered</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 portName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getName</code></td><td><span class="sig">String getName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getState</code></td><td><span class="sig">int getState()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setState</code></td><td><span class="sig">void setState(int s)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isActive</code></td><td><span class="sig">boolean isActive()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isPaused</code></td><td><span class="sig">boolean isPaused()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>missedCount</code></td><td><span class="sig">int missedCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>filteredCount</code></td><td><span class="sig">int filteredCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>noteMissed</code></td><td><span class="sig">void noteMissed()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>noteFiltered</code></td><td><span class="sig">void noteFiltered()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clearMissed</code></td><td><span class="sig">void clearMissed()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clearFaults</code></td><td><span class="sig">void clearFaults()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setWant</code></td><td><span class="sig">void setWant(int ins, int rep, int del, int first, int last)</span></td><td class="desc">Set what this listener wants. Both line bounds -1 means every line.</td></tr>
<tr><td><code>wantsChange</code></td><td><span class="sig">boolean wantsChange(SLObserverMessage m)</span></td><td class="desc">Does this listener want a CHANGE message? Other kinds always pass.</td></tr>
<tr><td><code>faultCount</code></td><td><span class="sig">int faultCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>faultText</code></td><td><span class="sig">String faultText()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fault</code></td><td><span class="sig">void fault(String why)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>receivedCount</code></td><td><span class="sig">int receivedCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>sentCount</code></td><td><span class="sig">int sentCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>droppedCount</code></td><td><span class="sig">int droppedCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>deliver</code></td><td><span class="sig">boolean deliver(SLObserverMessage m)</span></td><td class="desc">Deliver into the inbox. A closed port or a full inbox drops, never blocks.</td></tr>
<tr><td><code>takeOut</code></td><td><span class="sig">SLObserverMessage takeOut()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>outPending</code></td><td><span class="sig">int outPending()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasMail</code></td><td><span class="sig">boolean hasMail()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>mailCount</code></td><td><span class="sig">int mailCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>next</code></td><td><span class="sig">SLObserverMessage next()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>say</code></td><td><span class="sig">boolean say(SLObserverMessage m)</span></td><td class="desc">Queue an outbound message. An overflowing outbox counts as a fault.</td></tr>
<tr><td><code>note</code></td><td><span class="sig">boolean note(String to, String body)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ask</code></td><td><span class="sig">boolean ask(String to, String body)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>reply</code></td><td><span class="sig">boolean reply(SLObserverMessage original, String body)</span></td><td class="desc">Answer a received message: addressed to its sender, same conversation depth.</td></tr>
<tr><td><code>propose</code></td><td><span class="sig">boolean propose(int op, int line, String body, int baseRevision)</span></td><td class="desc">Ask the observer to edit the document (op 0 insert, 1 replace, 2 delete). The edit is only applied if baseRevision is still current.</td></tr>
<tr><td><code>reportFault</code></td><td><span class="sig">boolean reportFault(String why)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slobserverreviewmodule">SLObserverReviewModule <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/observer/SLObserverReviewModule.sleela)</span></h2>
<div data-u="slobserverreviewmodule slobserverreviewmodule">
<h3 id="SLObserverReviewModule">SLObserverReviewModule <span class="pill">class</span></h3>
<p class="desc">A drop-in module for the dynamic document observer. The nested class SLObserverReviewModule.Responder opens a conversation when admitted: it asks the auditor for its change count and keeps asking while answers come back (up to a fixed number of questions). The observer hop limit is what finally ends the conversation.</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>
</div>
<div data-u="slobserverreviewmodule responder">
<h3 id="Responder">Responder <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>port</code></td><td><span class="sig">SLObserverPort port</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>peer</code></td><td><span class="sig">String peer</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>asked</code></td><td><span class="sig">int asked</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>answered</code></td><td><span class="sig">int answered</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>maxAsks</code></td><td><span class="sig">int maxAsks</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lastAnswer</code></td><td><span class="sig">String lastAnswer</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>attach</code></td><td><span class="sig">void attach(String portName, String peerName, int limit)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>portOf</code></td><td><span class="sig">SLObserverPort portOf()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>askedCount</code></td><td><span class="sig">int askedCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>answeredCount</code></td><td><span class="sig">int answeredCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>latestAnswer</code></td><td><span class="sig">String latestAnswer()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pump</code></td><td><span class="sig">int pump()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slobserversummarymodule">SLObserverSummaryModule <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/observer/SLObserverSummaryModule.sleela)</span></h2>
<div data-u="slobserversummarymodule slobserversummarymodule">
<h3 id="SLObserverSummaryModule">SLObserverSummaryModule <span class="pill">class</span></h3>
<p class="desc">A drop-in module for the dynamic document observer. The nested class SLObserverSummaryModule.Responder tracks the latest revision, line count and edit mix, and answers the question &quot;summary?&quot;.</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>
</div>
<div data-u="slobserversummarymodule responder">
<h3 id="Responder">Responder <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>port</code></td><td><span class="sig">SLObserverPort port</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lastRevision</code></td><td><span class="sig">int lastRevision</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">int lines</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>inserts</code></td><td><span class="sig">int inserts</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>replaces</code></td><td><span class="sig">int replaces</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>deletes</code></td><td><span class="sig">int deletes</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>attach</code></td><td><span class="sig">void attach(String portName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>portOf</code></td><td><span class="sig">SLObserverPort portOf()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>latestRevision</code></td><td><span class="sig">int latestRevision()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>summary</code></td><td><span class="sig">String summary()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pump</code></td><td><span class="sig">int pump()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slobserverview">SLObserverView <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/observer/SLObserverView.sleela)</span></h2>
<div data-u="slobserverview slobserverview">
<h3 id="SLObserverView">SLObserverView <span class="pill">class</span></h3>
<p class="desc">Defines SLObserverView — the modest GUI for the dynamic document observer. It is a small retained widget tree (labels, an entry, buttons) that mirrors the standing document, the module roster and the audit trail, and turns button presses into latched actions the host loop services with the same take-the-latch discipline as the gui package. It is self-contained on purpose: a host walks nodeCount()/tagAt()/textAt() to mount it on real widgets and calls press(id) when a button is activated.</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">int MAX_NODES = 48</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>observer</code></td><td><span class="sig">SLDocumentObserver observer</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"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tags</code></td><td><span class="sig">String[] tags</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>texts</code></td><td><span class="sig">String[] texts</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">String[] parents</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>latch</code></td><td><span class="sig">int[] latch</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>
</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(SLDocumentObserver o)</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>idAt</code></td><td><span class="sig">String idAt(int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tagAt</code></td><td><span class="sig">String tagAt(int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>textAt</code></td><td><span class="sig">String textAt(int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>parentAt</code></td><td><span class="sig">String parentAt(int i)</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>add</code></td><td><span class="sig">boolean add(String parent, String tag, String id)</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 id, String t)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>textOf</code></td><td><span class="sig">String textOf(String id)</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">void type(String t)</span></td><td class="desc">A host reports the user typed into the entry, or activated a button.</td></tr>
<tr><td><code>press</code></td><td><span class="sig">boolean press(String id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>taken</code></td><td><span class="sig">boolean taken(String id)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>build</code></td><td><span class="sig">void build()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>entryText</code></td><td><span class="sig">String entryText()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clearEntry</code></td><td><span class="sig">void clearEntry()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>stateName</code></td><td><span class="sig">String stateName(int s)</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">Mirror observer state into the nodes.</td></tr>
<tr><td><code>service</code></td><td><span class="sig">int service()</span></td><td class="desc">Take one latched press: returns the action code, or 0 when idle.</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>