@siliconst/metaui 1.4.6 → 1.4.7

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

@@ -10,8 +10,25 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/controls/DateTimePlugin" {
      * Handles rendering and logic for timestamps/datetime inputs.
      */
     export class DateTimePlugin extends BasePlugin {
+        /**
+         * Renders a `sap.m.DateTimePicker` component.
+         *
+         * @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.
+         * @param engineScopeId The deterministic scope ID.
+         * @param onChange The callback fired on value change.
+         * @returns {Control} The configured DateTimePicker control.
+         */
         render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control;
+        /**
+         * Retrieves the current datetime string.
+         * @returns {any} The datetime value.
+         */
         protected getValue(): any;
+        /**
+         * Applies dynamic read-only state.
+         */
         protected applyState(): void;
     }
 }

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

@@ -1 +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"}
+{"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;QAC1C;;;;;;;;;WASG;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;QAgD7L;;;WAGG;QACH,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB;;WAEG;QACH,SAAS,CAAC,UAAU,IAAI,IAAI;KAQ/B;CAEA"}

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

@@ -1 +1 @@
-{"version":3,"file":"DateTimePlugin.js","names":["BasePlugin","___BasePlugin","DateTimePlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","this","metadata","isEditable","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.isEditable) {\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.isEditable) 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,IAAKK,KAAKE,WAAY,CAClBC,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,IAAKD,KAAKE,WAAY,OACtB,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":[]}
+{"version":3,"file":"DateTimePlugin.js","names":["BasePlugin","___BasePlugin","DateTimePlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","this","metadata","isEditable","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    /**\n     * Renders a `sap.m.DateTimePicker` component.\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     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured DateTimePicker 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.isEditable) {\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    /**\n     * Retrieves the current datetime string.\n     * @returns {any} The datetime value.\n     */\n    protected getValue(): any {\n        return this.control ? (this.control as DateTimePicker).getValue() : null;\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (!this.isEditable) 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,EAWzBG,OAAOC,EAAmCC,EAAsBC,EAAoB,OAAQC,EAAwBC,GACvHC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAEhB,IAAKK,KAAKE,WAAY,CAClBC,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,CAMUuB,WACN,OAAO/B,KAAKQ,QAAWR,KAAKQ,QAA2BuB,WAAa,IACxE,CAKUC,aACN,GAAIhC,KAAKQ,SAAWR,KAAKC,SAAU,CAC/B,IAAKD,KAAKE,WAAY,OACtB,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

@@ -12,6 +12,16 @@ import Control from "sap/ui/core/Control";
  * Handles rendering and logic for timestamps/datetime inputs.
  */
 export class DateTimePlugin extends BasePlugin {
+    /**
+     * Renders a `sap.m.DateTimePicker` component.
+     * 
+     * @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.
+     * @param engineScopeId The deterministic scope ID.
+     * @param onChange The callback fired on value change.
+     * @returns {Control} The configured DateTimePicker 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;
@@ -60,10 +70,17 @@ export class DateTimePlugin extends BasePlugin {
         return this.control as Control;
     }
 
+    /**
+     * Retrieves the current datetime string.
+     * @returns {any} The datetime value.
+     */
     protected getValue(): any {
         return this.control ? (this.control as DateTimePicker).getValue() : null;
     }
 
+    /**
+     * Applies dynamic read-only state.
+     */
     protected applyState(): void {
         if (this.control && this.metadata) {
             if (!this.isEditable) return;

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

@@ -20,6 +20,8 @@ sap.ui.define(["./BasePlugin", "sap/m/Select", "sap/ui/core/Item"], function (__
      * @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.
+     * @param engineScopeId The deterministic scope ID.
+     * @param onChange The callback fired on value change.
      * @returns {Control} The configured Select control.
      */
     render(fieldMetadata, bindingPath, modelName = "meta", engineScopeId, onChange) {

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

@@ -1 +1 @@
-{"version":3,"file":"DropdownPlugin-dbg.js","names":["BasePlugin","___BasePlugin","DropdownPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","isEditable","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.isEditable) {\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.isEditable) return;\n            const select = this.control as Select;\n            select.setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"DropdownPlugin-dbg.js","names":["BasePlugin","___BasePlugin","DropdownPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","isEditable","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     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\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.isEditable) {\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.isEditable) 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;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,CAAC,IAAI,CAACM,UAAU,EAAE;QAClBC,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,CAAC,IAAI,CAACC,UAAU,EAAE;QACtB,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

@@ -20,6 +20,8 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/controls/DropdownPlugin" {
          * @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.
+         * @param engineScopeId The deterministic scope ID.
+         * @param onChange The callback fired on value change.
          * @returns {Control} The configured Select control.
          */
         render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control;

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

@@ -1 +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"}
+{"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;;;;;;;;;WASG;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.map

@@ -1 +1 @@
-{"version":3,"file":"DropdownPlugin.js","names":["BasePlugin","___BasePlugin","DropdownPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","this","metadata","isEditable","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.isEditable) {\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.isEditable) 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,IAAKK,KAAKE,WAAY,CAClBC,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,IAAKD,KAAKE,WAAY,OACtB,MAAMyB,EAAS3B,KAAKkB,QACpBS,EAAOuB,YAAYlD,KAAKC,SAASG,IAAI2B,SACzC,CACJ,EACH,IAAAoB,EAAA,CAAAC,WAAA,MAAAD,EAAA1D,iBAAA,OAAA0D,CAAA","ignoreList":[]}
+{"version":3,"file":"DropdownPlugin.js","names":["BasePlugin","___BasePlugin","DropdownPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","this","metadata","isEditable","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     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\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.isEditable) {\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.isEditable) 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,EAWzBG,OAAOC,EAAmCC,EAAsBC,EAAoB,OAAQC,EAAwBC,GACvHC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAEhB,IAAKK,KAAKE,WAAY,CAClBC,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,IAAKD,KAAKE,WAAY,OACtB,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

@@ -23,6 +23,8 @@ export class DropdownPlugin extends BasePlugin {
      * @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.
+     * @param engineScopeId The deterministic scope ID.
+     * @param onChange The callback fired on value change.
      * @returns {Control} The configured Select control.
      */
     public render(fieldMetadata: IPropertyMetadata,  bindingPath: string,  modelName: string = "meta", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {

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

@@ -13,6 +13,16 @@ sap.ui.define(["./BasePlugin", "sap/ui/unified/FileUploader"], function (___Base
    * @public
    */
   class FileUploaderPlugin extends BasePlugin {
+    /**
+     * Renders a `sap.ui.unified.FileUploader` component.
+     * 
+     * @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.
+     * @param engineScopeId The deterministic scope ID.
+     * @param onChange The callback fired on value change.
+     * @returns {Control} The configured FileUploader control.
+     */
     render(fieldMetadata, bindingPath, modelName = "meta", engineScopeId, onChange) {
       this.onChange = onChange;
       this.metadata = fieldMetadata;
@@ -46,9 +56,18 @@ sap.ui.define(["./BasePlugin", "sap/ui/unified/FileUploader"], function (___Base
       this.applyCommonDirectives(this.control, fieldMetadata, modelName);
       return this.control;
     }
+
+    /**
+     * Retrieves the current file path.
+     * @returns {any} The file value.
+     */
     getValue() {
       return this.control ? this.control.getValue() : null;
     }
+
+    /**
+     * Applies dynamic read-only state.
+     */
     applyState() {
       if (this.control && this.metadata) {
         if (!this.isEditable) return;

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

@@ -1 +1 @@
-{"version":3,"file":"FileUploaderPlugin-dbg.js","names":["BasePlugin","___BasePlugin","FileUploaderPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","isEditable","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.isEditable) {\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.isEditable) 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,CAAC,IAAI,CAACM,UAAU,EAAE;QAClBC,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,CAAC,IAAI,CAACC,UAAU,EAAE;QACrB,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":[]}
+{"version":3,"file":"FileUploaderPlugin-dbg.js","names":["BasePlugin","___BasePlugin","FileUploaderPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","isEditable","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    /**\n     * Renders a `sap.ui.unified.FileUploader` component.\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     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured FileUploader 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.isEditable) {\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    /**\n     * Retrieves the current file path.\n     * @returns {any} The file value.\n     */\n    protected getValue(): any {\n        return this.control ? (this.control as FileUploader).getValue() : null;\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (!this.isEditable) 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;IAC/C;AACJ;AACA;AACA;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,CAAC,IAAI,CAACM,UAAU,EAAE;QAClBC,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;;IAEA;AACJ;AACA;AACA;IACcsB,QAAQA,CAAA,EAAQ;MACtB,OAAO,IAAI,CAACtB,OAAO,GAAI,IAAI,CAACA,OAAO,CAAkBsB,QAAQ,CAAC,CAAC,GAAG,IAAI;IAC1E;;IAEA;AACJ;AACA;IACcC,UAAUA,CAAA,EAAS;MACzB,IAAI,IAAI,CAACvB,OAAO,IAAI,IAAI,CAACP,QAAQ,EAAE;QAC/B,IAAI,CAAC,IAAI,CAACC,UAAU,EAAE;QACrB,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

@@ -13,8 +13,25 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/controls/FileUploaderPlugin"
      * @public
      */
     export class FileUploaderPlugin extends BasePlugin {
+        /**
+         * Renders a `sap.ui.unified.FileUploader` component.
+         *
+         * @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.
+         * @param engineScopeId The deterministic scope ID.
+         * @param onChange The callback fired on value change.
+         * @returns {Control} The configured FileUploader control.
+         */
         render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control;
+        /**
+         * Retrieves the current file path.
+         * @returns {any} The file value.
+         */
         protected getValue(): any;
+        /**
+         * Applies dynamic read-only state.
+         */
         protected applyState(): void;
     }
 }

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

@@ -1 +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"}
+{"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;QAC9C;;;;;;;;;WASG;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;QAoC7L;;;WAGG;QACH,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB;;WAEG;QACH,SAAS,CAAC,UAAU,IAAI,IAAI;KAM/B;CAEA"}

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

@@ -1 +1 @@
-{"version":3,"file":"FileUploaderPlugin.js","names":["BasePlugin","___BasePlugin","FileUploaderPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","this","metadata","isEditable","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.isEditable) {\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.isEditable) return;\n            (this.control as FileUploader).setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"wFAAA,MAKSA,EAAUC,EAAA,cAWZ,MAAMC,UAA2BF,EAC7BG,OAAOC,EAAmCC,EAAsBC,EAAoB,OAAQC,EAAwBC,GACvHC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAEhB,IAAKK,KAAKE,WAAY,CAClBC,IAAIC,GAAGC,YAAY,cACnB,MAAMC,EAAcH,IAAIC,GAAGG,QAAQ,cACnCP,KAAKQ,QAAU,IAAIF,EAAY,CAC3BG,GAAIT,KAAKU,iBAAiBZ,EAAeF,GACzCe,KAAM,IAAId,KAAaD,KACvBgB,KAAM,IAAIf,KAAaD,KACvBiB,OAAQ,WAEZb,KAAKc,sBAAsBd,KAAKQ,QAASb,EAAeE,GACxD,OAAOG,KAAKQ,OAChB,CAEAR,KAAKQ,QAAU,IAAIO,EAAa,CAC5BN,GAAIT,KAAKU,iBAAiBZ,EAAeF,GACzCoB,MAAO,IAAInB,KAAaD,KACxBqB,SAAUtB,EAAcS,IAAIc,SAC5BC,YAAaxB,EAAcS,IAAIgB,OAAS,mBACxCC,MAAO,OACPC,OAASC,IACL,MAAMC,EAAMD,EAAOE,aAAa,YAChC,MAAMC,EAAS1B,KAAK2B,WACpB,GAAI3B,KAAKD,SAAU,CACfC,KAAKD,SAAS2B,EAAOE,QAAS5B,KAAK6B,SACvC,KAIR7B,KAAKc,sBAAsBd,KAAKQ,QAASb,EAAeE,GACxD,OAAOG,KAAKQ,OAChB,CAEUsB,WACN,OAAO9B,KAAKQ,QAAWR,KAAKQ,QAAyBsB,WAAa,IACtE,CAEUC,aACN,GAAI/B,KAAKQ,SAAWR,KAAKC,SAAU,CAC/B,IAAKD,KAAKE,WAAY,OACrBF,KAAKQ,QAAyBwB,YAAYhC,KAAKC,SAASG,IAAIc,SACjE,CACJ,EACH,IAAAe,EAAA,CAAAC,WAAA,MAAAD,EAAAxC,qBAAA,OAAAwC,CAAA","ignoreList":[]}
+{"version":3,"file":"FileUploaderPlugin.js","names":["BasePlugin","___BasePlugin","FileUploaderPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","this","metadata","isEditable","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    /**\n     * Renders a `sap.ui.unified.FileUploader` component.\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     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured FileUploader 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.isEditable) {\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    /**\n     * Retrieves the current file path.\n     * @returns {any} The file value.\n     */\n    protected getValue(): any {\n        return this.control ? (this.control as FileUploader).getValue() : null;\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (!this.isEditable) return;\n            (this.control as FileUploader).setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"wFAAA,MAKSA,EAAUC,EAAA,cAWZ,MAAMC,UAA2BF,EAW7BG,OAAOC,EAAmCC,EAAsBC,EAAoB,OAAQC,EAAwBC,GACvHC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAEhB,IAAKK,KAAKE,WAAY,CAClBC,IAAIC,GAAGC,YAAY,cACnB,MAAMC,EAAcH,IAAIC,GAAGG,QAAQ,cACnCP,KAAKQ,QAAU,IAAIF,EAAY,CAC3BG,GAAIT,KAAKU,iBAAiBZ,EAAeF,GACzCe,KAAM,IAAId,KAAaD,KACvBgB,KAAM,IAAIf,KAAaD,KACvBiB,OAAQ,WAEZb,KAAKc,sBAAsBd,KAAKQ,QAASb,EAAeE,GACxD,OAAOG,KAAKQ,OAChB,CAEAR,KAAKQ,QAAU,IAAIO,EAAa,CAC5BN,GAAIT,KAAKU,iBAAiBZ,EAAeF,GACzCoB,MAAO,IAAInB,KAAaD,KACxBqB,SAAUtB,EAAcS,IAAIc,SAC5BC,YAAaxB,EAAcS,IAAIgB,OAAS,mBACxCC,MAAO,OACPC,OAASC,IACL,MAAMC,EAAMD,EAAOE,aAAa,YAChC,MAAMC,EAAS1B,KAAK2B,WACpB,GAAI3B,KAAKD,SAAU,CACfC,KAAKD,SAAS2B,EAAOE,QAAS5B,KAAK6B,SACvC,KAIR7B,KAAKc,sBAAsBd,KAAKQ,QAASb,EAAeE,GACxD,OAAOG,KAAKQ,OAChB,CAMUsB,WACN,OAAO9B,KAAKQ,QAAWR,KAAKQ,QAAyBsB,WAAa,IACtE,CAKUC,aACN,GAAI/B,KAAKQ,SAAWR,KAAKC,SAAU,CAC/B,IAAKD,KAAKE,WAAY,OACrBF,KAAKQ,QAAyBwB,YAAYhC,KAAKC,SAASG,IAAIc,SACjE,CACJ,EACH,IAAAe,EAAA,CAAAC,WAAA,MAAAD,EAAAxC,qBAAA,OAAAwC,CAAA","ignoreList":[]}

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

@@ -15,6 +15,16 @@ import Control from "sap/ui/core/Control";
  * @public
  */
 export class FileUploaderPlugin extends BasePlugin {
+    /**
+     * Renders a `sap.ui.unified.FileUploader` component.
+     * 
+     * @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.
+     * @param engineScopeId The deterministic scope ID.
+     * @param onChange The callback fired on value change.
+     * @returns {Control} The configured FileUploader 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;
@@ -51,10 +61,17 @@ export class FileUploaderPlugin extends BasePlugin {
         return this.control as Control;
     }
 
+    /**
+     * Retrieves the current file path.
+     * @returns {any} The file value.
+     */
     protected getValue(): any {
         return this.control ? (this.control as FileUploader).getValue() : null;
     }
 
+    /**
+     * Applies dynamic read-only state.
+     */
     protected applyState(): void {
         if (this.control && this.metadata) {
             if (!this.isEditable) return;

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

@@ -7,6 +7,16 @@ sap.ui.define(["../controls/BasePlugin", "../../controls/GeolocationControl"], f
   const BasePlugin = ___controls_BasePlugin["BasePlugin"];
   const GeolocationControl = _interopRequireDefault(__GeolocationControl);
   class GeolocationPlugin extends BasePlugin {
+    /**
+     * Renders a `GeolocationControl` component.
+     * 
+     * @param metadata The specific JSON schema properties for this field.
+     * @param bindingPath The JSON path bound to this control.
+     * @param modelName The UI5 JSONModel name.
+     * @param engineScopeId The deterministic scope ID.
+     * @param onChange The callback fired on value change.
+     * @returns {Control} The configured GeolocationControl.
+     */
     render(metadata, bindingPath, modelName = "meta", engineScopeId, onChange) {
       this.onChange = onChange;
       this.metadata = metadata;
@@ -40,9 +50,18 @@ sap.ui.define(["../controls/BasePlugin", "../../controls/GeolocationControl"], f
       });
       return this.control;
     }
+
+    /**
+     * Retrieves the current geolocation object.
+     * @returns {any} The geolocation value.
+     */
     getValue() {
       return this.control ? this.control.getValue() : null;
     }
+
+    /**
+     * Applies dynamic read-only state.
+     */
     applyState() {
       if (this.control && this.metadata) {
         if (!this.isEditable) return;

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

@@ -1 +1 @@
-{"version":3,"file":"GeolocationPlugin-dbg.js","names":["BasePlugin","___controls_BasePlugin","GeolocationControl","_interopRequireDefault","__GeolocationControl","GeolocationPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","fieldKey","replace","isEditable","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","path","formatter","val","lat","undefined","lng","applyCommonDirectives","value","schemaMetadata","readOnly","attachCapture","result","validate","isValid","getValue","applyState","setProperty","__exports","__esModule"],"sources":["GeolocationPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport GeolocationControl from \"../../controls/GeolocationControl\";\n\nexport class GeolocationPlugin extends BasePlugin {\n    public render(metadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = metadata;\n        this.fieldKey = bindingPath.replace('/', '');\n        this.modelName = modelName;\n\n        if (!this.isEditable) {\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                    formatter: (val: unknown) => val && val.lat !== undefined && val.lng !== undefined ? `Lat: ${val.lat}, Lng: ${val.lng}` : \"\"\n                }\n            });\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.control = new GeolocationControl({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            value: `{${modelName}>${bindingPath}}`,\n            schemaMetadata: metadata,\n            readOnly: !!metadata.ui?.readOnly\n        });\n\n        this.applyCommonDirectives(this.control, metadata, modelName);\n\n        (this.control as unknown as { attachCapture: (fn: Function) => void }).attachCapture(() => {\n            const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n        });\n\n        return this.control as Control;\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as unknown as { getValue: () => unknown }).getValue() : null;\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (!this.isEditable) return;\n            (this.control as unknown as { setProperty: (k: string, v: unknown) => void }).setProperty(\"readOnly\", !!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":";;;;;;QAASA,UAAU,GAAAC,sBAAA;EAAA,MAGZC,kBAAkB,GAAAC,sBAAA,CAAAC,oBAAA;EAElB,MAAMC,iBAAiB,SAASL,UAAU,CAAC;IACvCM,MAAMA,CAACC,QAA2B,EAAGC,WAAmB,EAAGC,SAAiB,GAAG,MAAM,EAAEC,aAAsB,EAAEC,QAAwD,EAAW;MACrL,IAAI,CAACA,QAAQ,GAAGA,QAAQ;MACxB,IAAI,CAACJ,QAAQ,GAAGA,QAAQ;MACxB,IAAI,CAACK,QAAQ,GAAGJ,WAAW,CAACK,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;MAC5C,IAAI,CAACJ,SAAS,GAAGA,SAAS;MAE1B,IAAI,CAAC,IAAI,CAACK,UAAU,EAAE;QAClBC,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,CAACZ,aAAa,EAAEF,WAAW,CAAC;UACrDe,IAAI,EAAE;YACFC,IAAI,EAAE,GAAGf,SAAS,IAAID,WAAW,EAAE;YACnCiB,SAAS,EAAGC,GAAY,IAAKA,GAAG,IAAIA,GAAG,CAACC,GAAG,KAAKC,SAAS,IAAIF,GAAG,CAACG,GAAG,KAAKD,SAAS,GAAG,QAAQF,GAAG,CAACC,GAAG,UAAUD,GAAG,CAACG,GAAG,EAAE,GAAG;UAC9H;QACJ,CAAC,CAAC;QACF,IAAI,CAACC,qBAAqB,CAAC,IAAI,CAACV,OAAO,EAAEb,QAAQ,EAAEE,SAAS,CAAC;QAC7D,OAAO,IAAI,CAACW,OAAO;MACvB;MAEA,IAAI,CAACA,OAAO,GAAG,IAAIlB,kBAAkB,CAAC;QAClCmB,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAACZ,aAAa,EAAEF,WAAW,CAAC;QACrDuB,KAAK,EAAE,IAAItB,SAAS,IAAID,WAAW,GAAG;QACtCwB,cAAc,EAAEzB,QAAQ;QACxB0B,QAAQ,EAAE,CAAC,CAAC1B,QAAQ,CAACS,EAAE,EAAEiB;MAC7B,CAAC,CAAC;MAEF,IAAI,CAACH,qBAAqB,CAAC,IAAI,CAACV,OAAO,EAAEb,QAAQ,EAAEE,SAAS,CAAC;MAE5D,IAAI,CAACW,OAAO,CAA0Dc,aAAa,CAAC,MAAM;QACvF,MAAMC,MAAM,GAAG,IAAI,CAACC,QAAQ,CAAC,CAAC;QAC1B,IAAI,IAAI,CAACzB,QAAQ,EAAE;UACf,IAAI,CAACA,QAAQ,CAACwB,MAAM,CAACE,OAAO,EAAE,IAAI,CAACzB,QAAQ,CAAC;QAChD;MACR,CAAC,CAAC;MAEF,OAAO,IAAI,CAACQ,OAAO;IACvB;IAEUkB,QAAQA,CAAA,EAAQ;MACtB,OAAO,IAAI,CAAClB,OAAO,GAAI,IAAI,CAACA,OAAO,CAA4CkB,QAAQ,CAAC,CAAC,GAAG,IAAI;IACpG;IAEUC,UAAUA,CAAA,EAAS;MACzB,IAAI,IAAI,CAACnB,OAAO,IAAI,IAAI,CAACb,QAAQ,EAAE;QAC/B,IAAI,CAAC,IAAI,CAACO,UAAU,EAAE;QACrB,IAAI,CAACM,OAAO,CAAiEoB,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAACjC,QAAQ,CAACS,EAAE,EAAEiB,QAAQ,CAAC;MACvI;IACJ;EACJ;EAAC,IAAAQ,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAApC,iBAAA,GAAAA,iBAAA;EAAA,OAAAoC,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"GeolocationPlugin-dbg.js","names":["BasePlugin","___controls_BasePlugin","GeolocationControl","_interopRequireDefault","__GeolocationControl","GeolocationPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","fieldKey","replace","isEditable","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","path","formatter","val","lat","undefined","lng","applyCommonDirectives","value","schemaMetadata","readOnly","attachCapture","result","validate","isValid","getValue","applyState","setProperty","__exports","__esModule"],"sources":["GeolocationPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport GeolocationControl from \"../../controls/GeolocationControl\";\n\nexport class GeolocationPlugin extends BasePlugin {\n    /**\n     * Renders a `GeolocationControl` component.\n     * \n     * @param metadata 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     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured GeolocationControl.\n     */\n    public render(metadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = metadata;\n        this.fieldKey = bindingPath.replace('/', '');\n        this.modelName = modelName;\n\n        if (!this.isEditable) {\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                    formatter: (val: unknown) => val && val.lat !== undefined && val.lng !== undefined ? `Lat: ${val.lat}, Lng: ${val.lng}` : \"\"\n                }\n            });\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.control = new GeolocationControl({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            value: `{${modelName}>${bindingPath}}`,\n            schemaMetadata: metadata,\n            readOnly: !!metadata.ui?.readOnly\n        });\n\n        this.applyCommonDirectives(this.control, metadata, modelName);\n\n        (this.control as unknown as { attachCapture: (fn: Function) => void }).attachCapture(() => {\n            const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n        });\n\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the current geolocation object.\n     * @returns {any} The geolocation value.\n     */\n    protected getValue(): any {\n        return this.control ? (this.control as unknown as { getValue: () => unknown }).getValue() : null;\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (!this.isEditable) return;\n            (this.control as unknown as { setProperty: (k: string, v: unknown) => void }).setProperty(\"readOnly\", !!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -3,8 +3,25 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/controls/GeolocationPlugin" {
     import { IPropertyMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
     import Control from "sap/ui/core/Control";
     export class GeolocationPlugin extends BasePlugin {
+        /**
+         * Renders a `GeolocationControl` component.
+         *
+         * @param metadata The specific JSON schema properties for this field.
+         * @param bindingPath The JSON path bound to this control.
+         * @param modelName The UI5 JSONModel name.
+         * @param engineScopeId The deterministic scope ID.
+         * @param onChange The callback fired on value change.
+         * @returns {Control} The configured GeolocationControl.
+         */
         render(metadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control;
+        /**
+         * Retrieves the current geolocation object.
+         * @returns {any} The geolocation value.
+         */
         protected getValue(): any;
+        /**
+         * Applies dynamic read-only state.
+         */
         protected applyState(): void;
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"GeolocationPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/GeolocationPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,+DAA+D,CAAC;IAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAClF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAG1C,MAAa,iBAAkB,SAAQ,UAAU;QACtC,MAAM,CAAC,QAAQ,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;QAuCxL,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB,SAAS,CAAC,UAAU,IAAI,IAAI;KAM/B;CAEA"}
+{"version":3,"file":"GeolocationPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/GeolocationPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,+DAA+D,CAAC;IAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAClF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAG1C,MAAa,iBAAkB,SAAQ,UAAU;QAC7C;;;;;;;;;WASG;QACI,MAAM,CAAC,QAAQ,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;QAuCxL;;;WAGG;QACH,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB;;WAEG;QACH,SAAS,CAAC,UAAU,IAAI,IAAI;KAM/B;CAEA"}

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

@@ -1 +1 @@
-{"version":3,"file":"GeolocationPlugin.js","names":["BasePlugin","___controls_BasePlugin","GeolocationControl","_interopRequireDefault","__GeolocationControl","GeolocationPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","this","fieldKey","replace","isEditable","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","path","formatter","val","lat","undefined","lng","applyCommonDirectives","value","schemaMetadata","readOnly","attachCapture","result","validate","isValid","getValue","applyState","setProperty","__exports","__esModule"],"sources":["GeolocationPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport GeolocationControl from \"../../controls/GeolocationControl\";\n\nexport class GeolocationPlugin extends BasePlugin {\n    public render(metadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = metadata;\n        this.fieldKey = bindingPath.replace('/', '');\n        this.modelName = modelName;\n\n        if (!this.isEditable) {\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                    formatter: (val: unknown) => val && val.lat !== undefined && val.lng !== undefined ? `Lat: ${val.lat}, Lng: ${val.lng}` : \"\"\n                }\n            });\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.control = new GeolocationControl({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            value: `{${modelName}>${bindingPath}}`,\n            schemaMetadata: metadata,\n            readOnly: !!metadata.ui?.readOnly\n        });\n\n        this.applyCommonDirectives(this.control, metadata, modelName);\n\n        (this.control as unknown as { attachCapture: (fn: Function) => void }).attachCapture(() => {\n            const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n        });\n\n        return this.control as Control;\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as unknown as { getValue: () => unknown }).getValue() : null;\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (!this.isEditable) return;\n            (this.control as unknown as { setProperty: (k: string, v: unknown) => void }).setProperty(\"readOnly\", !!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"+LAASA,EAAUC,EAAA,oBAGZC,EAAkBC,EAAAC,GAElB,MAAMC,UAA0BL,EAC5BM,OAAOC,EAA8BC,EAAsBC,EAAoB,OAAQC,EAAwBC,GAClHC,KAAKD,SAAWA,EAChBC,KAAKL,SAAWA,EAChBK,KAAKC,SAAWL,EAAYM,QAAQ,IAAK,IACzCF,KAAKH,UAAYA,EAEjB,IAAKG,KAAKG,WAAY,CAClBC,IAAIC,GAAGC,YAAY,cACnB,MAAMC,EAAcH,IAAIC,GAAGG,QAAQ,cACnCR,KAAKS,QAAU,IAAIF,EAAY,CAC3BG,GAAIV,KAAKW,iBAAiBb,EAAeF,GACzCgB,KAAM,CACFC,KAAM,GAAGhB,KAAaD,IACtBkB,UAAYC,GAAiBA,GAAOA,EAAIC,MAAQC,WAAaF,EAAIG,MAAQD,UAAY,QAAQF,EAAIC,aAAaD,EAAIG,MAAQ,MAGlIlB,KAAKmB,sBAAsBnB,KAAKS,QAASd,EAAUE,GACnD,OAAOG,KAAKS,OAChB,CAEAT,KAAKS,QAAU,IAAInB,EAAmB,CAClCoB,GAAIV,KAAKW,iBAAiBb,EAAeF,GACzCwB,MAAO,IAAIvB,KAAaD,KACxByB,eAAgB1B,EAChB2B,WAAY3B,EAASU,IAAIiB,WAG7BtB,KAAKmB,sBAAsBnB,KAAKS,QAASd,EAAUE,GAElDG,KAAKS,QAAiEc,cAAc,KACjF,MAAMC,EAASxB,KAAKyB,WAChB,GAAIzB,KAAKD,SAAU,CACfC,KAAKD,SAASyB,EAAOE,QAAS1B,KAAKC,SACvC,IAGR,OAAOD,KAAKS,OAChB,CAEUkB,WACN,OAAO3B,KAAKS,QAAWT,KAAKS,QAAmDkB,WAAa,IAChG,CAEUC,aACN,GAAI5B,KAAKS,SAAWT,KAAKL,SAAU,CAC/B,IAAKK,KAAKG,WAAY,OACrBH,KAAKS,QAAwEoB,YAAY,aAAc7B,KAAKL,SAASU,IAAIiB,SAC9H,CACJ,EACH,IAAAQ,EAAA,CAAAC,WAAA,MAAAD,EAAArC,oBAAA,OAAAqC,CAAA","ignoreList":[]}
+{"version":3,"file":"GeolocationPlugin.js","names":["BasePlugin","___controls_BasePlugin","GeolocationControl","_interopRequireDefault","__GeolocationControl","GeolocationPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","this","fieldKey","replace","isEditable","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","path","formatter","val","lat","undefined","lng","applyCommonDirectives","value","schemaMetadata","readOnly","attachCapture","result","validate","isValid","getValue","applyState","setProperty","__exports","__esModule"],"sources":["GeolocationPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport GeolocationControl from \"../../controls/GeolocationControl\";\n\nexport class GeolocationPlugin extends BasePlugin {\n    /**\n     * Renders a `GeolocationControl` component.\n     * \n     * @param metadata 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     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured GeolocationControl.\n     */\n    public render(metadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = metadata;\n        this.fieldKey = bindingPath.replace('/', '');\n        this.modelName = modelName;\n\n        if (!this.isEditable) {\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                    formatter: (val: unknown) => val && val.lat !== undefined && val.lng !== undefined ? `Lat: ${val.lat}, Lng: ${val.lng}` : \"\"\n                }\n            });\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.control = new GeolocationControl({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            value: `{${modelName}>${bindingPath}}`,\n            schemaMetadata: metadata,\n            readOnly: !!metadata.ui?.readOnly\n        });\n\n        this.applyCommonDirectives(this.control, metadata, modelName);\n\n        (this.control as unknown as { attachCapture: (fn: Function) => void }).attachCapture(() => {\n            const result = this.validate();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n        });\n\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the current geolocation object.\n     * @returns {any} The geolocation value.\n     */\n    protected getValue(): any {\n        return this.control ? (this.control as unknown as { getValue: () => unknown }).getValue() : null;\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            if (!this.isEditable) return;\n            (this.control as unknown as { setProperty: (k: string, v: unknown) => void }).setProperty(\"readOnly\", !!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"+LAASA,EAAUC,EAAA,oBAGZC,EAAkBC,EAAAC,GAElB,MAAMC,UAA0BL,EAW5BM,OAAOC,EAA8BC,EAAsBC,EAAoB,OAAQC,EAAwBC,GAClHC,KAAKD,SAAWA,EAChBC,KAAKL,SAAWA,EAChBK,KAAKC,SAAWL,EAAYM,QAAQ,IAAK,IACzCF,KAAKH,UAAYA,EAEjB,IAAKG,KAAKG,WAAY,CAClBC,IAAIC,GAAGC,YAAY,cACnB,MAAMC,EAAcH,IAAIC,GAAGG,QAAQ,cACnCR,KAAKS,QAAU,IAAIF,EAAY,CAC3BG,GAAIV,KAAKW,iBAAiBb,EAAeF,GACzCgB,KAAM,CACFC,KAAM,GAAGhB,KAAaD,IACtBkB,UAAYC,GAAiBA,GAAOA,EAAIC,MAAQC,WAAaF,EAAIG,MAAQD,UAAY,QAAQF,EAAIC,aAAaD,EAAIG,MAAQ,MAGlIlB,KAAKmB,sBAAsBnB,KAAKS,QAASd,EAAUE,GACnD,OAAOG,KAAKS,OAChB,CAEAT,KAAKS,QAAU,IAAInB,EAAmB,CAClCoB,GAAIV,KAAKW,iBAAiBb,EAAeF,GACzCwB,MAAO,IAAIvB,KAAaD,KACxByB,eAAgB1B,EAChB2B,WAAY3B,EAASU,IAAIiB,WAG7BtB,KAAKmB,sBAAsBnB,KAAKS,QAASd,EAAUE,GAElDG,KAAKS,QAAiEc,cAAc,KACjF,MAAMC,EAASxB,KAAKyB,WAChB,GAAIzB,KAAKD,SAAU,CACfC,KAAKD,SAASyB,EAAOE,QAAS1B,KAAKC,SACvC,IAGR,OAAOD,KAAKS,OAChB,CAMUkB,WACN,OAAO3B,KAAKS,QAAWT,KAAKS,QAAmDkB,WAAa,IAChG,CAKUC,aACN,GAAI5B,KAAKS,SAAWT,KAAKL,SAAU,CAC/B,IAAKK,KAAKG,WAAY,OACrBH,KAAKS,QAAwEoB,YAAY,aAAc7B,KAAKL,SAASU,IAAIiB,SAC9H,CACJ,EACH,IAAAQ,EAAA,CAAAC,WAAA,MAAAD,EAAArC,oBAAA,OAAAqC,CAAA","ignoreList":[]}

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

@@ -4,6 +4,16 @@ import Control from "sap/ui/core/Control";
 import GeolocationControl from "../../controls/GeolocationControl";
 
 export class GeolocationPlugin extends BasePlugin {
+    /**
+     * Renders a `GeolocationControl` component.
+     * 
+     * @param metadata The specific JSON schema properties for this field.
+     * @param bindingPath The JSON path bound to this control.
+     * @param modelName The UI5 JSONModel name.
+     * @param engineScopeId The deterministic scope ID.
+     * @param onChange The callback fired on value change.
+     * @returns {Control} The configured GeolocationControl.
+     */
     public render(metadata: IPropertyMetadata,  bindingPath: string,  modelName: string = "meta", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {
         this.onChange = onChange;
         this.metadata = metadata;
@@ -43,10 +53,17 @@ export class GeolocationPlugin extends BasePlugin {
         return this.control as Control;
     }
 
+    /**
+     * Retrieves the current geolocation object.
+     * @returns {any} The geolocation value.
+     */
     protected getValue(): any {
         return this.control ? (this.control as unknown as { getValue: () => unknown }).getValue() : null;
     }
 
+    /**
+     * Applies dynamic read-only state.
+     */
     protected applyState(): void {
         if (this.control && this.metadata) {
             if (!this.isEditable) return;

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

@@ -14,6 +14,16 @@ sap.ui.define(["./BasePlugin", "sap/m/MessageStrip"], function (___BasePlugin, M
    * @public
    */
   class MessageStripPlugin extends BasePlugin {
+    /**
+     * Renders a `sap.m.MessageStrip` component.
+     * 
+     * @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.
+     * @param engineScopeId The deterministic scope ID.
+     * @param onChange The callback fired on value change.
+     * @returns {Control} The configured MessageStrip control.
+     */
     render(fieldMetadata, bindingPath, modelName = "meta", engineScopeId, onChange) {
       this.onChange = onChange;
       this.metadata = fieldMetadata;
@@ -29,9 +39,17 @@ sap.ui.define(["./BasePlugin", "sap/m/MessageStrip"], function (___BasePlugin, M
       });
       return this.control;
     }
+
+    /**
+     * Read-only control, returns null.
+     */
     getValue() {
       return null; // Read-only component
     }
+
+    /**
+     * Read-only control, no dynamic state needed.
+     */
     applyState() {
       // Read-only component, no dynamic state needed currently
     }

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

@@ -1 +1 @@
-{"version":3,"file":"MessageStripPlugin-dbg.js","names":["BasePlugin","___BasePlugin","MessageStripPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","control","MessageStrip","id","generateStableId","text","type","showIcon","showCloseButton","getValue","applyState","__exports","__esModule"],"sources":["MessageStripPlugin.ts"],"sourcesContent":["/**\n * @file MessageStripPlugin.ts\n * @description Renders a sap.m.MessageStrip for informational text.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport MessageStrip from \"sap/m/MessageStrip\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Renders read-only informational alerts within the layout.\n * Does not emit values to the payload.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.controls\n * @public\n */\nexport class MessageStripPlugin 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        // Use binding to display text if the field has a value, otherwise use the label\n        this.control = new MessageStrip({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: `{${modelName}>${bindingPath}}`,\n            type: \"Information\", // Can be driven by schema arguments in the future\n            showIcon: true,\n            showCloseButton: false\n        });\n\n        return this.control as Control;\n    }\n\n    protected getValue(): any {\n        return null; // Read-only component\n    }\n\n    protected applyState(): void {\n        // Read-only component, no dynamic state needed currently\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;EAHA,MAKSA,UAAU,GAAAC,aAAA;EAKnB;AACA;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;MACA,IAAI,CAACM,OAAO,GAAG,IAAIC,YAAY,CAAC;QAC5BC,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAACN,aAAa,EAAEF,WAAW,CAAC;QACrDS,IAAI,EAAE,IAAIR,SAAS,IAAID,WAAW,GAAG;QACrCU,IAAI,EAAE,aAAa;QAAE;QACrBC,QAAQ,EAAE,IAAI;QACdC,eAAe,EAAE;MACrB,CAAC,CAAC;MAEF,OAAO,IAAI,CAACP,OAAO;IACvB;IAEUQ,QAAQA,CAAA,EAAQ;MACtB,OAAO,IAAI,CAAC,CAAC;IACjB;IAEUC,UAAUA,CAAA,EAAS;MACzB;IAAA;EAER;EAAC,IAAAC,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAlB,kBAAA,GAAAA,kBAAA;EAAA,OAAAkB,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"MessageStripPlugin-dbg.js","names":["BasePlugin","___BasePlugin","MessageStripPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","control","MessageStrip","id","generateStableId","text","type","showIcon","showCloseButton","getValue","applyState","__exports","__esModule"],"sources":["MessageStripPlugin.ts"],"sourcesContent":["/**\n * @file MessageStripPlugin.ts\n * @description Renders a sap.m.MessageStrip for informational text.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport MessageStrip from \"sap/m/MessageStrip\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Renders read-only informational alerts within the layout.\n * Does not emit values to the payload.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.controls\n * @public\n */\nexport class MessageStripPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.MessageStrip` component.\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     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured MessageStrip 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        // Use binding to display text if the field has a value, otherwise use the label\n        this.control = new MessageStrip({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: `{${modelName}>${bindingPath}}`,\n            type: \"Information\", // Can be driven by schema arguments in the future\n            showIcon: true,\n            showCloseButton: false\n        });\n\n        return this.control as Control;\n    }\n\n    /**\n     * Read-only control, returns null.\n     */\n    protected getValue(): any {\n        return null; // Read-only component\n    }\n\n    /**\n     * Read-only control, no dynamic state needed.\n     */\n    protected applyState(): void {\n        // Read-only component, no dynamic state needed currently\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;EAHA,MAKSA,UAAU,GAAAC,aAAA;EAKnB;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMC,kBAAkB,SAASF,UAAU,CAAC;IAC/C;AACJ;AACA;AACA;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;MACA,IAAI,CAACM,OAAO,GAAG,IAAIC,YAAY,CAAC;QAC5BC,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAACN,aAAa,EAAEF,WAAW,CAAC;QACrDS,IAAI,EAAE,IAAIR,SAAS,IAAID,WAAW,GAAG;QACrCU,IAAI,EAAE,aAAa;QAAE;QACrBC,QAAQ,EAAE,IAAI;QACdC,eAAe,EAAE;MACrB,CAAC,CAAC;MAEF,OAAO,IAAI,CAACP,OAAO;IACvB;;IAEA;AACJ;AACA;IACcQ,QAAQA,CAAA,EAAQ;MACtB,OAAO,IAAI,CAAC,CAAC;IACjB;;IAEA;AACJ;AACA;IACcC,UAAUA,CAAA,EAAS;MACzB;IAAA;EAER;EAAC,IAAAC,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAlB,kBAAA,GAAAA,kBAAA;EAAA,OAAAkB,SAAA;AAAA","ignoreList":[]}