@siliconst/metaui 1.0.2 → 1.4.4

package/src/nz/co/siliconst/ui5/metaui/controls/DynamicHost.ts

@@ -0,0 +1,203 @@
+import Control from "sap/ui/core/Control";
+import RenderManager from "sap/ui/core/RenderManager";
+import GeneratorHost from "./host/GeneratorHost";
+import { Logger } from "../utils/Logger";
+
+/**
+ * A transparent wrapper control (Facade) that automatically chooses between Explicit Schema Mode 
+ * and Inference Mode based on the presence of a 'schemaDefinition'.
+ * 
+ * This maintains total architectural separation of the modes without forcing developers to 
+ * use different XML tags.
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.controls
+ */
+export default class DynamicHost extends Control {
+    static readonly metadata = {
+        properties: {
+            schemaDefinition: { type: "any", defaultValue: null },
+            data: { type: "object", defaultValue: null, bindable: "bindable" },
+            dataJson: { type: "string", defaultValue: null, bindable: "bindable" },
+            liveUpdate: { type: "boolean", defaultValue: false },
+            isValid: { type: "boolean", defaultValue: true },
+            useMessageManager: { type: "boolean", defaultValue: false },
+            modelName: { type: "string", defaultValue: "meta" },
+            debugMode: { type: "boolean", defaultValue: false },
+            displayMode: { type: "boolean", defaultValue: false }
+        },
+        aggregations: {
+            _content: { type: "sap.ui.core.Control", multiple: false, visibility: "hidden" }
+        },
+        events: {
+            beforeSubmit: {
+                parameters: {
+                    payload: { type: "object" },
+                    addError: { type: "function" },
+                    preventDefault: { type: "function" }
+                }
+            },
+            submit: {
+                parameters: {
+                    payload: { type: "object" },
+                    payloadJson: { type: "string" }
+                }
+            },
+            cancel: {},
+            fieldChange: {
+                parameters: {
+                    fieldPath: { type: "string" },
+                    value: { type: "any" },
+                    payload: { type: "object" },
+                    isValid: { type: "boolean" }
+                }
+            },
+            validationStateChanged: { parameters: { isValid: { type: "boolean" } } },
+            validationError: { parameters: { fieldPath: { type: "string" }, message: { type: "string" } } },
+            validationSuccess: { parameters: { fieldPath: { type: "string" } } }
+        }
+    };
+
+    static renderer = {
+        apiVersion: 2,
+        render(rm: RenderManager, control: DynamicHost) {
+            rm.openStart("div", control);
+            rm.style("width", "100%");
+            rm.style("height", "100%");
+            rm.openEnd();
+
+            const content = control.getAggregation("_content") as Control;
+            if (content) {
+                rm.renderControl(content);
+            }
+
+            rm.close("div");
+        }
+    };
+
+    private _innerHost: GeneratorHost | null = null;
+    private _initializedInner: boolean = false;
+
+    /**
+     * Standard UI5 Lifecycle Hook.
+     * Evaluates the initial properties and spawns the appropriate inner host strategy via the HostFactory.
+     * It handles the complex lifecycle task of copying all bindings, raw properties, and event listeners 
+     * down to the inner host perfectly transparently.
+     */
+    public onBeforeRendering(): void {
+        Logger.debug("[MetaUI DynamicHost]", `onBeforeRendering called. _initializedInner: ${this._initializedInner}`, "DynamicHost");
+
+        if (!this._initializedInner) {
+            const schema = this.getProperty("schemaDefinition");
+            const dataJson = this.getProperty("dataJson");
+            const data = this.getProperty("data");
+
+            const hasSchema = !!schema;
+            const hasData = !!dataJson || !!data;
+
+            Logger.debug("[MetaUI DynamicHost]", `Evaluating boot. hasSchema: ${hasSchema}, hasData: ${hasData}`, "DynamicHost");
+
+            // Only boot if we have either a schema or some data to infer from
+            if (hasSchema || hasData) {
+                if (this.getProperty("debugMode")) {
+                    Logger.debug("[MetaUI DynamicHost]", `Booting inner host. hasSchema: ${hasSchema}, hasData: ${hasData}`, "DynamicHost");
+                }
+                // The architectural Facade router logic:
+                // We've simplified this! We no longer use HostFactory or separate subclasses.
+                // GeneratorHost is fully capable of inferring the schema if none is provided.
+                this._innerHost = new GeneratorHost();
+
+                // 1. Forward all static values to the spawned host BEFORE mounting.
+                // Since we no longer use bindProperty, it's perfectly safe to set raw properties before mounting.
+                const props = this.getMetadata().getProperties();
+                for (const propName in props) {
+                    const val = super.getProperty(propName);
+                    if (val !== null && val !== undefined) {
+                        this._innerHost.setProperty(propName, val);
+                    }
+                }
+
+                // 2. Mount so it inherits models and triggers lifecycle.
+                this.setAggregation("_content", this._innerHost);
+
+                // 3. Forward all event subscriptions.
+                // By proxying the events upwards, the developer can subscribe to `<meta:DynamicHost submit="...">` 
+                // and perfectly receive the inner host's submission event.
+                const events = this.getMetadata().getEvents();
+                for (const eventName in events) {
+                    this._innerHost.attachEvent(eventName, (oEvent: any) => {
+                        // Natively push updated payload out to any bound Fiori Element properties.
+                        // Using super.setProperty prevents an infinite loop back down to _innerHost.
+                        if (eventName === "submit" || eventName === "fieldChange") {
+                            const params = oEvent.getParameters();
+                            if (params.payload) {
+                                super.setProperty("data", params.payload, true);
+
+                                const str = params.payloadJson || JSON.stringify(params.payload, null, 2);
+                                super.setProperty("dataJson", str, true);
+                            }
+                        }
+                        this.fireEvent(eventName, oEvent.getParameters());
+                    });
+                }
+
+                this._initializedInner = true;
+            }
+        }
+    }
+
+    /**
+     * Overrides standard UI5 setProperty to act as a transparent proxy.
+     * When a property is updated on the wrapper (either programmatically or via a binding update),
+     * it instantly mirrors that value down to the inner instantiated host.
+     */
+    public setProperty(propertyName: string, value: unknown, suppressInvalidate?: boolean): this {
+        if (propertyName === "data" || propertyName === "dataJson" || propertyName === "schemaDefinition") {
+            if (this.getProperty("debugMode")) {
+                Logger.debug("[MetaUI DynamicHost]", `Wrapper received setProperty: ${propertyName}`, "DynamicHost");
+            }
+        }
+        super.setProperty(propertyName, value, suppressInvalidate);
+        if (this._innerHost) {
+            this._innerHost.setProperty(propertyName, value, suppressInvalidate);
+        } else if (propertyName === "data" || propertyName === "dataJson" || propertyName === "schemaDefinition") {
+            if (this.getProperty("debugMode")) {
+                Logger.debug("[MetaUI DynamicHost]", `_innerHost not yet initialized when ${propertyName} was set. Booting will happen on next render.`, "DynamicHost");
+            }
+        }
+        return this;
+    }
+
+
+
+
+
+    /**
+     * Programmatic API support. Routes dialog commands down to the spawned inner host.
+     */
+    public openInDialog(title?: string, submitButtonText?: string, cancelButtonText?: string): void {
+        if (!this._innerHost) {
+            this.onBeforeRendering(); // Force init if they bypassed UI5 rendering
+        }
+        this._innerHost?.openInDialog(title, submitButtonText, cancelButtonText);
+    }
+
+    /**
+     * Proxies submission triggering down to the instantiated generator host.
+     */
+    public triggerSubmit(): boolean {
+        if (!this._innerHost) {
+            return false;
+        }
+        return (this._innerHost as any).triggerSubmit();
+    }
+
+    /**
+     * Overrides standard UI5 getProperty to transparently pull extracted data from the inner host.
+     */
+    public getProperty(propertyName: string): any {
+        if (this._innerHost && (propertyName === "data" || propertyName === "dataJson")) {
+            return this._innerHost.getProperty(propertyName);
+        }
+        return super.getProperty(propertyName);
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/controls/GeolocationControl-dbg.js

@@ -0,0 +1,73 @@
+sap.ui.define(["./BaseHardwareControl", "./BaseHardwareControlRenderer", "sap/m/Button", "sap/m/Input", "sap/m/VBox", "sap/m/MessageToast"], function (__BaseHardwareControl, __BaseHardwareControlRenderer, Button, Input, VBox, MessageToast) {
+  "use strict";
+
+  function _interopRequireDefault(obj) {
+    return obj && obj.__esModule && typeof obj.default !== "undefined" ? obj.default : obj;
+  }
+  /**
+   * @file GeolocationControl.ts
+   * @description Native UI5 Control for GPS capture.
+   * 
+   * @namespace nz.co.siliconst.ui5.metaui.controls
+   */
+  const BaseHardwareControl = _interopRequireDefault(__BaseHardwareControl);
+  const BaseHardwareControlRenderer = _interopRequireDefault(__BaseHardwareControlRenderer);
+  class GeolocationControl extends BaseHardwareControl {
+    static renderer = BaseHardwareControlRenderer;
+    static metadata = {
+      aggregations: {
+        _content: {
+          type: "sap.m.VBox",
+          multiple: false,
+          visibility: "hidden"
+        }
+      }
+    };
+    init() {
+      super.init();
+      this.locationBtn = new Button({
+        icon: "sap-icon://map",
+        text: "Get Location",
+        press: this.getLocation.bind(this)
+      });
+      this.resultInput = new Input({
+        editable: false,
+        visible: false
+      });
+      this.vBox = new VBox({
+        items: [this.locationBtn, this.resultInput]
+      });
+      this.setAggregation("_content", this.vBox);
+    }
+    onBeforeRendering() {
+      const metadata = this.getProperty("schemaMetadata");
+      if (metadata && metadata.ui && metadata.ui.label) {
+        this.locationBtn.setText(metadata.ui.label);
+      }
+      const readOnly = this.getProperty("readOnly");
+      this.locationBtn.setEnabled(!readOnly);
+      const currentVal = this.getProperty("value");
+      if (currentVal) {
+        this.resultInput.setValue(currentVal);
+        this.resultInput.setVisible(true);
+      }
+    }
+    getLocation() {
+      if (!navigator.geolocation) {
+        MessageToast.show("Geolocation is not supported by your browser");
+        return;
+      }
+      navigator.geolocation.getCurrentPosition(position => {
+        const locStr = `${position.coords.latitude}, ${position.coords.longitude}`;
+        this.resultInput.setValue(locStr);
+        this.resultInput.setVisible(true);
+        this.setValueAndFire(locStr);
+        MessageToast.show("Location acquired.");
+      }, () => {
+        MessageToast.show("Unable to retrieve your location");
+      });
+    }
+  }
+  return GeolocationControl;
+});
+//# sourceMappingURL=GeolocationControl-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/controls/GeolocationControl-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeolocationControl-dbg.js","names":["BaseHardwareControl","_interopRequireDefault","__BaseHardwareControl","BaseHardwareControlRenderer","__BaseHardwareControlRenderer","GeolocationControl","renderer","metadata","aggregations","_content","type","multiple","visibility","init","locationBtn","Button","icon","text","press","getLocation","bind","resultInput","Input","editable","visible","vBox","VBox","items","setAggregation","onBeforeRendering","getProperty","ui","label","setText","readOnly","setEnabled","currentVal","setValue","setVisible","navigator","geolocation","MessageToast","show","getCurrentPosition","position","locStr","coords","latitude","longitude","setValueAndFire"],"sources":["GeolocationControl.ts"],"sourcesContent":["/**\n * @file GeolocationControl.ts\n * @description Native UI5 Control for GPS capture.\n * \n * @namespace nz.co.siliconst.ui5.metaui.controls\n */\nimport BaseHardwareControl from \"./BaseHardwareControl\";\nimport BaseHardwareControlRenderer from \"./BaseHardwareControlRenderer\";\nimport RenderManager from \"sap/ui/core/RenderManager\";\nimport Button from \"sap/m/Button\";\nimport Input from \"sap/m/Input\";\nimport VBox from \"sap/m/VBox\";\nimport MessageToast from \"sap/m/MessageToast\";\n\nexport default class GeolocationControl extends BaseHardwareControl {\n    private vBox: VBox;\n    private locationBtn: Button;\n    private resultInput: Input;\n\n    static readonly renderer = BaseHardwareControlRenderer;\n\n    static readonly metadata = {\n        aggregations: {\n            _content: { type: \"sap.m.VBox\", multiple: false, visibility: \"hidden\" }\n        }\n    };\n\n    public init(): void {\n        super.init();\n\n        this.locationBtn = new Button({\n            icon: \"sap-icon://map\",\n            text: \"Get Location\",\n            press: this.getLocation.bind(this)\n        });\n\n        this.resultInput = new Input({\n            editable: false,\n            visible: false\n        });\n\n        this.vBox = new VBox({\n            items: [this.locationBtn, this.resultInput]\n        });\n\n        this.setAggregation(\"_content\", this.vBox);\n    }\n\n    public onBeforeRendering(): void {\n        const metadata = this.getProperty(\"schemaMetadata\");\n        if (metadata && metadata.ui && metadata.ui.label) {\n            this.locationBtn.setText(metadata.ui.label);\n        }\n\n        const readOnly = this.getProperty(\"readOnly\");\n        this.locationBtn.setEnabled(!readOnly);\n\n        const currentVal = this.getProperty(\"value\");\n        if (currentVal) {\n            this.resultInput.setValue(currentVal as string);\n            this.resultInput.setVisible(true);\n        }\n    }\n\n    private getLocation(): void {\n        if (!navigator.geolocation) {\n            MessageToast.show(\"Geolocation is not supported by your browser\");\n            return;\n        }\n\n        navigator.geolocation.getCurrentPosition(\n            (position) => {\n                const locStr = `${position.coords.latitude}, ${position.coords.longitude}`;\n                this.resultInput.setValue(locStr);\n                this.resultInput.setVisible(true);\n                this.setValueAndFire(locStr);\n                MessageToast.show(\"Location acquired.\");\n            },\n            () => {\n                MessageToast.show(\"Unable to retrieve your location\");\n            }\n        );\n    }\n\n\n}\n"],"mappings":";;;;;;EAAA;AACA;AACA;AACA;AACA;AACA;EALA,MAMOA,mBAAmB,GAAAC,sBAAA,CAAAC,qBAAA;EAAA,MACnBC,2BAA2B,GAAAF,sBAAA,CAAAG,6BAAA;EAOnB,MAAMC,kBAAkB,SAASL,mBAAmB,CAAC;IAKhE,OAAgBM,QAAQ,GAAGH,2BAA2B;IAEtD,OAAgBI,QAAQ,GAAG;MACvBC,YAAY,EAAE;QACVC,QAAQ,EAAE;UAAEC,IAAI,EAAE,YAAY;UAAEC,QAAQ,EAAE,KAAK;UAAEC,UAAU,EAAE;QAAS;MAC1E;IACJ,CAAC;IAEMC,IAAIA,CAAA,EAAS;MAChB,KAAK,CAACA,IAAI,CAAC,CAAC;MAEZ,IAAI,CAACC,WAAW,GAAG,IAAIC,MAAM,CAAC;QAC1BC,IAAI,EAAE,gBAAgB;QACtBC,IAAI,EAAE,cAAc;QACpBC,KAAK,EAAE,IAAI,CAACC,WAAW,CAACC,IAAI,CAAC,IAAI;MACrC,CAAC,CAAC;MAEF,IAAI,CAACC,WAAW,GAAG,IAAIC,KAAK,CAAC;QACzBC,QAAQ,EAAE,KAAK;QACfC,OAAO,EAAE;MACb,CAAC,CAAC;MAEF,IAAI,CAACC,IAAI,GAAG,IAAIC,IAAI,CAAC;QACjBC,KAAK,EAAE,CAAC,IAAI,CAACb,WAAW,EAAE,IAAI,CAACO,WAAW;MAC9C,CAAC,CAAC;MAEF,IAAI,CAACO,cAAc,CAAC,UAAU,EAAE,IAAI,CAACH,IAAI,CAAC;IAC9C;IAEOI,iBAAiBA,CAAA,EAAS;MAC7B,MAAMtB,QAAQ,GAAG,IAAI,CAACuB,WAAW,CAAC,gBAAgB,CAAC;MACnD,IAAIvB,QAAQ,IAAIA,QAAQ,CAACwB,EAAE,IAAIxB,QAAQ,CAACwB,EAAE,CAACC,KAAK,EAAE;QAC9C,IAAI,CAAClB,WAAW,CAACmB,OAAO,CAAC1B,QAAQ,CAACwB,EAAE,CAACC,KAAK,CAAC;MAC/C;MAEA,MAAME,QAAQ,GAAG,IAAI,CAACJ,WAAW,CAAC,UAAU,CAAC;MAC7C,IAAI,CAAChB,WAAW,CAACqB,UAAU,CAAC,CAACD,QAAQ,CAAC;MAEtC,MAAME,UAAU,GAAG,IAAI,CAACN,WAAW,CAAC,OAAO,CAAC;MAC5C,IAAIM,UAAU,EAAE;QACZ,IAAI,CAACf,WAAW,CAACgB,QAAQ,CAACD,UAAoB,CAAC;QAC/C,IAAI,CAACf,WAAW,CAACiB,UAAU,CAAC,IAAI,CAAC;MACrC;IACJ;IAEQnB,WAAWA,CAAA,EAAS;MACxB,IAAI,CAACoB,SAAS,CAACC,WAAW,EAAE;QACxBC,YAAY,CAACC,IAAI,CAAC,8CAA8C,CAAC;QACjE;MACJ;MAEAH,SAAS,CAACC,WAAW,CAACG,kBAAkB,CACnCC,QAAQ,IAAK;QACV,MAAMC,MAAM,GAAG,GAAGD,QAAQ,CAACE,MAAM,CAACC,QAAQ,KAAKH,QAAQ,CAACE,MAAM,CAACE,SAAS,EAAE;QAC1E,IAAI,CAAC3B,WAAW,CAACgB,QAAQ,CAACQ,MAAM,CAAC;QACjC,IAAI,CAACxB,WAAW,CAACiB,UAAU,CAAC,IAAI,CAAC;QACjC,IAAI,CAACW,eAAe,CAACJ,MAAM,CAAC;QAC5BJ,YAAY,CAACC,IAAI,CAAC,oBAAoB,CAAC;MAC3C,CAAC,EACD,MAAM;QACFD,YAAY,CAACC,IAAI,CAAC,kCAAkC,CAAC;MACzD,CACJ,CAAC;IACL;EAGJ;EAAC,OAAArC,kBAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/GeolocationControl.d.ts

@@ -0,0 +1,32 @@
+declare module "nz/co/siliconst/ui5/metaui/controls/GeolocationControl" {
+    /**
+     * @file GeolocationControl.ts
+     * @description Native UI5 Control for GPS capture.
+     *
+     * @namespace nz.co.siliconst.ui5.metaui.controls
+     */
+    import BaseHardwareControl from "nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl";
+    import RenderManager from "sap/ui/core/RenderManager";
+    export default class GeolocationControl extends BaseHardwareControl {
+        private vBox;
+        private locationBtn;
+        private resultInput;
+        static readonly renderer: {
+            apiVersion: number;
+            render: (rm: RenderManager, control: BaseHardwareControl) => void;
+        };
+        static readonly metadata: {
+            aggregations: {
+                _content: {
+                    type: string;
+                    multiple: boolean;
+                    visibility: string;
+                };
+            };
+        };
+        init(): void;
+        onBeforeRendering(): void;
+        private getLocation;
+    }
+}
+//# sourceMappingURL=GeolocationControl.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/controls/GeolocationControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeolocationControl.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/controls/GeolocationControl.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,wDAAwD,CAAC;IACxE;;;;;OAKG;IACH,OAAO,mBAAmB,MAAM,yDAAyD,CAAC;IAE1F,OAAO,aAAa,MAAM,2BAA2B,CAAC;IAMtD,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,mBAAmB;QAC/D,OAAO,CAAC,IAAI,CAAO;QACnB,OAAO,CAAC,WAAW,CAAS;QAC5B,OAAO,CAAC,WAAW,CAAQ;QAE3B,MAAM,CAAC,QAAQ,CAAC,QAAQ;;;UAA+B;QAEvD,MAAM,CAAC,QAAQ,CAAC,QAAQ;;;;;;;;UAItB;QAEK,IAAI,IAAI,IAAI;QAqBZ,iBAAiB,IAAI,IAAI;QAgBhC,OAAO,CAAC,WAAW;KAqBtB;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/controls/GeolocationControl.js

@@ -0,0 +1,2 @@
+sap.ui.define(["./BaseHardwareControl","./BaseHardwareControlRenderer","sap/m/Button","sap/m/Input","sap/m/VBox","sap/m/MessageToast"],function(t,e,s,i,o,n){"use strict";function a(t){return t&&t.__esModule&&typeof t.default!=="undefined"?t.default:t}const r=a(t);const l=a(e);class u extends r{static renderer=l;static metadata={aggregations:{_content:{type:"sap.m.VBox",multiple:false,visibility:"hidden"}}};init(){super.init();this.locationBtn=new s({icon:"sap-icon://map",text:"Get Location",press:this.getLocation.bind(this)});this.resultInput=new i({editable:false,visible:false});this.vBox=new o({items:[this.locationBtn,this.resultInput]});this.setAggregation("_content",this.vBox)}onBeforeRendering(){const t=this.getProperty("schemaMetadata");if(t&&t.ui&&t.ui.label){this.locationBtn.setText(t.ui.label)}const e=this.getProperty("readOnly");this.locationBtn.setEnabled(!e);const s=this.getProperty("value");if(s){this.resultInput.setValue(s);this.resultInput.setVisible(true)}}getLocation(){if(!navigator.geolocation){n.show("Geolocation is not supported by your browser");return}navigator.geolocation.getCurrentPosition(t=>{const e=`${t.coords.latitude}, ${t.coords.longitude}`;this.resultInput.setValue(e);this.resultInput.setVisible(true);this.setValueAndFire(e);n.show("Location acquired.")},()=>{n.show("Unable to retrieve your location")})}}return u});
+//# sourceMappingURL=GeolocationControl.js.map

package/src/nz/co/siliconst/ui5/metaui/controls/GeolocationControl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeolocationControl.js","names":["BaseHardwareControl","_interopRequireDefault","__BaseHardwareControl","BaseHardwareControlRenderer","__BaseHardwareControlRenderer","GeolocationControl","static","aggregations","_content","type","multiple","visibility","init","super","this","locationBtn","Button","icon","text","press","getLocation","bind","resultInput","Input","editable","visible","vBox","VBox","items","setAggregation","onBeforeRendering","metadata","getProperty","ui","label","setText","readOnly","setEnabled","currentVal","setValue","setVisible","navigator","geolocation","MessageToast","show","getCurrentPosition","position","locStr","coords","latitude","longitude","setValueAndFire"],"sources":["GeolocationControl.ts"],"sourcesContent":["/**\n * @file GeolocationControl.ts\n * @description Native UI5 Control for GPS capture.\n * \n * @namespace nz.co.siliconst.ui5.metaui.controls\n */\nimport BaseHardwareControl from \"./BaseHardwareControl\";\nimport BaseHardwareControlRenderer from \"./BaseHardwareControlRenderer\";\nimport RenderManager from \"sap/ui/core/RenderManager\";\nimport Button from \"sap/m/Button\";\nimport Input from \"sap/m/Input\";\nimport VBox from \"sap/m/VBox\";\nimport MessageToast from \"sap/m/MessageToast\";\n\nexport default class GeolocationControl extends BaseHardwareControl {\n    private vBox: VBox;\n    private locationBtn: Button;\n    private resultInput: Input;\n\n    static readonly renderer = BaseHardwareControlRenderer;\n\n    static readonly metadata = {\n        aggregations: {\n            _content: { type: \"sap.m.VBox\", multiple: false, visibility: \"hidden\" }\n        }\n    };\n\n    public init(): void {\n        super.init();\n\n        this.locationBtn = new Button({\n            icon: \"sap-icon://map\",\n            text: \"Get Location\",\n            press: this.getLocation.bind(this)\n        });\n\n        this.resultInput = new Input({\n            editable: false,\n            visible: false\n        });\n\n        this.vBox = new VBox({\n            items: [this.locationBtn, this.resultInput]\n        });\n\n        this.setAggregation(\"_content\", this.vBox);\n    }\n\n    public onBeforeRendering(): void {\n        const metadata = this.getProperty(\"schemaMetadata\");\n        if (metadata && metadata.ui && metadata.ui.label) {\n            this.locationBtn.setText(metadata.ui.label);\n        }\n\n        const readOnly = this.getProperty(\"readOnly\");\n        this.locationBtn.setEnabled(!readOnly);\n\n        const currentVal = this.getProperty(\"value\");\n        if (currentVal) {\n            this.resultInput.setValue(currentVal as string);\n            this.resultInput.setVisible(true);\n        }\n    }\n\n    private getLocation(): void {\n        if (!navigator.geolocation) {\n            MessageToast.show(\"Geolocation is not supported by your browser\");\n            return;\n        }\n\n        navigator.geolocation.getCurrentPosition(\n            (position) => {\n                const locStr = `${position.coords.latitude}, ${position.coords.longitude}`;\n                this.resultInput.setValue(locStr);\n                this.resultInput.setVisible(true);\n                this.setValueAndFire(locStr);\n                MessageToast.show(\"Location acquired.\");\n            },\n            () => {\n                MessageToast.show(\"Unable to retrieve your location\");\n            }\n        );\n    }\n\n\n}\n"],"mappings":"2PAAA,MAMOA,EAAmBC,EAAAC,GAAA,MACnBC,EAA2BF,EAAAG,GAOnB,MAAMC,UAA2BL,EAK5CM,gBAA2BH,EAE3BG,gBAA2B,CACvBC,aAAc,CACVC,SAAU,CAAEC,KAAM,aAAcC,SAAU,MAAOC,WAAY,YAI9DC,OACHC,MAAMD,OAENE,KAAKC,YAAc,IAAIC,EAAO,CAC1BC,KAAM,iBACNC,KAAM,eACNC,MAAOL,KAAKM,YAAYC,KAAKP,QAGjCA,KAAKQ,YAAc,IAAIC,EAAM,CACzBC,SAAU,MACVC,QAAS,QAGbX,KAAKY,KAAO,IAAIC,EAAK,CACjBC,MAAO,CAACd,KAAKC,YAAaD,KAAKQ,eAGnCR,KAAKe,eAAe,WAAYf,KAAKY,KACzC,CAEOI,oBACH,MAAMC,EAAWjB,KAAKkB,YAAY,kBAClC,GAAID,GAAYA,EAASE,IAAMF,EAASE,GAAGC,MAAO,CAC9CpB,KAAKC,YAAYoB,QAAQJ,EAASE,GAAGC,MACzC,CAEA,MAAME,EAAWtB,KAAKkB,YAAY,YAClClB,KAAKC,YAAYsB,YAAYD,GAE7B,MAAME,EAAaxB,KAAKkB,YAAY,SACpC,GAAIM,EAAY,CACZxB,KAAKQ,YAAYiB,SAASD,GAC1BxB,KAAKQ,YAAYkB,WAAW,KAChC,CACJ,CAEQpB,cACJ,IAAKqB,UAAUC,YAAa,CACxBC,EAAaC,KAAK,gDAClB,MACJ,CAEAH,UAAUC,YAAYG,mBACjBC,IACG,MAAMC,EAAS,GAAGD,EAASE,OAAOC,aAAaH,EAASE,OAAOE,YAC/DpC,KAAKQ,YAAYiB,SAASQ,GAC1BjC,KAAKQ,YAAYkB,WAAW,MAC5B1B,KAAKqC,gBAAgBJ,GACrBJ,EAAaC,KAAK,uBAEtB,KACID,EAAaC,KAAK,qCAG9B,EAGH,OAAAvC,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/GeolocationControl.ts

@@ -0,0 +1,86 @@
+/**
+ * @file GeolocationControl.ts
+ * @description Native UI5 Control for GPS capture.
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.controls
+ */
+import BaseHardwareControl from "./BaseHardwareControl";
+import BaseHardwareControlRenderer from "./BaseHardwareControlRenderer";
+import RenderManager from "sap/ui/core/RenderManager";
+import Button from "sap/m/Button";
+import Input from "sap/m/Input";
+import VBox from "sap/m/VBox";
+import MessageToast from "sap/m/MessageToast";
+
+export default class GeolocationControl extends BaseHardwareControl {
+    private vBox: VBox;
+    private locationBtn: Button;
+    private resultInput: Input;
+
+    static readonly renderer = BaseHardwareControlRenderer;
+
+    static readonly metadata = {
+        aggregations: {
+            _content: { type: "sap.m.VBox", multiple: false, visibility: "hidden" }
+        }
+    };
+
+    public init(): void {
+        super.init();
+
+        this.locationBtn = new Button({
+            icon: "sap-icon://map",
+            text: "Get Location",
+            press: this.getLocation.bind(this)
+        });
+
+        this.resultInput = new Input({
+            editable: false,
+            visible: false
+        });
+
+        this.vBox = new VBox({
+            items: [this.locationBtn, this.resultInput]
+        });
+
+        this.setAggregation("_content", this.vBox);
+    }
+
+    public onBeforeRendering(): void {
+        const metadata = this.getProperty("schemaMetadata");
+        if (metadata && metadata.ui && metadata.ui.label) {
+            this.locationBtn.setText(metadata.ui.label);
+        }
+
+        const readOnly = this.getProperty("readOnly");
+        this.locationBtn.setEnabled(!readOnly);
+
+        const currentVal = this.getProperty("value");
+        if (currentVal) {
+            this.resultInput.setValue(currentVal as string);
+            this.resultInput.setVisible(true);
+        }
+    }
+
+    private getLocation(): void {
+        if (!navigator.geolocation) {
+            MessageToast.show("Geolocation is not supported by your browser");
+            return;
+        }
+
+        navigator.geolocation.getCurrentPosition(
+            (position) => {
+                const locStr = `${position.coords.latitude}, ${position.coords.longitude}`;
+                this.resultInput.setValue(locStr);
+                this.resultInput.setVisible(true);
+                this.setValueAndFire(locStr);
+                MessageToast.show("Location acquired.");
+            },
+            () => {
+                MessageToast.show("Unable to retrieve your location");
+            }
+        );
+    }
+
+
+}

package/src/nz/co/siliconst/ui5/metaui/controls/RichTextControl-dbg.js

@@ -0,0 +1,60 @@
+sap.ui.define(["./BaseHardwareControl", "./BaseHardwareControlRenderer", "sap/m/VBox", "sap/ui/richtexteditor/RichTextEditor"], function (__BaseHardwareControl, __BaseHardwareControlRenderer, VBox, RichTextEditor) {
+  "use strict";
+
+  function _interopRequireDefault(obj) {
+    return obj && obj.__esModule && typeof obj.default !== "undefined" ? obj.default : obj;
+  }
+  const BaseHardwareControl = _interopRequireDefault(__BaseHardwareControl);
+  const BaseHardwareControlRenderer = _interopRequireDefault(__BaseHardwareControlRenderer);
+  /**
+   * @file RichTextControl.ts
+   * @description Native UI5 Control for rich text input.
+   * 
+   * @namespace nz.co.siliconst.ui5.metaui.controls
+   */
+  const RichTextControl = BaseHardwareControl.extend("nz.co.siliconst.ui5.metaui.controls.RichTextControl", {
+    metadata: {
+      properties: {},
+      events: {},
+      aggregations: {
+        _content: {
+          type: "sap.m.VBox",
+          multiple: false,
+          visibility: "hidden"
+        }
+      }
+    },
+    renderer: BaseHardwareControlRenderer,
+    init: function _init() {
+      BaseHardwareControl.prototype.init.call(this);
+      this.richTextEditor = new RichTextEditor({
+        width: "100%",
+        height: "300px",
+        showGroupFont: true,
+        showGroupInsert: true,
+        tooltip: "Rich Text Editor",
+        change: oEvent => {
+          const val = oEvent.getParameter("newValue");
+          this.setValueAndFire(val);
+        }
+      });
+      this.vBox = new VBox({
+        items: [this.richTextEditor]
+      });
+      this.setAggregation("_content", this.vBox);
+    },
+    onBeforeRendering: function _onBeforeRendering() {
+      const readOnly = this.getProperty("readOnly");
+      this.richTextEditor.setEditable(!readOnly);
+      const currentVal = this.getProperty("value");
+      if (currentVal !== undefined && currentVal !== null) {
+        // Prevent recursive update if the value matches the editor's current value
+        if (this.richTextEditor.getValue() !== currentVal) {
+          this.richTextEditor.setValue(currentVal);
+        }
+      }
+    }
+  });
+  return RichTextControl;
+});
+//# sourceMappingURL=RichTextControl-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/controls/RichTextControl-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RichTextControl-dbg.js","names":["BaseHardwareControl","_interopRequireDefault","__BaseHardwareControl","BaseHardwareControlRenderer","__BaseHardwareControlRenderer","RichTextControl","extend","metadata","properties","events","aggregations","_content","type","multiple","visibility","renderer","init","_init","BaseHardwareControl.prototype.init.call","richTextEditor","RichTextEditor","width","height","showGroupFont","showGroupInsert","tooltip","change","oEvent","val","getParameter","setValueAndFire","vBox","VBox","items","setAggregation","onBeforeRendering","_onBeforeRendering","readOnly","getProperty","setEditable","currentVal","undefined","getValue","setValue"],"sources":["RichTextControl.ts"],"sourcesContent":["import BaseHardwareControl from \"./BaseHardwareControl\";\nimport BaseHardwareControlRenderer from \"./BaseHardwareControlRenderer\";\nimport RenderManager from \"sap/ui/core/RenderManager\";\nimport VBox from \"sap/m/VBox\";\nimport RichTextEditor from \"sap/ui/richtexteditor/RichTextEditor\";\n\n/**\n * @file RichTextControl.ts\n * @description Native UI5 Control for rich text input.\n * \n * @namespace nz.co.siliconst.ui5.metaui.controls\n */\nexport default class RichTextControl extends BaseHardwareControl {\n    private vBox!: VBox;\n    private richTextEditor!: RichTextEditor;\n\n    static readonly renderer = BaseHardwareControlRenderer;\n\n    static readonly metadata = {\n        properties: {},\n        events: {},\n        aggregations: {\n            _content: { type: \"sap.m.VBox\", multiple: false, visibility: \"hidden\" }\n        }\n    };\n\n    public init(): void {\n        super.init();\n\n        this.richTextEditor = new RichTextEditor({\n            width: \"100%\",\n            height: \"300px\",\n            showGroupFont: true,\n            showGroupInsert: true,\n            tooltip: \"Rich Text Editor\",\n            change: (oEvent: sap.ui.base.Event) => {\n                const val = oEvent.getParameter(\"newValue\");\n                this.setValueAndFire(val);\n            }\n        });\n\n        this.vBox = new VBox({\n            items: [this.richTextEditor]\n        });\n\n        this.setAggregation(\"_content\", this.vBox);\n    }\n\n    public onBeforeRendering(): void {\n        const readOnly = this.getProperty(\"readOnly\");\n        this.richTextEditor.setEditable(!readOnly);\n\n        const currentVal = this.getProperty(\"value\");\n        if (currentVal !== undefined && currentVal !== null) {\n            // Prevent recursive update if the value matches the editor's current value\n            if (this.richTextEditor.getValue() !== currentVal) {\n                this.richTextEditor.setValue(currentVal as string);\n            }\n        }\n    }\n}\n"],"mappings":";;;;;;QAAOA,mBAAmB,GAAAC,sBAAA,CAAAC,qBAAA;EAAA,MACnBC,2BAA2B,GAAAF,sBAAA,CAAAG,6BAAA;EAKlC;AACA;AACA;AACA;AACA;AACA;EALA,MAMqBC,eAAe,GAASL,mBAAmB,CAAAM,MAAA;IAM5CC,QAAQ,EAAG;MACvBC,UAAU,EAAE,CAAC,CAAC;MACdC,MAAM,EAAE,CAAC,CAAC;MACVC,YAAY,EAAE;QACVC,QAAQ,EAAE;UAAEC,IAAI,EAAE,YAAY;UAAEC,QAAQ,EAAE,KAAK;UAAEC,UAAU,EAAE;QAAS;MAC1E;IACJ,CAAC;IAReC,QAAQ,EAAGZ,2BAA2B;IAU/Ca,IAAI,WAAAC,MAAA,EAAS;MAChBC,uCAAA;MAEA,IAAI,CAACC,cAAc,GAAG,IAAIC,cAAc,CAAC;QACrCC,KAAK,EAAE,MAAM;QACbC,MAAM,EAAE,OAAO;QACfC,aAAa,EAAE,IAAI;QACnBC,eAAe,EAAE,IAAI;QACrBC,OAAO,EAAE,kBAAkB;QAC3BC,MAAM,EAAGC,MAAyB,IAAK;UACnC,MAAMC,GAAG,GAAGD,MAAM,CAACE,YAAY,CAAC,UAAU,CAAC;UAC3C,IAAI,CAACC,eAAe,CAACF,GAAG,CAAC;QAC7B;MACJ,CAAC,CAAC;MAEF,IAAI,CAACG,IAAI,GAAG,IAAIC,IAAI,CAAC;QACjBC,KAAK,EAAE,CAAC,IAAI,CAACd,cAAc;MAC/B,CAAC,CAAC;MAEF,IAAI,CAACe,cAAc,CAAC,UAAU,EAAE,IAAI,CAACH,IAAI,CAAC;IAC9C,CAAC;IAEMI,iBAAiB,WAAAC,mBAAA,EAAS;MAC7B,MAAMC,QAAQ,GAAG,IAAI,CAACC,WAAW,CAAC,UAAU,CAAC;MAC7C,IAAI,CAACnB,cAAc,CAACoB,WAAW,CAAC,CAACF,QAAQ,CAAC;MAE1C,MAAMG,UAAU,GAAG,IAAI,CAACF,WAAW,CAAC,OAAO,CAAC;MAC5C,IAAIE,UAAU,KAAKC,SAAS,IAAID,UAAU,KAAK,IAAI,EAAE;QACjD;QACA,IAAI,IAAI,CAACrB,cAAc,CAACuB,QAAQ,CAAC,CAAC,KAAKF,UAAU,EAAE;UAC/C,IAAI,CAACrB,cAAc,CAACwB,QAAQ,CAACH,UAAoB,CAAC;QACtD;MACJ;IACJ;EAAC;EAAA,OA/CgBnC,eAAe;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/RichTextControl.d.ts

@@ -0,0 +1,32 @@
+declare module "nz/co/siliconst/ui5/metaui/controls/RichTextControl" {
+    import BaseHardwareControl from "nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl";
+    import RenderManager from "sap/ui/core/RenderManager";
+    /**
+     * @file RichTextControl.ts
+     * @description Native UI5 Control for rich text input.
+     *
+     * @namespace nz.co.siliconst.ui5.metaui.controls
+     */
+    export default class RichTextControl extends BaseHardwareControl {
+        private vBox;
+        private richTextEditor;
+        static readonly renderer: {
+            apiVersion: number;
+            render: (rm: RenderManager, control: BaseHardwareControl) => void;
+        };
+        static readonly metadata: {
+            properties: {};
+            events: {};
+            aggregations: {
+                _content: {
+                    type: string;
+                    multiple: boolean;
+                    visibility: string;
+                };
+            };
+        };
+        init(): void;
+        onBeforeRendering(): void;
+    }
+}
+//# sourceMappingURL=RichTextControl.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/controls/RichTextControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RichTextControl.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/controls/RichTextControl.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,qDAAqD,CAAC;IACrE,OAAO,mBAAmB,MAAM,yDAAyD,CAAC;IAE1F,OAAO,aAAa,MAAM,2BAA2B,CAAC;IAItD;;;;;OAKG;IACH,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,mBAAmB;QAC5D,OAAO,CAAC,IAAI,CAAQ;QACpB,OAAO,CAAC,cAAc,CAAkB;QAExC,MAAM,CAAC,QAAQ,CAAC,QAAQ;;;UAA+B;QAEvD,MAAM,CAAC,QAAQ,CAAC,QAAQ;;;;;;;;;;UAMtB;QAEK,IAAI,IAAI,IAAI;QAsBZ,iBAAiB,IAAI,IAAI;KAYnC;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/controls/RichTextControl.js

@@ -0,0 +1,2 @@
+sap.ui.define(["./BaseHardwareControl","./BaseHardwareControlRenderer","sap/m/VBox","sap/ui/richtexteditor/RichTextEditor"],function(t,e,i,n){"use strict";function o(t){return t&&t.__esModule&&typeof t.default!=="undefined"?t.default:t}const r=o(t);const s=o(e);const a=r.extend("nz.co.siliconst.ui5.metaui.controls.RichTextControl",{metadata:{properties:{},events:{},aggregations:{_content:{type:"sap.m.VBox",multiple:false,visibility:"hidden"}}},renderer:s,init:function t(){r.prototype.init.call(this);this.richTextEditor=new n({width:"100%",height:"300px",showGroupFont:true,showGroupInsert:true,tooltip:"Rich Text Editor",change:t=>{const e=t.getParameter("newValue");this.setValueAndFire(e)}});this.vBox=new i({items:[this.richTextEditor]});this.setAggregation("_content",this.vBox)},onBeforeRendering:function t(){const e=this.getProperty("readOnly");this.richTextEditor.setEditable(!e);const i=this.getProperty("value");if(i!==undefined&&i!==null){if(this.richTextEditor.getValue()!==i){this.richTextEditor.setValue(i)}}}});return a});
+//# sourceMappingURL=RichTextControl.js.map

package/src/nz/co/siliconst/ui5/metaui/controls/RichTextControl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RichTextControl.js","names":["BaseHardwareControl","_interopRequireDefault","__BaseHardwareControl","BaseHardwareControlRenderer","__BaseHardwareControlRenderer","RichTextControl","extend","metadata","properties","events","aggregations","_content","type","multiple","visibility","renderer","init","_init","BaseHardwareControl.prototype.init.call","this","richTextEditor","RichTextEditor","width","height","showGroupFont","showGroupInsert","tooltip","change","oEvent","val","getParameter","setValueAndFire","vBox","VBox","items","setAggregation","onBeforeRendering","_onBeforeRendering","readOnly","getProperty","setEditable","currentVal","undefined","getValue","setValue"],"sources":["RichTextControl.ts"],"sourcesContent":["import BaseHardwareControl from \"./BaseHardwareControl\";\nimport BaseHardwareControlRenderer from \"./BaseHardwareControlRenderer\";\nimport RenderManager from \"sap/ui/core/RenderManager\";\nimport VBox from \"sap/m/VBox\";\nimport RichTextEditor from \"sap/ui/richtexteditor/RichTextEditor\";\n\n/**\n * @file RichTextControl.ts\n * @description Native UI5 Control for rich text input.\n * \n * @namespace nz.co.siliconst.ui5.metaui.controls\n */\nexport default class RichTextControl extends BaseHardwareControl {\n    private vBox!: VBox;\n    private richTextEditor!: RichTextEditor;\n\n    static readonly renderer = BaseHardwareControlRenderer;\n\n    static readonly metadata = {\n        properties: {},\n        events: {},\n        aggregations: {\n            _content: { type: \"sap.m.VBox\", multiple: false, visibility: \"hidden\" }\n        }\n    };\n\n    public init(): void {\n        super.init();\n\n        this.richTextEditor = new RichTextEditor({\n            width: \"100%\",\n            height: \"300px\",\n            showGroupFont: true,\n            showGroupInsert: true,\n            tooltip: \"Rich Text Editor\",\n            change: (oEvent: sap.ui.base.Event) => {\n                const val = oEvent.getParameter(\"newValue\");\n                this.setValueAndFire(val);\n            }\n        });\n\n        this.vBox = new VBox({\n            items: [this.richTextEditor]\n        });\n\n        this.setAggregation(\"_content\", this.vBox);\n    }\n\n    public onBeforeRendering(): void {\n        const readOnly = this.getProperty(\"readOnly\");\n        this.richTextEditor.setEditable(!readOnly);\n\n        const currentVal = this.getProperty(\"value\");\n        if (currentVal !== undefined && currentVal !== null) {\n            // Prevent recursive update if the value matches the editor's current value\n            if (this.richTextEditor.getValue() !== currentVal) {\n                this.richTextEditor.setValue(currentVal as string);\n            }\n        }\n    }\n}\n"],"mappings":"kPAAOA,EAAmBC,EAAAC,GAAA,MACnBC,EAA2BF,EAAAG,GAKlC,MAMqBC,EAAwBL,EAAmBM,OAAA,uDAM5CC,SAAW,CACvBC,WAAY,CAAC,EACbC,OAAQ,CAAC,EACTC,aAAc,CACVC,SAAU,CAAEC,KAAM,aAAcC,SAAU,MAAOC,WAAY,YANrDC,SAAWZ,EAUpBa,KAAI,SAAAC,IACPC,sBAAAC,MAEAA,KAAKC,eAAiB,IAAIC,EAAe,CACrCC,MAAO,OACPC,OAAQ,QACRC,cAAe,KACfC,gBAAiB,KACjBC,QAAS,mBACTC,OAASC,IACL,MAAMC,EAAMD,EAAOE,aAAa,YAChCX,KAAKY,gBAAgBF,MAI7BV,KAAKa,KAAO,IAAIC,EAAK,CACjBC,MAAO,CAACf,KAAKC,kBAGjBD,KAAKgB,eAAe,WAAYhB,KAAKa,KACzC,EAEOI,kBAAiB,SAAAC,IACpB,MAAMC,EAAWnB,KAAKoB,YAAY,YAClCpB,KAAKC,eAAeoB,aAAaF,GAEjC,MAAMG,EAAatB,KAAKoB,YAAY,SACpC,GAAIE,IAAeC,WAAaD,IAAe,KAAM,CAEjD,GAAItB,KAAKC,eAAeuB,aAAeF,EAAY,CAC/CtB,KAAKC,eAAewB,SAASH,EACjC,CACJ,CACJ,IAAC,OA/CgBpC,CAAe","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/RichTextControl.ts

