@siliconst/metaui 1.2.0 → 1.4.4

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

@@ -1,2 +1,2 @@
-sap.ui.define([],function(){"use strict";class e{static normalize(e,t){let r=e;if(typeof r==="string"){try{r=JSON.parse(r)}catch(e){console.warn("[MetaUI] Failed to parse schema string, falling back to inference.",e);r=null}}if(!r||typeof r!=="object"||Array.isArray(r)){return this.inferSchemaFromData(t)}const i={title:r.title||"MetaUI Generated Form",type:r.type||(r.items?"array":"object")};if(i.type==="object"){i.properties=this.normalizeProperties(r.properties||{})}else if(i.type==="array"){i.items=this.normalizePropertyMetadata(r.items||{type:"object",properties:{}},"items")}return i}static normalizeProperties(e){const t={};for(const r of Object.keys(e)){t[r]=this.normalizePropertyMetadata(e[r],r)}return t}static normalizePropertyMetadata(e,t){const r={type:e.type||"string",ui:{label:e.ui?.label||this.generateLabel(t),isKey:!!e.ui?.isKey,readOnly:!!e.ui?.readOnly,widget:e.ui?.widget,group:e.ui?.group,visibleOn:e.ui?.visibleOn,enabledOn:e.ui?.enabledOn,format:e.ui?.format},required:!!e.required,maxLength:e.maxLength,minimum:e.minimum,maximum:e.maximum,pattern:e.pattern,precision:e.precision,scale:e.scale,valueHelp:e.valueHelp};if(r.type==="object"&&e.properties){r.properties=this.normalizeProperties(e.properties)}else if(r.type==="array"&&e.items){r.items=this.normalizePropertyMetadata(e.items,"items")}return r}static generateLabel(e){if(!e)return"";let t=e.replace(/([A-Z])/g," $1").replace(/_/g," ");return t.split(" ").filter(e=>e.length>0).map(e=>e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join(" ").trim()}static inferSchemaFromData(e){const t={type:"object",properties:{}};if(!e||typeof e!=="object"){return t}if(Array.isArray(e)){t.type="array";t.items={type:"object",properties:e.length>0?this.inferPropertiesFromObject(e[0]):{}}}else{t.type="object";t.properties=this.inferPropertiesFromObject(e)}return t}static inferPropertiesFromObject(e){const t={};if(!e||typeof e!=="object")return t;for(const r of Object.keys(e)){const i=e[r];if(i===null||i===undefined)continue;if(typeof i==="object"&&!Array.isArray(i))continue;let a="string";let s;if(typeof i==="number")a="number";else if(typeof i==="boolean")a="boolean";else if(Array.isArray(i)){a="array";s={type:"object",properties:i.length>0?this.inferPropertiesFromObject(i[0]):{}}}t[r]={type:a,items:s,ui:{label:this.generateLabel(r),isKey:false,readOnly:false}}}return t}}var t={__esModule:true};t.SchemaNormalizer=e;return t});
+sap.ui.define(["../utils/Logger"],function(e){"use strict";const t=e["Logger"];class r{static normalize(e,r){let i=e;if(typeof i==="string"){try{i=JSON.parse(i)}catch(e){const r=e.message;t.error("[MetaUI SchemaNormalizer] Failed to parse schema string.",r);t.showErrorPopup(`Failed to parse the provided JSON schema.\n\nDetails: ${r}`);i=null}}if(!i||typeof i!=="object"||Array.isArray(i)){return this.inferSchemaFromData(r)}try{const e={title:i.title,type:i.type||(i.items?"array":"object"),layoutStrategy:i.layoutStrategy,uiLayout:i.uiLayout,additionalProperties:i.additionalProperties};let t=i.properties||{};if(i.additionalProperties===true&&r){const e=this.inferSchemaFromData(r);if(e.type==="object"&&e.properties){t=this.deepMergeProperties(e.properties,t)}else if(e.type==="array"&&e.items&&e.items.properties){}}if(e.type==="object"){e.properties=this.normalizeProperties(t)}else if(e.type==="array"){e.items=this.normalizePropertyMetadata(i.items||{type:"object",properties:{}},"items")}return e}catch(e){const r=e.message;t.error("[MetaUI SchemaNormalizer] Critical error normalizing schema object.",r);t.showErrorPopup(`Schema Normalization failed.\n\nDetails: ${r}`);return{type:"object",properties:{}}}}static deepMergeProperties(e,t){const r={...e};for(const e of Object.keys(t)){const i=t[e];const a=r[e];if(a&&typeof a==="object"&&!Array.isArray(a)&&i&&typeof i==="object"&&!Array.isArray(i)){r[e]=this.deepMergeProperties(a,i)}else{r[e]=i}}return r}static normalizeProperties(e){const t={};for(const r of Object.keys(e)){t[r]=this.normalizePropertyMetadata(e[r],r)}return t}static normalizePropertyMetadata(e,t){const r={type:e.type||"string",ui:{label:e.ui?.label||this.generateLabel(t),isKey:!!e.ui?.isKey,readOnly:!!e.ui?.readOnly,widget:e.ui?.widget||(e.valueHelp||e.enum?"select":undefined),visibleOn:e.ui?.visibleOn,enabledOn:e.ui?.enabledOn,format:e.ui?.format,validators:e.ui?.validators,formatter:e.ui?.formatter,args:e.ui?.args,rows:e.ui?.rows,fullWidth:e.ui?.fullWidth},required:!!e.required,maxLength:e.maxLength,minimum:e.minimum,maximum:e.maximum,pattern:e.pattern,precision:e.precision,scale:e.scale,valueHelp:e.valueHelp,enum:e.enum};if(r.type==="object"&&e.properties){r.properties=this.normalizeProperties(e.properties);r.uiLayout=e.uiLayout}else if(r.type==="array"&&e.items){r.items=this.normalizePropertyMetadata(e.items,"items");r.uiLayout=e.uiLayout}return r}static generateLabel(e){if(!e)return"";let t=e.replace(/([A-Z])/g," $1").replace(/_/g," ");return t.split(" ").filter(e=>e.length>0).map(e=>e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join(" ").trim()}static inferSchemaFromData(e){const t={type:"object",properties:{},layoutStrategy:"compact",title:""};if(!e||typeof e!=="object"){return t}if(Array.isArray(e)){t.type="array";t.layoutStrategy="table";t.items={type:"object",layoutStrategy:"compact",properties:e.length>0?this.inferPropertiesFromObject(e[0]):{}}}else{t.type="object";t.properties=this.inferPropertiesFromObject(e)}return t}static inferPropertiesFromObject(e){const t={};if(!e||typeof e!=="object")return t;for(const r of Object.keys(e)){const i=e[r];if(i===null||i===undefined)continue;if(typeof i==="object"&&!Array.isArray(i))continue;let a="string";let o;if(typeof i==="number")a="number";else if(typeof i==="boolean")a="boolean";else if(Array.isArray(i)){a="array";o={type:"object",properties:i.length>0?this.inferPropertiesFromObject(i[0]):{}}}t[r]={type:a,items:o,ui:{label:this.generateLabel(r),isKey:false,readOnly:false}}}return t}}var i={__esModule:true};i.SchemaNormalizer=r;return i});
 //# sourceMappingURL=SchemaNormalizer.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"SchemaNormalizer.js","names":["SchemaNormalizer","normalize","rawSchema","data","schemaObj","JSON","parse","e","console","warn","Array","isArray","this","inferSchemaFromData","normalized","title","type","items","properties","normalizeProperties","normalizePropertyMetadata","normalizedProps","key","Object","keys","prop","keyName","ui","label","generateLabel","isKey","readOnly","widget","group","visibleOn","enabledOn","format","required","maxLength","minimum","maximum","pattern","precision","scale","valueHelp","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","trim","schema","inferPropertiesFromObject","obj","val","undefined","__exports","__esModule"],"sources":["SchemaNormalizer.ts"],"sourcesContent":["/**\n * @file SchemaNormalizer.ts\n * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.\n */\n\nimport { ISchema, IPropertyMetadata, FieldType } from \"../interfaces/ISchema\";\n\nexport class SchemaNormalizer {\n    \n    /**\n     * Validates that the provided raw payload conforms to the required ISchema structures.\n     */\n    public static normalize(rawSchema?: any, data?: any): ISchema {\n        let schemaObj = rawSchema;\n\n        if (typeof schemaObj === \"string\") {\n            try {\n                schemaObj = JSON.parse(schemaObj);\n            } catch (e) {\n                console.warn(\"[MetaUI] Failed to parse schema string, falling back to inference.\", e);\n                schemaObj = null;\n            }\n        }\n\n        if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {\n            return this.inferSchemaFromData(data);\n        }\n\n        // It is an object. Ensure it conforms to v2 structure.\n        const normalized: ISchema = {\n            title: schemaObj.title || \"MetaUI Generated Form\",\n            type: schemaObj.type || (schemaObj.items ? \"array\" : \"object\"),\n        };\n\n        if (normalized.type === \"object\") {\n            normalized.properties = this.normalizeProperties(schemaObj.properties || {});\n        } else if (normalized.type === \"array\") {\n            normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: \"object\", properties: {} }, \"items\");\n        }\n\n        return normalized;\n    }\n\n    private static normalizeProperties(properties: any): Record<string, IPropertyMetadata> {\n        const normalizedProps: Record<string, IPropertyMetadata> = {};\n        for (const key of Object.keys(properties)) {\n            normalizedProps[key] = this.normalizePropertyMetadata(properties[key], key);\n        }\n        return normalizedProps;\n    }\n\n    private static normalizePropertyMetadata(prop: any, keyName: string): IPropertyMetadata {\n        const normalized: IPropertyMetadata = {\n            type: prop.type || \"string\",\n            ui: {\n                label: prop.ui?.label || this.generateLabel(keyName),\n                isKey: !!prop.ui?.isKey,\n                readOnly: !!prop.ui?.readOnly,\n                widget: prop.ui?.widget,\n                group: prop.ui?.group,\n                visibleOn: prop.ui?.visibleOn,\n                enabledOn: prop.ui?.enabledOn,\n                format: prop.ui?.format\n            },\n            required: !!prop.required,\n            maxLength: prop.maxLength,\n            minimum: prop.minimum,\n            maximum: prop.maximum,\n            pattern: prop.pattern,\n            precision: prop.precision,\n            scale: prop.scale,\n            valueHelp: prop.valueHelp\n        };\n\n        if (normalized.type === \"object\" && prop.properties) {\n            normalized.properties = this.normalizeProperties(prop.properties);\n        } else if (normalized.type === \"array\" && prop.items) {\n            normalized.items = this.normalizePropertyMetadata(prop.items, \"items\");\n        }\n\n        return normalized;\n    }\n\n    /**\n     * Generates a Title Case label from camelCase or snake_case technical names.\n     */\n    private static generateLabel(name: string): string {\n        if (!name) return \"\";\n        let spaced = name.replace(/([A-Z])/g, \" $1\").replace(/_/g, \" \");\n        return spaced.split(' ')\n            .filter(w => w.length > 0)\n            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n            .join(' ')\n            .trim();\n    }\n\n    /**\n     * Infers a v2 ISchema structure dynamically from a plain data payload.\n     */\n    private static inferSchemaFromData(data: any): ISchema {\n        const schema: ISchema = { type: \"object\", properties: {} };\n        \n        if (!data || typeof data !== \"object\") {\n            return schema;\n        }\n\n        if (Array.isArray(data)) {\n            schema.type = \"array\";\n            schema.items = {\n                type: \"object\",\n                properties: data.length > 0 ? this.inferPropertiesFromObject(data[0]) : {}\n            };\n        } else {\n            schema.type = \"object\";\n            schema.properties = this.inferPropertiesFromObject(data);\n        }\n\n        return schema;\n    }\n\n    private static inferPropertiesFromObject(obj: any): Record<string, IPropertyMetadata> {\n        const properties: Record<string, IPropertyMetadata> = {};\n        if (!obj || typeof obj !== \"object\") return properties;\n\n        for (const key of Object.keys(obj)) {\n            const val = obj[key];\n            if (val === null || val === undefined) continue;\n            \n            if (typeof val === \"object\" && !Array.isArray(val)) continue;\n\n            let type: FieldType = \"string\";\n            let items: IPropertyMetadata | undefined;\n\n            if (typeof val === \"number\") type = \"number\";\n            else if (typeof val === \"boolean\") type = \"boolean\";\n            else if (Array.isArray(val)) {\n                type = \"array\";\n                items = {\n                    type: \"object\",\n                    properties: val.length > 0 ? this.inferPropertiesFromObject(val[0]) : {}\n                };\n            }\n            \n            properties[key] = {\n                type,\n                items,\n                ui: {\n                    label: this.generateLabel(key),\n                    isKey: false,\n                    readOnly: false\n                }\n            };\n        }\n\n        return properties;\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"SchemaNormalizer.js","names":["Logger","___utils_Logger","SchemaNormalizer","normalize","rawSchema","data","schemaObj","JSON","parse","e","msg","message","error","showErrorPopup","Array","isArray","this","inferSchemaFromData","normalized","title","type","items","layoutStrategy","uiLayout","additionalProperties","targetProperties","properties","inferred","deepMergeProperties","normalizeProperties","normalizePropertyMetadata","base","override","merged","key","Object","keys","overrideVal","baseVal","normalizedProps","prop","keyName","ui","label","generateLabel","isKey","readOnly","widget","valueHelp","enum","undefined","visibleOn","enabledOn","format","validators","formatter","args","rows","fullWidth","required","maxLength","minimum","maximum","pattern","precision","scale","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","trim","schema","inferPropertiesFromObject","obj","val","__exports","__esModule"],"sources":["SchemaNormalizer.ts"],"sourcesContent":["/**\n * @file SchemaNormalizer.ts\n * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.\n */\n\nimport { ISchema, IPropertyMetadata, FieldType } from \"../interfaces/ISchema\";\nimport { Logger } from \"../utils/Logger\";\n\nexport class SchemaNormalizer {\n\n    /**\n     * Validates that the provided raw payload conforms to the required ISchema structures.\n     */\n    public static normalize(rawSchema?: any, data?: any): ISchema {\n        let schemaObj = rawSchema;\n\n        if (typeof schemaObj === \"string\") {\n            try {\n                schemaObj = JSON.parse(schemaObj);\n            } catch (e) {\n                const msg = (e as Error).message;\n                Logger.error(\"[MetaUI SchemaNormalizer] Failed to parse schema string.\", msg);\n                Logger.showErrorPopup(`Failed to parse the provided JSON schema.\\n\\nDetails: ${msg}`);\n                schemaObj = null;\n            }\n        }\n\n        if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {\n            return this.inferSchemaFromData(data);\n        }\n\n        try {\n            // It is an object. Ensure it conforms to v2 structure.\n            const normalized: ISchema = {\n                title: schemaObj.title,\n                type: schemaObj.type || (schemaObj.items ? \"array\" : \"object\"),\n                layoutStrategy: schemaObj.layoutStrategy,\n                uiLayout: schemaObj.uiLayout,\n                additionalProperties: schemaObj.additionalProperties\n            };\n\n            let targetProperties = schemaObj.properties || {};\n\n            if (schemaObj.additionalProperties === true && data) {\n                const inferred = this.inferSchemaFromData(data);\n                if (inferred.type === \"object\" && inferred.properties) {\n                    targetProperties = this.deepMergeProperties(inferred.properties, targetProperties);\n                } else if (inferred.type === \"array\" && inferred.items && inferred.items.properties) {\n                    // Array schema merging could be added here if we want full support.\n                }\n            }\n\n            if (normalized.type === \"object\") {\n                normalized.properties = this.normalizeProperties(targetProperties);\n            } else if (normalized.type === \"array\") {\n                // Future expansion: array deep merge\n                normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: \"object\", properties: {} }, \"items\");\n            }\n\n            return normalized;\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(\"[MetaUI SchemaNormalizer] Critical error normalizing schema object.\", msg);\n            Logger.showErrorPopup(`Schema Normalization failed.\\n\\nDetails: ${msg}`);\n            // Fallback to empty object to prevent hard crash downstream\n            return { type: \"object\", properties: {} };\n        }\n    }\n\n    private static deepMergeProperties(base: any, override: any): any {\n        const merged = { ...base };\n        for (const key of Object.keys(override)) {\n            const overrideVal = override[key];\n            const baseVal = merged[key];\n\n            if (baseVal && typeof baseVal === \"object\" && !Array.isArray(baseVal) &&\n                overrideVal && typeof overrideVal === \"object\" && !Array.isArray(overrideVal)) {\n                merged[key] = this.deepMergeProperties(baseVal, overrideVal);\n            } else {\n                merged[key] = overrideVal;\n            }\n        }\n        return merged;\n    }\n\n    private static normalizeProperties(properties: any): Record<string, IPropertyMetadata> {\n        const normalizedProps: Record<string, IPropertyMetadata> = {};\n        for (const key of Object.keys(properties)) {\n            normalizedProps[key] = this.normalizePropertyMetadata(properties[key], key);\n        }\n        return normalizedProps;\n    }\n\n    private static normalizePropertyMetadata(prop: any, keyName: string): IPropertyMetadata {\n        const normalized: IPropertyMetadata = {\n            type: prop.type || \"string\",\n            ui: {\n                label: prop.ui?.label || this.generateLabel(keyName),\n                isKey: !!prop.ui?.isKey,\n                readOnly: !!prop.ui?.readOnly,\n                widget: prop.ui?.widget || (prop.valueHelp || prop.enum ? \"select\" : undefined),\n                visibleOn: prop.ui?.visibleOn,\n                enabledOn: prop.ui?.enabledOn,\n                format: prop.ui?.format,\n                validators: prop.ui?.validators,\n                formatter: prop.ui?.formatter,\n                args: prop.ui?.args,\n                rows: prop.ui?.rows,\n                fullWidth: prop.ui?.fullWidth\n            },\n            required: !!prop.required,\n            maxLength: prop.maxLength,\n            minimum: prop.minimum,\n            maximum: prop.maximum,\n            pattern: prop.pattern,\n            precision: prop.precision,\n            scale: prop.scale,\n            valueHelp: prop.valueHelp,\n            enum: prop.enum\n        };\n\n        if (normalized.type === \"object\" && prop.properties) {\n            normalized.properties = this.normalizeProperties(prop.properties);\n            normalized.uiLayout = prop.uiLayout;\n        } else if (normalized.type === \"array\" && prop.items) {\n            normalized.items = this.normalizePropertyMetadata(prop.items, \"items\");\n            normalized.uiLayout = prop.uiLayout;\n        }\n\n        return normalized;\n    }\n\n    /**\n     * Generates a Title Case label from camelCase or snake_case technical names.\n     */\n    private static generateLabel(name: string): string {\n        if (!name) return \"\";\n        let spaced = name.replace(/([A-Z])/g, \" $1\").replace(/_/g, \" \");\n        return spaced.split(' ')\n            .filter(w => w.length > 0)\n            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n            .join(' ')\n            .trim();\n    }\n\n    /**\n     * Infers a v2 ISchema structure dynamically from a plain data payload.\n     */\n    private static inferSchemaFromData(data: any): ISchema {\n        const schema: ISchema = { type: \"object\", properties: {}, layoutStrategy: \"compact\", title: \"\" };\n\n        if (!data || typeof data !== \"object\") {\n            return schema;\n        }\n\n        if (Array.isArray(data)) {\n            schema.type = \"array\";\n            schema.layoutStrategy = \"table\";\n            schema.items = {\n                type: \"object\",\n                layoutStrategy: \"compact\",\n                properties: data.length > 0 ? this.inferPropertiesFromObject(data[0]) : {}\n            };\n        } else {\n            schema.type = \"object\";\n            schema.properties = this.inferPropertiesFromObject(data);\n        }\n\n        return schema;\n    }\n\n    private static inferPropertiesFromObject(obj: any): Record<string, IPropertyMetadata> {\n        const properties: Record<string, IPropertyMetadata> = {};\n        if (!obj || typeof obj !== \"object\") return properties;\n\n        for (const key of Object.keys(obj)) {\n            const val = obj[key];\n            if (val === null || val === undefined) continue;\n\n            if (typeof val === \"object\" && !Array.isArray(val)) continue;\n\n            let type: FieldType = \"string\";\n            let items: IPropertyMetadata | undefined;\n\n            if (typeof val === \"number\") type = \"number\";\n            else if (typeof val === \"boolean\") type = \"boolean\";\n            else if (Array.isArray(val)) {\n                type = \"array\";\n                items = {\n                    type: \"object\",\n                    properties: val.length > 0 ? this.inferPropertiesFromObject(val[0]) : {}\n                };\n            }\n\n            properties[key] = {\n                type,\n                items,\n                ui: {\n                    label: this.generateLabel(key),\n                    isKey: false,\n                    readOnly: false\n                }\n            };\n        }\n\n        return properties;\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -4,9 +4,10 @@
  */
 
 import { ISchema, IPropertyMetadata, FieldType } from "../interfaces/ISchema";
+import { Logger } from "../utils/Logger";
 
 export class SchemaNormalizer {
-    
+
     /**
      * Validates that the provided raw payload conforms to the required ISchema structures.
      */
@@ -17,7 +18,9 @@ export class SchemaNormalizer {
             try {
                 schemaObj = JSON.parse(schemaObj);
             } catch (e) {
-                console.warn("[MetaUI] Failed to parse schema string, falling back to inference.", e);
+                const msg = (e as Error).message;
+                Logger.error("[MetaUI SchemaNormalizer] Failed to parse schema string.", msg);
+                Logger.showErrorPopup(`Failed to parse the provided JSON schema.\n\nDetails: ${msg}`);
                 schemaObj = null;
             }
         }
@@ -26,19 +29,58 @@ export class SchemaNormalizer {
             return this.inferSchemaFromData(data);
         }
 
-        // It is an object. Ensure it conforms to v2 structure.
-        const normalized: ISchema = {
-            title: schemaObj.title || "MetaUI Generated Form",
-            type: schemaObj.type || (schemaObj.items ? "array" : "object"),
-        };
+        try {
+            // It is an object. Ensure it conforms to v2 structure.
+            const normalized: ISchema = {
+                title: schemaObj.title,
+                type: schemaObj.type || (schemaObj.items ? "array" : "object"),
+                layoutStrategy: schemaObj.layoutStrategy,
+                uiLayout: schemaObj.uiLayout,
+                additionalProperties: schemaObj.additionalProperties
+            };
+
+            let targetProperties = schemaObj.properties || {};
+
+            if (schemaObj.additionalProperties === true && data) {
+                const inferred = this.inferSchemaFromData(data);
+                if (inferred.type === "object" && inferred.properties) {
+                    targetProperties = this.deepMergeProperties(inferred.properties, targetProperties);
+                } else if (inferred.type === "array" && inferred.items && inferred.items.properties) {
+                    // Array schema merging could be added here if we want full support.
+                }
+            }
+
+            if (normalized.type === "object") {
+                normalized.properties = this.normalizeProperties(targetProperties);
+            } else if (normalized.type === "array") {
+                // Future expansion: array deep merge
+                normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: "object", properties: {} }, "items");
+            }
 
-        if (normalized.type === "object") {
-            normalized.properties = this.normalizeProperties(schemaObj.properties || {});
-        } else if (normalized.type === "array") {
-            normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: "object", properties: {} }, "items");
+            return normalized;
+        } catch (error) {
+            const msg = (error as Error).message;
+            Logger.error("[MetaUI SchemaNormalizer] Critical error normalizing schema object.", msg);
+            Logger.showErrorPopup(`Schema Normalization failed.\n\nDetails: ${msg}`);
+            // Fallback to empty object to prevent hard crash downstream
+            return { type: "object", properties: {} };
         }
