@siliconst/metaui 1.4.10 → 1.4.13

package/src/nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultLayoutGenerator-dbg.js","names":["DefaultLayoutGenerator","ensureLayout","schema","uiLayout","Array","isArray","length","type","props","items","properties","Object","keys","elements","generateElementsFromProperties","filter","e","label","title","basePath","key","prop","currentPath","push","ui","scope","error","__ui5_require_async","then","Logger","message","__exports","__esModule"],"sources":["DefaultLayoutGenerator.ts"],"sourcesContent":["/**\n * @file DefaultLayoutGenerator.ts\n * @description Automatically synthesizes a default UI layout for schemas that lack an explicit mapping.\n */\n\nimport { ISchema, ILayoutElement } from \"../interfaces/ISchema\";\n\n/**\n * Encapsulates the logic to dynamically build a safe, default layout orchestration\n * when the developer or backend fails to provide an explicit `uiLayout`.\n * \n * By elevating this into a dedicated utility, we avoid polluting layout engines\n * (like FormLayout or TableLayout) with structural inference responsibilities.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class DefaultLayoutGenerator {\n    /**\n     * Inspects a schema. If it has properties but no `uiLayout`, it synthesizes a default.\n     * @param schema The ISchema dictionary.\n     * @returns boolean True if a layout was synthesized, false if it already existed or was empty.\n     */\n    public static ensureLayout(schema: ISchema): boolean {\n        // If it already has a valid array, do nothing\n        if (schema.uiLayout && Array.isArray(schema.uiLayout) && schema.uiLayout.length > 0) {\n            return false;\n        }\n\n        const isArray = schema.type === \"array\";\n        const props = isArray ? schema.items?.properties : schema.properties;\n\n        if (!props || Object.keys(props).length === 0) {\n            return false; // Nothing to map\n        }\n\n        const elements = this.generateElementsFromProperties(props, \"#/properties\");\n\n        if (isArray) {\n            // Table layouts expect an array of flat Controls at the root uiLayout\n            // For tables, we flatten the deep elements or just render the root level\n            // To keep it safe, we'll just use the flat elements for tables\n            schema.uiLayout = elements.filter(e => e.type === \"Control\");\n        } else {\n            // Form layouts expect a grouped structure\n            schema.uiLayout = [\n                {\n                    type: \"Group\",\n                    label: schema.title,\n                    elements: elements\n                }\n            ];\n        }\n\n        return true;\n    }\n\n    /**\n     * Recursively traverses property metadata to synthesize generic Group and Control layout definitions.\n     * @param props The properties object from the schema.\n     * @param basePath The absolute JSON scope path to prefix bindings.\n     * @returns An array of generated layout element descriptors.\n     */\n    private static generateElementsFromProperties(props: Record<string, import(\"../interfaces/ISchema\").IPropertyMetadata>, basePath: string): ILayoutElement[] {\n        const elements: ILayoutElement[] = [];\n        for (const key of Object.keys(props)) {\n            try {\n                const prop = props[key];\n                const currentPath = `${basePath}/${key}`;\n\n                if (prop.type === \"object\" && prop.properties) {\n                    elements.push({\n                        type: \"Group\",\n                        label: prop.ui?.label || key,\n                        elements: this.generateElementsFromProperties(prop.properties, `${currentPath}/properties`)\n                    });\n                } else {\n                    elements.push({\n                        type: \"Control\",\n                        scope: currentPath\n                    });\n                }\n            } catch (error) {\n                // If a single synthesized property fails, swallow it to prevent the entire synthesized form from crashing.\n                import(\"../utils/Logger\").then(({ Logger }) => {\n                    Logger.error(`[MetaUI] DefaultLayoutGenerator failed to synthesize property '${key}'`, (error as Error).message);\n                });\n            }\n        }\n        return elements;\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;EAAA;AACA;AACA;AACA;;EAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMA,sBAAsB,CAAC;IAChC;AACJ;AACA;AACA;AACA;IACI,OAAcC,YAAYA,CAACC,MAAe,EAAW;MACjD;MACA,IAAIA,MAAM,CAACC,QAAQ,IAAIC,KAAK,CAACC,OAAO,CAACH,MAAM,CAACC,QAAQ,CAAC,IAAID,MAAM,CAACC,QAAQ,CAACG,MAAM,GAAG,CAAC,EAAE;QACjF,OAAO,KAAK;MAChB;MAEA,MAAMD,OAAO,GAAGH,MAAM,CAACK,IAAI,KAAK,OAAO;MACvC,MAAMC,KAAK,GAAGH,OAAO,GAAGH,MAAM,CAACO,KAAK,EAAEC,UAAU,GAAGR,MAAM,CAACQ,UAAU;MAEpE,IAAI,CAACF,KAAK,IAAIG,MAAM,CAACC,IAAI,CAACJ,KAAK,CAAC,CAACF,MAAM,KAAK,CAAC,EAAE;QAC3C,OAAO,KAAK,CAAC,CAAC;MAClB;MAEA,MAAMO,QAAQ,GAAG,IAAI,CAACC,8BAA8B,CAACN,KAAK,EAAE,cAAc,CAAC;MAE3E,IAAIH,OAAO,EAAE;QACT;QACA;QACA;QACAH,MAAM,CAACC,QAAQ,GAAGU,QAAQ,CAACE,MAAM,CAACC,CAAC,IAAIA,CAAC,CAACT,IAAI,KAAK,SAAS,CAAC;MAChE,CAAC,MAAM;QACH;QACAL,MAAM,CAACC,QAAQ,GAAG,CACd;UACII,IAAI,EAAE,OAAO;UACbU,KAAK,EAAEf,MAAM,CAACgB,KAAK;UACnBL,QAAQ,EAAEA;QACd,CAAC,CACJ;MACL;MAEA,OAAO,IAAI;IACf;;IAEA;AACJ;AACA;AACA;AACA;AACA;IACI,OAAeC,8BAA8BA,CAACN,KAAwE,EAAEW,QAAgB,EAAoB;MACxJ,MAAMN,QAA0B,GAAG,EAAE;MACrC,KAAK,MAAMO,GAAG,IAAIT,MAAM,CAACC,IAAI,CAACJ,KAAK,CAAC,EAAE;QAClC,IAAI;UACA,MAAMa,IAAI,GAAGb,KAAK,CAACY,GAAG,CAAC;UACvB,MAAME,WAAW,GAAG,GAAGH,QAAQ,IAAIC,GAAG,EAAE;UAExC,IAAIC,IAAI,CAACd,IAAI,KAAK,QAAQ,IAAIc,IAAI,CAACX,UAAU,EAAE;YAC3CG,QAAQ,CAACU,IAAI,CAAC;cACVhB,IAAI,EAAE,OAAO;cACbU,KAAK,EAAEI,IAAI,CAACG,EAAE,EAAEP,KAAK,IAAIG,GAAG;cAC5BP,QAAQ,EAAE,IAAI,CAACC,8BAA8B,CAACO,IAAI,CAACX,UAAU,EAAE,GAAGY,WAAW,aAAa;YAC9F,CAAC,CAAC;UACN,CAAC,MAAM;YACHT,QAAQ,CAACU,IAAI,CAAC;cACVhB,IAAI,EAAE,SAAS;cACfkB,KAAK,EAAEH;YACX,CAAC,CAAC;UACN;QACJ,CAAC,CAAC,OAAOI,KAAK,EAAE;UACZ;UACAC,mBAAA,CAAO,iBAAiB,CAAC,CAACC,IAAI,CAAC,CAAC;YAAEC;UAAO,CAAC,KAAK;YAC3CA,MAAM,CAACH,KAAK,CAAC,kEAAkEN,GAAG,GAAG,EAAGM,KAAK,CAAWI,OAAO,CAAC;UACpH,CAAC,CAAC;QACN;MACJ;MACA,OAAOjB,QAAQ;IACnB;EACJ;EAAC,IAAAkB,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAA/B,sBAAA,GAAAA,sBAAA;EAAA,OAAA+B,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"DefaultLayoutGenerator-dbg.js","names":["DefaultLayoutGenerator","ensureLayout","schema","uiLayout","Array","isArray","length","type","props","items","properties","Object","keys","elements","generateElementsFromProperties","filter","e","label","title","basePath","key","prop","currentPath","push","ui","scope","error","msg","message","__ui5_require_async","then","m","Logger","Error","__exports","__esModule"],"sources":["DefaultLayoutGenerator.ts"],"sourcesContent":["/**\n * @file DefaultLayoutGenerator.ts\n * @description Automatically synthesizes a default UI layout for schemas that lack an explicit mapping.\n */\n\nimport { ISchema, ILayoutElement } from \"../interfaces/ISchema\";\n\n/**\n * Encapsulates the logic to dynamically build a safe, default layout orchestration\n * when the developer or backend fails to provide an explicit `uiLayout`.\n * \n * By elevating this into a dedicated utility, we avoid polluting layout engines\n * (like FormLayout or TableLayout) with structural inference responsibilities.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class DefaultLayoutGenerator {\n    /**\n     * Inspects a schema. If it has properties but no `uiLayout`, it synthesizes a default.\n     * @param schema The ISchema dictionary.\n     * @returns boolean True if a layout was synthesized, false if it already existed or was empty.\n     */\n    public static ensureLayout(schema: ISchema): boolean {\n        // If it already has a valid array, do nothing\n        if (schema.uiLayout && Array.isArray(schema.uiLayout) && schema.uiLayout.length > 0) {\n            return false;\n        }\n\n        const isArray = schema.type === \"array\";\n        const props = isArray ? schema.items?.properties : schema.properties;\n\n        if (!props || Object.keys(props).length === 0) {\n            return false; // Nothing to map\n        }\n\n        const elements = this.generateElementsFromProperties(props, \"#/properties\");\n\n        if (isArray) {\n            // Table layouts expect an array of flat Controls at the root uiLayout\n            // For tables, we flatten the deep elements or just render the root level\n            // To keep it safe, we'll just use the flat elements for tables\n            schema.uiLayout = elements.filter(e => e.type === \"Control\");\n        } else {\n            // Form layouts expect a grouped structure\n            schema.uiLayout = [\n                {\n                    type: \"Group\",\n                    label: schema.title,\n                    elements: elements\n                }\n            ];\n        }\n\n        return true;\n    }\n\n    /**\n     * Recursively traverses property metadata to synthesize generic Group and Control layout definitions.\n     * @param props The properties object from the schema.\n     * @param basePath The absolute JSON scope path to prefix bindings.\n     * @returns An array of generated layout element descriptors.\n     */\n    private static generateElementsFromProperties(props: Record<string, import(\"../interfaces/ISchema\").IPropertyMetadata>, basePath: string): ILayoutElement[] {\n        const elements: ILayoutElement[] = [];\n        for (const key of Object.keys(props)) {\n            try {\n                const prop = props[key];\n                const currentPath = `${basePath}/${key}`;\n\n                if (prop.type === \"object\" && prop.properties) {\n                    elements.push({\n                        type: \"Group\",\n                        label: prop.ui?.label || key,\n                        elements: this.generateElementsFromProperties(prop.properties, `${currentPath}/properties`)\n                    });\n                } else {\n                    elements.push({\n                        type: \"Control\",\n                        scope: currentPath\n                    });\n                }\n            } catch (error) {\n                // Do not swallow errors. A failure to synthesize a property is a critical failure.\n                const msg = `[MetaUI] DefaultLayoutGenerator failed to synthesize property '${key}': ${(error as Error).message}`;\n                import(\"../utils/Logger\").then(m => m.Logger.error(msg));\n                throw new Error(msg);\n            }\n        }\n        return elements;\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;EAAA;AACA;AACA;AACA;;EAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMA,sBAAsB,CAAC;IAChC;AACJ;AACA;AACA;AACA;IACI,OAAcC,YAAYA,CAACC,MAAe,EAAW;MACjD;MACA,IAAIA,MAAM,CAACC,QAAQ,IAAIC,KAAK,CAACC,OAAO,CAACH,MAAM,CAACC,QAAQ,CAAC,IAAID,MAAM,CAACC,QAAQ,CAACG,MAAM,GAAG,CAAC,EAAE;QACjF,OAAO,KAAK;MAChB;MAEA,MAAMD,OAAO,GAAGH,MAAM,CAACK,IAAI,KAAK,OAAO;MACvC,MAAMC,KAAK,GAAGH,OAAO,GAAGH,MAAM,CAACO,KAAK,EAAEC,UAAU,GAAGR,MAAM,CAACQ,UAAU;MAEpE,IAAI,CAACF,KAAK,IAAIG,MAAM,CAACC,IAAI,CAACJ,KAAK,CAAC,CAACF,MAAM,KAAK,CAAC,EAAE;QAC3C,OAAO,KAAK,CAAC,CAAC;MAClB;MAEA,MAAMO,QAAQ,GAAG,IAAI,CAACC,8BAA8B,CAACN,KAAK,EAAE,cAAc,CAAC;MAE3E,IAAIH,OAAO,EAAE;QACT;QACA;QACA;QACAH,MAAM,CAACC,QAAQ,GAAGU,QAAQ,CAACE,MAAM,CAACC,CAAC,IAAIA,CAAC,CAACT,IAAI,KAAK,SAAS,CAAC;MAChE,CAAC,MAAM;QACH;QACAL,MAAM,CAACC,QAAQ,GAAG,CACd;UACII,IAAI,EAAE,OAAO;UACbU,KAAK,EAAEf,MAAM,CAACgB,KAAK;UACnBL,QAAQ,EAAEA;QACd,CAAC,CACJ;MACL;MAEA,OAAO,IAAI;IACf;;IAEA;AACJ;AACA;AACA;AACA;AACA;IACI,OAAeC,8BAA8BA,CAACN,KAAwE,EAAEW,QAAgB,EAAoB;MACxJ,MAAMN,QAA0B,GAAG,EAAE;MACrC,KAAK,MAAMO,GAAG,IAAIT,MAAM,CAACC,IAAI,CAACJ,KAAK,CAAC,EAAE;QAClC,IAAI;UACA,MAAMa,IAAI,GAAGb,KAAK,CAACY,GAAG,CAAC;UACvB,MAAME,WAAW,GAAG,GAAGH,QAAQ,IAAIC,GAAG,EAAE;UAExC,IAAIC,IAAI,CAACd,IAAI,KAAK,QAAQ,IAAIc,IAAI,CAACX,UAAU,EAAE;YAC3CG,QAAQ,CAACU,IAAI,CAAC;cACVhB,IAAI,EAAE,OAAO;cACbU,KAAK,EAAEI,IAAI,CAACG,EAAE,EAAEP,KAAK,IAAIG,GAAG;cAC5BP,QAAQ,EAAE,IAAI,CAACC,8BAA8B,CAACO,IAAI,CAACX,UAAU,EAAE,GAAGY,WAAW,aAAa;YAC9F,CAAC,CAAC;UACN,CAAC,MAAM;YACHT,QAAQ,CAACU,IAAI,CAAC;cACVhB,IAAI,EAAE,SAAS;cACfkB,KAAK,EAAEH;YACX,CAAC,CAAC;UACN;QACJ,CAAC,CAAC,OAAOI,KAAK,EAAE;UACZ;UACA,MAAMC,GAAG,GAAG,kEAAkEP,GAAG,MAAOM,KAAK,CAAWE,OAAO,EAAE;UACjHC,mBAAA,CAAO,iBAAiB,CAAC,CAACC,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACC,MAAM,CAACN,KAAK,CAACC,GAAG,CAAC,CAAC;UACxD,MAAM,IAAIM,KAAK,CAACN,GAAG,CAAC;QACxB;MACJ;MACA,OAAOd,QAAQ;IACnB;EACJ;EAAC,IAAAqB,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAlC,sBAAA,GAAAA,sBAAA;EAAA,OAAAkC,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator.js

