Home /Modules/user-interface/SLGuiWidgetFactory.sleela

SLGuiWidgetFactory.sleela

lib/user-interface/SLGuiWidgetFactory.sleela · 113 line(s) · sleela

<< lib/user-interface/SLGuiWidgetFactory.sleela
   SLeeLa Standard Library Definition.
   Definition: Defines SLGuiWidgetFactory — the single place that knows how a
     DOM tag maps to a real SleelaUI widget. Given a node's tag and a parent
     widget handle it calls the matching `ui*` built-in (uiBox / uiButton /
     uiLabel / uiEntry / uiToggle / uiHeaderBar / uiStatusBar / ...) and returns
     the new widget handle, so the reconciler (SLGuiMount) never hard-codes
     toolkit knowledge. Tags mirror the SleelaUI vocabulary; an unknown tag
     falls back to a vertical box so an unrecognised element still has a
     container to hold children. This is the DOM->toolkit construction seam.
   
   Family: user-interface. The factory crosses the `ui*` SLVM bridge to the real toolkit;
   SLeeLa still owns the node that the widget mirrors. >>
#sleela 2.5
material;
class SLGuiWidgetFactory {
  < ---- 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 = 11052;
  String metaAuthor = "Kiro Agent";
  String metaDate = "2026-10-16";
  String metaCopyright = "SLeeLa project";
  String metaTrademark = "none";
  String metaCorporation = "none";
  < metaOrigin: National | <nation> | International | Galactic >
  String metaOrigin = "International";
  String metaBirthDate = "2026-10-13";
  < 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; }
  < Orientation ordinals (mirror SLUIOrientation / SLWidget). >
  static final int ORIENT_VERTICAL   = 0;
  static final int ORIENT_HORIZONTAL = 1;

  < Construct the widget for `node` inside `parentHandle`. Returns the new >
  < widget handle, or -1 when it could not be created. `label` is the node's >
  < initial text/placeholder (empty string when it has none). >
  int construct(int parentHandle, String tag, String label) {
    if (parentHandle < 0) { return -1; }

    < Containers. >
    if (tag == "window" || tag == "box" || tag == "vbox") {
      return uiBox(parentHandle, ORIENT_VERTICAL, 8);
    }
    if (tag == "hbox" || tag == "row") {
      return uiBox(parentHandle, ORIENT_HORIZONTAL, 8);
    }
    if (tag == "header" || tag == "headerbar") { return uiHeaderBar(parentHandle); }
    if (tag == "status" || tag == "statusbar") { return uiStatusBar(parentHandle); }
    if (tag == "frame" || tag == "group")      { return uiFrame(parentHandle, label); }

    < Leaf / interactive controls. >
    if (tag == "label" || tag == "text")   { return uiLabel(parentHandle, label); }
    if (tag == "button")                    { return uiButton(parentHandle, label); }
    if (tag == "entry" || tag == "input")   { return uiEntry(parentHandle, label); }
    if (tag == "toggle" || tag == "switch") { return uiToggle(parentHandle, label, 0); }
    if (tag == "spacer")                    { return uiSpacer(parentHandle); }
    if (tag == "separator" || tag == "hr")  { return uiSeparator(parentHandle, ORIENT_HORIZONTAL); }

    < Unknown tag: give it a vertical box so children still have a container. >
    return uiBox(parentHandle, ORIENT_VERTICAL, 8);
  }

  < Is this tag an interactive control the host should poll for activations? >
  boolean interactive(String tag) {
    return tag == "button" || tag == "entry" || tag == "input"
        || tag == "toggle" || tag == "switch";
  }

  < Which SLGuiEventType an activation on this tag should raise. >
  < Buttons -> CLICK; entries -> SUBMIT (Enter); toggles -> TOGGLE. >
  int activationEvent(String tag) {
    if (tag == "button") { return SLGuiEventType.CLICK; }
    if (tag == "toggle" || tag == "switch") { return SLGuiEventType.TOGGLE; }
    if (tag == "entry" || tag == "input")   { return SLGuiEventType.SUBMIT; }
    return SLGuiEventType.CUSTOM;
  }

  boolean isContainer(String tag) {
    return tag == "window" || tag == "box" || tag == "vbox" || tag == "hbox"
        || tag == "row" || tag == "header" || tag == "headerbar"
        || tag == "status" || tag == "statusbar" || tag == "frame"
        || tag == "group";
  }
}