+    }
 
-        return normalized;
+    private static deepMergeProperties(base: any, override: any): any {
+        const merged = { ...base };
+        for (const key of Object.keys(override)) {
+            const overrideVal = override[key];
+            const baseVal = merged[key];
+
+            if (baseVal && typeof baseVal === "object" && !Array.isArray(baseVal) &&
+                overrideVal && typeof overrideVal === "object" && !Array.isArray(overrideVal)) {
+                merged[key] = this.deepMergeProperties(baseVal, overrideVal);
+            } else {
+                merged[key] = overrideVal;
+            }
+        }
+        return merged;
     }
 
     private static normalizeProperties(properties: any): Record<string, IPropertyMetadata> {
@@ -56,11 +98,15 @@ export class SchemaNormalizer {
                 label: prop.ui?.label || this.generateLabel(keyName),
                 isKey: !!prop.ui?.isKey,
                 readOnly: !!prop.ui?.readOnly,
-                widget: prop.ui?.widget,
-                group: prop.ui?.group,
+                widget: prop.ui?.widget || (prop.valueHelp || prop.enum ? "select" : undefined),
                 visibleOn: prop.ui?.visibleOn,
                 enabledOn: prop.ui?.enabledOn,
-                format: prop.ui?.format
+                format: prop.ui?.format,
+                validators: prop.ui?.validators,
+                formatter: prop.ui?.formatter,
+                args: prop.ui?.args,
+                rows: prop.ui?.rows,
+                fullWidth: prop.ui?.fullWidth
             },
             required: !!prop.required,
             maxLength: prop.maxLength,
@@ -69,13 +115,16 @@ export class SchemaNormalizer {
             pattern: prop.pattern,
             precision: prop.precision,
             scale: prop.scale,
-            valueHelp: prop.valueHelp
+            valueHelp: prop.valueHelp,
+            enum: prop.enum
         };
 
         if (normalized.type === "object" && prop.properties) {
             normalized.properties = this.normalizeProperties(prop.properties);
+            normalized.uiLayout = prop.uiLayout;
         } else if (normalized.type === "array" && prop.items) {
             normalized.items = this.normalizePropertyMetadata(prop.items, "items");
+            normalized.uiLayout = prop.uiLayout;
         }
 
         return normalized;
@@ -98,16 +147,18 @@ export class SchemaNormalizer {
      * Infers a v2 ISchema structure dynamically from a plain data payload.
      */
     private static inferSchemaFromData(data: any): ISchema {
-        const schema: ISchema = { type: "object", properties: {} };
-        
+        const schema: ISchema = { type: "object", properties: {}, layoutStrategy: "compact", title: "" };
+
         if (!data || typeof data !== "object") {
             return schema;
         }
 
         if (Array.isArray(data)) {
             schema.type = "array";
+            schema.layoutStrategy = "table";
             schema.items = {
                 type: "object",
+                layoutStrategy: "compact",
                 properties: data.length > 0 ? this.inferPropertiesFromObject(data[0]) : {}
             };
         } else {
@@ -125,7 +176,7 @@ export class SchemaNormalizer {
         for (const key of Object.keys(obj)) {
             const val = obj[key];
             if (val === null || val === undefined) continue;
-            
+
             if (typeof val === "object" && !Array.isArray(val)) continue;
 
             let type: FieldType = "string";
@@ -140,7 +191,7 @@ export class SchemaNormalizer {
                     properties: val.length > 0 ? this.inferPropertiesFromObject(val[0]) : {}
                 };
             }
-            
+
             properties[key] = {
                 type,
                 items,

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

@@ -0,0 +1,54 @@
+sap.ui.define([], function () {
+  "use strict";
+
+  /**
+   * @file SchemaValidator.ts
+   * @description Structural validation utility to catch developer errors in the JSON schema itself.
+   */
+
+  class SchemaValidator {
+    /**
+     * Validates a parsed JSON schema object for structural correctness.
+     * @param schema The schema object to validate
+     * @returns An array of error strings. Empty if no errors.
+     */
+    static validateSchemaStructure(schema) {
+      const errors = [];
+      if (!schema || typeof schema !== "object") {
+        return ["Root schema must be an object."];
+      }
+      if (schema.type !== "object" && schema.type !== "array") {
+        errors.push(`Root schema must have type 'object' or 'array'. Found: '${schema.type}'`);
+      }
+      if (schema.type === "object" && !schema.properties) {
+        errors.push("Object schema is missing the 'properties' node.");
+      }
+      if (schema.properties) {
+        for (const key of Object.keys(schema.properties)) {
+          const prop = schema.properties[key];
+          if (!prop || typeof prop !== "object") {
+            errors.push(`Property '${key}' must be an object.`);
+            continue;
+          }
+          if (!prop.type) {
+            errors.push(`Property '${key}' is missing 'type'.`);
+          } else {
+            const allowedTypes = ["string", "number", "boolean", "date", "object", "array"];
+            if (!allowedTypes.includes(prop.type)) {
+              errors.push(`Property '${key}' has invalid type '${prop.type}'. Allowed: ${allowedTypes.join(", ")}`);
+            }
+          }
+
+          // Removed strict check for prop.items on array properties because inference handles empty definitions
+        }
+      }
+      return errors;
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.SchemaValidator = SchemaValidator;
+  return __exports;
+});
+//# sourceMappingURL=SchemaValidator-dbg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaValidator-dbg.js","names":["SchemaValidator","validateSchemaStructure","schema","errors","type","push","properties","key","Object","keys","prop","allowedTypes","includes","join","__exports","__esModule"],"sources":["SchemaValidator.ts"],"sourcesContent":["/**\n * @file SchemaValidator.ts\n * @description Structural validation utility to catch developer errors in the JSON schema itself.\n */\n\nimport { ISchema, FieldType } from \"../interfaces/ISchema\";\n\nexport class SchemaValidator {\n    /**\n     * Validates a parsed JSON schema object for structural correctness.\n     * @param schema The schema object to validate\n     * @returns An array of error strings. Empty if no errors.\n     */\n    public static validateSchemaStructure(schema: any): string[] {\n        const errors: string[] = [];\n\n        if (!schema || typeof schema !== \"object\") {\n            return [\"Root schema must be an object.\"];\n        }\n\n        if (schema.type !== \"object\" && schema.type !== \"array\") {\n            errors.push(`Root schema must have type 'object' or 'array'. Found: '${schema.type}'`);\n        }\n\n        if (schema.type === \"object\" && !schema.properties) {\n            errors.push(\"Object schema is missing the 'properties' node.\");\n        }\n\n        if (schema.properties) {\n            for (const key of Object.keys(schema.properties)) {\n                const prop = schema.properties[key];\n                if (!prop || typeof prop !== \"object\") {\n                    errors.push(`Property '${key}' must be an object.`);\n                    continue;\n                }\n\n                if (!prop.type) {\n                    errors.push(`Property '${key}' is missing 'type'.`);\n                } else {\n                    const allowedTypes: FieldType[] = [\"string\", \"number\", \"boolean\", \"date\", \"object\", \"array\"];\n                    if (!allowedTypes.includes(prop.type)) {\n                        errors.push(`Property '${key}' has invalid type '${prop.type}'. Allowed: ${allowedTypes.join(\", \")}`);\n                    }\n                }\n\n                // Removed strict check for prop.items on array properties because inference handles empty definitions\n\n            }\n        }\n\n        return errors;\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;;EAIO,MAAMA,eAAe,CAAC;IACzB;AACJ;AACA;AACA;AACA;IACI,OAAcC,uBAAuBA,CAACC,MAAW,EAAY;MACzD,MAAMC,MAAgB,GAAG,EAAE;MAE3B,IAAI,CAACD,MAAM,IAAI,OAAOA,MAAM,KAAK,QAAQ,EAAE;QACvC,OAAO,CAAC,gCAAgC,CAAC;MAC7C;MAEA,IAAIA,MAAM,CAACE,IAAI,KAAK,QAAQ,IAAIF,MAAM,CAACE,IAAI,KAAK,OAAO,EAAE;QACrDD,MAAM,CAACE,IAAI,CAAC,2DAA2DH,MAAM,CAACE,IAAI,GAAG,CAAC;MAC1F;MAEA,IAAIF,MAAM,CAACE,IAAI,KAAK,QAAQ,IAAI,CAACF,MAAM,CAACI,UAAU,EAAE;QAChDH,MAAM,CAACE,IAAI,CAAC,iDAAiD,CAAC;MAClE;MAEA,IAAIH,MAAM,CAACI,UAAU,EAAE;QACnB,KAAK,MAAMC,GAAG,IAAIC,MAAM,CAACC,IAAI,CAACP,MAAM,CAACI,UAAU,CAAC,EAAE;UAC9C,MAAMI,IAAI,GAAGR,MAAM,CAACI,UAAU,CAACC,GAAG,CAAC;UACnC,IAAI,CAACG,IAAI,IAAI,OAAOA,IAAI,KAAK,QAAQ,EAAE;YACnCP,MAAM,CAACE,IAAI,CAAC,aAAaE,GAAG,sBAAsB,CAAC;YACnD;UACJ;UAEA,IAAI,CAACG,IAAI,CAACN,IAAI,EAAE;YACZD,MAAM,CAACE,IAAI,CAAC,aAAaE,GAAG,sBAAsB,CAAC;UACvD,CAAC,MAAM;YACH,MAAMI,YAAyB,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC;YAC5F,IAAI,CAACA,YAAY,CAACC,QAAQ,CAACF,IAAI,CAACN,IAAI,CAAC,EAAE;cACnCD,MAAM,CAACE,IAAI,CAAC,aAAaE,GAAG,uBAAuBG,IAAI,CAACN,IAAI,eAAeO,YAAY,CAACE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzG;UACJ;;UAEA;QAEJ;MACJ;MAEA,OAAOV,MAAM;IACjB;EACJ;EAAC,IAAAW,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAd,eAAA,GAAAA,eAAA;EAAA,OAAAc,SAAA;AAAA","ignoreList":[]}

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

@@ -0,0 +1,11 @@
+declare module "nz/co/siliconst/ui5/metaui/core/SchemaValidator" {
+    export class SchemaValidator {
+        /**
+         * Validates a parsed JSON schema object for structural correctness.
+         * @param schema The schema object to validate
+         * @returns An array of error strings. Empty if no errors.
+         */
+        static validateSchemaStructure(schema: any): string[];
+    }
+}
+//# sourceMappingURL=SchemaValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaValidator.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/SchemaValidator.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,iDAAiD,CAAC;IAQjE,MAAa,eAAe;QACxB;;;;WAIG;eACW,uBAAuB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE;KAuC/D;CAEA"}

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

@@ -0,0 +1,2 @@
+sap.ui.define([],function(){"use strict";class e{static validateSchemaStructure(e){const t=[];if(!e||typeof e!=="object"){return["Root schema must be an object."]}if(e.type!=="object"&&e.type!=="array"){t.push(`Root schema must have type 'object' or 'array'. Found: '${e.type}'`)}if(e.type==="object"&&!e.properties){t.push("Object schema is missing the 'properties' node.")}if(e.properties){for(const o of Object.keys(e.properties)){const r=e.properties[o];if(!r||typeof r!=="object"){t.push(`Property '${o}' must be an object.`);continue}if(!r.type){t.push(`Property '${o}' is missing 'type'.`)}else{const e=["string","number","boolean","date","object","array"];if(!e.includes(r.type)){t.push(`Property '${o}' has invalid type '${r.type}'. Allowed: ${e.join(", ")}`)}}}}return t}}var t={__esModule:true};t.SchemaValidator=e;return t});
+//# sourceMappingURL=SchemaValidator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaValidator.js","names":["SchemaValidator","validateSchemaStructure","schema","errors","type","push","properties","key","Object","keys","prop","allowedTypes","includes","join","__exports","__esModule"],"sources":["SchemaValidator.ts"],"sourcesContent":["/**\n * @file SchemaValidator.ts\n * @description Structural validation utility to catch developer errors in the JSON schema itself.\n */\n\nimport { ISchema, FieldType } from \"../interfaces/ISchema\";\n\nexport class SchemaValidator {\n    /**\n     * Validates a parsed JSON schema object for structural correctness.\n     * @param schema The schema object to validate\n     * @returns An array of error strings. Empty if no errors.\n     */\n    public static validateSchemaStructure(schema: any): string[] {\n        const errors: string[] = [];\n\n        if (!schema || typeof schema !== \"object\") {\n            return [\"Root schema must be an object.\"];\n        }\n\n        if (schema.type !== \"object\" && schema.type !== \"array\") {\n            errors.push(`Root schema must have type 'object' or 'array'. Found: '${schema.type}'`);\n        }\n\n        if (schema.type === \"object\" && !schema.properties) {\n            errors.push(\"Object schema is missing the 'properties' node.\");\n        }\n\n        if (schema.properties) {\n            for (const key of Object.keys(schema.properties)) {\n                const prop = schema.properties[key];\n                if (!prop || typeof prop !== \"object\") {\n                    errors.push(`Property '${key}' must be an object.`);\n                    continue;\n                }\n\n                if (!prop.type) {\n                    errors.push(`Property '${key}' is missing 'type'.`);\n                } else {\n                    const allowedTypes: FieldType[] = [\"string\", \"number\", \"boolean\", \"date\", \"object\", \"array\"];\n                    if (!allowedTypes.includes(prop.type)) {\n                        errors.push(`Property '${key}' has invalid type '${prop.type}'. Allowed: ${allowedTypes.join(\", \")}`);\n                    }\n                }\n\n                // Removed strict check for prop.items on array properties because inference handles empty definitions\n\n            }\n        }\n\n        return errors;\n    }\n}\n"],"mappings":"yCAOO,MAAMA,EAMT,8BAAcC,CAAwBC,GAClC,MAAMC,EAAmB,GAEzB,IAAKD,UAAiBA,IAAW,SAAU,CACvC,MAAO,CAAC,iCACZ,CAEA,GAAIA,EAAOE,OAAS,UAAYF,EAAOE,OAAS,QAAS,CACrDD,EAAOE,KAAK,2DAA2DH,EAAOE,QAClF,CAEA,GAAIF,EAAOE,OAAS,WAAaF,EAAOI,WAAY,CAChDH,EAAOE,KAAK,kDAChB,CAEA,GAAIH,EAAOI,WAAY,CACnB,IAAK,MAAMC,KAAOC,OAAOC,KAAKP,EAAOI,YAAa,CAC9C,MAAMI,EAAOR,EAAOI,WAAWC,GAC/B,IAAKG,UAAeA,IAAS,SAAU,CACnCP,EAAOE,KAAK,aAAaE,yBACzB,QACJ,CAEA,IAAKG,EAAKN,KAAM,CACZD,EAAOE,KAAK,aAAaE,wBAC7B,KAAO,CACH,MAAMI,EAA4B,CAAC,SAAU,SAAU,UAAW,OAAQ,SAAU,SACpF,IAAKA,EAAaC,SAASF,EAAKN,MAAO,CACnCD,EAAOE,KAAK,aAAaE,wBAA0BG,EAAKN,mBAAmBO,EAAaE,KAAK,QACjG,CACJ,CAIJ,CACJ,CAEA,OAAOV,CACX,EACH,IAAAW,EAAA,CAAAC,WAAA,MAAAD,EAAAd,kBAAA,OAAAc,CAAA","ignoreList":[]}

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

@@ -0,0 +1,53 @@
+/**
+ * @file SchemaValidator.ts
+ * @description Structural validation utility to catch developer errors in the JSON schema itself.
+ */
+
+import { ISchema, FieldType } from "../interfaces/ISchema";
+
+export class SchemaValidator {
+    /**
+     * Validates a parsed JSON schema object for structural correctness.
+     * @param schema The schema object to validate
+     * @returns An array of error strings. Empty if no errors.
+     */
+    public static validateSchemaStructure(schema: any): string[] {
+        const errors: string[] = [];
+
+        if (!schema || typeof schema !== "object") {
+            return ["Root schema must be an object."];
+        }
+
+        if (schema.type !== "object" && schema.type !== "array") {
+            errors.push(`Root schema must have type 'object' or 'array'. Found: '${schema.type}'`);
+        }
+
+        if (schema.type === "object" && !schema.properties) {
+            errors.push("Object schema is missing the 'properties' node.");
+        }
+
+        if (schema.properties) {
+            for (const key of Object.keys(schema.properties)) {
+                const prop = schema.properties[key];
+                if (!prop || typeof prop !== "object") {
+                    errors.push(`Property '${key}' must be an object.`);
+                    continue;
+                }
+
+                if (!prop.type) {
+                    errors.push(`Property '${key}' is missing 'type'.`);
+                } else {
+                    const allowedTypes: FieldType[] = ["string", "number", "boolean", "date", "object", "array"];
+                    if (!allowedTypes.includes(prop.type)) {
+                        errors.push(`Property '${key}' has invalid type '${prop.type}'. Allowed: ${allowedTypes.join(", ")}`);
+                    }
+                }
+
+                // Removed strict check for prop.items on array properties because inference handles empty definitions
+
+            }
+        }
+
+        return errors;
+    }
+}

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

@@ -1,6 +1,7 @@
-sap.ui.define(["sap/ui/model/json/JSONModel"], function (JSONModel) {
+sap.ui.define(["sap/ui/model/json/JSONModel", "./PipelineManager", "sap/ui/core/message/Message", "sap/ui/core/library", "sap/ui/core/Messaging"], function (JSONModel, ___PipelineManager, Message, coreLibrary, Messaging) {
   "use strict";
 
+  const GlobalPipeline = ___PipelineManager["GlobalPipeline"];
   /**
    * Manages the isolated internal data payload for the MetaUI engine.
    */
@@ -8,12 +9,88 @@ sap.ui.define(["sap/ui/model/json/JSONModel"], function (JSONModel) {
     /**
      * Initializes the state manager with an optional initial payload.
      * @param initialData The initial JSON payload to populate the fields.
+     * @param schema The normalized schema for live validation.
+     * @param modelName The UI5 model alias used for isolation.
      */
-    constructor(initialData = {}) {
+    constructor(initialData = {}, schema, modelName = "meta") {
+      this.activeModelName = modelName;
+      this.schema = schema;
+
       // Deep copy to ensure no reference leakage from the host application
       const safeData = JSON.parse(JSON.stringify(initialData));
       this.model = new JSONModel(safeData);
       this.model.setDefaultBindingMode("TwoWay");
+
+      // Centralized Model-Level Validation Interceptor
+      const originalSetProperty = this.model.setProperty.bind(this.model);
+      this.model.setProperty = (sPath, oValue, oContext, bAsyncUpdate) => {
+        const result = originalSetProperty(sPath, oValue, oContext, bAsyncUpdate);
+        this.validatePath(sPath, oValue);
+        return result;
+      };
+    }
+
+    /**
+     * Validates a specific path against the schema and updates the MessageManager.
+     */
+    validatePath(sPath, value) {
+      const fieldKey = sPath.replace(/^\//, "");
+      const metadata = this.findMetadataForPath(fieldKey);
+      const messageManager = Messaging;
+      const targetPath = sPath.startsWith("/") ? sPath : `/${sPath}`; // Pure UI5: target MUST be absolute path
+
+      // 1. Remove existing messages (strictly for THIS model instance)
+      const existingMessages = messageManager.getMessageModel().getData();
+      const messagesToRemove = existingMessages.filter(msg => {
+        const isMatch = msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.model.getId();
+        return isMatch;
+      });
+      if (messagesToRemove.length > 0) {
+        messageManager.removeMessages(messagesToRemove);
+      }
+      if (!metadata) return;
+
+      // 2. Run GlobalPipeline
+      const validatorsToRun = [];
+      const argsMap = {};
+      if (metadata.required) {
+        validatorsToRun.push("required");
+      }
+      if (metadata.type === "string" && metadata.maxLength) {
+        validatorsToRun.push("maxLength");
+        argsMap["maxLength"] = {
+          max: metadata.maxLength
+        };
+      }
+      if (metadata.ui?.validators) {
+        for (const v of metadata.ui.validators) {
+          if (typeof v === "string") {
+            validatorsToRun.push(v);
+          } else if (v && v.name) {
+            validatorsToRun.push(v.name);
+            if (v.args !== undefined) {
+              argsMap[v.name] = v.args;
+            }
+          }
+        }
+      }
+      if (validatorsToRun.length > 0) {
+        const validationResult = GlobalPipeline.executeValidation(value, validatorsToRun, argsMap);
+        if (!validationResult.isValid) {
+          const newMsg = new Message({
+            message: validationResult.errorMessage || "Invalid value.",
+            type: coreLibrary.MessageType.Error,
+            target: targetPath,
+            processor: this.model
+          });
+          messageManager.addMessages(newMsg);
+        }
+      }
+    }
+    findMetadataForPath(path) {
+      if (!this.schema || !this.schema.properties) return undefined;
+      // Basic single-level support for now. Nested object resolution would split by '.' or '/'
+      return this.schema.properties[path];
     }
 
     /**
@@ -46,6 +123,15 @@ sap.ui.define(["sap/ui/model/json/JSONModel"], function (JSONModel) {
       const data = this.model.getData();
       return JSON.parse(JSON.stringify(data));
     }
+
+    /**
+     * Cleans up internal state and natively destroys the UI5 JSONModel to prevent memory leaks.
+     */
+    destroy() {
+      if (this.model) {
+        this.model.destroy();
+      }
+    }
   }
   var __exports = {
     __esModule: true

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

@@ -1 +1 @@
-{"version":3,"file":"StateManager-dbg.js","names":["StateManager","constructor","initialData","safeData","JSON","parse","stringify","model","JSONModel","setDefaultBindingMode","getModel","bindControl","control","property","bindingPath","bindProperty","path","extractPayload","data","getData","__exports","__esModule"],"sources":["StateManager.ts"],"sourcesContent":["/**\n * @file StateManager.ts\n * @description Isolated internal state management. Decouples the MetaUI engine from external host models.\n */\n\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport ManagedObject from \"sap/ui/base/ManagedObject\";\n\n/**\n * Manages the isolated internal data payload for the MetaUI engine.\n */\nexport class StateManager {\n    private model: JSONModel;\n\n    /**\n     * Initializes the state manager with an optional initial payload.\n     * @param initialData The initial JSON payload to populate the fields.\n     */\n    constructor(initialData: Record<string, any> = {}) {\n        // Deep copy to ensure no reference leakage from the host application\n        const safeData = JSON.parse(JSON.stringify(initialData));\n        this.model = new JSONModel(safeData);\n        this.model.setDefaultBindingMode(\"TwoWay\");\n    }\n\n    /**\n     * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.\n     * @returns The internal JSONModel.\n     */\n    public getModel(): JSONModel {\n        return this.model;\n    }\n\n    /**\n     * Binds a generated UI control property to a path in the internal model.\n     * @param control The target UI5 Control.\n     * @param property The UI5 property name (e.g., 'value').\n     * @param bindingPath The exact path in the JSON payload.\n     */\n    public bindControl(control: ManagedObject, property: string, bindingPath: string): void {\n        control.bindProperty(property, {\n            path: bindingPath,\n            model: \"meta\" // Assumes the model is bound to the root container with the name 'meta'\n        });\n    }\n\n    /**\n     * Extracts the flat JavaScript object representing the current state of the UI.\n     * @returns A serialized record of the data payload, free of UI5 wrappers.\n     */\n    public extractPayload(): Record<string, any> {\n        // Create a deep copy to prevent accidental mutations by the host\n        const data = this.model.getData();\n        return JSON.parse(JSON.stringify(data));\n    }\n}\n"],"mappings":";;;EAQA;AACA;AACA;EACO,MAAMA,YAAY,CAAC;IAGtB;AACJ;AACA;AACA;IACIC,WAAWA,CAACC,WAAgC,GAAG,CAAC,CAAC,EAAE;MAC/C;MACA,MAAMC,QAAQ,GAAGC,IAAI,CAACC,KAAK,CAACD,IAAI,CAACE,SAAS,CAACJ,WAAW,CAAC,CAAC;MACxD,IAAI,CAACK,KAAK,GAAG,IAAIC,SAAS,CAACL,QAAQ,CAAC;MACpC,IAAI,CAACI,KAAK,CAACE,qBAAqB,CAAC,QAAQ,CAAC;IAC9C;;IAEA;AACJ;AACA;AACA;IACWC,QAAQA,CAAA,EAAc;MACzB,OAAO,IAAI,CAACH,KAAK;IACrB;;IAEA;AACJ;AACA;AACA;AACA;AACA;IACWI,WAAWA,CAACC,OAAsB,EAAEC,QAAgB,EAAEC,WAAmB,EAAQ;MACpFF,OAAO,CAACG,YAAY,CAACF,QAAQ,EAAE;QAC3BG,IAAI,EAAEF,WAAW;QACjBP,KAAK,EAAE,MAAM,CAAC;MAClB,CAAC,CAAC;IACN;;IAEA;AACJ;AACA;AACA;IACWU,cAAcA,CAAA,EAAwB;MACzC;MACA,MAAMC,IAAI,GAAG,IAAI,CAACX,KAAK,CAACY,OAAO,CAAC,CAAC;MACjC,OAAOf,IAAI,CAACC,KAAK,CAACD,IAAI,CAACE,SAAS,CAACY,IAAI,CAAC,CAAC;IAC3C;EACJ;EAAC,IAAAE,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAApB,YAAA,GAAAA,YAAA;EAAA,OAAAoB,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"StateManager-dbg.js","names":["GlobalPipeline","___PipelineManager","StateManager","constructor","initialData","schema","modelName","activeModelName","safeData","JSON","parse","stringify","model","JSONModel","setDefaultBindingMode","originalSetProperty","setProperty","bind","sPath","oValue","oContext","bAsyncUpdate","result","validatePath","value","fieldKey","replace","metadata","findMetadataForPath","messageManager","Messaging","targetPath","startsWith","existingMessages","getMessageModel","getData","messagesToRemove","filter","msg","isMatch","getTarget","getMessageProcessor","getId","length","removeMessages","validatorsToRun","argsMap","required","push","type","maxLength","max","ui","validators","v","name","args","undefined","validationResult","executeValidation","isValid","newMsg","Message","message","errorMessage","coreLibrary","MessageType","Error","target","processor","addMessages","path","properties","getModel","bindControl","control","property","bindingPath","bindProperty","extractPayload","data","destroy","__exports","__esModule"],"sources":["StateManager.ts"],"sourcesContent":["/**\n * @file StateManager.ts\n * @description Isolated internal state management. Decouples the MetaUI engine from external host models.\n */\n\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport ManagedObject from \"sap/ui/base/ManagedObject\";\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { GlobalPipeline } from \"./PipelineManager\";\nimport Message from \"sap/ui/core/message/Message\";\nimport coreLibrary from \"sap/ui/core/library\";\nimport Core from \"sap/ui/core/Core\";\nimport Messaging from \"sap/ui/core/Messaging\";\n\n\n/**\n * Manages the isolated internal data payload for the MetaUI engine.\n */\nexport class StateManager {\n    private model: JSONModel;\n    private activeModelName: string;\n    private schema: ISchema;\n\n    /**\n     * Initializes the state manager with an optional initial payload.\n     * @param initialData The initial JSON payload to populate the fields.\n     * @param schema The normalized schema for live validation.\n     * @param modelName The UI5 model alias used for isolation.\n     */\n    constructor(initialData: Record<string, any> = {}, schema: ISchema, modelName: string = \"meta\") {\n        this.activeModelName = modelName;\n        this.schema = schema;\n        \n        // Deep copy to ensure no reference leakage from the host application\n        const safeData = JSON.parse(JSON.stringify(initialData));\n        this.model = new JSONModel(safeData);\n        this.model.setDefaultBindingMode(\"TwoWay\");\n\n        // Centralized Model-Level Validation Interceptor\n        const originalSetProperty = this.model.setProperty.bind(this.model);\n        this.model.setProperty = (sPath: string, oValue: any, oContext?: any, bAsyncUpdate?: boolean) => {\n            const result = originalSetProperty(sPath, oValue, oContext, bAsyncUpdate);\n            this.validatePath(sPath, oValue);\n            return result;\n        };\n    }\n\n    /**\n     * Validates a specific path against the schema and updates the MessageManager.\n     */\n    private validatePath(sPath: string, value: any): void {\n        const fieldKey = sPath.replace(/^\\//, \"\");\n        const metadata = this.findMetadataForPath(fieldKey);\n        \n        const messageManager = Messaging;\n        const targetPath = sPath.startsWith(\"/\") ? sPath : `/${sPath}`; // Pure UI5: target MUST be absolute path\n        \n        // 1. Remove existing messages (strictly for THIS model instance)\n        const existingMessages = messageManager.getMessageModel().getData();\n        const messagesToRemove = existingMessages.filter((msg: any) => {\n            const isMatch = msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.model.getId();\n            return isMatch;\n        });\n        \n        \n        if (messagesToRemove.length > 0) {\n            messageManager.removeMessages(messagesToRemove);\n        }\n\n        if (!metadata) return;\n\n        // 2. Run GlobalPipeline\n        const validatorsToRun: string[] = [];\n        const argsMap: Record<string, any> = {};\n\n        if (metadata.required) {\n            validatorsToRun.push(\"required\");\n        }\n        if (metadata.type === \"string\" && metadata.maxLength) {\n            validatorsToRun.push(\"maxLength\");\n            argsMap[\"maxLength\"] = { max: metadata.maxLength };\n        }\n        if (metadata.ui?.validators) {\n            for (const v of metadata.ui.validators) {\n                if (typeof v === \"string\") {\n                    validatorsToRun.push(v);\n                } else if (v && v.name) {\n                    validatorsToRun.push(v.name);\n                    if (v.args !== undefined) {\n                        argsMap[v.name] = v.args;\n                    }\n                }\n            }\n        }\n\n        if (validatorsToRun.length > 0) {\n            const validationResult = GlobalPipeline.executeValidation(value, validatorsToRun, argsMap);\n            if (!validationResult.isValid) {\n                const newMsg = new Message({\n                    message: validationResult.errorMessage || \"Invalid value.\",\n                    type: coreLibrary.MessageType.Error,\n                    target: targetPath,\n                    processor: this.model\n                });\n                messageManager.addMessages(newMsg);\n            }\n        }\n    }\n\n    private findMetadataForPath(path: string): IPropertyMetadata | undefined {\n        if (!this.schema || !this.schema.properties) return undefined;\n        // Basic single-level support for now. Nested object resolution would split by '.' or '/'\n        return this.schema.properties[path];\n    }\n\n\n\n    /**\n     * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.\n     * @returns The internal JSONModel.\n     */\n    public getModel(): JSONModel {\n        return this.model;\n    }\n\n    /**\n     * Binds a generated UI control property to a path in the internal model.\n     * @param control The target UI5 Control.\n     * @param property The UI5 property name (e.g., 'value').\n     * @param bindingPath The exact path in the JSON payload.\n     */\n    public bindControl(control: ManagedObject, property: string, bindingPath: string): void {\n        control.bindProperty(property, {\n            path: bindingPath,\n            model: \"meta\" // Assumes the model is bound to the root container with the name 'meta'\n        });\n    }\n\n    /**\n     * Extracts the flat JavaScript object representing the current state of the UI.\n     * @returns A serialized record of the data payload, free of UI5 wrappers.\n     */\n    public extractPayload(): Record<string, any> {\n        // Create a deep copy to prevent accidental mutations by the host\n        const data = this.model.getData();\n        return JSON.parse(JSON.stringify(data));\n    }\n\n    /**\n     * Cleans up internal state and natively destroys the UI5 JSONModel to prevent memory leaks.\n     */\n    public destroy(): void {\n        \n        if (this.model) {\n            this.model.destroy();\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -5,16 +5,26 @@ declare module "nz/co/siliconst/ui5/metaui/core/StateManager" {
      */
     import JSONModel from "sap/ui/model/json/JSONModel";
     import ManagedObject from "sap/ui/base/ManagedObject";
+    import { ISchema } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
     /**
      * Manages the isolated internal data payload for the MetaUI engine.
      */
     export class StateManager {
         private model;
+        private activeModelName;
+        private schema;
         /**
          * Initializes the state manager with an optional initial payload.
          * @param initialData The initial JSON payload to populate the fields.
+         * @param schema The normalized schema for live validation.
+         * @param modelName The UI5 model alias used for isolation.
          */
-        constructor(initialData?: Record<string, any>);
+        constructor(initialData: Record<string, any>, schema: ISchema, modelName?: string);
+        /**
+         * Validates a specific path against the schema and updates the MessageManager.
+         */
+        private validatePath;
+        private findMetadataForPath;
         /**
          * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.
          * @returns The internal JSONModel.
@@ -32,6 +42,10 @@ declare module "nz/co/siliconst/ui5/metaui/core/StateManager" {
          * @returns A serialized record of the data payload, free of UI5 wrappers.
          */
         extractPayload(): Record<string, any>;
+        /**
+         * Cleans up internal state and natively destroys the UI5 JSONModel to prevent memory leaks.
+         */
+        destroy(): void;
     }
 }
 //# sourceMappingURL=StateManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"StateManager.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/StateManager.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,8CAA8C,CAAC;IAC9D;;;OAGG;IAEH,OAAO,SAAS,MAAM,6BAA6B,CAAC;IACpD,OAAO,aAAa,MAAM,2BAA2B,CAAC;IAEtD;;OAEG;IACH,MAAa,YAAY;QACrB,OAAO,CAAC,KAAK,CAAY;QAEzB;;;WAGG;oBACS,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;QAOjD;;;WAGG;QACI,QAAQ,IAAI,SAAS;QAI5B;;;;;WAKG;QACI,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;QAOvF;;;WAGG;QACI,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;KAK/C;CAEA"}
+{"version":3,"file":"StateManager.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/StateManager.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,8CAA8C,CAAC;IAC9D;;;OAGG;IAEH,OAAO,SAAS,MAAM,6BAA6B,CAAC;IACpD,OAAO,aAAa,MAAM,2BAA2B,CAAC;IACtD,OAAO,EAAE,OAAO,EAAqB,MAAM,+CAA+C,CAAC;IAQ3F;;OAEG;IACH,MAAa,YAAY;QACrB,OAAO,CAAC,KAAK,CAAY;QACzB,OAAO,CAAC,eAAe,CAAS;QAChC,OAAO,CAAC,MAAM,CAAU;QAExB;;;;;WAKG;oBACS,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAE,MAAe;QAkB9F;;WAEG;QACH,OAAO,CAAC,YAAY;QA2DpB,OAAO,CAAC,mBAAmB;QAQ3B;;;WAGG;QACI,QAAQ,IAAI,SAAS;QAI5B;;;;;WAKG;QACI,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;QAOvF;;;WAGG;QACI,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;QAM5C;;WAEG;QACI,OAAO,IAAI,IAAI;KAMzB;CAEA"}

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

@@ -1,2 +1,2 @@
-sap.ui.define(["sap/ui/model/json/JSONModel"],function(e){"use strict";class t{constructor(t={}){const o=JSON.parse(JSON.stringify(t));this.model=new e(o);this.model.setDefaultBindingMode("TwoWay")}getModel(){return this.model}bindControl(e,t,o){e.bindProperty(t,{path:o,model:"meta"})}extractPayload(){const e=this.model.getData();return JSON.parse(JSON.stringify(e))}}var o={__esModule:true};o.StateManager=t;return o});
+sap.ui.define(["sap/ui/model/json/JSONModel","./PipelineManager","sap/ui/core/message/Message","sap/ui/core/library","sap/ui/core/Messaging"],function(e,t,s,a,i){"use strict";const r=t["GlobalPipeline"];class o{constructor(t={},s,a="meta"){this.activeModelName=a;this.schema=s;const i=JSON.parse(JSON.stringify(t));this.model=new e(i);this.model.setDefaultBindingMode("TwoWay");const r=this.model.setProperty.bind(this.model);this.model.setProperty=(e,t,s,a)=>{const i=r(e,t,s,a);this.validatePath(e,t);return i}}validatePath(e,t){const o=e.replace(/^\//,"");const n=this.findMetadataForPath(o);const d=i;const l=e.startsWith("/")?e:`/${e}`;const g=d.getMessageModel().getData();const h=g.filter(e=>{const t=e.getTarget()===l&&e.getMessageProcessor()&&e.getMessageProcessor().getId()===this.model.getId();return t});if(h.length>0){d.removeMessages(h)}if(!n)return;const c=[];const m={};if(n.required){c.push("required")}if(n.type==="string"&&n.maxLength){c.push("maxLength");m["maxLength"]={max:n.maxLength}}if(n.ui?.validators){for(const e of n.ui.validators){if(typeof e==="string"){c.push(e)}else if(e&&e.name){c.push(e.name);if(e.args!==undefined){m[e.name]=e.args}}}}if(c.length>0){const e=r.executeValidation(t,c,m);if(!e.isValid){const t=new s({message:e.errorMessage||"Invalid value.",type:a.MessageType.Error,target:l,processor:this.model});d.addMessages(t)}}}findMetadataForPath(e){if(!this.schema||!this.schema.properties)return undefined;return this.schema.properties[e]}getModel(){return this.model}bindControl(e,t,s){e.bindProperty(t,{path:s,model:"meta"})}extractPayload(){const e=this.model.getData();return JSON.parse(JSON.stringify(e))}destroy(){if(this.model){this.model.destroy()}}}var n={__esModule:true};n.StateManager=o;return n});
 //# sourceMappingURL=StateManager.js.map