@siliconst/metaui 1.4.6 → 1.4.8

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

@@ -1,4 +1,4 @@
-sap.ui.define(["../controls/BasePlugin", "../../controls/VoiceInputControl"], function (___controls_BasePlugin, __VoiceInputControl) {
+sap.ui.define(["../controls/BasePlugin", "../../controls/VoiceInputControl", "sap/m/Text"], function (___controls_BasePlugin, __VoiceInputControl, TextControl) {
   "use strict";
 
   function _interopRequireDefault(obj) {
@@ -7,14 +7,22 @@ sap.ui.define(["../controls/BasePlugin", "../../controls/VoiceInputControl"], fu
   const BasePlugin = ___controls_BasePlugin["BasePlugin"];
   const VoiceInputControl = _interopRequireDefault(__VoiceInputControl);
   class VoiceInputPlugin extends BasePlugin {
+    /**
+     * Renders a `VoiceInputControl` 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 VoiceInputControl.
+     */
     render(metadata, bindingPath, modelName = "meta", engineScopeId, onChange) {
       this.onChange = onChange;
       this.metadata = metadata;
       this.fieldKey = bindingPath.replace('/', '');
       this.modelName = modelName;
       if (!this.isEditable) {
-        sap.ui.requireSync("sap/m/Text");
-        const TextControl = sap.ui.require("sap/m/Text");
         this.control = new TextControl({
           id: this.generateStableId(engineScopeId, bindingPath),
           text: {
@@ -43,9 +51,18 @@ sap.ui.define(["../controls/BasePlugin", "../../controls/VoiceInputControl"], fu
       });
       return this.control;
     }
+
+    /**
+     * Retrieves the current voice transcription text.
+     * @returns {unknown} The text string.
+     */
     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/VoiceInputPlugin-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"VoiceInputPlugin-dbg.js","names":["BasePlugin","___controls_BasePlugin","VoiceInputControl","_interopRequireDefault","__VoiceInputControl","VoiceInputPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","fieldKey","replace","isEditable","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","path","formatter","val","applyCommonDirectives","value","schemaMetadata","readOnly","attachCapture","result","validate","isValid","getValue","applyState","setProperty","__exports","__esModule"],"sources":["VoiceInputPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport VoiceInputControl from \"../../controls/VoiceInputControl\";\n\nexport class VoiceInputPlugin 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 as unknown as { requireSync: (s: string) => unknown }).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) => {\n                        if (!val || val === \"undefined\" || val === \"null\") return \"\";\n                        return val;\n                    }\n                }\n            }) as unknown as sap.ui.core.Control;\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.control = new VoiceInputControl({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            value: `{${modelName}>${bindingPath}}`,\n            schemaMetadata: metadata,\n            readOnly: !!metadata.ui?.readOnly\n        }) as unknown as sap.ui.core.Control;\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 sap.ui.core.Control).setProperty(\"readOnly\", !!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":";;;;;;QAASA,UAAU,GAAAC,sBAAA;EAAA,MAGZC,iBAAiB,GAAAC,sBAAA,CAAAC,mBAAA;EAEjB,MAAMC,gBAAgB,SAASL,UAAU,CAAC;IACtCM,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;QACjBC,GAAG,CAACC,EAAE,CAAwDC,WAAW,CAAC,YAAY,CAAC;QACxF,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,IAAK;cACzB,IAAI,CAACA,GAAG,IAAIA,GAAG,KAAK,WAAW,IAAIA,GAAG,KAAK,MAAM,EAAE,OAAO,EAAE;cAC5D,OAAOA,GAAG;YACd;UACJ;QACJ,CAAC,CAAmC;QACpC,IAAI,CAACC,qBAAqB,CAAC,IAAI,CAACP,OAAO,EAAEb,QAAQ,EAAEE,SAAS,CAAC;QAC7D,OAAO,IAAI,CAACW,OAAO;MACvB;MAEA,IAAI,CAACA,OAAO,GAAG,IAAIlB,iBAAiB,CAAC;QACjCmB,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAACZ,aAAa,EAAEF,WAAW,CAAC;QACrDoB,KAAK,EAAE,IAAInB,SAAS,IAAID,WAAW,GAAG;QACtCqB,cAAc,EAAEtB,QAAQ;QACxBuB,QAAQ,EAAE,CAAC,CAACvB,QAAQ,CAACS,EAAE,EAAEc;MAC7B,CAAC,CAAmC;MAEpC,IAAI,CAACH,qBAAqB,CAAC,IAAI,CAACP,OAAO,EAAEb,QAAQ,EAAEE,SAAS,CAAC;MAE5D,IAAI,CAACW,OAAO,CAA0DW,aAAa,CAAC,MAAM;QACvF,MAAMC,MAAM,GAAG,IAAI,CAACC,QAAQ,CAAC,CAAC;QAC1B,IAAI,IAAI,CAACtB,QAAQ,EAAE;UACf,IAAI,CAACA,QAAQ,CAACqB,MAAM,CAACE,OAAO,EAAE,IAAI,CAACtB,QAAQ,CAAC;QAChD;MACR,CAAC,CAAC;MAEF,OAAO,IAAI,CAACQ,OAAO;IACvB;IAEUe,QAAQA,CAAA,EAAQ;MACtB,OAAO,IAAI,CAACf,OAAO,GAAI,IAAI,CAACA,OAAO,CAA4Ce,QAAQ,CAAC,CAAC,GAAG,IAAI;IACpG;IAEUC,UAAUA,CAAA,EAAS;MACzB,IAAI,IAAI,CAAChB,OAAO,IAAI,IAAI,CAACb,QAAQ,EAAE;QAC/B,IAAI,CAAC,IAAI,CAACO,UAAU,EAAE;QACrB,IAAI,CAACM,OAAO,CAAyBiB,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC9B,QAAQ,CAACS,EAAE,EAAEc,QAAQ,CAAC;MAC/F;IACJ;EACJ;EAAC,IAAAQ,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAjC,gBAAA,GAAAA,gBAAA;EAAA,OAAAiC,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"VoiceInputPlugin-dbg.js","names":["BasePlugin","___controls_BasePlugin","VoiceInputControl","_interopRequireDefault","__VoiceInputControl","VoiceInputPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","fieldKey","replace","isEditable","control","TextControl","id","generateStableId","text","path","formatter","val","applyCommonDirectives","value","schemaMetadata","readOnly","ui","attachCapture","result","validate","isValid","getValue","applyState","setProperty","__exports","__esModule"],"sources":["VoiceInputPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport VoiceInputControl from \"../../controls/VoiceInputControl\";\nimport TextControl from \"sap/m/Text\";\n\nexport class VoiceInputPlugin extends BasePlugin {\n    /**\n     * Renders a `VoiceInputControl` 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 VoiceInputControl.\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            \n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: {\n                    path: `${modelName}>${bindingPath}`,\n                    formatter: (val: unknown) => {\n                        if (!val || val === \"undefined\" || val === \"null\") return \"\";\n                        return val;\n                    }\n                }\n            }) as Control;\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.control = new VoiceInputControl({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            value: `{${modelName}>${bindingPath}}`,\n            schemaMetadata: metadata,\n            readOnly: !!metadata.ui?.readOnly\n        }) as Control;\n\n        this.applyCommonDirectives(this.control, metadata, modelName);\n\n        (this.control as VoiceInputControl).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 voice transcription text.\n     * @returns {unknown} The text string.\n     */\n    protected getValue(): unknown {\n        return this.control ? (this.control as VoiceInputControl).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 sap.ui.core.Control).setProperty(\"readOnly\", !!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":";;;;;;QAASA,UAAU,GAAAC,sBAAA;EAAA,MAGZC,iBAAiB,GAAAC,sBAAA,CAAAC,mBAAA;EAGjB,MAAMC,gBAAgB,SAASL,UAAU,CAAC;IAC7C;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACWM,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;QAElB,IAAI,CAACC,OAAO,GAAG,IAAIC,WAAW,CAAC;UAC3BC,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAACR,aAAa,EAAEF,WAAW,CAAC;UACrDW,IAAI,EAAE;YACFC,IAAI,EAAE,GAAGX,SAAS,IAAID,WAAW,EAAE;YACnCa,SAAS,EAAGC,GAAY,IAAK;cACzB,IAAI,CAACA,GAAG,IAAIA,GAAG,KAAK,WAAW,IAAIA,GAAG,KAAK,MAAM,EAAE,OAAO,EAAE;cAC5D,OAAOA,GAAG;YACd;UACJ;QACJ,CAAC,CAAY;QACb,IAAI,CAACC,qBAAqB,CAAC,IAAI,CAACR,OAAO,EAAER,QAAQ,EAAEE,SAAS,CAAC;QAC7D,OAAO,IAAI,CAACM,OAAO;MACvB;MAEA,IAAI,CAACA,OAAO,GAAG,IAAIb,iBAAiB,CAAC;QACjCe,EAAE,EAAE,IAAI,CAACC,gBAAgB,CAACR,aAAa,EAAEF,WAAW,CAAC;QACrDgB,KAAK,EAAE,IAAIf,SAAS,IAAID,WAAW,GAAG;QACtCiB,cAAc,EAAElB,QAAQ;QACxBmB,QAAQ,EAAE,CAAC,CAACnB,QAAQ,CAACoB,EAAE,EAAED;MAC7B,CAAC,CAAY;MAEb,IAAI,CAACH,qBAAqB,CAAC,IAAI,CAACR,OAAO,EAAER,QAAQ,EAAEE,SAAS,CAAC;MAE5D,IAAI,CAACM,OAAO,CAAuBa,aAAa,CAAC,MAAM;QACpD,MAAMC,MAAM,GAAG,IAAI,CAACC,QAAQ,CAAC,CAAC;QAC1B,IAAI,IAAI,CAACnB,QAAQ,EAAE;UACf,IAAI,CAACA,QAAQ,CAACkB,MAAM,CAACE,OAAO,EAAE,IAAI,CAACnB,QAAQ,CAAC;QAChD;MACR,CAAC,CAAC;MAEF,OAAO,IAAI,CAACG,OAAO;IACvB;;IAEA;AACJ;AACA;AACA;IACciB,QAAQA,CAAA,EAAY;MAC1B,OAAO,IAAI,CAACjB,OAAO,GAAI,IAAI,CAACA,OAAO,CAAuBiB,QAAQ,CAAC,CAAC,GAAG,IAAI;IAC/E;;IAEA;AACJ;AACA;IACcC,UAAUA,CAAA,EAAS;MACzB,IAAI,IAAI,CAAClB,OAAO,IAAI,IAAI,CAACR,QAAQ,EAAE;QAC/B,IAAI,CAAC,IAAI,CAACO,UAAU,EAAE;QACrB,IAAI,CAACC,OAAO,CAAyBmB,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC3B,QAAQ,CAACoB,EAAE,EAAED,QAAQ,CAAC;MAC/F;IACJ;EACJ;EAAC,IAAAS,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAA9B,gBAAA,GAAAA,gBAAA;EAAA,OAAA8B,SAAA;AAAA","ignoreList":[]}

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

@@ -3,8 +3,25 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/controls/VoiceInputPlugin" {
     import { IPropertyMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
     import Control from "sap/ui/core/Control";
     export class VoiceInputPlugin extends BasePlugin {
+        /**
+         * Renders a `VoiceInputControl` 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 VoiceInputControl.
+         */
         render(metadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control;
-        protected getValue(): any;
+        /**
+         * Retrieves the current voice transcription text.
+         * @returns {unknown} The text string.
+         */
+        protected getValue(): unknown;
+        /**
+         * Applies dynamic read-only state.
+         */
         protected applyState(): void;
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"VoiceInputPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/VoiceInputPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,8DAA8D,CAAC;IAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAClF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAG1C,MAAa,gBAAiB,SAAQ,UAAU;QACrC,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;QA0CxL,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB,SAAS,CAAC,UAAU,IAAI,IAAI;KAM/B;CAEA"}
+{"version":3,"file":"VoiceInputPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/VoiceInputPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,8DAA8D,CAAC;IAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAClF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAI1C,MAAa,gBAAiB,SAAQ,UAAU;QAC5C;;;;;;;;;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;QAyCxL;;;WAGG;QACH,SAAS,CAAC,QAAQ,IAAI,OAAO;QAI7B;;WAEG;QACH,SAAS,CAAC,UAAU,IAAI,IAAI;KAM/B;CAEA"}

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

@@ -1,2 +1,2 @@
-sap.ui.define(["../controls/BasePlugin","../../controls/VoiceInputControl"],function(t,e){"use strict";function i(t){return t&&t.__esModule&&typeof t.default!=="undefined"?t.default:t}const n=t["BasePlugin"];const a=i(e);class s extends n{render(t,e,i="meta",n,s){this.onChange=s;this.metadata=t;this.fieldKey=e.replace("/","");this.modelName=i;if(!this.isEditable){sap.ui.requireSync("sap/m/Text");const a=sap.ui.require("sap/m/Text");this.control=new a({id:this.generateStableId(n,e),text:{path:`${i}>${e}`,formatter:t=>{if(!t||t==="undefined"||t==="null")return"";return t}}});this.applyCommonDirectives(this.control,t,i);return this.control}this.control=new a({id:this.generateStableId(n,e),value:`{${i}>${e}}`,schemaMetadata:t,readOnly:!!t.ui?.readOnly});this.applyCommonDirectives(this.control,t,i);this.control.attachCapture(()=>{const t=this.validate();if(this.onChange){this.onChange(t.isValid,this.fieldKey)}});return this.control}getValue(){return this.control?this.control.getValue():null}applyState(){if(this.control&&this.metadata){if(!this.isEditable)return;this.control.setProperty("readOnly",!!this.metadata.ui?.readOnly)}}}var r={__esModule:true};r.VoiceInputPlugin=s;return r});
+sap.ui.define(["../controls/BasePlugin","../../controls/VoiceInputControl","sap/m/Text"],function(t,e,i){"use strict";function n(t){return t&&t.__esModule&&typeof t.default!=="undefined"?t.default:t}const a=t["BasePlugin"];const s=n(e);class r extends a{render(t,e,n="meta",a,r){this.onChange=r;this.metadata=t;this.fieldKey=e.replace("/","");this.modelName=n;if(!this.isEditable){this.control=new i({id:this.generateStableId(a,e),text:{path:`${n}>${e}`,formatter:t=>{if(!t||t==="undefined"||t==="null")return"";return t}}});this.applyCommonDirectives(this.control,t,n);return this.control}this.control=new s({id:this.generateStableId(a,e),value:`{${n}>${e}}`,schemaMetadata:t,readOnly:!!t.ui?.readOnly});this.applyCommonDirectives(this.control,t,n);this.control.attachCapture(()=>{const t=this.validate();if(this.onChange){this.onChange(t.isValid,this.fieldKey)}});return this.control}getValue(){return this.control?this.control.getValue():null}applyState(){if(this.control&&this.metadata){if(!this.isEditable)return;this.control.setProperty("readOnly",!!this.metadata.ui?.readOnly)}}}var o={__esModule:true};o.VoiceInputPlugin=r;return o});
 //# sourceMappingURL=VoiceInputPlugin.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"VoiceInputPlugin.js","names":["BasePlugin","___controls_BasePlugin","VoiceInputControl","_interopRequireDefault","__VoiceInputControl","VoiceInputPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","this","fieldKey","replace","isEditable","sap","ui","requireSync","TextControl","require","control","id","generateStableId","text","path","formatter","val","applyCommonDirectives","value","schemaMetadata","readOnly","attachCapture","result","validate","isValid","getValue","applyState","setProperty","__exports","__esModule"],"sources":["VoiceInputPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport VoiceInputControl from \"../../controls/VoiceInputControl\";\n\nexport class VoiceInputPlugin 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 as unknown as { requireSync: (s: string) => unknown }).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) => {\n                        if (!val || val === \"undefined\" || val === \"null\") return \"\";\n                        return val;\n                    }\n                }\n            }) as unknown as sap.ui.core.Control;\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.control = new VoiceInputControl({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            value: `{${modelName}>${bindingPath}}`,\n            schemaMetadata: metadata,\n            readOnly: !!metadata.ui?.readOnly\n        }) as unknown as sap.ui.core.Control;\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 sap.ui.core.Control).setProperty(\"readOnly\", !!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"8LAASA,EAAUC,EAAA,oBAGZC,EAAiBC,EAAAC,GAEjB,MAAMC,UAAyBL,EAC3BM,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,CACjBC,IAAIC,GAA0DC,YAAY,cAC3E,MAAMC,EAAcH,IAAIC,GAAGG,QAAQ,cACnCR,KAAKS,QAAU,IAAIF,EAAY,CAC3BG,GAAIV,KAAKW,iBAAiBb,EAAeF,GACzCgB,KAAM,CACFC,KAAM,GAAGhB,KAAaD,IACtBkB,UAAYC,IACR,IAAKA,GAAOA,IAAQ,aAAeA,IAAQ,OAAQ,MAAO,GAC1D,OAAOA,MAInBf,KAAKgB,sBAAsBhB,KAAKS,QAASd,EAAUE,GACnD,OAAOG,KAAKS,OAChB,CAEAT,KAAKS,QAAU,IAAInB,EAAkB,CACjCoB,GAAIV,KAAKW,iBAAiBb,EAAeF,GACzCqB,MAAO,IAAIpB,KAAaD,KACxBsB,eAAgBvB,EAChBwB,WAAYxB,EAASU,IAAIc,WAG7BnB,KAAKgB,sBAAsBhB,KAAKS,QAASd,EAAUE,GAElDG,KAAKS,QAAiEW,cAAc,KACjF,MAAMC,EAASrB,KAAKsB,WAChB,GAAItB,KAAKD,SAAU,CACfC,KAAKD,SAASsB,EAAOE,QAASvB,KAAKC,SACvC,IAGR,OAAOD,KAAKS,OAChB,CAEUe,WACN,OAAOxB,KAAKS,QAAWT,KAAKS,QAAmDe,WAAa,IAChG,CAEUC,aACN,GAAIzB,KAAKS,SAAWT,KAAKL,SAAU,CAC/B,IAAKK,KAAKG,WAAY,OACrBH,KAAKS,QAAgCiB,YAAY,aAAc1B,KAAKL,SAASU,IAAIc,SACtF,CACJ,EACH,IAAAQ,EAAA,CAAAC,WAAA,MAAAD,EAAAlC,mBAAA,OAAAkC,CAAA","ignoreList":[]}
+{"version":3,"file":"VoiceInputPlugin.js","names":["BasePlugin","___controls_BasePlugin","VoiceInputControl","_interopRequireDefault","__VoiceInputControl","VoiceInputPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","this","fieldKey","replace","isEditable","control","TextControl","id","generateStableId","text","path","formatter","val","applyCommonDirectives","value","schemaMetadata","readOnly","ui","attachCapture","result","validate","isValid","getValue","applyState","setProperty","__exports","__esModule"],"sources":["VoiceInputPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport VoiceInputControl from \"../../controls/VoiceInputControl\";\nimport TextControl from \"sap/m/Text\";\n\nexport class VoiceInputPlugin extends BasePlugin {\n    /**\n     * Renders a `VoiceInputControl` 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 VoiceInputControl.\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            \n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: {\n                    path: `${modelName}>${bindingPath}`,\n                    formatter: (val: unknown) => {\n                        if (!val || val === \"undefined\" || val === \"null\") return \"\";\n                        return val;\n                    }\n                }\n            }) as Control;\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.control = new VoiceInputControl({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            value: `{${modelName}>${bindingPath}}`,\n            schemaMetadata: metadata,\n            readOnly: !!metadata.ui?.readOnly\n        }) as Control;\n\n        this.applyCommonDirectives(this.control, metadata, modelName);\n\n        (this.control as VoiceInputControl).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 voice transcription text.\n     * @returns {unknown} The text string.\n     */\n    protected getValue(): unknown {\n        return this.control ? (this.control as VoiceInputControl).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 sap.ui.core.Control).setProperty(\"readOnly\", !!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"6MAASA,EAAUC,EAAA,oBAGZC,EAAiBC,EAAAC,GAGjB,MAAMC,UAAyBL,EAW3BM,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,CAElBH,KAAKI,QAAU,IAAIC,EAAY,CAC3BC,GAAIN,KAAKO,iBAAiBT,EAAeF,GACzCY,KAAM,CACFC,KAAM,GAAGZ,KAAaD,IACtBc,UAAYC,IACR,IAAKA,GAAOA,IAAQ,aAAeA,IAAQ,OAAQ,MAAO,GAC1D,OAAOA,MAInBX,KAAKY,sBAAsBZ,KAAKI,QAAST,EAAUE,GACnD,OAAOG,KAAKI,OAChB,CAEAJ,KAAKI,QAAU,IAAId,EAAkB,CACjCgB,GAAIN,KAAKO,iBAAiBT,EAAeF,GACzCiB,MAAO,IAAIhB,KAAaD,KACxBkB,eAAgBnB,EAChBoB,WAAYpB,EAASqB,IAAID,WAG7Bf,KAAKY,sBAAsBZ,KAAKI,QAAST,EAAUE,GAElDG,KAAKI,QAA8Ba,cAAc,KAC9C,MAAMC,EAASlB,KAAKmB,WAChB,GAAInB,KAAKD,SAAU,CACfC,KAAKD,SAASmB,EAAOE,QAASpB,KAAKC,SACvC,IAGR,OAAOD,KAAKI,OAChB,CAMUiB,WACN,OAAOrB,KAAKI,QAAWJ,KAAKI,QAA8BiB,WAAa,IAC3E,CAKUC,aACN,GAAItB,KAAKI,SAAWJ,KAAKL,SAAU,CAC/B,IAAKK,KAAKG,WAAY,OACrBH,KAAKI,QAAgCmB,YAAY,aAAcvB,KAAKL,SAASqB,IAAID,SACtF,CACJ,EACH,IAAAS,EAAA,CAAAC,WAAA,MAAAD,EAAA/B,mBAAA,OAAA+B,CAAA","ignoreList":[]}

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

@@ -2,8 +2,19 @@ import { BasePlugin } from "../controls/BasePlugin";
 import { IPropertyMetadata } from "../../interfaces/ISchema";
 import Control from "sap/ui/core/Control";
 import VoiceInputControl from "../../controls/VoiceInputControl";
+import TextControl from "sap/m/Text";
 
 export class VoiceInputPlugin extends BasePlugin {
+    /**
+     * Renders a `VoiceInputControl` 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 VoiceInputControl.
+     */
     public render(metadata: IPropertyMetadata,  bindingPath: string,  modelName: string = "meta", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {
         this.onChange = onChange;
         this.metadata = metadata;
@@ -11,8 +22,7 @@ export class VoiceInputPlugin extends BasePlugin {
         this.modelName = modelName;
 
         if (!this.isEditable) {
-            (sap.ui as unknown as { requireSync: (s: string) => unknown }).requireSync("sap/m/Text");
-            const TextControl = sap.ui.require("sap/m/Text");
+            
             this.control = new TextControl({
                 id: this.generateStableId(engineScopeId, bindingPath),
                 text: {
@@ -22,7 +32,7 @@ export class VoiceInputPlugin extends BasePlugin {
                         return val;
                     }
                 }
-            }) as unknown as sap.ui.core.Control;
+            }) as Control;
             this.applyCommonDirectives(this.control, metadata, modelName);
             return this.control as Control;
         }
@@ -32,11 +42,11 @@ export class VoiceInputPlugin extends BasePlugin {
             value: `{${modelName}>${bindingPath}}`,
             schemaMetadata: metadata,
             readOnly: !!metadata.ui?.readOnly
-        }) as unknown as sap.ui.core.Control;
+        }) as Control;
 
         this.applyCommonDirectives(this.control, metadata, modelName);
 
-        (this.control as unknown as { attachCapture: (fn: Function) => void }).attachCapture(() => {
+        (this.control as VoiceInputControl).attachCapture(() => {
             const result = this.validate();
                 if (this.onChange) {
                     this.onChange(result.isValid, this.fieldKey);
@@ -46,10 +56,17 @@ export class VoiceInputPlugin extends BasePlugin {
         return this.control as Control;
     }
 
-    protected getValue(): any {
-        return this.control ? (this.control as unknown as { getValue: () => unknown }).getValue() : null;
+    /**
+     * Retrieves the current voice transcription text.
+     * @returns {unknown} The text string.
+     */
+    protected getValue(): unknown {
+        return this.control ? (this.control as VoiceInputControl).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/datasources/LiveSearchPlugin-dbg.js

@@ -76,9 +76,18 @@ sap.ui.define(["../controls/BasePlugin", "sap/m/Input", "sap/ui/core/Item", "../
         input.setBusy(false);
       });
     }
+
+    /**
+     * Retrieves the current input value.
+     * @returns {unknown} The input text.
+     */
     getValue() {
       return this.control ? this.control.getValue() : 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/LiveSearchPlugin-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"LiveSearchPlugin-dbg.js","names":["BasePlugin","___controls_BasePlugin","Logger","____utils_Logger","LiveSearchPlugin","render","fieldMetadata","bindingPath","modelName","metadata","input","Input","value","enabled","ui","readOnly","placeholder","showSuggestion","suggest","oEvent","query","getParameter","fetchSuggestions","change","validate","control","vhConfig","valueHelp","url","error","removeAllSuggestionItems","setBusy","fetch","then","res","json","data","keyPath","textPath","lowerQuery","toLowerCase","filteredData","filter","item","textValue","String","includes","forEach","itemData","addSuggestionItem","Item","key","text","catch","err","message","finally","getValue","applyState","setEnabled","__exports","__esModule"],"sources":["LiveSearchPlugin.ts"],"sourcesContent":["/**\n * @file LiveSearchPlugin.ts\n * @description A custom datasource plugin that provides asynchronous live search (autocomplete) functionality.\n */\n\nimport { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Input from \"sap/m/Input\";\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 provides asynchronous live search (autocomplete) functionality.\n * As the user types, it fetches suggestions from a remote endpoint.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources\n * @public\n */\nexport class LiveSearchPlugin extends BasePlugin {\n    public render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName: string = \"meta\"): Control {\n        this.metadata = fieldMetadata;\n        \n        const input = new Input({\n            value: `{${modelName}>${bindingPath}}`,\n            enabled: !fieldMetadata.ui?.readOnly,\n            placeholder: \"Type to search...\",\n            showSuggestion: true,\n            suggest: (oEvent: unknown) => {\n                const query = (oEvent as { getParameter: (s: string) => unknown }).getParameter(\"suggestValue\");\n                this.fetchSuggestions(input, query);\n            },\n            change: (oEvent: unknown) => {\n                this.validate();\n            }\n        });\n\n        this.control = input;\n        return this.control as Control;\n    }\n\n    /**\n     * Executes the REST fetch for suggestions based on a query. Can be overridden by mock subclasses.\n     * @param input The UI5 Input to populate with suggestions.\n     * @param query The text typed by the user.\n     */\n    protected fetchSuggestions(input: Input, query: string): void {\n        const vhConfig = this.metadata?.valueHelp as unknown as Record<string, unknown>;\n        if (!vhConfig || !vhConfig.url) {\n            Logger.error(\"LiveSearchPlugin requires a valid valueHelp configuration with a URL.\", \"\", \"LiveSearchPlugin\");\n            return;\n        }\n\n        if (!query) {\n            input.removeAllSuggestionItems();\n            return;\n        }\n        \n        input.setBusy(true);\n        \n        // In a real application, the query parameter would be passed to the backend (e.g. ?q=query)\n        // Here, we simulate fetching and filter locally, but subclasses can override this entirely.\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                input.removeAllSuggestionItems();\n\n                // Simple client-side filter for demonstration\n                const lowerQuery = query.toLowerCase();\n                const filteredData = data.filter(item => {\n                    const textValue = String(item[textPath] || item[keyPath]).toLowerCase();\n                    return textValue.includes(lowerQuery);\n                });\n                \n                filteredData.forEach(itemData => {\n                    input.addSuggestionItem(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, \"LiveSearchPlugin\");\n            })\n            .finally(() => {\n                input.setBusy(false);\n            });\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as Input).getValue() : null;\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            (this.control as Input).setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"LiveSearchPlugin-dbg.js","names":["BasePlugin","___controls_BasePlugin","Logger","____utils_Logger","LiveSearchPlugin","render","fieldMetadata","bindingPath","modelName","metadata","input","Input","value","enabled","ui","readOnly","placeholder","showSuggestion","suggest","oEvent","query","getParameter","fetchSuggestions","change","validate","control","vhConfig","valueHelp","url","error","removeAllSuggestionItems","setBusy","fetch","then","res","json","data","keyPath","textPath","lowerQuery","toLowerCase","filteredData","filter","item","textValue","String","includes","forEach","itemData","addSuggestionItem","Item","key","text","catch","err","message","finally","getValue","applyState","setEnabled","__exports","__esModule"],"sources":["LiveSearchPlugin.ts"],"sourcesContent":["/**\n * @file LiveSearchPlugin.ts\n * @description A custom datasource plugin that provides asynchronous live search (autocomplete) functionality.\n */\n\nimport { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata, IRemoteValueHelpConfig } from \"../../interfaces/ISchema\";\nimport Input from \"sap/m/Input\";\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 provides asynchronous live search (autocomplete) functionality.\n * As the user types, it fetches suggestions from a remote endpoint.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources\n * @public\n */\nexport class LiveSearchPlugin extends BasePlugin {\n    public render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName: string = \"meta\"): Control {\n        this.metadata = fieldMetadata;\n        \n        const input = new Input({\n            value: `{${modelName}>${bindingPath}}`,\n            enabled: !fieldMetadata.ui?.readOnly,\n            placeholder: \"Type to search...\",\n            showSuggestion: true,\n            suggest: (oEvent: sap.ui.base.Event) => {\n                const query = (oEvent as sap.ui.base.Event).getParameter(\"suggestValue\");\n                this.fetchSuggestions(input, query);\n            },\n            change: (oEvent: sap.ui.base.Event) => {\n                this.validate();\n            }\n        });\n\n        this.control = input;\n        return this.control as Control;\n    }\n\n    /**\n     * Executes the REST fetch for suggestions based on a query. Can be overridden by mock subclasses.\n     * @param input The UI5 Input to populate with suggestions.\n     * @param query The text typed by the user.\n     */\n    protected fetchSuggestions(input: Input, query: string): void {\n        const vhConfig = this.metadata?.valueHelp as IRemoteValueHelpConfig;\n        if (!vhConfig || !vhConfig.url) {\n            Logger.error(\"LiveSearchPlugin requires a valid valueHelp configuration with a URL.\", \"\", \"LiveSearchPlugin\");\n            return;\n        }\n\n        if (!query) {\n            input.removeAllSuggestionItems();\n            return;\n        }\n        \n        input.setBusy(true);\n        \n        // In a real application, the query parameter would be passed to the backend (e.g. ?q=query)\n        // Here, we simulate fetching and filter locally, but subclasses can override this entirely.\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                input.removeAllSuggestionItems();\n\n                // Simple client-side filter for demonstration\n                const lowerQuery = query.toLowerCase();\n                const filteredData = data.filter(item => {\n                    const textValue = String(item[textPath] || item[keyPath]).toLowerCase();\n                    return textValue.includes(lowerQuery);\n                });\n                \n                filteredData.forEach(itemData => {\n                    input.addSuggestionItem(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, \"LiveSearchPlugin\");\n            })\n            .finally(() => {\n                input.setBusy(false);\n            });\n    }\n\n    /**\n     * Retrieves the current input value.\n     * @returns {unknown} The input text.\n     */\n    protected getValue(): unknown {\n        return this.control ? (this.control as Input).getValue() : 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 Input).setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -22,7 +22,14 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/datasources/LiveSearchPlugin"
          * @param query The text typed by the user.
          */
         protected fetchSuggestions(input: Input, query: string): void;
-        protected getValue(): any;
+        /**
+         * Retrieves the current input value.
+         * @returns {unknown} The input text.
+         */
+        protected getValue(): unknown;
+        /**
+         * Applies dynamic read-only state.
+         */
         protected applyState(): void;
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"LiveSearchPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/datasources/LiveSearchPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,iEAAiE,CAAC;IACjF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAClF,OAAO,KAAK,MAAM,aAAa,CAAC;IAEhC,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAG1C;;;;;;OAMG;IACH,MAAa,gBAAiB,SAAQ,UAAU;QACrC,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAe,GAAG,OAAO;QAqBzG;;;;WAIG;QACH,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;QA8C7D,SAAS,CAAC,QAAQ,IAAI,GAAG;QAIzB,SAAS,CAAC,UAAU,IAAI,IAAI;KAK/B;CAEA"}
+{"version":3,"file":"LiveSearchPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/datasources/LiveSearchPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,iEAAiE,CAAC;IACjF;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAA0B,MAAM,+CAA+C,CAAC;IAC1G,OAAO,KAAK,MAAM,aAAa,CAAC;IAEhC,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAG1C;;;;;;OAMG;IACH,MAAa,gBAAiB,SAAQ,UAAU;QACrC,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAe,GAAG,OAAO;QAqBzG;;;;WAIG;QACH,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;QA8C7D;;;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/LiveSearchPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"LiveSearchPlugin.js","names":["BasePlugin","___controls_BasePlugin","Logger","____utils_Logger","LiveSearchPlugin","render","fieldMetadata","bindingPath","modelName","this","metadata","input","Input","value","enabled","ui","readOnly","placeholder","showSuggestion","suggest","oEvent","query","getParameter","fetchSuggestions","change","validate","control","vhConfig","valueHelp","url","error","removeAllSuggestionItems","setBusy","fetch","then","res","json","data","keyPath","textPath","lowerQuery","toLowerCase","filteredData","filter","item","textValue","String","includes","forEach","itemData","addSuggestionItem","Item","key","text","catch","err","message","finally","getValue","applyState","setEnabled","__exports","__esModule"],"sources":["LiveSearchPlugin.ts"],"sourcesContent":["/**\n * @file LiveSearchPlugin.ts\n * @description A custom datasource plugin that provides asynchronous live search (autocomplete) functionality.\n */\n\nimport { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Input from \"sap/m/Input\";\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 provides asynchronous live search (autocomplete) functionality.\n * As the user types, it fetches suggestions from a remote endpoint.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources\n * @public\n */\nexport class LiveSearchPlugin extends BasePlugin {\n    public render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName: string = \"meta\"): Control {\n        this.metadata = fieldMetadata;\n        \n        const input = new Input({\n            value: `{${modelName}>${bindingPath}}`,\n            enabled: !fieldMetadata.ui?.readOnly,\n            placeholder: \"Type to search...\",\n            showSuggestion: true,\n            suggest: (oEvent: unknown) => {\n                const query = (oEvent as { getParameter: (s: string) => unknown }).getParameter(\"suggestValue\");\n                this.fetchSuggestions(input, query);\n            },\n            change: (oEvent: unknown) => {\n                this.validate();\n            }\n        });\n\n        this.control = input;\n        return this.control as Control;\n    }\n\n    /**\n     * Executes the REST fetch for suggestions based on a query. Can be overridden by mock subclasses.\n     * @param input The UI5 Input to populate with suggestions.\n     * @param query The text typed by the user.\n     */\n    protected fetchSuggestions(input: Input, query: string): void {\n        const vhConfig = this.metadata?.valueHelp as unknown as Record<string, unknown>;\n        if (!vhConfig || !vhConfig.url) {\n            Logger.error(\"LiveSearchPlugin requires a valid valueHelp configuration with a URL.\", \"\", \"LiveSearchPlugin\");\n            return;\n        }\n\n        if (!query) {\n            input.removeAllSuggestionItems();\n            return;\n        }\n        \n        input.setBusy(true);\n        \n        // In a real application, the query parameter would be passed to the backend (e.g. ?q=query)\n        // Here, we simulate fetching and filter locally, but subclasses can override this entirely.\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                input.removeAllSuggestionItems();\n\n                // Simple client-side filter for demonstration\n                const lowerQuery = query.toLowerCase();\n                const filteredData = data.filter(item => {\n                    const textValue = String(item[textPath] || item[keyPath]).toLowerCase();\n                    return textValue.includes(lowerQuery);\n                });\n                \n                filteredData.forEach(itemData => {\n                    input.addSuggestionItem(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, \"LiveSearchPlugin\");\n            })\n            .finally(() => {\n                input.setBusy(false);\n            });\n    }\n\n    protected getValue(): any {\n        return this.control ? (this.control as Input).getValue() : null;\n    }\n\n    protected applyState(): void {\n        if (this.control && this.metadata) {\n            (this.control as Input).setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"8HAAA,MAKSA,EAAUC,EAAA,oBAKVC,EAAMC,EAAA,UASR,MAAMC,UAAyBJ,EAC3BK,OAAOC,EAAkCC,EAAqBC,EAAoB,QACrFC,KAAKC,SAAWJ,EAEhB,MAAMK,EAAQ,IAAIC,EAAM,CACpBC,MAAO,IAAIL,KAAaD,KACxBO,SAAUR,EAAcS,IAAIC,SAC5BC,YAAa,oBACbC,eAAgB,KAChBC,QAAUC,IACN,MAAMC,EAASD,EAAoDE,aAAa,gBAChFb,KAAKc,iBAAiBZ,EAAOU,IAEjCG,OAASJ,IACLX,KAAKgB,cAIbhB,KAAKiB,QAAUf,EACf,OAAOF,KAAKiB,OAChB,CAOUH,iBAAiBZ,EAAcU,GACrC,MAAMM,EAAWlB,KAAKC,UAAUkB,UAChC,IAAKD,IAAaA,EAASE,IAAK,CAC5B3B,EAAO4B,MAAM,wEAAyE,GAAI,oBAC1F,MACJ,CAEA,IAAKT,EAAO,CACRV,EAAMoB,2BACN,MACJ,CAEApB,EAAMqB,QAAQ,MAIdC,MAAMN,EAASE,KACVK,KAAKC,GAAOA,EAAIC,QAChBF,KAAMG,IACH,MAAMC,EAAUX,EAASW,SAAW,MACpC,MAAMC,EAAWZ,EAASY,UAAY,OAEtC5B,EAAMoB,2BAGN,MAAMS,EAAanB,EAAMoB,cACzB,MAAMC,EAAeL,EAAKM,OAAOC,IAC7B,MAAMC,EAAYC,OAAOF,EAAKL,IAAaK,EAAKN,IAAUG,cAC1D,OAAOI,EAAUE,SAASP,KAG9BE,EAAaM,QAAQC,IACjBtC,EAAMuC,kBAAkB,IAAIC,EAAK,CAC7BC,IAAKH,EAASX,GACde,KAAMJ,EAASV,IAAaU,EAASX,UAIhDgB,MAAMC,IACHrD,EAAO4B,MAAM,kCAAoCH,EAASE,IAAK0B,EAAIC,QAAS,sBAE/EC,QAAQ,KACL9C,EAAMqB,QAAQ,QAE1B,CAEU0B,WACN,OAAOjD,KAAKiB,QAAWjB,KAAKiB,QAAkBgC,WAAa,IAC/D,CAEUC,aACN,GAAIlD,KAAKiB,SAAWjB,KAAKC,SAAU,CAC9BD,KAAKiB,QAAkBkC,YAAYnD,KAAKC,SAASK,IAAIC,SAC1D,CACJ,EACH,IAAA6C,EAAA,CAAAC,WAAA,MAAAD,EAAAzD,mBAAA,OAAAyD,CAAA","ignoreList":[]}
+{"version":3,"file":"LiveSearchPlugin.js","names":["BasePlugin","___controls_BasePlugin","Logger","____utils_Logger","LiveSearchPlugin","render","fieldMetadata","bindingPath","modelName","this","metadata","input","Input","value","enabled","ui","readOnly","placeholder","showSuggestion","suggest","oEvent","query","getParameter","fetchSuggestions","change","validate","control","vhConfig","valueHelp","url","error","removeAllSuggestionItems","setBusy","fetch","then","res","json","data","keyPath","textPath","lowerQuery","toLowerCase","filteredData","filter","item","textValue","String","includes","forEach","itemData","addSuggestionItem","Item","key","text","catch","err","message","finally","getValue","applyState","setEnabled","__exports","__esModule"],"sources":["LiveSearchPlugin.ts"],"sourcesContent":["/**\n * @file LiveSearchPlugin.ts\n * @description A custom datasource plugin that provides asynchronous live search (autocomplete) functionality.\n */\n\nimport { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata, IRemoteValueHelpConfig } from \"../../interfaces/ISchema\";\nimport Input from \"sap/m/Input\";\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 provides asynchronous live search (autocomplete) functionality.\n * As the user types, it fetches suggestions from a remote endpoint.\n * \n * @namespace nz.co.siliconst.ui5.metaui.plugins.datasources\n * @public\n */\nexport class LiveSearchPlugin extends BasePlugin {\n    public render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName: string = \"meta\"): Control {\n        this.metadata = fieldMetadata;\n        \n        const input = new Input({\n            value: `{${modelName}>${bindingPath}}`,\n            enabled: !fieldMetadata.ui?.readOnly,\n            placeholder: \"Type to search...\",\n            showSuggestion: true,\n            suggest: (oEvent: sap.ui.base.Event) => {\n                const query = (oEvent as sap.ui.base.Event).getParameter(\"suggestValue\");\n                this.fetchSuggestions(input, query);\n            },\n            change: (oEvent: sap.ui.base.Event) => {\n                this.validate();\n            }\n        });\n\n        this.control = input;\n        return this.control as Control;\n    }\n\n    /**\n     * Executes the REST fetch for suggestions based on a query. Can be overridden by mock subclasses.\n     * @param input The UI5 Input to populate with suggestions.\n     * @param query The text typed by the user.\n     */\n    protected fetchSuggestions(input: Input, query: string): void {\n        const vhConfig = this.metadata?.valueHelp as IRemoteValueHelpConfig;\n        if (!vhConfig || !vhConfig.url) {\n            Logger.error(\"LiveSearchPlugin requires a valid valueHelp configuration with a URL.\", \"\", \"LiveSearchPlugin\");\n            return;\n        }\n\n        if (!query) {\n            input.removeAllSuggestionItems();\n            return;\n        }\n        \n        input.setBusy(true);\n        \n        // In a real application, the query parameter would be passed to the backend (e.g. ?q=query)\n        // Here, we simulate fetching and filter locally, but subclasses can override this entirely.\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                input.removeAllSuggestionItems();\n\n                // Simple client-side filter for demonstration\n                const lowerQuery = query.toLowerCase();\n                const filteredData = data.filter(item => {\n                    const textValue = String(item[textPath] || item[keyPath]).toLowerCase();\n                    return textValue.includes(lowerQuery);\n                });\n                \n                filteredData.forEach(itemData => {\n                    input.addSuggestionItem(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, \"LiveSearchPlugin\");\n            })\n            .finally(() => {\n                input.setBusy(false);\n            });\n    }\n\n    /**\n     * Retrieves the current input value.\n     * @returns {unknown} The input text.\n     */\n    protected getValue(): unknown {\n        return this.control ? (this.control as Input).getValue() : 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 Input).setEnabled(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"8HAAA,MAKSA,EAAUC,EAAA,oBAKVC,EAAMC,EAAA,UASR,MAAMC,UAAyBJ,EAC3BK,OAAOC,EAAkCC,EAAqBC,EAAoB,QACrFC,KAAKC,SAAWJ,EAEhB,MAAMK,EAAQ,IAAIC,EAAM,CACpBC,MAAO,IAAIL,KAAaD,KACxBO,SAAUR,EAAcS,IAAIC,SAC5BC,YAAa,oBACbC,eAAgB,KAChBC,QAAUC,IACN,MAAMC,EAASD,EAA6BE,aAAa,gBACzDb,KAAKc,iBAAiBZ,EAAOU,IAEjCG,OAASJ,IACLX,KAAKgB,cAIbhB,KAAKiB,QAAUf,EACf,OAAOF,KAAKiB,OAChB,CAOUH,iBAAiBZ,EAAcU,GACrC,MAAMM,EAAWlB,KAAKC,UAAUkB,UAChC,IAAKD,IAAaA,EAASE,IAAK,CAC5B3B,EAAO4B,MAAM,wEAAyE,GAAI,oBAC1F,MACJ,CAEA,IAAKT,EAAO,CACRV,EAAMoB,2BACN,MACJ,CAEApB,EAAMqB,QAAQ,MAIdC,MAAMN,EAASE,KACVK,KAAKC,GAAOA,EAAIC,QAChBF,KAAMG,IACH,MAAMC,EAAUX,EAASW,SAAW,MACpC,MAAMC,EAAWZ,EAASY,UAAY,OAEtC5B,EAAMoB,2BAGN,MAAMS,EAAanB,EAAMoB,cACzB,MAAMC,EAAeL,EAAKM,OAAOC,IAC7B,MAAMC,EAAYC,OAAOF,EAAKL,IAAaK,EAAKN,IAAUG,cAC1D,OAAOI,EAAUE,SAASP,KAG9BE,EAAaM,QAAQC,IACjBtC,EAAMuC,kBAAkB,IAAIC,EAAK,CAC7BC,IAAKH,EAASX,GACde,KAAMJ,EAASV,IAAaU,EAASX,UAIhDgB,MAAMC,IACHrD,EAAO4B,MAAM,kCAAoCH,EAASE,IAAK0B,EAAIC,QAAS,sBAE/EC,QAAQ,KACL9C,EAAMqB,QAAQ,QAE1B,CAMU0B,WACN,OAAOjD,KAAKiB,QAAWjB,KAAKiB,QAAkBgC,WAAa,IAC/D,CAKUC,aACN,GAAIlD,KAAKiB,SAAWjB,KAAKC,SAAU,CAC9BD,KAAKiB,QAAkBkC,YAAYnD,KAAKC,SAASK,IAAIC,SAC1D,CACJ,EACH,IAAA6C,EAAA,CAAAC,WAAA,MAAAD,EAAAzD,mBAAA,OAAAyD,CAAA","ignoreList":[]}

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

@@ -4,7 +4,7 @@
  */
 
 import { BasePlugin } from "../controls/BasePlugin";
-import { IPropertyMetadata } from "../../interfaces/ISchema";
+import { IPropertyMetadata, IRemoteValueHelpConfig } from "../../interfaces/ISchema";
 import Input from "sap/m/Input";
 import Item from "sap/ui/core/Item";
 import Control from "sap/ui/core/Control";
@@ -26,11 +26,11 @@ export class LiveSearchPlugin extends BasePlugin {
             enabled: !fieldMetadata.ui?.readOnly,
             placeholder: "Type to search...",
             showSuggestion: true,
-            suggest: (oEvent: unknown) => {
-                const query = (oEvent as { getParameter: (s: string) => unknown }).getParameter("suggestValue");
+            suggest: (oEvent: sap.ui.base.Event) => {
+                const query = (oEvent as sap.ui.base.Event).getParameter("suggestValue");
                 this.fetchSuggestions(input, query);
             },
-            change: (oEvent: unknown) => {
+            change: (oEvent: sap.ui.base.Event) => {
                 this.validate();
             }
         });
@@ -45,7 +45,7 @@ export class LiveSearchPlugin extends BasePlugin {
      * @param query The text typed by the user.
      */
     protected fetchSuggestions(input: Input, query: string): 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("LiveSearchPlugin requires a valid valueHelp configuration with a URL.", "", "LiveSearchPlugin");
             return;
@@ -90,10 +90,17 @@ export class LiveSearchPlugin extends BasePlugin {
             });
     }
 
-    protected getValue(): any {
+    /**
+     * Retrieves the current input value.
+     * @returns {unknown} The input text.
+     */
+    protected getValue(): unknown {
         return this.control ? (this.control as Input).getValue() : null;
     }
 
+    /**
+     * Applies dynamic read-only state.
+     */
     protected applyState(): void {
         if (this.control && this.metadata) {
             (this.control as Input).setEnabled(!this.metadata.ui?.readOnly);

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

@@ -42,9 +42,18 @@ sap.ui.define(["../controls/BasePlugin", "sap/m/ComboBox", "sap/ui/core/Item"],
       });
       return this.control;
     }
+
+    /**
+     * 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/ODataListBindingPlugin-dbg.js.map

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

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

@@ -15,7 +15,14 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/datasources/ODataListBindingP
      */
     export class ODataListBindingPlugin extends BasePlugin {
         render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string): Control;
-        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/ODataListBindingPlugin.d.ts.map

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

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

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

@@ -26,8 +26,8 @@ export class ODataListBindingPlugin extends BasePlugin {
             selectedKey: `{${modelName}>${bindingPath}}`,
             enabled: !fieldMetadata.ui?.readOnly,
             placeholder: fieldMetadata.ui?.label || "Select...",
-            change: (oEvent: unknown) => {
-                const val = (oEvent as { getParameter: (s: string) => unknown }).getParameter("selectedItem")?.getKey();
+            change: (oEvent: sap.ui.base.Event) => {
+                const val = (oEvent as sap.ui.base.Event).getParameter("selectedItem")?.getKey();
                 this.validate();
             }
         });
@@ -45,10 +45,17 @@ export class ODataListBindingPlugin 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 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/datasources/RemoteDropdownPlugin-dbg.js

@@ -15,6 +15,16 @@ sap.ui.define(["../controls/BasePlugin", "sap/m/Select", "sap/ui/core/Item", "..
    * @public
    */
   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.
+     */
     render(fieldMetadata, bindingPath, modelName = "meta", engineScopeId, onChange) {
       this.onChange = onChange;
       this.metadata = fieldMetadata;
@@ -86,9 +96,18 @@ sap.ui.define(["../controls/BasePlugin", "sap/m/Select", "sap/ui/core/Item", "..
       this.applyCommonDirectives(this.control, fieldMetadata, modelName);
       return this.control;
     }
+
+    /**
+     * 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) {
         if (!this.isEditable) return;

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

@@ -1 +1 @@
-{"version":3,"file":"RemoteDropdownPlugin-dbg.js","names":["BasePlugin","___controls_BasePlugin","Logger","____utils_Logger","RemoteDropdownPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","config","valueHelp","url","warn","sap","m","Text","text","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":"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","ignoreList":[]}
+{"version":3,"file":"RemoteDropdownPlugin-dbg.js","names":["BasePlugin","___controls_BasePlugin","Logger","____utils_Logger","RemoteDropdownPlugin","render","fieldMetadata","bindingPath","modelName","engineScopeId","onChange","metadata","config","valueHelp","url","warn","sap","m","Text","text","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":"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","ignoreList":[]}