@siliconst/metaui 1.2.0 → 1.4.4

package/src/nz/co/siliconst/ui5/metaui/plugins/{DateTimePlugin-dbg.js → controls/DateTimePlugin-dbg.js}

@@ -10,9 +10,30 @@ sap.ui.define(["./BasePlugin", "sap/m/DateTimePicker"], function (___BasePlugin,
    * Handles rendering and logic for timestamps/datetime inputs.
    */
   class DateTimePlugin extends BasePlugin {
-    render(fieldMetadata, bindingPath, modelName = "meta") {
+    render(fieldMetadata, bindingPath, modelName = "meta", engineScopeId, onChange) {
+      this.onChange = onChange;
       this.metadata = fieldMetadata;
+      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: {
+            path: `${modelName}>${bindingPath}`,
+            type: "sap.ui.model.type.DateTime",
+            formatOptions: {
+              source: {
+                pattern: "yyyy-MM-dd'T'HH:mm:ss'Z'"
+              },
+              pattern: "yyyy-MM-dd'T'HH:mm:ss'Z'"
+            }
+          }
+        });
+        this.applyCommonDirectives(this.control, fieldMetadata, modelName);
+        return this.control;
+      }
       this.control = new DateTimePicker({
+        id: this.generateStableId(engineScopeId, bindingPath),
         value: {
           path: `${modelName}>${bindingPath}`,
           type: "sap.ui.model.type.DateTime",
@@ -27,32 +48,21 @@ sap.ui.define(["./BasePlugin", "sap/m/DateTimePicker"], function (___BasePlugin,
         required: fieldMetadata.required,
         change: oEvent => {
           const val = oEvent.getParameter("value");
-          this.publishChange(val);
-          this.validate();
+          const result = this.validate();
+          if (this.onChange) {
+            this.onChange(result.isValid, this.fieldKey);
+          }
         }
       });
+      this.applyCommonDirectives(this.control, fieldMetadata, modelName);
       return this.control;
     }
-    validate() {
-      if (!this.control || !this.metadata) return true;
-      const input = this.control;
-      const isValid = typeof input.isValidValue === "function" ? input.isValidValue() : true;
-      const val = input.getValue();
-      if (this.metadata.required && (!val || typeof val !== 'string' || val.trim() === "")) {
-        input.setValueState("Error");
-        input.setValueStateText("This field is required.");
-        return false;
-      }
-      if (val && !isValid) {
-        input.setValueState("Error");
-        input.setValueStateText("Invalid datetime format.");
-        return false;
-      }
-      input.setValueState("None");
-      return true;
+    getValue() {
+      return this.control ? this.control.getValue() : null;
     }
     applyState() {
       if (this.control && this.metadata) {
+        if (this.isDisplayMode) return;
         const input = this.control;
         input.setEditable(!this.metadata.ui?.readOnly);
         input.setRequired(this.metadata.required);

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

@@ -0,0 +1 @@
+{"version":3,"file":"DateTimePlugin-dbg.js","names":["BasePlugin","___BasePlugin","DateTimePlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","isDisplayMode","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","path","type","formatOptions","source","pattern","applyCommonDirectives","DateTimePicker","value","editable","readOnly","required","change","oEvent","val","getParameter","result","validate","isValid","fieldKey","getValue","applyState","input","setEditable","setRequired","__exports","__esModule"],"sources":["DateTimePlugin.ts"],"sourcesContent":["/**\n * @file DateTimePlugin.ts\n * @description Handles rendering logic for DateTime strings (timestamps).\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport DateTimePicker from \"sap/m/DateTimePicker\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Handles rendering and logic for timestamps/datetime inputs.\n */\nexport class DateTimePlugin extends BasePlugin {\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        if (this.isDisplayMode) {\n            sap.ui.requireSync(\"sap/m/Text\");\n            const TextControl = sap.ui.require(\"sap/m/Text\");\n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: {\n                    path: `${modelName}>${bindingPath}`,\n                    type: \"sap.ui.model.type.DateTime\",\n                    formatOptions: {\n                        source: { pattern: \"yyyy-MM-dd'T'HH:mm:ss'Z'\" },\n                        pattern: \"yyyy-MM-dd'T'HH:mm:ss'Z'\"\n                    }\n                }\n            });\n            this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n            return this.control as Control;\n        }\n\n        this.control = new DateTimePicker({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            value: {\n                path: `${modelName}>${bindingPath}`,\n                type: \"sap.ui.model.type.DateTime\",\n                formatOptions: {\n                    source: { pattern: \"yyyy-MM-dd'T'HH:mm:ss'Z'\" },\n                    pattern: \"yyyy-MM-dd'T'HH:mm:ss'Z'\"\n                }\n            },\n            editable: !fieldMetadata.ui?.readOnly,\n            required: fieldMetadata.required,\n            change: (oEvent: sap.ui.base.Event) => {\n                const val = oEvent.getParameter(\"value\");\n                const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n\n        this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n\n        return this.control as Control;\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as DateTimePicker).getValue() : null;\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (this.isDisplayMode) return;\n            const input = this.control as DateTimePicker;\n            input.setEditable(!this.metadata.ui?.readOnly);\n            input.setRequired(this.metadata.required);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/{DateTimePlugin.d.ts → controls/DateTimePlugin.d.ts}

@@ -1,17 +1,17 @@
-declare module "nz/co/siliconst/ui5/metaui/plugins/DateTimePlugin" {
+declare module "nz/co/siliconst/ui5/metaui/plugins/controls/DateTimePlugin" {
     /**
      * @file DateTimePlugin.ts
      * @description Handles rendering logic for DateTime strings (timestamps).
      */
-    import { BasePlugin } from "nz/co/siliconst/ui5/metaui/plugins/BasePlugin";
+    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 and logic for timestamps/datetime inputs.
      */
     export class DateTimePlugin extends BasePlugin {
-        render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string): Control;
-        validate(): boolean;
+        render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control;
+        protected getValue(): any;
         protected applyState(): void;
     }
 }

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

@@ -0,0 +1 @@
+{"version":3,"file":"DateTimePlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/DateTimePlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,4DAA4D,CAAC;IAC5E;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAElF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAE1C;;OAEG;IACH,MAAa,cAAe,SAAQ,UAAU;QACnC,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAG,WAAW,EAAE,MAAM,EAAG,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;QAgD7L,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB,SAAS,CAAC,UAAU,IAAI,IAAI;KAQ/B;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/DateTimePlugin.js

@@ -0,0 +1,2 @@
+sap.ui.define(["./BasePlugin","sap/m/DateTimePicker"],function(t,e){"use strict";const i=t["BasePlugin"];class s extends i{render(t,i,s="meta",a,r){this.onChange=r;this.metadata=t;if(this.isDisplayMode){sap.ui.requireSync("sap/m/Text");const e=sap.ui.require("sap/m/Text");this.control=new e({id:this.generateStableId(a,i),text:{path:`${s}>${i}`,type:"sap.ui.model.type.DateTime",formatOptions:{source:{pattern:"yyyy-MM-dd'T'HH:mm:ss'Z'"},pattern:"yyyy-MM-dd'T'HH:mm:ss'Z'"}}});this.applyCommonDirectives(this.control,t,s);return this.control}this.control=new e({id:this.generateStableId(a,i),value:{path:`${s}>${i}`,type:"sap.ui.model.type.DateTime",formatOptions:{source:{pattern:"yyyy-MM-dd'T'HH:mm:ss'Z'"},pattern:"yyyy-MM-dd'T'HH:mm:ss'Z'"}},editable:!t.ui?.readOnly,required:t.required,change:t=>{const e=t.getParameter("value");const i=this.validate();if(this.onChange){this.onChange(i.isValid,this.fieldKey)}}});this.applyCommonDirectives(this.control,t,s);return this.control}getValue(){return this.control?this.control.getValue():null}applyState(){if(this.control&&this.metadata){if(this.isDisplayMode)return;const t=this.control;t.setEditable(!this.metadata.ui?.readOnly);t.setRequired(this.metadata.required)}}}var a={__esModule:true};a.DateTimePlugin=s;return a});
+//# sourceMappingURL=DateTimePlugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DateTimePlugin.js","names":["BasePlugin","___BasePlugin","DateTimePlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","this","metadata","isDisplayMode","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","path","type","formatOptions","source","pattern","applyCommonDirectives","DateTimePicker","value","editable","readOnly","required","change","oEvent","val","getParameter","result","validate","isValid","fieldKey","getValue","applyState","input","setEditable","setRequired","__exports","__esModule"],"sources":["DateTimePlugin.ts"],"sourcesContent":["/**\n * @file DateTimePlugin.ts\n * @description Handles rendering logic for DateTime strings (timestamps).\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport DateTimePicker from \"sap/m/DateTimePicker\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Handles rendering and logic for timestamps/datetime inputs.\n */\nexport class DateTimePlugin extends BasePlugin {\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        if (this.isDisplayMode) {\n            sap.ui.requireSync(\"sap/m/Text\");\n            const TextControl = sap.ui.require(\"sap/m/Text\");\n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: {\n                    path: `${modelName}>${bindingPath}`,\n                    type: \"sap.ui.model.type.DateTime\",\n                    formatOptions: {\n                        source: { pattern: \"yyyy-MM-dd'T'HH:mm:ss'Z'\" },\n                        pattern: \"yyyy-MM-dd'T'HH:mm:ss'Z'\"\n                    }\n                }\n            });\n            this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n            return this.control as Control;\n        }\n\n        this.control = new DateTimePicker({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            value: {\n                path: `${modelName}>${bindingPath}`,\n                type: \"sap.ui.model.type.DateTime\",\n                formatOptions: {\n                    source: { pattern: \"yyyy-MM-dd'T'HH:mm:ss'Z'\" },\n                    pattern: \"yyyy-MM-dd'T'HH:mm:ss'Z'\"\n                }\n            },\n            editable: !fieldMetadata.ui?.readOnly,\n            required: fieldMetadata.required,\n            change: (oEvent: sap.ui.base.Event) => {\n                const val = oEvent.getParameter(\"value\");\n                const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n\n        this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n\n        return this.control as Control;\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as DateTimePicker).getValue() : null;\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (this.isDisplayMode) return;\n            const input = this.control as DateTimePicker;\n            input.setEditable(!this.metadata.ui?.readOnly);\n            input.setRequired(this.metadata.required);\n        }\n    }\n}\n"],"mappings":"iFAAA,MAKSA,EAAUC,EAAA,cAQZ,MAAMC,UAAuBF,EACzBG,OAAOC,EAAmCC,EAAsBC,EAAoB,OAAQC,EAAwBC,GACvHC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAEhB,GAAIK,KAAKE,cAAe,CACpBC,IAAIC,GAAGC,YAAY,cACnB,MAAMC,EAAcH,IAAIC,GAAGG,QAAQ,cACnCP,KAAKQ,QAAU,IAAIF,EAAY,CAC3BG,GAAIT,KAAKU,iBAAiBZ,EAAeF,GACzCe,KAAM,CACFC,KAAM,GAAGf,KAAaD,IACtBiB,KAAM,6BACNC,cAAe,CACXC,OAAQ,CAAEC,QAAS,4BACnBA,QAAS,+BAIrBhB,KAAKiB,sBAAsBjB,KAAKQ,QAASb,EAAeE,GACxD,OAAOG,KAAKQ,OAChB,CAEAR,KAAKQ,QAAU,IAAIU,EAAe,CAC9BT,GAAIT,KAAKU,iBAAiBZ,EAAeF,GACzCuB,MAAO,CACHP,KAAM,GAAGf,KAAaD,IACtBiB,KAAM,6BACNC,cAAe,CACXC,OAAQ,CAAEC,QAAS,4BACnBA,QAAS,6BAGjBI,UAAWzB,EAAcS,IAAIiB,SAC7BC,SAAU3B,EAAc2B,SACxBC,OAASC,IACL,MAAMC,EAAMD,EAAOE,aAAa,SAChC,MAAMC,EAAS3B,KAAK4B,WACpB,GAAI5B,KAAKD,SAAU,CACfC,KAAKD,SAAS4B,EAAOE,QAAS7B,KAAK8B,SACvC,KAIR9B,KAAKiB,sBAAsBjB,KAAKQ,QAASb,EAAeE,GAExD,OAAOG,KAAKQ,OAChB,CAEUuB,WACN,OAAO/B,KAAKQ,QAAWR,KAAKQ,QAA2BuB,WAAa,IACxE,CAEUC,aACN,GAAIhC,KAAKQ,SAAWR,KAAKC,SAAU,CAC/B,GAAID,KAAKE,cAAe,OACxB,MAAM+B,EAAQjC,KAAKQ,QACnByB,EAAMC,aAAalC,KAAKC,SAASG,IAAIiB,UACrCY,EAAME,YAAYnC,KAAKC,SAASqB,SACpC,CACJ,EACH,IAAAc,EAAA,CAAAC,WAAA,MAAAD,EAAA3C,iBAAA,OAAA2C,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/DateTimePlugin.ts

@@ -0,0 +1,75 @@
+/**
+ * @file DateTimePlugin.ts
+ * @description Handles rendering logic for DateTime strings (timestamps).
+ */
+
+import { BasePlugin } from "./BasePlugin";
+import { IPropertyMetadata } from "../../interfaces/ISchema";
+import DateTimePicker from "sap/m/DateTimePicker";
+import Control from "sap/ui/core/Control";
+
+/**
+ * Handles rendering and logic for timestamps/datetime inputs.
+ */
+export class DateTimePlugin 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;
+        
+        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: {
+                    path: `${modelName}>${bindingPath}`,
+                    type: "sap.ui.model.type.DateTime",
+                    formatOptions: {
+                        source: { pattern: "yyyy-MM-dd'T'HH:mm:ss'Z'" },
+                        pattern: "yyyy-MM-dd'T'HH:mm:ss'Z'"
+                    }
+                }
+            });
+            this.applyCommonDirectives(this.control, fieldMetadata, modelName);
+            return this.control as Control;
+        }
+
+        this.control = new DateTimePicker({
+            id: this.generateStableId(engineScopeId, bindingPath),
+            value: {
+                path: `${modelName}>${bindingPath}`,
+                type: "sap.ui.model.type.DateTime",
+                formatOptions: {
+                    source: { pattern: "yyyy-MM-dd'T'HH:mm:ss'Z'" },
+                    pattern: "yyyy-MM-dd'T'HH:mm:ss'Z'"
+                }
+            },
+            editable: !fieldMetadata.ui?.readOnly,
+            required: fieldMetadata.required,
+            change: (oEvent: sap.ui.base.Event) => {
+                const val = oEvent.getParameter("value");
+                const result = this.validate();
+                if (this.onChange) {
+                    this.onChange(result.isValid, this.fieldKey);
+                }
+            }
+        });
+
+        this.applyCommonDirectives(this.control, fieldMetadata, modelName);
+
+        return this.control as Control;
+    }
+
+    protected getValue(): any {
+        return this.control ? (this.control as DateTimePicker).getValue() : null;
+    }
+
+    protected applyState(): void {
+        if (this.control && this.metadata) {
+            if (this.isDisplayMode) return;
+            const input = this.control as DateTimePicker;
+            input.setEditable(!this.metadata.ui?.readOnly);
+            input.setRequired(this.metadata.required);
+        }
+    }
+}

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

@@ -0,0 +1,109 @@
+sap.ui.define(["./BasePlugin", "sap/m/Select", "sap/ui/core/Item"], function (___BasePlugin, Select, Item) {
+  "use strict";
+
+  /**
+   * @file DropdownPlugin.ts
+   * @description Renders a sap.m.Select utilizing the schema's valueHelp structure.
+   */
+  const BasePlugin = ___BasePlugin["BasePlugin"];
+  /**
+   * Handles rendering logic for dropdown inputs.
+   * Maps the static `valueHelp` schema array to `sap.ui.core.Item` elements.
+   * 
+   * @namespace nz.co.siliconst.ui5.metaui.plugins.controls
+   * @public
+   */
+  class DropdownPlugin extends BasePlugin {
+    /**
+     * Renders a `sap.m.Select` component populated with schema-defined value help.
+     * 
+     * @param fieldMetadata The specific JSON schema properties for this field.
+     * @param bindingPath The JSON path bound to this control.
+     * @param modelName The UI5 JSONModel name.
+     * @returns {Control} The configured Select control.
+     */
+    render(fieldMetadata, bindingPath, modelName = "meta", engineScopeId, onChange) {
+      this.onChange = onChange;
+      this.metadata = fieldMetadata;
+      if (this.isDisplayMode) {
+        sap.ui.requireSync("sap/m/Text");
+        const TextControl = sap.ui.require("sap/m/Text");
+        const valueHelpArray = fieldMetadata.valueHelp && Array.isArray(fieldMetadata.valueHelp) ? fieldMetadata.valueHelp : fieldMetadata.enum ? fieldMetadata.enum.map(e => ({
+          key: String(e),
+          text: String(e)
+        })) : [];
+        this.control = new TextControl({
+          id: this.generateStableId(engineScopeId, bindingPath),
+          text: {
+            path: `${modelName}>${bindingPath}`,
+            formatter: key => {
+              const match = valueHelpArray.find(vh => vh.key === key);
+              return match ? match.text : key;
+            }
+          }
+        });
+        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,
+        change: oEvent => {
+          const item = oEvent.getParameter("selectedItem");
+          const val = item ? item.getKey() : "";
+          const result = this.validate();
+          if (this.onChange) {
+            this.onChange(result.isValid, this.fieldKey);
+          }
+        }
+      });
+      const valueHelpArray = fieldMetadata.valueHelp && Array.isArray(fieldMetadata.valueHelp) ? fieldMetadata.valueHelp : fieldMetadata.enum ? fieldMetadata.enum.map(e => ({
+        key: String(e),
+        text: String(e)
+      })) : [];
+      if (valueHelpArray.length > 0) {
+        // Always add the empty placeholder so that 'required' checks can actually fire if the user hasn't made a choice
+        select.addItem(new Item({
+          key: "",
+          text: "--- Select ---"
+        }));
+        valueHelpArray.forEach(vh => {
+          select.addItem(new Item({
+            key: vh.key,
+            text: vh.text
+          }));
+        });
+      }
+      this.control = select;
+      this.applyCommonDirectives(this.control, fieldMetadata, modelName);
+      return this.control;
+    }
+
+    /**
+     * Retrieves the currently selected key.
+     * @returns {any} The selected key.
+     */
+    getValue() {
+      return this.control ? this.control.getSelectedKey() : null;
+    }
+
+    /**
+     * Applies dynamic metadata state (e.g. readOnly) when the ConditionEngine fires.
+     */
+    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.DropdownPlugin = DropdownPlugin;
+  return __exports;
+});
+//# sourceMappingURL=DropdownPlugin-dbg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DropdownPlugin-dbg.js","names":["BasePlugin","___BasePlugin","DropdownPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","isDisplayMode","sap","ui","requireSync","TextControl","require","valueHelpArray","valueHelp","Array","isArray","enum","map","e","key","String","text","control","id","generateStableId","path","formatter","match","find","vh","applyCommonDirectives","select","Select","selectedKey","enabled","readOnly","forceSelection","change","oEvent","item","getParameter","val","getKey","result","validate","isValid","fieldKey","length","addItem","Item","forEach","getValue","getSelectedKey","applyState","setEnabled","__exports","__esModule"],"sources":["DropdownPlugin.ts"],"sourcesContent":["/**\n * @file DropdownPlugin.ts\n * @description Renders a sap.m.Select utilizing the schema's valueHelp structure.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Select from \"sap/m/Select\";\nimport Item from \"sap/ui/core/Item\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Handles rendering logic for dropdown inputs.\n * Maps the static `valueHelp` schema array to `sap.ui.core.Item` elements.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.controls\n * @public\n */\nexport class DropdownPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.Select` component populated with schema-defined value help.\n     * \n     * @param fieldMetadata The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @returns {Control} The configured Select control.\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        if (this.isDisplayMode) {\n            sap.ui.requireSync(\"sap/m/Text\");\n            const TextControl = sap.ui.require(\"sap/m/Text\");\n            \n            const valueHelpArray = fieldMetadata.valueHelp && Array.isArray(fieldMetadata.valueHelp) \n                ? fieldMetadata.valueHelp \n                : (fieldMetadata.enum ? fieldMetadata.enum.map(e => ({ key: String(e), text: String(e) })) : []);\n            \n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: {\n                    path: `${modelName}>${bindingPath}`,\n                    formatter: (key: string) => {\n                        const match = valueHelpArray.find(vh => vh.key === key);\n                        return match ? match.text : key;\n                    }\n                }\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            change: (oEvent: sap.ui.base.Event) => {\n                const item = oEvent.getParameter(\"selectedItem\");\n                const val = item ? item.getKey() : \"\";\n                const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n\n        const valueHelpArray = fieldMetadata.valueHelp && Array.isArray(fieldMetadata.valueHelp) \n            ? fieldMetadata.valueHelp \n            : (fieldMetadata.enum ? fieldMetadata.enum.map(e => ({ key: String(e), text: String(e) })) : []);\n\n        if (valueHelpArray.length > 0) {\n            // Always add the empty placeholder so that 'required' checks can actually fire if the user hasn't made a choice\n            select.addItem(new Item({ key: \"\", text: \"--- Select ---\" }));\n            \n            valueHelpArray.forEach(vh => {\n                select.addItem(new Item({ key: vh.key, text: vh.text }));\n            });\n        }\n\n        this.control = select;\n        this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the currently selected key.\n     * @returns {any} The selected key.\n     */\n    protected getValue(): any {\n        return this.control ? (this.control as Select).getSelectedKey() : null;\n    }\n\n    /**\n     * Applies dynamic metadata state (e.g. readOnly) when the ConditionEngine fires.\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,aAAA;EAMnB;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMC,cAAc,SAASF,UAAU,CAAC;IAC3C;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;IACWG,MAAMA,CAACC,aAAgC,EAAGC,WAAmB,EAAGC,SAAiB,GAAG,MAAM,EAAEC,aAAsB,EAAEC,QAAwD,EAAW;MAC1L,IAAI,CAACA,QAAQ,GAAGA,QAAQ;MACxB,IAAI,CAACC,QAAQ,GAAGL,aAAa;MAE7B,IAAI,IAAI,CAACM,aAAa,EAAE;QACpBC,GAAG,CAACC,EAAE,CAACC,WAAW,CAAC,YAAY,CAAC;QAChC,MAAMC,WAAW,GAAGH,GAAG,CAACC,EAAE,CAACG,OAAO,CAAC,YAAY,CAAC;QAEhD,MAAMC,cAAc,GAAGZ,aAAa,CAACa,SAAS,IAAIC,KAAK,CAACC,OAAO,CAACf,aAAa,CAACa,SAAS,CAAC,GAClFb,aAAa,CAACa,SAAS,GACtBb,aAAa,CAACgB,IAAI,GAAGhB,aAAa,CAACgB,IAAI,CAACC,GAAG,CAACC,CAAC,KAAK;UAAEC,GAAG,EAAEC,MAAM,CAACF,CAAC,CAAC;UAAEG,IAAI,EAAED,MAAM,CAACF,CAAC;QAAE,CAAC,CAAC,CAAC,GAAG,EAAG;QAEpG,IAAI,CAACI,OAAO,GAAG,IAAIZ,WAAW,CAAC;UAC3Ba,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAACrB,aAAa,EAAEF,WAAW,CAAC;UACrDoB,IAAI,EAAE;YACFI,IAAI,EAAE,GAAGvB,SAAS,IAAID,WAAW,EAAE;YACnCyB,SAAS,EAAGP,GAAW,IAAK;cACxB,MAAMQ,KAAK,GAAGf,cAAc,CAACgB,IAAI,CAACC,EAAE,IAAIA,EAAE,CAACV,GAAG,KAAKA,GAAG,CAAC;cACvD,OAAOQ,KAAK,GAAGA,KAAK,CAACN,IAAI,GAAGF,GAAG;YACnC;UACJ;QACJ,CAAC,CAAC;QACF,IAAI,CAACW,qBAAqB,CAAC,IAAI,CAACR,OAAO,EAAEtB,aAAa,EAAEE,SAAS,CAAC;QAClE,OAAO,IAAI,CAACoB,OAAO;MACvB;MAEA,MAAMS,MAAM,GAAG,IAAIC,MAAM,CAAC;QACtBT,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAACrB,aAAa,EAAEF,WAAW,CAAC;QACrDgC,WAAW,EAAE,IAAI/B,SAAS,IAAID,WAAW,GAAG;QAC5CiC,OAAO,EAAE,CAAClC,aAAa,CAACQ,EAAE,EAAE2B,QAAQ;QACpCC,cAAc,EAAE,KAAK;QACrBC,MAAM,EAAGC,MAAyB,IAAK;UACnC,MAAMC,IAAI,GAAGD,MAAM,CAACE,YAAY,CAAC,cAAc,CAAC;UAChD,MAAMC,GAAG,GAAGF,IAAI,GAAGA,IAAI,CAACG,MAAM,CAAC,CAAC,GAAG,EAAE;UACrC,MAAMC,MAAM,GAAG,IAAI,CAACC,QAAQ,CAAC,CAAC;UAC9B,IAAI,IAAI,CAACxC,QAAQ,EAAE;YACf,IAAI,CAACA,QAAQ,CAACuC,MAAM,CAACE,OAAO,EAAE,IAAI,CAACC,QAAQ,CAAC;UAChD;QACJ;MACJ,CAAC,CAAC;MAEF,MAAMlC,cAAc,GAAGZ,aAAa,CAACa,SAAS,IAAIC,KAAK,CAACC,OAAO,CAACf,aAAa,CAACa,SAAS,CAAC,GAClFb,aAAa,CAACa,SAAS,GACtBb,aAAa,CAACgB,IAAI,GAAGhB,aAAa,CAACgB,IAAI,CAACC,GAAG,CAACC,CAAC,KAAK;QAAEC,GAAG,EAAEC,MAAM,CAACF,CAAC,CAAC;QAAEG,IAAI,EAAED,MAAM,CAACF,CAAC;MAAE,CAAC,CAAC,CAAC,GAAG,EAAG;MAEpG,IAAIN,cAAc,CAACmC,MAAM,GAAG,CAAC,EAAE;QAC3B;QACAhB,MAAM,CAACiB,OAAO,CAAC,IAAIC,IAAI,CAAC;UAAE9B,GAAG,EAAE,EAAE;UAAEE,IAAI,EAAE;QAAiB,CAAC,CAAC,CAAC;QAE7DT,cAAc,CAACsC,OAAO,CAACrB,EAAE,IAAI;UACzBE,MAAM,CAACiB,OAAO,CAAC,IAAIC,IAAI,CAAC;YAAE9B,GAAG,EAAEU,EAAE,CAACV,GAAG;YAAEE,IAAI,EAAEQ,EAAE,CAACR;UAAK,CAAC,CAAC,CAAC;QAC5D,CAAC,CAAC;MACN;MAEA,IAAI,CAACC,OAAO,GAAGS,MAAM;MACrB,IAAI,CAACD,qBAAqB,CAAC,IAAI,CAACR,OAAO,EAAEtB,aAAa,EAAEE,SAAS,CAAC;MAClE,OAAO,IAAI,CAACoB,OAAO;IACvB;;IAEA;AACJ;AACA;AACA;IACc6B,QAAQA,CAAA,EAAQ;MACtB,OAAO,IAAI,CAAC7B,OAAO,GAAI,IAAI,CAACA,OAAO,CAAY8B,cAAc,CAAC,CAAC,GAAG,IAAI;IAC1E;;IAEA;AACJ;AACA;IACcC,UAAUA,CAAA,EAAS;MACzB,IAAI,IAAI,CAAC/B,OAAO,IAAI,IAAI,CAACjB,QAAQ,EAAE;QAC/B,IAAI,IAAI,CAACC,aAAa,EAAE;QACxB,MAAMyB,MAAM,GAAG,IAAI,CAACT,OAAiB;QACrCS,MAAM,CAACuB,UAAU,CAAC,CAAC,IAAI,CAACjD,QAAQ,CAACG,EAAE,EAAE2B,QAAQ,CAAC;MAClD;IACJ;EACJ;EAAC,IAAAoB,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAzD,cAAA,GAAAA,cAAA;EAAA,OAAAyD,SAAA;AAAA","ignoreList":[]}

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

@@ -0,0 +1,37 @@
+declare module "nz/co/siliconst/ui5/metaui/plugins/controls/DropdownPlugin" {
+    /**
+     * @file DropdownPlugin.ts
+     * @description Renders a sap.m.Select utilizing the schema's valueHelp structure.
+     */
+    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.
+     * Maps the static `valueHelp` schema array to `sap.ui.core.Item` elements.
+     *
+     * @namespace nz.co.siliconst.ui5.metaui.plugins.controls
+     * @public
+     */
+    export class DropdownPlugin extends BasePlugin {
+        /**
+         * Renders a `sap.m.Select` component populated with schema-defined value help.
+         *
+         * @param fieldMetadata The specific JSON schema properties for this field.
+         * @param bindingPath The JSON path bound to this control.
+         * @param modelName The UI5 JSONModel name.
+         * @returns {Control} The configured Select control.
+         */
+        render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control;
+        /**
+         * Retrieves the currently selected key.
+         * @returns {any} The selected key.
+         */
+        protected getValue(): any;
+        /**
+         * Applies dynamic metadata state (e.g. readOnly) when the ConditionEngine fires.
+         */
+        protected applyState(): void;
+    }
+}
+//# sourceMappingURL=DropdownPlugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DropdownPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/DropdownPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,4DAA4D,CAAC;IAC5E;;;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,cAAe,SAAQ,UAAU;QAC1C;;;;;;;WAOG;QACI,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAG,WAAW,EAAE,MAAM,EAAG,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;QA2D7L;;;WAGG;QACH,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB;;WAEG;QACH,SAAS,CAAC,UAAU,IAAI,IAAI;KAO/B;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/DropdownPlugin.js

@@ -0,0 +1,2 @@
+sap.ui.define(["./BasePlugin","sap/m/Select","sap/ui/core/Item"],function(e,t,n){"use strict";const i=e["BasePlugin"];class a extends i{render(e,i,a="meta",s,r){this.onChange=r;this.metadata=e;if(this.isDisplayMode){sap.ui.requireSync("sap/m/Text");const t=sap.ui.require("sap/m/Text");const n=e.valueHelp&&Array.isArray(e.valueHelp)?e.valueHelp:e.enum?e.enum.map(e=>({key:String(e),text:String(e)})):[];this.control=new t({id:this.generateStableId(s,i),text:{path:`${a}>${i}`,formatter:e=>{const t=n.find(t=>t.key===e);return t?t.text:e}}});this.applyCommonDirectives(this.control,e,a);return this.control}const l=new t({id:this.generateStableId(s,i),selectedKey:`{${a}>${i}}`,enabled:!e.ui?.readOnly,forceSelection:false,change:e=>{const t=e.getParameter("selectedItem");const n=t?t.getKey():"";const i=this.validate();if(this.onChange){this.onChange(i.isValid,this.fieldKey)}}});const o=e.valueHelp&&Array.isArray(e.valueHelp)?e.valueHelp:e.enum?e.enum.map(e=>({key:String(e),text:String(e)})):[];if(o.length>0){l.addItem(new n({key:"",text:"--- Select ---"}));o.forEach(e=>{l.addItem(new n({key:e.key,text:e.text}))})}this.control=l;this.applyCommonDirectives(this.control,e,a);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 s={__esModule:true};s.DropdownPlugin=a;return s});
+//# sourceMappingURL=DropdownPlugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DropdownPlugin.js","names":["BasePlugin","___BasePlugin","DropdownPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","this","metadata","isDisplayMode","sap","ui","requireSync","TextControl","require","valueHelpArray","valueHelp","Array","isArray","enum","map","e","key","String","text","control","id","generateStableId","path","formatter","match","find","vh","applyCommonDirectives","select","Select","selectedKey","enabled","readOnly","forceSelection","change","oEvent","item","getParameter","val","getKey","result","validate","isValid","fieldKey","length","addItem","Item","forEach","getValue","getSelectedKey","applyState","setEnabled","__exports","__esModule"],"sources":["DropdownPlugin.ts"],"sourcesContent":["/**\n * @file DropdownPlugin.ts\n * @description Renders a sap.m.Select utilizing the schema's valueHelp structure.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Select from \"sap/m/Select\";\nimport Item from \"sap/ui/core/Item\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Handles rendering logic for dropdown inputs.\n * Maps the static `valueHelp` schema array to `sap.ui.core.Item` elements.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.controls\n * @public\n */\nexport class DropdownPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.Select` component populated with schema-defined value help.\n     * \n     * @param fieldMetadata The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @returns {Control} The configured Select control.\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        if (this.isDisplayMode) {\n            sap.ui.requireSync(\"sap/m/Text\");\n            const TextControl = sap.ui.require(\"sap/m/Text\");\n            \n            const valueHelpArray = fieldMetadata.valueHelp && Array.isArray(fieldMetadata.valueHelp) \n                ? fieldMetadata.valueHelp \n                : (fieldMetadata.enum ? fieldMetadata.enum.map(e => ({ key: String(e), text: String(e) })) : []);\n            \n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: {\n                    path: `${modelName}>${bindingPath}`,\n                    formatter: (key: string) => {\n                        const match = valueHelpArray.find(vh => vh.key === key);\n                        return match ? match.text : key;\n                    }\n                }\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            change: (oEvent: sap.ui.base.Event) => {\n                const item = oEvent.getParameter(\"selectedItem\");\n                const val = item ? item.getKey() : \"\";\n                const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n\n        const valueHelpArray = fieldMetadata.valueHelp && Array.isArray(fieldMetadata.valueHelp) \n            ? fieldMetadata.valueHelp \n            : (fieldMetadata.enum ? fieldMetadata.enum.map(e => ({ key: String(e), text: String(e) })) : []);\n\n        if (valueHelpArray.length > 0) {\n            // Always add the empty placeholder so that 'required' checks can actually fire if the user hasn't made a choice\n            select.addItem(new Item({ key: \"\", text: \"--- Select ---\" }));\n            \n            valueHelpArray.forEach(vh => {\n                select.addItem(new Item({ key: vh.key, text: vh.text }));\n            });\n        }\n\n        this.control = select;\n        this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the currently selected key.\n     * @returns {any} The selected key.\n     */\n    protected getValue(): any {\n        return this.control ? (this.control as Select).getSelectedKey() : null;\n    }\n\n    /**\n     * Applies dynamic metadata state (e.g. readOnly) when the ConditionEngine fires.\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":"8FAAA,MAKSA,EAAUC,EAAA,cAaZ,MAAMC,UAAuBF,EASzBG,OAAOC,EAAmCC,EAAsBC,EAAoB,OAAQC,EAAwBC,GACvHC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAEhB,GAAIK,KAAKE,cAAe,CACpBC,IAAIC,GAAGC,YAAY,cACnB,MAAMC,EAAcH,IAAIC,GAAGG,QAAQ,cAEnC,MAAMC,EAAiBb,EAAcc,WAAaC,MAAMC,QAAQhB,EAAcc,WACxEd,EAAcc,UACbd,EAAciB,KAAOjB,EAAciB,KAAKC,IAAIC,IAAC,CAAOC,IAAKC,OAAOF,GAAIG,KAAMD,OAAOF,MAAS,GAEjGd,KAAKkB,QAAU,IAAIZ,EAAY,CAC3Ba,GAAInB,KAAKoB,iBAAiBtB,EAAeF,GACzCqB,KAAM,CACFI,KAAM,GAAGxB,KAAaD,IACtB0B,UAAYP,IACR,MAAMQ,EAAQf,EAAegB,KAAKC,GAAMA,EAAGV,MAAQA,GACnD,OAAOQ,EAAQA,EAAMN,KAAOF,MAIxCf,KAAK0B,sBAAsB1B,KAAKkB,QAASvB,EAAeE,GACxD,OAAOG,KAAKkB,OAChB,CAEA,MAAMS,EAAS,IAAIC,EAAO,CACtBT,GAAInB,KAAKoB,iBAAiBtB,EAAeF,GACzCiC,YAAa,IAAIhC,KAAaD,KAC9BkC,SAAUnC,EAAcS,IAAI2B,SAC5BC,eAAgB,MAChBC,OAASC,IACL,MAAMC,EAAOD,EAAOE,aAAa,gBACjC,MAAMC,EAAMF,EAAOA,EAAKG,SAAW,GACnC,MAAMC,EAASvC,KAAKwC,WACpB,GAAIxC,KAAKD,SAAU,CACfC,KAAKD,SAASwC,EAAOE,QAASzC,KAAK0C,SACvC,KAIR,MAAMlC,EAAiBb,EAAcc,WAAaC,MAAMC,QAAQhB,EAAcc,WACxEd,EAAcc,UACbd,EAAciB,KAAOjB,EAAciB,KAAKC,IAAIC,IAAC,CAAOC,IAAKC,OAAOF,GAAIG,KAAMD,OAAOF,MAAS,GAEjG,GAAIN,EAAemC,OAAS,EAAG,CAE3BhB,EAAOiB,QAAQ,IAAIC,EAAK,CAAE9B,IAAK,GAAIE,KAAM,oBAEzCT,EAAesC,QAAQrB,IACnBE,EAAOiB,QAAQ,IAAIC,EAAK,CAAE9B,IAAKU,EAAGV,IAAKE,KAAMQ,EAAGR,SAExD,CAEAjB,KAAKkB,QAAUS,EACf3B,KAAK0B,sBAAsB1B,KAAKkB,QAASvB,EAAeE,GACxD,OAAOG,KAAKkB,OAChB,CAMU6B,WACN,OAAO/C,KAAKkB,QAAWlB,KAAKkB,QAAmB8B,iBAAmB,IACtE,CAKUC,aACN,GAAIjD,KAAKkB,SAAWlB,KAAKC,SAAU,CAC/B,GAAID,KAAKE,cAAe,OACxB,MAAMyB,EAAS3B,KAAKkB,QACpBS,EAAOuB,YAAYlD,KAAKC,SAASG,IAAI2B,SACzC,CACJ,EACH,IAAAoB,EAAA,CAAAC,WAAA,MAAAD,EAAA1D,iBAAA,OAAA0D,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/DropdownPlugin.ts

@@ -0,0 +1,105 @@
+/**
+ * @file DropdownPlugin.ts
+ * @description Renders a sap.m.Select utilizing the schema's valueHelp structure.
+ */
+
+import { BasePlugin } from "./BasePlugin";
+import { IPropertyMetadata } from "../../interfaces/ISchema";
+import Select from "sap/m/Select";
+import Item from "sap/ui/core/Item";
+import Control from "sap/ui/core/Control";
+
+/**
+ * Handles rendering logic for dropdown inputs.
+ * Maps the static `valueHelp` schema array to `sap.ui.core.Item` elements.
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.plugins.controls
+ * @public
+ */
+export class DropdownPlugin extends BasePlugin {
+    /**
+     * Renders a `sap.m.Select` component populated with schema-defined value help.
+     * 
+     * @param fieldMetadata The specific JSON schema properties for this field.
+     * @param bindingPath The JSON path bound to this control.
+     * @param modelName The UI5 JSONModel name.
+     * @returns {Control} The configured Select control.
+     */
+    public render(fieldMetadata: IPropertyMetadata,  bindingPath: string,  modelName: string = "meta", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {
+        this.onChange = onChange;
+        this.metadata = fieldMetadata;
+        
+        if (this.isDisplayMode) {
+            sap.ui.requireSync("sap/m/Text");
+            const TextControl = sap.ui.require("sap/m/Text");
+            
+            const valueHelpArray = fieldMetadata.valueHelp && Array.isArray(fieldMetadata.valueHelp) 
+                ? fieldMetadata.valueHelp 
+                : (fieldMetadata.enum ? fieldMetadata.enum.map(e => ({ key: String(e), text: String(e) })) : []);
+            
+            this.control = new TextControl({
+                id: this.generateStableId(engineScopeId, bindingPath),
+                text: {
+                    path: `${modelName}>${bindingPath}`,
+                    formatter: (key: string) => {
+                        const match = valueHelpArray.find(vh => vh.key === key);
+                        return match ? match.text : key;
+                    }
+                }
+            });
+            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,
+            change: (oEvent: sap.ui.base.Event) => {
+                const item = oEvent.getParameter("selectedItem");
+                const val = item ? item.getKey() : "";
+                const result = this.validate();
+                if (this.onChange) {
+                    this.onChange(result.isValid, this.fieldKey);
+                }
+            }
+        });
+
+        const valueHelpArray = fieldMetadata.valueHelp && Array.isArray(fieldMetadata.valueHelp) 
+            ? fieldMetadata.valueHelp 
+            : (fieldMetadata.enum ? fieldMetadata.enum.map(e => ({ key: String(e), text: String(e) })) : []);
+
+        if (valueHelpArray.length > 0) {
+            // Always add the empty placeholder so that 'required' checks can actually fire if the user hasn't made a choice
+            select.addItem(new Item({ key: "", text: "--- Select ---" }));
+            
+            valueHelpArray.forEach(vh => {
+                select.addItem(new Item({ key: vh.key, text: vh.text }));
+            });
+        }
+
+        this.control = select;
+        this.applyCommonDirectives(this.control, fieldMetadata, modelName);
+        return this.control as Control;
+    }
+
+    /**
+     * Retrieves the currently selected key.
+     * @returns {any} The selected key.
+     */
+    protected getValue(): any {
+        return this.control ? (this.control as Select).getSelectedKey() : null;
+    }
+
+    /**
+     * Applies dynamic metadata state (e.g. readOnly) when the ConditionEngine fires.
+     */
+    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/controls/FileUploaderPlugin-dbg.js

@@ -0,0 +1,65 @@
+sap.ui.define(["./BasePlugin", "sap/ui/unified/FileUploader"], function (___BasePlugin, FileUploader) {
+  "use strict";
+
+  /**
+   * @file FileUploaderPlugin.ts
+   * @description Renders a sap.ui.unified.FileUploader.
+   */
+  const BasePlugin = ___BasePlugin["BasePlugin"];
+  /**
+   * Handles rendering logic for file uploads.
+   * 
+   * @namespace nz.co.siliconst.ui5.metaui.plugins.controls
+   * @public
+   */
+  class FileUploaderPlugin extends BasePlugin {
+    render(fieldMetadata, bindingPath, modelName = "meta", engineScopeId, onChange) {
+      this.onChange = onChange;
+      this.metadata = fieldMetadata;
+      if (this.isDisplayMode) {
+        sap.ui.requireSync("sap/m/Link");
+        const LinkControl = sap.ui.require("sap/m/Link");
+        this.control = new LinkControl({
+          id: this.generateStableId(engineScopeId, bindingPath),
+          text: `{${modelName}>${bindingPath}}`,
+          href: `{${modelName}>${bindingPath}}`,
+          // Assuming the value is a URL to the file
+          target: "_blank"
+        });
+        this.applyCommonDirectives(this.control, fieldMetadata, modelName);
+        return this.control;
+      }
+      this.control = new FileUploader({
+        id: this.generateStableId(engineScopeId, bindingPath),
+        value: `{${modelName}>${bindingPath}}`,
+        enabled: !fieldMetadata.ui?.readOnly,
+        placeholder: fieldMetadata.ui?.label || "Choose a file...",
+        width: "100%",
+        change: oEvent => {
+          const val = oEvent.getParameter("newValue");
+          const result = this.validate();
+          if (this.onChange) {
+            this.onChange(result.isValid, this.fieldKey);
+          }
+        }
+      });
+      this.applyCommonDirectives(this.control, fieldMetadata, modelName);
+      return this.control;
+    }
+    getValue() {
+      return this.control ? this.control.getValue() : null;
+    }
+    applyState() {
+      if (this.control && this.metadata) {
+        if (this.isDisplayMode) return;
+        this.control.setEnabled(!this.metadata.ui?.readOnly);
+      }
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.FileUploaderPlugin = FileUploaderPlugin;
+  return __exports;
+});
+//# sourceMappingURL=FileUploaderPlugin-dbg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FileUploaderPlugin-dbg.js","names":["BasePlugin","___BasePlugin","FileUploaderPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","isDisplayMode","sap","ui","requireSync","LinkControl","require","control","id","generateStableId","text","href","target","applyCommonDirectives","FileUploader","value","enabled","readOnly","placeholder","label","width","change","oEvent","val","getParameter","result","validate","isValid","fieldKey","getValue","applyState","setEnabled","__exports","__esModule"],"sources":["FileUploaderPlugin.ts"],"sourcesContent":["/**\n * @file FileUploaderPlugin.ts\n * @description Renders a sap.ui.unified.FileUploader.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport FileUploader from \"sap/ui/unified/FileUploader\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Handles rendering logic for file uploads.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.controls\n * @public\n */\nexport class FileUploaderPlugin extends BasePlugin {\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        if (this.isDisplayMode) {\n            sap.ui.requireSync(\"sap/m/Link\");\n            const LinkControl = sap.ui.require(\"sap/m/Link\");\n            this.control = new LinkControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: `{${modelName}>${bindingPath}}`,\n                href: `{${modelName}>${bindingPath}}`, // Assuming the value is a URL to the file\n                target: \"_blank\"\n            });\n            this.applyCommonDirectives(this.control, fieldMetadata, modelName);\n            return this.control as Control;\n        }\n\n        this.control = new FileUploader({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            value: `{${modelName}>${bindingPath}}`,\n            enabled: !fieldMetadata.ui?.readOnly,\n            placeholder: fieldMetadata.ui?.label || \"Choose a file...\",\n            width: \"100%\",\n            change: (oEvent: sap.ui.base.Event) => {\n                const val = oEvent.getParameter(\"newValue\");\n                const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n\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 FileUploader).getValue() : null;\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (this.isDisplayMode) return;\n            (this.control as FileUploader).setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;EAHA,MAKSA,UAAU,GAAAC,aAAA;EAKnB;AACA;AACA;AACA;AACA;AACA;EACO,MAAMC,kBAAkB,SAASF,UAAU,CAAC;IACxCG,MAAMA,CAACC,aAAgC,EAAGC,WAAmB,EAAGC,SAAiB,GAAG,MAAM,EAAEC,aAAsB,EAAEC,QAAwD,EAAW;MAC1L,IAAI,CAACA,QAAQ,GAAGA,QAAQ;MACxB,IAAI,CAACC,QAAQ,GAAGL,aAAa;MAE7B,IAAI,IAAI,CAACM,aAAa,EAAE;QACpBC,GAAG,CAACC,EAAE,CAACC,WAAW,CAAC,YAAY,CAAC;QAChC,MAAMC,WAAW,GAAGH,GAAG,CAACC,EAAE,CAACG,OAAO,CAAC,YAAY,CAAC;QAChD,IAAI,CAACC,OAAO,GAAG,IAAIF,WAAW,CAAC;UAC3BG,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAACX,aAAa,EAAEF,WAAW,CAAC;UACrDc,IAAI,EAAE,IAAIb,SAAS,IAAID,WAAW,GAAG;UACrCe,IAAI,EAAE,IAAId,SAAS,IAAID,WAAW,GAAG;UAAE;UACvCgB,MAAM,EAAE;QACZ,CAAC,CAAC;QACF,IAAI,CAACC,qBAAqB,CAAC,IAAI,CAACN,OAAO,EAAEZ,aAAa,EAAEE,SAAS,CAAC;QAClE,OAAO,IAAI,CAACU,OAAO;MACvB;MAEA,IAAI,CAACA,OAAO,GAAG,IAAIO,YAAY,CAAC;QAC5BN,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAACX,aAAa,EAAEF,WAAW,CAAC;QACrDmB,KAAK,EAAE,IAAIlB,SAAS,IAAID,WAAW,GAAG;QACtCoB,OAAO,EAAE,CAACrB,aAAa,CAACQ,EAAE,EAAEc,QAAQ;QACpCC,WAAW,EAAEvB,aAAa,CAACQ,EAAE,EAAEgB,KAAK,IAAI,kBAAkB;QAC1DC,KAAK,EAAE,MAAM;QACbC,MAAM,EAAGC,MAAyB,IAAK;UACnC,MAAMC,GAAG,GAAGD,MAAM,CAACE,YAAY,CAAC,UAAU,CAAC;UAC3C,MAAMC,MAAM,GAAG,IAAI,CAACC,QAAQ,CAAC,CAAC;UAC9B,IAAI,IAAI,CAAC3B,QAAQ,EAAE;YACf,IAAI,CAACA,QAAQ,CAAC0B,MAAM,CAACE,OAAO,EAAE,IAAI,CAACC,QAAQ,CAAC;UAChD;QACJ;MACJ,CAAC,CAAC;MAEF,IAAI,CAACf,qBAAqB,CAAC,IAAI,CAACN,OAAO,EAAEZ,aAAa,EAAEE,SAAS,CAAC;MAClE,OAAO,IAAI,CAACU,OAAO;IACvB;IAEUsB,QAAQA,CAAA,EAAQ;MACtB,OAAO,IAAI,CAACtB,OAAO,GAAI,IAAI,CAACA,OAAO,CAAkBsB,QAAQ,CAAC,CAAC,GAAG,IAAI;IAC1E;IAEUC,UAAUA,CAAA,EAAS;MACzB,IAAI,IAAI,CAACvB,OAAO,IAAI,IAAI,CAACP,QAAQ,EAAE;QAC/B,IAAI,IAAI,CAACC,aAAa,EAAE;QACvB,IAAI,CAACM,OAAO,CAAkBwB,UAAU,CAAC,CAAC,IAAI,CAAC/B,QAAQ,CAACG,EAAE,EAAEc,QAAQ,CAAC;MAC1E;IACJ;EACJ;EAAC,IAAAe,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAvC,kBAAA,GAAAA,kBAAA;EAAA,OAAAuC,SAAA;AAAA","ignoreList":[]}

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

@@ -0,0 +1,21 @@
+declare module "nz/co/siliconst/ui5/metaui/plugins/controls/FileUploaderPlugin" {
+    /**
+     * @file FileUploaderPlugin.ts
+     * @description Renders a sap.ui.unified.FileUploader.
+     */
+    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 file uploads.
+     *
+     * @namespace nz.co.siliconst.ui5.metaui.plugins.controls
+     * @public
+     */
+    export class FileUploaderPlugin 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=FileUploaderPlugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FileUploaderPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/FileUploaderPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,gEAAgE,CAAC;IAChF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAElF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAE1C;;;;;OAKG;IACH,MAAa,kBAAmB,SAAQ,UAAU;QACvC,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAG,WAAW,EAAE,MAAM,EAAG,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;QAoC7L,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB,SAAS,CAAC,UAAU,IAAI,IAAI;KAM/B;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/FileUploaderPlugin.js

@@ -0,0 +1,2 @@
+sap.ui.define(["./BasePlugin","sap/ui/unified/FileUploader"],function(e,t){"use strict";const i=e["BasePlugin"];class a extends i{render(e,i,a="meta",n,s){this.onChange=s;this.metadata=e;if(this.isDisplayMode){sap.ui.requireSync("sap/m/Link");const t=sap.ui.require("sap/m/Link");this.control=new t({id:this.generateStableId(n,i),text:`{${a}>${i}}`,href:`{${a}>${i}}`,target:"_blank"});this.applyCommonDirectives(this.control,e,a);return this.control}this.control=new t({id:this.generateStableId(n,i),value:`{${a}>${i}}`,enabled:!e.ui?.readOnly,placeholder:e.ui?.label||"Choose a file...",width:"100%",change:e=>{const t=e.getParameter("newValue");const i=this.validate();if(this.onChange){this.onChange(i.isValid,this.fieldKey)}}});this.applyCommonDirectives(this.control,e,a);return this.control}getValue(){return this.control?this.control.getValue():null}applyState(){if(this.control&&this.metadata){if(this.isDisplayMode)return;this.control.setEnabled(!this.metadata.ui?.readOnly)}}}var n={__esModule:true};n.FileUploaderPlugin=a;return n});
+//# sourceMappingURL=FileUploaderPlugin.js.map