<< lib/gui/version-dual/SLGuiDom.sleela SLeeLa Standard Library Definition. Definition: 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: gui. SLeeLa owns the document and dispatch; the host mounts and paints it. >> #sleela 2.5 material; class SLGuiDom { < ---- Descriptive metadata (version 1.11 nested-friendly accessors) ---- > << Eleven catalogued attributes with getter/setter pairs, so a GUI, loader, or catalog can read and (where appropriate) override this record. Values are faithful to the subject's real origin where publicly known. >> String metaVersion = "1.0.0"; int metaId = 11190; String metaAuthor = "Kiro Agent"; String metaDate = "2026-10-16"; String metaCopyright = "SLeeLa project"; String metaTrademark = "none"; String metaCorporation = "none"; < metaOrigin: National | | International | Galactic > String metaOrigin = "International"; String metaBirthDate = "2026-10-16"; < metaScienceRating: maturity/robustness on a 1..10 scale > int metaScienceRating = 9; < metaNationalSchedule: a real, citable instrument or "none" > String metaNationalSchedule = "none"; String getMetaVersion() { return metaVersion; } void setMetaVersion(String v) { metaVersion = v; } int getMetaId() { return metaId; } void setMetaId(int v) { metaId = v; } String getAuthor() { return metaAuthor; } void setAuthor(String v) { metaAuthor = v; } String getDate() { return metaDate; } void setDate(String v) { metaDate = v; } String getCopyright() { return metaCopyright; } void setCopyright(String v) { metaCopyright = v; } String getTrademark() { return metaTrademark; } void setTrademark(String v) { metaTrademark = v; } String getCorporation() { return metaCorporation; } void setCorporation(String v) { metaCorporation = v; } String getOrigin() { return metaOrigin; } void setOrigin(String v) { metaOrigin = v; } String getBirthDate() { return metaBirthDate; } void setBirthDate(String v) { metaBirthDate = v; } int getScienceRating() { return metaScienceRating; } void setScienceRating(int v) { metaScienceRating = v; } String getNationalSchedule() { return metaNationalSchedule; } void setNationalSchedule(String v) { metaNationalSchedule = v; } static final int MAX_NODES = 65536; SLGuiNode[] nodes; int count; String rootId; SLGuiEventBus bus; < name<->ordinal helper > SLGuiEventType types; < auto-id counter for createElement without an id > int idSeq; void init() { nodes = new SLGuiNode[MAX_NODES]; count = 0; rootId = ""; bus = new SLGuiEventBus(); bus.init(); types = new SLGuiEventType(); idSeq = 0; } SLGuiEventBus events() { return bus; } int size() { return count; } < ---- creation / tree ---------------------------------------------------- > < createElement(tag, id): id "" generates a stable auto id ("n"). > SLGuiNode createElement(String tag, String id) { if (count >= MAX_NODES) { return null; } String nodeId = (id == null || id == "") ? autoId() : id; SLGuiNode n = new SLGuiNode(); n.configure(nodeId, tag, ""); nodes[count] = n; count = count + 1; return n; } < The document root (the window element). Created once. > SLGuiNode createRoot(String tag, String id) { SLGuiNode n = createElement(tag, id); if (n != null) { rootId = n.getId(); } return n; } SLGuiNode root() { return getElementById(rootId); } SLGuiNode getElementById(String id) { for (int i = 0; i < count; i = i + 1) { if (nodes[i].getId() == id) { return nodes[i]; } } return null; } int indexOfId(String id) { for (int i = 0; i < count; i = i + 1) { if (nodes[i].getId() == id) { return i; } } return -1; } < appendChild(parentId, childId): link child under parent in both directions. > boolean appendChild(String parentId, String childId) { SLGuiNode p = getElementById(parentId); SLGuiNode c = getElementById(childId); if (p == null || c == null) { return false; } c.setParent(parentId); return p.appendChild(childId); } < Convenience: create a child element already appended to a parent. > SLGuiNode appendElement(String parentId, String tag, String id) { SLGuiNode c = createElement(tag, id); if (c == null) { return null; } appendChild(parentId, c.getId()); return c; } < removeChild: detach from parent, remove its handlers, and drop the node > < (and recursively its subtree). > boolean removeChild(String childId) { SLGuiNode c = getElementById(childId); if (c == null) { return false; } SLGuiNode p = getElementById(c.getParent()); if (p != null) { p.removeChild(childId); } removeSubtree(childId); return true; } < ---- manipulation (id-addressed, DHTML-style) --------------------------- > void setText(String id, String text) { SLGuiNode n = getElementById(id); if (n != null) { n.setText(text); } } void setAttribute(String id, String name, String value) { SLGuiNode n = getElementById(id); if (n != null) { n.setAttribute(name, value); } } void setStyle(String id, String prop, String value) { SLGuiNode n = getElementById(id); if (n != null) { n.setStyle(prop, value); } } void show(String id) { SLGuiNode n = getElementById(id); if (n != null) { n.show(); } } void hide(String id) { SLGuiNode n = getElementById(id); if (n != null) { n.hide(); } } void setEnabled(String id, boolean on) { SLGuiNode n = getElementById(id); if (n != null) { n.setEnabled(on); } } < ---- queries ------------------------------------------------------------ > < Fill `out` with the ids of every node with the given tag; returns the count. > int getElementsByTag(String tag, String[] out, int cap) { int n = 0; for (int i = 0; i < count && n < cap; i = i + 1) { if (nodes[i].getTag() == tag) { out[n] = nodes[i].getId(); n = n + 1; } } return n; } < Return the first node id whose attribute `name` equals `value` (or null). > String querySelectorByAttr(String name, String value) { for (int i = 0; i < count; i = i + 1) { String got = nodes[i].getAttribute(name); if (got != null && got == value) { return nodes[i].getId(); } } return null; } < ---- events (addEventListener + onX shorthands) ------------------------- > SLGuiHandler addEventListener(String id, String eventName, String operation) { int t = types.typeOf(eventName); if (t < 0) { return null; } return bus.addListener(id, t, operation); } boolean removeEventListener(String id, String eventName, String operation) { int t = types.typeOf(eventName); if (t < 0) { return false; } return bus.removeListener(id, t, operation); } < Shorthands mirroring onclick=/oninput= style bindings. > SLGuiHandler onClick(String id, String operation) { return bus.addListener(id, SLGuiEventType.CLICK, operation); } SLGuiHandler onInput(String id, String operation) { return bus.addListener(id, SLGuiEventType.INPUT, operation); } SLGuiHandler onChange(String id, String operation) { return bus.addListener(id, SLGuiEventType.CHANGE, operation); } SLGuiHandler onKeyDown(String id, String operation) { return bus.addListener(id, SLGuiEventType.KEYDOWN, operation); } SLGuiHandler onSubmit(String id, String operation) { return bus.addListener(id, SLGuiEventType.SUBMIT, operation); } < The host raises an activation on a node; dispatch it through the bus. > < Returns how many handlers fired. > int dispatchEvent(SLGuiEvent event) { return bus.dispatch(event); } int fire(int eventType, String targetId, String value) { return bus.raise(eventType, targetId, value); } < ---- host sync ---------------------------------------------------------- > < The number of nodes needing a host re-sync (dirty), for the mount walk. > int dirtyCount() { int n = 0; for (int i = 0; i < count; i = i + 1) { if (nodes[i].isDirty()) { n = n + 1; } } return n; } SLGuiNode nodeAt(int i) { if (i < 0 || i >= count) { return null; } return nodes[i]; } < ---- internals ---------------------------------------------------------- > String autoId() { idSeq = idSeq + 1; return "n" + idSeq; } void removeSubtree(String id) { SLGuiNode n = getElementById(id); if (n == null) { return; } for (int i = 0; i < n.children(); i = i + 1) { removeSubtree(n.childAt(i)); } bus.removeTarget(id); removeNode(id); } void removeNode(String id) { int idx = indexOfId(id); if (idx < 0) { return; } for (int i = idx; i < count - 1; i = i + 1) { nodes[i] = nodes[i + 1]; } count = count - 1; nodes[count] = null; } }