<< lib/advantage/SLAdvantageDividend.sleela SLeeLa Standard Library Definition. Definition: The unique dividend that the onion model advantages, held with respect to a named model. >> #sleela 3.0 material; artifact; pure; gasoline; < The dividend is the value being advantaged. It is "unique" in that it carries > < its own identity (a label) and is held "with respect to a model" (a named > < frame of reference). The onion layers mutate the running value; the dividend > < remembers its base, its current value, and the net advantage gained. > class SLAdvantageDividend { < ---- 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 = 10512; String metaAuthor = "Kiro Agent"; String metaDate = "2026-11-08"; String metaCopyright = "SLeeLa project"; String metaTrademark = "none"; String metaCorporation = "none"; < metaOrigin: National | | International | Galactic > String metaOrigin = "International"; String metaBirthDate = "2026-11-08"; < 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; } < ---- Dividend state ---- > < the unique identity of this dividend > String label; < the model (frame of reference) it is held with respect to > String model; < the party to whose advantage the model is tuned > String owner; < the starting value before any layer is applied > int base; < the running value as layers are applied > int current; < ---- Original snapshot, captured at configure() for full restitute ---- > String originalLabel; String originalModel; String originalOwner; int originalBase; void configure(String lbl, String mdl, int baseValue) { label = lbl; model = mdl; owner = "unknown"; base = baseValue; current = baseValue; snapshot(); } < Record the current identity as the restitution point. > void snapshot() { originalLabel = label; originalModel = model; originalOwner = owner; originalBase = base; } String getLabel() { return label; } String getModel() { return model; } String getOwner() { return owner; } void setOwner(String o) { owner = o; } int getBase() { return base; } int getCurrent() { return current; } void setCurrent(int v) { current = v; } < ---- Dynamic update: re-point the model without losing the snapshot. ---- > < Pass null for any field to leave it unchanged. The original snapshot is > < preserved so a later restitute() can undo every change at once. > void updateModel(String newModel, String newLabel, int newBase) { if (newModel != null) { model = newModel; } if (newLabel != null) { label = newLabel; } base = newBase; current = newBase; } < ---- Full restitute: restore the dividend to its original identity. ---- > void restitute() { label = originalLabel; model = originalModel; owner = originalOwner; base = originalBase; current = originalBase; } < The net advantage: how far the dividend has moved from its base. > int advantage() { return current - base; } < Reset the running value back to the base for a fresh pass. > void rebase() { current = base; } String describe() { return "dividend '" + label + "' wrt model '" + model + "' (owner '" + owner + "'): base=" + base + " current=" + current + " advantage=" + advantage(); } }