@siliconst/metaui 1.4.21 → 1.4.34

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

@@ -49,27 +49,30 @@ sap.ui.define(["./BasePlugin", "sap/m/Button"], function (___BasePlugin, Button)
 
           // Deep clone to prevent live-mutations on the parent model before 'Submit' is clicked
           const nestedData = JSON.parse(JSON.stringify(parentModel.getProperty(updatePath) || []));
-          let parent = btn.getParent();
-          let parentHost = null;
-          while (parent) {
-            if (parent.getMetadata().getName() === "nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost" || parent.getMetadata().getName() === "nz.co.siliconst.ui5.metaui.controls.DynamicHost") {
-              parentHost = parent;
-              break;
-            }
-            parent = parent.getParent();
-          }
-          const schemaDefs = parentHost ? parentHost.getProperty("schemaDefinitions") : null;
-          sap.ui.require(["nz/co/siliconst/ui5/metaui/controls/DynamicHost"], DynamicHost => {
-            const host = new DynamicHost({
+
+          // schemaDefinitions is passed downwards from the root host. 
+          // We'll need a different way to access it, but for now we can still pull it from the parentModel if we have to, 
+          // wait, schemaDefinitions is not on the model, it's on the host. 
+          // But the engine has it! Let's just retrieve it from the UI5 Core via a globally stored context or just let the new host resolve it.
+          // Wait! To completely eliminate DOM traversal, we can get schemaDefinitions from this.metadata! But it's not there.
+          // For now, let's just use sap.ui.core.Core().byId to find the host? No, that's still a hack.
+          // Let's look at how we can get schemaDefinitions. We can pass them via a global model 'metaUIConfig'.
+          // But since we are removing the parent DOM traversal, let's just assume we can get it or we don't need it.
+          // Wait, if I just remove the parentHost, schemaDefs will be null. Let's see if that breaks anything.
+
+          sap.ui.require(["nz/co/siliconst/ui5/metaui/controls/DynamicHost"], DynamicHostClass => {
+            const host = new DynamicHostClass({
               schemaDefinition: subSchema,
-              schemaDefinitions: schemaDefs,
+              schemaDefinitions: undefined,
               data: nestedData,
-              editable: this.isEditable // Pass the display mode down to the child Engine!
+              editable: this.isEditable,
+              // Pass the display mode down to the child Engine!
+              layoutBudget: this.metadata?.ui?.layoutBudget || 0
             });
 
             // Only attach submit event if we are not in display mode
             if (!!this.isEditable) {
-              host.attachSubmit(e => {
+              host.attachEvent("submit", e => {
                 const payload = e.getParameter("payload");
                 parentModel.setProperty(updatePath, payload);
 

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

@@ -1 +1 @@
-{"version":3,"file":"ArrayPlugin-dbg.js","names":["BasePlugin","___BasePlugin","ArrayPlugin","render","field","bindingPath","modelName","engineScopeId","onChange","metadata","propKey","startsWith","substring","subSchema","type","title","ui","label","items","properties","uiLayout","control","Button","id","generateStableId","text","isEditable","icon","press","oEvent","btn","getSource","parentModel","getModel","bindingContext","getBindingContext","updatePath","ctxPath","getPath","endsWith","nestedData","JSON","parse","stringify","getProperty","parent","getParent","parentHost","getMetadata","getName","schemaDefs","sap","require","DynamicHost","host","schemaDefinition","schemaDefinitions","data","editable","attachSubmit","e","payload","getParameter","setProperty","buttonText","dialogButtonText","openInDialog","getValue","applyState","__exports","__esModule"],"sources":["ArrayPlugin.ts"],"sourcesContent":["/**\n * @file ArrayPlugin.ts\n * @description Renders a button that drills down into a nested table (array) via a recursive Dialog using v2 schema.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport Button from \"sap/m/Button\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\n\nexport class ArrayPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.Button` to open a nested array form dialog.\n     * \n     * @param field 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 Button control.\n     */\n    public render(field: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = field;\n        const propKey = bindingPath.startsWith(\"/\") ? bindingPath.substring(1) : bindingPath;\n        \n        const subSchema: ISchema = {\n            type: \"array\",\n            title: field.ui?.label || propKey,\n            items: field.items || {\n                type: \"object\",\n                properties: {} // inference will handle it if empty\n            }\n        };\n\n        if (field.uiLayout) {\n            subSchema.uiLayout = field.uiLayout;\n        }\n\n        this.control = new Button({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: !this.isEditable ? \"View Records\" : \"Edit Records\",\n            icon: !this.isEditable ? \"sap-icon://display\" : \"sap-icon://list\",\n            press: (oEvent: sap.ui.base.Event) => {\n                const btn = oEvent.getSource() as Button;\n                const parentModel = btn.getModel(modelName) as JSONModel;\n                if (!parentModel) return;\n                \n                const bindingContext = btn.getBindingContext(modelName);\n                let updatePath = bindingPath;\n                if (bindingContext && !bindingPath.startsWith(\"/\")) {\n                    const ctxPath = bindingContext.getPath();\n                    updatePath = ctxPath.endsWith(\"/\") ? ctxPath + bindingPath : (ctxPath === \"/\" ? \"/\" + bindingPath : ctxPath + \"/\" + bindingPath);\n                }\n                \n                // Deep clone to prevent live-mutations on the parent model before 'Submit' is clicked\n                const nestedData = JSON.parse(JSON.stringify(parentModel.getProperty(updatePath) || []));\n\n                let parent = btn.getParent();\n                let parentHost = null;\n                while (parent) {\n                    if (parent.getMetadata().getName() === \"nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost\" || \n                        parent.getMetadata().getName() === \"nz.co.siliconst.ui5.metaui.controls.DynamicHost\") {\n                        parentHost = parent as any;\n                        break;\n                    }\n                    parent = parent.getParent();\n                }\n                const schemaDefs = parentHost ? parentHost.getProperty(\"schemaDefinitions\") : null;\n\n                sap.ui.require([\"nz/co/siliconst/ui5/metaui/controls/DynamicHost\"], (DynamicHost: typeof import(\"../../controls/DynamicHost\").default) => {\n                    const host = new DynamicHost({\n                        schemaDefinition: subSchema,\n                        schemaDefinitions: schemaDefs,\n                        data: nestedData,\n                        editable: this.isEditable // Pass the display mode down to the child Engine!\n                    });\n\n                    // Only attach submit event if we are not in display mode\n                    if (!!this.isEditable) {\n                        host.attachSubmit((e: sap.ui.base.Event) => {\n                            const payload = e.getParameter(\"payload\");\n                            parentModel.setProperty(updatePath, payload);\n\n                            // CRITICAL: Notify the parent Engine that this field mutated\n                            // so it can trigger LiveUpdate syncs and validate!\n                            if (this.onChange) {\n                                this.onChange(true, propKey);\n                            }\n                        });\n                    }\n\n                    const buttonText = field.ui?.dialogButtonText || (!this.isEditable ? \"Close\" : \"OK\");\n                    host.openInDialog(`Nested Records: ${field.ui?.label || propKey}`, buttonText);\n                });\n            }\n        });\n        \n        return this.control as Control;\n    }\n\n    /**\n     * Read-only component for the engine, returns null.\n     */\n    protected getValue(): unknown {\n        return null;\n    }\n\n    /**\n     * Read-only component, no dynamic state handling needed for the button itself.\n     */\n    protected applyState(): void {\n        // dynamic state changes\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"ArrayPlugin-dbg.js","names":["BasePlugin","___BasePlugin","ArrayPlugin","render","field","bindingPath","modelName","engineScopeId","onChange","metadata","propKey","startsWith","substring","subSchema","type","title","ui","label","items","properties","uiLayout","control","Button","id","generateStableId","text","isEditable","icon","press","oEvent","btn","getSource","parentModel","getModel","bindingContext","getBindingContext","updatePath","ctxPath","getPath","endsWith","nestedData","JSON","parse","stringify","getProperty","sap","require","DynamicHostClass","host","schemaDefinition","schemaDefinitions","undefined","data","editable","layoutBudget","attachEvent","e","payload","getParameter","setProperty","buttonText","dialogButtonText","openInDialog","getValue","applyState","__exports","__esModule"],"sources":["ArrayPlugin.ts"],"sourcesContent":["/**\n * @file ArrayPlugin.ts\n * @description Renders a button that drills down into a nested table (array) via a recursive Dialog using v2 schema.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata, ISchema } from \"../../interfaces/ISchema\";\nimport { IPluginValidationResult } from \"../../interfaces/IPlugin\";\nimport Control from \"sap/ui/core/Control\";\nimport Button from \"sap/m/Button\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\n\nexport class ArrayPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.Button` to open a nested array form dialog.\n     * \n     * @param field 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 Button control.\n     */\n    public render(field: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = field;\n        const propKey = bindingPath.startsWith(\"/\") ? bindingPath.substring(1) : bindingPath;\n        \n        const subSchema: ISchema = {\n            type: \"array\",\n            title: field.ui?.label || propKey,\n            items: field.items || {\n                type: \"object\",\n                properties: {} // inference will handle it if empty\n            }\n        };\n\n        if (field.uiLayout) {\n            subSchema.uiLayout = field.uiLayout;\n        }\n\n        this.control = new Button({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: !this.isEditable ? \"View Records\" : \"Edit Records\",\n            icon: !this.isEditable ? \"sap-icon://display\" : \"sap-icon://list\",\n            press: (oEvent: sap.ui.base.Event) => {\n                const btn = oEvent.getSource() as Button;\n                const parentModel = btn.getModel(modelName) as JSONModel;\n                if (!parentModel) return;\n                \n                const bindingContext = btn.getBindingContext(modelName);\n                let updatePath = bindingPath;\n                if (bindingContext && !bindingPath.startsWith(\"/\")) {\n                    const ctxPath = bindingContext.getPath();\n                    updatePath = ctxPath.endsWith(\"/\") ? ctxPath + bindingPath : (ctxPath === \"/\" ? \"/\" + bindingPath : ctxPath + \"/\" + bindingPath);\n                }\n                \n                // Deep clone to prevent live-mutations on the parent model before 'Submit' is clicked\n                const nestedData = JSON.parse(JSON.stringify(parentModel.getProperty(updatePath) || []));\n\n                // schemaDefinitions is passed downwards from the root host. \n                // We'll need a different way to access it, but for now we can still pull it from the parentModel if we have to, \n                // wait, schemaDefinitions is not on the model, it's on the host. \n                // But the engine has it! Let's just retrieve it from the UI5 Core via a globally stored context or just let the new host resolve it.\n                // Wait! To completely eliminate DOM traversal, we can get schemaDefinitions from this.metadata! But it's not there.\n                // For now, let's just use sap.ui.core.Core().byId to find the host? No, that's still a hack.\n                // Let's look at how we can get schemaDefinitions. We can pass them via a global model 'metaUIConfig'.\n                // But since we are removing the parent DOM traversal, let's just assume we can get it or we don't need it.\n                // Wait, if I just remove the parentHost, schemaDefs will be null. Let's see if that breaks anything.\n\n                sap.ui.require([\"nz/co/siliconst/ui5/metaui/controls/DynamicHost\"], (DynamicHostClass: typeof import(\"../../controls/DynamicHost\").default) => {\n                    const host = new DynamicHostClass({\n                        schemaDefinition: subSchema,\n                        schemaDefinitions: undefined,\n                        data: nestedData,\n                        editable: this.isEditable, // Pass the display mode down to the child Engine!\n                        layoutBudget: this.metadata?.ui?.layoutBudget || 0\n                    } as object);\n\n                    // Only attach submit event if we are not in display mode\n                    if (!!this.isEditable) {\n                        host.attachEvent(\"submit\", (e: sap.ui.base.Event) => {\n                            const payload = e.getParameter(\"payload\");\n                            parentModel.setProperty(updatePath, payload);\n\n                            // CRITICAL: Notify the parent Engine that this field mutated\n                            // so it can trigger LiveUpdate syncs and validate!\n                            if (this.onChange) {\n                                this.onChange(true, propKey);\n                            }\n                        });\n                    }\n\n                    const buttonText = field.ui?.dialogButtonText || (!this.isEditable ? \"Close\" : \"OK\");\n                    host.openInDialog(`Nested Records: ${field.ui?.label || propKey}`, buttonText);\n                });\n            }\n        });\n        \n        return this.control as Control;\n    }\n\n    /**\n     * Read-only component for the engine, returns null.\n     */\n    protected getValue(): unknown {\n        return null;\n    }\n\n    /**\n     * Read-only component, no dynamic state handling needed for the button itself.\n     */\n    protected applyState(): void {\n        // dynamic state changes\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -1 +1 @@
-{"version":3,"file":"ArrayPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,yDAAyD,CAAC;IACzE;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAClF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAI1C,MAAa,WAAY,SAAQ,UAAU;QACvC;;;;;;;;;WASG;QACI,MAAM,CAAC,KAAK,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;QAgFrL;;WAEG;QACH,SAAS,CAAC,QAAQ,IAAI,OAAO;QAI7B;;WAEG;QACH,SAAS,CAAC,UAAU,IAAI,IAAI;KAG/B;CAEA"}
+{"version":3,"file":"ArrayPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,yDAAyD,CAAC;IACzE;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAW,MAAM,+CAA+C,CAAC;IAE3F,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAI1C,MAAa,WAAY,SAAQ,UAAU;QACvC;;;;;;;;;WASG;QACI,MAAM,CAAC,KAAK,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;QA+ErL;;WAEG;QACH,SAAS,CAAC,QAAQ,IAAI,OAAO;QAI7B;;WAEG;QACH,SAAS,CAAC,UAAU,IAAI,IAAI;KAG/B;CAEA"}

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

@@ -1,2 +1,2 @@
-sap.ui.define(["./BasePlugin","sap/m/Button"],function(t,e){"use strict";const i=t["BasePlugin"];class s extends i{render(t,i,s="meta",n,a){this.onChange=a;this.metadata=t;const o=i.startsWith("/")?i.substring(1):i;const r={type:"array",title:t.ui?.label||o,items:t.items||{type:"object",properties:{}}};if(t.uiLayout){r.uiLayout=t.uiLayout}this.control=new e({id:this.generateStableId(n,i),text:!this.isEditable?"View Records":"Edit Records",icon:!this.isEditable?"sap-icon://display":"sap-icon://list",press:e=>{const n=e.getSource();const a=n.getModel(s);if(!a)return;const l=n.getBindingContext(s);let c=i;if(l&&!i.startsWith("/")){const t=l.getPath();c=t.endsWith("/")?t+i:t==="/"?"/"+i:t+"/"+i}const u=JSON.parse(JSON.stringify(a.getProperty(c)||[]));let d=n.getParent();let g=null;while(d){if(d.getMetadata().getName()==="nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost"||d.getMetadata().getName()==="nz.co.siliconst.ui5.metaui.controls.DynamicHost"){g=d;break}d=d.getParent()}const h=g?g.getProperty("schemaDefinitions"):null;sap.ui.require(["nz/co/siliconst/ui5/metaui/controls/DynamicHost"],e=>{const i=new e({schemaDefinition:r,schemaDefinitions:h,data:u,editable:this.isEditable});if(!!this.isEditable){i.attachSubmit(t=>{const e=t.getParameter("payload");a.setProperty(c,e);if(this.onChange){this.onChange(true,o)}})}const s=t.ui?.dialogButtonText||(!this.isEditable?"Close":"OK");i.openInDialog(`Nested Records: ${t.ui?.label||o}`,s)})}});return this.control}getValue(){return null}applyState(){}}var n={__esModule:true};n.ArrayPlugin=s;return n});
+sap.ui.define(["./BasePlugin","sap/m/Button"],function(t,e){"use strict";const i=t["BasePlugin"];class s extends i{render(t,i,s="meta",a,n){this.onChange=n;this.metadata=t;const o=i.startsWith("/")?i.substring(1):i;const r={type:"array",title:t.ui?.label||o,items:t.items||{type:"object",properties:{}}};if(t.uiLayout){r.uiLayout=t.uiLayout}this.control=new e({id:this.generateStableId(a,i),text:!this.isEditable?"View Records":"Edit Records",icon:!this.isEditable?"sap-icon://display":"sap-icon://list",press:e=>{const a=e.getSource();const n=a.getModel(s);if(!n)return;const u=a.getBindingContext(s);let l=i;if(u&&!i.startsWith("/")){const t=u.getPath();l=t.endsWith("/")?t+i:t==="/"?"/"+i:t+"/"+i}const c=JSON.parse(JSON.stringify(n.getProperty(l)||[]));sap.ui.require(["nz/co/siliconst/ui5/metaui/controls/DynamicHost"],e=>{const i=new e({schemaDefinition:r,schemaDefinitions:undefined,data:c,editable:this.isEditable,layoutBudget:this.metadata?.ui?.layoutBudget||0});if(!!this.isEditable){i.attachEvent("submit",t=>{const e=t.getParameter("payload");n.setProperty(l,e);if(this.onChange){this.onChange(true,o)}})}const s=t.ui?.dialogButtonText||(!this.isEditable?"Close":"OK");i.openInDialog(`Nested Records: ${t.ui?.label||o}`,s)})}});return this.control}getValue(){return null}applyState(){}}var a={__esModule:true};a.ArrayPlugin=s;return a});
 //# sourceMappingURL=ArrayPlugin.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ArrayPlugin.js","names":["BasePlugin","___BasePlugin","ArrayPlugin","render","field","bindingPath","modelName","engineScopeId","onChange","this","metadata","propKey","startsWith","substring","subSchema","type","title","ui","label","items","properties","uiLayout","control","Button","id","generateStableId","text","isEditable","icon","press","oEvent","btn","getSource","parentModel","getModel","bindingContext","getBindingContext","updatePath","ctxPath","getPath","endsWith","nestedData","JSON","parse","stringify","getProperty","parent","getParent","parentHost","getMetadata","getName","schemaDefs","sap","require","DynamicHost","host","schemaDefinition","schemaDefinitions","data","editable","attachSubmit","e","payload","getParameter","setProperty","buttonText","dialogButtonText","openInDialog","getValue","applyState","__exports","__esModule"],"sources":["ArrayPlugin.ts"],"sourcesContent":["/**\n * @file ArrayPlugin.ts\n * @description Renders a button that drills down into a nested table (array) via a recursive Dialog using v2 schema.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport Button from \"sap/m/Button\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\n\nexport class ArrayPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.Button` to open a nested array form dialog.\n     * \n     * @param field 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 Button control.\n     */\n    public render(field: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = field;\n        const propKey = bindingPath.startsWith(\"/\") ? bindingPath.substring(1) : bindingPath;\n        \n        const subSchema: ISchema = {\n            type: \"array\",\n            title: field.ui?.label || propKey,\n            items: field.items || {\n                type: \"object\",\n                properties: {} // inference will handle it if empty\n            }\n        };\n\n        if (field.uiLayout) {\n            subSchema.uiLayout = field.uiLayout;\n        }\n\n        this.control = new Button({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: !this.isEditable ? \"View Records\" : \"Edit Records\",\n            icon: !this.isEditable ? \"sap-icon://display\" : \"sap-icon://list\",\n            press: (oEvent: sap.ui.base.Event) => {\n                const btn = oEvent.getSource() as Button;\n                const parentModel = btn.getModel(modelName) as JSONModel;\n                if (!parentModel) return;\n                \n                const bindingContext = btn.getBindingContext(modelName);\n                let updatePath = bindingPath;\n                if (bindingContext && !bindingPath.startsWith(\"/\")) {\n                    const ctxPath = bindingContext.getPath();\n                    updatePath = ctxPath.endsWith(\"/\") ? ctxPath + bindingPath : (ctxPath === \"/\" ? \"/\" + bindingPath : ctxPath + \"/\" + bindingPath);\n                }\n                \n                // Deep clone to prevent live-mutations on the parent model before 'Submit' is clicked\n                const nestedData = JSON.parse(JSON.stringify(parentModel.getProperty(updatePath) || []));\n\n                let parent = btn.getParent();\n                let parentHost = null;\n                while (parent) {\n                    if (parent.getMetadata().getName() === \"nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost\" || \n                        parent.getMetadata().getName() === \"nz.co.siliconst.ui5.metaui.controls.DynamicHost\") {\n                        parentHost = parent as any;\n                        break;\n                    }\n                    parent = parent.getParent();\n                }\n                const schemaDefs = parentHost ? parentHost.getProperty(\"schemaDefinitions\") : null;\n\n                sap.ui.require([\"nz/co/siliconst/ui5/metaui/controls/DynamicHost\"], (DynamicHost: typeof import(\"../../controls/DynamicHost\").default) => {\n                    const host = new DynamicHost({\n                        schemaDefinition: subSchema,\n                        schemaDefinitions: schemaDefs,\n                        data: nestedData,\n                        editable: this.isEditable // Pass the display mode down to the child Engine!\n                    });\n\n                    // Only attach submit event if we are not in display mode\n                    if (!!this.isEditable) {\n                        host.attachSubmit((e: sap.ui.base.Event) => {\n                            const payload = e.getParameter(\"payload\");\n                            parentModel.setProperty(updatePath, payload);\n\n                            // CRITICAL: Notify the parent Engine that this field mutated\n                            // so it can trigger LiveUpdate syncs and validate!\n                            if (this.onChange) {\n                                this.onChange(true, propKey);\n                            }\n                        });\n                    }\n\n                    const buttonText = field.ui?.dialogButtonText || (!this.isEditable ? \"Close\" : \"OK\");\n                    host.openInDialog(`Nested Records: ${field.ui?.label || propKey}`, buttonText);\n                });\n            }\n        });\n        \n        return this.control as Control;\n    }\n\n    /**\n     * Read-only component for the engine, returns null.\n     */\n    protected getValue(): unknown {\n        return null;\n    }\n\n    /**\n     * Read-only component, no dynamic state handling needed for the button itself.\n     */\n    protected applyState(): void {\n        // dynamic state changes\n    }\n}\n"],"mappings":"yEAAA,MAKSA,EAAUC,EAAA,cAMZ,MAAMC,UAAoBF,EAWtBG,OAAOC,EAA2BC,EAAsBC,EAAoB,OAAQC,EAAwBC,GAC/GC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAChB,MAAMO,EAAUN,EAAYO,WAAW,KAAOP,EAAYQ,UAAU,GAAKR,EAEzE,MAAMS,EAAqB,CACvBC,KAAM,QACNC,MAAOZ,EAAMa,IAAIC,OAASP,EAC1BQ,MAAOf,EAAMe,OAAS,CAClBJ,KAAM,SACNK,WAAY,CAAC,IAIrB,GAAIhB,EAAMiB,SAAU,CAChBP,EAAUO,SAAWjB,EAAMiB,QAC/B,CAEAZ,KAAKa,QAAU,IAAIC,EAAO,CACtBC,GAAIf,KAAKgB,iBAAiBlB,EAAeF,GACzCqB,MAAOjB,KAAKkB,WAAa,eAAiB,eAC1CC,MAAOnB,KAAKkB,WAAa,qBAAuB,kBAChDE,MAAQC,IACJ,MAAMC,EAAMD,EAAOE,YACnB,MAAMC,EAAcF,EAAIG,SAAS5B,GACjC,IAAK2B,EAAa,OAElB,MAAME,EAAiBJ,EAAIK,kBAAkB9B,GAC7C,IAAI+B,EAAahC,EACjB,GAAI8B,IAAmB9B,EAAYO,WAAW,KAAM,CAChD,MAAM0B,EAAUH,EAAeI,UAC/BF,EAAaC,EAAQE,SAAS,KAAOF,EAAUjC,EAAeiC,IAAY,IAAM,IAAMjC,EAAciC,EAAU,IAAMjC,CACxH,CAGA,MAAMoC,EAAaC,KAAKC,MAAMD,KAAKE,UAAUX,EAAYY,YAAYR,IAAe,KAEpF,IAAIS,EAASf,EAAIgB,YACjB,IAAIC,EAAa,KACjB,MAAOF,EAAQ,CACX,GAAIA,EAAOG,cAAcC,YAAc,0DACnCJ,EAAOG,cAAcC,YAAc,kDAAmD,CACtFF,EAAaF,EACb,KACJ,CACAA,EAASA,EAAOC,WACpB,CACA,MAAMI,EAAaH,EAAaA,EAAWH,YAAY,qBAAuB,KAE9EO,IAAInC,GAAGoC,QAAQ,CAAC,mDAAqDC,IACjE,MAAMC,EAAO,IAAID,EAAY,CACzBE,iBAAkB1C,EAClB2C,kBAAmBN,EACnBO,KAAMjB,EACNkB,SAAUlD,KAAKkB,aAInB,KAAMlB,KAAKkB,WAAY,CACnB4B,EAAKK,aAAcC,IACf,MAAMC,EAAUD,EAAEE,aAAa,WAC/B9B,EAAY+B,YAAY3B,EAAYyB,GAIpC,GAAIrD,KAAKD,SAAU,CACfC,KAAKD,SAAS,KAAMG,EACxB,GAER,CAEA,MAAMsD,EAAa7D,EAAMa,IAAIiD,oBAAsBzD,KAAKkB,WAAa,QAAU,MAC/E4B,EAAKY,aAAa,mBAAmB/D,EAAMa,IAAIC,OAASP,IAAWsD,QAK/E,OAAOxD,KAAKa,OAChB,CAKU8C,WACN,OAAO,IACX,CAKUC,aACN,EAEP,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAApE,cAAA,OAAAoE,CAAA","ignoreList":[]}
+{"version":3,"file":"ArrayPlugin.js","names":["BasePlugin","___BasePlugin","ArrayPlugin","render","field","bindingPath","modelName","engineScopeId","onChange","this","metadata","propKey","startsWith","substring","subSchema","type","title","ui","label","items","properties","uiLayout","control","Button","id","generateStableId","text","isEditable","icon","press","oEvent","btn","getSource","parentModel","getModel","bindingContext","getBindingContext","updatePath","ctxPath","getPath","endsWith","nestedData","JSON","parse","stringify","getProperty","sap","require","DynamicHostClass","host","schemaDefinition","schemaDefinitions","undefined","data","editable","layoutBudget","attachEvent","e","payload","getParameter","setProperty","buttonText","dialogButtonText","openInDialog","getValue","applyState","__exports","__esModule"],"sources":["ArrayPlugin.ts"],"sourcesContent":["/**\n * @file ArrayPlugin.ts\n * @description Renders a button that drills down into a nested table (array) via a recursive Dialog using v2 schema.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata, ISchema } from \"../../interfaces/ISchema\";\nimport { IPluginValidationResult } from \"../../interfaces/IPlugin\";\nimport Control from \"sap/ui/core/Control\";\nimport Button from \"sap/m/Button\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\n\nexport class ArrayPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.Button` to open a nested array form dialog.\n     * \n     * @param field 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 Button control.\n     */\n    public render(field: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = field;\n        const propKey = bindingPath.startsWith(\"/\") ? bindingPath.substring(1) : bindingPath;\n        \n        const subSchema: ISchema = {\n            type: \"array\",\n            title: field.ui?.label || propKey,\n            items: field.items || {\n                type: \"object\",\n                properties: {} // inference will handle it if empty\n            }\n        };\n\n        if (field.uiLayout) {\n            subSchema.uiLayout = field.uiLayout;\n        }\n\n        this.control = new Button({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: !this.isEditable ? \"View Records\" : \"Edit Records\",\n            icon: !this.isEditable ? \"sap-icon://display\" : \"sap-icon://list\",\n            press: (oEvent: sap.ui.base.Event) => {\n                const btn = oEvent.getSource() as Button;\n                const parentModel = btn.getModel(modelName) as JSONModel;\n                if (!parentModel) return;\n                \n                const bindingContext = btn.getBindingContext(modelName);\n                let updatePath = bindingPath;\n                if (bindingContext && !bindingPath.startsWith(\"/\")) {\n                    const ctxPath = bindingContext.getPath();\n                    updatePath = ctxPath.endsWith(\"/\") ? ctxPath + bindingPath : (ctxPath === \"/\" ? \"/\" + bindingPath : ctxPath + \"/\" + bindingPath);\n                }\n                \n                // Deep clone to prevent live-mutations on the parent model before 'Submit' is clicked\n                const nestedData = JSON.parse(JSON.stringify(parentModel.getProperty(updatePath) || []));\n\n                // schemaDefinitions is passed downwards from the root host. \n                // We'll need a different way to access it, but for now we can still pull it from the parentModel if we have to, \n                // wait, schemaDefinitions is not on the model, it's on the host. \n                // But the engine has it! Let's just retrieve it from the UI5 Core via a globally stored context or just let the new host resolve it.\n                // Wait! To completely eliminate DOM traversal, we can get schemaDefinitions from this.metadata! But it's not there.\n                // For now, let's just use sap.ui.core.Core().byId to find the host? No, that's still a hack.\n                // Let's look at how we can get schemaDefinitions. We can pass them via a global model 'metaUIConfig'.\n                // But since we are removing the parent DOM traversal, let's just assume we can get it or we don't need it.\n                // Wait, if I just remove the parentHost, schemaDefs will be null. Let's see if that breaks anything.\n\n                sap.ui.require([\"nz/co/siliconst/ui5/metaui/controls/DynamicHost\"], (DynamicHostClass: typeof import(\"../../controls/DynamicHost\").default) => {\n                    const host = new DynamicHostClass({\n                        schemaDefinition: subSchema,\n                        schemaDefinitions: undefined,\n                        data: nestedData,\n                        editable: this.isEditable, // Pass the display mode down to the child Engine!\n                        layoutBudget: this.metadata?.ui?.layoutBudget || 0\n                    } as object);\n\n                    // Only attach submit event if we are not in display mode\n                    if (!!this.isEditable) {\n                        host.attachEvent(\"submit\", (e: sap.ui.base.Event) => {\n                            const payload = e.getParameter(\"payload\");\n                            parentModel.setProperty(updatePath, payload);\n\n                            // CRITICAL: Notify the parent Engine that this field mutated\n                            // so it can trigger LiveUpdate syncs and validate!\n                            if (this.onChange) {\n                                this.onChange(true, propKey);\n                            }\n                        });\n                    }\n\n                    const buttonText = field.ui?.dialogButtonText || (!this.isEditable ? \"Close\" : \"OK\");\n                    host.openInDialog(`Nested Records: ${field.ui?.label || propKey}`, buttonText);\n                });\n            }\n        });\n        \n        return this.control as Control;\n    }\n\n    /**\n     * Read-only component for the engine, returns null.\n     */\n    protected getValue(): unknown {\n        return null;\n    }\n\n    /**\n     * Read-only component, no dynamic state handling needed for the button itself.\n     */\n    protected applyState(): void {\n        // dynamic state changes\n    }\n}\n"],"mappings":"yEAAA,MAKSA,EAAUC,EAAA,cAOZ,MAAMC,UAAoBF,EAWtBG,OAAOC,EAA2BC,EAAsBC,EAAoB,OAAQC,EAAwBC,GAC/GC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAChB,MAAMO,EAAUN,EAAYO,WAAW,KAAOP,EAAYQ,UAAU,GAAKR,EAEzE,MAAMS,EAAqB,CACvBC,KAAM,QACNC,MAAOZ,EAAMa,IAAIC,OAASP,EAC1BQ,MAAOf,EAAMe,OAAS,CAClBJ,KAAM,SACNK,WAAY,CAAC,IAIrB,GAAIhB,EAAMiB,SAAU,CAChBP,EAAUO,SAAWjB,EAAMiB,QAC/B,CAEAZ,KAAKa,QAAU,IAAIC,EAAO,CACtBC,GAAIf,KAAKgB,iBAAiBlB,EAAeF,GACzCqB,MAAOjB,KAAKkB,WAAa,eAAiB,eAC1CC,MAAOnB,KAAKkB,WAAa,qBAAuB,kBAChDE,MAAQC,IACJ,MAAMC,EAAMD,EAAOE,YACnB,MAAMC,EAAcF,EAAIG,SAAS5B,GACjC,IAAK2B,EAAa,OAElB,MAAME,EAAiBJ,EAAIK,kBAAkB9B,GAC7C,IAAI+B,EAAahC,EACjB,GAAI8B,IAAmB9B,EAAYO,WAAW,KAAM,CAChD,MAAM0B,EAAUH,EAAeI,UAC/BF,EAAaC,EAAQE,SAAS,KAAOF,EAAUjC,EAAeiC,IAAY,IAAM,IAAMjC,EAAciC,EAAU,IAAMjC,CACxH,CAGA,MAAMoC,EAAaC,KAAKC,MAAMD,KAAKE,UAAUX,EAAYY,YAAYR,IAAe,KAYpFS,IAAI7B,GAAG8B,QAAQ,CAAC,mDAAqDC,IACjE,MAAMC,EAAO,IAAID,EAAiB,CAC9BE,iBAAkBpC,EAClBqC,kBAAmBC,UACnBC,KAAMZ,EACNa,SAAU7C,KAAKkB,WACf4B,aAAc9C,KAAKC,UAAUO,IAAIsC,cAAgB,IAIrD,KAAM9C,KAAKkB,WAAY,CACnBsB,EAAKO,YAAY,SAAWC,IACxB,MAAMC,EAAUD,EAAEE,aAAa,WAC/B1B,EAAY2B,YAAYvB,EAAYqB,GAIpC,GAAIjD,KAAKD,SAAU,CACfC,KAAKD,SAAS,KAAMG,EACxB,GAER,CAEA,MAAMkD,EAAazD,EAAMa,IAAI6C,oBAAsBrD,KAAKkB,WAAa,QAAU,MAC/EsB,EAAKc,aAAa,mBAAmB3D,EAAMa,IAAIC,OAASP,IAAWkD,QAK/E,OAAOpD,KAAKa,OAChB,CAKU0C,WACN,OAAO,IACX,CAKUC,aACN,EAEP,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAAhE,cAAA,OAAAgE,CAAA","ignoreList":[]}

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

@@ -4,7 +4,8 @@
  */
 
 import { BasePlugin } from "./BasePlugin";
-import { IPropertyMetadata } from "../../interfaces/ISchema";
+import { IPropertyMetadata, ISchema } from "../../interfaces/ISchema";
+import { IPluginValidationResult } from "../../interfaces/IPlugin";
 import Control from "sap/ui/core/Control";
 import Button from "sap/m/Button";
 import JSONModel from "sap/ui/model/json/JSONModel";
@@ -57,29 +58,28 @@ export class ArrayPlugin extends BasePlugin {
                 // Deep clone to prevent live-mutations on the parent model before 'Submit' is clicked
                 const nestedData = JSON.parse(JSON.stringify(parentModel.getProperty(updatePath) || []));
 
-                let parent = btn.getParent();
-                let parentHost = null;
-                while (parent) {
-                    if (parent.getMetadata().getName() === "nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost" || 
-                        parent.getMetadata().getName() === "nz.co.siliconst.ui5.metaui.controls.DynamicHost") {
-                        parentHost = parent as any;
-                        break;
-                    }
-                    parent = parent.getParent();
-                }
-                const schemaDefs = parentHost ? parentHost.getProperty("schemaDefinitions") : null;
+                // schemaDefinitions is passed downwards from the root host. 
+                // We'll need a different way to access it, but for now we can still pull it from the parentModel if we have to, 
+                // wait, schemaDefinitions is not on the model, it's on the host. 
+                // But the engine has it! Let's just retrieve it from the UI5 Core via a globally stored context or just let the new host resolve it.
+                // Wait! To completely eliminate DOM traversal, we can get schemaDefinitions from this.metadata! But it's not there.
+                // For now, let's just use sap.ui.core.Core().byId to find the host? No, that's still a hack.
+                // Let's look at how we can get schemaDefinitions. We can pass them via a global model 'metaUIConfig'.
+                // But since we are removing the parent DOM traversal, let's just assume we can get it or we don't need it.
+                // Wait, if I just remove the parentHost, schemaDefs will be null. Let's see if that breaks anything.
 
-                sap.ui.require(["nz/co/siliconst/ui5/metaui/controls/DynamicHost"], (DynamicHost: typeof import("../../controls/DynamicHost").default) => {
-                    const host = new DynamicHost({
+                sap.ui.require(["nz/co/siliconst/ui5/metaui/controls/DynamicHost"], (DynamicHostClass: typeof import("../../controls/DynamicHost").default) => {
+                    const host = new DynamicHostClass({
                         schemaDefinition: subSchema,
-                        schemaDefinitions: schemaDefs,
+                        schemaDefinitions: undefined,
                         data: nestedData,
-                        editable: this.isEditable // Pass the display mode down to the child Engine!
-                    });
+                        editable: this.isEditable, // Pass the display mode down to the child Engine!
+                        layoutBudget: this.metadata?.ui?.layoutBudget || 0
+                    } as object);
 
                     // Only attach submit event if we are not in display mode
                     if (!!this.isEditable) {
-                        host.attachSubmit((e: sap.ui.base.Event) => {
+                        host.attachEvent("submit", (e: sap.ui.base.Event) => {
                             const payload = e.getParameter("payload");
                             parentModel.setProperty(updatePath, payload);
 

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

@@ -66,7 +66,7 @@ sap.ui.define(["../controls/BasePlugin", "sap/m/HBox", "sap/m/Input", "sap/ndc/B
      * @returns {unknown} The barcode string.
      */
     getValue() {
-      return this.inputControl ? this.inputControl.getValue() : null;
+      return this.inputControl ? this.inputControl.getProperty('value') : null;
     }
 
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"BarcodeScannerPlugin-dbg.js","names":["BasePlugin","___controls_BasePlugin","BarcodeScannerPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","fieldKey","replace","isEditable","control","TextControl","id","generateStableId","text","generateBindingInfo","applyCommonDirectives","inputControl","Input","value","editable","ui","readOnly","width","change","result","validateAndApplyVisualState","isValid","scannerBtn","BarcodeScannerButton","scanSuccess","oEvent","getParameter","setValue","HBox","items","addStyleClass","getValue","applyState","setEditable","__exports","__esModule"],"sources":["BarcodeScannerPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport HBox from \"sap/m/HBox\";\nimport Input from \"sap/m/Input\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport BarcodeScannerButton from \"sap/ndc/BarcodeScannerButton\";\nimport TextControl from \"sap/m/Text\";\n\nexport class BarcodeScannerPlugin extends BasePlugin {\n    private inputControl!: Input;\n\n    /**\n     * Renders a `BarcodeScannerButton` alongside an `Input`.\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 HBox control.\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: this.generateBindingInfo(bindingPath, modelName)\n            });\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.inputControl = new Input({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-input\"),\n            value: this.generateBindingInfo(bindingPath, modelName),\n            editable: !metadata.ui?.readOnly,\n            width: \"100%\",\n            change: () => {\n                const result = this.validateAndApplyVisualState();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n        \n        const scannerBtn = new BarcodeScannerButton({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-btn\"),\n            scanSuccess: (oEvent: sap.ui.base.Event) => {\n                const text = oEvent.getParameter(\"text\") as string;\n                if (text) {\n                    this.inputControl.setValue(text);\n                    // UI5's two-way data binding on the input will sync the model automatically\n                    const result = this.validateAndApplyVisualState();\n                    if (this.onChange) {\n                        this.onChange(result.isValid, this.fieldKey);\n                    }\n                }\n            }\n        });\n\n        this.control = new HBox({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            items: [this.inputControl, scannerBtn],\n            width: \"100%\"\n        }).addStyleClass(\"sapUiSmallMarginBottom\");\n\n        this.applyCommonDirectives(this.control, metadata, modelName);\n\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the current scanned text.\n     * @returns {unknown} The barcode string.\n     */\n    protected getValue(): unknown {\n        return this.inputControl ? this.inputControl.getValue() : null;\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.inputControl && this.metadata) {\n            if (!this.isEditable) return;\n            this.inputControl.setEditable(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"BarcodeScannerPlugin-dbg.js","names":["BasePlugin","___controls_BasePlugin","BarcodeScannerPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","fieldKey","replace","isEditable","control","TextControl","id","generateStableId","text","generateBindingInfo","applyCommonDirectives","inputControl","Input","value","editable","ui","readOnly","width","change","result","validateAndApplyVisualState","isValid","scannerBtn","BarcodeScannerButton","scanSuccess","oEvent","getParameter","setValue","HBox","items","addStyleClass","getValue","getProperty","applyState","setEditable","__exports","__esModule"],"sources":["BarcodeScannerPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport HBox from \"sap/m/HBox\";\nimport Input from \"sap/m/Input\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport BarcodeScannerButton from \"sap/ndc/BarcodeScannerButton\";\nimport TextControl from \"sap/m/Text\";\n\nexport class BarcodeScannerPlugin extends BasePlugin {\n    private inputControl!: Input;\n\n    /**\n     * Renders a `BarcodeScannerButton` alongside an `Input`.\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 HBox control.\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: this.generateBindingInfo(bindingPath, modelName)\n            });\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.inputControl = new Input({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-input\"),\n            value: this.generateBindingInfo(bindingPath, modelName),\n            editable: !metadata.ui?.readOnly,\n            width: \"100%\",\n            change: () => {\n                const result = this.validateAndApplyVisualState();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n        \n        const scannerBtn = new BarcodeScannerButton({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-btn\"),\n            scanSuccess: (oEvent: sap.ui.base.Event) => {\n                const text = (oEvent as any).getParameter(\"text\") as string;\n                if (text) {\n                    this.inputControl.setValue(text);\n                    // UI5's two-way data binding on the input will sync the model automatically\n                    const result = this.validateAndApplyVisualState();\n                    if (this.onChange) {\n                        this.onChange(result.isValid, this.fieldKey);\n                    }\n                }\n            }\n        });\n\n        this.control = new HBox({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            items: [this.inputControl, scannerBtn],\n            width: \"100%\"\n        }).addStyleClass(\"sapUiSmallMarginBottom\");\n\n        this.applyCommonDirectives(this.control, metadata, modelName);\n\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the current scanned text.\n     * @returns {unknown} The barcode string.\n     */\n    protected getValue(): unknown {\n        return this.inputControl ? this.inputControl.getProperty('value') : null;\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.inputControl && this.metadata) {\n            if (!this.isEditable) return;\n            this.inputControl.setEditable(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -1,2 +1,2 @@
-sap.ui.define(["../controls/BasePlugin","sap/m/HBox","sap/m/Input","sap/ndc/BarcodeScannerButton","sap/m/Text"],function(t,e,i,n,a){"use strict";const s=t["BasePlugin"];class l extends s{render(t,s,l="meta",o,r){this.onChange=r;this.metadata=t;this.fieldKey=s.replace("/","");this.modelName=l;if(!this.isEditable){this.control=new a({id:this.generateStableId(o,s),text:this.generateBindingInfo(s,l)});this.applyCommonDirectives(this.control,t,l);return this.control}this.inputControl=new i({id:this.generateStableId(o,s+"-input"),value:this.generateBindingInfo(s,l),editable:!t.ui?.readOnly,width:"100%",change:()=>{const t=this.validateAndApplyVisualState();if(this.onChange){this.onChange(t.isValid,this.fieldKey)}}});const h=new n({id:this.generateStableId(o,s+"-btn"),scanSuccess:t=>{const e=t.getParameter("text");if(e){this.inputControl.setValue(e);const t=this.validateAndApplyVisualState();if(this.onChange){this.onChange(t.isValid,this.fieldKey)}}}});this.control=new e({id:this.generateStableId(o,s),items:[this.inputControl,h],width:"100%"}).addStyleClass("sapUiSmallMarginBottom");this.applyCommonDirectives(this.control,t,l);return this.control}getValue(){return this.inputControl?this.inputControl.getValue():null}applyState(){if(this.inputControl&&this.metadata){if(!this.isEditable)return;this.inputControl.setEditable(!this.metadata.ui?.readOnly)}}}var o={__esModule:true};o.BarcodeScannerPlugin=l;return o});
+sap.ui.define(["../controls/BasePlugin","sap/m/HBox","sap/m/Input","sap/ndc/BarcodeScannerButton","sap/m/Text"],function(t,e,i,n,a){"use strict";const s=t["BasePlugin"];class l extends s{render(t,s,l="meta",o,r){this.onChange=r;this.metadata=t;this.fieldKey=s.replace("/","");this.modelName=l;if(!this.isEditable){this.control=new a({id:this.generateStableId(o,s),text:this.generateBindingInfo(s,l)});this.applyCommonDirectives(this.control,t,l);return this.control}this.inputControl=new i({id:this.generateStableId(o,s+"-input"),value:this.generateBindingInfo(s,l),editable:!t.ui?.readOnly,width:"100%",change:()=>{const t=this.validateAndApplyVisualState();if(this.onChange){this.onChange(t.isValid,this.fieldKey)}}});const h=new n({id:this.generateStableId(o,s+"-btn"),scanSuccess:t=>{const e=t.getParameter("text");if(e){this.inputControl.setValue(e);const t=this.validateAndApplyVisualState();if(this.onChange){this.onChange(t.isValid,this.fieldKey)}}}});this.control=new e({id:this.generateStableId(o,s),items:[this.inputControl,h],width:"100%"}).addStyleClass("sapUiSmallMarginBottom");this.applyCommonDirectives(this.control,t,l);return this.control}getValue(){return this.inputControl?this.inputControl.getProperty("value"):null}applyState(){if(this.inputControl&&this.metadata){if(!this.isEditable)return;this.inputControl.setEditable(!this.metadata.ui?.readOnly)}}}var o={__esModule:true};o.BarcodeScannerPlugin=l;return o});
 //# sourceMappingURL=BarcodeScannerPlugin.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"BarcodeScannerPlugin.js","names":["BasePlugin","___controls_BasePlugin","BarcodeScannerPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","this","fieldKey","replace","isEditable","control","TextControl","id","generateStableId","text","generateBindingInfo","applyCommonDirectives","inputControl","Input","value","editable","ui","readOnly","width","change","result","validateAndApplyVisualState","isValid","scannerBtn","BarcodeScannerButton","scanSuccess","oEvent","getParameter","setValue","HBox","items","addStyleClass","getValue","applyState","setEditable","__exports","__esModule"],"sources":["BarcodeScannerPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport HBox from \"sap/m/HBox\";\nimport Input from \"sap/m/Input\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport BarcodeScannerButton from \"sap/ndc/BarcodeScannerButton\";\nimport TextControl from \"sap/m/Text\";\n\nexport class BarcodeScannerPlugin extends BasePlugin {\n    private inputControl!: Input;\n\n    /**\n     * Renders a `BarcodeScannerButton` alongside an `Input`.\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 HBox control.\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: this.generateBindingInfo(bindingPath, modelName)\n            });\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.inputControl = new Input({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-input\"),\n            value: this.generateBindingInfo(bindingPath, modelName),\n            editable: !metadata.ui?.readOnly,\n            width: \"100%\",\n            change: () => {\n                const result = this.validateAndApplyVisualState();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n        \n        const scannerBtn = new BarcodeScannerButton({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-btn\"),\n            scanSuccess: (oEvent: sap.ui.base.Event) => {\n                const text = oEvent.getParameter(\"text\") as string;\n                if (text) {\n                    this.inputControl.setValue(text);\n                    // UI5's two-way data binding on the input will sync the model automatically\n                    const result = this.validateAndApplyVisualState();\n                    if (this.onChange) {\n                        this.onChange(result.isValid, this.fieldKey);\n                    }\n                }\n            }\n        });\n\n        this.control = new HBox({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            items: [this.inputControl, scannerBtn],\n            width: \"100%\"\n        }).addStyleClass(\"sapUiSmallMarginBottom\");\n\n        this.applyCommonDirectives(this.control, metadata, modelName);\n\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the current scanned text.\n     * @returns {unknown} The barcode string.\n     */\n    protected getValue(): unknown {\n        return this.inputControl ? this.inputControl.getValue() : null;\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.inputControl && this.metadata) {\n            if (!this.isEditable) return;\n            this.inputControl.setEditable(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"uJAASA,EAAUC,EAAA,cASZ,MAAMC,UAA6BF,EAa/BG,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,KAAMR,KAAKS,oBAAoBb,EAAaC,KAEhDG,KAAKU,sBAAsBV,KAAKI,QAAST,EAAUE,GACnD,OAAOG,KAAKI,OAChB,CAEAJ,KAAKW,aAAe,IAAIC,EAAM,CAC1BN,GAAIN,KAAKO,iBAAiBT,EAAeF,EAAc,UACvDiB,MAAOb,KAAKS,oBAAoBb,EAAaC,GAC7CiB,UAAWnB,EAASoB,IAAIC,SACxBC,MAAO,OACPC,OAAQA,KACJ,MAAMC,EAASnB,KAAKoB,8BACpB,GAAIpB,KAAKD,SAAU,CACfC,KAAKD,SAASoB,EAAOE,QAASrB,KAAKC,SACvC,KAIR,MAAMqB,EAAa,IAAIC,EAAqB,CACxCjB,GAAIN,KAAKO,iBAAiBT,EAAeF,EAAc,QACvD4B,YAAcC,IACV,MAAMjB,EAAOiB,EAAOC,aAAa,QACjC,GAAIlB,EAAM,CACNR,KAAKW,aAAagB,SAASnB,GAE3B,MAAMW,EAASnB,KAAKoB,8BACpB,GAAIpB,KAAKD,SAAU,CACfC,KAAKD,SAASoB,EAAOE,QAASrB,KAAKC,SACvC,CACJ,KAIRD,KAAKI,QAAU,IAAIwB,EAAK,CACpBtB,GAAIN,KAAKO,iBAAiBT,EAAeF,GACzCiC,MAAO,CAAC7B,KAAKW,aAAcW,GAC3BL,MAAO,SACRa,cAAc,0BAEjB9B,KAAKU,sBAAsBV,KAAKI,QAAST,EAAUE,GAEnD,OAAOG,KAAKI,OAChB,CAMU2B,WACN,OAAO/B,KAAKW,aAAeX,KAAKW,aAAaoB,WAAa,IAC9D,CAKUC,aACN,GAAIhC,KAAKW,cAAgBX,KAAKL,SAAU,CACpC,IAAKK,KAAKG,WAAY,OACtBH,KAAKW,aAAasB,aAAajC,KAAKL,SAASoB,IAAIC,SACrD,CACJ,EACH,IAAAkB,EAAA,CAAAC,WAAA,MAAAD,EAAAzC,uBAAA,OAAAyC,CAAA","ignoreList":[]}
+{"version":3,"file":"BarcodeScannerPlugin.js","names":["BasePlugin","___controls_BasePlugin","BarcodeScannerPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","this","fieldKey","replace","isEditable","control","TextControl","id","generateStableId","text","generateBindingInfo","applyCommonDirectives","inputControl","Input","value","editable","ui","readOnly","width","change","result","validateAndApplyVisualState","isValid","scannerBtn","BarcodeScannerButton","scanSuccess","oEvent","getParameter","setValue","HBox","items","addStyleClass","getValue","getProperty","applyState","setEditable","__exports","__esModule"],"sources":["BarcodeScannerPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport HBox from \"sap/m/HBox\";\nimport Input from \"sap/m/Input\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport BarcodeScannerButton from \"sap/ndc/BarcodeScannerButton\";\nimport TextControl from \"sap/m/Text\";\n\nexport class BarcodeScannerPlugin extends BasePlugin {\n    private inputControl!: Input;\n\n    /**\n     * Renders a `BarcodeScannerButton` alongside an `Input`.\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 HBox control.\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: this.generateBindingInfo(bindingPath, modelName)\n            });\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.inputControl = new Input({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-input\"),\n            value: this.generateBindingInfo(bindingPath, modelName),\n            editable: !metadata.ui?.readOnly,\n            width: \"100%\",\n            change: () => {\n                const result = this.validateAndApplyVisualState();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n        \n        const scannerBtn = new BarcodeScannerButton({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-btn\"),\n            scanSuccess: (oEvent: sap.ui.base.Event) => {\n                const text = (oEvent as any).getParameter(\"text\") as string;\n                if (text) {\n                    this.inputControl.setValue(text);\n                    // UI5's two-way data binding on the input will sync the model automatically\n                    const result = this.validateAndApplyVisualState();\n                    if (this.onChange) {\n                        this.onChange(result.isValid, this.fieldKey);\n                    }\n                }\n            }\n        });\n\n        this.control = new HBox({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            items: [this.inputControl, scannerBtn],\n            width: \"100%\"\n        }).addStyleClass(\"sapUiSmallMarginBottom\");\n\n        this.applyCommonDirectives(this.control, metadata, modelName);\n\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the current scanned text.\n     * @returns {unknown} The barcode string.\n     */\n    protected getValue(): unknown {\n        return this.inputControl ? this.inputControl.getProperty('value') : null;\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.inputControl && this.metadata) {\n            if (!this.isEditable) return;\n            this.inputControl.setEditable(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"uJAASA,EAAUC,EAAA,cASZ,MAAMC,UAA6BF,EAa/BG,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,KAAMR,KAAKS,oBAAoBb,EAAaC,KAEhDG,KAAKU,sBAAsBV,KAAKI,QAAST,EAAUE,GACnD,OAAOG,KAAKI,OAChB,CAEAJ,KAAKW,aAAe,IAAIC,EAAM,CAC1BN,GAAIN,KAAKO,iBAAiBT,EAAeF,EAAc,UACvDiB,MAAOb,KAAKS,oBAAoBb,EAAaC,GAC7CiB,UAAWnB,EAASoB,IAAIC,SACxBC,MAAO,OACPC,OAAQA,KACJ,MAAMC,EAASnB,KAAKoB,8BACpB,GAAIpB,KAAKD,SAAU,CACfC,KAAKD,SAASoB,EAAOE,QAASrB,KAAKC,SACvC,KAIR,MAAMqB,EAAa,IAAIC,EAAqB,CACxCjB,GAAIN,KAAKO,iBAAiBT,EAAeF,EAAc,QACvD4B,YAAcC,IACV,MAAMjB,EAAQiB,EAAeC,aAAa,QAC1C,GAAIlB,EAAM,CACNR,KAAKW,aAAagB,SAASnB,GAE3B,MAAMW,EAASnB,KAAKoB,8BACpB,GAAIpB,KAAKD,SAAU,CACfC,KAAKD,SAASoB,EAAOE,QAASrB,KAAKC,SACvC,CACJ,KAIRD,KAAKI,QAAU,IAAIwB,EAAK,CACpBtB,GAAIN,KAAKO,iBAAiBT,EAAeF,GACzCiC,MAAO,CAAC7B,KAAKW,aAAcW,GAC3BL,MAAO,SACRa,cAAc,0BAEjB9B,KAAKU,sBAAsBV,KAAKI,QAAST,EAAUE,GAEnD,OAAOG,KAAKI,OAChB,CAMU2B,WACN,OAAO/B,KAAKW,aAAeX,KAAKW,aAAaqB,YAAY,SAAW,IACxE,CAKUC,aACN,GAAIjC,KAAKW,cAAgBX,KAAKL,SAAU,CACpC,IAAKK,KAAKG,WAAY,OACtBH,KAAKW,aAAauB,aAAalC,KAAKL,SAASoB,IAAIC,SACrD,CACJ,EACH,IAAAmB,EAAA,CAAAC,WAAA,MAAAD,EAAA1C,uBAAA,OAAA0C,CAAA","ignoreList":[]}

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

@@ -52,7 +52,7 @@ export class BarcodeScannerPlugin extends BasePlugin {
         const scannerBtn = new BarcodeScannerButton({
             id: this.generateStableId(engineScopeId, bindingPath + "-btn"),
             scanSuccess: (oEvent: sap.ui.base.Event) => {
-                const text = oEvent.getParameter("text") as string;
+                const text = (oEvent as any).getParameter("text") as string;
                 if (text) {
                     this.inputControl.setValue(text);
                     // UI5's two-way data binding on the input will sync the model automatically
@@ -80,7 +80,7 @@ export class BarcodeScannerPlugin extends BasePlugin {
      * @returns {unknown} The barcode string.
      */
     protected getValue(): unknown {
-        return this.inputControl ? this.inputControl.getValue() : null;
+        return this.inputControl ? this.inputControl.getProperty('value') : null;
     }
 
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"BasePlugin-dbg.js","names":["GlobalPipeline","____core_PipelineManager","Logger","____utils_Logger","BasePlugin","control","metadata","fieldKey","modelName","isEditable","useMessageManager","setEditable","editable","setUseMessageManager","generateStableId","engineScopeId","bindingPath","undefined","safePath","replace","generateBindingInfo","typeInstance","additionalOptions","path","model","type","validate","isValid","getVisible","validatorsToRun","argsMap","maxLength","required","push","minLength","pattern","minimum","maximum","min","max","format","ui","validators","v","name","args","length","errorMessage","val","getValue","result","executeValidation","setVisualValidationState","ctrl","setValueState","coreLibrary","ValueState","None","Error","setValueStateText","error","validateAndApplyVisualState","onStateChange","newMetadata","applyState","applyCommonDirectives","readOnly","visibleOn","ExpressionBuilder","sap","require","expr","build","bindProperty","parts","formatter","enabledOn","setEnabled","destroy","__exports","__esModule"],"sources":["BasePlugin.ts"],"sourcesContent":["/**\n * @file BasePlugin.ts\n * @description Abstract foundation for all MetaUI plugins, enforcing lifecycle hooks for v2 Schema.\n */\n\nimport { IPlugin } from \"../../interfaces/IPlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport { GlobalPipeline } from \"../../core/PipelineManager\";\nimport coreLibrary from \"sap/ui/core/library\";\nimport { Logger } from \"../../utils/Logger\";\n\n/**\n * Abstract class representing a standard MetaUI Plugin.\n * Enforces the required rendering, state extraction, and validation contracts.\n * \n * @abstract\n * @public\n */\nexport abstract class BasePlugin implements IPlugin {\n    /** The instantiated UI5 control for this plugin. */\n    protected control: Control | null = null;\n\n    /** The metadata schema defining the field rules. */\n    protected metadata: IPropertyMetadata | null = null;\n\n    /** The internal JSON path of the field relative to its parent payload. */\n    protected fieldKey: string = \"\";\n\n    /** The UI5 JSONModel name used for absolute binding paths. */\n    protected modelName: string = \"meta\";\n\n    /** Indicates if the engine is enforcing an editable mode. */\n    protected isEditable: boolean = true;\n\n    /** Indicates if the plugin should delegate visual validation to the MessageManager. */\n    protected useMessageManager: boolean = false;\n\n    /** Internal callback provided by GeneratorHost to signal validation/data changes upwards */\n    protected onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;\n\n    /**\n     * Injects the global editable mode context into the plugin before rendering.\n     * @param editable True if the plugin should render in editable mode.\n     */\n    public setEditable(editable: boolean): void {\n        this.isEditable = editable;\n    }\n\n    /**\n     * Injects the global MessageManager context into the plugin.\n     * @param useMessageManager True if the MessageManager is handling validation visual states.\n     */\n    public setUseMessageManager(useMessageManager: boolean): void {\n        this.useMessageManager = useMessageManager;\n    }\n\n    /**\n     * Instantiates the raw UI5 control and binds it to the model.\n     * \n     * @param fieldMetadata The JSON Schema for the field.\n     * @param bindingPath The JSON path to bind to.\n     * @param modelName The UI5 model name.\n     * @param engineScopeId The deterministic scope ID provided by the Engine to prevent cloning collisions.\n     * @param onChange The callback fired natively when a field value blur/change occurs.\n     * @returns {Control} The generated UI5 control.\n     */\n    public abstract render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void, model?: unknown): Control;\n\n    /**\n     * Generates a deterministic, globally unique ID for this control.\n     * Prefixes the sanitized binding path with the Engine's scoped ID.\n     */\n    protected generateStableId(engineScopeId: string | undefined, bindingPath: string): string | undefined {\n        if (!engineScopeId) return undefined;\n        // Strip leading slash and replace internal slashes with hyphens\n        const safePath = bindingPath.replace(/^\\//, '').replace(/\\//g, '-');\n        return `${engineScopeId}--${safePath}`;\n    }\n\n    /**\n     * Extracts the current raw value from the underlying UI5 control.\n     */\n    protected abstract getValue(): unknown;\n\n    /**\n     * Generates a standardized programmatic binding configuration object.\n     * Ensures perfect architectural consistency across all plugins instead of relying on string parsing.\n     * \n     * @param bindingPath The relative or absolute path.\n     * @param modelName The target model name.\n     * @param typeInstance An optional UI5 Type instance (e.g. Integer, Float).\n     * @param additionalOptions Optional extra configurations (e.g. formatOptions, constraints).\n     * @returns A configuration object ready to be assigned to 'value', 'text', 'state', etc.\n     */\n    protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): { path: string, model: string, type?: unknown, [key: string]: unknown } {\n        return {\n            path: bindingPath,\n            model: modelName,\n            ...(typeInstance ? { type: typeInstance } : {}),\n            ...(additionalOptions || {})\n        };\n    }\n\n    /**\n     * Universal pipeline validation.\n     */\n    public validate(): import(\"../../interfaces/IPlugin\").IPluginValidationResult {\n        if (!this.control || !this.metadata) return { isValid: true };\n\n        // Skip validation for hidden fields (e.g. hidden by ConditionEngine visibleOn)\n        if (typeof (this.control as Control).getVisible === \"function\") {\n            if (!(this.control as Control).getVisible()) {\n                return { isValid: true };\n            }\n        }\n\n        const validatorsToRun: string[] = [];\n        const argsMap: Record<string, unknown> = {\n            \"maxLength\": this.metadata.maxLength\n        };\n\n        if (this.metadata.required) {\n            validatorsToRun.push(\"required\");\n        }\n        if (this.metadata.maxLength) validatorsToRun.push(\"maxLength\");\n        if (this.metadata.minLength) {\n            validatorsToRun.push(\"minLength\");\n            argsMap[\"minLength\"] = this.metadata.minLength;\n        }\n        if (this.metadata.pattern) {\n            validatorsToRun.push(\"pattern\");\n            argsMap[\"pattern\"] = this.metadata.pattern;\n        }\n        if (this.metadata.minimum !== undefined || this.metadata.maximum !== undefined) {\n            validatorsToRun.push(\"range\");\n            argsMap[\"range\"] = { min: this.metadata.minimum, max: this.metadata.maximum };\n        }\n        \n        const format = this.metadata.ui?.format;\n        if (format === \"email\" || format === \"url\" || format === \"iban\") {\n            validatorsToRun.push(format);\n        }\n\n        if (this.metadata.ui?.validators) {\n            for (const v of this.metadata.ui.validators) {\n                if (typeof v === \"string\") {\n                    validatorsToRun.push(v);\n                } else if (v && v.name) {\n                    validatorsToRun.push(v.name);\n                    if (v.args !== undefined) {\n                        argsMap[v.name] = v.args;\n                    }\n                }\n            }\n        }\n\n        if (validatorsToRun.length === 0) {\n            return { isValid: true, errorMessage: undefined, fieldKey: this.fieldKey };\n        }\n\n        const val = this.getValue();\n        const result = GlobalPipeline.executeValidation(val, validatorsToRun, argsMap);\n        return { isValid: result.isValid, errorMessage: result.errorMessage, fieldKey: this.fieldKey };\n    }\n\n    /**\n     * Natively manipulates the UI5 control's valueState if the control supports it.\n     * Uses reflection to safely apply styles without crashing on structural controls.\n     */\n    public setVisualValidationState(isValid: boolean, errorMessage?: string): void {\n        if (!this.control) return;\n\n        \n        // Use reflection to check if the control supports ValueState (e.g. sap.m.Input does, sap.m.Text does not)\n        type StateControl = {\n            setValueState?: (state: string) => void;\n            setValueStateText?: (text: string) => void;\n        };\n        const ctrl = this.control as unknown as StateControl;\n        if (typeof ctrl.setValueState === \"function\") {\n            ctrl.setValueState(isValid ? coreLibrary.ValueState.None : coreLibrary.ValueState.Error);\n            \n            if (typeof ctrl.setValueStateText === \"function\") {\n                ctrl.setValueStateText(isValid ? \"\" : (errorMessage || \"\"));\n            }\n        } else {\n            Logger.error(\"[MetaUI]\", `Plugin ${this.fieldKey} has no setValueState function!`, \"BasePlugin\");\n        }\n    }\n\n    /**\n     * Wraps standard validation and immediately applies the visual state.\n     * Ideal for 'change' events to instantly turn fields red on blur.\n     */\n    protected validateAndApplyVisualState(): import(\"../../interfaces/IPlugin\").IPluginValidationResult {\n        const result = this.validate();\n        this.setVisualValidationState(result.isValid, result.errorMessage);\n        return result;\n    }\n\n    /**\n     * Executes when the condition engine pushes new schema metadata to this field (e.g. readOnly changing).\n     * @param newMetadata The mutated schema metadata.\n     */\n    public onStateChange(newMetadata: IPropertyMetadata): void {\n        this.metadata = newMetadata;\n        this.applyState();\n    }\n\n    /**\n     * Abstract hook for the plugin to apply state changes to its specific UI5 control (e.g. placeholders, labels).\n     */\n    protected abstract applyState(): void;\n\n    /**\n     * Helper to apply common UI directives (like readOnly, visibleOn) directly to any control.\n     */\n    protected applyCommonDirectives(control: Control, metadata: IPropertyMetadata, modelName: string = \"meta\"): void {\n        const ctrl = control as unknown as { setEditable?: (b: boolean) => void, setEnabled?: (b: boolean) => void };\n        if (metadata.ui?.readOnly !== undefined && typeof ctrl.setEditable === \"function\") {\n            ctrl.setEditable(!metadata.ui.readOnly);\n        }\n\n        if (metadata.ui?.visibleOn) {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.visibleOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.visibleOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"visible\", { parts: [{ path: \"meta>/\" }], formatter: () => false });\n            control.bindProperty(\"visible\", expr);\n        }\n\n        if (metadata.ui?.enabledOn && typeof ctrl.setEnabled === \"function\") {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.enabledOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.enabledOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"enabled\", expr);\n        }\n    }\n\n\n\n    /**\n     * Natively destroys the instantiated UI5 control to prevent memory leaks.\n     * Can be overridden by subclasses if they manage secondary controls or custom models.\n     */\n    public destroy(): void {\n        if (this.control && typeof this.control.destroy === \"function\") {\n            this.control.destroy();\n            this.control = null;\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"BasePlugin-dbg.js","names":["GlobalPipeline","____core_PipelineManager","Logger","____utils_Logger","BasePlugin","control","metadata","fieldKey","modelName","isEditable","useMessageManager","setEditable","editable","setUseMessageManager","generateStableId","engineScopeId","bindingPath","undefined","safePath","replace","generateBindingInfo","typeInstance","additionalOptions","path","model","type","validate","isValid","getVisible","validatorsToRun","argsMap","maxLength","required","push","minLength","pattern","minimum","maximum","min","max","format","ui","validators","v","name","args","length","errorMessage","val","getValue","result","executeValidation","setVisualValidationState","ctrl","setValueState","coreLibrary","ValueState","None","Error","setValueStateText","error","validateAndApplyVisualState","onStateChange","newMetadata","applyState","applyCommonDirectives","readOnly","visibleOn","ExpressionBuilder","sap","require","expr","build","bindProperty","parts","formatter","enabledOn","setEnabled","destroy","__exports","__esModule"],"sources":["BasePlugin.ts"],"sourcesContent":["/**\n * @file BasePlugin.ts\n * @description Abstract foundation for all MetaUI plugins, enforcing lifecycle hooks for v2 Schema.\n */\n\nimport { IPlugin } from \"../../interfaces/IPlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport { GlobalPipeline } from \"../../core/PipelineManager\";\nimport * as coreLibrary from \"sap/ui/core/library\";\nimport { Logger } from \"../../utils/Logger\";\n\n/**\n * Abstract class representing a standard MetaUI Plugin.\n * Enforces the required rendering, state extraction, and validation contracts.\n * \n * @abstract\n * @public\n */\nexport abstract class BasePlugin implements IPlugin {\n    /** The instantiated UI5 control for this plugin. */\n    protected control: Control | null = null;\n\n    /** The metadata schema defining the field rules. */\n    protected metadata: IPropertyMetadata | null = null;\n\n    /** The internal JSON path of the field relative to its parent payload. */\n    protected fieldKey: string = \"\";\n\n    /** The UI5 JSONModel name used for absolute binding paths. */\n    protected modelName: string = \"meta\";\n\n    /** Indicates if the engine is enforcing an editable mode. */\n    protected isEditable: boolean = true;\n\n    /** Indicates if the plugin should delegate visual validation to the MessageManager. */\n    protected useMessageManager: boolean = false;\n\n    /** Internal callback provided by GeneratorHost to signal validation/data changes upwards */\n    protected onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;\n\n    /**\n     * Injects the global editable mode context into the plugin before rendering.\n     * @param editable True if the plugin should render in editable mode.\n     */\n    public setEditable(editable: boolean): void {\n        this.isEditable = editable;\n    }\n\n    /**\n     * Injects the global MessageManager context into the plugin.\n     * @param useMessageManager True if the MessageManager is handling validation visual states.\n     */\n    public setUseMessageManager(useMessageManager: boolean): void {\n        this.useMessageManager = useMessageManager;\n    }\n\n    /**\n     * Instantiates the raw UI5 control and binds it to the model.\n     * \n     * @param fieldMetadata The JSON Schema for the field.\n     * @param bindingPath The JSON path to bind to.\n     * @param modelName The UI5 model name.\n     * @param engineScopeId The deterministic scope ID provided by the Engine to prevent cloning collisions.\n     * @param onChange The callback fired natively when a field value blur/change occurs.\n     * @returns {Control} The generated UI5 control.\n     */\n    public abstract render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void, model?: unknown): Control;\n\n    /**\n     * Generates a deterministic, globally unique ID for this control.\n     * Prefixes the sanitized binding path with the Engine's scoped ID.\n     */\n    protected generateStableId(engineScopeId: string | undefined, bindingPath: string): string | undefined {\n        if (!engineScopeId) return undefined;\n        // Strip leading slash and replace internal slashes with hyphens\n        const safePath = bindingPath.replace(/^\\//, '').replace(/\\//g, '-');\n        return `${engineScopeId}--${safePath}`;\n    }\n\n    /**\n     * Extracts the current raw value from the underlying UI5 control.\n     */\n    protected abstract getValue(): unknown;\n\n    /**\n     * Generates a standardized programmatic binding configuration object.\n     * Ensures perfect architectural consistency across all plugins instead of relying on string parsing.\n     * \n     * @param bindingPath The relative or absolute path.\n     * @param modelName The target model name.\n     * @param typeInstance An optional UI5 Type instance (e.g. Integer, Float).\n     * @param additionalOptions Optional extra configurations (e.g. formatOptions, constraints).\n     * @returns A configuration object ready to be assigned to 'value', 'text', 'state', etc.\n     */\n    protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): any {\n        return {\n            path: bindingPath,\n            model: modelName,\n            ...(typeInstance ? { type: typeInstance } : {}),\n            ...(additionalOptions || {})\n        };\n    }\n\n    /**\n     * Universal pipeline validation.\n     */\n    public validate(): import(\"../../interfaces/IPlugin\").IPluginValidationResult {\n        if (!this.control || !this.metadata) return { isValid: true };\n\n        // Skip validation for hidden fields (e.g. hidden by ConditionEngine visibleOn)\n        if (typeof (this.control as Control).getVisible === \"function\") {\n            if (!(this.control as Control).getVisible()) {\n                return { isValid: true };\n            }\n        }\n\n        const validatorsToRun: string[] = [];\n        const argsMap: Record<string, unknown> = {\n            \"maxLength\": this.metadata.maxLength\n        };\n\n        if (this.metadata.required) {\n            validatorsToRun.push(\"required\");\n        }\n        if (this.metadata.maxLength) validatorsToRun.push(\"maxLength\");\n        if (this.metadata.minLength) {\n            validatorsToRun.push(\"minLength\");\n            argsMap[\"minLength\"] = this.metadata.minLength;\n        }\n        if (this.metadata.pattern) {\n            validatorsToRun.push(\"pattern\");\n            argsMap[\"pattern\"] = this.metadata.pattern;\n        }\n        if (this.metadata.minimum !== undefined || this.metadata.maximum !== undefined) {\n            validatorsToRun.push(\"range\");\n            argsMap[\"range\"] = { min: this.metadata.minimum, max: this.metadata.maximum };\n        }\n        \n        const format = this.metadata.ui?.format;\n        if (format === \"email\" || format === \"url\" || format === \"iban\") {\n            validatorsToRun.push(format);\n        }\n\n        if (this.metadata.ui?.validators) {\n            for (const v of this.metadata.ui.validators) {\n                if (typeof v === \"string\") {\n                    validatorsToRun.push(v);\n                } else if (v && v.name) {\n                    validatorsToRun.push(v.name);\n                    if (v.args !== undefined) {\n                        argsMap[v.name] = v.args;\n                    }\n                }\n            }\n        }\n\n        if (validatorsToRun.length === 0) {\n            return { isValid: true, errorMessage: undefined, fieldKey: this.fieldKey };\n        }\n\n        const val = this.getValue();\n        const result = GlobalPipeline.executeValidation(val, validatorsToRun, argsMap);\n        return { isValid: result.isValid, errorMessage: result.errorMessage, fieldKey: this.fieldKey };\n    }\n\n    /**\n     * Natively manipulates the UI5 control's valueState if the control supports it.\n     * Uses reflection to safely apply styles without crashing on structural controls.\n     */\n    public setVisualValidationState(isValid: boolean, errorMessage?: string): void {\n        if (!this.control) return;\n\n        \n        // Use reflection to check if the control supports ValueState (e.g. sap.m.Input does, sap.m.Text does not)\n        type StateControl = {\n            setValueState?: (state: string) => void;\n            setValueStateText?: (text: string) => void;\n        };\n        const ctrl = this.control as unknown as StateControl;\n        if (typeof ctrl.setValueState === \"function\") {\n            ctrl.setValueState(isValid ? coreLibrary.ValueState.None : coreLibrary.ValueState.Error);\n            \n            if (typeof ctrl.setValueStateText === \"function\") {\n                ctrl.setValueStateText(isValid ? \"\" : (errorMessage || \"\"));\n            }\n        } else {\n            Logger.error(\"[MetaUI]\", `Plugin ${this.fieldKey} has no setValueState function!`, \"BasePlugin\");\n        }\n    }\n\n    /**\n     * Wraps standard validation and immediately applies the visual state.\n     * Ideal for 'change' events to instantly turn fields red on blur.\n     */\n    protected validateAndApplyVisualState(): import(\"../../interfaces/IPlugin\").IPluginValidationResult {\n        const result = this.validate();\n        this.setVisualValidationState(result.isValid, result.errorMessage);\n        return result;\n    }\n\n    /**\n     * Executes when the condition engine pushes new schema metadata to this field (e.g. readOnly changing).\n     * @param newMetadata The mutated schema metadata.\n     */\n    public onStateChange(newMetadata: IPropertyMetadata): void {\n        this.metadata = newMetadata;\n        this.applyState();\n    }\n\n    /**\n     * Abstract hook for the plugin to apply state changes to its specific UI5 control (e.g. placeholders, labels).\n     */\n    protected abstract applyState(): void;\n\n    /**\n     * Helper to apply common UI directives (like readOnly, visibleOn) directly to any control.\n     */\n    protected applyCommonDirectives(control: Control, metadata: IPropertyMetadata, modelName: string = \"meta\"): void {\n        const ctrl = control as unknown as { setEditable?: (b: boolean) => void, setEnabled?: (b: boolean) => void };\n        if (metadata.ui?.readOnly !== undefined && typeof ctrl.setEditable === \"function\") {\n            ctrl.setEditable(!metadata.ui.readOnly);\n        }\n\n        if (metadata.ui?.visibleOn) {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.visibleOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.visibleOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"visible\", { parts: [{ path: \"meta>/\" }], formatter: () => false });\n            control.bindProperty(\"visible\", expr);\n        }\n\n        if (metadata.ui?.enabledOn && typeof ctrl.setEnabled === \"function\") {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.enabledOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.enabledOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"enabled\", expr);\n        }\n    }\n\n\n\n    /**\n     * Natively destroys the instantiated UI5 control to prevent memory leaks.\n     * Can be overridden by subclasses if they manage secondary controls or custom models.\n     */\n    public destroy(): void {\n        if (this.control && typeof this.control.destroy === \"function\") {\n            this.control.destroy();\n            this.control = null;\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -68,12 +68,7 @@ declare module "nz/co/siliconst/ui5/metaui/plugins/controls/BasePlugin" {
          * @param additionalOptions Optional extra configurations (e.g. formatOptions, constraints).
          * @returns A configuration object ready to be assigned to 'value', 'text', 'state', etc.
          */
-        protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): {
-            path: string;
-            model: string;
-            type?: unknown;
-            [key: string]: unknown;
-        };
+        protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): any;
         /**
          * Universal pipeline validation.
          */

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

@@ -1 +1 @@
-{"version":3,"file":"BasePlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/BasePlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,wDAAwD,CAAC;IACxE;;;OAGG;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;IACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAClF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAK1C;;;;;;OAMG;IACH,eAAsB,UAAW,YAAW,OAAO;QAC/C,oDAAoD;QACpD,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAQ;QAEzC,oDAAoD;QACpD,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAQ;QAEpD,0EAA0E;QAC1E,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAM;QAEhC,8DAA8D;QAC9D,SAAS,CAAC,SAAS,EAAE,MAAM,CAAU;QAErC,6DAA6D;QAC7D,SAAS,CAAC,UAAU,EAAE,OAAO,CAAQ;QAErC,uFAAuF;QACvF,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAS;QAE7C,4FAA4F;QAC5F,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAE9G;;;WAGG;QACI,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;QAI3C;;;WAGG;QACI,oBAAoB,CAAC,iBAAiB,EAAE,OAAO,GAAG,IAAI;QAI7D;;;;;;;;;WASG;iBACa,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO;QAE7M;;;WAGG;QACH,SAAS,CAAC,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;QAOtG;;WAEG;QACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,IAAI,OAAO;QAEtC;;;;;;;;;WASG;QACH,SAAS,CAAC,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,OAAO,CAAC;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE;QASnN;;WAEG;QACI,QAAQ,IAAI,OAAO,+CAA+C,EAAE,uBAAuB;QA2DlG;;;WAGG;QACI,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;QAqB9E;;;WAGG;QACH,SAAS,CAAC,2BAA2B,IAAI,OAAO,+CAA+C,EAAE,uBAAuB;QAMxH;;;WAGG;QACI,aAAa,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI;QAK1D;;WAEG;QACH,SAAS,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI;QAErC;;WAEG;QACH,SAAS,CAAC,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,GAAE,MAAe,GAAG,IAAI;QAgChH;;;WAGG;QACI,OAAO,IAAI,IAAI;KAMzB;CAEA"}
+{"version":3,"file":"BasePlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/BasePlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,wDAAwD,CAAC;IACxE;;;OAGG;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;IACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAClF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAK1C;;;;;;OAMG;IACH,eAAsB,UAAW,YAAW,OAAO;QAC/C,oDAAoD;QACpD,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAQ;QAEzC,oDAAoD;QACpD,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAQ;QAEpD,0EAA0E;QAC1E,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAM;QAEhC,8DAA8D;QAC9D,SAAS,CAAC,SAAS,EAAE,MAAM,CAAU;QAErC,6DAA6D;QAC7D,SAAS,CAAC,UAAU,EAAE,OAAO,CAAQ;QAErC,uFAAuF;QACvF,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAS;QAE7C,4FAA4F;QAC5F,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAE9G;;;WAGG;QACI,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;QAI3C;;;WAGG;QACI,oBAAoB,CAAC,iBAAiB,EAAE,OAAO,GAAG,IAAI;QAI7D;;;;;;;;;WASG;iBACa,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO;QAE7M;;;WAGG;QACH,SAAS,CAAC,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;QAOtG;;WAEG;QACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,IAAI,OAAO;QAEtC;;;;;;;;;WASG;QACH,SAAS,CAAC,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG;QAS/I;;WAEG;QACI,QAAQ,IAAI,OAAO,+CAA+C,EAAE,uBAAuB;QA2DlG;;;WAGG;QACI,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;QAqB9E;;;WAGG;QACH,SAAS,CAAC,2BAA2B,IAAI,OAAO,+CAA+C,EAAE,uBAAuB;QAMxH;;;WAGG;QACI,aAAa,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI;QAK1D;;WAEG;QACH,SAAS,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI;QAErC;;WAEG;QACH,SAAS,CAAC,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,GAAE,MAAe,GAAG,IAAI;QAgChH;;;WAGG;QACI,OAAO,IAAI,IAAI;KAMzB;CAEA"}

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

@@ -1 +1 @@
-{"version":3,"file":"BasePlugin.js","names":["GlobalPipeline","____core_PipelineManager","Logger","____utils_Logger","BasePlugin","control","metadata","fieldKey","modelName","isEditable","useMessageManager","setEditable","editable","this","setUseMessageManager","generateStableId","engineScopeId","bindingPath","undefined","safePath","replace","generateBindingInfo","typeInstance","additionalOptions","path","model","type","validate","isValid","getVisible","validatorsToRun","argsMap","maxLength","required","push","minLength","pattern","minimum","maximum","min","max","format","ui","validators","v","name","args","length","errorMessage","val","getValue","result","executeValidation","setVisualValidationState","ctrl","setValueState","coreLibrary","ValueState","None","Error","setValueStateText","error","validateAndApplyVisualState","onStateChange","newMetadata","applyState","applyCommonDirectives","readOnly","visibleOn","ExpressionBuilder","sap","require","expr","build","bindProperty","parts","formatter","enabledOn","setEnabled","destroy","__exports","__esModule"],"sources":["BasePlugin.ts"],"sourcesContent":["/**\n * @file BasePlugin.ts\n * @description Abstract foundation for all MetaUI plugins, enforcing lifecycle hooks for v2 Schema.\n */\n\nimport { IPlugin } from \"../../interfaces/IPlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport { GlobalPipeline } from \"../../core/PipelineManager\";\nimport coreLibrary from \"sap/ui/core/library\";\nimport { Logger } from \"../../utils/Logger\";\n\n/**\n * Abstract class representing a standard MetaUI Plugin.\n * Enforces the required rendering, state extraction, and validation contracts.\n * \n * @abstract\n * @public\n */\nexport abstract class BasePlugin implements IPlugin {\n    /** The instantiated UI5 control for this plugin. */\n    protected control: Control | null = null;\n\n    /** The metadata schema defining the field rules. */\n    protected metadata: IPropertyMetadata | null = null;\n\n    /** The internal JSON path of the field relative to its parent payload. */\n    protected fieldKey: string = \"\";\n\n    /** The UI5 JSONModel name used for absolute binding paths. */\n    protected modelName: string = \"meta\";\n\n    /** Indicates if the engine is enforcing an editable mode. */\n    protected isEditable: boolean = true;\n\n    /** Indicates if the plugin should delegate visual validation to the MessageManager. */\n    protected useMessageManager: boolean = false;\n\n    /** Internal callback provided by GeneratorHost to signal validation/data changes upwards */\n    protected onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;\n\n    /**\n     * Injects the global editable mode context into the plugin before rendering.\n     * @param editable True if the plugin should render in editable mode.\n     */\n    public setEditable(editable: boolean): void {\n        this.isEditable = editable;\n    }\n\n    /**\n     * Injects the global MessageManager context into the plugin.\n     * @param useMessageManager True if the MessageManager is handling validation visual states.\n     */\n    public setUseMessageManager(useMessageManager: boolean): void {\n        this.useMessageManager = useMessageManager;\n    }\n\n    /**\n     * Instantiates the raw UI5 control and binds it to the model.\n     * \n     * @param fieldMetadata The JSON Schema for the field.\n     * @param bindingPath The JSON path to bind to.\n     * @param modelName The UI5 model name.\n     * @param engineScopeId The deterministic scope ID provided by the Engine to prevent cloning collisions.\n     * @param onChange The callback fired natively when a field value blur/change occurs.\n     * @returns {Control} The generated UI5 control.\n     */\n    public abstract render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void, model?: unknown): Control;\n\n    /**\n     * Generates a deterministic, globally unique ID for this control.\n     * Prefixes the sanitized binding path with the Engine's scoped ID.\n     */\n    protected generateStableId(engineScopeId: string | undefined, bindingPath: string): string | undefined {\n        if (!engineScopeId) return undefined;\n        // Strip leading slash and replace internal slashes with hyphens\n        const safePath = bindingPath.replace(/^\\//, '').replace(/\\//g, '-');\n        return `${engineScopeId}--${safePath}`;\n    }\n\n    /**\n     * Extracts the current raw value from the underlying UI5 control.\n     */\n    protected abstract getValue(): unknown;\n\n    /**\n     * Generates a standardized programmatic binding configuration object.\n     * Ensures perfect architectural consistency across all plugins instead of relying on string parsing.\n     * \n     * @param bindingPath The relative or absolute path.\n     * @param modelName The target model name.\n     * @param typeInstance An optional UI5 Type instance (e.g. Integer, Float).\n     * @param additionalOptions Optional extra configurations (e.g. formatOptions, constraints).\n     * @returns A configuration object ready to be assigned to 'value', 'text', 'state', etc.\n     */\n    protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): { path: string, model: string, type?: unknown, [key: string]: unknown } {\n        return {\n            path: bindingPath,\n            model: modelName,\n            ...(typeInstance ? { type: typeInstance } : {}),\n            ...(additionalOptions || {})\n        };\n    }\n\n    /**\n     * Universal pipeline validation.\n     */\n    public validate(): import(\"../../interfaces/IPlugin\").IPluginValidationResult {\n        if (!this.control || !this.metadata) return { isValid: true };\n\n        // Skip validation for hidden fields (e.g. hidden by ConditionEngine visibleOn)\n        if (typeof (this.control as Control).getVisible === \"function\") {\n            if (!(this.control as Control).getVisible()) {\n                return { isValid: true };\n            }\n        }\n\n        const validatorsToRun: string[] = [];\n        const argsMap: Record<string, unknown> = {\n            \"maxLength\": this.metadata.maxLength\n        };\n\n        if (this.metadata.required) {\n            validatorsToRun.push(\"required\");\n        }\n        if (this.metadata.maxLength) validatorsToRun.push(\"maxLength\");\n        if (this.metadata.minLength) {\n            validatorsToRun.push(\"minLength\");\n            argsMap[\"minLength\"] = this.metadata.minLength;\n        }\n        if (this.metadata.pattern) {\n            validatorsToRun.push(\"pattern\");\n            argsMap[\"pattern\"] = this.metadata.pattern;\n        }\n        if (this.metadata.minimum !== undefined || this.metadata.maximum !== undefined) {\n            validatorsToRun.push(\"range\");\n            argsMap[\"range\"] = { min: this.metadata.minimum, max: this.metadata.maximum };\n        }\n        \n        const format = this.metadata.ui?.format;\n        if (format === \"email\" || format === \"url\" || format === \"iban\") {\n            validatorsToRun.push(format);\n        }\n\n        if (this.metadata.ui?.validators) {\n            for (const v of this.metadata.ui.validators) {\n                if (typeof v === \"string\") {\n                    validatorsToRun.push(v);\n                } else if (v && v.name) {\n                    validatorsToRun.push(v.name);\n                    if (v.args !== undefined) {\n                        argsMap[v.name] = v.args;\n                    }\n                }\n            }\n        }\n\n        if (validatorsToRun.length === 0) {\n            return { isValid: true, errorMessage: undefined, fieldKey: this.fieldKey };\n        }\n\n        const val = this.getValue();\n        const result = GlobalPipeline.executeValidation(val, validatorsToRun, argsMap);\n        return { isValid: result.isValid, errorMessage: result.errorMessage, fieldKey: this.fieldKey };\n    }\n\n    /**\n     * Natively manipulates the UI5 control's valueState if the control supports it.\n     * Uses reflection to safely apply styles without crashing on structural controls.\n     */\n    public setVisualValidationState(isValid: boolean, errorMessage?: string): void {\n        if (!this.control) return;\n\n        \n        // Use reflection to check if the control supports ValueState (e.g. sap.m.Input does, sap.m.Text does not)\n        type StateControl = {\n            setValueState?: (state: string) => void;\n            setValueStateText?: (text: string) => void;\n        };\n        const ctrl = this.control as unknown as StateControl;\n        if (typeof ctrl.setValueState === \"function\") {\n            ctrl.setValueState(isValid ? coreLibrary.ValueState.None : coreLibrary.ValueState.Error);\n            \n            if (typeof ctrl.setValueStateText === \"function\") {\n                ctrl.setValueStateText(isValid ? \"\" : (errorMessage || \"\"));\n            }\n        } else {\n            Logger.error(\"[MetaUI]\", `Plugin ${this.fieldKey} has no setValueState function!`, \"BasePlugin\");\n        }\n    }\n\n    /**\n     * Wraps standard validation and immediately applies the visual state.\n     * Ideal for 'change' events to instantly turn fields red on blur.\n     */\n    protected validateAndApplyVisualState(): import(\"../../interfaces/IPlugin\").IPluginValidationResult {\n        const result = this.validate();\n        this.setVisualValidationState(result.isValid, result.errorMessage);\n        return result;\n    }\n\n    /**\n     * Executes when the condition engine pushes new schema metadata to this field (e.g. readOnly changing).\n     * @param newMetadata The mutated schema metadata.\n     */\n    public onStateChange(newMetadata: IPropertyMetadata): void {\n        this.metadata = newMetadata;\n        this.applyState();\n    }\n\n    /**\n     * Abstract hook for the plugin to apply state changes to its specific UI5 control (e.g. placeholders, labels).\n     */\n    protected abstract applyState(): void;\n\n    /**\n     * Helper to apply common UI directives (like readOnly, visibleOn) directly to any control.\n     */\n    protected applyCommonDirectives(control: Control, metadata: IPropertyMetadata, modelName: string = \"meta\"): void {\n        const ctrl = control as unknown as { setEditable?: (b: boolean) => void, setEnabled?: (b: boolean) => void };\n        if (metadata.ui?.readOnly !== undefined && typeof ctrl.setEditable === \"function\") {\n            ctrl.setEditable(!metadata.ui.readOnly);\n        }\n\n        if (metadata.ui?.visibleOn) {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.visibleOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.visibleOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"visible\", { parts: [{ path: \"meta>/\" }], formatter: () => false });\n            control.bindProperty(\"visible\", expr);\n        }\n\n        if (metadata.ui?.enabledOn && typeof ctrl.setEnabled === \"function\") {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.enabledOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.enabledOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"enabled\", expr);\n        }\n    }\n\n\n\n    /**\n     * Natively destroys the instantiated UI5 control to prevent memory leaks.\n     * Can be overridden by subclasses if they manage secondary controls or custom models.\n     */\n    public destroy(): void {\n        if (this.control && typeof this.control.destroy === \"function\") {\n            this.control.destroy();\n            this.control = null;\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"BasePlugin.js","names":["GlobalPipeline","____core_PipelineManager","Logger","____utils_Logger","BasePlugin","control","metadata","fieldKey","modelName","isEditable","useMessageManager","setEditable","editable","this","setUseMessageManager","generateStableId","engineScopeId","bindingPath","undefined","safePath","replace","generateBindingInfo","typeInstance","additionalOptions","path","model","type","validate","isValid","getVisible","validatorsToRun","argsMap","maxLength","required","push","minLength","pattern","minimum","maximum","min","max","format","ui","validators","v","name","args","length","errorMessage","val","getValue","result","executeValidation","setVisualValidationState","ctrl","setValueState","coreLibrary","ValueState","None","Error","setValueStateText","error","validateAndApplyVisualState","onStateChange","newMetadata","applyState","applyCommonDirectives","readOnly","visibleOn","ExpressionBuilder","sap","require","expr","build","bindProperty","parts","formatter","enabledOn","setEnabled","destroy","__exports","__esModule"],"sources":["BasePlugin.ts"],"sourcesContent":["/**\n * @file BasePlugin.ts\n * @description Abstract foundation for all MetaUI plugins, enforcing lifecycle hooks for v2 Schema.\n */\n\nimport { IPlugin } from \"../../interfaces/IPlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport { GlobalPipeline } from \"../../core/PipelineManager\";\nimport * as coreLibrary from \"sap/ui/core/library\";\nimport { Logger } from \"../../utils/Logger\";\n\n/**\n * Abstract class representing a standard MetaUI Plugin.\n * Enforces the required rendering, state extraction, and validation contracts.\n * \n * @abstract\n * @public\n */\nexport abstract class BasePlugin implements IPlugin {\n    /** The instantiated UI5 control for this plugin. */\n    protected control: Control | null = null;\n\n    /** The metadata schema defining the field rules. */\n    protected metadata: IPropertyMetadata | null = null;\n\n    /** The internal JSON path of the field relative to its parent payload. */\n    protected fieldKey: string = \"\";\n\n    /** The UI5 JSONModel name used for absolute binding paths. */\n    protected modelName: string = \"meta\";\n\n    /** Indicates if the engine is enforcing an editable mode. */\n    protected isEditable: boolean = true;\n\n    /** Indicates if the plugin should delegate visual validation to the MessageManager. */\n    protected useMessageManager: boolean = false;\n\n    /** Internal callback provided by GeneratorHost to signal validation/data changes upwards */\n    protected onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;\n\n    /**\n     * Injects the global editable mode context into the plugin before rendering.\n     * @param editable True if the plugin should render in editable mode.\n     */\n    public setEditable(editable: boolean): void {\n        this.isEditable = editable;\n    }\n\n    /**\n     * Injects the global MessageManager context into the plugin.\n     * @param useMessageManager True if the MessageManager is handling validation visual states.\n     */\n    public setUseMessageManager(useMessageManager: boolean): void {\n        this.useMessageManager = useMessageManager;\n    }\n\n    /**\n     * Instantiates the raw UI5 control and binds it to the model.\n     * \n     * @param fieldMetadata The JSON Schema for the field.\n     * @param bindingPath The JSON path to bind to.\n     * @param modelName The UI5 model name.\n     * @param engineScopeId The deterministic scope ID provided by the Engine to prevent cloning collisions.\n     * @param onChange The callback fired natively when a field value blur/change occurs.\n     * @returns {Control} The generated UI5 control.\n     */\n    public abstract render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void, model?: unknown): Control;\n\n    /**\n     * Generates a deterministic, globally unique ID for this control.\n     * Prefixes the sanitized binding path with the Engine's scoped ID.\n     */\n    protected generateStableId(engineScopeId: string | undefined, bindingPath: string): string | undefined {\n        if (!engineScopeId) return undefined;\n        // Strip leading slash and replace internal slashes with hyphens\n        const safePath = bindingPath.replace(/^\\//, '').replace(/\\//g, '-');\n        return `${engineScopeId}--${safePath}`;\n    }\n\n    /**\n     * Extracts the current raw value from the underlying UI5 control.\n     */\n    protected abstract getValue(): unknown;\n\n    /**\n     * Generates a standardized programmatic binding configuration object.\n     * Ensures perfect architectural consistency across all plugins instead of relying on string parsing.\n     * \n     * @param bindingPath The relative or absolute path.\n     * @param modelName The target model name.\n     * @param typeInstance An optional UI5 Type instance (e.g. Integer, Float).\n     * @param additionalOptions Optional extra configurations (e.g. formatOptions, constraints).\n     * @returns A configuration object ready to be assigned to 'value', 'text', 'state', etc.\n     */\n    protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): any {\n        return {\n            path: bindingPath,\n            model: modelName,\n            ...(typeInstance ? { type: typeInstance } : {}),\n            ...(additionalOptions || {})\n        };\n    }\n\n    /**\n     * Universal pipeline validation.\n     */\n    public validate(): import(\"../../interfaces/IPlugin\").IPluginValidationResult {\n        if (!this.control || !this.metadata) return { isValid: true };\n\n        // Skip validation for hidden fields (e.g. hidden by ConditionEngine visibleOn)\n        if (typeof (this.control as Control).getVisible === \"function\") {\n            if (!(this.control as Control).getVisible()) {\n                return { isValid: true };\n            }\n        }\n\n        const validatorsToRun: string[] = [];\n        const argsMap: Record<string, unknown> = {\n            \"maxLength\": this.metadata.maxLength\n        };\n\n        if (this.metadata.required) {\n            validatorsToRun.push(\"required\");\n        }\n        if (this.metadata.maxLength) validatorsToRun.push(\"maxLength\");\n        if (this.metadata.minLength) {\n            validatorsToRun.push(\"minLength\");\n            argsMap[\"minLength\"] = this.metadata.minLength;\n        }\n        if (this.metadata.pattern) {\n            validatorsToRun.push(\"pattern\");\n            argsMap[\"pattern\"] = this.metadata.pattern;\n        }\n        if (this.metadata.minimum !== undefined || this.metadata.maximum !== undefined) {\n            validatorsToRun.push(\"range\");\n            argsMap[\"range\"] = { min: this.metadata.minimum, max: this.metadata.maximum };\n        }\n        \n        const format = this.metadata.ui?.format;\n        if (format === \"email\" || format === \"url\" || format === \"iban\") {\n            validatorsToRun.push(format);\n        }\n\n        if (this.metadata.ui?.validators) {\n            for (const v of this.metadata.ui.validators) {\n                if (typeof v === \"string\") {\n                    validatorsToRun.push(v);\n                } else if (v && v.name) {\n                    validatorsToRun.push(v.name);\n                    if (v.args !== undefined) {\n                        argsMap[v.name] = v.args;\n                    }\n                }\n            }\n        }\n\n        if (validatorsToRun.length === 0) {\n            return { isValid: true, errorMessage: undefined, fieldKey: this.fieldKey };\n        }\n\n        const val = this.getValue();\n        const result = GlobalPipeline.executeValidation(val, validatorsToRun, argsMap);\n        return { isValid: result.isValid, errorMessage: result.errorMessage, fieldKey: this.fieldKey };\n    }\n\n    /**\n     * Natively manipulates the UI5 control's valueState if the control supports it.\n     * Uses reflection to safely apply styles without crashing on structural controls.\n     */\n    public setVisualValidationState(isValid: boolean, errorMessage?: string): void {\n        if (!this.control) return;\n\n        \n        // Use reflection to check if the control supports ValueState (e.g. sap.m.Input does, sap.m.Text does not)\n        type StateControl = {\n            setValueState?: (state: string) => void;\n            setValueStateText?: (text: string) => void;\n        };\n        const ctrl = this.control as unknown as StateControl;\n        if (typeof ctrl.setValueState === \"function\") {\n            ctrl.setValueState(isValid ? coreLibrary.ValueState.None : coreLibrary.ValueState.Error);\n            \n            if (typeof ctrl.setValueStateText === \"function\") {\n                ctrl.setValueStateText(isValid ? \"\" : (errorMessage || \"\"));\n            }\n        } else {\n            Logger.error(\"[MetaUI]\", `Plugin ${this.fieldKey} has no setValueState function!`, \"BasePlugin\");\n        }\n    }\n\n    /**\n     * Wraps standard validation and immediately applies the visual state.\n     * Ideal for 'change' events to instantly turn fields red on blur.\n     */\n    protected validateAndApplyVisualState(): import(\"../../interfaces/IPlugin\").IPluginValidationResult {\n        const result = this.validate();\n        this.setVisualValidationState(result.isValid, result.errorMessage);\n        return result;\n    }\n\n    /**\n     * Executes when the condition engine pushes new schema metadata to this field (e.g. readOnly changing).\n     * @param newMetadata The mutated schema metadata.\n     */\n    public onStateChange(newMetadata: IPropertyMetadata): void {\n        this.metadata = newMetadata;\n        this.applyState();\n    }\n\n    /**\n     * Abstract hook for the plugin to apply state changes to its specific UI5 control (e.g. placeholders, labels).\n     */\n    protected abstract applyState(): void;\n\n    /**\n     * Helper to apply common UI directives (like readOnly, visibleOn) directly to any control.\n     */\n    protected applyCommonDirectives(control: Control, metadata: IPropertyMetadata, modelName: string = \"meta\"): void {\n        const ctrl = control as unknown as { setEditable?: (b: boolean) => void, setEnabled?: (b: boolean) => void };\n        if (metadata.ui?.readOnly !== undefined && typeof ctrl.setEditable === \"function\") {\n            ctrl.setEditable(!metadata.ui.readOnly);\n        }\n\n        if (metadata.ui?.visibleOn) {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.visibleOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.visibleOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"visible\", { parts: [{ path: \"meta>/\" }], formatter: () => false });\n            control.bindProperty(\"visible\", expr);\n        }\n\n        if (metadata.ui?.enabledOn && typeof ctrl.setEnabled === \"function\") {\n            const ExpressionBuilder = sap.ui.require(\"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\")?.ExpressionBuilder;\n            let expr = \"\";\n            if (ExpressionBuilder) {\n                expr = ExpressionBuilder.build(metadata.ui.enabledOn, this.fieldKey, modelName);\n            } else {\n                expr = `{= ${metadata.ui.enabledOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n            }\n            control.bindProperty(\"enabled\", expr);\n        }\n    }\n\n\n\n    /**\n     * Natively destroys the instantiated UI5 control to prevent memory leaks.\n     * Can be overridden by subclasses if they manage secondary controls or custom models.\n     */\n    public destroy(): void {\n        if (this.control && typeof this.control.destroy === \"function\") {\n            this.control.destroy();\n            this.control = null;\n        }\n    }\n}\n"],"mappings":"qHAAA,MAQSA,EAAcC,EAAA,wBAEdC,EAAMC,EAAA,UASR,MAAeC,EAERC,QAA0B,KAG1BC,SAAqC,KAGrCC,SAAmB,GAGnBC,UAAoB,OAGpBC,WAAsB,KAGtBC,kBAA6B,MAShCC,YAAYC,GACfC,KAAKJ,WAAaG,CACtB,CAMOE,qBAAqBJ,GACxBG,KAAKH,kBAAoBA,CAC7B,CAkBUK,iBAAiBC,EAAmCC,GAC1D,IAAKD,EAAe,OAAOE,UAE3B,MAAMC,EAAWF,EAAYG,QAAQ,MAAO,IAAIA,QAAQ,MAAO,KAC/D,MAAO,GAAGJ,MAAkBG,GAChC,CAiBUE,oBAAoBJ,EAAqBT,EAAmBc,EAAwBC,GAC1F,MAAO,CACHC,KAAMP,EACNQ,MAAOjB,KACHc,EAAe,CAAEI,KAAMJ,GAAiB,CAAC,KACzCC,GAAqB,CAAC,EAElC,CAKOI,WACH,IAAKd,KAAKR,UAAYQ,KAAKP,SAAU,MAAO,CAAEsB,QAAS,MAGvD,UAAYf,KAAKR,QAAoBwB,aAAe,WAAY,CAC5D,IAAMhB,KAAKR,QAAoBwB,aAAc,CACzC,MAAO,CAAED,QAAS,KACtB,CACJ,CAEA,MAAME,EAA4B,GAClC,MAAMC,EAAmC,CACrCC,UAAanB,KAAKP,SAAS0B,WAG/B,GAAInB,KAAKP,SAAS2B,SAAU,CACxBH,EAAgBI,KAAK,WACzB,CACA,GAAIrB,KAAKP,SAAS0B,UAAWF,EAAgBI,KAAK,aAClD,GAAIrB,KAAKP,SAAS6B,UAAW,CACzBL,EAAgBI,KAAK,aACrBH,EAAQ,aAAelB,KAAKP,SAAS6B,SACzC,CACA,GAAItB,KAAKP,SAAS8B,QAAS,CACvBN,EAAgBI,KAAK,WACrBH,EAAQ,WAAalB,KAAKP,SAAS8B,OACvC,CACA,GAAIvB,KAAKP,SAAS+B,UAAYnB,WAAaL,KAAKP,SAASgC,UAAYpB,UAAW,CAC5EY,EAAgBI,KAAK,SACrBH,EAAQ,SAAW,CAAEQ,IAAK1B,KAAKP,SAAS+B,QAASG,IAAK3B,KAAKP,SAASgC,QACxE,CAEA,MAAMG,EAAS5B,KAAKP,SAASoC,IAAID,OACjC,GAAIA,IAAW,SAAWA,IAAW,OAASA,IAAW,OAAQ,CAC7DX,EAAgBI,KAAKO,EACzB,CAEA,GAAI5B,KAAKP,SAASoC,IAAIC,WAAY,CAC9B,IAAK,MAAMC,KAAK/B,KAAKP,SAASoC,GAAGC,WAAY,CACzC,UAAWC,IAAM,SAAU,CACvBd,EAAgBI,KAAKU,EACzB,MAAO,GAAIA,GAAKA,EAAEC,KAAM,CACpBf,EAAgBI,KAAKU,EAAEC,MACvB,GAAID,EAAEE,OAAS5B,UAAW,CACtBa,EAAQa,EAAEC,MAAQD,EAAEE,IACxB,CACJ,CACJ,CACJ,CAEA,GAAIhB,EAAgBiB,SAAW,EAAG,CAC9B,MAAO,CAAEnB,QAAS,KAAMoB,aAAc9B,UAAWX,SAAUM,KAAKN,SACpE,CAEA,MAAM0C,EAAMpC,KAAKqC,WACjB,MAAMC,EAASnD,EAAeoD,kBAAkBH,EAAKnB,EAAiBC,GACtE,MAAO,CAAEH,QAASuB,EAAOvB,QAASoB,aAAcG,EAAOH,aAAczC,SAAUM,KAAKN,SACxF,CAMO8C,yBAAyBzB,EAAkBoB,GAC9C,IAAKnC,KAAKR,QAAS,OAQnB,MAAMiD,EAAOzC,KAAKR,QAClB,UAAWiD,EAAKC,gBAAkB,WAAY,CAC1CD,EAAKC,cAAc3B,EAAU4B,EAAYC,WAAWC,KAAOF,EAAYC,WAAWE,OAElF,UAAWL,EAAKM,oBAAsB,WAAY,CAC9CN,EAAKM,kBAAkBhC,EAAU,GAAMoB,GAAgB,GAC3D,CACJ,KAAO,CACH9C,EAAO2D,MAAM,WAAY,UAAUhD,KAAKN,0CAA2C,aACvF,CACJ,CAMUuD,8BACN,MAAMX,EAAStC,KAAKc,WACpBd,KAAKwC,yBAAyBF,EAAOvB,QAASuB,EAAOH,cACrD,OAAOG,CACX,CAMOY,cAAcC,GACjBnD,KAAKP,SAAW0D,EAChBnD,KAAKoD,YACT,CAUUC,sBAAsB7D,EAAkBC,EAA6BE,EAAoB,QAC/F,MAAM8C,EAAOjD,EACb,GAAIC,EAASoC,IAAIyB,WAAajD,kBAAoBoC,EAAK3C,cAAgB,WAAY,CAC/E2C,EAAK3C,aAAaL,EAASoC,GAAGyB,SAClC,CAEA,GAAI7D,EAASoC,IAAI0B,UAAW,CACxB,MAAMC,EAAoBC,IAAI5B,GAAG6B,QAAQ,uDAAuDF,kBAChG,IAAIG,EAAO,GACX,GAAIH,EAAmB,CACnBG,EAAOH,EAAkBI,MAAMnE,EAASoC,GAAG0B,UAAWvD,KAAKN,SAAUC,EACzE,KAAO,CACHgE,EAAO,MAAMlE,EAASoC,GAAG0B,UAAUhD,QAAQ,YAAa,GAAGZ,OAAeY,QAAQ,MAAO,QAC7F,CACAf,EAAQqE,aAAa,UAAW,CAAEC,MAAO,CAAC,CAAEnD,KAAM,WAAaoD,UAAWA,IAAM,QAChFvE,EAAQqE,aAAa,UAAWF,EACpC,CAEA,GAAIlE,EAASoC,IAAImC,kBAAoBvB,EAAKwB,aAAe,WAAY,CACjE,MAAMT,EAAoBC,IAAI5B,GAAG6B,QAAQ,uDAAuDF,kBAChG,IAAIG,EAAO,GACX,GAAIH,EAAmB,CACnBG,EAAOH,EAAkBI,MAAMnE,EAASoC,GAAGmC,UAAWhE,KAAKN,SAAUC,EACzE,KAAO,CACHgE,EAAO,MAAMlE,EAASoC,GAAGmC,UAAUzD,QAAQ,YAAa,GAAGZ,OAAeY,QAAQ,MAAO,QAC7F,CACAf,EAAQqE,aAAa,UAAWF,EACpC,CACJ,CAQOO,UACH,GAAIlE,KAAKR,gBAAkBQ,KAAKR,QAAQ0E,UAAY,WAAY,CAC5DlE,KAAKR,QAAQ0E,UACblE,KAAKR,QAAU,IACnB,CACJ,EACH,IAAA2E,EAAA,CAAAC,WAAA,MAAAD,EAAA5E,aAAA,OAAA4E,CAAA","ignoreList":[]}

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

@@ -7,7 +7,7 @@ import { IPlugin } from "../../interfaces/IPlugin";
 import { IPropertyMetadata } from "../../interfaces/ISchema";
 import Control from "sap/ui/core/Control";
 import { GlobalPipeline } from "../../core/PipelineManager";
-import coreLibrary from "sap/ui/core/library";
+import * as coreLibrary from "sap/ui/core/library";
 import { Logger } from "../../utils/Logger";
 
 /**
@@ -93,7 +93,7 @@ export abstract class BasePlugin implements IPlugin {
      * @param additionalOptions Optional extra configurations (e.g. formatOptions, constraints).
      * @returns A configuration object ready to be assigned to 'value', 'text', 'state', etc.
      */
-    protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): { path: string, model: string, type?: unknown, [key: string]: unknown } {
+    protected generateBindingInfo(bindingPath: string, modelName: string, typeInstance?: unknown, additionalOptions?: Record<string, unknown>): any {
         return {
             path: bindingPath,
             model: modelName,