@siliconst/metaui 1.4.7 → 1.4.8

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

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

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

@@ -19,6 +19,16 @@ import { Logger } from "../../utils/Logger";
  */
 export class RemoteDropdownPlugin extends BasePlugin {
     
+    /**
+     * Renders a `Select` dropdown that fetches data remotely.
+     * 
+     * @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 {
         this.onChange = onChange;
         this.metadata = fieldMetadata;
@@ -69,7 +79,7 @@ export class RemoteDropdownPlugin extends BasePlugin {
             })
             .then(data => {
                 const arr = Array.isArray(data) ? data : (data.value || []);
-                arr.forEach((item: any) => {
+                arr.forEach((item: Record<string, unknown>) => {
                     const k = config.keyPath ? item[config.keyPath] : item;
                     const t = config.textPath ? item[config.textPath] : item;
                     select.addItem(new Item({ key: String(k), text: String(t) }));
@@ -87,10 +97,17 @@ export class RemoteDropdownPlugin extends BasePlugin {
         return this.control as Control;
     }
 
-    protected getValue(): any {
+    /**
+     * Retrieves the current selected key.
+     * @returns {unknown} The selected key.
+     */
+    protected getValue(): unknown {
         return this.control ? (this.control as Select).getSelectedKey() : 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/datasources/RemoteValueHelpPlugin-dbg.js

@@ -16,6 +16,15 @@ sap.ui.define(["../controls/BasePlugin", "sap/m/ComboBox", "sap/ui/core/Item", "
    */
   class RemoteValueHelpPlugin extends BasePlugin {
     isLoaded = false;
+
+    /**
+     * Renders a `ComboBox` that simulates fetching data from a remote server.
+     * 
+     * @param fieldMetadata The specific JSON schema properties for this field.
+     * @param bindingPath The JSON path bound to this control.
+     * @param modelName The UI5 JSONModel name.
+     * @returns {Control} The configured ComboBox control.
+     */
     render(fieldMetadata, bindingPath, modelName = "meta") {
       this.metadata = fieldMetadata;
       const comboBox = new ComboBox({
@@ -36,6 +45,11 @@ sap.ui.define(["../controls/BasePlugin", "sap/m/ComboBox", "sap/ui/core/Item", "
       this.control = comboBox;
       return this.control;
     }
+
+    /**
+     * Executes the REST fetch for data.
+     * @param comboBox The UI5 ComboBox to populate.
+     */
     fetchData(comboBox) {
       const vhConfig = this.metadata?.valueHelp;
       if (!vhConfig || !vhConfig.url) {
@@ -59,9 +73,18 @@ sap.ui.define(["../controls/BasePlugin", "sap/m/ComboBox", "sap/ui/core/Item", "
         this.isLoaded = true;
       });
     }
+
+    /**
+     * Retrieves the current selected key.
+     * @returns {unknown} The selected key.
+     */
     getValue() {
       return this.control ? this.control.getSelectedKey() : null;
     }
+
+    /**
+     * Applies dynamic read-only state.
+     */
     applyState() {
       if (this.control && this.metadata) {
         this.control.setEnabled(!this.metadata.ui?.readOnly);

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

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

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

@@ -16,9 +16,28 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/datasources/RemoteValueHelpPl
      */
     export class RemoteValueHelpPlugin extends BasePlugin {
         private isLoaded;
+        /**
+         * Renders a `ComboBox` that simulates fetching data from a remote server.
+         *
+         * @param fieldMetadata The specific JSON schema properties for this field.
+         * @param bindingPath The JSON path bound to this control.
+         * @param modelName The UI5 JSONModel name.
+         * @returns {Control} The configured ComboBox control.
+         */
         render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string): Control;
+        /**
+         * Executes the REST fetch for data.
+         * @param comboBox The UI5 ComboBox to populate.
+         */
         protected fetchData(comboBox: ComboBox): void;
-        protected getValue(): any;
+        /**
+         * Retrieves the current selected key.
+         * @returns {unknown} The selected key.
+         */
+        protected getValue(): unknown;
+        /**
+         * Applies dynamic read-only state.
+         */
         protected applyState(): void;
     }
 }

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

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

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

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

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

@@ -4,7 +4,7 @@
  */
 
 import { BasePlugin } from "../controls/BasePlugin";
-import { IPropertyMetadata } from "../../interfaces/ISchema";
+import { IPropertyMetadata, IRemoteValueHelpConfig } from "../../interfaces/ISchema";
 import ComboBox from "sap/m/ComboBox";
 import Item from "sap/ui/core/Item";
 import Control from "sap/ui/core/Control";
@@ -20,6 +20,14 @@ import { Logger } from "../../utils/Logger";
 export class RemoteValueHelpPlugin extends BasePlugin {
     private isLoaded = false;
 
+    /**
+     * Renders a `ComboBox` that simulates fetching data from a remote server.
+     * 
+     * @param fieldMetadata The specific JSON schema properties for this field.
+     * @param bindingPath The JSON path bound to this control.
+     * @param modelName The UI5 JSONModel name.
+     * @returns {Control} The configured ComboBox control.
+     */
     public render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName: string = "meta"): Control {
         this.metadata = fieldMetadata;
         
@@ -27,9 +35,9 @@ export class RemoteValueHelpPlugin extends BasePlugin {
             selectedKey: `{${modelName}>${bindingPath}}`,
             enabled: !fieldMetadata.ui?.readOnly,
             placeholder: "Select a country...",
-            change: (oEvent: unknown) => {
-                const item = (oEvent as { getParameter: (s: string) => unknown }).getParameter("selectedItem");
-                const val = item ? item.getKey() : (oEvent as { getParameter: (s: string) => unknown }).getParameter("value"); // Allow free text as well
+            change: (oEvent: sap.ui.base.Event) => {
+                const item = (oEvent as sap.ui.base.Event).getParameter("selectedItem");
+                const val = item ? item.getKey() : (oEvent as sap.ui.base.Event).getParameter("value"); // Allow free text as well
                 this.validate();
             }
         });
@@ -43,8 +51,12 @@ export class RemoteValueHelpPlugin extends BasePlugin {
         return this.control as Control;
     }
 
+    /**
+     * Executes the REST fetch for data.
+     * @param comboBox The UI5 ComboBox to populate.
+     */
     protected fetchData(comboBox: ComboBox): void {
-        const vhConfig = this.metadata?.valueHelp as unknown as Record<string, unknown>;
+        const vhConfig = this.metadata?.valueHelp as IRemoteValueHelpConfig;
         if (!vhConfig || !vhConfig.url) {
             Logger.error("RemoteValueHelpPlugin requires a valid valueHelp configuration with a URL.", "", "RemoteValueHelpPlugin");
             return;
@@ -74,10 +86,17 @@ export class RemoteValueHelpPlugin extends BasePlugin {
             });
     }
 
-    protected getValue(): any {
+    /**
+     * Retrieves the current selected key.
+     * @returns {unknown} The selected key.
+     */
+    protected getValue(): unknown {
         return this.control ? (this.control as ComboBox).getSelectedKey() : null;
     }
 
+    /**
+     * Applies dynamic read-only state.
+     */
     protected applyState(): void {
         if (this.control && this.metadata) {
             (this.control as ComboBox).setEnabled(!this.metadata.ui?.readOnly);

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/CurrencyFormatterPlugin-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"CurrencyFormatterPlugin-dbg.js","names":["CurrencyFormatterPlugin","constructor","currencyFormat","NumberFormat","getCurrencyInstance","showMeasure","format","rawValue","args","undefined","__exports","__esModule"],"sources":["CurrencyFormatterPlugin.ts"],"sourcesContent":["/**\n * @file CurrencyFormatterPlugin.ts\n * @description Standard data formatter for currency values.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\nimport NumberFormat from \"sap/ui/core/format/NumberFormat\";\n\n/**\n * Standard data formatter for currency values.\n * Uses sap.ui.core.format.NumberFormat to format raw numbers into localized currency strings.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class CurrencyFormatterPlugin implements IFormatter {\n    private currencyFormat: any;\n\n    constructor() {\n        this.currencyFormat = NumberFormat.getCurrencyInstance({\n            showMeasure: false\n        });\n    }\n\n    /**\n     * Formats raw JSON model data into a UI-friendly currency string.\n     * @param rawValue The raw numeric value from the JSON payload.\n     * @returns The formatted string for the UI control.\n     */\n    public format(rawValue: unknown, args?: unknown): string {\n        if (rawValue === null || rawValue === undefined) {\n            return \"\";\n        }\n        return \"$\" + this.currencyFormat.format(rawValue);\n    }\n}\n"],"mappings":";;;EAQA;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMA,uBAAuB,CAAuB;IAGvDC,WAAWA,CAAA,EAAG;MACV,IAAI,CAACC,cAAc,GAAGC,YAAY,CAACC,mBAAmB,CAAC;QACnDC,WAAW,EAAE;MACjB,CAAC,CAAC;IACN;;IAEA;AACJ;AACA;AACA;AACA;IACWC,MAAMA,CAACC,QAAiB,EAAEC,IAAc,EAAU;MACrD,IAAID,QAAQ,KAAK,IAAI,IAAIA,QAAQ,KAAKE,SAAS,EAAE;QAC7C,OAAO,EAAE;MACb;MACA,OAAO,GAAG,GAAG,IAAI,CAACP,cAAc,CAACI,MAAM,CAACC,QAAQ,CAAC;IACrD;EACJ;EAAC,IAAAG,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAV,uBAAA,GAAAA,uBAAA;EAAA,OAAAU,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"CurrencyFormatterPlugin-dbg.js","names":["CurrencyFormatterPlugin","constructor","currencyFormat","NumberFormat","getCurrencyInstance","showMeasure","format","rawValue","args","undefined","__exports","__esModule"],"sources":["CurrencyFormatterPlugin.ts"],"sourcesContent":["/**\n * @file CurrencyFormatterPlugin.ts\n * @description Standard data formatter for currency values.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\nimport NumberFormat from \"sap/ui/core/format/NumberFormat\";\n\n/**\n * Standard data formatter for currency values.\n * Uses sap.ui.core.format.NumberFormat to format raw numbers into localized currency strings.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class CurrencyFormatterPlugin implements IFormatter {\n    private currencyFormat: NumberFormat;\n\n    constructor() {\n        this.currencyFormat = NumberFormat.getCurrencyInstance({\n            showMeasure: false\n        });\n    }\n\n    /**\n     * Formats raw JSON model data into a UI-friendly currency string.\n     * @param rawValue The raw numeric value from the JSON payload.\n     * @returns The formatted string for the UI control.\n     */\n    public format(rawValue: string | number, args?: Record<string, string>): string {\n        if (rawValue === null || rawValue === undefined) {\n            return \"\";\n        }\n        return \"$\" + this.currencyFormat.format(rawValue);\n    }\n}\n"],"mappings":";;;EAQA;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMA,uBAAuB,CAAuB;IAGvDC,WAAWA,CAAA,EAAG;MACV,IAAI,CAACC,cAAc,GAAGC,YAAY,CAACC,mBAAmB,CAAC;QACnDC,WAAW,EAAE;MACjB,CAAC,CAAC;IACN;;IAEA;AACJ;AACA;AACA;AACA;IACWC,MAAMA,CAACC,QAAyB,EAAEC,IAA6B,EAAU;MAC5E,IAAID,QAAQ,KAAK,IAAI,IAAIA,QAAQ,KAAKE,SAAS,EAAE;QAC7C,OAAO,EAAE;MACb;MACA,OAAO,GAAG,GAAG,IAAI,CAACP,cAAc,CAACI,MAAM,CAACC,QAAQ,CAAC;IACrD;EACJ;EAAC,IAAAG,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAV,uBAAA,GAAAA,uBAAA;EAAA,OAAAU,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/CurrencyFormatterPlugin.d.ts

@@ -19,7 +19,7 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/formatters/CurrencyFormatterP
          * @param rawValue The raw numeric value from the JSON payload.
          * @returns The formatted string for the UI control.
          */
-        format(rawValue: unknown, args?: unknown): string;
+        format(rawValue: string | number, args?: Record<string, string>): string;
     }
 }
 //# sourceMappingURL=CurrencyFormatterPlugin.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/CurrencyFormatterPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CurrencyFormatterPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/formatters/CurrencyFormatterPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,uEAAuE,CAAC;IACvF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAC;IAG7E;;;;;;OAMG;IACH,MAAa,uBAAwB,YAAW,UAAU;QACtD,OAAO,CAAC,cAAc,CAAM;;QAQ5B;;;;WAIG;QACI,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM;KAM3D;CAEA"}
+{"version":3,"file":"CurrencyFormatterPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/formatters/CurrencyFormatterPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,uEAAuE,CAAC;IACvF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAC;IAG7E;;;;;;OAMG;IACH,MAAa,uBAAwB,YAAW,UAAU;QACtD,OAAO,CAAC,cAAc,CAAe;;QAQrC;;;;WAIG;QACI,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;KAMlF;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/CurrencyFormatterPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"CurrencyFormatterPlugin.js","names":["CurrencyFormatterPlugin","constructor","this","currencyFormat","NumberFormat","getCurrencyInstance","showMeasure","format","rawValue","args","undefined","__exports","__esModule"],"sources":["CurrencyFormatterPlugin.ts"],"sourcesContent":["/**\n * @file CurrencyFormatterPlugin.ts\n * @description Standard data formatter for currency values.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\nimport NumberFormat from \"sap/ui/core/format/NumberFormat\";\n\n/**\n * Standard data formatter for currency values.\n * Uses sap.ui.core.format.NumberFormat to format raw numbers into localized currency strings.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class CurrencyFormatterPlugin implements IFormatter {\n    private currencyFormat: any;\n\n    constructor() {\n        this.currencyFormat = NumberFormat.getCurrencyInstance({\n            showMeasure: false\n        });\n    }\n\n    /**\n     * Formats raw JSON model data into a UI-friendly currency string.\n     * @param rawValue The raw numeric value from the JSON payload.\n     * @returns The formatted string for the UI control.\n     */\n    public format(rawValue: unknown, args?: unknown): string {\n        if (rawValue === null || rawValue === undefined) {\n            return \"\";\n        }\n        return \"$\" + this.currencyFormat.format(rawValue);\n    }\n}\n"],"mappings":"2EAeO,MAAMA,EAGTC,cACIC,KAAKC,eAAiBC,EAAaC,oBAAoB,CACnDC,YAAa,OAErB,CAOOC,OAAOC,EAAmBC,GAC7B,GAAID,IAAa,MAAQA,IAAaE,UAAW,CAC7C,MAAO,EACX,CACA,MAAO,IAAMR,KAAKC,eAAeI,OAAOC,EAC5C,EACH,IAAAG,EAAA,CAAAC,WAAA,MAAAD,EAAAX,0BAAA,OAAAW,CAAA","ignoreList":[]}
+{"version":3,"file":"CurrencyFormatterPlugin.js","names":["CurrencyFormatterPlugin","constructor","this","currencyFormat","NumberFormat","getCurrencyInstance","showMeasure","format","rawValue","args","undefined","__exports","__esModule"],"sources":["CurrencyFormatterPlugin.ts"],"sourcesContent":["/**\n * @file CurrencyFormatterPlugin.ts\n * @description Standard data formatter for currency values.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\nimport NumberFormat from \"sap/ui/core/format/NumberFormat\";\n\n/**\n * Standard data formatter for currency values.\n * Uses sap.ui.core.format.NumberFormat to format raw numbers into localized currency strings.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class CurrencyFormatterPlugin implements IFormatter {\n    private currencyFormat: NumberFormat;\n\n    constructor() {\n        this.currencyFormat = NumberFormat.getCurrencyInstance({\n            showMeasure: false\n        });\n    }\n\n    /**\n     * Formats raw JSON model data into a UI-friendly currency string.\n     * @param rawValue The raw numeric value from the JSON payload.\n     * @returns The formatted string for the UI control.\n     */\n    public format(rawValue: string | number, args?: Record<string, string>): string {\n        if (rawValue === null || rawValue === undefined) {\n            return \"\";\n        }\n        return \"$\" + this.currencyFormat.format(rawValue);\n    }\n}\n"],"mappings":"2EAeO,MAAMA,EAGTC,cACIC,KAAKC,eAAiBC,EAAaC,oBAAoB,CACnDC,YAAa,OAErB,CAOOC,OAAOC,EAA2BC,GACrC,GAAID,IAAa,MAAQA,IAAaE,UAAW,CAC7C,MAAO,EACX,CACA,MAAO,IAAMR,KAAKC,eAAeI,OAAOC,EAC5C,EACH,IAAAG,EAAA,CAAAC,WAAA,MAAAD,EAAAX,0BAAA,OAAAW,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/CurrencyFormatterPlugin.ts

@@ -14,7 +14,7 @@ import NumberFormat from "sap/ui/core/format/NumberFormat";
  * @public
  */
 export class CurrencyFormatterPlugin implements IFormatter {
-    private currencyFormat: any;
+    private currencyFormat: NumberFormat;
 
     constructor() {
         this.currencyFormat = NumberFormat.getCurrencyInstance({
@@ -27,7 +27,7 @@ export class CurrencyFormatterPlugin implements IFormatter {
      * @param rawValue The raw numeric value from the JSON payload.
      * @returns The formatted string for the UI control.
      */
-    public format(rawValue: unknown, args?: unknown): string {
+    public format(rawValue: string | number, args?: Record<string, string>): string {
         if (rawValue === null || rawValue === undefined) {
             return "";
         }

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/DateFormatterPlugin-dbg.js

@@ -13,6 +13,12 @@ sap.ui.define(["sap/ui/core/format/DateFormat"], function (DateFormat) {
         style: "medium"
       });
     }
+
+    /**
+     * Formats raw JSON model data into a medium-style date string.
+     * @param rawValue The raw date string.
+     * @returns The formatted string for the UI control.
+     */
     format(rawValue, args) {
       if (!rawValue) return "";
       try {

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/DateFormatterPlugin-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"DateFormatterPlugin-dbg.js","names":["DateFormatterPlugin","constructor","dateFormat","DateFormat","getDateInstance","style","format","rawValue","args","dateObj","Date","e","__exports","__esModule"],"sources":["DateFormatterPlugin.ts"],"sourcesContent":["/**\n * @file DateFormatterPlugin.ts\n * @description Standard data formatter for dates.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\nimport DateFormat from \"sap/ui/core/format/DateFormat\";\n\n/**\n * Formats ISO date strings to localized Medium formats (e.g., \"Oct 15, 2026\").\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class DateFormatterPlugin implements IFormatter {\n    private dateFormat: any;\n\n    constructor() {\n        this.dateFormat = DateFormat.getDateInstance({ style: \"medium\" });\n    }\n\n    public format(rawValue: unknown, args?: unknown): string {\n        if (!rawValue) return \"\";\n        try {\n            const dateObj = new Date(rawValue as string);\n            return this.dateFormat.format(dateObj);\n        } catch (e) {\n            return rawValue as string; // Fallback to raw string if invalid date\n        }\n    }\n}\n"],"mappings":";;;EAQA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMA,mBAAmB,CAAuB;IAGnDC,WAAWA,CAAA,EAAG;MACV,IAAI,CAACC,UAAU,GAAGC,UAAU,CAACC,eAAe,CAAC;QAAEC,KAAK,EAAE;MAAS,CAAC,CAAC;IACrE;IAEOC,MAAMA,CAACC,QAAiB,EAAEC,IAAc,EAAU;MACrD,IAAI,CAACD,QAAQ,EAAE,OAAO,EAAE;MACxB,IAAI;QACA,MAAME,OAAO,GAAG,IAAIC,IAAI,CAACH,QAAkB,CAAC;QAC5C,OAAO,IAAI,CAACL,UAAU,CAACI,MAAM,CAACG,OAAO,CAAC;MAC1C,CAAC,CAAC,OAAOE,CAAC,EAAE;QACR,OAAOJ,QAAQ,CAAW,CAAC;MAC/B;IACJ;EACJ;EAAC,IAAAK,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAZ,mBAAA,GAAAA,mBAAA;EAAA,OAAAY,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"DateFormatterPlugin-dbg.js","names":["DateFormatterPlugin","constructor","dateFormat","DateFormat","getDateInstance","style","format","rawValue","args","dateObj","Date","e","__exports","__esModule"],"sources":["DateFormatterPlugin.ts"],"sourcesContent":["/**\n * @file DateFormatterPlugin.ts\n * @description Standard data formatter for dates.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\nimport DateFormat from \"sap/ui/core/format/DateFormat\";\n\n/**\n * Formats ISO date strings to localized Medium formats (e.g., \"Oct 15, 2026\").\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class DateFormatterPlugin implements IFormatter {\n    private dateFormat: DateFormat;\n\n    constructor() {\n        this.dateFormat = DateFormat.getDateInstance({ style: \"medium\" });\n    }\n\n    /**\n     * Formats raw JSON model data into a medium-style date string.\n     * @param rawValue The raw date string.\n     * @returns The formatted string for the UI control.\n     */\n    public format(rawValue: string | number, args?: Record<string, string>): string {\n        if (!rawValue) return \"\";\n        try {\n            const dateObj = new Date(rawValue as string);\n            return this.dateFormat.format(dateObj);\n        } catch (e) {\n            return rawValue as string; // Fallback to raw string if invalid date\n        }\n    }\n}\n"],"mappings":";;;EAQA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMA,mBAAmB,CAAuB;IAGnDC,WAAWA,CAAA,EAAG;MACV,IAAI,CAACC,UAAU,GAAGC,UAAU,CAACC,eAAe,CAAC;QAAEC,KAAK,EAAE;MAAS,CAAC,CAAC;IACrE;;IAEA;AACJ;AACA;AACA;AACA;IACWC,MAAMA,CAACC,QAAyB,EAAEC,IAA6B,EAAU;MAC5E,IAAI,CAACD,QAAQ,EAAE,OAAO,EAAE;MACxB,IAAI;QACA,MAAME,OAAO,GAAG,IAAIC,IAAI,CAACH,QAAkB,CAAC;QAC5C,OAAO,IAAI,CAACL,UAAU,CAACI,MAAM,CAACG,OAAO,CAAC;MAC1C,CAAC,CAAC,OAAOE,CAAC,EAAE;QACR,OAAOJ,QAAQ,CAAW,CAAC;MAC/B;IACJ;EACJ;EAAC,IAAAK,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAZ,mBAAA,GAAAA,mBAAA;EAAA,OAAAY,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/DateFormatterPlugin.d.ts

@@ -13,7 +13,12 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/formatters/DateFormatterPlugi
     export class DateFormatterPlugin implements IFormatter {
         private dateFormat;
         constructor();
-        format(rawValue: unknown, args?: unknown): string;
+        /**
+         * Formats raw JSON model data into a medium-style date string.
+         * @param rawValue The raw date string.
+         * @returns The formatted string for the UI control.
+         */
+        format(rawValue: string | number, args?: Record<string, string>): string;
     }
 }
 //# sourceMappingURL=DateFormatterPlugin.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/DateFormatterPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DateFormatterPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/formatters/DateFormatterPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,mEAAmE,CAAC;IACnF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAC;IAG7E;;;;;OAKG;IACH,MAAa,mBAAoB,YAAW,UAAU;QAClD,OAAO,CAAC,UAAU,CAAM;;QAMjB,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM;KAS3D;CAEA"}
+{"version":3,"file":"DateFormatterPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/formatters/DateFormatterPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,mEAAmE,CAAC;IACnF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAC;IAG7E;;;;;OAKG;IACH,MAAa,mBAAoB,YAAW,UAAU;QAClD,OAAO,CAAC,UAAU,CAAa;;QAM/B;;;;WAIG;QACI,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;KASlF;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/DateFormatterPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"DateFormatterPlugin.js","names":["DateFormatterPlugin","constructor","this","dateFormat","DateFormat","getDateInstance","style","format","rawValue","args","dateObj","Date","e","__exports","__esModule"],"sources":["DateFormatterPlugin.ts"],"sourcesContent":["/**\n * @file DateFormatterPlugin.ts\n * @description Standard data formatter for dates.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\nimport DateFormat from \"sap/ui/core/format/DateFormat\";\n\n/**\n * Formats ISO date strings to localized Medium formats (e.g., \"Oct 15, 2026\").\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class DateFormatterPlugin implements IFormatter {\n    private dateFormat: any;\n\n    constructor() {\n        this.dateFormat = DateFormat.getDateInstance({ style: \"medium\" });\n    }\n\n    public format(rawValue: unknown, args?: unknown): string {\n        if (!rawValue) return \"\";\n        try {\n            const dateObj = new Date(rawValue as string);\n            return this.dateFormat.format(dateObj);\n        } catch (e) {\n            return rawValue as string; // Fallback to raw string if invalid date\n        }\n    }\n}\n"],"mappings":"yEAcO,MAAMA,EAGTC,cACIC,KAAKC,WAAaC,EAAWC,gBAAgB,CAAEC,MAAO,UAC1D,CAEOC,OAAOC,EAAmBC,GAC7B,IAAKD,EAAU,MAAO,GACtB,IACI,MAAME,EAAU,IAAIC,KAAKH,GACzB,OAAON,KAAKC,WAAWI,OAAOG,EAClC,CAAE,MAAOE,GACL,OAAOJ,CACX,CACJ,EACH,IAAAK,EAAA,CAAAC,WAAA,MAAAD,EAAAb,sBAAA,OAAAa,CAAA","ignoreList":[]}
+{"version":3,"file":"DateFormatterPlugin.js","names":["DateFormatterPlugin","constructor","this","dateFormat","DateFormat","getDateInstance","style","format","rawValue","args","dateObj","Date","e","__exports","__esModule"],"sources":["DateFormatterPlugin.ts"],"sourcesContent":["/**\n * @file DateFormatterPlugin.ts\n * @description Standard data formatter for dates.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\nimport DateFormat from \"sap/ui/core/format/DateFormat\";\n\n/**\n * Formats ISO date strings to localized Medium formats (e.g., \"Oct 15, 2026\").\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class DateFormatterPlugin implements IFormatter {\n    private dateFormat: DateFormat;\n\n    constructor() {\n        this.dateFormat = DateFormat.getDateInstance({ style: \"medium\" });\n    }\n\n    /**\n     * Formats raw JSON model data into a medium-style date string.\n     * @param rawValue The raw date string.\n     * @returns The formatted string for the UI control.\n     */\n    public format(rawValue: string | number, args?: Record<string, string>): string {\n        if (!rawValue) return \"\";\n        try {\n            const dateObj = new Date(rawValue as string);\n            return this.dateFormat.format(dateObj);\n        } catch (e) {\n            return rawValue as string; // Fallback to raw string if invalid date\n        }\n    }\n}\n"],"mappings":"yEAcO,MAAMA,EAGTC,cACIC,KAAKC,WAAaC,EAAWC,gBAAgB,CAAEC,MAAO,UAC1D,CAOOC,OAAOC,EAA2BC,GACrC,IAAKD,EAAU,MAAO,GACtB,IACI,MAAME,EAAU,IAAIC,KAAKH,GACzB,OAAON,KAAKC,WAAWI,OAAOG,EAClC,CAAE,MAAOE,GACL,OAAOJ,CACX,CACJ,EACH,IAAAK,EAAA,CAAAC,WAAA,MAAAD,EAAAb,sBAAA,OAAAa,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/DateFormatterPlugin.ts

@@ -13,13 +13,18 @@ import DateFormat from "sap/ui/core/format/DateFormat";
  * @public
  */
 export class DateFormatterPlugin implements IFormatter {
-    private dateFormat: any;
+    private dateFormat: DateFormat;
 
     constructor() {
         this.dateFormat = DateFormat.getDateInstance({ style: "medium" });
     }
 
-    public format(rawValue: unknown, args?: unknown): string {
+    /**
+     * Formats raw JSON model data into a medium-style date string.
+     * @param rawValue The raw date string.
+     * @returns The formatted string for the UI control.
+     */
+    public format(rawValue: string | number, args?: Record<string, string>): string {
         if (!rawValue) return "";
         try {
             const dateObj = new Date(rawValue as string);

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/PhoneFormatterPlugin-dbg.js

@@ -13,6 +13,11 @@ sap.ui.define([], function () {
    * @public
    */
   class PhoneFormatterPlugin {
+    /**
+     * Formats raw JSON model data into a masked phone number.
+     * @param rawValue The raw phone string.
+     * @returns The formatted string for the UI control.
+     */
     format(rawValue, args) {
       if (!rawValue || typeof rawValue !== "string") return rawValue || "";
       const cleaned = ('' + rawValue).replace(/\D/g, '');

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/PhoneFormatterPlugin-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"PhoneFormatterPlugin-dbg.js","names":["PhoneFormatterPlugin","format","rawValue","args","cleaned","replace","match","__exports","__esModule"],"sources":["PhoneFormatterPlugin.ts"],"sourcesContent":["/**\n * @file PhoneFormatterPlugin.ts\n * @description Standard data formatter for phone numbers.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\n\n/**\n * Simple mask for 10-digit phone numbers (e.g. 5551234567 -> (555) 123-4567).\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class PhoneFormatterPlugin implements IFormatter {\n    public format(rawValue: unknown, args?: unknown): string {\n        if (!rawValue || typeof rawValue !== \"string\") return rawValue || \"\";\n        \n        const cleaned = ('' + rawValue).replace(/\\D/g, '');\n        const match = cleaned.match(/^(\\d{3})(\\d{3})(\\d{4})$/);\n        \n        if (match) {\n            return '(' + match[1] + ') ' + match[2] + '-' + match[3];\n        }\n        \n        return rawValue as string;\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;;EAIA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMA,oBAAoB,CAAuB;IAC7CC,MAAMA,CAACC,QAAiB,EAAEC,IAAc,EAAU;MACrD,IAAI,CAACD,QAAQ,IAAI,OAAOA,QAAQ,KAAK,QAAQ,EAAE,OAAOA,QAAQ,IAAI,EAAE;MAEpE,MAAME,OAAO,GAAG,CAAC,EAAE,GAAGF,QAAQ,EAAEG,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;MAClD,MAAMC,KAAK,GAAGF,OAAO,CAACE,KAAK,CAAC,yBAAyB,CAAC;MAEtD,IAAIA,KAAK,EAAE;QACP,OAAO,GAAG,GAAGA,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,GAAGA,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,GAAGA,KAAK,CAAC,CAAC,CAAC;MAC5D;MAEA,OAAOJ,QAAQ;IACnB;EACJ;EAAC,IAAAK,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAP,oBAAA,GAAAA,oBAAA;EAAA,OAAAO,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"PhoneFormatterPlugin-dbg.js","names":["PhoneFormatterPlugin","format","rawValue","args","cleaned","replace","match","__exports","__esModule"],"sources":["PhoneFormatterPlugin.ts"],"sourcesContent":["/**\n * @file PhoneFormatterPlugin.ts\n * @description Standard data formatter for phone numbers.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\n\n/**\n * Simple mask for 10-digit phone numbers (e.g. 5551234567 -> (555) 123-4567).\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class PhoneFormatterPlugin implements IFormatter {\n    /**\n     * Formats raw JSON model data into a masked phone number.\n     * @param rawValue The raw phone string.\n     * @returns The formatted string for the UI control.\n     */\n    public format(rawValue: string | number, args?: Record<string, string>): string {\n        if (!rawValue || typeof rawValue !== \"string\") return rawValue || \"\";\n        \n        const cleaned = ('' + rawValue).replace(/\\D/g, '');\n        const match = cleaned.match(/^(\\d{3})(\\d{3})(\\d{4})$/);\n        \n        if (match) {\n            return '(' + match[1] + ') ' + match[2] + '-' + match[3];\n        }\n        \n        return rawValue as string;\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;;EAIA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMA,oBAAoB,CAAuB;IACpD;AACJ;AACA;AACA;AACA;IACWC,MAAMA,CAACC,QAAyB,EAAEC,IAA6B,EAAU;MAC5E,IAAI,CAACD,QAAQ,IAAI,OAAOA,QAAQ,KAAK,QAAQ,EAAE,OAAOA,QAAQ,IAAI,EAAE;MAEpE,MAAME,OAAO,GAAG,CAAC,EAAE,GAAGF,QAAQ,EAAEG,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;MAClD,MAAMC,KAAK,GAAGF,OAAO,CAACE,KAAK,CAAC,yBAAyB,CAAC;MAEtD,IAAIA,KAAK,EAAE;QACP,OAAO,GAAG,GAAGA,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,GAAGA,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,GAAGA,KAAK,CAAC,CAAC,CAAC;MAC5D;MAEA,OAAOJ,QAAQ;IACnB;EACJ;EAAC,IAAAK,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAP,oBAAA,GAAAA,oBAAA;EAAA,OAAAO,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/PhoneFormatterPlugin.d.ts

@@ -11,7 +11,12 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/formatters/PhoneFormatterPlug
      * @public
      */
     export class PhoneFormatterPlugin implements IFormatter {
-        format(rawValue: unknown, args?: unknown): string;
+        /**
+         * Formats raw JSON model data into a masked phone number.
+         * @param rawValue The raw phone string.
+         * @returns The formatted string for the UI control.
+         */
+        format(rawValue: string | number, args?: Record<string, string>): string;
     }
 }
 //# sourceMappingURL=PhoneFormatterPlugin.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/PhoneFormatterPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PhoneFormatterPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/formatters/PhoneFormatterPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,oEAAoE,CAAC;IACpF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAC;IAE7E;;;;;OAKG;IACH,MAAa,oBAAqB,YAAW,UAAU;QAC5C,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM;KAY3D;CAEA"}
+{"version":3,"file":"PhoneFormatterPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/formatters/PhoneFormatterPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,oEAAoE,CAAC;IACpF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAC;IAE7E;;;;;OAKG;IACH,MAAa,oBAAqB,YAAW,UAAU;QACnD;;;;WAIG;QACI,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;KAYlF;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/PhoneFormatterPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"PhoneFormatterPlugin.js","names":["PhoneFormatterPlugin","format","rawValue","args","cleaned","replace","match","__exports","__esModule"],"sources":["PhoneFormatterPlugin.ts"],"sourcesContent":["/**\n * @file PhoneFormatterPlugin.ts\n * @description Standard data formatter for phone numbers.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\n\n/**\n * Simple mask for 10-digit phone numbers (e.g. 5551234567 -> (555) 123-4567).\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class PhoneFormatterPlugin implements IFormatter {\n    public format(rawValue: unknown, args?: unknown): string {\n        if (!rawValue || typeof rawValue !== \"string\") return rawValue || \"\";\n        \n        const cleaned = ('' + rawValue).replace(/\\D/g, '');\n        const match = cleaned.match(/^(\\d{3})(\\d{3})(\\d{4})$/);\n        \n        if (match) {\n            return '(' + match[1] + ') ' + match[2] + '-' + match[3];\n        }\n        \n        return rawValue as string;\n    }\n}\n"],"mappings":"yCAaO,MAAMA,EACFC,OAAOC,EAAmBC,GAC7B,IAAKD,UAAmBA,IAAa,SAAU,OAAOA,GAAY,GAElE,MAAME,GAAW,GAAKF,GAAUG,QAAQ,MAAO,IAC/C,MAAMC,EAAQF,EAAQE,MAAM,2BAE5B,GAAIA,EAAO,CACP,MAAO,IAAMA,EAAM,GAAK,KAAOA,EAAM,GAAK,IAAMA,EAAM,EAC1D,CAEA,OAAOJ,CACX,EACH,IAAAK,EAAA,CAAAC,WAAA,MAAAD,EAAAP,uBAAA,OAAAO,CAAA","ignoreList":[]}
+{"version":3,"file":"PhoneFormatterPlugin.js","names":["PhoneFormatterPlugin","format","rawValue","args","cleaned","replace","match","__exports","__esModule"],"sources":["PhoneFormatterPlugin.ts"],"sourcesContent":["/**\n * @file PhoneFormatterPlugin.ts\n * @description Standard data formatter for phone numbers.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\n\n/**\n * Simple mask for 10-digit phone numbers (e.g. 5551234567 -> (555) 123-4567).\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class PhoneFormatterPlugin implements IFormatter {\n    /**\n     * Formats raw JSON model data into a masked phone number.\n     * @param rawValue The raw phone string.\n     * @returns The formatted string for the UI control.\n     */\n    public format(rawValue: string | number, args?: Record<string, string>): string {\n        if (!rawValue || typeof rawValue !== \"string\") return rawValue || \"\";\n        \n        const cleaned = ('' + rawValue).replace(/\\D/g, '');\n        const match = cleaned.match(/^(\\d{3})(\\d{3})(\\d{4})$/);\n        \n        if (match) {\n            return '(' + match[1] + ') ' + match[2] + '-' + match[3];\n        }\n        \n        return rawValue as string;\n    }\n}\n"],"mappings":"yCAaO,MAAMA,EAMFC,OAAOC,EAA2BC,GACrC,IAAKD,UAAmBA,IAAa,SAAU,OAAOA,GAAY,GAElE,MAAME,GAAW,GAAKF,GAAUG,QAAQ,MAAO,IAC/C,MAAMC,EAAQF,EAAQE,MAAM,2BAE5B,GAAIA,EAAO,CACP,MAAO,IAAMA,EAAM,GAAK,KAAOA,EAAM,GAAK,IAAMA,EAAM,EAC1D,CAEA,OAAOJ,CACX,EACH,IAAAK,EAAA,CAAAC,WAAA,MAAAD,EAAAP,uBAAA,OAAAO,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/PhoneFormatterPlugin.ts

@@ -12,7 +12,12 @@ import { IFormatter } from "../../interfaces/IPipeline";
  * @public
  */
 export class PhoneFormatterPlugin implements IFormatter {
-    public format(rawValue: unknown, args?: unknown): string {
+    /**
+     * Formats raw JSON model data into a masked phone number.
+     * @param rawValue The raw phone string.
+     * @returns The formatted string for the UI control.
+     */
+    public format(rawValue: string | number, args?: Record<string, string>): string {
         if (!rawValue || typeof rawValue !== "string") return rawValue || "";
         
         const cleaned = ('' + rawValue).replace(/\D/g, '');

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/TextCaseFormatterPlugin-dbg.js

@@ -14,6 +14,11 @@ sap.ui.define([], function () {
    * @public
    */
   class TextCaseFormatterPlugin {
+    /**
+     * Formats raw JSON model data into uppercase.
+     * @param rawValue The raw string.
+     * @returns The uppercase formatted string for the UI control.
+     */
     format(rawValue, args) {
       if (typeof rawValue !== "string") return rawValue || "";
 

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/TextCaseFormatterPlugin-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"TextCaseFormatterPlugin-dbg.js","names":["TextCaseFormatterPlugin","format","rawValue","args","toUpperCase","__exports","__esModule"],"sources":["TextCaseFormatterPlugin.ts"],"sourcesContent":["/**\n * @file TextCaseFormatterPlugin.ts\n * @description Standard data formatter for text casing.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\n\n/**\n * Transforms text to UPPERCASE, lowercase, or Title Case.\n * Defaults to uppercase.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class TextCaseFormatterPlugin implements IFormatter {\n    public format(rawValue: unknown, args?: unknown): string {\n        if (typeof rawValue !== \"string\") return rawValue || \"\";\n        \n        // Default to uppercase if no specific arg could be easily parsed by simple formatter \n        // (could be enhanced to support schema args if formatters allowed args).\n        return rawValue.toUpperCase();\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;;EAIA;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMA,uBAAuB,CAAuB;IAChDC,MAAMA,CAACC,QAAiB,EAAEC,IAAc,EAAU;MACrD,IAAI,OAAOD,QAAQ,KAAK,QAAQ,EAAE,OAAOA,QAAQ,IAAI,EAAE;;MAEvD;MACA;MACA,OAAOA,QAAQ,CAACE,WAAW,CAAC,CAAC;IACjC;EACJ;EAAC,IAAAC,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAL,uBAAA,GAAAA,uBAAA;EAAA,OAAAK,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"TextCaseFormatterPlugin-dbg.js","names":["TextCaseFormatterPlugin","format","rawValue","args","toUpperCase","__exports","__esModule"],"sources":["TextCaseFormatterPlugin.ts"],"sourcesContent":["/**\n * @file TextCaseFormatterPlugin.ts\n * @description Standard data formatter for text casing.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\n\n/**\n * Transforms text to UPPERCASE, lowercase, or Title Case.\n * Defaults to uppercase.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class TextCaseFormatterPlugin implements IFormatter {\n    /**\n     * Formats raw JSON model data into uppercase.\n     * @param rawValue The raw string.\n     * @returns The uppercase formatted string for the UI control.\n     */\n    public format(rawValue: string | number, args?: Record<string, string>): string {\n        if (typeof rawValue !== \"string\") return rawValue || \"\";\n        \n        // Default to uppercase if no specific arg could be easily parsed by simple formatter \n        // (could be enhanced to support schema args if formatters allowed args).\n        return rawValue.toUpperCase();\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;;EAIA;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMA,uBAAuB,CAAuB;IACvD;AACJ;AACA;AACA;AACA;IACWC,MAAMA,CAACC,QAAyB,EAAEC,IAA6B,EAAU;MAC5E,IAAI,OAAOD,QAAQ,KAAK,QAAQ,EAAE,OAAOA,QAAQ,IAAI,EAAE;;MAEvD;MACA;MACA,OAAOA,QAAQ,CAACE,WAAW,CAAC,CAAC;IACjC;EACJ;EAAC,IAAAC,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAL,uBAAA,GAAAA,uBAAA;EAAA,OAAAK,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/TextCaseFormatterPlugin.d.ts

@@ -12,7 +12,12 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/formatters/TextCaseFormatterP
      * @public
      */
     export class TextCaseFormatterPlugin implements IFormatter {
-        format(rawValue: unknown, args?: unknown): string;
+        /**
+         * Formats raw JSON model data into uppercase.
+         * @param rawValue The raw string.
+         * @returns The uppercase formatted string for the UI control.
+         */
+        format(rawValue: string | number, args?: Record<string, string>): string;
     }
 }
 //# sourceMappingURL=TextCaseFormatterPlugin.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/TextCaseFormatterPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextCaseFormatterPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/formatters/TextCaseFormatterPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,uEAAuE,CAAC;IACvF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAC;IAE7E;;;;;;OAMG;IACH,MAAa,uBAAwB,YAAW,UAAU;QAC/C,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM;KAO3D;CAEA"}
+{"version":3,"file":"TextCaseFormatterPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/formatters/TextCaseFormatterPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,uEAAuE,CAAC;IACvF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAC;IAE7E;;;;;;OAMG;IACH,MAAa,uBAAwB,YAAW,UAAU;QACtD;;;;WAIG;QACI,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;KAOlF;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/TextCaseFormatterPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"TextCaseFormatterPlugin.js","names":["TextCaseFormatterPlugin","format","rawValue","args","toUpperCase","__exports","__esModule"],"sources":["TextCaseFormatterPlugin.ts"],"sourcesContent":["/**\n * @file TextCaseFormatterPlugin.ts\n * @description Standard data formatter for text casing.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\n\n/**\n * Transforms text to UPPERCASE, lowercase, or Title Case.\n * Defaults to uppercase.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class TextCaseFormatterPlugin implements IFormatter {\n    public format(rawValue: unknown, args?: unknown): string {\n        if (typeof rawValue !== \"string\") return rawValue || \"\";\n        \n        // Default to uppercase if no specific arg could be easily parsed by simple formatter \n        // (could be enhanced to support schema args if formatters allowed args).\n        return rawValue.toUpperCase();\n    }\n}\n"],"mappings":"yCAcO,MAAMA,EACFC,OAAOC,EAAmBC,GAC7B,UAAWD,IAAa,SAAU,OAAOA,GAAY,GAIrD,OAAOA,EAASE,aACpB,EACH,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAAL,0BAAA,OAAAK,CAAA","ignoreList":[]}
+{"version":3,"file":"TextCaseFormatterPlugin.js","names":["TextCaseFormatterPlugin","format","rawValue","args","toUpperCase","__exports","__esModule"],"sources":["TextCaseFormatterPlugin.ts"],"sourcesContent":["/**\n * @file TextCaseFormatterPlugin.ts\n * @description Standard data formatter for text casing.\n */\n\nimport { IFormatter } from \"../../interfaces/IPipeline\";\n\n/**\n * Transforms text to UPPERCASE, lowercase, or Title Case.\n * Defaults to uppercase.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.formatters\n * @public\n */\nexport class TextCaseFormatterPlugin implements IFormatter {\n    /**\n     * Formats raw JSON model data into uppercase.\n     * @param rawValue The raw string.\n     * @returns The uppercase formatted string for the UI control.\n     */\n    public format(rawValue: string | number, args?: Record<string, string>): string {\n        if (typeof rawValue !== \"string\") return rawValue || \"\";\n        \n        // Default to uppercase if no specific arg could be easily parsed by simple formatter \n        // (could be enhanced to support schema args if formatters allowed args).\n        return rawValue.toUpperCase();\n    }\n}\n"],"mappings":"yCAcO,MAAMA,EAMFC,OAAOC,EAA2BC,GACrC,UAAWD,IAAa,SAAU,OAAOA,GAAY,GAIrD,OAAOA,EAASE,aACpB,EACH,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAAL,0BAAA,OAAAK,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/formatters/TextCaseFormatterPlugin.ts

@@ -13,7 +13,12 @@ import { IFormatter } from "../../interfaces/IPipeline";
  * @public
  */
 export class TextCaseFormatterPlugin implements IFormatter {
-    public format(rawValue: unknown, args?: unknown): string {
+    /**
+     * Formats raw JSON model data into uppercase.
+     * @param rawValue The raw string.
+     * @returns The uppercase formatted string for the UI control.
+     */
+    public format(rawValue: string | number, args?: Record<string, string>): string {
         if (typeof rawValue !== "string") return rawValue || "";
         
         // Default to uppercase if no specific arg could be easily parsed by simple formatter