@@ -1,2 +1,2 @@
-sap.ui.define([],function(){"use strict";function e(e){return new Promise(function(t,r){sap.ui.require([e],function(r){if(!(r&&r.__esModule)){r=r===null||!(typeof r==="object"&&e.endsWith("/library"))?{default:r}:r;Object.defineProperty(r,"__esModule",{value:true})}t(r)},function(e){r(e)})})}class t{static ensureLayout(e){if(e.uiLayout&&Array.isArray(e.uiLayout)&&e.uiLayout.length>0){return false}const t=e.type==="array";const r=t?e.items?.properties:e.properties;if(!r||Object.keys(r).length===0){return false}const o=this.generateElementsFromProperties(r,"#/properties");if(t){e.uiLayout=o.filter(e=>e.type==="Control")}else{e.uiLayout=[{type:"Group",label:e.title,elements:o}]}return true}static generateElementsFromProperties(t,r){const o=[];for(const s of Object.keys(t)){try{const e=t[s];const u=`${r}/${s}`;if(e.type==="object"&&e.properties){o.push({type:"Group",label:e.ui?.label||s,elements:this.generateElementsFromProperties(e.properties,`${u}/properties`)})}else{o.push({type:"Control",scope:u})}}catch(t){e("../utils/Logger").then(({Logger:e})=>{e.error(`[MetaUI] DefaultLayoutGenerator failed to synthesize property '${s}'`,t.message)})}}return o}}var r={__esModule:true};r.DefaultLayoutGenerator=t;return r});
+sap.ui.define([],function(){"use strict";function e(e){return new Promise(function(t,r){sap.ui.require([e],function(r){if(!(r&&r.__esModule)){r=r===null||!(typeof r==="object"&&e.endsWith("/library"))?{default:r}:r;Object.defineProperty(r,"__esModule",{value:true})}t(r)},function(e){r(e)})})}class t{static ensureLayout(e){if(e.uiLayout&&Array.isArray(e.uiLayout)&&e.uiLayout.length>0){return false}const t=e.type==="array";const r=t?e.items?.properties:e.properties;if(!r||Object.keys(r).length===0){return false}const o=this.generateElementsFromProperties(r,"#/properties");if(t){e.uiLayout=o.filter(e=>e.type==="Control")}else{e.uiLayout=[{type:"Group",label:e.title,elements:o}]}return true}static generateElementsFromProperties(t,r){const o=[];for(const s of Object.keys(t)){try{const e=t[s];const n=`${r}/${s}`;if(e.type==="object"&&e.properties){o.push({type:"Group",label:e.ui?.label||s,elements:this.generateElementsFromProperties(e.properties,`${n}/properties`)})}else{o.push({type:"Control",scope:n})}}catch(t){const r=`[MetaUI] DefaultLayoutGenerator failed to synthesize property '${s}': ${t.message}`;e("../utils/Logger").then(e=>e.Logger.error(r));throw new Error(r)}}return o}}var r={__esModule:true};r.DefaultLayoutGenerator=t;return r});
 //# sourceMappingURL=DefaultLayoutGenerator.js.map

package/src/nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultLayoutGenerator.js","names":["DefaultLayoutGenerator","ensureLayout","schema","uiLayout","Array","isArray","length","type","props","items","properties","Object","keys","elements","this","generateElementsFromProperties","filter","e","label","title","basePath","key","prop","currentPath","push","ui","scope","error","__ui5_require_async","then","Logger","message","__exports","__esModule"],"sources":["DefaultLayoutGenerator.ts"],"sourcesContent":["/**\n * @file DefaultLayoutGenerator.ts\n * @description Automatically synthesizes a default UI layout for schemas that lack an explicit mapping.\n */\n\nimport { ISchema, ILayoutElement } from \"../interfaces/ISchema\";\n\n/**\n * Encapsulates the logic to dynamically build a safe, default layout orchestration\n * when the developer or backend fails to provide an explicit `uiLayout`.\n * \n * By elevating this into a dedicated utility, we avoid polluting layout engines\n * (like FormLayout or TableLayout) with structural inference responsibilities.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class DefaultLayoutGenerator {\n    /**\n     * Inspects a schema. If it has properties but no `uiLayout`, it synthesizes a default.\n     * @param schema The ISchema dictionary.\n     * @returns boolean True if a layout was synthesized, false if it already existed or was empty.\n     */\n    public static ensureLayout(schema: ISchema): boolean {\n        // If it already has a valid array, do nothing\n        if (schema.uiLayout && Array.isArray(schema.uiLayout) && schema.uiLayout.length > 0) {\n            return false;\n        }\n\n        const isArray = schema.type === \"array\";\n        const props = isArray ? schema.items?.properties : schema.properties;\n\n        if (!props || Object.keys(props).length === 0) {\n            return false; // Nothing to map\n        }\n\n        const elements = this.generateElementsFromProperties(props, \"#/properties\");\n\n        if (isArray) {\n            // Table layouts expect an array of flat Controls at the root uiLayout\n            // For tables, we flatten the deep elements or just render the root level\n            // To keep it safe, we'll just use the flat elements for tables\n            schema.uiLayout = elements.filter(e => e.type === \"Control\");\n        } else {\n            // Form layouts expect a grouped structure\n            schema.uiLayout = [\n                {\n                    type: \"Group\",\n                    label: schema.title,\n                    elements: elements\n                }\n            ];\n        }\n\n        return true;\n    }\n\n    /**\n     * Recursively traverses property metadata to synthesize generic Group and Control layout definitions.\n     * @param props The properties object from the schema.\n     * @param basePath The absolute JSON scope path to prefix bindings.\n     * @returns An array of generated layout element descriptors.\n     */\n    private static generateElementsFromProperties(props: Record<string, import(\"../interfaces/ISchema\").IPropertyMetadata>, basePath: string): ILayoutElement[] {\n        const elements: ILayoutElement[] = [];\n        for (const key of Object.keys(props)) {\n            try {\n                const prop = props[key];\n                const currentPath = `${basePath}/${key}`;\n\n                if (prop.type === \"object\" && prop.properties) {\n                    elements.push({\n                        type: \"Group\",\n                        label: prop.ui?.label || key,\n                        elements: this.generateElementsFromProperties(prop.properties, `${currentPath}/properties`)\n                    });\n                } else {\n                    elements.push({\n                        type: \"Control\",\n                        scope: currentPath\n                    });\n                }\n            } catch (error) {\n                // If a single synthesized property fails, swallow it to prevent the entire synthesized form from crashing.\n                import(\"../utils/Logger\").then(({ Logger }) => {\n                    Logger.error(`[MetaUI] DefaultLayoutGenerator failed to synthesize property '${key}'`, (error as Error).message);\n                });\n            }\n        }\n        return elements;\n    }\n}\n"],"mappings":"qSAiBO,MAAMA,EAMT,mBAAcC,CAAaC,GAEvB,GAAIA,EAAOC,UAAYC,MAAMC,QAAQH,EAAOC,WAAaD,EAAOC,SAASG,OAAS,EAAG,CACjF,OAAO,KACX,CAEA,MAAMD,EAAUH,EAAOK,OAAS,QAChC,MAAMC,EAAQH,EAAUH,EAAOO,OAAOC,WAAaR,EAAOQ,WAE1D,IAAKF,GAASG,OAAOC,KAAKJ,GAAOF,SAAW,EAAG,CAC3C,OAAO,KACX,CAEA,MAAMO,EAAWC,KAAKC,+BAA+BP,EAAO,gBAE5D,GAAIH,EAAS,CAITH,EAAOC,SAAWU,EAASG,OAAOC,GAAKA,EAAEV,OAAS,UACtD,KAAO,CAEHL,EAAOC,SAAW,CACd,CACII,KAAM,QACNW,MAAOhB,EAAOiB,MACdN,SAAUA,GAGtB,CAEA,OAAO,IACX,CAQA,qCAAeE,CAA+BP,EAA0EY,GACpH,MAAMP,EAA6B,GACnC,IAAK,MAAMQ,KAAOV,OAAOC,KAAKJ,GAAQ,CAClC,IACI,MAAMc,EAAOd,EAAMa,GACnB,MAAME,EAAc,GAAGH,KAAYC,IAEnC,GAAIC,EAAKf,OAAS,UAAYe,EAAKZ,WAAY,CAC3CG,EAASW,KAAK,CACVjB,KAAM,QACNW,MAAOI,EAAKG,IAAIP,OAASG,EACzBR,SAAUC,KAAKC,+BAA+BO,EAAKZ,WAAY,GAAGa,iBAE1E,KAAO,CACHV,EAASW,KAAK,CACVjB,KAAM,UACNmB,MAAOH,GAEf,CACJ,CAAE,MAAOI,GAELC,EAAO,mBAAmBC,KAAK,EAAGC,aAC9BA,EAAOH,MAAM,kEAAkEN,KAASM,EAAgBI,UAEhH,CACJ,CACA,OAAOlB,CACX,EACH,IAAAmB,EAAA,CAAAC,WAAA,MAAAD,EAAAhC,yBAAA,OAAAgC,CAAA","ignoreList":[]}
+{"version":3,"file":"DefaultLayoutGenerator.js","names":["DefaultLayoutGenerator","ensureLayout","schema","uiLayout","Array","isArray","length","type","props","items","properties","Object","keys","elements","this","generateElementsFromProperties","filter","e","label","title","basePath","key","prop","currentPath","push","ui","scope","error","msg","message","__ui5_require_async","then","m","Logger","Error","__exports","__esModule"],"sources":["DefaultLayoutGenerator.ts"],"sourcesContent":["/**\n * @file DefaultLayoutGenerator.ts\n * @description Automatically synthesizes a default UI layout for schemas that lack an explicit mapping.\n */\n\nimport { ISchema, ILayoutElement } from \"../interfaces/ISchema\";\n\n/**\n * Encapsulates the logic to dynamically build a safe, default layout orchestration\n * when the developer or backend fails to provide an explicit `uiLayout`.\n * \n * By elevating this into a dedicated utility, we avoid polluting layout engines\n * (like FormLayout or TableLayout) with structural inference responsibilities.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class DefaultLayoutGenerator {\n    /**\n     * Inspects a schema. If it has properties but no `uiLayout`, it synthesizes a default.\n     * @param schema The ISchema dictionary.\n     * @returns boolean True if a layout was synthesized, false if it already existed or was empty.\n     */\n    public static ensureLayout(schema: ISchema): boolean {\n        // If it already has a valid array, do nothing\n        if (schema.uiLayout && Array.isArray(schema.uiLayout) && schema.uiLayout.length > 0) {\n            return false;\n        }\n\n        const isArray = schema.type === \"array\";\n        const props = isArray ? schema.items?.properties : schema.properties;\n\n        if (!props || Object.keys(props).length === 0) {\n            return false; // Nothing to map\n        }\n\n        const elements = this.generateElementsFromProperties(props, \"#/properties\");\n\n        if (isArray) {\n            // Table layouts expect an array of flat Controls at the root uiLayout\n            // For tables, we flatten the deep elements or just render the root level\n            // To keep it safe, we'll just use the flat elements for tables\n            schema.uiLayout = elements.filter(e => e.type === \"Control\");\n        } else {\n            // Form layouts expect a grouped structure\n            schema.uiLayout = [\n                {\n                    type: \"Group\",\n                    label: schema.title,\n                    elements: elements\n                }\n            ];\n        }\n\n        return true;\n    }\n\n    /**\n     * Recursively traverses property metadata to synthesize generic Group and Control layout definitions.\n     * @param props The properties object from the schema.\n     * @param basePath The absolute JSON scope path to prefix bindings.\n     * @returns An array of generated layout element descriptors.\n     */\n    private static generateElementsFromProperties(props: Record<string, import(\"../interfaces/ISchema\").IPropertyMetadata>, basePath: string): ILayoutElement[] {\n        const elements: ILayoutElement[] = [];\n        for (const key of Object.keys(props)) {\n            try {\n                const prop = props[key];\n                const currentPath = `${basePath}/${key}`;\n\n                if (prop.type === \"object\" && prop.properties) {\n                    elements.push({\n                        type: \"Group\",\n                        label: prop.ui?.label || key,\n                        elements: this.generateElementsFromProperties(prop.properties, `${currentPath}/properties`)\n                    });\n                } else {\n                    elements.push({\n                        type: \"Control\",\n                        scope: currentPath\n                    });\n                }\n            } catch (error) {\n                // Do not swallow errors. A failure to synthesize a property is a critical failure.\n                const msg = `[MetaUI] DefaultLayoutGenerator failed to synthesize property '${key}': ${(error as Error).message}`;\n                import(\"../utils/Logger\").then(m => m.Logger.error(msg));\n                throw new Error(msg);\n            }\n        }\n        return elements;\n    }\n}\n"],"mappings":"qSAiBO,MAAMA,EAMT,mBAAcC,CAAaC,GAEvB,GAAIA,EAAOC,UAAYC,MAAMC,QAAQH,EAAOC,WAAaD,EAAOC,SAASG,OAAS,EAAG,CACjF,OAAO,KACX,CAEA,MAAMD,EAAUH,EAAOK,OAAS,QAChC,MAAMC,EAAQH,EAAUH,EAAOO,OAAOC,WAAaR,EAAOQ,WAE1D,IAAKF,GAASG,OAAOC,KAAKJ,GAAOF,SAAW,EAAG,CAC3C,OAAO,KACX,CAEA,MAAMO,EAAWC,KAAKC,+BAA+BP,EAAO,gBAE5D,GAAIH,EAAS,CAITH,EAAOC,SAAWU,EAASG,OAAOC,GAAKA,EAAEV,OAAS,UACtD,KAAO,CAEHL,EAAOC,SAAW,CACd,CACII,KAAM,QACNW,MAAOhB,EAAOiB,MACdN,SAAUA,GAGtB,CAEA,OAAO,IACX,CAQA,qCAAeE,CAA+BP,EAA0EY,GACpH,MAAMP,EAA6B,GACnC,IAAK,MAAMQ,KAAOV,OAAOC,KAAKJ,GAAQ,CAClC,IACI,MAAMc,EAAOd,EAAMa,GACnB,MAAME,EAAc,GAAGH,KAAYC,IAEnC,GAAIC,EAAKf,OAAS,UAAYe,EAAKZ,WAAY,CAC3CG,EAASW,KAAK,CACVjB,KAAM,QACNW,MAAOI,EAAKG,IAAIP,OAASG,EACzBR,SAAUC,KAAKC,+BAA+BO,EAAKZ,WAAY,GAAGa,iBAE1E,KAAO,CACHV,EAASW,KAAK,CACVjB,KAAM,UACNmB,MAAOH,GAEf,CACJ,CAAE,MAAOI,GAEL,MAAMC,EAAM,kEAAkEP,OAAUM,EAAgBE,UACxGC,EAAO,mBAAmBC,KAAKC,GAAKA,EAAEC,OAAON,MAAMC,IACnD,MAAM,IAAIM,MAAMN,EACpB,CACJ,CACA,OAAOf,CACX,EACH,IAAAsB,EAAA,CAAAC,WAAA,MAAAD,EAAAnC,yBAAA,OAAAmC,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator.ts

@@ -81,10 +81,10 @@ export class DefaultLayoutGenerator {
                     });
                 }
             } catch (error) {
-                // If a single synthesized property fails, swallow it to prevent the entire synthesized form from crashing.
-                import("../utils/Logger").then(({ Logger }) => {
-                    Logger.error(`[MetaUI] DefaultLayoutGenerator failed to synthesize property '${key}'`, (error as Error).message);
-                });
+                // Do not swallow errors. A failure to synthesize a property is a critical failure.
+                const msg = `[MetaUI] DefaultLayoutGenerator failed to synthesize property '${key}': ${(error as Error).message}`;
+                import("../utils/Logger").then(m => m.Logger.error(msg));
+                throw new Error(msg);
             }
         }
         return elements;

