<< lib/gui/version-military/SLGuiToast.sleela SLeeLa Standard Library Definition. Definition: Defines SLGuiToast — the TOAST / SNACKBAR component: a small notification panel that fades IN at a corner/edge of the screen, DWELLS for a few seconds, then fades OUT. It is a pure model + lifecycle state machine: hidden -> fadingIn -> shown -> fadingOut -> hidden, driven by tick(elapsed). The fade in and fade out are each an SLGuiTransition (the shared enter/exit tween); the dwell is a plain timer. SLeeLa owns the message, placement, severity, and timing; the host paints the panel at the resolved opacity and anchors it to the chosen corner. Family: gui. A self-dismissing notification; the host renders it, this model decides when it is visible and how opaque. >> #sleela 2.5 material; class SLGuiToast { < ---- 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 = 11401; String metaAuthor = "Kiro Agent"; String metaDate = "2026-10-19"; String metaCopyright = "SLeeLa project"; String metaTrademark = "none"; String metaCorporation = "none"; < metaOrigin: National | | International | Galactic > String metaOrigin = "International"; String metaBirthDate = "2026-10-19"; < 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; } < Lifecycle states. > < not on screen > static final int STATE_HIDDEN = 0; < enter transition running > static final int STATE_FADING_IN = 1; < fully visible, dwelling > static final int STATE_SHOWN = 2; < exit transition running > static final int STATE_FADING_OUT = 3; < Severity (tints the panel; the host maps to accent/warning/danger/success). > static final int SEV_INFO = 0; static final int SEV_SUCCESS = 1; static final int SEV_WARNING = 2; static final int SEV_DANGER = 3; < Placement anchors (which screen corner/edge the toast docks to). > static final int POS_TOP_LEFT = 0; static final int POS_TOP_RIGHT = 1; static final int POS_TOP_CENTER = 2; static final int POS_BOTTOM_LEFT = 3; static final int POS_BOTTOM_RIGHT = 4; static final int POS_BOTTOM_CENTER = 5; String message; < SEV_* > int severity; < POS_* > int position; < STATE_* > int state; < how long STATE_SHOWN lasts, 0..60000 ms > int dwellMs; < time spent in STATE_SHOWN so far > int dwellElapsed; < fade-in tween > SLGuiTransition enterFx; < fade-out tween > SLGuiTransition exitFx; int clamp(int v, int lo, int hi) { if (v < lo) { return lo; } if (v > hi) { return hi; } return v; } < Safe defaults: an info toast, bottom-right, 250ms fade-in, ~3s dwell, > < 250ms fade-out (the classic snackbar cadence). > void configure(String text) { message = (text == null) ? "" : text; severity = SEV_INFO; position = POS_BOTTOM_RIGHT; state = STATE_HIDDEN; dwellMs = 3000; dwellElapsed = 0; enterFx = new SLGuiTransition(); enterFx.configure(); < 2 = SLGuiTransition.EASE_OUT > enterFx.fadeIn(250, 2); exitFx = new SLGuiTransition(); exitFx.configure(); < 1 = SLGuiTransition.EASE_IN > exitFx.fadeOut(250, 1); } void setMessage(String text) { message = (text == null) ? "" : text; } void setSeverity(int sev) { if (sev >= SEV_INFO && sev <= SEV_DANGER) { severity = sev; } } void setPosition(int pos) { if (pos >= POS_TOP_LEFT && pos <= POS_BOTTOM_CENTER) { position = pos; } } void setDwell(int ms) { dwellMs = clamp(ms, 0, 60000); } void setFadeInMillis(int ms) { enterFx.setDuration(ms); } void setFadeOutMillis(int ms) { exitFx.setDuration(ms); } void setFadeEasing(int ease) { enterFx.setEasing(ease); exitFx.setEasing(ease); } < ---- lifecycle ---------------------------------------------------------- > < Begin showing the toast: start the enter transition from the top. > void show() { state = STATE_FADING_IN; enterFx.reset(); dwellElapsed = 0; } < Begin dismissing early (before the dwell elapses): start the exit tween. > void dismiss() { if (state == STATE_HIDDEN || state == STATE_FADING_OUT) { return; } state = STATE_FADING_OUT; exitFx.reset(); } void hideNow() { state = STATE_HIDDEN; dwellElapsed = 0; } < Advance the lifecycle by `deltaMs`. Returns true while the toast still > < occupies the screen (any non-hidden state), false once fully hidden. > boolean tick(int deltaMs) { if (deltaMs < 0) { deltaMs = 0; } if (state == STATE_FADING_IN) { enterFx.advance(deltaMs); if (enterFx.done()) { state = STATE_SHOWN; dwellElapsed = 0; } return true; } if (state == STATE_SHOWN) { dwellElapsed = dwellElapsed + deltaMs; if (dwellElapsed >= dwellMs) { state = STATE_FADING_OUT; exitFx.reset(); } return true; } if (state == STATE_FADING_OUT) { exitFx.advance(deltaMs); if (exitFx.done()) { state = STATE_HIDDEN; return false; } return true; } < STATE_HIDDEN > return false; } < ---- presentation ------------------------------------------------------- > < The opacity (0..100 %) the host should paint the panel at right now. > int opacityPct() { if (state == STATE_FADING_IN) { return enterFx.opacityPct(); } if (state == STATE_SHOWN) { return 100; } if (state == STATE_FADING_OUT) { return exitFx.opacityPct(); } < STATE_HIDDEN > return 0; } boolean onScreen() { return state != STATE_HIDDEN; } boolean fullyShown() { return state == STATE_SHOWN; } < ---- readers ------------------------------------------------------------ > String getMessage() { return message; } int getSeverity() { return severity; } int getPosition() { return position; } int getState() { return state; } SLGuiTransition enterTransition() { return enterFx; } SLGuiTransition exitTransition() { return exitFx; } String severityName() { if (severity == SEV_SUCCESS) { return "success"; } if (severity == SEV_WARNING) { return "warning"; } if (severity == SEV_DANGER) { return "danger"; } return "info"; } String positionName() { if (position == POS_TOP_LEFT) { return "top-left"; } if (position == POS_TOP_RIGHT) { return "top-right"; } if (position == POS_TOP_CENTER) { return "top-center"; } if (position == POS_BOTTOM_LEFT) { return "bottom-left"; } if (position == POS_BOTTOM_CENTER) { return "bottom-center"; } return "bottom-right"; } String stateName() { if (state == STATE_FADING_IN) { return "fading-in"; } if (state == STATE_SHOWN) { return "shown"; } if (state == STATE_FADING_OUT) { return "fading-out"; } return "hidden"; } boolean honored() { if (dwellMs < 0 || dwellMs > 60000) { return false; } int o = opacityPct(); return o >= 0 && o <= 100 && enterFx.honored() && exitFx.honored(); } < Flatten into the reconciler's style descriptor. Shape: > < "toast:@;dwell:;;" > String toStyle() { return "toast:" + severityName() + "@" + positionName() + ";" + "dwell:" + dwellMs + ";in-" + enterFx.toStyle() + ";out-" + exitFx.toStyle(); } String report() { return "toast [" + severityName() + " @" + positionName() + "]: \"" + message + "\" " + stateName() + " opacity=" + opacityPct() + "% dwell=" + dwellMs + "ms"; } }