@siliconst/metaui 1.4.17 → 1.4.21

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

@@ -1,2 +1,2 @@
-sap.ui.define(["../utils/Logger"],function(e){"use strict";const t=e["Logger"];class r{canHandle(e){if(e.openapi||e.swagger)return false;return true}build(e){return r.normalize(e)}static normalize(e,r){let i=e;if(typeof i==="string"){if(!i.trim()){i=null}else{try{i=JSON.parse(i)}catch(e){const r="Failed to parse schema string: "+e.message;t.error("[MetaUI SchemaNormalizer]",r);throw new Error(r)}}}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"){const r=Array.isArray(i.required)?i.required:[];e.properties=this.normalizeProperties(t,r)}else if(e.type==="array"){e.items=this.normalizePropertyMetadata(i.items||{type:"object",properties:{}},"items",false)}return e}catch(e){const r="Critical error normalizing schema object: "+e.message;t.error("[MetaUI SchemaNormalizer]",r);throw new Error(r)}}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,t=[]){const r={};for(const i of Object.keys(e)){const a=t.includes(i);r[i]=this.normalizePropertyMetadata(e[i],i,a)}return r}static normalizePropertyMetadata(e,t,r=false){const i={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,dialogButtonText:e.ui?.dialogButtonText},required:r||!!e.required,maxLength:e.maxLength,minLength:e.minLength,minimum:e.minimum,maximum:e.maximum,pattern:e.pattern,precision:e.precision,scale:e.scale,multipleOf:e.multipleOf,valueHelp:e.valueHelp,enum:e.enum};if(i.type==="object"&&e.properties){const t=Array.isArray(e.required)?e.required:[];i.properties=this.normalizeProperties(e.properties,t);i.uiLayout=e.uiLayout}else if(i.type==="array"&&e.items){i.items=this.normalizePropertyMetadata(e.items,"items",false);i.uiLayout=e.uiLayout}return i}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";if(e.length>0&&typeof e[0]!=="object"){t.layoutStrategy="compact";t.items={type:typeof e[0]}}else{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;let a="string";let o;let s;if(typeof i==="number")a="number";else if(typeof i==="boolean")a="boolean";else if(Array.isArray(i)){a="array";if(i.length>0&&typeof i[0]!=="object"){o={type:typeof i[0]}}else{o={type:"object",properties:i.length>0?this.inferPropertiesFromObject(i[0]):{}}}}else if(typeof i==="object"){a="object";s=this.inferPropertiesFromObject(i)}t[r]={type:a,items:o,properties:s,ui:{label:this.generateLabel(r),isKey:false,readOnly:false,widget:a==="array"&&o?.type!=="object"?"multiInput":undefined}}}return t}static resolveScope(e,r){if(!r||!r.startsWith("#/properties/")){return{meta:undefined,bindingPath:r||"",propKey:r||""}}const i=r.replace("#/properties/","").split("/properties/");let a=e.properties;let o;t.debug("[MetaUI SchemaNormalizer]",`Resolving scope '${r}' with segments: ${JSON.stringify(i)}`,"SchemaNormalizer");t.debug("[MetaUI SchemaNormalizer]",`Root schema keys: ${Object.keys(e.properties||{})}`,"SchemaNormalizer");for(let e=0;e<i.length;e++){const r=i[e];if(!a){t.debug("[MetaUI SchemaNormalizer]",`current is undefined at segment '${r}'`,"SchemaNormalizer");o=undefined;break}o=a[r];t.debug("[MetaUI SchemaNormalizer]",`Segment '${r}' resolved to meta: ${!!o}. Available keys in current: ${Object.keys(a)}`,"SchemaNormalizer");if(e<i.length-1){a=o?.properties}}const s=i.join("/");const n=r.replace("#/properties/","");return{meta:o,bindingPath:s,propKey:n}}}var i={__esModule:true};i.SchemaNormalizer=r;return i});
+sap.ui.define(["../utils/Logger"],function(e){"use strict";const t=e["Logger"];class r{canHandle(e){return true}build(e,t){return r.normalize(e)}static normalize(e,r){let i=e;if(typeof i==="string"){if(!i.trim()){i=null}else{try{i=JSON.parse(i)}catch(e){const r="Failed to parse schema string: "+e.message;t.error("[MetaUI SchemaNormalizer]",r);throw new Error(r)}}}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"){const r=Array.isArray(i.required)?i.required:[];e.properties=this.normalizeProperties(t,r)}else if(e.type==="array"){e.items=this.normalizePropertyMetadata(i.items||{type:"object",properties:{}},"items",false)}return e}catch(e){const r="Critical error normalizing schema object: "+e.message;t.error("[MetaUI SchemaNormalizer]",r);throw new Error(r)}}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,t=[]){const r={};for(const i of Object.keys(e)){const a=t.includes(i);r[i]=this.normalizePropertyMetadata(e[i],i,a)}return r}static normalizePropertyMetadata(e,t,r=false){const i={type:e.type||"string",$ref:e.$ref,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,dialogButtonText:e.ui?.dialogButtonText},required:r||!!e.required,maxLength:e.maxLength,minLength:e.minLength,minimum:e.minimum,maximum:e.maximum,pattern:e.pattern,precision:e.precision,scale:e.scale,multipleOf:e.multipleOf,valueHelp:e.valueHelp,enum:e.enum};if(i.type==="object"&&e.properties){const t=Array.isArray(e.required)?e.required:[];i.properties=this.normalizeProperties(e.properties,t);i.uiLayout=e.uiLayout}else if(i.type==="array"&&e.items){i.items=this.normalizePropertyMetadata(e.items,"items",false);i.uiLayout=e.uiLayout}return i}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";if(e.length>0&&typeof e[0]!=="object"){t.layoutStrategy="compact";t.items={type:typeof e[0]}}else{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;let a="string";let o;let s;if(typeof i==="number")a="number";else if(typeof i==="boolean")a="boolean";else if(Array.isArray(i)){a="array";if(i.length>0&&typeof i[0]!=="object"){o={type:typeof i[0]}}else{o={type:"object",properties:i.length>0?this.inferPropertiesFromObject(i[0]):{}}}}else if(typeof i==="object"){a="object";s=this.inferPropertiesFromObject(i)}t[r]={type:a,items:o,properties:s,ui:{label:this.generateLabel(r),isKey:false,readOnly:false,widget:a==="array"&&o?.type!=="object"?"multiInput":undefined}}}return t}static resolveScope(e,r){if(!r||!r.startsWith("#/properties/")){return{meta:undefined,bindingPath:r||"",propKey:r||""}}const i=r.replace("#/properties/","").split("/properties/");let a=e.properties;let o;t.debug("[MetaUI SchemaNormalizer]",`Resolving scope '${r}' with segments: ${JSON.stringify(i)}`,"SchemaNormalizer");t.debug("[MetaUI SchemaNormalizer]",`Root schema keys: ${Object.keys(e.properties||{})}`,"SchemaNormalizer");for(let e=0;e<i.length;e++){const r=i[e];if(!a){t.debug("[MetaUI SchemaNormalizer]",`current is undefined at segment '${r}'`,"SchemaNormalizer");o=undefined;break}o=a[r];t.debug("[MetaUI SchemaNormalizer]",`Segment '${r}' resolved to meta: ${!!o}. Available keys in current: ${Object.keys(a)}`,"SchemaNormalizer");if(e<i.length-1){a=o?.properties}}const s=i.join("/");const n=r.replace("#/properties/","");return{meta:o,bindingPath:s,propKey:n}}}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":["Logger","___utils_Logger","SchemaNormalizer","canHandle","rawSchema","openapi","swagger","build","normalize","data","schemaObj","trim","JSON","parse","e","msg","message","error","Error","Array","isArray","this","inferSchemaFromData","normalized","title","type","items","layoutStrategy","uiLayout","additionalProperties","targetProperties","properties","inferred","deepMergeProperties","requiredKeys","required","normalizeProperties","normalizePropertyMetadata","base","override","merged","key","Object","keys","overrideVal","baseVal","normalizedProps","isRequired","includes","prop","keyName","ui","label","generateLabel","isKey","readOnly","widget","valueHelp","enum","undefined","visibleOn","enabledOn","format","validators","formatter","args","rows","fullWidth","dialogButtonText","maxLength","minLength","minimum","maximum","pattern","precision","scale","multipleOf","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","schema","inferPropertiesFromObject","obj","val","nestedProps","resolveScope","scope","startsWith","meta","bindingPath","propKey","pathSegments","current","debug","stringify","i","segment","__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 { ISchemaBuilderPlugin } from \"../interfaces/ISchemaBuilderPlugin\";\nimport { Logger } from \"../utils/Logger\";\n\nexport class SchemaNormalizer implements ISchemaBuilderPlugin {\n\n    /**\n     * ISchemaBuilderPlugin Contract\n     */\n    public canHandle(rawSchema: any): boolean {\n        // MetaUI native schemas almost always have properties, items, or a layoutStrategy\n        // This acts as a fallback for native schemas.\n        if (rawSchema.openapi || rawSchema.swagger) return false; \n        return true;\n    }\n\n    /**\n     * ISchemaBuilderPlugin Contract\n     */\n    public build(rawSchema: any): ISchema {\n        return SchemaNormalizer.normalize(rawSchema);\n    }\n\n    /**\n     * Validates that the provided raw payload conforms to the required ISchema structures.\n     */\n    public static normalize(rawSchema?: unknown, data?: unknown): ISchema {\n        let schemaObj = rawSchema;\n\n        if (typeof schemaObj === \"string\") {\n            if (!schemaObj.trim()) {\n                schemaObj = null;\n            } else {\n                try {\n                    schemaObj = JSON.parse(schemaObj);\n                } catch (e) {\n                    const msg = \"Failed to parse schema string: \" + (e as Error).message;\n                    Logger.error(\"[MetaUI SchemaNormalizer]\", msg);\n                    throw new Error(msg);\n                }\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                const requiredKeys = Array.isArray(schemaObj.required) ? schemaObj.required : [];\n                normalized.properties = this.normalizeProperties(targetProperties, requiredKeys);\n            } else if (normalized.type === \"array\") {\n                // Future expansion: array deep merge\n                normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: \"object\", properties: {} }, \"items\", false);\n            }\n\n            return normalized;\n        } catch (error) {\n            const msg = \"Critical error normalizing schema object: \" + (error as Error).message;\n            Logger.error(\"[MetaUI SchemaNormalizer]\", msg);\n            throw new Error(msg);\n        }\n    }\n\n    /**\n     * Recursively deep merges an inferred schema over a base schema.\n     * @param base The base property dictionary.\n     * @param override The overriding inferred dictionary.\n     * @returns A new deeply merged property dictionary.\n     */\n    private static deepMergeProperties(base: Record<string, unknown>, override: Record<string, unknown>): Record<string, unknown> {\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    /**\n     * Normalizes a collection of properties.\n     * @param properties The raw properties map.\n     * @param requiredKeys An optional array of keys that are required by the parent object.\n     * @returns A map of strict IPropertyMetadata objects.\n     */\n    private static normalizeProperties(properties: Record<string, unknown>, requiredKeys: string[] = []): Record<string, IPropertyMetadata> {\n        const normalizedProps: Record<string, IPropertyMetadata> = {};\n        for (const key of Object.keys(properties)) {\n            const isRequired = requiredKeys.includes(key);\n            normalizedProps[key] = this.normalizePropertyMetadata(properties[key], key, isRequired);\n        }\n        return normalizedProps;\n    }\n\n    /**\n     * Normalizes a single property against the ISchema specification.\n     * @param prop The raw property definition.\n     * @param keyName The string key name for generating default labels.\n     * @param isRequired Indicates if the parent object mandated this property as required.\n     * @returns A strict IPropertyMetadata instance.\n     */\n    private static normalizePropertyMetadata(prop: Record<string, unknown>, keyName: string, isRequired: boolean = false): 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                dialogButtonText: prop.ui?.dialogButtonText\n            },\n            required: isRequired || !!prop.required,\n            maxLength: prop.maxLength as number,\n            minLength: prop.minLength as number,\n            minimum: prop.minimum,\n            maximum: prop.maximum,\n            pattern: prop.pattern,\n            precision: prop.precision,\n            scale: prop.scale,\n            multipleOf: prop.multipleOf as number,\n            valueHelp: prop.valueHelp,\n            enum: prop.enum\n        };\n\n        if (normalized.type === \"object\" && prop.properties) {\n            const requiredKeys = Array.isArray(prop.required) ? prop.required : [];\n            normalized.properties = this.normalizeProperties(prop.properties as Record<string, unknown>, requiredKeys);\n            normalized.uiLayout = prop.uiLayout;\n        } else if (normalized.type === \"array\" && prop.items) {\n            normalized.items = this.normalizePropertyMetadata(prop.items as Record<string, unknown>, \"items\", false);\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    public static inferSchemaFromData(data: unknown): 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            if (data.length > 0 && typeof data[0] !== \"object\") {\n                schema.layoutStrategy = \"compact\";\n                schema.items = { type: typeof data[0] as FieldType };\n            } else {\n                schema.layoutStrategy = \"table\";\n                schema.items = {\n                    type: \"object\",\n                    layoutStrategy: \"compact\",\n                    properties: data.length > 0 ? this.inferPropertiesFromObject(data[0] as Record<string, unknown>) : {}\n                };\n            }\n        } else {\n            schema.type = \"object\";\n            schema.properties = this.inferPropertiesFromObject(data);\n        }\n\n        return schema;\n    }\n\n    /**\n     * Infers field metadata recursively from a raw data object.\n     * @param obj The raw JavaScript object.\n     * @returns A dictionary of inferred IPropertyMetadata.\n     */\n    private static inferPropertiesFromObject(obj: Record<string, unknown>): 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            let type: FieldType = \"string\";\n            let items: IPropertyMetadata | undefined;\n            let nestedProps: Record<string, 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                if (val.length > 0 && typeof val[0] !== \"object\") {\n                    items = {\n                        type: typeof val[0] as FieldType\n                    };\n                } else {\n                    items = {\n                        type: \"object\",\n                        properties: val.length > 0 ? this.inferPropertiesFromObject(val[0] as Record<string, unknown>) : {}\n                    };\n                }\n            } else if (typeof val === \"object\") {\n                type = \"object\";\n                nestedProps = this.inferPropertiesFromObject(val);\n            }\n\n            properties[key] = {\n                type,\n                items,\n                properties: nestedProps,\n                ui: {\n                    label: this.generateLabel(key),\n                    isKey: false,\n                    readOnly: false,\n                    widget: type === \"array\" && items?.type !== \"object\" ? \"multiInput\" : undefined\n                }\n            };\n        }\n\n        return properties;\n    }\n\n    /**\n     * Resolves a JSON Schema scope (e.g. '#/properties/header/properties/id')\n     * against the ISchema, returning the PropertyMetadata and the UI5 binding path.\n     */\n    public static resolveScope(schema: ISchema, scope: string): { meta: IPropertyMetadata | undefined, bindingPath: string, propKey: string } {\n        if (!scope || !scope.startsWith(\"#/properties/\")) {\n            return { meta: undefined, bindingPath: scope || \"\", propKey: scope || \"\" };\n        }\n        \n        const pathSegments = scope.replace(\"#/properties/\", \"\").split(\"/properties/\");\n        let current: Record<string, IPropertyMetadata> | undefined = schema.properties;\n        let meta: IPropertyMetadata | undefined;\n        \n        Logger.debug(\"[MetaUI SchemaNormalizer]\", `Resolving scope '${scope}' with segments: ${JSON.stringify(pathSegments)}`, \"SchemaNormalizer\");\n        Logger.debug(\"[MetaUI SchemaNormalizer]\", `Root schema keys: ${Object.keys(schema.properties || {})}`, \"SchemaNormalizer\");\n\n        for (let i = 0; i < pathSegments.length; i++) {\n            const segment = pathSegments[i];\n            if (!current) {\n                Logger.debug(\"[MetaUI SchemaNormalizer]\", `current is undefined at segment '${segment}'`, \"SchemaNormalizer\");\n                meta = undefined;\n                break;\n            }\n            meta = current[segment];\n            Logger.debug(\"[MetaUI SchemaNormalizer]\", `Segment '${segment}' resolved to meta: ${!!meta}. Available keys in current: ${Object.keys(current)}`, \"SchemaNormalizer\");\n            if (i < pathSegments.length - 1) {\n                current = meta?.properties;\n            }\n        }\n        \n        const bindingPath = pathSegments.join(\"/\");\n        const propKey = scope.replace(\"#/properties/\", \"\"); // The original raw string for logging\n        \n        return {\n            meta,\n            bindingPath,\n            propKey\n        };\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"SchemaNormalizer.js","names":["Logger","___utils_Logger","SchemaNormalizer","canHandle","rawSchema","build","targetDefinition","normalize","data","schemaObj","trim","JSON","parse","e","msg","message","error","Error","Array","isArray","this","inferSchemaFromData","normalized","title","type","items","layoutStrategy","uiLayout","additionalProperties","targetProperties","properties","inferred","deepMergeProperties","requiredKeys","required","normalizeProperties","normalizePropertyMetadata","base","override","merged","key","Object","keys","overrideVal","baseVal","normalizedProps","isRequired","includes","prop","keyName","$ref","ui","label","generateLabel","isKey","readOnly","widget","valueHelp","enum","undefined","visibleOn","enabledOn","format","validators","formatter","args","rows","fullWidth","dialogButtonText","maxLength","minLength","minimum","maximum","pattern","precision","scale","multipleOf","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","schema","inferPropertiesFromObject","obj","val","nestedProps","resolveScope","scope","startsWith","meta","bindingPath","propKey","pathSegments","current","debug","stringify","i","segment","__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 { ISchemaBuilderPlugin } from \"../interfaces/ISchemaBuilderPlugin\";\nimport { Logger } from \"../utils/Logger\";\n\nexport class SchemaNormalizer implements ISchemaBuilderPlugin {\n\n    /**\n     * ISchemaBuilderPlugin Contract\n     */\n    public canHandle(rawSchema: unknown): boolean {\n        // Fallback for native ISchemas or data inference.\n        // It always returns true because it is the final fallback builder in the registry.\n        return true;\n    }\n\n    /**\n     * ISchemaBuilderPlugin Contract\n     */\n    public build(rawSchema: unknown, targetDefinition?: string): ISchema {\n        return SchemaNormalizer.normalize(rawSchema);\n    }\n\n    /**\n     * Validates that the provided raw payload conforms to the required ISchema structures.\n     */\n    public static normalize(rawSchema?: unknown, data?: unknown): ISchema {\n        let schemaObj = rawSchema;\n\n        if (typeof schemaObj === \"string\") {\n            if (!schemaObj.trim()) {\n                schemaObj = null;\n            } else {\n                try {\n                    schemaObj = JSON.parse(schemaObj);\n                } catch (e) {\n                    const msg = \"Failed to parse schema string: \" + (e as Error).message;\n                    Logger.error(\"[MetaUI SchemaNormalizer]\", msg);\n                    throw new Error(msg);\n                }\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                const requiredKeys = Array.isArray(schemaObj.required) ? schemaObj.required : [];\n                normalized.properties = this.normalizeProperties(targetProperties, requiredKeys);\n            } else if (normalized.type === \"array\") {\n                // Future expansion: array deep merge\n                normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: \"object\", properties: {} }, \"items\", false);\n            }\n\n            return normalized;\n        } catch (error) {\n            const msg = \"Critical error normalizing schema object: \" + (error as Error).message;\n            Logger.error(\"[MetaUI SchemaNormalizer]\", msg);\n            throw new Error(msg);\n        }\n    }\n\n    /**\n     * Recursively deep merges an inferred schema over a base schema.\n     * @param base The base property dictionary.\n     * @param override The overriding inferred dictionary.\n     * @returns A new deeply merged property dictionary.\n     */\n    private static deepMergeProperties(base: Record<string, unknown>, override: Record<string, unknown>): Record<string, unknown> {\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    /**\n     * Normalizes a collection of properties.\n     * @param properties The raw properties map.\n     * @param requiredKeys An optional array of keys that are required by the parent object.\n     * @returns A map of strict IPropertyMetadata objects.\n     */\n    private static normalizeProperties(properties: Record<string, unknown>, requiredKeys: string[] = []): Record<string, IPropertyMetadata> {\n        const normalizedProps: Record<string, IPropertyMetadata> = {};\n        for (const key of Object.keys(properties)) {\n            const isRequired = requiredKeys.includes(key);\n            normalizedProps[key] = this.normalizePropertyMetadata(properties[key], key, isRequired);\n        }\n        return normalizedProps;\n    }\n\n    /**\n     * Normalizes a single property against the ISchema specification.\n     * @param prop The raw property definition.\n     * @param keyName The string key name for generating default labels.\n     * @param isRequired Indicates if the parent object mandated this property as required.\n     * @returns A strict IPropertyMetadata instance.\n     */\n    private static normalizePropertyMetadata(prop: Record<string, unknown>, keyName: string, isRequired: boolean = false): IPropertyMetadata {\n        const normalized: IPropertyMetadata = {\n            type: (prop.type as FieldType) || \"string\",\n            $ref: prop.$ref as string | undefined,\n            ui: {\n                label: (prop.ui as any)?.label || this.generateLabel(keyName),\n                isKey: !!(prop.ui as any)?.isKey,\n                readOnly: !!(prop.ui as any)?.readOnly,\n                widget: (prop.ui as any)?.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                dialogButtonText: prop.ui?.dialogButtonText\n            },\n            required: isRequired || !!prop.required,\n            maxLength: prop.maxLength as number,\n            minLength: prop.minLength as number,\n            minimum: prop.minimum,\n            maximum: prop.maximum,\n            pattern: prop.pattern,\n            precision: prop.precision,\n            scale: prop.scale,\n            multipleOf: prop.multipleOf as number,\n            valueHelp: prop.valueHelp,\n            enum: prop.enum\n        };\n\n        if (normalized.type === \"object\" && prop.properties) {\n            const requiredKeys = Array.isArray(prop.required) ? prop.required : [];\n            normalized.properties = this.normalizeProperties(prop.properties as Record<string, unknown>, requiredKeys);\n            normalized.uiLayout = prop.uiLayout;\n        } else if (normalized.type === \"array\" && prop.items) {\n            normalized.items = this.normalizePropertyMetadata(prop.items as Record<string, unknown>, \"items\", false);\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    public static inferSchemaFromData(data: unknown): 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            if (data.length > 0 && typeof data[0] !== \"object\") {\n                schema.layoutStrategy = \"compact\";\n                schema.items = { type: typeof data[0] as FieldType };\n            } else {\n                schema.layoutStrategy = \"table\";\n                schema.items = {\n                    type: \"object\",\n                    layoutStrategy: \"compact\",\n                    properties: data.length > 0 ? this.inferPropertiesFromObject(data[0] as Record<string, unknown>) : {}\n                };\n            }\n        } else {\n            schema.type = \"object\";\n            schema.properties = this.inferPropertiesFromObject(data);\n        }\n\n        return schema;\n    }\n\n    /**\n     * Infers field metadata recursively from a raw data object.\n     * @param obj The raw JavaScript object.\n     * @returns A dictionary of inferred IPropertyMetadata.\n     */\n    private static inferPropertiesFromObject(obj: Record<string, unknown>): 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            let type: FieldType = \"string\";\n            let items: IPropertyMetadata | undefined;\n            let nestedProps: Record<string, 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                if (val.length > 0 && typeof val[0] !== \"object\") {\n                    items = {\n                        type: typeof val[0] as FieldType\n                    };\n                } else {\n                    items = {\n                        type: \"object\",\n                        properties: val.length > 0 ? this.inferPropertiesFromObject(val[0] as Record<string, unknown>) : {}\n                    };\n                }\n            } else if (typeof val === \"object\") {\n                type = \"object\";\n                nestedProps = this.inferPropertiesFromObject(val);\n            }\n\n            properties[key] = {\n                type,\n                items,\n                properties: nestedProps,\n                ui: {\n                    label: this.generateLabel(key),\n                    isKey: false,\n                    readOnly: false,\n                    widget: type === \"array\" && items?.type !== \"object\" ? \"multiInput\" : undefined\n                }\n            };\n        }\n\n        return properties;\n    }\n\n    /**\n     * Resolves a JSON Schema scope (e.g. '#/properties/header/properties/id')\n     * against the ISchema, returning the PropertyMetadata and the UI5 binding path.\n     */\n    public static resolveScope(schema: ISchema, scope: string): { meta: IPropertyMetadata | undefined, bindingPath: string, propKey: string } {\n        if (!scope || !scope.startsWith(\"#/properties/\")) {\n            return { meta: undefined, bindingPath: scope || \"\", propKey: scope || \"\" };\n        }\n        \n        const pathSegments = scope.replace(\"#/properties/\", \"\").split(\"/properties/\");\n        let current: Record<string, IPropertyMetadata> | undefined = schema.properties;\n        let meta: IPropertyMetadata | undefined;\n        \n        Logger.debug(\"[MetaUI SchemaNormalizer]\", `Resolving scope '${scope}' with segments: ${JSON.stringify(pathSegments)}`, \"SchemaNormalizer\");\n        Logger.debug(\"[MetaUI SchemaNormalizer]\", `Root schema keys: ${Object.keys(schema.properties || {})}`, \"SchemaNormalizer\");\n\n        for (let i = 0; i < pathSegments.length; i++) {\n            const segment = pathSegments[i];\n            if (!current) {\n                Logger.debug(\"[MetaUI SchemaNormalizer]\", `current is undefined at segment '${segment}'`, \"SchemaNormalizer\");\n                meta = undefined;\n                break;\n            }\n            meta = current[segment];\n            Logger.debug(\"[MetaUI SchemaNormalizer]\", `Segment '${segment}' resolved to meta: ${!!meta}. Available keys in current: ${Object.keys(current)}`, \"SchemaNormalizer\");\n            if (i < pathSegments.length - 1) {\n                current = meta?.properties;\n            }\n        }\n        \n        const bindingPath = pathSegments.join(\"/\");\n        const propKey = scope.replace(\"#/properties/\", \"\"); // The original raw string for logging\n        \n        return {\n            meta,\n            bindingPath,\n            propKey\n        };\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -12,17 +12,16 @@ export class SchemaNormalizer implements ISchemaBuilderPlugin {
     /**
      * ISchemaBuilderPlugin Contract
      */
-    public canHandle(rawSchema: any): boolean {
-        // MetaUI native schemas almost always have properties, items, or a layoutStrategy
-        // This acts as a fallback for native schemas.
-        if (rawSchema.openapi || rawSchema.swagger) return false; 
+    public canHandle(rawSchema: unknown): boolean {
+        // Fallback for native ISchemas or data inference.
+        // It always returns true because it is the final fallback builder in the registry.
         return true;
     }
 
     /**
      * ISchemaBuilderPlugin Contract
      */
-    public build(rawSchema: any): ISchema {
+    public build(rawSchema: unknown, targetDefinition?: string): ISchema {
         return SchemaNormalizer.normalize(rawSchema);
     }
 
@@ -133,12 +132,13 @@ export class SchemaNormalizer implements ISchemaBuilderPlugin {
      */
     private static normalizePropertyMetadata(prop: Record<string, unknown>, keyName: string, isRequired: boolean = false): IPropertyMetadata {
         const normalized: IPropertyMetadata = {
-            type: prop.type || "string",
+            type: (prop.type as FieldType) || "string",
+            $ref: prop.$ref as string | undefined,
             ui: {
-                label: prop.ui?.label || this.generateLabel(keyName),
-                isKey: !!prop.ui?.isKey,
-                readOnly: !!prop.ui?.readOnly,
-                widget: prop.ui?.widget || (prop.valueHelp || prop.enum ? "select" : undefined),
+                label: (prop.ui as any)?.label || this.generateLabel(keyName),
+                isKey: !!(prop.ui as any)?.isKey,
+                readOnly: !!(prop.ui as any)?.readOnly,
+                widget: (prop.ui as any)?.widget || (prop.valueHelp || prop.enum ? "select" : undefined),
                 visibleOn: prop.ui?.visibleOn,
                 enabledOn: prop.ui?.enabledOn,
                 format: prop.ui?.format,

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

@@ -34,7 +34,7 @@ sap.ui.define([], function () {
           if (!prop.type) {
             errors.push(`Property '${key}' is missing 'type'.`);
           } else {
-            const allowedTypes = ["string", "number", "boolean", "date", "object", "array"];
+            const allowedTypes = ["string", "number", "integer", "boolean", "date", "object", "array"];
             if (!allowedTypes.includes(prop.type)) {
               errors.push(`Property '${key}' has invalid type '${prop.type}'. Allowed: ${allowedTypes.join(", ")}`);
             }

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

@@ -1 +1 @@
-{"version":3,"file":"SchemaValidator-dbg.js","names":["SchemaValidator","validateSchemaStructure","schema","errors","s","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: unknown): string[] {\n        const errors: string[] = [];\n\n        if (!schema || typeof schema !== \"object\") {\n            return [\"Root schema must be an object.\"];\n        }\n\n        const s = schema as Record<string, any>;\n        if (s.type !== \"object\" && s.type !== \"array\") {\n            errors.push(`Root schema must have type 'object' or 'array'. Found: '${s.type}'`);\n        }\n\n        if (s.type === \"object\" && !s.properties) {\n            errors.push(\"Object schema is missing the 'properties' node.\");\n        }\n\n        if (s.properties) {\n            for (const key of Object.keys(s.properties)) {\n                const prop = s.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,MAAe,EAAY;MAC7D,MAAMC,MAAgB,GAAG,EAAE;MAE3B,IAAI,CAACD,MAAM,IAAI,OAAOA,MAAM,KAAK,QAAQ,EAAE;QACvC,OAAO,CAAC,gCAAgC,CAAC;MAC7C;MAEA,MAAME,CAAC,GAAGF,MAA6B;MACvC,IAAIE,CAAC,CAACC,IAAI,KAAK,QAAQ,IAAID,CAAC,CAACC,IAAI,KAAK,OAAO,EAAE;QAC3CF,MAAM,CAACG,IAAI,CAAC,2DAA2DF,CAAC,CAACC,IAAI,GAAG,CAAC;MACrF;MAEA,IAAID,CAAC,CAACC,IAAI,KAAK,QAAQ,IAAI,CAACD,CAAC,CAACG,UAAU,EAAE;QACtCJ,MAAM,CAACG,IAAI,CAAC,iDAAiD,CAAC;MAClE;MAEA,IAAIF,CAAC,CAACG,UAAU,EAAE;QACd,KAAK,MAAMC,GAAG,IAAIC,MAAM,CAACC,IAAI,CAACN,CAAC,CAACG,UAAU,CAAC,EAAE;UACzC,MAAMI,IAAI,GAAGP,CAAC,CAACG,UAAU,CAACC,GAAG,CAAC;UAC9B,IAAI,CAACG,IAAI,IAAI,OAAOA,IAAI,KAAK,QAAQ,EAAE;YACnCR,MAAM,CAACG,IAAI,CAAC,aAAaE,GAAG,sBAAsB,CAAC;YACnD;UACJ;UAEA,IAAI,CAACG,IAAI,CAACN,IAAI,EAAE;YACZF,MAAM,CAACG,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;cACnCF,MAAM,CAACG,IAAI,CAAC,aAAaE,GAAG,uBAAuBG,IAAI,CAACN,IAAI,eAAeO,YAAY,CAACE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzG;UACJ;;UAEA;QAEJ;MACJ;MAEA,OAAOX,MAAM;IACjB;EACJ;EAAC,IAAAY,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAf,eAAA,GAAAA,eAAA;EAAA,OAAAe,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"SchemaValidator-dbg.js","names":["SchemaValidator","validateSchemaStructure","schema","errors","s","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: unknown): string[] {\n        const errors: string[] = [];\n\n        if (!schema || typeof schema !== \"object\") {\n            return [\"Root schema must be an object.\"];\n        }\n\n        const s = schema as Record<string, any>;\n        if (s.type !== \"object\" && s.type !== \"array\") {\n            errors.push(`Root schema must have type 'object' or 'array'. Found: '${s.type}'`);\n        }\n\n        if (s.type === \"object\" && !s.properties) {\n            errors.push(\"Object schema is missing the 'properties' node.\");\n        }\n\n        if (s.properties) {\n            for (const key of Object.keys(s.properties)) {\n                const prop = s.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\", \"integer\", \"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,MAAe,EAAY;MAC7D,MAAMC,MAAgB,GAAG,EAAE;MAE3B,IAAI,CAACD,MAAM,IAAI,OAAOA,MAAM,KAAK,QAAQ,EAAE;QACvC,OAAO,CAAC,gCAAgC,CAAC;MAC7C;MAEA,MAAME,CAAC,GAAGF,MAA6B;MACvC,IAAIE,CAAC,CAACC,IAAI,KAAK,QAAQ,IAAID,CAAC,CAACC,IAAI,KAAK,OAAO,EAAE;QAC3CF,MAAM,CAACG,IAAI,CAAC,2DAA2DF,CAAC,CAACC,IAAI,GAAG,CAAC;MACrF;MAEA,IAAID,CAAC,CAACC,IAAI,KAAK,QAAQ,IAAI,CAACD,CAAC,CAACG,UAAU,EAAE;QACtCJ,MAAM,CAACG,IAAI,CAAC,iDAAiD,CAAC;MAClE;MAEA,IAAIF,CAAC,CAACG,UAAU,EAAE;QACd,KAAK,MAAMC,GAAG,IAAIC,MAAM,CAACC,IAAI,CAACN,CAAC,CAACG,UAAU,CAAC,EAAE;UACzC,MAAMI,IAAI,GAAGP,CAAC,CAACG,UAAU,CAACC,GAAG,CAAC;UAC9B,IAAI,CAACG,IAAI,IAAI,OAAOA,IAAI,KAAK,QAAQ,EAAE;YACnCR,MAAM,CAACG,IAAI,CAAC,aAAaE,GAAG,sBAAsB,CAAC;YACnD;UACJ;UAEA,IAAI,CAACG,IAAI,CAACN,IAAI,EAAE;YACZF,MAAM,CAACG,IAAI,CAAC,aAAaE,GAAG,sBAAsB,CAAC;UACvD,CAAC,MAAM;YACH,MAAMI,YAAyB,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC;YACvG,IAAI,CAACA,YAAY,CAACC,QAAQ,CAACF,IAAI,CAACN,IAAI,CAAC,EAAE;cACnCF,MAAM,CAACG,IAAI,CAAC,aAAaE,GAAG,uBAAuBG,IAAI,CAACN,IAAI,eAAeO,YAAY,CAACE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzG;UACJ;;UAEA;QAEJ;MACJ;MAEA,OAAOX,MAAM;IACjB;EACJ;EAAC,IAAAY,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAf,eAAA,GAAAA,eAAA;EAAA,OAAAe,SAAA;AAAA","ignoreList":[]}

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

@@ -1,2 +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."]}const o=e;if(o.type!=="object"&&o.type!=="array"){t.push(`Root schema must have type 'object' or 'array'. Found: '${o.type}'`)}if(o.type==="object"&&!o.properties){t.push("Object schema is missing the 'properties' node.")}if(o.properties){for(const e of Object.keys(o.properties)){const s=o.properties[e];if(!s||typeof s!=="object"){t.push(`Property '${e}' must be an object.`);continue}if(!s.type){t.push(`Property '${e}' is missing 'type'.`)}else{const o=["string","number","boolean","date","object","array"];if(!o.includes(s.type)){t.push(`Property '${e}' has invalid type '${s.type}'. Allowed: ${o.join(", ")}`)}}}}return t}}var t={__esModule:true};t.SchemaValidator=e;return t});
+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."]}const o=e;if(o.type!=="object"&&o.type!=="array"){t.push(`Root schema must have type 'object' or 'array'. Found: '${o.type}'`)}if(o.type==="object"&&!o.properties){t.push("Object schema is missing the 'properties' node.")}if(o.properties){for(const e of Object.keys(o.properties)){const r=o.properties[e];if(!r||typeof r!=="object"){t.push(`Property '${e}' must be an object.`);continue}if(!r.type){t.push(`Property '${e}' is missing 'type'.`)}else{const o=["string","number","integer","boolean","date","object","array"];if(!o.includes(r.type)){t.push(`Property '${e}' has invalid type '${r.type}'. Allowed: ${o.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

@@ -1 +1 @@
-{"version":3,"file":"SchemaValidator.js","names":["SchemaValidator","validateSchemaStructure","schema","errors","s","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: unknown): string[] {\n        const errors: string[] = [];\n\n        if (!schema || typeof schema !== \"object\") {\n            return [\"Root schema must be an object.\"];\n        }\n\n        const s = schema as Record<string, any>;\n        if (s.type !== \"object\" && s.type !== \"array\") {\n            errors.push(`Root schema must have type 'object' or 'array'. Found: '${s.type}'`);\n        }\n\n        if (s.type === \"object\" && !s.properties) {\n            errors.push(\"Object schema is missing the 'properties' node.\");\n        }\n\n        if (s.properties) {\n            for (const key of Object.keys(s.properties)) {\n                const prop = s.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,MAAME,EAAIF,EACV,GAAIE,EAAEC,OAAS,UAAYD,EAAEC,OAAS,QAAS,CAC3CF,EAAOG,KAAK,2DAA2DF,EAAEC,QAC7E,CAEA,GAAID,EAAEC,OAAS,WAAaD,EAAEG,WAAY,CACtCJ,EAAOG,KAAK,kDAChB,CAEA,GAAIF,EAAEG,WAAY,CACd,IAAK,MAAMC,KAAOC,OAAOC,KAAKN,EAAEG,YAAa,CACzC,MAAMI,EAAOP,EAAEG,WAAWC,GAC1B,IAAKG,UAAeA,IAAS,SAAU,CACnCR,EAAOG,KAAK,aAAaE,yBACzB,QACJ,CAEA,IAAKG,EAAKN,KAAM,CACZF,EAAOG,KAAK,aAAaE,wBAC7B,KAAO,CACH,MAAMI,EAA4B,CAAC,SAAU,SAAU,UAAW,OAAQ,SAAU,SACpF,IAAKA,EAAaC,SAASF,EAAKN,MAAO,CACnCF,EAAOG,KAAK,aAAaE,wBAA0BG,EAAKN,mBAAmBO,EAAaE,KAAK,QACjG,CACJ,CAIJ,CACJ,CAEA,OAAOX,CACX,EACH,IAAAY,EAAA,CAAAC,WAAA,MAAAD,EAAAf,kBAAA,OAAAe,CAAA","ignoreList":[]}
+{"version":3,"file":"SchemaValidator.js","names":["SchemaValidator","validateSchemaStructure","schema","errors","s","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: unknown): string[] {\n        const errors: string[] = [];\n\n        if (!schema || typeof schema !== \"object\") {\n            return [\"Root schema must be an object.\"];\n        }\n\n        const s = schema as Record<string, any>;\n        if (s.type !== \"object\" && s.type !== \"array\") {\n            errors.push(`Root schema must have type 'object' or 'array'. Found: '${s.type}'`);\n        }\n\n        if (s.type === \"object\" && !s.properties) {\n            errors.push(\"Object schema is missing the 'properties' node.\");\n        }\n\n        if (s.properties) {\n            for (const key of Object.keys(s.properties)) {\n                const prop = s.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\", \"integer\", \"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,MAAME,EAAIF,EACV,GAAIE,EAAEC,OAAS,UAAYD,EAAEC,OAAS,QAAS,CAC3CF,EAAOG,KAAK,2DAA2DF,EAAEC,QAC7E,CAEA,GAAID,EAAEC,OAAS,WAAaD,EAAEG,WAAY,CACtCJ,EAAOG,KAAK,kDAChB,CAEA,GAAIF,EAAEG,WAAY,CACd,IAAK,MAAMC,KAAOC,OAAOC,KAAKN,EAAEG,YAAa,CACzC,MAAMI,EAAOP,EAAEG,WAAWC,GAC1B,IAAKG,UAAeA,IAAS,SAAU,CACnCR,EAAOG,KAAK,aAAaE,yBACzB,QACJ,CAEA,IAAKG,EAAKN,KAAM,CACZF,EAAOG,KAAK,aAAaE,wBAC7B,KAAO,CACH,MAAMI,EAA4B,CAAC,SAAU,SAAU,UAAW,UAAW,OAAQ,SAAU,SAC/F,IAAKA,EAAaC,SAASF,EAAKN,MAAO,CACnCF,EAAOG,KAAK,aAAaE,wBAA0BG,EAAKN,mBAAmBO,EAAaE,KAAK,QACjG,CACJ,CAIJ,CACJ,CAEA,OAAOX,CACX,EACH,IAAAY,EAAA,CAAAC,WAAA,MAAAD,EAAAf,kBAAA,OAAAe,CAAA","ignoreList":[]}

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

@@ -38,7 +38,7 @@ export class SchemaValidator {
                 if (!prop.type) {
                     errors.push(`Property '${key}' is missing 'type'.`);
                 } else {
-                    const allowedTypes: FieldType[] = ["string", "number", "boolean", "date", "object", "array"];
+                    const allowedTypes: FieldType[] = ["string", "number", "integer", "boolean", "date", "object", "array"];
                     if (!allowedTypes.includes(prop.type)) {
                         errors.push(`Property '${key}' has invalid type '${prop.type}'. Allowed: ${allowedTypes.join(", ")}`);
                     }

package/src/nz/co/siliconst/ui5/metaui/interfaces/IPlugin-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"IPlugin-dbg.js","names":[],"sources":["IPlugin.ts"],"sourcesContent":["/**\n * @file IPlugin.ts\n * @description Contract for all discrete UI control generation plugins.\n * Enforces a strict lifecycle for rendering, validation, and dynamic state updates.\n */\n\nimport Control from \"sap/ui/core/Control\";\nimport { IPropertyMetadata } from \"./ISchema\";\n\nexport interface IPluginValidationResult {\n    isValid: boolean;\n    errorMessage?: string;\n    fieldKey?: string;\n}\n\nexport interface IPlugin {\n    /**\n     * Instructs the plugin whether to delegate visual error states to the global MessageManager.\n     * @param useMessageManager True if the global MessageManager is active.\n     */\n    setUseMessageManager?(useMessageManager: boolean): void;\n\n    /**\n     * Instantiates the raw UI5 control and binds it to the specified data model.\n     * \n     * @param fieldMetadata The JSON Schema defining the field's constraints and UI hints.\n     * @param bindingPath The specific JSON path representing the field within the payload.\n     * @param modelName The UI5 JSONModel alias used for data binding (defaults to 'meta').\n     * @param engineScopeId The deterministic scope ID provided by the Engine.\n     * @param onChange The callback fired natively when a field value blur/change occurs.\n     * @returns {Control} The generated UI5 control ready to be mounted.\n     */\n    render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control;\n\n    /**\n     * Triggers the internal validation pipeline for this specific plugin instance.\n     * \n     * @returns {IPluginValidationResult} The structural validity state and error messages.\n     */\n    validate(): IPluginValidationResult;\n\n    /**\n     * Executes when the ConditionEngine pushes dynamic metadata mutations to the field.\n     * \n     * @param newMetadata The mutated schema metadata.\n     */\n    onStateChange(newMetadata: IPropertyMetadata): void;\n\n    /**\n     * Optionally allows the plugin to natively manage its own UI control's visual ValueState (e.g., red borders).\n     * Used when the global MessageManager is disabled.\n     * \n     * @param isValid Whether the field passed validation.\n     * @param errorMessage The error message to display if invalid.\n     */\n    setVisualValidationState?(isValid: boolean, errorMessage?: string): void;\n\n    /**\n     * Optional lifecycle hook executed when the parent layout is destroyed.\n     * Plugins must use this to destroy isolated JSONModels, custom EventBus listeners, \n     * or embedded Dialogs to prevent memory leaks in the SAP Fiori Launchpad.\n     */\n    destroy?(): void;\n\n    /**\n     * Injects the global editable mode context into the plugin before rendering.\n     * @param editable True if the plugin should render in an editable mode.\n     */\n    setEditable?(editable: boolean): void;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"IPlugin-dbg.js","names":[],"sources":["IPlugin.ts"],"sourcesContent":["/**\n * @file IPlugin.ts\n * @description Contract for all discrete UI control generation plugins.\n * Enforces a strict lifecycle for rendering, validation, and dynamic state updates.\n */\n\nimport Control from \"sap/ui/core/Control\";\nimport { IPropertyMetadata } from \"./ISchema\";\n\nexport interface IPluginValidationResult {\n    isValid: boolean;\n    errorMessage?: string;\n    fieldKey?: string;\n}\n\nexport interface IPlugin {\n    /**\n     * Instructs the plugin whether to delegate visual error states to the global MessageManager.\n     * @param useMessageManager True if the global MessageManager is active.\n     */\n    setUseMessageManager?(useMessageManager: boolean): void;\n\n    /**\n     * Instantiates the raw UI5 control and binds it to the specified data model.\n     * \n     * @param fieldMetadata The JSON Schema defining the field's constraints and UI hints.\n     * @param bindingPath The specific JSON path representing the field within the payload.\n     * @param modelName The UI5 JSONModel alias used for data binding (defaults to 'meta').\n     * @param engineScopeId The deterministic scope ID provided by the Engine.\n     * @param onChange The callback fired natively when a field value blur/change occurs.\n     * @returns {Control} The generated UI5 control ready to be mounted.\n     */\n    render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void, model?: unknown): Control;\n\n    /**\n     * Triggers the internal validation pipeline for this specific plugin instance.\n     * \n     * @returns {IPluginValidationResult} The structural validity state and error messages.\n     */\n    validate(): IPluginValidationResult;\n\n    /**\n     * Executes when the ConditionEngine pushes dynamic metadata mutations to the field.\n     * \n     * @param newMetadata The mutated schema metadata.\n     */\n    onStateChange(newMetadata: IPropertyMetadata): void;\n\n    /**\n     * Optionally allows the plugin to natively manage its own UI control's visual ValueState (e.g., red borders).\n     * Used when the global MessageManager is disabled.\n     * \n     * @param isValid Whether the field passed validation.\n     * @param errorMessage The error message to display if invalid.\n     */\n    setVisualValidationState?(isValid: boolean, errorMessage?: string): void;\n\n    /**\n     * Optional lifecycle hook executed when the parent layout is destroyed.\n     * Plugins must use this to destroy isolated JSONModels, custom EventBus listeners, \n     * or embedded Dialogs to prevent memory leaks in the SAP Fiori Launchpad.\n     */\n    destroy?(): void;\n\n    /**\n     * Injects the global editable mode context into the plugin before rendering.\n     * @param editable True if the plugin should render in an editable mode.\n     */\n    setEditable?(editable: boolean): void;\n}\n"],"mappings":"","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/interfaces/IPlugin.d.ts

@@ -27,7 +27,7 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/IPlugin" {
          * @param onChange The callback fired natively when a field value blur/change occurs.
          * @returns {Control} The generated UI5 control ready to be mounted.
          */
-        render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control;
+        render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void, model?: unknown): Control;
         /**
          * Triggers the internal validation pipeline for this specific plugin instance.
          *

package/src/nz/co/siliconst/ui5/metaui/interfaces/IPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IPlugin.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/IPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,+CAA+C,CAAC;IAC/D;;;;OAIG;IAEH,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAElF,UAAiB,uBAAuB;QACpC,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB;IAED,UAAiB,OAAO;QACpB;;;WAGG;QACH,oBAAoB,CAAC,CAAC,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;QAExD;;;;;;;;;WASG;QACH,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC;QAExN;;;;WAIG;QACH,QAAQ,IAAI,uBAAuB,CAAC;QAEpC;;;;WAIG;QACH,aAAa,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;QAEpD;;;;;;WAMG;QACH,wBAAwB,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEzE;;;;WAIG;QACH,OAAO,CAAC,IAAI,IAAI,CAAC;QAEjB;;;WAGG;QACH,WAAW,CAAC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;KACzC;CAEA"}
+{"version":3,"file":"IPlugin.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/IPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,+CAA+C,CAAC;IAC/D;;;;OAIG;IAEH,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAElF,UAAiB,uBAAuB;QACpC,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB;IAED,UAAiB,OAAO;QACpB;;;WAGG;QACH,oBAAoB,CAAC,CAAC,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;QAExD;;;;;;;;;WASG;QACH,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAEzO;;;;WAIG;QACH,QAAQ,IAAI,uBAAuB,CAAC;QAEpC;;;;WAIG;QACH,aAAa,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;QAEpD;;;;;;WAMG;QACH,wBAAwB,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEzE;;;;WAIG;QACH,OAAO,CAAC,IAAI,IAAI,CAAC;QAEjB;;;WAGG;QACH,WAAW,CAAC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;KACzC;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/interfaces/IPlugin.ts

@@ -30,7 +30,7 @@ export interface IPlugin {
      * @param onChange The callback fired natively when a field value blur/change occurs.
      * @returns {Control} The generated UI5 control ready to be mounted.
      */
-    render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control;
+    render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void, model?: unknown): Control;
 
     /**
      * Triggers the internal validation pipeline for this specific plugin instance.

package/src/nz/co/siliconst/ui5/metaui/interfaces/ISchema-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"ISchema-dbg.js","names":[],"sources":["ISchema.ts"],"sourcesContent":["/**\n * @file ISchema.ts\n * @description MetaUI v2 Core Schema Contract.\n * Aligned with standard JSON-Schema syntax (properties, items) for native AI generation,\n * with a proprietary 'ui' directive block for Fiori visual orchestration.\n */\n\nexport type FieldType = \"string\" | \"number\" | \"integer\" | \"boolean\" | \"date\" | \"array\" | \"object\";\n\n/**\n * Value help structure mapping SAP Key/Text pairs.\n */\nexport interface IValueHelp {\n    key: string;\n    text: string;\n}\n\nexport interface IValidationRule {\n    name: string;\n    args?: unknown;\n}\n\n/**\n * An element in the visual layout tree.\n */\nexport interface ILayoutElement {\n    type: \"Group\" | \"Control\" | \"HorizontalLayout\" | \"VerticalLayout\" | \"WizardStep\";\n    label?: string;\n    scope?: string; // JSON Pointer to property, e.g. \"#/properties/FirstName\"\n    elements?: ILayoutElement[];\n    widget?: string; // Optional override for the widget\n}\n\n/**\n * Visual orchestration directives to separate layout from data modeling.\n */\nexport interface IUIDirective {\n    label?: string;\n    isKey?: boolean;\n    readOnly?: boolean;\n    widget?: string;\n    visibleOn?: string;\n    enabledOn?: string;\n    format?: string;\n    rows?: number;\n    fullWidth?: boolean;\n    validators?: (string | IValidationRule)[];\n    formatter?: string;\n    args?: unknown;\n    dialogButtonText?: string;\n}\n\nexport interface IRemoteValueHelpConfig {\n    url: string;\n    keyPath: string;\n    textPath: string;\n}\n\n/**\n * Standard JSON-Schema property definition.\n */\nexport interface IPropertyMetadata {\n    type: FieldType;\n    \n    // MetaUI specific orchestration\n    ui?: IUIDirective;\n    \n    // Standard validations\n    required?: boolean;\n    maxLength?: number;\n    minLength?: number;\n    minimum?: number;\n    maximum?: number;\n    pattern?: string;\n    \n    // Numeric specifics\n    precision?: number;\n    scale?: number;\n    multipleOf?: number;\n    \n    // Value constraints\n    valueHelp?: IValueHelp[] | IRemoteValueHelpConfig;\n    enum?: string[] | number[];\n    \n    // OpenAPI Advanced features\n    default?: any;\n    nullable?: boolean;\n    writeOnly?: boolean;\n    example?: any;\n    deprecated?: boolean;\n    exclusiveMinimum?: boolean | number;\n    exclusiveMaximum?: boolean | number;\n    \n    // Nested recursion for objects and arrays\n    properties?: Record<string, IPropertyMetadata>;\n    items?: IPropertyMetadata;\n    uiLayout?: ILayoutElement[];\n    additionalProperties?: boolean;\n}\n\n/**\n * The master schema contract ingested by the Engine.\n */\nexport interface ISchema {\n    title?: string;\n    layoutStrategy?: string;\n    type?: \"object\" | \"array\"; // Implicit layout hinting\n    properties?: Record<string, IPropertyMetadata>;\n    items?: IPropertyMetadata;\n    uiLayout?: ILayoutElement[];\n    additionalProperties?: boolean;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"ISchema-dbg.js","names":[],"sources":["ISchema.ts"],"sourcesContent":["/**\n * @file ISchema.ts\n * @description MetaUI v2 Core Schema Contract.\n * Aligned with standard JSON-Schema syntax (properties, items) for native AI generation,\n * with a proprietary 'ui' directive block for Fiori visual orchestration.\n */\n\nexport type FieldType = \"string\" | \"number\" | \"integer\" | \"boolean\" | \"date\" | \"array\" | \"object\";\n\n/**\n * Value help structure mapping SAP Key/Text pairs.\n */\nexport interface IValueHelp {\n    key: string;\n    text: string;\n}\n\nexport interface IValidationRule {\n    name: string;\n    args?: unknown;\n}\n\n/**\n * An element in the visual layout tree.\n */\nexport interface ILayoutElement {\n    type: \"Group\" | \"Control\" | \"HorizontalLayout\" | \"VerticalLayout\" | \"WizardStep\";\n    label?: string;\n    scope?: string; // JSON Pointer to property, e.g. \"#/properties/FirstName\"\n    elements?: ILayoutElement[];\n    widget?: string; // Optional override for the widget\n}\n\n/**\n * Visual orchestration directives to separate layout from data modeling.\n */\nexport interface IUIDirective {\n    label?: string;\n    isKey?: boolean;\n    readOnly?: boolean;\n    widget?: string;\n    visibleOn?: string;\n    enabledOn?: string;\n    format?: string;\n    rows?: number;\n    fullWidth?: boolean;\n    validators?: (string | IValidationRule)[];\n    formatter?: string;\n    args?: unknown;\n    dialogButtonText?: string;\n}\n\nexport interface IRemoteValueHelpConfig {\n    url: string;\n    keyPath: string;\n    textPath: string;\n}\n\n/**\n * Standard JSON-Schema property definition.\n */\nexport interface IPropertyMetadata {\n    type: FieldType;\n    $ref?: string;\n    \n    // MetaUI specific orchestration\n    ui?: IUIDirective;\n    \n    // Standard validations\n    required?: boolean;\n    maxLength?: number;\n    minLength?: number;\n    minimum?: number;\n    maximum?: number;\n    pattern?: string;\n    \n    // Numeric specifics\n    precision?: number;\n    scale?: number;\n    multipleOf?: number;\n    \n    // Value constraints\n    valueHelp?: IValueHelp[] | IRemoteValueHelpConfig;\n    enum?: string[] | number[];\n    \n    // OpenAPI Advanced features\n    default?: unknown;\n    nullable?: boolean;\n    writeOnly?: boolean;\n    readOnly?: boolean;\n    example?: unknown;\n    deprecated?: boolean;\n    exclusiveMinimum?: boolean | number;\n    exclusiveMaximum?: boolean | number;\n    \n    // Array Validation\n    maxItems?: number;\n    minItems?: number;\n    uniqueItems?: boolean;\n\n    // Object Validation\n    maxProperties?: number;\n    minProperties?: number;\n\n    // Polymorphism and Composition\n    oneOf?: IPropertyMetadata[];\n    anyOf?: IPropertyMetadata[];\n    allOf?: IPropertyMetadata[];\n    not?: IPropertyMetadata;\n    discriminator?: { propertyName: string, mapping?: Record<string, string> };\n    \n    // Nested recursion for objects and arrays\n    properties?: Record<string, IPropertyMetadata>;\n    items?: IPropertyMetadata;\n    uiLayout?: ILayoutElement[];\n    additionalProperties?: boolean | IPropertyMetadata;\n}\n\n/**\n * The master schema contract ingested by the Engine.\n */\nexport interface ISchema {\n    title?: string;\n    layoutStrategy?: string;\n    type?: \"object\" | \"array\"; // Implicit layout hinting\n    properties?: Record<string, IPropertyMetadata>;\n    items?: IPropertyMetadata;\n    uiLayout?: ILayoutElement[];\n    additionalProperties?: boolean;\n    definitions?: Record<string, ISchema>;\n}\n"],"mappings":"","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/interfaces/ISchema.d.ts

@@ -55,6 +55,7 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/ISchema" {
      */
     export interface IPropertyMetadata {
         type: FieldType;
+        $ref?: string;
         ui?: IUIDirective;
         required?: boolean;
         maxLength?: number;
@@ -67,17 +68,31 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/ISchema" {
         multipleOf?: number;
         valueHelp?: IValueHelp[] | IRemoteValueHelpConfig;
         enum?: string[] | number[];
-        default?: any;
+        default?: unknown;
         nullable?: boolean;
         writeOnly?: boolean;
-        example?: any;
+        readOnly?: boolean;
+        example?: unknown;
         deprecated?: boolean;
         exclusiveMinimum?: boolean | number;
         exclusiveMaximum?: boolean | number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+        maxProperties?: number;
+        minProperties?: number;
+        oneOf?: IPropertyMetadata[];
+        anyOf?: IPropertyMetadata[];
+        allOf?: IPropertyMetadata[];
+        not?: IPropertyMetadata;
+        discriminator?: {
+            propertyName: string;
+            mapping?: Record<string, string>;
+        };
         properties?: Record<string, IPropertyMetadata>;
         items?: IPropertyMetadata;
         uiLayout?: ILayoutElement[];
-        additionalProperties?: boolean;
+        additionalProperties?: boolean | IPropertyMetadata;
     }
     /**
      * The master schema contract ingested by the Engine.
@@ -90,6 +105,7 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/ISchema" {
         items?: IPropertyMetadata;
         uiLayout?: ILayoutElement[];
         additionalProperties?: boolean;
+        definitions?: Record<string, ISchema>;
     }
 }
 //# sourceMappingURL=ISchema.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/interfaces/ISchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ISchema.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/ISchema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ISchema.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/ISchema.ts"],"names":[],"mappings":"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"}

package/src/nz/co/siliconst/ui5/metaui/interfaces/ISchema.ts

@@ -61,6 +61,7 @@ export interface IRemoteValueHelpConfig {
  */
 export interface IPropertyMetadata {
     type: FieldType;
+    $ref?: string;
     
     // MetaUI specific orchestration
     ui?: IUIDirective;
@@ -83,19 +84,36 @@ export interface IPropertyMetadata {
     enum?: string[] | number[];
     
     // OpenAPI Advanced features
-    default?: any;
+    default?: unknown;
     nullable?: boolean;
     writeOnly?: boolean;
-    example?: any;
+    readOnly?: boolean;
+    example?: unknown;
     deprecated?: boolean;
     exclusiveMinimum?: boolean | number;
     exclusiveMaximum?: boolean | number;
     
+    // Array Validation
+    maxItems?: number;
+    minItems?: number;
+    uniqueItems?: boolean;
+
+    // Object Validation
+    maxProperties?: number;
+    minProperties?: number;
+
+    // Polymorphism and Composition
+    oneOf?: IPropertyMetadata[];
+    anyOf?: IPropertyMetadata[];
+    allOf?: IPropertyMetadata[];
+    not?: IPropertyMetadata;
+    discriminator?: { propertyName: string, mapping?: Record<string, string> };
+    
     // Nested recursion for objects and arrays
     properties?: Record<string, IPropertyMetadata>;
     items?: IPropertyMetadata;
     uiLayout?: ILayoutElement[];
-    additionalProperties?: boolean;
+    additionalProperties?: boolean | IPropertyMetadata;
 }
 
 /**
@@ -109,4 +127,5 @@ export interface ISchema {
     items?: IPropertyMetadata;
     uiLayout?: ILayoutElement[];
     additionalProperties?: boolean;
+    definitions?: Record<string, ISchema>;
 }

package/src/nz/co/siliconst/ui5/metaui/interfaces/ISchemaBuilderPlugin-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"ISchemaBuilderPlugin-dbg.js","names":[],"sources":["ISchemaBuilderPlugin.ts"],"sourcesContent":["/**\n * @file ISchemaBuilderPlugin.ts\n * @description Contract for all Schema Parsers (Native MetaUI, Swagger, etc).\n * Supports the Open-Closed principle for schema ingestion.\n */\n\nimport { ISchema } from \"./ISchema\";\n\nexport interface ISchemaBuilderPlugin {\n    /**\n     * Deterministically checks if this plugin can parse the given raw payload.\n     * @param rawSchema The unparsed JSON object.\n     * @returns True if this plugin can handle the schema format.\n     */\n    canHandle(rawSchema: any): boolean;\n\n    /**\n     * Converts the raw schema payload into a strict MetaUI ISchema.\n     * @param rawSchema The raw schema JSON object.\n     * @returns A strict MetaUI ISchema.\n     */\n    build(rawSchema: any): ISchema;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"ISchemaBuilderPlugin-dbg.js","names":[],"sources":["ISchemaBuilderPlugin.ts"],"sourcesContent":["/**\n * @file ISchemaBuilderPlugin.ts\n * @description Contract for all Schema Parsers (Native MetaUI, Swagger, etc).\n * Supports the Open-Closed principle for schema ingestion.\n */\n\nimport { ISchema } from \"./ISchema\";\n\nexport interface ISchemaBuilderPlugin {\n    /**\n     * Deterministically checks if this plugin can parse the given raw payload.\n     * @param rawSchema The unparsed JSON object.\n     * @returns True if this plugin can handle the schema format.\n     */\n    canHandle(rawSchema: unknown): boolean;\n\n    /**\n     * Converts the raw schema payload into a strict MetaUI ISchema.\n     * @param rawSchema The raw schema JSON object.\n     * @param targetDefinition Optional target root definition.\n     * @returns A strict MetaUI ISchema.\n     */\n    build(rawSchema: unknown, targetDefinition?: string): ISchema;\n}\n"],"mappings":"","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/interfaces/ISchemaBuilderPlugin.d.ts

@@ -11,13 +11,14 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/ISchemaBuilderPlugin" {
          * @param rawSchema The unparsed JSON object.
          * @returns True if this plugin can handle the schema format.
          */
-        canHandle(rawSchema: any): boolean;
+        canHandle(rawSchema: unknown): boolean;
         /**
          * Converts the raw schema payload into a strict MetaUI ISchema.
          * @param rawSchema The raw schema JSON object.
+         * @param targetDefinition Optional target root definition.
          * @returns A strict MetaUI ISchema.
          */
-        build(rawSchema: any): ISchema;
+        build(rawSchema: unknown, targetDefinition?: string): ISchema;
     }
 }
 //# sourceMappingURL=ISchemaBuilderPlugin.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/interfaces/ISchemaBuilderPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ISchemaBuilderPlugin.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/ISchemaBuilderPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,4DAA4D,CAAC;IAC5E;;;;OAIG;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;IAExE,UAAiB,oBAAoB;QACjC;;;;WAIG;QACH,SAAS,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC;QAEnC;;;;WAIG;QACH,KAAK,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC;KAClC;CAEA"}
+{"version":3,"file":"ISchemaBuilderPlugin.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/ISchemaBuilderPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,4DAA4D,CAAC;IAC5E;;;;OAIG;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;IAExE,UAAiB,oBAAoB;QACjC;;;;WAIG;QACH,SAAS,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;QAEvC;;;;;WAKG;QACH,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACjE;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/interfaces/ISchemaBuilderPlugin.ts

@@ -12,12 +12,13 @@ export interface ISchemaBuilderPlugin {
      * @param rawSchema The unparsed JSON object.
      * @returns True if this plugin can handle the schema format.
      */
-    canHandle(rawSchema: any): boolean;
+    canHandle(rawSchema: unknown): boolean;
 
     /**
      * Converts the raw schema payload into a strict MetaUI ISchema.
      * @param rawSchema The raw schema JSON object.
+     * @param targetDefinition Optional target root definition.
      * @returns A strict MetaUI ISchema.
      */
-    build(rawSchema: any): ISchema;
+    build(rawSchema: unknown, targetDefinition?: string): ISchema;
 }

package/src/nz/co/siliconst/ui5/metaui/layouts/TableLayout-dbg.js

@@ -24,7 +24,23 @@ sap.ui.define(["sap/m/Table", "sap/m/Column", "sap/m/Text", "sap/m/ColumnListIte
      * @throws {Error} If the provided schema is not of type 'array'.
      */
     render(schema, modelName, engine, onSubmit, bindingPath = "/") {
-      if (schema.type !== "array" || !schema.items || !schema.items.properties) {
+      let itemsSchema = schema.items;
+      if (itemsSchema && !itemsSchema.properties && itemsSchema.ui?.widget === "reference" && itemsSchema.$ref) {
+        Logger.debug(`[MetaUI] TableLayout detecting reference widget for ${bindingPath}. Resolving ${itemsSchema.$ref}`, "", "TableLayout");
+        if (engine.host && engine.host.getSchemaDefinition) {
+          const resolved = engine.host.getSchemaDefinition(itemsSchema.$ref);
+          Logger.debug(`[MetaUI] Resolved schema for ${itemsSchema.$ref}: ${!!resolved} ${resolved ? Object.keys(resolved) : ""}`, "", "TableLayout");
+          if (resolved && resolved.properties) {
+            itemsSchema = resolved;
+          } else {
+            Logger.error(`[MetaUI] TableLayout resolved schema but it has no properties!`, "", "TableLayout");
+          }
+        } else {
+          Logger.error(`[MetaUI] TableLayout cannot resolve ${itemsSchema.$ref} because engine.host.getSchemaDefinition is missing! host: ${engine.host?.getMetadata().getName()}`, "", "TableLayout");
+        }
+      }
+      if (schema.type !== "array" || !itemsSchema || !itemsSchema.properties) {
+        Logger.error(`[MetaUI] TableLayout fatal error! schema.type: ${schema.type}, itemsSchema: ${!!itemsSchema}, properties: ${itemsSchema ? !!itemsSchema.properties : false}`, "", "TableLayout");
         throw new Error("[MetaUI] TableLayout requires an array schema with items.properties.");
       }
       const tableTitle = schema.title || "Table";
@@ -78,7 +94,7 @@ sap.ui.define(["sap/m/Table", "sap/m/Column", "sap/m/Text", "sap/m/ColumnListIte
         }
       });
       const templateCells = [];
-      const props = schema.items.properties;
+      const props = itemsSchema.properties;
       const layoutElements = schema.uiLayout;
       if (layoutElements && Array.isArray(layoutElements)) {
         // Only render columns defined in uiLayout