package/src/nz/co/siliconst/ui5/metaui/core/Engine-dbg.js

@@ -33,12 +33,20 @@ sap.ui.define(["./ConditionEngine", "./PluginRegistry", "sap/m/Text", "../utils/
     /** Tracks whether the entire engine is running in Editable mode. */
     isEditable = true;
 
+    /** Tracks if any fields or sub-layouts failed to render, requiring a warning strip. */
+    hasPartialRenderingErrors = false;
+
+    /** Tracks whether the engine should delegate visual state to the global MessageManager. */
+    useMessageManager = false;
+
     /**
      * Initializes a new Engine instance.
      * @param editable Whether the engine should render form fields as editable or read-only.
+     * @param useMessageManager Whether to delegate visual state to UI5 MessageManager.
      */
-    constructor(editable = true) {
+    constructor(editable = true, useMessageManager = false) {
       this.isEditable = editable;
+      this.useMessageManager = useMessageManager;
     }
 
     /**
@@ -74,6 +82,7 @@ sap.ui.define(["./ConditionEngine", "./PluginRegistry", "sap/m/Text", "../utils/
         const layoutManager = PluginRegistry.getInstance().getLayout(layoutStrategy);
         return layoutManager.render(schema, modelName, this, onSubmit);
       } catch (error) {
+        this.hasPartialRenderingErrors = true;
         const msg = error.message;
         Logger.error("[MetaUI Engine] Critical error during layout generation", msg);
         Logger.showErrorPopup(`Engine failed to generate the layout.\n\nDetails: ${msg}`);
@@ -96,6 +105,9 @@ sap.ui.define(["./ConditionEngine", "./PluginRegistry", "sap/m/Text", "../utils/
       try {
         const plugin = PluginRegistry.getInstance().getPlugin(fieldMeta.type || "string", fieldMeta.ui?.widget);
         plugin.setEditable(this.isEditable);
+        if (typeof plugin.setUseMessageManager === "function") {
+          plugin.setUseMessageManager(this.useMessageManager);
+        }
         if (!isTemplate) {
           this.activePlugins.push({
             plugin,
@@ -109,6 +121,7 @@ sap.ui.define(["./ConditionEngine", "./PluginRegistry", "sap/m/Text", "../utils/
         }
         return control;
       } catch (error) {
+        this.hasPartialRenderingErrors = true;
         const msg = error.message;
         Logger.error(`[MetaUI Engine] Failed to generate field at ${bindingPath}`, msg);
         Logger.showErrorPopup(`Failed to generate field '${bindingPath}'.\n\nDetails: ${msg}`);
@@ -133,6 +146,7 @@ sap.ui.define(["./ConditionEngine", "./PluginRegistry", "sap/m/Text", "../utils/
         const layoutManager = PluginRegistry.getInstance().getLayout(layoutStrategy);
         return layoutManager.render(schema, modelName, this, undefined, bindingPath);
       } catch (error) {
+        this.hasPartialRenderingErrors = true;
         const msg = error.message;
         Logger.error(`[MetaUI Engine] Critical error generating sub-layout for ${bindingPath}`, msg);
         Logger.showErrorPopup(`Engine failed to generate a sub-layout.\n\nDetails: ${msg}`);
@@ -145,13 +159,17 @@ sap.ui.define(["./ConditionEngine", "./PluginRegistry", "sap/m/Text", "../utils/
     /**
      * Iterates through all active plugins and triggers their internal validation pipelines.
      * 
+     * @param applyVisualState If true, explicitly instructs the plugin to natively paint its own ValueState.
      * @returns {IPluginValidationResult[]} Array of validation error objects. Empty array if valid.
      */
-    validateAll() {
+    validateAll(applyVisualState = false) {
       const errors = [];
       for (const item of this.activePlugins) {
         try {
           const result = item.plugin.validate();
+          if (applyVisualState && typeof item.plugin.setVisualValidationState === "function") {
+            item.plugin.setVisualValidationState(result.isValid, result.errorMessage);
+          }
           if (!result.isValid) {
             // Ensure the path is bound to the error so GeneratorHost knows where to target it
             result.fieldKey = result.fieldKey || item.path.replace(/^\//, "");
@@ -160,18 +178,25 @@ sap.ui.define(["./ConditionEngine", "./PluginRegistry", "sap/m/Text", "../utils/
             Logger.error("[MetaUI Validation] Plugin failed validation silently:", item.path || item.plugin.constructor.name);
           }
         } catch (error) {
-          const msg = error.message;
-          Logger.error(`[MetaUI Validation] Exception during plugin validation at path ${item.path}`, msg);
-          errors.push({
-            isValid: false,
-            errorMessage: `Validation crashed: ${msg}`,
-            fieldKey: item.path.replace(/^\//, "")
-          });
+          Logger.error(`[MetaUI Engine] Error validating plugin at ${item.path}`, error.message);
         }
       }
       return errors;
     }
 
+    /**
+     * Retrieves an active plugin instance by its absolute binding path.
+     * Useful for programmatic field manipulation (e.g., custom error injection).
+     * 
+     * @param path The binding path (e.g. "/General/CustomerName").
+     * @returns {IPlugin | undefined} The plugin instance, or undefined if not found.
+     */
+    getPluginByPath(path) {
+      const cleanPath = path.startsWith("/") ? path : `/${path}`;
+      const match = this.activePlugins.find(p => p.path === cleanPath || p.path === `/${cleanPath}`);
+      return match ? match.plugin : undefined;
+    }
+
     /**
      * Cleans up internal state and destroys the condition engine to prevent memory leaks.
      */

package/src/nz/co/siliconst/ui5/metaui/core/Engine-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"Engine-dbg.js","names":["ConditionEngine","___ConditionEngine","PluginRegistry","___PluginRegistry","Logger","___utils_Logger","DefaultLayoutGenerator","___DefaultLayoutGenerator","Engine","conditionEngine","activePlugins","isEditable","constructor","editable","build","schema","model","modelName","onSubmit","engineScopeId","onChange","activeModel","isValid","fieldKey","errorMessage","controlId","handleEvent","ensureLayout","warn","layoutStrategy","type","layoutManager","getInstance","getLayout","render","error","msg","message","showErrorPopup","Text","text","generateField","fieldMeta","bindingPath","isTemplate","plugin","getPlugin","ui","widget","setEditable","push","path","scopeId","undefined","control","registerPlugin","generateLayout","validateAll","errors","item","result","validate","replace","name","destroy","messageManager","Messaging","existingMessages","getMessageModel","getData","messagesToRemove","targetPath","matched","filter","getTarget","getMessageProcessor","getId","length","removeMessages","__exports","__esModule"],"sources":["Engine.ts"],"sourcesContent":["/**\n * @file Engine.ts\n * @description The central orchestrator that routes data between the Layout Factory and Plugin Registry (v2).\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { IPlugin, IPluginValidationResult } from \"../interfaces/IPlugin\";\nimport { ConditionEngine } from \"./ConditionEngine\";\nimport { PluginRegistry } from \"./PluginRegistry\";\nimport Control from \"sap/ui/core/Control\";\nimport VBox from \"sap/m/VBox\";\nimport Text from \"sap/m/Text\";\nimport { Logger } from \"../utils/Logger\";\nimport { DefaultLayoutGenerator } from \"./DefaultLayoutGenerator\";\nimport Core from \"sap/ui/core/Core\";\nimport Messaging from \"sap/ui/core/Messaging\";\n\n/**\n * The Engine is responsible for translating a normalized schema into a physical UI5 layout.\n * It delegates layout generation to the configured `LayoutManager` and field generation to the `PluginRegistry`.\n * It strictly routes execution flow and tracks active plugins for validation.\n * It embodies the \"Plugin-First Philosophy\" by routing all complex field and layout rendering\n * through discrete, decoupled plugins rather than handling native overrides.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class Engine {\n    /** Handles dynamic conditional logic across the active form. */\n    private conditionEngine: ConditionEngine | null = null;\n\n    /** Array of all instantiated plugins generated during the current build. */\n    private activePlugins: { plugin: IPlugin, path: string }[] = [];\n\n    /** Deterministic scope ID injected by the host control to prevent clone collisions. */\n    public engineScopeId?: string;\n\n    private activeModel?: sap.ui.model.Model;\n\n    /** Callback to notify the host that an internal field changed. */\n    public onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;\n\n    /** Tracks whether the entire engine is running in Editable mode. */\n    public readonly isEditable: boolean = true;\n\n    /**\n     * Initializes a new Engine instance.\n     * @param editable Whether the engine should render form fields as editable or read-only.\n     */\n    constructor(editable: boolean = true) {\n        this.isEditable = editable;\n    }\n\n    /**\n     * Bootstraps the layout generation process by resolving the correct layout strategy.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param model The active StateManager JSONModel instance.\n     * @param modelName The UI5 model alias used for isolation.\n     * @param onSubmit Callback fired when form is submitted.\n     * @param engineScopeId Deterministic scope ID for this engine instance.\n     * @param onChange Callback fired when field values change.\n     * @returns The generated root UI5 Control container.\n     */\n    public build(schema: ISchema, model: sap.ui.model.Model, modelName: string = \"meta\", onSubmit?: () => void, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control {\n        this.conditionEngine = new ConditionEngine(schema);\n        this.activePlugins = [];\n        this.activeModel = model;\n        this.engineScopeId = engineScopeId;\n        this.onChange = (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => {\n            if (this.conditionEngine && fieldKey) {\n                this.conditionEngine.handleEvent(fieldKey, isValid);\n            }\n            if (onChange) {\n                onChange(isValid, fieldKey, errorMessage, controlId);\n            }\n        };\n\n        try {\n            // Intercept and synthesize a default layout if the developer/backend failed to provide one\n            if (DefaultLayoutGenerator.ensureLayout(schema)) {\n                Logger.warn(\"[MetaUI Engine] Missing 'uiLayout' array in schema. Synthesized a default layout mapping to prevent a blank render.\");\n            }\n\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = PluginRegistry.getInstance().getLayout(layoutStrategy);\n\n            return layoutManager.render(schema, modelName, this, onSubmit);\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(\"[MetaUI Engine] Critical error during layout generation\", msg);\n            Logger.showErrorPopup(`Engine failed to generate the layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Layout Error\" });\n        }\n    }\n\n    /**\n     * Instantiates the correct plugin for a specific field based on type and widget hints,\n     * and tracks the plugin for global validation.\n     * \n     * @param fieldMeta The metadata schema specific to the field.\n     * @param bindingPath The JSON path representing the field within the payload.\n     * @param modelName The UI5 JSONModel name used for data binding.\n     * @returns The generated UI5 Control for the field.\n     */\n    public generateField(fieldMeta: IPropertyMetadata, bindingPath: string, modelName: string, isTemplate: boolean = false): Control {\n        try {\n            const plugin = PluginRegistry.getInstance().getPlugin(fieldMeta.type || \"string\", fieldMeta.ui?.widget);\n            plugin.setEditable(this.isEditable);\n\n            if (!isTemplate) {\n                this.activePlugins.push({ plugin, path: bindingPath });\n            }\n            const scopeId = isTemplate ? undefined : this.engineScopeId;\n            const control = plugin.render(fieldMeta, bindingPath, modelName, scopeId, this.onChange);\n\n            if (this.conditionEngine) {\n                this.conditionEngine.registerPlugin(bindingPath, plugin);\n            }\n\n            return control;\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Failed to generate field at ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Failed to generate field '${bindingPath}'.\\n\\nDetails: ${msg}`);\n            return new Text({ text: `[Error generating field ${bindingPath}]` });\n        }\n    }\n\n    /**\n     * Generates a sub-layout (like an embedded table or nested form) without \n     * destroying the current Engine state or Condition tracking.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param modelName The UI5 JSONModel name used for data binding (defaults to \"meta\").\n     * @param bindingPath Optional path to bind the sub-layout to a specific array/object property.\n     * @returns The generated root UI5 Control container.\n     */\n    public generateLayout(schema: ISchema, modelName: string, bindingPath?: string): Control {\n        try {\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = PluginRegistry.getInstance().getLayout(layoutStrategy);\n            return layoutManager.render(schema, modelName, this, undefined, bindingPath);\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Critical error generating sub-layout for ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Engine failed to generate a sub-layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Sub-Layout Error\" });\n        }\n    }\n\n    /**\n     * Iterates through all active plugins and triggers their internal validation pipelines.\n     * \n     * @returns {IPluginValidationResult[]} Array of validation error objects. Empty array if valid.\n     */\n    public validateAll(): IPluginValidationResult[] {\n        const errors: IPluginValidationResult[] = [];\n        for (const item of this.activePlugins) {\n            try {\n                const result = item.plugin.validate();\n                if (!result.isValid) {\n                    // Ensure the path is bound to the error so GeneratorHost knows where to target it\n                    result.fieldKey = result.fieldKey || item.path.replace(/^\\//, \"\");\n                    errors.push(result);\n                    // Add console log to find which plugin fails silently\n                    Logger.error(\"[MetaUI Validation] Plugin failed validation silently:\", item.path || item.plugin.constructor.name);\n                }\n            } catch (error) {\n                const msg = (error as Error).message;\n                Logger.error(`[MetaUI Validation] Exception during plugin validation at path ${item.path}`, msg);\n                errors.push({ isValid: false, errorMessage: `Validation crashed: ${msg}`, fieldKey: item.path.replace(/^\\//, \"\") });\n            }\n        }\n        return errors;\n    }\n\n    /**\n     * Cleans up internal state and destroys the condition engine to prevent memory leaks.\n     */\n    public destroy(): void {\n        if (this.conditionEngine) {\n            this.conditionEngine.destroy();\n            this.conditionEngine = null;\n        }\n\n        // ------------------------------------------------------------------------\n        // Ghost Error Prevention\n        // Flush MessageManager for active plugins before destroying their controls\n        // ------------------------------------------------------------------------\n        const messageManager = Messaging;\n        const existingMessages = messageManager.getMessageModel().getData();\n        const messagesToRemove: sap.ui.core.message.Message[] = [];\n\n        for (const item of this.activePlugins) {\n            if (this.activeModel) {\n                const targetPath = `/${item.path.replace(/^\\//, \"\")}`;\n                const matched = existingMessages.filter((msg: sap.ui.core.message.Message) =>\n                    msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.activeModel.getId()\n                );\n                messagesToRemove.push(...matched);\n            }\n            if (typeof item.plugin.destroy === \"function\") {\n                item.plugin.destroy();\n            }\n        }\n\n        if (messagesToRemove.length > 0) {\n            messageManager.removeMessages(messagesToRemove);\n        }\n\n        this.activePlugins = [];\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;EAHA,MAQSA,eAAe,GAAAC,kBAAA;EAAA,MACfC,cAAc,GAAAC,iBAAA;EAAA,MAIdC,MAAM,GAAAC,eAAA;EAAA,MACNC,sBAAsB,GAAAC,yBAAA;EAI/B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMC,MAAM,CAAC;IAChB;IACQC,eAAe,GAA2B,IAAI;;IAEtD;IACQC,aAAa,GAAwC,EAAE;;IAE/D;;IAKA;;IAGA;IACgBC,UAAU,GAAY,IAAI;;IAE1C;AACJ;AACA;AACA;IACIC,WAAWA,CAACC,QAAiB,GAAG,IAAI,EAAE;MAClC,IAAI,CAACF,UAAU,GAAGE,QAAQ;IAC9B;;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACWC,KAAKA,CAACC,MAAe,EAAEC,KAAyB,EAAEC,SAAiB,GAAG,MAAM,EAAEC,QAAqB,EAAEC,aAAsB,EAAEC,QAAmG,EAAW;MAC9O,IAAI,CAACX,eAAe,GAAG,IAAIT,eAAe,CAACe,MAAM,CAAC;MAClD,IAAI,CAACL,aAAa,GAAG,EAAE;MACvB,IAAI,CAACW,WAAW,GAAGL,KAAK;MACxB,IAAI,CAACG,aAAa,GAAGA,aAAa;MAClC,IAAI,CAACC,QAAQ,GAAG,CAACE,OAAgB,EAAEC,QAAiB,EAAEC,YAAqB,EAAEC,SAAkB,KAAK;QAChG,IAAI,IAAI,CAAChB,eAAe,IAAIc,QAAQ,EAAE;UAClC,IAAI,CAACd,eAAe,CAACiB,WAAW,CAACH,QAAQ,EAAED,OAAO,CAAC;QACvD;QACA,IAAIF,QAAQ,EAAE;UACVA,QAAQ,CAACE,OAAO,EAAEC,QAAQ,EAAEC,YAAY,EAAEC,SAAS,CAAC;QACxD;MACJ,CAAC;MAED,IAAI;QACA;QACA,IAAInB,sBAAsB,CAACqB,YAAY,CAACZ,MAAM,CAAC,EAAE;UAC7CX,MAAM,CAACwB,IAAI,CAAC,qHAAqH,CAAC;QACtI;QAEA,MAAMC,cAAc,GAAGd,MAAM,CAACc,cAAc,KAAKd,MAAM,CAACe,IAAI,KAAK,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;QAC5F,MAAMC,aAAa,GAAG7B,cAAc,CAAC8B,WAAW,CAAC,CAAC,CAACC,SAAS,CAACJ,cAAc,CAAC;QAE5E,OAAOE,aAAa,CAACG,MAAM,CAACnB,MAAM,EAAEE,SAAS,EAAE,IAAI,EAAEC,QAAQ,CAAC;MAClE,CAAC,CAAC,OAAOiB,KAAK,EAAE;QACZ,MAAMC,GAAG,GAAID,KAAK,CAAWE,OAAO;QACpCjC,MAAM,CAAC+B,KAAK,CAAC,yDAAyD,EAAEC,GAAG,CAAC;QAC5EhC,MAAM,CAACkC,cAAc,CAAC,qDAAqDF,GAAG,EAAE,CAAC;QACjF,OAAO,IAAIG,IAAI,CAAC;UAAEC,IAAI,EAAE;QAAwB,CAAC,CAAC;MACtD;IACJ;;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACWC,aAAaA,CAACC,SAA4B,EAAEC,WAAmB,EAAE1B,SAAiB,EAAE2B,UAAmB,GAAG,KAAK,EAAW;MAC7H,IAAI;QACA,MAAMC,MAAM,GAAG3C,cAAc,CAAC8B,WAAW,CAAC,CAAC,CAACc,SAAS,CAACJ,SAAS,CAACZ,IAAI,IAAI,QAAQ,EAAEY,SAAS,CAACK,EAAE,EAAEC,MAAM,CAAC;QACvGH,MAAM,CAACI,WAAW,CAAC,IAAI,CAACtC,UAAU,CAAC;QAEnC,IAAI,CAACiC,UAAU,EAAE;UACb,IAAI,CAAClC,aAAa,CAACwC,IAAI,CAAC;YAAEL,MAAM;YAAEM,IAAI,EAAER;UAAY,CAAC,CAAC;QAC1D;QACA,MAAMS,OAAO,GAAGR,UAAU,GAAGS,SAAS,GAAG,IAAI,CAAClC,aAAa;QAC3D,MAAMmC,OAAO,GAAGT,MAAM,CAACX,MAAM,CAACQ,SAAS,EAAEC,WAAW,EAAE1B,SAAS,EAAEmC,OAAO,EAAE,IAAI,CAAChC,QAAQ,CAAC;QAExF,IAAI,IAAI,CAACX,eAAe,EAAE;UACtB,IAAI,CAACA,eAAe,CAAC8C,cAAc,CAACZ,WAAW,EAAEE,MAAM,CAAC;QAC5D;QAEA,OAAOS,OAAO;MAClB,CAAC,CAAC,OAAOnB,KAAK,EAAE;QACZ,MAAMC,GAAG,GAAID,KAAK,CAAWE,OAAO;QACpCjC,MAAM,CAAC+B,KAAK,CAAC,+CAA+CQ,WAAW,EAAE,EAAEP,GAAG,CAAC;QAC/EhC,MAAM,CAACkC,cAAc,CAAC,6BAA6BK,WAAW,kBAAkBP,GAAG,EAAE,CAAC;QACtF,OAAO,IAAIG,IAAI,CAAC;UAAEC,IAAI,EAAE,2BAA2BG,WAAW;QAAI,CAAC,CAAC;MACxE;IACJ;;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACWa,cAAcA,CAACzC,MAAe,EAAEE,SAAiB,EAAE0B,WAAoB,EAAW;MACrF,IAAI;QACA,MAAMd,cAAc,GAAGd,MAAM,CAACc,cAAc,KAAKd,MAAM,CAACe,IAAI,KAAK,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;QAC5F,MAAMC,aAAa,GAAG7B,cAAc,CAAC8B,WAAW,CAAC,CAAC,CAACC,SAAS,CAACJ,cAAc,CAAC;QAC5E,OAAOE,aAAa,CAACG,MAAM,CAACnB,MAAM,EAAEE,SAAS,EAAE,IAAI,EAAEoC,SAAS,EAAEV,WAAW,CAAC;MAChF,CAAC,CAAC,OAAOR,KAAK,EAAE;QACZ,MAAMC,GAAG,GAAID,KAAK,CAAWE,OAAO;QACpCjC,MAAM,CAAC+B,KAAK,CAAC,4DAA4DQ,WAAW,EAAE,EAAEP,GAAG,CAAC;QAC5FhC,MAAM,CAACkC,cAAc,CAAC,uDAAuDF,GAAG,EAAE,CAAC;QACnF,OAAO,IAAIG,IAAI,CAAC;UAAEC,IAAI,EAAE;QAA4B,CAAC,CAAC;MAC1D;IACJ;;IAEA;AACJ;AACA;AACA;AACA;IACWiB,WAAWA,CAAA,EAA8B;MAC5C,MAAMC,MAAiC,GAAG,EAAE;MAC5C,KAAK,MAAMC,IAAI,IAAI,IAAI,CAACjD,aAAa,EAAE;QACnC,IAAI;UACA,MAAMkD,MAAM,GAAGD,IAAI,CAACd,MAAM,CAACgB,QAAQ,CAAC,CAAC;UACrC,IAAI,CAACD,MAAM,CAACtC,OAAO,EAAE;YACjB;YACAsC,MAAM,CAACrC,QAAQ,GAAGqC,MAAM,CAACrC,QAAQ,IAAIoC,IAAI,CAACR,IAAI,CAACW,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YACjEJ,MAAM,CAACR,IAAI,CAACU,MAAM,CAAC;YACnB;YACAxD,MAAM,CAAC+B,KAAK,CAAC,wDAAwD,EAAEwB,IAAI,CAACR,IAAI,IAAIQ,IAAI,CAACd,MAAM,CAACjC,WAAW,CAACmD,IAAI,CAAC;UACrH;QACJ,CAAC,CAAC,OAAO5B,KAAK,EAAE;UACZ,MAAMC,GAAG,GAAID,KAAK,CAAWE,OAAO;UACpCjC,MAAM,CAAC+B,KAAK,CAAC,kEAAkEwB,IAAI,CAACR,IAAI,EAAE,EAAEf,GAAG,CAAC;UAChGsB,MAAM,CAACR,IAAI,CAAC;YAAE5B,OAAO,EAAE,KAAK;YAAEE,YAAY,EAAE,uBAAuBY,GAAG,EAAE;YAAEb,QAAQ,EAAEoC,IAAI,CAACR,IAAI,CAACW,OAAO,CAAC,KAAK,EAAE,EAAE;UAAE,CAAC,CAAC;QACvH;MACJ;MACA,OAAOJ,MAAM;IACjB;;IAEA;AACJ;AACA;IACWM,OAAOA,CAAA,EAAS;MACnB,IAAI,IAAI,CAACvD,eAAe,EAAE;QACtB,IAAI,CAACA,eAAe,CAACuD,OAAO,CAAC,CAAC;QAC9B,IAAI,CAACvD,eAAe,GAAG,IAAI;MAC/B;;MAEA;MACA;MACA;MACA;MACA,MAAMwD,cAAc,GAAGC,SAAS;MAChC,MAAMC,gBAAgB,GAAGF,cAAc,CAACG,eAAe,CAAC,CAAC,CAACC,OAAO,CAAC,CAAC;MACnE,MAAMC,gBAA+C,GAAG,EAAE;MAE1D,KAAK,MAAMX,IAAI,IAAI,IAAI,CAACjD,aAAa,EAAE;QACnC,IAAI,IAAI,CAACW,WAAW,EAAE;UAClB,MAAMkD,UAAU,GAAG,IAAIZ,IAAI,CAACR,IAAI,CAACW,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE;UACrD,MAAMU,OAAO,GAAGL,gBAAgB,CAACM,MAAM,CAAErC,GAAgC,IACrEA,GAAG,CAACsC,SAAS,CAAC,CAAC,KAAKH,UAAU,IAAInC,GAAG,CAACuC,mBAAmB,CAAC,CAAC,IAAIvC,GAAG,CAACuC,mBAAmB,CAAC,CAAC,CAACC,KAAK,CAAC,CAAC,KAAK,IAAI,CAACvD,WAAW,CAACuD,KAAK,CAAC,CAChI,CAAC;UACDN,gBAAgB,CAACpB,IAAI,CAAC,GAAGsB,OAAO,CAAC;QACrC;QACA,IAAI,OAAOb,IAAI,CAACd,MAAM,CAACmB,OAAO,KAAK,UAAU,EAAE;UAC3CL,IAAI,CAACd,MAAM,CAACmB,OAAO,CAAC,CAAC;QACzB;MACJ;MAEA,IAAIM,gBAAgB,CAACO,MAAM,GAAG,CAAC,EAAE;QAC7BZ,cAAc,CAACa,cAAc,CAACR,gBAAgB,CAAC;MACnD;MAEA,IAAI,CAAC5D,aAAa,GAAG,EAAE;IAC3B;EACJ;EAAC,IAAAqE,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAvE,MAAA,GAAAA,MAAA;EAAA,OAAAuE,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"Engine-dbg.js","names":["ConditionEngine","___ConditionEngine","PluginRegistry","___PluginRegistry","Logger","___utils_Logger","DefaultLayoutGenerator","___DefaultLayoutGenerator","Engine","conditionEngine","activePlugins","isEditable","hasPartialRenderingErrors","useMessageManager","constructor","editable","build","schema","model","modelName","onSubmit","engineScopeId","onChange","activeModel","isValid","fieldKey","errorMessage","controlId","handleEvent","ensureLayout","warn","layoutStrategy","type","layoutManager","getInstance","getLayout","render","error","msg","message","showErrorPopup","Text","text","generateField","fieldMeta","bindingPath","isTemplate","plugin","getPlugin","ui","widget","setEditable","setUseMessageManager","push","path","scopeId","undefined","control","registerPlugin","generateLayout","validateAll","applyVisualState","errors","item","result","validate","setVisualValidationState","replace","name","getPluginByPath","cleanPath","startsWith","match","find","p","destroy","messageManager","Messaging","existingMessages","getMessageModel","getData","messagesToRemove","targetPath","matched","filter","getTarget","getMessageProcessor","getId","length","removeMessages","__exports","__esModule"],"sources":["Engine.ts"],"sourcesContent":["/**\n * @file Engine.ts\n * @description The central orchestrator that routes data between the Layout Factory and Plugin Registry (v2).\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { IPlugin, IPluginValidationResult } from \"../interfaces/IPlugin\";\nimport { ConditionEngine } from \"./ConditionEngine\";\nimport { PluginRegistry } from \"./PluginRegistry\";\nimport Control from \"sap/ui/core/Control\";\nimport VBox from \"sap/m/VBox\";\nimport Text from \"sap/m/Text\";\nimport { Logger } from \"../utils/Logger\";\nimport { DefaultLayoutGenerator } from \"./DefaultLayoutGenerator\";\nimport Core from \"sap/ui/core/Core\";\nimport Messaging from \"sap/ui/core/Messaging\";\n\n/**\n * The Engine is responsible for translating a normalized schema into a physical UI5 layout.\n * It delegates layout generation to the configured `LayoutManager` and field generation to the `PluginRegistry`.\n * It strictly routes execution flow and tracks active plugins for validation.\n * It embodies the \"Plugin-First Philosophy\" by routing all complex field and layout rendering\n * through discrete, decoupled plugins rather than handling native overrides.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class Engine {\n    /** Handles dynamic conditional logic across the active form. */\n    private conditionEngine: ConditionEngine | null = null;\n\n    /** Array of all instantiated plugins generated during the current build. */\n    private activePlugins: { plugin: IPlugin, path: string }[] = [];\n\n    /** Deterministic scope ID injected by the host control to prevent clone collisions. */\n    public engineScopeId?: string;\n\n    private activeModel?: sap.ui.model.Model;\n\n    /** Callback to notify the host that an internal field changed. */\n    public onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;\n\n    /** Tracks whether the entire engine is running in Editable mode. */\n    public readonly isEditable: boolean = true;\n\n    /** Tracks if any fields or sub-layouts failed to render, requiring a warning strip. */\n    public hasPartialRenderingErrors: boolean = false;\n\n    /** Tracks whether the engine should delegate visual state to the global MessageManager. */\n    public readonly useMessageManager: boolean = false;\n\n    /**\n     * Initializes a new Engine instance.\n     * @param editable Whether the engine should render form fields as editable or read-only.\n     * @param useMessageManager Whether to delegate visual state to UI5 MessageManager.\n     */\n    constructor(editable: boolean = true, useMessageManager: boolean = false) {\n        this.isEditable = editable;\n        this.useMessageManager = useMessageManager;\n    }\n\n    /**\n     * Bootstraps the layout generation process by resolving the correct layout strategy.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param model The active StateManager JSONModel instance.\n     * @param modelName The UI5 model alias used for isolation.\n     * @param onSubmit Callback fired when form is submitted.\n     * @param engineScopeId Deterministic scope ID for this engine instance.\n     * @param onChange Callback fired when field values change.\n     * @returns The generated root UI5 Control container.\n     */\n    public build(schema: ISchema, model: sap.ui.model.Model, modelName: string = \"meta\", onSubmit?: () => void, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control {\n        this.conditionEngine = new ConditionEngine(schema);\n        this.activePlugins = [];\n        this.activeModel = model;\n        this.engineScopeId = engineScopeId;\n        this.onChange = (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => {\n            if (this.conditionEngine && fieldKey) {\n                this.conditionEngine.handleEvent(fieldKey, isValid);\n            }\n            if (onChange) {\n                onChange(isValid, fieldKey, errorMessage, controlId);\n            }\n        };\n\n        try {\n            // Intercept and synthesize a default layout if the developer/backend failed to provide one\n            if (DefaultLayoutGenerator.ensureLayout(schema)) {\n                Logger.warn(\"[MetaUI Engine] Missing 'uiLayout' array in schema. Synthesized a default layout mapping to prevent a blank render.\");\n            }\n\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = PluginRegistry.getInstance().getLayout(layoutStrategy);\n\n            return layoutManager.render(schema, modelName, this, onSubmit);\n        } catch (error) {\n            this.hasPartialRenderingErrors = true;\n            const msg = (error as Error).message;\n            Logger.error(\"[MetaUI Engine] Critical error during layout generation\", msg);\n            Logger.showErrorPopup(`Engine failed to generate the layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Layout Error\" });\n        }\n    }\n\n    /**\n     * Instantiates the correct plugin for a specific field based on type and widget hints,\n     * and tracks the plugin for global validation.\n     * \n     * @param fieldMeta The metadata schema specific to the field.\n     * @param bindingPath The JSON path representing the field within the payload.\n     * @param modelName The UI5 JSONModel name used for data binding.\n     * @returns The generated UI5 Control for the field.\n     */\n    public generateField(fieldMeta: IPropertyMetadata, bindingPath: string, modelName: string, isTemplate: boolean = false): Control {\n        try {\n            const plugin = PluginRegistry.getInstance().getPlugin(fieldMeta.type || \"string\", fieldMeta.ui?.widget);\n            plugin.setEditable(this.isEditable);\n            \n            if (typeof plugin.setUseMessageManager === \"function\") {\n                plugin.setUseMessageManager(this.useMessageManager);\n            }\n\n            if (!isTemplate) {\n                this.activePlugins.push({ plugin, path: bindingPath });\n            }\n            const scopeId = isTemplate ? undefined : this.engineScopeId;\n            const control = plugin.render(fieldMeta, bindingPath, modelName, scopeId, this.onChange);\n\n            if (this.conditionEngine) {\n                this.conditionEngine.registerPlugin(bindingPath, plugin);\n            }\n\n            return control;\n        } catch (error) {\n            this.hasPartialRenderingErrors = true;\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Failed to generate field at ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Failed to generate field '${bindingPath}'.\\n\\nDetails: ${msg}`);\n            return new Text({ text: `[Error generating field ${bindingPath}]` });\n        }\n    }\n\n    /**\n     * Generates a sub-layout (like an embedded table or nested form) without \n     * destroying the current Engine state or Condition tracking.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param modelName The UI5 JSONModel name used for data binding (defaults to \"meta\").\n     * @param bindingPath Optional path to bind the sub-layout to a specific array/object property.\n     * @returns The generated root UI5 Control container.\n     */\n    public generateLayout(schema: ISchema, modelName: string, bindingPath?: string): Control {\n        try {\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = PluginRegistry.getInstance().getLayout(layoutStrategy);\n            return layoutManager.render(schema, modelName, this, undefined, bindingPath);\n        } catch (error) {\n            this.hasPartialRenderingErrors = true;\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Critical error generating sub-layout for ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Engine failed to generate a sub-layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Sub-Layout Error\" });\n        }\n    }\n\n    /**\n     * Iterates through all active plugins and triggers their internal validation pipelines.\n     * \n     * @param applyVisualState If true, explicitly instructs the plugin to natively paint its own ValueState.\n     * @returns {IPluginValidationResult[]} Array of validation error objects. Empty array if valid.\n     */\n    public validateAll(applyVisualState: boolean = false): IPluginValidationResult[] {\n        const errors: IPluginValidationResult[] = [];\n        for (const item of this.activePlugins) {\n            try {\n                const result = item.plugin.validate();\n                if (applyVisualState && typeof item.plugin.setVisualValidationState === \"function\") {\n                    item.plugin.setVisualValidationState(result.isValid, result.errorMessage);\n                }\n                \n                if (!result.isValid) {\n                    // Ensure the path is bound to the error so GeneratorHost knows where to target it\n                    result.fieldKey = result.fieldKey || item.path.replace(/^\\//, \"\");\n                    errors.push(result);\n                    // Add console log to find which plugin fails silently\n                    Logger.error(\"[MetaUI Validation] Plugin failed validation silently:\", item.path || item.plugin.constructor.name);\n                }\n            } catch (error) {\n                Logger.error(`[MetaUI Engine] Error validating plugin at ${item.path}`, (error as Error).message);\n            }\n        }\n        return errors;\n    }\n\n    /**\n     * Retrieves an active plugin instance by its absolute binding path.\n     * Useful for programmatic field manipulation (e.g., custom error injection).\n     * \n     * @param path The binding path (e.g. \"/General/CustomerName\").\n     * @returns {IPlugin | undefined} The plugin instance, or undefined if not found.\n     */\n    public getPluginByPath(path: string): import(\"../interfaces/IPlugin\").IPlugin | undefined {\n        const cleanPath = path.startsWith(\"/\") ? path : `/${path}`;\n        const match = this.activePlugins.find(p => p.path === cleanPath || p.path === `/${cleanPath}`);\n        return match ? match.plugin : undefined;\n    }\n\n    /**\n     * Cleans up internal state and destroys the condition engine to prevent memory leaks.\n     */\n    public destroy(): void {\n        if (this.conditionEngine) {\n            this.conditionEngine.destroy();\n            this.conditionEngine = null;\n        }\n\n        // ------------------------------------------------------------------------\n        // Ghost Error Prevention\n        // Flush MessageManager for active plugins before destroying their controls\n        // ------------------------------------------------------------------------\n        const messageManager = Messaging;\n        const existingMessages = messageManager.getMessageModel().getData();\n        const messagesToRemove: sap.ui.core.message.Message[] = [];\n\n        for (const item of this.activePlugins) {\n            if (this.activeModel) {\n                const targetPath = `/${item.path.replace(/^\\//, \"\")}`;\n                const matched = existingMessages.filter((msg: sap.ui.core.message.Message) =>\n                    msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.activeModel.getId()\n                );\n                messagesToRemove.push(...matched);\n            }\n            if (typeof item.plugin.destroy === \"function\") {\n                item.plugin.destroy();\n            }\n        }\n\n        if (messagesToRemove.length > 0) {\n            messageManager.removeMessages(messagesToRemove);\n        }\n\n        this.activePlugins = [];\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/core/Engine.d.ts

@@ -28,11 +28,16 @@ declare module "nz/co/siliconst/ui5/metaui/core/Engine" {
         onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;
         /** Tracks whether the entire engine is running in Editable mode. */
         readonly isEditable: boolean;
+        /** Tracks if any fields or sub-layouts failed to render, requiring a warning strip. */
+        hasPartialRenderingErrors: boolean;
+        /** Tracks whether the engine should delegate visual state to the global MessageManager. */
+        readonly useMessageManager: boolean;
         /**
          * Initializes a new Engine instance.
          * @param editable Whether the engine should render form fields as editable or read-only.
+         * @param useMessageManager Whether to delegate visual state to UI5 MessageManager.
          */
-        constructor(editable?: boolean);
+        constructor(editable?: boolean, useMessageManager?: boolean);
         /**
          * Bootstraps the layout generation process by resolving the correct layout strategy.
          *
@@ -68,9 +73,18 @@ declare module "nz/co/siliconst/ui5/metaui/core/Engine" {
         /**
          * Iterates through all active plugins and triggers their internal validation pipelines.
          *
+         * @param applyVisualState If true, explicitly instructs the plugin to natively paint its own ValueState.
          * @returns {IPluginValidationResult[]} Array of validation error objects. Empty array if valid.
          */
-        validateAll(): IPluginValidationResult[];
+        validateAll(applyVisualState?: boolean): IPluginValidationResult[];
+        /**
+         * Retrieves an active plugin instance by its absolute binding path.
+         * Useful for programmatic field manipulation (e.g., custom error injection).
+         *
+         * @param path The binding path (e.g. "/General/CustomerName").
+         * @returns {IPlugin | undefined} The plugin instance, or undefined if not found.
+         */
+        getPluginByPath(path: string): import("nz/co/siliconst/ui5/metaui/interfaces/IPlugin").IPlugin | undefined;
         /**
          * Cleans up internal state and destroys the condition engine to prevent memory leaks.
          */

package/src/nz/co/siliconst/ui5/metaui/core/Engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Engine.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/Engine.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,wCAAwC,CAAC;IACxD;;;OAGG;IAEH,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAE3F,OAAO,EAAW,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;IAGjG,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAQ1C;;;;;;;;;OASG;IACH,MAAa,MAAM;QACf,gEAAgE;QAChE,OAAO,CAAC,eAAe,CAAgC;QAEvD,4EAA4E;QAC5E,OAAO,CAAC,aAAa,CAA2C;QAEhE,uFAAuF;QAChF,aAAa,CAAC,EAAE,MAAM,CAAC;QAE9B,OAAO,CAAC,WAAW,CAAC,CAAqB;QAEzC,kEAAkE;QAC3D,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;QAE3G,oEAAoE;QACpE,SAAgB,UAAU,EAAE,OAAO,CAAQ;QAE3C;;;WAGG;oBACS,QAAQ,GAAE,OAAc;QAIpC;;;;;;;;;;WAUG;QACI,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,GAAE,MAAe,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO;QAgCjP;;;;;;;;WAQG;QACI,aAAa,CAAC,SAAS,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,OAAe,GAAG,OAAO;QAwBhI;;;;;;;;WAQG;QACI,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO;QAaxF;;;;WAIG;QACI,WAAW,IAAI,uBAAuB,EAAE;QAqB/C;;WAEG;QACI,OAAO,IAAI,IAAI;KAiCzB;CAEA"}
+{"version":3,"file":"Engine.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/Engine.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,wCAAwC,CAAC;IACxD;;;OAGG;IAEH,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAE3F,OAAO,EAAW,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;IAGjG,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAQ1C;;;;;;;;;OASG;IACH,MAAa,MAAM;QACf,gEAAgE;QAChE,OAAO,CAAC,eAAe,CAAgC;QAEvD,4EAA4E;QAC5E,OAAO,CAAC,aAAa,CAA2C;QAEhE,uFAAuF;QAChF,aAAa,CAAC,EAAE,MAAM,CAAC;QAE9B,OAAO,CAAC,WAAW,CAAC,CAAqB;QAEzC,kEAAkE;QAC3D,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;QAE3G,oEAAoE;QACpE,SAAgB,UAAU,EAAE,OAAO,CAAQ;QAE3C,uFAAuF;QAChF,yBAAyB,EAAE,OAAO,CAAS;QAElD,2FAA2F;QAC3F,SAAgB,iBAAiB,EAAE,OAAO,CAAS;QAEnD;;;;WAIG;oBACS,QAAQ,GAAE,OAAc,EAAE,iBAAiB,GAAE,OAAe;QAKxE;;;;;;;;;;WAUG;QACI,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,GAAE,MAAe,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO;QAiCjP;;;;;;;;WAQG;QACI,aAAa,CAAC,SAAS,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,OAAe,GAAG,OAAO;QA6BhI;;;;;;;;WAQG;QACI,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO;QAcxF;;;;;WAKG;QACI,WAAW,CAAC,gBAAgB,GAAE,OAAe,GAAG,uBAAuB,EAAE;QAuBhF;;;;;;WAMG;QACI,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,+CAA+C,EAAE,OAAO,GAAG,SAAS;QAMjH;;WAEG;QACI,OAAO,IAAI,IAAI;KAiCzB;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/core/Engine.js

@@ -1,2 +1,2 @@
-sap.ui.define(["./ConditionEngine","./PluginRegistry","sap/m/Text","../utils/Logger","./DefaultLayoutGenerator","sap/ui/core/Messaging"],function(e,t,n,i,a,r){"use strict";const o=e["ConditionEngine"];const s=t["PluginRegistry"];const g=i["Logger"];const l=a["DefaultLayoutGenerator"];class c{conditionEngine=null;activePlugins=[];isEditable=true;constructor(e=true){this.isEditable=e}build(e,t,i="meta",a,r,c){this.conditionEngine=new o(e);this.activePlugins=[];this.activeModel=t;this.engineScopeId=r;this.onChange=(e,t,n,i)=>{if(this.conditionEngine&&t){this.conditionEngine.handleEvent(t,e)}if(c){c(e,t,n,i)}};try{if(l.ensureLayout(e)){g.warn("[MetaUI Engine] Missing 'uiLayout' array in schema. Synthesized a default layout mapping to prevent a blank render.")}const t=e.layoutStrategy||(e.type==="array"?"table":"form");const n=s.getInstance().getLayout(t);return n.render(e,i,this,a)}catch(e){const t=e.message;g.error("[MetaUI Engine] Critical error during layout generation",t);g.showErrorPopup(`Engine failed to generate the layout.\n\nDetails: ${t}`);return new n({text:"Critical Layout Error"})}}generateField(e,t,i,a=false){try{const n=s.getInstance().getPlugin(e.type||"string",e.ui?.widget);n.setEditable(this.isEditable);if(!a){this.activePlugins.push({plugin:n,path:t})}const r=a?undefined:this.engineScopeId;const o=n.render(e,t,i,r,this.onChange);if(this.conditionEngine){this.conditionEngine.registerPlugin(t,n)}return o}catch(e){const i=e.message;g.error(`[MetaUI Engine] Failed to generate field at ${t}`,i);g.showErrorPopup(`Failed to generate field '${t}'.\n\nDetails: ${i}`);return new n({text:`[Error generating field ${t}]`})}}generateLayout(e,t,i){try{const n=e.layoutStrategy||(e.type==="array"?"table":"form");const a=s.getInstance().getLayout(n);return a.render(e,t,this,undefined,i)}catch(e){const t=e.message;g.error(`[MetaUI Engine] Critical error generating sub-layout for ${i}`,t);g.showErrorPopup(`Engine failed to generate a sub-layout.\n\nDetails: ${t}`);return new n({text:"Critical Sub-Layout Error"})}}validateAll(){const e=[];for(const t of this.activePlugins){try{const n=t.plugin.validate();if(!n.isValid){n.fieldKey=n.fieldKey||t.path.replace(/^\//,"");e.push(n);g.error("[MetaUI Validation] Plugin failed validation silently:",t.path||t.plugin.constructor.name)}}catch(n){const i=n.message;g.error(`[MetaUI Validation] Exception during plugin validation at path ${t.path}`,i);e.push({isValid:false,errorMessage:`Validation crashed: ${i}`,fieldKey:t.path.replace(/^\//,"")})}}return e}destroy(){if(this.conditionEngine){this.conditionEngine.destroy();this.conditionEngine=null}const e=r;const t=e.getMessageModel().getData();const n=[];for(const e of this.activePlugins){if(this.activeModel){const i=`/${e.path.replace(/^\//,"")}`;const a=t.filter(e=>e.getTarget()===i&&e.getMessageProcessor()&&e.getMessageProcessor().getId()===this.activeModel.getId());n.push(...a)}if(typeof e.plugin.destroy==="function"){e.plugin.destroy()}}if(n.length>0){e.removeMessages(n)}this.activePlugins=[]}}var u={__esModule:true};u.Engine=c;return u});
+sap.ui.define(["./ConditionEngine","./PluginRegistry","sap/m/Text","../utils/Logger","./DefaultLayoutGenerator","sap/ui/core/Messaging"],function(e,t,n,i,a,r){"use strict";const s=e["ConditionEngine"];const o=t["PluginRegistry"];const g=i["Logger"];const l=a["DefaultLayoutGenerator"];class u{conditionEngine=null;activePlugins=[];isEditable=true;hasPartialRenderingErrors=false;useMessageManager=false;constructor(e=true,t=false){this.isEditable=e;this.useMessageManager=t}build(e,t,i="meta",a,r,u){this.conditionEngine=new s(e);this.activePlugins=[];this.activeModel=t;this.engineScopeId=r;this.onChange=(e,t,n,i)=>{if(this.conditionEngine&&t){this.conditionEngine.handleEvent(t,e)}if(u){u(e,t,n,i)}};try{if(l.ensureLayout(e)){g.warn("[MetaUI Engine] Missing 'uiLayout' array in schema. Synthesized a default layout mapping to prevent a blank render.")}const t=e.layoutStrategy||(e.type==="array"?"table":"form");const n=o.getInstance().getLayout(t);return n.render(e,i,this,a)}catch(e){this.hasPartialRenderingErrors=true;const t=e.message;g.error("[MetaUI Engine] Critical error during layout generation",t);g.showErrorPopup(`Engine failed to generate the layout.\n\nDetails: ${t}`);return new n({text:"Critical Layout Error"})}}generateField(e,t,i,a=false){try{const n=o.getInstance().getPlugin(e.type||"string",e.ui?.widget);n.setEditable(this.isEditable);if(typeof n.setUseMessageManager==="function"){n.setUseMessageManager(this.useMessageManager)}if(!a){this.activePlugins.push({plugin:n,path:t})}const r=a?undefined:this.engineScopeId;const s=n.render(e,t,i,r,this.onChange);if(this.conditionEngine){this.conditionEngine.registerPlugin(t,n)}return s}catch(e){this.hasPartialRenderingErrors=true;const i=e.message;g.error(`[MetaUI Engine] Failed to generate field at ${t}`,i);g.showErrorPopup(`Failed to generate field '${t}'.\n\nDetails: ${i}`);return new n({text:`[Error generating field ${t}]`})}}generateLayout(e,t,i){try{const n=e.layoutStrategy||(e.type==="array"?"table":"form");const a=o.getInstance().getLayout(n);return a.render(e,t,this,undefined,i)}catch(e){this.hasPartialRenderingErrors=true;const t=e.message;g.error(`[MetaUI Engine] Critical error generating sub-layout for ${i}`,t);g.showErrorPopup(`Engine failed to generate a sub-layout.\n\nDetails: ${t}`);return new n({text:"Critical Sub-Layout Error"})}}validateAll(e=false){const t=[];for(const n of this.activePlugins){try{const i=n.plugin.validate();if(e&&typeof n.plugin.setVisualValidationState==="function"){n.plugin.setVisualValidationState(i.isValid,i.errorMessage)}if(!i.isValid){i.fieldKey=i.fieldKey||n.path.replace(/^\//,"");t.push(i);g.error("[MetaUI Validation] Plugin failed validation silently:",n.path||n.plugin.constructor.name)}}catch(e){g.error(`[MetaUI Engine] Error validating plugin at ${n.path}`,e.message)}}return t}getPluginByPath(e){const t=e.startsWith("/")?e:`/${e}`;const n=this.activePlugins.find(e=>e.path===t||e.path===`/${t}`);return n?n.plugin:undefined}destroy(){if(this.conditionEngine){this.conditionEngine.destroy();this.conditionEngine=null}const e=r;const t=e.getMessageModel().getData();const n=[];for(const e of this.activePlugins){if(this.activeModel){const i=`/${e.path.replace(/^\//,"")}`;const a=t.filter(e=>e.getTarget()===i&&e.getMessageProcessor()&&e.getMessageProcessor().getId()===this.activeModel.getId());n.push(...a)}if(typeof e.plugin.destroy==="function"){e.plugin.destroy()}}if(n.length>0){e.removeMessages(n)}this.activePlugins=[]}}var c={__esModule:true};c.Engine=u;return c});
 //# sourceMappingURL=Engine.js.map

package/src/nz/co/siliconst/ui5/metaui/core/Engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"Engine.js","names":["ConditionEngine","___ConditionEngine","PluginRegistry","___PluginRegistry","Logger","___utils_Logger","DefaultLayoutGenerator","___DefaultLayoutGenerator","Engine","conditionEngine","activePlugins","isEditable","constructor","editable","this","build","schema","model","modelName","onSubmit","engineScopeId","onChange","activeModel","isValid","fieldKey","errorMessage","controlId","handleEvent","ensureLayout","warn","layoutStrategy","type","layoutManager","getInstance","getLayout","render","error","msg","message","showErrorPopup","Text","text","generateField","fieldMeta","bindingPath","isTemplate","plugin","getPlugin","ui","widget","setEditable","push","path","scopeId","undefined","control","registerPlugin","generateLayout","validateAll","errors","item","result","validate","replace","name","destroy","messageManager","Messaging","existingMessages","getMessageModel","getData","messagesToRemove","targetPath","matched","filter","getTarget","getMessageProcessor","getId","length","removeMessages","__exports","__esModule"],"sources":["Engine.ts"],"sourcesContent":["/**\n * @file Engine.ts\n * @description The central orchestrator that routes data between the Layout Factory and Plugin Registry (v2).\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { IPlugin, IPluginValidationResult } from \"../interfaces/IPlugin\";\nimport { ConditionEngine } from \"./ConditionEngine\";\nimport { PluginRegistry } from \"./PluginRegistry\";\nimport Control from \"sap/ui/core/Control\";\nimport VBox from \"sap/m/VBox\";\nimport Text from \"sap/m/Text\";\nimport { Logger } from \"../utils/Logger\";\nimport { DefaultLayoutGenerator } from \"./DefaultLayoutGenerator\";\nimport Core from \"sap/ui/core/Core\";\nimport Messaging from \"sap/ui/core/Messaging\";\n\n/**\n * The Engine is responsible for translating a normalized schema into a physical UI5 layout.\n * It delegates layout generation to the configured `LayoutManager` and field generation to the `PluginRegistry`.\n * It strictly routes execution flow and tracks active plugins for validation.\n * It embodies the \"Plugin-First Philosophy\" by routing all complex field and layout rendering\n * through discrete, decoupled plugins rather than handling native overrides.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class Engine {\n    /** Handles dynamic conditional logic across the active form. */\n    private conditionEngine: ConditionEngine | null = null;\n\n    /** Array of all instantiated plugins generated during the current build. */\n    private activePlugins: { plugin: IPlugin, path: string }[] = [];\n\n    /** Deterministic scope ID injected by the host control to prevent clone collisions. */\n    public engineScopeId?: string;\n\n    private activeModel?: sap.ui.model.Model;\n\n    /** Callback to notify the host that an internal field changed. */\n    public onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;\n\n    /** Tracks whether the entire engine is running in Editable mode. */\n    public readonly isEditable: boolean = true;\n\n    /**\n     * Initializes a new Engine instance.\n     * @param editable Whether the engine should render form fields as editable or read-only.\n     */\n    constructor(editable: boolean = true) {\n        this.isEditable = editable;\n    }\n\n    /**\n     * Bootstraps the layout generation process by resolving the correct layout strategy.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param model The active StateManager JSONModel instance.\n     * @param modelName The UI5 model alias used for isolation.\n     * @param onSubmit Callback fired when form is submitted.\n     * @param engineScopeId Deterministic scope ID for this engine instance.\n     * @param onChange Callback fired when field values change.\n     * @returns The generated root UI5 Control container.\n     */\n    public build(schema: ISchema, model: sap.ui.model.Model, modelName: string = \"meta\", onSubmit?: () => void, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control {\n        this.conditionEngine = new ConditionEngine(schema);\n        this.activePlugins = [];\n        this.activeModel = model;\n        this.engineScopeId = engineScopeId;\n        this.onChange = (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => {\n            if (this.conditionEngine && fieldKey) {\n                this.conditionEngine.handleEvent(fieldKey, isValid);\n            }\n            if (onChange) {\n                onChange(isValid, fieldKey, errorMessage, controlId);\n            }\n        };\n\n        try {\n            // Intercept and synthesize a default layout if the developer/backend failed to provide one\n            if (DefaultLayoutGenerator.ensureLayout(schema)) {\n                Logger.warn(\"[MetaUI Engine] Missing 'uiLayout' array in schema. Synthesized a default layout mapping to prevent a blank render.\");\n            }\n\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = PluginRegistry.getInstance().getLayout(layoutStrategy);\n\n            return layoutManager.render(schema, modelName, this, onSubmit);\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(\"[MetaUI Engine] Critical error during layout generation\", msg);\n            Logger.showErrorPopup(`Engine failed to generate the layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Layout Error\" });\n        }\n    }\n\n    /**\n     * Instantiates the correct plugin for a specific field based on type and widget hints,\n     * and tracks the plugin for global validation.\n     * \n     * @param fieldMeta The metadata schema specific to the field.\n     * @param bindingPath The JSON path representing the field within the payload.\n     * @param modelName The UI5 JSONModel name used for data binding.\n     * @returns The generated UI5 Control for the field.\n     */\n    public generateField(fieldMeta: IPropertyMetadata, bindingPath: string, modelName: string, isTemplate: boolean = false): Control {\n        try {\n            const plugin = PluginRegistry.getInstance().getPlugin(fieldMeta.type || \"string\", fieldMeta.ui?.widget);\n            plugin.setEditable(this.isEditable);\n\n            if (!isTemplate) {\n                this.activePlugins.push({ plugin, path: bindingPath });\n            }\n            const scopeId = isTemplate ? undefined : this.engineScopeId;\n            const control = plugin.render(fieldMeta, bindingPath, modelName, scopeId, this.onChange);\n\n            if (this.conditionEngine) {\n                this.conditionEngine.registerPlugin(bindingPath, plugin);\n            }\n\n            return control;\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Failed to generate field at ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Failed to generate field '${bindingPath}'.\\n\\nDetails: ${msg}`);\n            return new Text({ text: `[Error generating field ${bindingPath}]` });\n        }\n    }\n\n    /**\n     * Generates a sub-layout (like an embedded table or nested form) without \n     * destroying the current Engine state or Condition tracking.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param modelName The UI5 JSONModel name used for data binding (defaults to \"meta\").\n     * @param bindingPath Optional path to bind the sub-layout to a specific array/object property.\n     * @returns The generated root UI5 Control container.\n     */\n    public generateLayout(schema: ISchema, modelName: string, bindingPath?: string): Control {\n        try {\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = PluginRegistry.getInstance().getLayout(layoutStrategy);\n            return layoutManager.render(schema, modelName, this, undefined, bindingPath);\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Critical error generating sub-layout for ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Engine failed to generate a sub-layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Sub-Layout Error\" });\n        }\n    }\n\n    /**\n     * Iterates through all active plugins and triggers their internal validation pipelines.\n     * \n     * @returns {IPluginValidationResult[]} Array of validation error objects. Empty array if valid.\n     */\n    public validateAll(): IPluginValidationResult[] {\n        const errors: IPluginValidationResult[] = [];\n        for (const item of this.activePlugins) {\n            try {\n                const result = item.plugin.validate();\n                if (!result.isValid) {\n                    // Ensure the path is bound to the error so GeneratorHost knows where to target it\n                    result.fieldKey = result.fieldKey || item.path.replace(/^\\//, \"\");\n                    errors.push(result);\n                    // Add console log to find which plugin fails silently\n                    Logger.error(\"[MetaUI Validation] Plugin failed validation silently:\", item.path || item.plugin.constructor.name);\n                }\n            } catch (error) {\n                const msg = (error as Error).message;\n                Logger.error(`[MetaUI Validation] Exception during plugin validation at path ${item.path}`, msg);\n                errors.push({ isValid: false, errorMessage: `Validation crashed: ${msg}`, fieldKey: item.path.replace(/^\\//, \"\") });\n            }\n        }\n        return errors;\n    }\n\n    /**\n     * Cleans up internal state and destroys the condition engine to prevent memory leaks.\n     */\n    public destroy(): void {\n        if (this.conditionEngine) {\n            this.conditionEngine.destroy();\n            this.conditionEngine = null;\n        }\n\n        // ------------------------------------------------------------------------\n        // Ghost Error Prevention\n        // Flush MessageManager for active plugins before destroying their controls\n        // ------------------------------------------------------------------------\n        const messageManager = Messaging;\n        const existingMessages = messageManager.getMessageModel().getData();\n        const messagesToRemove: sap.ui.core.message.Message[] = [];\n\n        for (const item of this.activePlugins) {\n            if (this.activeModel) {\n                const targetPath = `/${item.path.replace(/^\\//, \"\")}`;\n                const matched = existingMessages.filter((msg: sap.ui.core.message.Message) =>\n                    msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.activeModel.getId()\n                );\n                messagesToRemove.push(...matched);\n            }\n            if (typeof item.plugin.destroy === \"function\") {\n                item.plugin.destroy();\n            }\n        }\n\n        if (messagesToRemove.length > 0) {\n            messageManager.removeMessages(messagesToRemove);\n        }\n\n        this.activePlugins = [];\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Engine.js","names":["ConditionEngine","___ConditionEngine","PluginRegistry","___PluginRegistry","Logger","___utils_Logger","DefaultLayoutGenerator","___DefaultLayoutGenerator","Engine","conditionEngine","activePlugins","isEditable","hasPartialRenderingErrors","useMessageManager","constructor","editable","this","build","schema","model","modelName","onSubmit","engineScopeId","onChange","activeModel","isValid","fieldKey","errorMessage","controlId","handleEvent","ensureLayout","warn","layoutStrategy","type","layoutManager","getInstance","getLayout","render","error","msg","message","showErrorPopup","Text","text","generateField","fieldMeta","bindingPath","isTemplate","plugin","getPlugin","ui","widget","setEditable","setUseMessageManager","push","path","scopeId","undefined","control","registerPlugin","generateLayout","validateAll","applyVisualState","errors","item","result","validate","setVisualValidationState","replace","name","getPluginByPath","cleanPath","startsWith","match","find","p","destroy","messageManager","Messaging","existingMessages","getMessageModel","getData","messagesToRemove","targetPath","matched","filter","getTarget","getMessageProcessor","getId","length","removeMessages","__exports","__esModule"],"sources":["Engine.ts"],"sourcesContent":["/**\n * @file Engine.ts\n * @description The central orchestrator that routes data between the Layout Factory and Plugin Registry (v2).\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { IPlugin, IPluginValidationResult } from \"../interfaces/IPlugin\";\nimport { ConditionEngine } from \"./ConditionEngine\";\nimport { PluginRegistry } from \"./PluginRegistry\";\nimport Control from \"sap/ui/core/Control\";\nimport VBox from \"sap/m/VBox\";\nimport Text from \"sap/m/Text\";\nimport { Logger } from \"../utils/Logger\";\nimport { DefaultLayoutGenerator } from \"./DefaultLayoutGenerator\";\nimport Core from \"sap/ui/core/Core\";\nimport Messaging from \"sap/ui/core/Messaging\";\n\n/**\n * The Engine is responsible for translating a normalized schema into a physical UI5 layout.\n * It delegates layout generation to the configured `LayoutManager` and field generation to the `PluginRegistry`.\n * It strictly routes execution flow and tracks active plugins for validation.\n * It embodies the \"Plugin-First Philosophy\" by routing all complex field and layout rendering\n * through discrete, decoupled plugins rather than handling native overrides.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class Engine {\n    /** Handles dynamic conditional logic across the active form. */\n    private conditionEngine: ConditionEngine | null = null;\n\n    /** Array of all instantiated plugins generated during the current build. */\n    private activePlugins: { plugin: IPlugin, path: string }[] = [];\n\n    /** Deterministic scope ID injected by the host control to prevent clone collisions. */\n    public engineScopeId?: string;\n\n    private activeModel?: sap.ui.model.Model;\n\n    /** Callback to notify the host that an internal field changed. */\n    public onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void;\n\n    /** Tracks whether the entire engine is running in Editable mode. */\n    public readonly isEditable: boolean = true;\n\n    /** Tracks if any fields or sub-layouts failed to render, requiring a warning strip. */\n    public hasPartialRenderingErrors: boolean = false;\n\n    /** Tracks whether the engine should delegate visual state to the global MessageManager. */\n    public readonly useMessageManager: boolean = false;\n\n    /**\n     * Initializes a new Engine instance.\n     * @param editable Whether the engine should render form fields as editable or read-only.\n     * @param useMessageManager Whether to delegate visual state to UI5 MessageManager.\n     */\n    constructor(editable: boolean = true, useMessageManager: boolean = false) {\n        this.isEditable = editable;\n        this.useMessageManager = useMessageManager;\n    }\n\n    /**\n     * Bootstraps the layout generation process by resolving the correct layout strategy.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param model The active StateManager JSONModel instance.\n     * @param modelName The UI5 model alias used for isolation.\n     * @param onSubmit Callback fired when form is submitted.\n     * @param engineScopeId Deterministic scope ID for this engine instance.\n     * @param onChange Callback fired when field values change.\n     * @returns The generated root UI5 Control container.\n     */\n    public build(schema: ISchema, model: sap.ui.model.Model, modelName: string = \"meta\", onSubmit?: () => void, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control {\n        this.conditionEngine = new ConditionEngine(schema);\n        this.activePlugins = [];\n        this.activeModel = model;\n        this.engineScopeId = engineScopeId;\n        this.onChange = (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => {\n            if (this.conditionEngine && fieldKey) {\n                this.conditionEngine.handleEvent(fieldKey, isValid);\n            }\n            if (onChange) {\n                onChange(isValid, fieldKey, errorMessage, controlId);\n            }\n        };\n\n        try {\n            // Intercept and synthesize a default layout if the developer/backend failed to provide one\n            if (DefaultLayoutGenerator.ensureLayout(schema)) {\n                Logger.warn(\"[MetaUI Engine] Missing 'uiLayout' array in schema. Synthesized a default layout mapping to prevent a blank render.\");\n            }\n\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = PluginRegistry.getInstance().getLayout(layoutStrategy);\n\n            return layoutManager.render(schema, modelName, this, onSubmit);\n        } catch (error) {\n            this.hasPartialRenderingErrors = true;\n            const msg = (error as Error).message;\n            Logger.error(\"[MetaUI Engine] Critical error during layout generation\", msg);\n            Logger.showErrorPopup(`Engine failed to generate the layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Layout Error\" });\n        }\n    }\n\n    /**\n     * Instantiates the correct plugin for a specific field based on type and widget hints,\n     * and tracks the plugin for global validation.\n     * \n     * @param fieldMeta The metadata schema specific to the field.\n     * @param bindingPath The JSON path representing the field within the payload.\n     * @param modelName The UI5 JSONModel name used for data binding.\n     * @returns The generated UI5 Control for the field.\n     */\n    public generateField(fieldMeta: IPropertyMetadata, bindingPath: string, modelName: string, isTemplate: boolean = false): Control {\n        try {\n            const plugin = PluginRegistry.getInstance().getPlugin(fieldMeta.type || \"string\", fieldMeta.ui?.widget);\n            plugin.setEditable(this.isEditable);\n            \n            if (typeof plugin.setUseMessageManager === \"function\") {\n                plugin.setUseMessageManager(this.useMessageManager);\n            }\n\n            if (!isTemplate) {\n                this.activePlugins.push({ plugin, path: bindingPath });\n            }\n            const scopeId = isTemplate ? undefined : this.engineScopeId;\n            const control = plugin.render(fieldMeta, bindingPath, modelName, scopeId, this.onChange);\n\n            if (this.conditionEngine) {\n                this.conditionEngine.registerPlugin(bindingPath, plugin);\n            }\n\n            return control;\n        } catch (error) {\n            this.hasPartialRenderingErrors = true;\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Failed to generate field at ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Failed to generate field '${bindingPath}'.\\n\\nDetails: ${msg}`);\n            return new Text({ text: `[Error generating field ${bindingPath}]` });\n        }\n    }\n\n    /**\n     * Generates a sub-layout (like an embedded table or nested form) without \n     * destroying the current Engine state or Condition tracking.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param modelName The UI5 JSONModel name used for data binding (defaults to \"meta\").\n     * @param bindingPath Optional path to bind the sub-layout to a specific array/object property.\n     * @returns The generated root UI5 Control container.\n     */\n    public generateLayout(schema: ISchema, modelName: string, bindingPath?: string): Control {\n        try {\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = PluginRegistry.getInstance().getLayout(layoutStrategy);\n            return layoutManager.render(schema, modelName, this, undefined, bindingPath);\n        } catch (error) {\n            this.hasPartialRenderingErrors = true;\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Critical error generating sub-layout for ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Engine failed to generate a sub-layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Sub-Layout Error\" });\n        }\n    }\n\n    /**\n     * Iterates through all active plugins and triggers their internal validation pipelines.\n     * \n     * @param applyVisualState If true, explicitly instructs the plugin to natively paint its own ValueState.\n     * @returns {IPluginValidationResult[]} Array of validation error objects. Empty array if valid.\n     */\n    public validateAll(applyVisualState: boolean = false): IPluginValidationResult[] {\n        const errors: IPluginValidationResult[] = [];\n        for (const item of this.activePlugins) {\n            try {\n                const result = item.plugin.validate();\n                if (applyVisualState && typeof item.plugin.setVisualValidationState === \"function\") {\n                    item.plugin.setVisualValidationState(result.isValid, result.errorMessage);\n                }\n                \n                if (!result.isValid) {\n                    // Ensure the path is bound to the error so GeneratorHost knows where to target it\n                    result.fieldKey = result.fieldKey || item.path.replace(/^\\//, \"\");\n                    errors.push(result);\n                    // Add console log to find which plugin fails silently\n                    Logger.error(\"[MetaUI Validation] Plugin failed validation silently:\", item.path || item.plugin.constructor.name);\n                }\n            } catch (error) {\n                Logger.error(`[MetaUI Engine] Error validating plugin at ${item.path}`, (error as Error).message);\n            }\n        }\n        return errors;\n    }\n\n    /**\n     * Retrieves an active plugin instance by its absolute binding path.\n     * Useful for programmatic field manipulation (e.g., custom error injection).\n     * \n     * @param path The binding path (e.g. \"/General/CustomerName\").\n     * @returns {IPlugin | undefined} The plugin instance, or undefined if not found.\n     */\n    public getPluginByPath(path: string): import(\"../interfaces/IPlugin\").IPlugin | undefined {\n        const cleanPath = path.startsWith(\"/\") ? path : `/${path}`;\n        const match = this.activePlugins.find(p => p.path === cleanPath || p.path === `/${cleanPath}`);\n        return match ? match.plugin : undefined;\n    }\n\n    /**\n     * Cleans up internal state and destroys the condition engine to prevent memory leaks.\n     */\n    public destroy(): void {\n        if (this.conditionEngine) {\n            this.conditionEngine.destroy();\n            this.conditionEngine = null;\n        }\n\n        // ------------------------------------------------------------------------\n        // Ghost Error Prevention\n        // Flush MessageManager for active plugins before destroying their controls\n        // ------------------------------------------------------------------------\n        const messageManager = Messaging;\n        const existingMessages = messageManager.getMessageModel().getData();\n        const messagesToRemove: sap.ui.core.message.Message[] = [];\n\n        for (const item of this.activePlugins) {\n            if (this.activeModel) {\n                const targetPath = `/${item.path.replace(/^\\//, \"\")}`;\n                const matched = existingMessages.filter((msg: sap.ui.core.message.Message) =>\n                    msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.activeModel.getId()\n                );\n                messagesToRemove.push(...matched);\n            }\n            if (typeof item.plugin.destroy === \"function\") {\n                item.plugin.destroy();\n            }\n        }\n\n        if (messagesToRemove.length > 0) {\n            messageManager.removeMessages(messagesToRemove);\n        }\n\n        this.activePlugins = [];\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/core/Engine.ts

@@ -44,12 +44,20 @@ export class Engine {
     /** Tracks whether the entire engine is running in Editable mode. */
     public readonly isEditable: boolean = true;
 
+    /** Tracks if any fields or sub-layouts failed to render, requiring a warning strip. */
+    public hasPartialRenderingErrors: boolean = false;
+
+    /** Tracks whether the engine should delegate visual state to the global MessageManager. */
+    public readonly useMessageManager: boolean = false;
+
     /**
      * Initializes a new Engine instance.
      * @param editable Whether the engine should render form fields as editable or read-only.
+     * @param useMessageManager Whether to delegate visual state to UI5 MessageManager.
      */
-    constructor(editable: boolean = true) {
+    constructor(editable: boolean = true, useMessageManager: boolean = false) {
         this.isEditable = editable;
+        this.useMessageManager = useMessageManager;
     }
 
     /**
@@ -88,6 +96,7 @@ export class Engine {
 
             return layoutManager.render(schema, modelName, this, onSubmit);
         } catch (error) {
+            this.hasPartialRenderingErrors = true;
             const msg = (error as Error).message;
             Logger.error("[MetaUI Engine] Critical error during layout generation", msg);
             Logger.showErrorPopup(`Engine failed to generate the layout.\n\nDetails: ${msg}`);
@@ -108,6 +117,10 @@ export class Engine {
         try {
             const plugin = PluginRegistry.getInstance().getPlugin(fieldMeta.type || "string", fieldMeta.ui?.widget);
             plugin.setEditable(this.isEditable);
+            
+            if (typeof plugin.setUseMessageManager === "function") {
+                plugin.setUseMessageManager(this.useMessageManager);
+            }
 
             if (!isTemplate) {
                 this.activePlugins.push({ plugin, path: bindingPath });
@@ -121,6 +134,7 @@ export class Engine {
 
             return control;
         } catch (error) {
+            this.hasPartialRenderingErrors = true;
             const msg = (error as Error).message;
             Logger.error(`[MetaUI Engine] Failed to generate field at ${bindingPath}`, msg);
             Logger.showErrorPopup(`Failed to generate field '${bindingPath}'.\n\nDetails: ${msg}`);
@@ -143,6 +157,7 @@ export class Engine {
             const layoutManager = PluginRegistry.getInstance().getLayout(layoutStrategy);
             return layoutManager.render(schema, modelName, this, undefined, bindingPath);
         } catch (error) {
+            this.hasPartialRenderingErrors = true;
             const msg = (error as Error).message;
             Logger.error(`[MetaUI Engine] Critical error generating sub-layout for ${bindingPath}`, msg);
             Logger.showErrorPopup(`Engine failed to generate a sub-layout.\n\nDetails: ${msg}`);
@@ -153,13 +168,18 @@ export class Engine {
     /**
      * Iterates through all active plugins and triggers their internal validation pipelines.
      * 
+     * @param applyVisualState If true, explicitly instructs the plugin to natively paint its own ValueState.
      * @returns {IPluginValidationResult[]} Array of validation error objects. Empty array if valid.
      */
-    public validateAll(): IPluginValidationResult[] {
+    public validateAll(applyVisualState: boolean = false): IPluginValidationResult[] {
         const errors: IPluginValidationResult[] = [];
         for (const item of this.activePlugins) {
             try {
                 const result = item.plugin.validate();
+                if (applyVisualState && typeof item.plugin.setVisualValidationState === "function") {
+                    item.plugin.setVisualValidationState(result.isValid, result.errorMessage);
+                }
+                
                 if (!result.isValid) {
                     // Ensure the path is bound to the error so GeneratorHost knows where to target it
                     result.fieldKey = result.fieldKey || item.path.replace(/^\//, "");
@@ -168,14 +188,25 @@ export class Engine {
                     Logger.error("[MetaUI Validation] Plugin failed validation silently:", item.path || item.plugin.constructor.name);
                 }
             } catch (error) {
-                const msg = (error as Error).message;
-                Logger.error(`[MetaUI Validation] Exception during plugin validation at path ${item.path}`, msg);
-                errors.push({ isValid: false, errorMessage: `Validation crashed: ${msg}`, fieldKey: item.path.replace(/^\//, "") });
+                Logger.error(`[MetaUI Engine] Error validating plugin at ${item.path}`, (error as Error).message);
             }
         }
         return errors;
     }
 
+    /**
+     * Retrieves an active plugin instance by its absolute binding path.
+     * Useful for programmatic field manipulation (e.g., custom error injection).
+     * 
+     * @param path The binding path (e.g. "/General/CustomerName").
+     * @returns {IPlugin | undefined} The plugin instance, or undefined if not found.
+     */
+    public getPluginByPath(path: string): import("../interfaces/IPlugin").IPlugin | undefined {
+        const cleanPath = path.startsWith("/") ? path : `/${path}`;
+        const match = this.activePlugins.find(p => p.path === cleanPath || p.path === `/${cleanPath}`);
+        return match ? match.plugin : undefined;
+    }
+
     /**
      * Cleans up internal state and destroys the condition engine to prevent memory leaks.
      */