@@ -0,0 +1,61 @@
+import BaseHardwareControl from "./BaseHardwareControl";
+import BaseHardwareControlRenderer from "./BaseHardwareControlRenderer";
+import RenderManager from "sap/ui/core/RenderManager";
+import VBox from "sap/m/VBox";
+import RichTextEditor from "sap/ui/richtexteditor/RichTextEditor";
+
+/**
+ * @file RichTextControl.ts
+ * @description Native UI5 Control for rich text input.
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.controls
+ */
+export default class RichTextControl extends BaseHardwareControl {
+    private vBox!: VBox;
+    private richTextEditor!: RichTextEditor;
+
+    static readonly renderer = BaseHardwareControlRenderer;
+
+    static readonly metadata = {
+        properties: {},
+        events: {},
+        aggregations: {
+            _content: { type: "sap.m.VBox", multiple: false, visibility: "hidden" }
+        }
+    };
+
+    public init(): void {
+        super.init();
+
+        this.richTextEditor = new RichTextEditor({
+            width: "100%",
+            height: "300px",
+            showGroupFont: true,
+            showGroupInsert: true,
+            tooltip: "Rich Text Editor",
+            change: (oEvent: sap.ui.base.Event) => {
+                const val = oEvent.getParameter("newValue");
+                this.setValueAndFire(val);
+            }
+        });
+
+        this.vBox = new VBox({
+            items: [this.richTextEditor]
+        });
+
+        this.setAggregation("_content", this.vBox);
+    }
+
+    public onBeforeRendering(): void {
+        const readOnly = this.getProperty("readOnly");
+        this.richTextEditor.setEditable(!readOnly);
+
+        const currentVal = this.getProperty("value");
+        if (currentVal !== undefined && currentVal !== null) {
+            // Prevent recursive update if the value matches the editor's current value
+            if (this.richTextEditor.getValue() !== currentVal) {
+                this.richTextEditor.setValue(currentVal as string);
+            }
+        }
+    }
+}