@siliconst/metaui 1.0.2 → 1.4.4

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/ODataListBindingPlugin-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ODataListBindingPlugin-dbg.js","names":["BasePlugin","___controls_BasePlugin","ODataListBindingPlugin","render","fieldMetadata","bindingPath","modelName","metadata","args","ui","path","key","text","control","ComboBox","selectedKey","enabled","readOnly","placeholder","label","change","oEvent","val","getParameter","getKey","validate","bindAggregation","template","Item","templateShareable","getValue","getSelectedKey","applyState","setEnabled","__exports","__esModule"],"sources":["ODataListBindingPlugin.ts"],"sourcesContent":["/**\n * @file ODataListBindingPlugin.ts\n * @description A custom datasource plugin that binds a ComboBox to an OData EntitySet.\n */\n\nimport { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport ComboBox from \"sap/m/ComboBox\";\nimport Item from \"sap/ui/core/Item\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Renders a ComboBox natively bound to an OData Model entity set.\n * Expects args: { path: \"/Categories\", key: \"ID\", text: \"Name\" }\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources\n * @public\n */\nexport class ODataListBindingPlugin extends BasePlugin {\n    public render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName: string = \"meta\"): Control {\n        this.metadata = fieldMetadata;\n        \n        const args = fieldMetadata.ui?.args || { path: \"/\", key: \"ID\", text: \"Name\" };\n        \n        this.control = new ComboBox({\n            selectedKey: `{${modelName}>${bindingPath}}`,\n            enabled: !fieldMetadata.ui?.readOnly,\n            placeholder: fieldMetadata.ui?.label || \"Select...\",\n            change: (oEvent: unknown) => {\n                const val = (oEvent as { getParameter: (s: string) => unknown }).getParameter(\"selectedItem\")?.getKey();\n                this.validate();\n            }\n        });\n\n        // Natively bind aggregation to the default model (OData)\n        (this.control as ComboBox).bindAggregation(\"items\", {\n            path: args.path,\n            template: new Item({\n                key: `{${args.key}}`,\n                text: `{${args.text}}`\n            }),\n            templateShareable: false\n        });\n\n        return this.control as Control;\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as ComboBox).getSelectedKey() : null;\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            (this.control as ComboBox).setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;EAHA,MAKSA,UAAU,GAAAC,sBAAA;EAMnB;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMC,sBAAsB,SAASF,UAAU,CAAC;IAC5CG,MAAMA,CAACC,aAAgC,EAAEC,WAAmB,EAAEC,SAAiB,GAAG,MAAM,EAAW;MACtG,IAAI,CAACC,QAAQ,GAAGH,aAAa;MAE7B,MAAMI,IAAI,GAAGJ,aAAa,CAACK,EAAE,EAAED,IAAI,IAAI;QAAEE,IAAI,EAAE,GAAG;QAAEC,GAAG,EAAE,IAAI;QAAEC,IAAI,EAAE;MAAO,CAAC;MAE7E,IAAI,CAACC,OAAO,GAAG,IAAIC,QAAQ,CAAC;QACxBC,WAAW,EAAE,IAAIT,SAAS,IAAID,WAAW,GAAG;QAC5CW,OAAO,EAAE,CAACZ,aAAa,CAACK,EAAE,EAAEQ,QAAQ;QACpCC,WAAW,EAAEd,aAAa,CAACK,EAAE,EAAEU,KAAK,IAAI,WAAW;QACnDC,MAAM,EAAGC,MAAe,IAAK;UACzB,MAAMC,GAAG,GAAID,MAAM,CAA8CE,YAAY,CAAC,cAAc,CAAC,EAAEC,MAAM,CAAC,CAAC;UACvG,IAAI,CAACC,QAAQ,CAAC,CAAC;QACnB;MACJ,CAAC,CAAC;;MAEF;MACC,IAAI,CAACZ,OAAO,CAAca,eAAe,CAAC,OAAO,EAAE;QAChDhB,IAAI,EAAEF,IAAI,CAACE,IAAI;QACfiB,QAAQ,EAAE,IAAIC,IAAI,CAAC;UACfjB,GAAG,EAAE,IAAIH,IAAI,CAACG,GAAG,GAAG;UACpBC,IAAI,EAAE,IAAIJ,IAAI,CAACI,IAAI;QACvB,CAAC,CAAC;QACFiB,iBAAiB,EAAE;MACvB,CAAC,CAAC;MAEF,OAAO,IAAI,CAAChB,OAAO;IACvB;IAEUiB,QAAQA,CAAA,EAAQ;MACtB,OAAO,IAAI,CAACjB,OAAO,GAAI,IAAI,CAACA,OAAO,CAAckB,cAAc,CAAC,CAAC,GAAG,IAAI;IAC5E;IAEUC,UAAUA,CAAA,EAAS;MACzB,IAAI,IAAI,CAACnB,OAAO,IAAI,IAAI,CAACN,QAAQ,EAAE;QAC9B,IAAI,CAACM,OAAO,CAAcoB,UAAU,CAAC,CAAC,IAAI,CAAC1B,QAAQ,CAACE,EAAE,EAAEQ,QAAQ,CAAC;MACtE;IACJ;EACJ;EAAC,IAAAiB,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAhC,sBAAA,GAAAA,sBAAA;EAAA,OAAAgC,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/ODataListBindingPlugin.d.ts

@@ -0,0 +1,22 @@
+declare module "nz/co/siliconst/ui5/metaui/plugins/datasources/ODataListBindingPlugin" {
+    /**
+     * @file ODataListBindingPlugin.ts
+     * @description A custom datasource plugin that binds a ComboBox to an OData EntitySet.
+     */
+    import { BasePlugin } from "nz/co/siliconst/ui5/metaui/plugins/controls/BasePlugin";
+    import { IPropertyMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    import Control from "sap/ui/core/Control";
+    /**
+     * Renders a ComboBox natively bound to an OData Model entity set.
+     * Expects args: { path: "/Categories", key: "ID", text: "Name" }
+     *
+     * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources
+     * @public
+     */
+    export class ODataListBindingPlugin extends BasePlugin {
+        render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string): Control;
+        protected getValue(): any;
+        protected applyState(): void;
+    }
+}
+//# sourceMappingURL=ODataListBindingPlugin.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/ODataListBindingPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ODataListBindingPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/datasources/ODataListBindingPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,uEAAuE,CAAC;IACvF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAGlF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAE1C;;;;;;OAMG;IACH,MAAa,sBAAuB,SAAQ,UAAU;QAC3C,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAe,GAAG,OAAO;QA4BzG,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB,SAAS,CAAC,UAAU,IAAI,IAAI;KAK/B;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/ODataListBindingPlugin.js

@@ -0,0 +1,2 @@
+sap.ui.define(["../controls/BasePlugin","sap/m/ComboBox","sap/ui/core/Item"],function(e,t,a){"use strict";const l=e["BasePlugin"];class n extends l{render(e,l,n="meta"){this.metadata=e;const s=e.ui?.args||{path:"/",key:"ID",text:"Name"};this.control=new t({selectedKey:`{${n}>${l}}`,enabled:!e.ui?.readOnly,placeholder:e.ui?.label||"Select...",change:e=>{const t=e.getParameter("selectedItem")?.getKey();this.validate()}});this.control.bindAggregation("items",{path:s.path,template:new a({key:`{${s.key}}`,text:`{${s.text}}`}),templateShareable:false});return this.control}getValue(){return this.control?this.control.getSelectedKey():null}applyState(){if(this.control&&this.metadata){this.control.setEnabled(!this.metadata.ui?.readOnly)}}}var s={__esModule:true};s.ODataListBindingPlugin=n;return s});
+//# sourceMappingURL=ODataListBindingPlugin.js.map

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/ODataListBindingPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ODataListBindingPlugin.js","names":["BasePlugin","___controls_BasePlugin","ODataListBindingPlugin","render","fieldMetadata","bindingPath","modelName","this","metadata","args","ui","path","key","text","control","ComboBox","selectedKey","enabled","readOnly","placeholder","label","change","oEvent","val","getParameter","getKey","validate","bindAggregation","template","Item","templateShareable","getValue","getSelectedKey","applyState","setEnabled","__exports","__esModule"],"sources":["ODataListBindingPlugin.ts"],"sourcesContent":["/**\n * @file ODataListBindingPlugin.ts\n * @description A custom datasource plugin that binds a ComboBox to an OData EntitySet.\n */\n\nimport { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport ComboBox from \"sap/m/ComboBox\";\nimport Item from \"sap/ui/core/Item\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Renders a ComboBox natively bound to an OData Model entity set.\n * Expects args: { path: \"/Categories\", key: \"ID\", text: \"Name\" }\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources\n * @public\n */\nexport class ODataListBindingPlugin extends BasePlugin {\n    public render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName: string = \"meta\"): Control {\n        this.metadata = fieldMetadata;\n        \n        const args = fieldMetadata.ui?.args || { path: \"/\", key: \"ID\", text: \"Name\" };\n        \n        this.control = new ComboBox({\n            selectedKey: `{${modelName}>${bindingPath}}`,\n            enabled: !fieldMetadata.ui?.readOnly,\n            placeholder: fieldMetadata.ui?.label || \"Select...\",\n            change: (oEvent: unknown) => {\n                const val = (oEvent as { getParameter: (s: string) => unknown }).getParameter(\"selectedItem\")?.getKey();\n                this.validate();\n            }\n        });\n\n        // Natively bind aggregation to the default model (OData)\n        (this.control as ComboBox).bindAggregation(\"items\", {\n            path: args.path,\n            template: new Item({\n                key: `{${args.key}}`,\n                text: `{${args.text}}`\n            }),\n            templateShareable: false\n        });\n\n        return this.control as Control;\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as ComboBox).getSelectedKey() : null;\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            (this.control as ComboBox).setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"0GAAA,MAKSA,EAAUC,EAAA,cAaZ,MAAMC,UAA+BF,EACjCG,OAAOC,EAAkCC,EAAqBC,EAAoB,QACrFC,KAAKC,SAAWJ,EAEhB,MAAMK,EAAOL,EAAcM,IAAID,MAAQ,CAAEE,KAAM,IAAKC,IAAK,KAAMC,KAAM,QAErEN,KAAKO,QAAU,IAAIC,EAAS,CACxBC,YAAa,IAAIV,KAAaD,KAC9BY,SAAUb,EAAcM,IAAIQ,SAC5BC,YAAaf,EAAcM,IAAIU,OAAS,YACxCC,OAASC,IACL,MAAMC,EAAOD,EAAoDE,aAAa,iBAAiBC,SAC/FlB,KAAKmB,cAKZnB,KAAKO,QAAqBa,gBAAgB,QAAS,CAChDhB,KAAMF,EAAKE,KACXiB,SAAU,IAAIC,EAAK,CACfjB,IAAK,IAAIH,EAAKG,OACdC,KAAM,IAAIJ,EAAKI,UAEnBiB,kBAAmB,QAGvB,OAAOvB,KAAKO,OAChB,CAEUiB,WACN,OAAOxB,KAAKO,QAAWP,KAAKO,QAAqBkB,iBAAmB,IACxE,CAEUC,aACN,GAAI1B,KAAKO,SAAWP,KAAKC,SAAU,CAC9BD,KAAKO,QAAqBoB,YAAY3B,KAAKC,SAASE,IAAIQ,SAC7D,CACJ,EACH,IAAAiB,EAAA,CAAAC,WAAA,MAAAD,EAAAjC,yBAAA,OAAAiC,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/ODataListBindingPlugin.ts

@@ -0,0 +1,57 @@
+/**
+ * @file ODataListBindingPlugin.ts
+ * @description A custom datasource plugin that binds a ComboBox to an OData EntitySet.
+ */
+
+import { BasePlugin } from "../controls/BasePlugin";
+import { IPropertyMetadata } from "../../interfaces/ISchema";
+import ComboBox from "sap/m/ComboBox";
+import Item from "sap/ui/core/Item";
+import Control from "sap/ui/core/Control";
+
+/**
+ * Renders a ComboBox natively bound to an OData Model entity set.
+ * Expects args: { path: "/Categories", key: "ID", text: "Name" }
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources
+ * @public
+ */
+export class ODataListBindingPlugin extends BasePlugin {
+    public render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName: string = "meta"): Control {
+        this.metadata = fieldMetadata;
+        
+        const args = fieldMetadata.ui?.args || { path: "/", key: "ID", text: "Name" };
+        
+        this.control = new ComboBox({
+            selectedKey: `{${modelName}>${bindingPath}}`,
+            enabled: !fieldMetadata.ui?.readOnly,
+            placeholder: fieldMetadata.ui?.label || "Select...",
+            change: (oEvent: unknown) => {
+                const val = (oEvent as { getParameter: (s: string) => unknown }).getParameter("selectedItem")?.getKey();
+                this.validate();
+            }
+        });
+
+        // Natively bind aggregation to the default model (OData)
+        (this.control as ComboBox).bindAggregation("items", {
+            path: args.path,
+            template: new Item({
+                key: `{${args.key}}`,
+                text: `{${args.text}}`
+            }),
+            templateShareable: false
+        });
+
+        return this.control as Control;
+    }
+
+    protected getValue(): any {
+        return this.control ? (this.control as ComboBox).getSelectedKey() : null;
+    }
+
+    protected applyState(): void {
+        if (this.control && this.metadata) {
+            (this.control as ComboBox).setEnabled(!this.metadata.ui?.readOnly);
+        }
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteDropdownPlugin-dbg.js

@@ -0,0 +1,106 @@
+sap.ui.define(["../controls/BasePlugin", "sap/m/Select", "sap/ui/core/Item", "../../utils/Logger"], function (___controls_BasePlugin, Select, Item, ____utils_Logger) {
+  "use strict";
+
+  /**
+   * @file RemoteDropdownPlugin.ts
+   * @description Renders a sap.m.Select that fetches valueHelp remotely via a JSON URL.
+   */
+  const BasePlugin = ___controls_BasePlugin["BasePlugin"];
+  const Logger = ____utils_Logger["Logger"];
+  /**
+   * Handles rendering logic for dropdown inputs fetching data remotely.
+   * Maps a URL response array to `sap.ui.core.Item` elements.
+   * 
+   * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources
+   * @public
+   */
+  class RemoteDropdownPlugin extends BasePlugin {
+    render(fieldMetadata, bindingPath, modelName = "meta", engineScopeId, onChange) {
+      this.onChange = onChange;
+      this.metadata = fieldMetadata;
+      const config = fieldMetadata.valueHelp;
+      if (!config || !config.url) {
+        Logger.warn("[MetaUI RemoteDropdownPlugin] No valid URL provided for remoteDropdown.");
+        return new sap.m.Text({
+          text: "Error: No URL provided"
+        });
+      }
+      if (this.isDisplayMode) {
+        sap.ui.requireSync("sap/m/Text");
+        const TextControl = sap.ui.require("sap/m/Text");
+        this.control = new TextControl({
+          id: this.generateStableId(engineScopeId, bindingPath),
+          text: `{${modelName}>${bindingPath}}` // We might not have the text mapping synchronously
+        });
+
+        // Optionally, we could fetch data and update the text formatter here
+
+        this.applyCommonDirectives(this.control, fieldMetadata, modelName);
+        return this.control;
+      }
+      const select = new Select({
+        id: this.generateStableId(engineScopeId, bindingPath),
+        selectedKey: `{${modelName}>${bindingPath}}`,
+        enabled: !fieldMetadata.ui?.readOnly,
+        forceSelection: false,
+        busy: true,
+        // Show busy indicator while fetching
+        change: oEvent => {
+          const result = this.validate();
+          if (this.onChange) {
+            this.onChange(result.isValid, this.fieldKey);
+          }
+        }
+      });
+
+      // Add empty placeholder
+      select.addItem(new Item({
+        key: "",
+        text: "--- Select ---"
+      }));
+
+      // Fetch data remotely
+      fetch(config.url).then(res => {
+        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        return res.json();
+      }).then(data => {
+        const arr = Array.isArray(data) ? data : data.value || [];
+        arr.forEach(item => {
+          const k = config.keyPath ? item[config.keyPath] : item;
+          const t = config.textPath ? item[config.textPath] : item;
+          select.addItem(new Item({
+            key: String(k),
+            text: String(t)
+          }));
+        });
+        select.setBusy(false);
+      }).catch(err => {
+        Logger.error(`[MetaUI RemoteDropdownPlugin] Failed to fetch remote data from ${config.url}`, err.message);
+        select.addItem(new Item({
+          key: "",
+          text: "Error loading data"
+        }));
+        select.setBusy(false);
+      });
+      this.control = select;
+      this.applyCommonDirectives(this.control, fieldMetadata, modelName);
+      return this.control;
+    }
+    getValue() {
+      return this.control ? this.control.getSelectedKey() : null;
+    }
+    applyState() {
+      if (this.control && this.metadata) {
+        if (this.isDisplayMode) return;
+        const select = this.control;
+        select.setEnabled(!this.metadata.ui?.readOnly);
+      }
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.RemoteDropdownPlugin = RemoteDropdownPlugin;
+  return __exports;
+});
+//# sourceMappingURL=RemoteDropdownPlugin-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteDropdownPlugin-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteDropdownPlugin-dbg.js","names":["BasePlugin","___controls_BasePlugin","Logger","____utils_Logger","RemoteDropdownPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","config","valueHelp","url","warn","sap","m","Text","text","isDisplayMode","ui","requireSync","TextControl","require","control","id","generateStableId","applyCommonDirectives","select","Select","selectedKey","enabled","readOnly","forceSelection","busy","change","oEvent","result","validate","isValid","fieldKey","addItem","Item","key","fetch","then","res","ok","Error","status","json","data","arr","Array","isArray","value","forEach","item","k","keyPath","t","textPath","String","setBusy","catch","err","error","message","getValue","getSelectedKey","applyState","setEnabled","__exports","__esModule"],"sources":["RemoteDropdownPlugin.ts"],"sourcesContent":["/**\n * @file RemoteDropdownPlugin.ts\n * @description Renders a sap.m.Select that fetches valueHelp remotely via a JSON URL.\n */\n\nimport { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata, IRemoteValueHelpConfig } from \"../../interfaces/ISchema\";\nimport Select from \"sap/m/Select\";\nimport Item from \"sap/ui/core/Item\";\nimport Control from \"sap/ui/core/Control\";\nimport { Logger } from \"../../utils/Logger\";\n\n/**\n * Handles rendering logic for dropdown inputs fetching data remotely.\n * Maps a URL response array to `sap.ui.core.Item` elements.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources\n * @public\n */\nexport class RemoteDropdownPlugin extends BasePlugin {\n    \n    public render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = fieldMetadata;\n\n        const config = fieldMetadata.valueHelp as IRemoteValueHelpConfig;\n        if (!config || !config.url) {\n            Logger.warn(\"[MetaUI RemoteDropdownPlugin] No valid URL provided for remoteDropdown.\");\n            return new sap.m.Text({ text: \"Error: No URL provided\" }) as Control;\n        }\n        \n        if (this.isDisplayMode) {\n            sap.ui.requireSync(\"sap/m/Text\");\n            const TextControl = sap.ui.require(\"sap/m/Text\");\n            \n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: `{${modelName}>${bindingPath}}` // We might not have the text mapping synchronously\n            });\n            \n            // Optionally, we could fetch data and update the text formatter here\n            \n            this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n            return this.control as Control;\n        }\n\n        const select = new Select({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            selectedKey: `{${modelName}>${bindingPath}}`,\n            enabled: !fieldMetadata.ui?.readOnly,\n            forceSelection: false,\n            busy: true, // Show busy indicator while fetching\n            change: (oEvent: sap.ui.base.Event) => {\n                const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n\n        // Add empty placeholder\n        select.addItem(new Item({ key: \"\", text: \"--- Select ---\" }));\n\n        // Fetch data remotely\n        fetch(config.url)\n            .then(res => {\n                if (!res.ok) throw new Error(`HTTP ${res.status}`);\n                return res.json();\n            })\n            .then(data => {\n                const arr = Array.isArray(data) ? data : (data.value || []);\n                arr.forEach((item: any) => {\n                    const k = config.keyPath ? item[config.keyPath] : item;\n                    const t = config.textPath ? item[config.textPath] : item;\n                    select.addItem(new Item({ key: String(k), text: String(t) }));\n                });\n                select.setBusy(false);\n            })\n            .catch(err => {\n                Logger.error(`[MetaUI RemoteDropdownPlugin] Failed to fetch remote data from ${config.url}`, err.message);\n                select.addItem(new Item({ key: \"\", text: \"Error loading data\" }));\n                select.setBusy(false);\n            });\n\n        this.control = select;\n        this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n        return this.control as Control;\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as Select).getSelectedKey() : null;\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (this.isDisplayMode) return;\n            const select = this.control as Select;\n            select.setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;EAHA,MAKSA,UAAU,GAAAC,sBAAA;EAAA,MAKVC,MAAM,GAAAC,gBAAA;EAEf;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMC,oBAAoB,SAASJ,UAAU,CAAC;IAE1CK,MAAMA,CAACC,aAAgC,EAAEC,WAAmB,EAAEC,SAAiB,GAAG,MAAM,EAAEC,aAAsB,EAAEC,QAAwD,EAAW;MACxL,IAAI,CAACA,QAAQ,GAAGA,QAAQ;MACxB,IAAI,CAACC,QAAQ,GAAGL,aAAa;MAE7B,MAAMM,MAAM,GAAGN,aAAa,CAACO,SAAmC;MAChE,IAAI,CAACD,MAAM,IAAI,CAACA,MAAM,CAACE,GAAG,EAAE;QACxBZ,MAAM,CAACa,IAAI,CAAC,yEAAyE,CAAC;QACtF,OAAO,IAAIC,GAAG,CAACC,CAAC,CAACC,IAAI,CAAC;UAAEC,IAAI,EAAE;QAAyB,CAAC,CAAC;MAC7D;MAEA,IAAI,IAAI,CAACC,aAAa,EAAE;QACpBJ,GAAG,CAACK,EAAE,CAACC,WAAW,CAAC,YAAY,CAAC;QAChC,MAAMC,WAAW,GAAGP,GAAG,CAACK,EAAE,CAACG,OAAO,CAAC,YAAY,CAAC;QAEhD,IAAI,CAACC,OAAO,GAAG,IAAIF,WAAW,CAAC;UAC3BG,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAAClB,aAAa,EAAEF,WAAW,CAAC;UACrDY,IAAI,EAAE,IAAIX,SAAS,IAAID,WAAW,GAAG,CAAC;QAC1C,CAAC,CAAC;;QAEF;;QAEA,IAAI,CAACqB,qBAAqB,CAAC,IAAI,CAACH,OAAO,EAAEnB,aAAa,EAAEE,SAAS,CAAC;QAClE,OAAO,IAAI,CAACiB,OAAO;MACvB;MAEA,MAAMI,MAAM,GAAG,IAAIC,MAAM,CAAC;QACtBJ,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAAClB,aAAa,EAAEF,WAAW,CAAC;QACrDwB,WAAW,EAAE,IAAIvB,SAAS,IAAID,WAAW,GAAG;QAC5CyB,OAAO,EAAE,CAAC1B,aAAa,CAACe,EAAE,EAAEY,QAAQ;QACpCC,cAAc,EAAE,KAAK;QACrBC,IAAI,EAAE,IAAI;QAAE;QACZC,MAAM,EAAGC,MAAyB,IAAK;UACnC,MAAMC,MAAM,GAAG,IAAI,CAACC,QAAQ,CAAC,CAAC;UAC9B,IAAI,IAAI,CAAC7B,QAAQ,EAAE;YACf,IAAI,CAACA,QAAQ,CAAC4B,MAAM,CAACE,OAAO,EAAE,IAAI,CAACC,QAAQ,CAAC;UAChD;QACJ;MACJ,CAAC,CAAC;;MAEF;MACAZ,MAAM,CAACa,OAAO,CAAC,IAAIC,IAAI,CAAC;QAAEC,GAAG,EAAE,EAAE;QAAEzB,IAAI,EAAE;MAAiB,CAAC,CAAC,CAAC;;MAE7D;MACA0B,KAAK,CAACjC,MAAM,CAACE,GAAG,CAAC,CACZgC,IAAI,CAACC,GAAG,IAAI;QACT,IAAI,CAACA,GAAG,CAACC,EAAE,EAAE,MAAM,IAAIC,KAAK,CAAC,QAAQF,GAAG,CAACG,MAAM,EAAE,CAAC;QAClD,OAAOH,GAAG,CAACI,IAAI,CAAC,CAAC;MACrB,CAAC,CAAC,CACDL,IAAI,CAACM,IAAI,IAAI;QACV,MAAMC,GAAG,GAAGC,KAAK,CAACC,OAAO,CAACH,IAAI,CAAC,GAAGA,IAAI,GAAIA,IAAI,CAACI,KAAK,IAAI,EAAG;QAC3DH,GAAG,CAACI,OAAO,CAAEC,IAAS,IAAK;UACvB,MAAMC,CAAC,GAAG/C,MAAM,CAACgD,OAAO,GAAGF,IAAI,CAAC9C,MAAM,CAACgD,OAAO,CAAC,GAAGF,IAAI;UACtD,MAAMG,CAAC,GAAGjD,MAAM,CAACkD,QAAQ,GAAGJ,IAAI,CAAC9C,MAAM,CAACkD,QAAQ,CAAC,GAAGJ,IAAI;UACxD7B,MAAM,CAACa,OAAO,CAAC,IAAIC,IAAI,CAAC;YAAEC,GAAG,EAAEmB,MAAM,CAACJ,CAAC,CAAC;YAAExC,IAAI,EAAE4C,MAAM,CAACF,CAAC;UAAE,CAAC,CAAC,CAAC;QACjE,CAAC,CAAC;QACFhC,MAAM,CAACmC,OAAO,CAAC,KAAK,CAAC;MACzB,CAAC,CAAC,CACDC,KAAK,CAACC,GAAG,IAAI;QACVhE,MAAM,CAACiE,KAAK,CAAC,kEAAkEvD,MAAM,CAACE,GAAG,EAAE,EAAEoD,GAAG,CAACE,OAAO,CAAC;QACzGvC,MAAM,CAACa,OAAO,CAAC,IAAIC,IAAI,CAAC;UAAEC,GAAG,EAAE,EAAE;UAAEzB,IAAI,EAAE;QAAqB,CAAC,CAAC,CAAC;QACjEU,MAAM,CAACmC,OAAO,CAAC,KAAK,CAAC;MACzB,CAAC,CAAC;MAEN,IAAI,CAACvC,OAAO,GAAGI,MAAM;MACrB,IAAI,CAACD,qBAAqB,CAAC,IAAI,CAACH,OAAO,EAAEnB,aAAa,EAAEE,SAAS,CAAC;MAClE,OAAO,IAAI,CAACiB,OAAO;IACvB;IAEU4C,QAAQA,CAAA,EAAQ;MACtB,OAAO,IAAI,CAAC5C,OAAO,GAAI,IAAI,CAACA,OAAO,CAAY6C,cAAc,CAAC,CAAC,GAAG,IAAI;IAC1E;IAEUC,UAAUA,CAAA,EAAS;MACzB,IAAI,IAAI,CAAC9C,OAAO,IAAI,IAAI,CAACd,QAAQ,EAAE;QAC/B,IAAI,IAAI,CAACS,aAAa,EAAE;QACxB,MAAMS,MAAM,GAAG,IAAI,CAACJ,OAAiB;QACrCI,MAAM,CAAC2C,UAAU,CAAC,CAAC,IAAI,CAAC7D,QAAQ,CAACU,EAAE,EAAEY,QAAQ,CAAC;MAClD;IACJ;EACJ;EAAC,IAAAwC,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAArE,oBAAA,GAAAA,oBAAA;EAAA,OAAAqE,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteDropdownPlugin.d.ts

@@ -0,0 +1,22 @@
+declare module "nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteDropdownPlugin" {
+    /**
+     * @file RemoteDropdownPlugin.ts
+     * @description Renders a sap.m.Select that fetches valueHelp remotely via a JSON URL.
+     */
+    import { BasePlugin } from "nz/co/siliconst/ui5/metaui/plugins/controls/BasePlugin";
+    import { IPropertyMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    import Control from "sap/ui/core/Control";
+    /**
+     * Handles rendering logic for dropdown inputs fetching data remotely.
+     * Maps a URL response array to `sap.ui.core.Item` elements.
+     *
+     * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources
+     * @public
+     */
+    export class RemoteDropdownPlugin extends BasePlugin {
+        render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control;
+        protected getValue(): any;
+        protected applyState(): void;
+    }
+}
+//# sourceMappingURL=RemoteDropdownPlugin.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteDropdownPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteDropdownPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteDropdownPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,qEAAqE,CAAC;IACrF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAA0B,MAAM,+CAA+C,CAAC;IAG1G,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAG1C;;;;;;OAMG;IACH,MAAa,oBAAqB,SAAQ,UAAU;QAEzC,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAe,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO;QAoE3L,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB,SAAS,CAAC,UAAU,IAAI,IAAI;KAO/B;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteDropdownPlugin.js

@@ -0,0 +1,2 @@
+sap.ui.define(["../controls/BasePlugin","sap/m/Select","sap/ui/core/Item","../../utils/Logger"],function(e,t,r,o){"use strict";const s=e["BasePlugin"];const n=o["Logger"];class a extends s{render(e,o,s="meta",a,i){this.onChange=i;this.metadata=e;const l=e.valueHelp;if(!l||!l.url){n.warn("[MetaUI RemoteDropdownPlugin] No valid URL provided for remoteDropdown.");return new sap.m.Text({text:"Error: No URL provided"})}if(this.isDisplayMode){sap.ui.requireSync("sap/m/Text");const t=sap.ui.require("sap/m/Text");this.control=new t({id:this.generateStableId(a,o),text:`{${s}>${o}}`});this.applyCommonDirectives(this.control,e,s);return this.control}const d=new t({id:this.generateStableId(a,o),selectedKey:`{${s}>${o}}`,enabled:!e.ui?.readOnly,forceSelection:false,busy:true,change:e=>{const t=this.validate();if(this.onChange){this.onChange(t.isValid,this.fieldKey)}}});d.addItem(new r({key:"",text:"--- Select ---"}));fetch(l.url).then(e=>{if(!e.ok)throw new Error(`HTTP ${e.status}`);return e.json()}).then(e=>{const t=Array.isArray(e)?e:e.value||[];t.forEach(e=>{const t=l.keyPath?e[l.keyPath]:e;const o=l.textPath?e[l.textPath]:e;d.addItem(new r({key:String(t),text:String(o)}))});d.setBusy(false)}).catch(e=>{n.error(`[MetaUI RemoteDropdownPlugin] Failed to fetch remote data from ${l.url}`,e.message);d.addItem(new r({key:"",text:"Error loading data"}));d.setBusy(false)});this.control=d;this.applyCommonDirectives(this.control,e,s);return this.control}getValue(){return this.control?this.control.getSelectedKey():null}applyState(){if(this.control&&this.metadata){if(this.isDisplayMode)return;const e=this.control;e.setEnabled(!this.metadata.ui?.readOnly)}}}var i={__esModule:true};i.RemoteDropdownPlugin=a;return i});
+//# sourceMappingURL=RemoteDropdownPlugin.js.map

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteDropdownPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteDropdownPlugin.js","names":["BasePlugin","___controls_BasePlugin","Logger","____utils_Logger","RemoteDropdownPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","this","metadata","config","valueHelp","url","warn","sap","m","Text","text","isDisplayMode","ui","requireSync","TextControl","require","control","id","generateStableId","applyCommonDirectives","select","Select","selectedKey","enabled","readOnly","forceSelection","busy","change","oEvent","result","validate","isValid","fieldKey","addItem","Item","key","fetch","then","res","ok","Error","status","json","data","arr","Array","isArray","value","forEach","item","k","keyPath","t","textPath","String","setBusy","catch","err","error","message","getValue","getSelectedKey","applyState","setEnabled","__exports","__esModule"],"sources":["RemoteDropdownPlugin.ts"],"sourcesContent":["/**\n * @file RemoteDropdownPlugin.ts\n * @description Renders a sap.m.Select that fetches valueHelp remotely via a JSON URL.\n */\n\nimport { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata, IRemoteValueHelpConfig } from \"../../interfaces/ISchema\";\nimport Select from \"sap/m/Select\";\nimport Item from \"sap/ui/core/Item\";\nimport Control from \"sap/ui/core/Control\";\nimport { Logger } from \"../../utils/Logger\";\n\n/**\n * Handles rendering logic for dropdown inputs fetching data remotely.\n * Maps a URL response array to `sap.ui.core.Item` elements.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources\n * @public\n */\nexport class RemoteDropdownPlugin extends BasePlugin {\n    \n    public render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = fieldMetadata;\n\n        const config = fieldMetadata.valueHelp as IRemoteValueHelpConfig;\n        if (!config || !config.url) {\n            Logger.warn(\"[MetaUI RemoteDropdownPlugin] No valid URL provided for remoteDropdown.\");\n            return new sap.m.Text({ text: \"Error: No URL provided\" }) as Control;\n        }\n        \n        if (this.isDisplayMode) {\n            sap.ui.requireSync(\"sap/m/Text\");\n            const TextControl = sap.ui.require(\"sap/m/Text\");\n            \n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: `{${modelName}>${bindingPath}}` // We might not have the text mapping synchronously\n            });\n            \n            // Optionally, we could fetch data and update the text formatter here\n            \n            this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n            return this.control as Control;\n        }\n\n        const select = new Select({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            selectedKey: `{${modelName}>${bindingPath}}`,\n            enabled: !fieldMetadata.ui?.readOnly,\n            forceSelection: false,\n            busy: true, // Show busy indicator while fetching\n            change: (oEvent: sap.ui.base.Event) => {\n                const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n\n        // Add empty placeholder\n        select.addItem(new Item({ key: \"\", text: \"--- Select ---\" }));\n\n        // Fetch data remotely\n        fetch(config.url)\n            .then(res => {\n                if (!res.ok) throw new Error(`HTTP ${res.status}`);\n                return res.json();\n            })\n            .then(data => {\n                const arr = Array.isArray(data) ? data : (data.value || []);\n                arr.forEach((item: any) => {\n                    const k = config.keyPath ? item[config.keyPath] : item;\n                    const t = config.textPath ? item[config.textPath] : item;\n                    select.addItem(new Item({ key: String(k), text: String(t) }));\n                });\n                select.setBusy(false);\n            })\n            .catch(err => {\n                Logger.error(`[MetaUI RemoteDropdownPlugin] Failed to fetch remote data from ${config.url}`, err.message);\n                select.addItem(new Item({ key: \"\", text: \"Error loading data\" }));\n                select.setBusy(false);\n            });\n\n        this.control = select;\n        this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n        return this.control as Control;\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as Select).getSelectedKey() : null;\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (this.isDisplayMode) return;\n            const select = this.control as Select;\n            select.setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"+HAAA,MAKSA,EAAUC,EAAA,oBAKVC,EAAMC,EAAA,UASR,MAAMC,UAA6BJ,EAE/BK,OAAOC,EAAkCC,EAAqBC,EAAoB,OAAQC,EAAwBC,GACrHC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAEhB,MAAMO,EAASP,EAAcQ,UAC7B,IAAKD,IAAWA,EAAOE,IAAK,CACxBb,EAAOc,KAAK,2EACZ,OAAO,IAAIC,IAAIC,EAAEC,KAAK,CAAEC,KAAM,0BAClC,CAEA,GAAIT,KAAKU,cAAe,CACpBJ,IAAIK,GAAGC,YAAY,cACnB,MAAMC,EAAcP,IAAIK,GAAGG,QAAQ,cAEnCd,KAAKe,QAAU,IAAIF,EAAY,CAC3BG,GAAIhB,KAAKiB,iBAAiBnB,EAAeF,GACzCa,KAAM,IAAIZ,KAAaD,OAK3BI,KAAKkB,sBAAsBlB,KAAKe,QAASpB,EAAeE,GACxD,OAAOG,KAAKe,OAChB,CAEA,MAAMI,EAAS,IAAIC,EAAO,CACtBJ,GAAIhB,KAAKiB,iBAAiBnB,EAAeF,GACzCyB,YAAa,IAAIxB,KAAaD,KAC9B0B,SAAU3B,EAAcgB,IAAIY,SAC5BC,eAAgB,MAChBC,KAAM,KACNC,OAASC,IACL,MAAMC,EAAS5B,KAAK6B,WACpB,GAAI7B,KAAKD,SAAU,CACfC,KAAKD,SAAS6B,EAAOE,QAAS9B,KAAK+B,SACvC,KAKRZ,EAAOa,QAAQ,IAAIC,EAAK,CAAEC,IAAK,GAAIzB,KAAM,oBAGzC0B,MAAMjC,EAAOE,KACRgC,KAAKC,IACF,IAAKA,EAAIC,GAAI,MAAM,IAAIC,MAAM,QAAQF,EAAIG,UACzC,OAAOH,EAAII,SAEdL,KAAKM,IACF,MAAMC,EAAMC,MAAMC,QAAQH,GAAQA,EAAQA,EAAKI,OAAS,GACxDH,EAAII,QAASC,IACT,MAAMC,EAAI/C,EAAOgD,QAAUF,EAAK9C,EAAOgD,SAAWF,EAClD,MAAMG,EAAIjD,EAAOkD,SAAWJ,EAAK9C,EAAOkD,UAAYJ,EACpD7B,EAAOa,QAAQ,IAAIC,EAAK,CAAEC,IAAKmB,OAAOJ,GAAIxC,KAAM4C,OAAOF,QAE3DhC,EAAOmC,QAAQ,SAElBC,MAAMC,IACHjE,EAAOkE,MAAM,kEAAkEvD,EAAOE,MAAOoD,EAAIE,SACjGvC,EAAOa,QAAQ,IAAIC,EAAK,CAAEC,IAAK,GAAIzB,KAAM,wBACzCU,EAAOmC,QAAQ,SAGvBtD,KAAKe,QAAUI,EACfnB,KAAKkB,sBAAsBlB,KAAKe,QAASpB,EAAeE,GACxD,OAAOG,KAAKe,OAChB,CAEU4C,WACN,OAAO3D,KAAKe,QAAWf,KAAKe,QAAmB6C,iBAAmB,IACtE,CAEUC,aACN,GAAI7D,KAAKe,SAAWf,KAAKC,SAAU,CAC/B,GAAID,KAAKU,cAAe,OACxB,MAAMS,EAASnB,KAAKe,QACpBI,EAAO2C,YAAY9D,KAAKC,SAASU,IAAIY,SACzC,CACJ,EACH,IAAAwC,EAAA,CAAAC,WAAA,MAAAD,EAAAtE,uBAAA,OAAAsE,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteDropdownPlugin.ts

@@ -0,0 +1,101 @@
+/**
+ * @file RemoteDropdownPlugin.ts
+ * @description Renders a sap.m.Select that fetches valueHelp remotely via a JSON URL.
+ */
+
+import { BasePlugin } from "../controls/BasePlugin";
+import { IPropertyMetadata, IRemoteValueHelpConfig } from "../../interfaces/ISchema";
+import Select from "sap/m/Select";
+import Item from "sap/ui/core/Item";
+import Control from "sap/ui/core/Control";
+import { Logger } from "../../utils/Logger";
+
+/**
+ * Handles rendering logic for dropdown inputs fetching data remotely.
+ * Maps a URL response array to `sap.ui.core.Item` elements.
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources
+ * @public
+ */
+export class RemoteDropdownPlugin extends BasePlugin {
+    
+    public render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName: string = "meta", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {
+        this.onChange = onChange;
+        this.metadata = fieldMetadata;
+
+        const config = fieldMetadata.valueHelp as IRemoteValueHelpConfig;
+        if (!config || !config.url) {
+            Logger.warn("[MetaUI RemoteDropdownPlugin] No valid URL provided for remoteDropdown.");
+            return new sap.m.Text({ text: "Error: No URL provided" }) as Control;
+        }
+        
+        if (this.isDisplayMode) {
+            sap.ui.requireSync("sap/m/Text");
+            const TextControl = sap.ui.require("sap/m/Text");
+            
+            this.control = new TextControl({
+                id: this.generateStableId(engineScopeId, bindingPath),
+                text: `{${modelName}>${bindingPath}}` // We might not have the text mapping synchronously
+            });
+            
+            // Optionally, we could fetch data and update the text formatter here
+            
+            this.applyCommonDirectives(this.control, fieldMetadata, modelName);
+            return this.control as Control;
+        }
+
+        const select = new Select({
+            id: this.generateStableId(engineScopeId, bindingPath),
+            selectedKey: `{${modelName}>${bindingPath}}`,
+            enabled: !fieldMetadata.ui?.readOnly,
+            forceSelection: false,
+            busy: true, // Show busy indicator while fetching
+            change: (oEvent: sap.ui.base.Event) => {
+                const result = this.validate();
+                if (this.onChange) {
+                    this.onChange(result.isValid, this.fieldKey);
+                }
+            }
+        });
+
+        // Add empty placeholder
+        select.addItem(new Item({ key: "", text: "--- Select ---" }));
+
+        // Fetch data remotely
+        fetch(config.url)
+            .then(res => {
+                if (!res.ok) throw new Error(`HTTP ${res.status}`);
+                return res.json();
+            })
+            .then(data => {
+                const arr = Array.isArray(data) ? data : (data.value || []);
+                arr.forEach((item: any) => {
+                    const k = config.keyPath ? item[config.keyPath] : item;
+                    const t = config.textPath ? item[config.textPath] : item;
+                    select.addItem(new Item({ key: String(k), text: String(t) }));
+                });
+                select.setBusy(false);
+            })
+            .catch(err => {
+                Logger.error(`[MetaUI RemoteDropdownPlugin] Failed to fetch remote data from ${config.url}`, err.message);
+                select.addItem(new Item({ key: "", text: "Error loading data" }));
+                select.setBusy(false);
+            });
+
+        this.control = select;
+        this.applyCommonDirectives(this.control, fieldMetadata, modelName);
+        return this.control as Control;
+    }
+
+    protected getValue(): any {
+        return this.control ? (this.control as Select).getSelectedKey() : null;
+    }
+
+    protected applyState(): void {
+        if (this.control && this.metadata) {
+            if (this.isDisplayMode) return;
+            const select = this.control as Select;
+            select.setEnabled(!this.metadata.ui?.readOnly);
+        }
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteValueHelpPlugin-dbg.js

@@ -0,0 +1,77 @@
+sap.ui.define(["../controls/BasePlugin", "sap/m/ComboBox", "sap/ui/core/Item", "../../utils/Logger"], function (___controls_BasePlugin, ComboBox, Item, ____utils_Logger) {
+  "use strict";
+
+  /**
+   * @file RemoteValueHelpPlugin.ts
+   * @description A custom datasource plugin that simulates fetching data from a remote server.
+   */
+  const BasePlugin = ___controls_BasePlugin["BasePlugin"];
+  const Logger = ____utils_Logger["Logger"];
+  /**
+   * A custom datasource plugin that simulates fetching data from a remote server.
+   * Proves out custom data sources that dynamically load value help.
+   * 
+   * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources
+   * @public
+   */
+  class RemoteValueHelpPlugin extends BasePlugin {
+    isLoaded = false;
+    render(fieldMetadata, bindingPath, modelName = "meta") {
+      this.metadata = fieldMetadata;
+      const comboBox = new ComboBox({
+        selectedKey: `{${modelName}>${bindingPath}}`,
+        enabled: !fieldMetadata.ui?.readOnly,
+        placeholder: "Select a country...",
+        change: oEvent => {
+          const item = oEvent.getParameter("selectedItem");
+          const val = item ? item.getKey() : oEvent.getParameter("value"); // Allow free text as well
+          this.validate();
+        }
+      });
+
+      // Perform an async load against the REST endpoint
+      comboBox.attachEventOnce("loadItems", () => {
+        this.fetchData(comboBox);
+      });
+      this.control = comboBox;
+      return this.control;
+    }
+    fetchData(comboBox) {
+      const vhConfig = this.metadata?.valueHelp;
+      if (!vhConfig || !vhConfig.url) {
+        Logger.error("RemoteValueHelpPlugin requires a valid valueHelp configuration with a URL.", "", "RemoteValueHelpPlugin");
+        return;
+      }
+      comboBox.setBusy(true);
+      fetch(vhConfig.url).then(res => res.json()).then(data => {
+        const keyPath = vhConfig.keyPath || "key";
+        const textPath = vhConfig.textPath || "text";
+        data.forEach(itemData => {
+          comboBox.addItem(new Item({
+            key: itemData[keyPath],
+            text: itemData[textPath] || itemData[keyPath]
+          }));
+        });
+      }).catch(err => {
+        Logger.error("Failed to load value help from " + vhConfig.url, err.message, "RemoteValueHelpPlugin");
+      }).finally(() => {
+        comboBox.setBusy(false);
+        this.isLoaded = true;
+      });
+    }
+    getValue() {
+      return this.control ? this.control.getSelectedKey() : null;
+    }
+    applyState() {
+      if (this.control && this.metadata) {
+        this.control.setEnabled(!this.metadata.ui?.readOnly);
+      }
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.RemoteValueHelpPlugin = RemoteValueHelpPlugin;
+  return __exports;
+});
+//# sourceMappingURL=RemoteValueHelpPlugin-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteValueHelpPlugin-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteValueHelpPlugin-dbg.js","names":["BasePlugin","___controls_BasePlugin","Logger","____utils_Logger","RemoteValueHelpPlugin","isLoaded","render","fieldMetadata","bindingPath","modelName","metadata","comboBox","ComboBox","selectedKey","enabled","ui","readOnly","placeholder","change","oEvent","item","getParameter","val","getKey","validate","attachEventOnce","fetchData","control","vhConfig","valueHelp","url","error","setBusy","fetch","then","res","json","data","keyPath","textPath","forEach","itemData","addItem","Item","key","text","catch","err","message","finally","getValue","getSelectedKey","applyState","setEnabled","__exports","__esModule"],"sources":["RemoteValueHelpPlugin.ts"],"sourcesContent":["/**\n * @file RemoteValueHelpPlugin.ts\n * @description A custom datasource plugin that simulates fetching data from a remote server.\n */\n\nimport { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport ComboBox from \"sap/m/ComboBox\";\nimport Item from \"sap/ui/core/Item\";\nimport Control from \"sap/ui/core/Control\";\nimport { Logger } from \"../../utils/Logger\";\n\n/**\n * A custom datasource plugin that simulates fetching data from a remote server.\n * Proves out custom data sources that dynamically load value help.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources\n * @public\n */\nexport class RemoteValueHelpPlugin extends BasePlugin {\n    private isLoaded = false;\n\n    public render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName: string = \"meta\"): Control {\n        this.metadata = fieldMetadata;\n        \n        const comboBox = new ComboBox({\n            selectedKey: `{${modelName}>${bindingPath}}`,\n            enabled: !fieldMetadata.ui?.readOnly,\n            placeholder: \"Select a country...\",\n            change: (oEvent: unknown) => {\n                const item = (oEvent as { getParameter: (s: string) => unknown }).getParameter(\"selectedItem\");\n                const val = item ? item.getKey() : (oEvent as { getParameter: (s: string) => unknown }).getParameter(\"value\"); // Allow free text as well\n                this.validate();\n            }\n        });\n\n        // Perform an async load against the REST endpoint\n        comboBox.attachEventOnce(\"loadItems\", () => {\n            this.fetchData(comboBox);\n        });\n\n        this.control = comboBox;\n        return this.control as Control;\n    }\n\n    protected fetchData(comboBox: ComboBox): void {\n        const vhConfig = this.metadata?.valueHelp as unknown as Record<string, unknown>;\n        if (!vhConfig || !vhConfig.url) {\n            Logger.error(\"RemoteValueHelpPlugin requires a valid valueHelp configuration with a URL.\", \"\", \"RemoteValueHelpPlugin\");\n            return;\n        }\n        \n        comboBox.setBusy(true);\n        \n        fetch(vhConfig.url)\n            .then(res => res.json())\n            .then((data: unknown[]) => {\n                const keyPath = vhConfig.keyPath || \"key\";\n                const textPath = vhConfig.textPath || \"text\";\n                \n                data.forEach(itemData => {\n                    comboBox.addItem(new Item({ \n                        key: itemData[keyPath], \n                        text: itemData[textPath] || itemData[keyPath]\n                    }));\n                });\n            })\n            .catch(err => {\n                Logger.error(\"Failed to load value help from \" + vhConfig.url, err.message, \"RemoteValueHelpPlugin\");\n            })\n            .finally(() => {\n                comboBox.setBusy(false);\n                this.isLoaded = true;\n            });\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as ComboBox).getSelectedKey() : null;\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            (this.control as ComboBox).setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteValueHelpPlugin.d.ts

@@ -0,0 +1,25 @@
+declare module "nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteValueHelpPlugin" {
+    /**
+     * @file RemoteValueHelpPlugin.ts
+     * @description A custom datasource plugin that simulates fetching data from a remote server.
+     */
+    import { BasePlugin } from "nz/co/siliconst/ui5/metaui/plugins/controls/BasePlugin";
+    import { IPropertyMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    import ComboBox from "sap/m/ComboBox";
+    import Control from "sap/ui/core/Control";
+    /**
+     * A custom datasource plugin that simulates fetching data from a remote server.
+     * Proves out custom data sources that dynamically load value help.
+     *
+     * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources
+     * @public
+     */
+    export class RemoteValueHelpPlugin extends BasePlugin {
+        private isLoaded;
+        render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string): Control;
+        protected fetchData(comboBox: ComboBox): void;
+        protected getValue(): any;
+        protected applyState(): void;
+    }
+}
+//# sourceMappingURL=RemoteValueHelpPlugin.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteValueHelpPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteValueHelpPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteValueHelpPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,sEAAsE,CAAC;IACtF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAClF,OAAO,QAAQ,MAAM,gBAAgB,CAAC;IAEtC,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAG1C;;;;;;OAMG;IACH,MAAa,qBAAsB,SAAQ,UAAU;QACjD,OAAO,CAAC,QAAQ,CAAS;QAElB,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAe,GAAG,OAAO;QAuBzG,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;QA+B7C,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB,SAAS,CAAC,UAAU,IAAI,IAAI;KAK/B;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteValueHelpPlugin.js

@@ -0,0 +1,2 @@
+sap.ui.define(["../controls/BasePlugin","sap/m/ComboBox","sap/ui/core/Item","../../utils/Logger"],function(e,t,a,l){"use strict";const s=e["BasePlugin"];const o=l["Logger"];class n extends s{isLoaded=false;render(e,a,l="meta"){this.metadata=e;const s=new t({selectedKey:`{${l}>${a}}`,enabled:!e.ui?.readOnly,placeholder:"Select a country...",change:e=>{const t=e.getParameter("selectedItem");const a=t?t.getKey():e.getParameter("value");this.validate()}});s.attachEventOnce("loadItems",()=>{this.fetchData(s)});this.control=s;return this.control}fetchData(e){const t=this.metadata?.valueHelp;if(!t||!t.url){o.error("RemoteValueHelpPlugin requires a valid valueHelp configuration with a URL.","","RemoteValueHelpPlugin");return}e.setBusy(true);fetch(t.url).then(e=>e.json()).then(l=>{const s=t.keyPath||"key";const o=t.textPath||"text";l.forEach(t=>{e.addItem(new a({key:t[s],text:t[o]||t[s]}))})}).catch(e=>{o.error("Failed to load value help from "+t.url,e.message,"RemoteValueHelpPlugin")}).finally(()=>{e.setBusy(false);this.isLoaded=true})}getValue(){return this.control?this.control.getSelectedKey():null}applyState(){if(this.control&&this.metadata){this.control.setEnabled(!this.metadata.ui?.readOnly)}}}var r={__esModule:true};r.RemoteValueHelpPlugin=n;return r});
+//# sourceMappingURL=RemoteValueHelpPlugin.js.map

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteValueHelpPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteValueHelpPlugin.js","names":["BasePlugin","___controls_BasePlugin","Logger","____utils_Logger","RemoteValueHelpPlugin","isLoaded","render","fieldMetadata","bindingPath","modelName","this","metadata","comboBox","ComboBox","selectedKey","enabled","ui","readOnly","placeholder","change","oEvent","item","getParameter","val","getKey","validate","attachEventOnce","fetchData","control","vhConfig","valueHelp","url","error","setBusy","fetch","then","res","json","data","keyPath","textPath","forEach","itemData","addItem","Item","key","text","catch","err","message","finally","getValue","getSelectedKey","applyState","setEnabled","__exports","__esModule"],"sources":["RemoteValueHelpPlugin.ts"],"sourcesContent":["/**\n * @file RemoteValueHelpPlugin.ts\n * @description A custom datasource plugin that simulates fetching data from a remote server.\n */\n\nimport { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport ComboBox from \"sap/m/ComboBox\";\nimport Item from \"sap/ui/core/Item\";\nimport Control from \"sap/ui/core/Control\";\nimport { Logger } from \"../../utils/Logger\";\n\n/**\n * A custom datasource plugin that simulates fetching data from a remote server.\n * Proves out custom data sources that dynamically load value help.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources\n * @public\n */\nexport class RemoteValueHelpPlugin extends BasePlugin {\n    private isLoaded = false;\n\n    public render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName: string = \"meta\"): Control {\n        this.metadata = fieldMetadata;\n        \n        const comboBox = new ComboBox({\n            selectedKey: `{${modelName}>${bindingPath}}`,\n            enabled: !fieldMetadata.ui?.readOnly,\n            placeholder: \"Select a country...\",\n            change: (oEvent: unknown) => {\n                const item = (oEvent as { getParameter: (s: string) => unknown }).getParameter(\"selectedItem\");\n                const val = item ? item.getKey() : (oEvent as { getParameter: (s: string) => unknown }).getParameter(\"value\"); // Allow free text as well\n                this.validate();\n            }\n        });\n\n        // Perform an async load against the REST endpoint\n        comboBox.attachEventOnce(\"loadItems\", () => {\n            this.fetchData(comboBox);\n        });\n\n        this.control = comboBox;\n        return this.control as Control;\n    }\n\n    protected fetchData(comboBox: ComboBox): void {\n        const vhConfig = this.metadata?.valueHelp as unknown as Record<string, unknown>;\n        if (!vhConfig || !vhConfig.url) {\n            Logger.error(\"RemoteValueHelpPlugin requires a valid valueHelp configuration with a URL.\", \"\", \"RemoteValueHelpPlugin\");\n            return;\n        }\n        \n        comboBox.setBusy(true);\n        \n        fetch(vhConfig.url)\n            .then(res => res.json())\n            .then((data: unknown[]) => {\n                const keyPath = vhConfig.keyPath || \"key\";\n                const textPath = vhConfig.textPath || \"text\";\n                \n                data.forEach(itemData => {\n                    comboBox.addItem(new Item({ \n                        key: itemData[keyPath], \n                        text: itemData[textPath] || itemData[keyPath]\n                    }));\n                });\n            })\n            .catch(err => {\n                Logger.error(\"Failed to load value help from \" + vhConfig.url, err.message, \"RemoteValueHelpPlugin\");\n            })\n            .finally(() => {\n                comboBox.setBusy(false);\n                this.isLoaded = true;\n            });\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as ComboBox).getSelectedKey() : null;\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            (this.control as ComboBox).setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"iIAAA,MAKSA,EAAUC,EAAA,oBAKVC,EAAMC,EAAA,UASR,MAAMC,UAA8BJ,EAC/BK,SAAW,MAEZC,OAAOC,EAAkCC,EAAqBC,EAAoB,QACrFC,KAAKC,SAAWJ,EAEhB,MAAMK,EAAW,IAAIC,EAAS,CAC1BC,YAAa,IAAIL,KAAaD,KAC9BO,SAAUR,EAAcS,IAAIC,SAC5BC,YAAa,sBACbC,OAASC,IACL,MAAMC,EAAQD,EAAoDE,aAAa,gBAC/E,MAAMC,EAAMF,EAAOA,EAAKG,SAAYJ,EAAoDE,aAAa,SACrGZ,KAAKe,cAKbb,EAASc,gBAAgB,YAAa,KAClChB,KAAKiB,UAAUf,KAGnBF,KAAKkB,QAAUhB,EACf,OAAOF,KAAKkB,OAChB,CAEUD,UAAUf,GAChB,MAAMiB,EAAWnB,KAAKC,UAAUmB,UAChC,IAAKD,IAAaA,EAASE,IAAK,CAC5B7B,EAAO8B,MAAM,6EAA8E,GAAI,yBAC/F,MACJ,CAEApB,EAASqB,QAAQ,MAEjBC,MAAML,EAASE,KACVI,KAAKC,GAAOA,EAAIC,QAChBF,KAAMG,IACH,MAAMC,EAAUV,EAASU,SAAW,MACpC,MAAMC,EAAWX,EAASW,UAAY,OAEtCF,EAAKG,QAAQC,IACT9B,EAAS+B,QAAQ,IAAIC,EAAK,CACtBC,IAAKH,EAASH,GACdO,KAAMJ,EAASF,IAAaE,EAASH,UAIhDQ,MAAMC,IACH9C,EAAO8B,MAAM,kCAAoCH,EAASE,IAAKiB,EAAIC,QAAS,2BAE/EC,QAAQ,KACLtC,EAASqB,QAAQ,OACjBvB,KAAKL,SAAW,MAE5B,CAEU8C,WACN,OAAOzC,KAAKkB,QAAWlB,KAAKkB,QAAqBwB,iBAAmB,IACxE,CAEUC,aACN,GAAI3C,KAAKkB,SAAWlB,KAAKC,SAAU,CAC9BD,KAAKkB,QAAqB0B,YAAY5C,KAAKC,SAASK,IAAIC,SAC7D,CACJ,EACH,IAAAsC,EAAA,CAAAC,WAAA,MAAAD,EAAAnD,wBAAA,OAAAmD,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteValueHelpPlugin.ts

@@ -0,0 +1,86 @@
+/**
+ * @file RemoteValueHelpPlugin.ts
+ * @description A custom datasource plugin that simulates fetching data from a remote server.
+ */
+
+import { BasePlugin } from "../controls/BasePlugin";
+import { IPropertyMetadata } from "../../interfaces/ISchema";
+import ComboBox from "sap/m/ComboBox";
+import Item from "sap/ui/core/Item";
+import Control from "sap/ui/core/Control";
+import { Logger } from "../../utils/Logger";
+
+/**
+ * A custom datasource plugin that simulates fetching data from a remote server.
+ * Proves out custom data sources that dynamically load value help.
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources
+ * @public
+ */
+export class RemoteValueHelpPlugin extends BasePlugin {
+    private isLoaded = false;
+
+    public render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName: string = "meta"): Control {
+        this.metadata = fieldMetadata;
+        
+        const comboBox = new ComboBox({
+            selectedKey: `{${modelName}>${bindingPath}}`,
+            enabled: !fieldMetadata.ui?.readOnly,
+            placeholder: "Select a country...",
+            change: (oEvent: unknown) => {
+                const item = (oEvent as { getParameter: (s: string) => unknown }).getParameter("selectedItem");
+                const val = item ? item.getKey() : (oEvent as { getParameter: (s: string) => unknown }).getParameter("value"); // Allow free text as well
+                this.validate();
+            }
+        });
+
+        // Perform an async load against the REST endpoint
+        comboBox.attachEventOnce("loadItems", () => {
+            this.fetchData(comboBox);
+        });
+
+        this.control = comboBox;
+        return this.control as Control;
+    }
+
+    protected fetchData(comboBox: ComboBox): void {
+        const vhConfig = this.metadata?.valueHelp as unknown as Record<string, unknown>;
+        if (!vhConfig || !vhConfig.url) {
+            Logger.error("RemoteValueHelpPlugin requires a valid valueHelp configuration with a URL.", "", "RemoteValueHelpPlugin");
+            return;
+        }
+        
+        comboBox.setBusy(true);
+        
+        fetch(vhConfig.url)
+            .then(res => res.json())
+            .then((data: unknown[]) => {
+                const keyPath = vhConfig.keyPath || "key";
+                const textPath = vhConfig.textPath || "text";
+                
+                data.forEach(itemData => {
+                    comboBox.addItem(new Item({ 
+                        key: itemData[keyPath], 
+                        text: itemData[textPath] || itemData[keyPath]
+                    }));
+                });
+            })
+            .catch(err => {
+                Logger.error("Failed to load value help from " + vhConfig.url, err.message, "RemoteValueHelpPlugin");
+            })
+            .finally(() => {
+                comboBox.setBusy(false);
+                this.isLoaded = true;
+            });
+    }
+
+    protected getValue(): any {
+        return this.control ? (this.control as ComboBox).getSelectedKey() : null;
+    }
+
+    protected applyState(): void {
+        if (this.control && this.metadata) {
+            (this.control as ComboBox).setEnabled(!this.metadata.ui?.readOnly);
+        }
+    }
+}