<< lib/ui/SLComponentQuality.sleela SLeeLa Standard Library Definition. Definition: SLComponentQuality — the per-COMPONENT QUALITY descriptor that completes the standard layout model. A layout already gives every component its exact SIZE and pixel-perfect PLACEMENT (SLLayoutBox: x/y/w/h); this class gives every component its intended QUALITY: which theme role it reads as, how strongly it is emphasised, and whether it is currently interactive. So a component is fully described by QUALITY + SIZE + PLACEMENT. Quality is expressed in the vocabulary the standard themes already define (SLStandardTheme's role tokens), so it maps cleanly to a flavor (blue / gray / black / white) and to what the native toolkit can honor per widget: - ROLE : which surface/text the renderer draws the component as -- BODY (default content), SURFACE (a raised panel), CHROME (title/menu bar), or ACCENT (the one interactive accent). - EMPHASIS: NORMAL, PRIMARY (the single suggested action -> the toolkit's uiWidgetSuggested), or DANGER (destructive -> uiWidgetDestructive). - interactive: whether the component is enabled (sensitive) right now (-> uiWidgetSensitive). - visible : whether the component is shown or hidden right now (-> uiWidgetVisible). A hidden component takes no space. - margin : per-edge breathing room around the component in px (-> uiWidgetMargin). - icon : an optional leading symbol/asset for the component (-> uiWidgetSetIcon). Pure SLeeLa (no native handle); it always checks and runs. The native realizer (SLLayoutDriver) reads a component's quality and applies every part the toolkit can honor per widget (emphasis, sensitivity, visibility, margin, icon); the role is a hint the themed renderer uses when it draws the surface. Each new axis maps 1:1 to a real ui* bridge call, so the count of quality aspects the standard model can faithfully deliver grows without inventing any capability the native toolkit lacks. >> #sleela 2.5 material; < Family: ui. Per-component quality: role + emphasis + interactivity. > class SLComponentQuality { < ---- Descriptive metadata (version 1.11 nested-friendly accessors) ---- > << Eleven catalogued attributes with getter/setter pairs. >> String metaVersion = "1.0.0"; int metaId = 11609; String metaAuthor = "Kiro Agent"; String metaDate = "2026-10-25"; String metaCopyright = "SLeeLa project"; String metaTrademark = "none"; String metaCorporation = "none"; < metaOrigin: National | | International | Galactic > String metaOrigin = "International"; String metaBirthDate = "2026-10-25"; < metaScienceRating: maturity/robustness on a 1..10 scale > int metaScienceRating = 8; < 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; } < ROLE: which theme surface/text the component reads as. > static final int ROLE_BODY = 0; static final int ROLE_SURFACE = 1; static final int ROLE_CHROME = 2; static final int ROLE_ACCENT = 3; < EMPHASIS: normal, the single primary action, or a destructive action. > static final int EMPHASIS_NORMAL = 0; static final int EMPHASIS_PRIMARY = 1; static final int EMPHASIS_DANGER = 2; int role; int emphasis; < 1 = enabled/interactive, 0 = disabled (greyed out) > int interactive; < 1 = shown, 0 = hidden. A hidden component takes no space and is not drawn. > int visible; < Margin (breathing room) around the component, in px, per edge. > int marginTop; int marginRight; int marginBottom; int marginLeft; < Optional leading icon: a named theme symbol (e.g. "save", "trash") and/or an > < asset path. Empty strings mean "no icon". > String iconSymbol; String iconAsset; < Default quality: body role, no emphasis, interactive, shown, no margin, > < no icon. > void create() { role = ROLE_BODY; emphasis = EMPHASIS_NORMAL; interactive = 1; visible = 1; marginTop = 0; marginRight = 0; marginBottom = 0; marginLeft = 0; iconSymbol = ""; iconAsset = ""; } < ---- role (fluent one-call setters, beginner-friendly) ------------------ > void asBody() { role = ROLE_BODY; } void asSurface() { role = ROLE_SURFACE; } void asChrome() { role = ROLE_CHROME; } void asAccent() { role = ROLE_ACCENT; } void setRole(int r) { if (r >= ROLE_BODY && r <= ROLE_ACCENT) { role = r; } } int getRole() { return role; } < ---- emphasis ----------------------------------------------------------- > void normal() { emphasis = EMPHASIS_NORMAL; } void primary() { emphasis = EMPHASIS_PRIMARY; } void danger() { emphasis = EMPHASIS_DANGER; } void setEmphasis(int e) { if (e >= EMPHASIS_NORMAL && e <= EMPHASIS_DANGER) { emphasis = e; } } int getEmphasis() { return emphasis; } boolean isPrimary() { return emphasis == EMPHASIS_PRIMARY; } boolean isDanger() { return emphasis == EMPHASIS_DANGER; } < ---- interactivity ------------------------------------------------------ > void enable() { interactive = 1; } void disable() { interactive = 0; } void setInteractive(boolean on) { interactive = on ? 1 : 0; } boolean isInteractive() { return interactive == 1; } < ---- visibility --------------------------------------------------------- > < A hidden component is not drawn and (in a stack) collapses to take no space; > < the native realizer honors it with uiWidgetVisible. > void show() { visible = 1; } void hide() { visible = 0; } void setVisible(boolean on) { visible = on ? 1 : 0; } boolean isVisible() { return visible == 1; } < ---- margin (breathing room around the component, per edge, in px) ------ > < Uniform margin on all four edges. > void margin(int px) { int m = (px < 0) ? 0 : px; marginTop = m; marginRight = m; marginBottom = m; marginLeft = m; } < Independent per-edge margins (negatives clamped to 0). > void setMargins(int top, int right, int bottom, int left) { marginTop = (top < 0) ? 0 : top; marginRight = (right < 0) ? 0 : right; marginBottom = (bottom < 0) ? 0 : bottom; marginLeft = (left < 0) ? 0 : left; } int getMarginTop() { return marginTop; } int getMarginRight() { return marginRight; } int getMarginBottom() { return marginBottom; } int getMarginLeft() { return marginLeft; } < True when any edge has a non-zero margin. > boolean hasMargin() { return marginTop > 0 || marginRight > 0 || marginBottom > 0 || marginLeft > 0; } < ---- icon (optional leading symbol / asset) ----------------------------- > < Set a named theme symbol (e.g. "save", "trash", "search"). > void icon(String symbol) { iconSymbol = (symbol == null) ? "" : symbol; } < Set an asset-path icon (e.g. a file the host loads). > void iconFromAsset(String assetPath) { iconAsset = (assetPath == null) ? "" : assetPath; } < Clear any icon. > void clearIcon() { iconSymbol = ""; iconAsset = ""; } String getIconSymbol() { return iconSymbol; } String getIconAsset() { return iconAsset; } < True when a symbol or asset icon has been set. > boolean hasIcon() { return (iconSymbol != null && iconSymbol != "") || (iconAsset != null && iconAsset != ""); } < The role name, in the theme's own vocabulary. > String roleName() { if (role == ROLE_SURFACE) { return "surface"; } if (role == ROLE_CHROME) { return "chrome"; } if (role == ROLE_ACCENT) { return "accent"; } return "body"; } < The emphasis name. > String emphasisName() { if (emphasis == EMPHASIS_PRIMARY) { return "primary"; } if (emphasis == EMPHASIS_DANGER) { return "danger"; } return "normal"; } < A one-line account of the quality, for logs/inspection. > String describe() { String s = "quality:" + roleName() + "/" + emphasisName() + (interactive == 1 ? "/enabled" : "/disabled") + (visible == 1 ? "/shown" : "/hidden"); if (hasMargin()) { s = s + "/margin[" + marginTop + "," + marginRight + "," + marginBottom + "," + marginLeft + "]"; } if (hasIcon()) { s = s + "/icon(" + (iconSymbol != "" ? iconSymbol : iconAsset) + ")"; } return s; } boolean honored() { return role >= ROLE_BODY && role <= ROLE_ACCENT && emphasis >= EMPHASIS_NORMAL && emphasis <= EMPHASIS_DANGER && (interactive == 0 || interactive == 1) && (visible == 0 || visible == 1) && marginTop >= 0 && marginRight >= 0 && marginBottom >= 0 && marginLeft >= 0 && iconSymbol != null && iconAsset != null; } }