@siliconst/metaui 1.4.21 → 1.4.37

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","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":[]}
+{"version":3,"file":"SchemaNormalizer.js","names":["SCHEMA_TYPE","___constants_MetaUIConstants","Logger","___utils_Logger","SchemaNormalizer","canHandle","rawSchema","build","targetDefinition","normalize","data","schemaObj","STRING","trim","JSON","parse","e","msg","message","error","Error","Array","isArray","this","inferSchemaFromData","normalized","title","type","items","layoutStrategy","uiLayout","stringify","undefined","additionalProperties","uiPolicies","targetProperties","properties","inferred","deepMergeProperties","requiredKeys","required","normalizeProperties","normalizePropertyMetadata","base","override","merged","key","Object","keys","overrideVal","baseVal","normalizedProps","isRequired","includes","rawProp","keyName","prop","ui","$ref","label","generateLabel","isKey","readOnly","widget","valueHelp","enum","visibleOn","enabledOn","format","validators","formatter","args","rows","fullWidth","dialogButtonText","controlProps","maxLength","minLength","minimum","maximum","pattern","precision","scale","multipleOf","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","schema","mergedProperties","limit","Math","min","i","inferPropertiesFromObject","obj","val","nestedProps","resolveScope","scope","startsWith","meta","bindingPath","propKey","pathSegments","current","debug","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 { SCHEMA_TYPE } from \"../constants/MetaUIConstants\";\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 === SCHEMA_TYPE.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 ? JSON.parse(JSON.stringify(schemaObj.uiLayout)) : undefined,\n                additionalProperties: schemaObj.additionalProperties,\n                uiPolicies: schemaObj.uiPolicies ? JSON.parse(JSON.stringify(schemaObj.uiPolicies)) : undefined\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(rawProp: unknown, keyName: string, isRequired: boolean = false): IPropertyMetadata {\n        const prop = (rawProp || {}) as Record<string, unknown>;\n        const ui = (prop.ui || {}) as Record<string, unknown>;\n        \n        const normalized: IPropertyMetadata = {\n            type: (prop.type as FieldType) || \"string\",\n            $ref: prop.$ref as string | undefined,\n            ui: {\n                label: ui.label as string || this.generateLabel(keyName),\n                isKey: !!ui.isKey,\n                readOnly: !!ui.readOnly,\n                widget: ui.widget as string || (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                controlProps: prop.ui?.controlProps\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\") {\n            // Auto-correct arrays that were mistakenly flattened with 'properties' instead of 'items.properties'\n            if (prop.properties && !prop.items) {\n                prop.items = {\n                    type: \"object\",\n                    properties: prop.properties\n                };\n                delete prop.properties;\n            }\n\n            if (prop.items) {\n                normalized.items = this.normalizePropertyMetadata(prop.items as Record<string, unknown>, \"items\", false);\n            }\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                \n                let mergedProperties: Record<string, unknown> = {};\n                const limit = Math.min(data.length, 50);\n                for (let i = 0; i < limit; i++) {\n                    const inferred = this.inferPropertiesFromObject(data[i] as Record<string, any>);\n                    mergedProperties = this.deepMergeProperties(mergedProperties, inferred as unknown as Record<string, unknown>);\n                }\n\n                schema.items = {\n                    type: \"object\",\n                    layoutStrategy: \"compact\",\n                    properties: mergedProperties as Record<string, IPropertyMetadata>\n                } as any;\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 = SCHEMA_TYPE.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 as Record<string, unknown>);\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

@@ -4,6 +4,7 @@
  */
 
 import { ISchema, IPropertyMetadata, FieldType } from "../interfaces/ISchema";
+import { SCHEMA_TYPE } from "../constants/MetaUIConstants";
 import { ISchemaBuilderPlugin } from "../interfaces/ISchemaBuilderPlugin";
 import { Logger } from "../utils/Logger";
 
@@ -31,7 +32,7 @@ export class SchemaNormalizer implements ISchemaBuilderPlugin {
     public static normalize(rawSchema?: unknown, data?: unknown): ISchema {
         let schemaObj = rawSchema;
 
-        if (typeof schemaObj === "string") {
+        if (typeof schemaObj === SCHEMA_TYPE.STRING) {
             if (!schemaObj.trim()) {
                 schemaObj = null;
             } else {
@@ -55,8 +56,9 @@ export class SchemaNormalizer implements ISchemaBuilderPlugin {
                 title: schemaObj.title,
                 type: schemaObj.type || (schemaObj.items ? "array" : "object"),
                 layoutStrategy: schemaObj.layoutStrategy,
-                uiLayout: schemaObj.uiLayout,
-                additionalProperties: schemaObj.additionalProperties
+                uiLayout: schemaObj.uiLayout ? JSON.parse(JSON.stringify(schemaObj.uiLayout)) : undefined,
+                additionalProperties: schemaObj.additionalProperties,
+                uiPolicies: schemaObj.uiPolicies ? JSON.parse(JSON.stringify(schemaObj.uiPolicies)) : undefined
             };
 
             let targetProperties = schemaObj.properties || {};
@@ -130,15 +132,18 @@ export class SchemaNormalizer implements ISchemaBuilderPlugin {
      * @param isRequired Indicates if the parent object mandated this property as required.
      * @returns A strict IPropertyMetadata instance.
      */
-    private static normalizePropertyMetadata(prop: Record<string, unknown>, keyName: string, isRequired: boolean = false): IPropertyMetadata {
+    private static normalizePropertyMetadata(rawProp: unknown, keyName: string, isRequired: boolean = false): IPropertyMetadata {
+        const prop = (rawProp || {}) as Record<string, unknown>;
+        const ui = (prop.ui || {}) as Record<string, unknown>;
+        
         const normalized: IPropertyMetadata = {
             type: (prop.type as FieldType) || "string",
             $ref: prop.$ref as string | undefined,
             ui: {
-                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),
+                label: ui.label as string || this.generateLabel(keyName),
+                isKey: !!ui.isKey,
+                readOnly: !!ui.readOnly,
+                widget: ui.widget as string || (prop.valueHelp || prop.enum ? "select" : undefined),
                 visibleOn: prop.ui?.visibleOn,
                 enabledOn: prop.ui?.enabledOn,
                 format: prop.ui?.format,
@@ -147,7 +152,8 @@ export class SchemaNormalizer implements ISchemaBuilderPlugin {
                 args: prop.ui?.args,
                 rows: prop.ui?.rows,
                 fullWidth: prop.ui?.fullWidth,
-                dialogButtonText: prop.ui?.dialogButtonText
+                dialogButtonText: prop.ui?.dialogButtonText,
+                controlProps: prop.ui?.controlProps
             },
             required: isRequired || !!prop.required,
             maxLength: prop.maxLength as number,
@@ -166,8 +172,19 @@ export class SchemaNormalizer implements ISchemaBuilderPlugin {
             const requiredKeys = Array.isArray(prop.required) ? prop.required : [];
             normalized.properties = this.normalizeProperties(prop.properties as Record<string, unknown>, requiredKeys);
             normalized.uiLayout = prop.uiLayout;
-        } else if (normalized.type === "array" && prop.items) {
-            normalized.items = this.normalizePropertyMetadata(prop.items as Record<string, unknown>, "items", false);
+        } else if (normalized.type === "array") {
+            // Auto-correct arrays that were mistakenly flattened with 'properties' instead of 'items.properties'
+            if (prop.properties && !prop.items) {
+                prop.items = {
+                    type: "object",
+                    properties: prop.properties
+                };
+                delete prop.properties;
+            }
+
+            if (prop.items) {
+                normalized.items = this.normalizePropertyMetadata(prop.items as Record<string, unknown>, "items", false);
+            }
             normalized.uiLayout = prop.uiLayout;
         }
 
@@ -204,11 +221,19 @@ export class SchemaNormalizer implements ISchemaBuilderPlugin {
                 schema.items = { type: typeof data[0] as FieldType };
             } else {
                 schema.layoutStrategy = "table";
+                
+                let mergedProperties: Record<string, unknown> = {};
+                const limit = Math.min(data.length, 50);
+                for (let i = 0; i < limit; i++) {
+                    const inferred = this.inferPropertiesFromObject(data[i] as Record<string, any>);
+                    mergedProperties = this.deepMergeProperties(mergedProperties, inferred as unknown as Record<string, unknown>);
+                }
+
                 schema.items = {
                     type: "object",
                     layoutStrategy: "compact",
-                    properties: data.length > 0 ? this.inferPropertiesFromObject(data[0] as Record<string, unknown>) : {}
-                };
+                    properties: mergedProperties as Record<string, IPropertyMetadata>
+                } as any;
             }
         } else {
             schema.type = "object";
@@ -231,7 +256,7 @@ export class SchemaNormalizer implements ISchemaBuilderPlugin {
             const val = obj[key];
             if (val === null || val === undefined) continue;
 
-            let type: FieldType = "string";
+            let type: FieldType = SCHEMA_TYPE.STRING;
             let items: IPropertyMetadata | undefined;
             let nestedProps: Record<string, IPropertyMetadata> | undefined;
 
@@ -251,7 +276,7 @@ export class SchemaNormalizer implements ISchemaBuilderPlugin {
                 }
             } else if (typeof val === "object") {
                 type = "object";
-                nestedProps = this.inferPropertiesFromObject(val);
+                nestedProps = this.inferPropertiesFromObject(val as Record<string, unknown>);
             }
 
             properties[key] = {

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

@@ -1,11 +1,11 @@
-sap.ui.define([], function () {
+sap.ui.define(["../constants/MetaUIConstants"], function (___constants_MetaUIConstants) {
   "use strict";
 
   /**
    * @file SchemaValidator.ts
    * @description Structural validation utility to catch developer errors in the JSON schema itself.
    */
-
+  const SCHEMA_TYPE = ___constants_MetaUIConstants["SCHEMA_TYPE"];
   class SchemaValidator {
     /**
      * Validates a parsed JSON schema object for structural correctness.
@@ -24,6 +24,18 @@ sap.ui.define([], function () {
       if (s.type === "object" && !s.properties) {
         errors.push("Object schema is missing the 'properties' node.");
       }
+      if (s.type === "array") {
+        if (!s.items) {
+          // Warning rather than error for inference support, but we should check it
+          // Actually inference creates { items: { type: 'string' } } for primitives
+          // Wait, the instruction says "completely skipping the validation of the array's items configuration"
+          // I will recursively call validateSchemaStructure if items exist
+        }
+        if (s.items && typeof s.items === "object") {
+          const itemErrors = SchemaValidator.validateSchemaStructure(s.items);
+          errors.push(...itemErrors);
+        }
+      }
       if (s.properties) {
         for (const key of Object.keys(s.properties)) {
           const prop = s.properties[key];
@@ -34,7 +46,7 @@ sap.ui.define([], function () {
           if (!prop.type) {
             errors.push(`Property '${key}' is missing 'type'.`);
           } else {
-            const allowedTypes = ["string", "number", "integer", "boolean", "date", "object", "array"];
+            const allowedTypes = [SCHEMA_TYPE.STRING, SCHEMA_TYPE.NUMBER, SCHEMA_TYPE.INTEGER, SCHEMA_TYPE.BOOLEAN, SCHEMA_TYPE.DATE, SCHEMA_TYPE.OBJECT, SCHEMA_TYPE.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\", \"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":[]}
+{"version":3,"file":"SchemaValidator-dbg.js","names":["SCHEMA_TYPE","___constants_MetaUIConstants","SchemaValidator","validateSchemaStructure","schema","errors","s","type","push","properties","items","itemErrors","key","Object","keys","prop","allowedTypes","STRING","NUMBER","INTEGER","BOOLEAN","DATE","OBJECT","ARRAY","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\";\nimport { SCHEMA_TYPE } from \"../constants/MetaUIConstants\";\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.type === \"array\") {\n            if (!s.items) {\n                // Warning rather than error for inference support, but we should check it\n                // Actually inference creates { items: { type: 'string' } } for primitives\n                // Wait, the instruction says \"completely skipping the validation of the array's items configuration\"\n                // I will recursively call validateSchemaStructure if items exist\n            }\n            if (s.items && typeof s.items === \"object\") {\n                const itemErrors = SchemaValidator.validateSchemaStructure(s.items);\n                errors.push(...itemErrors);\n            }\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[] = [SCHEMA_TYPE.STRING, SCHEMA_TYPE.NUMBER, SCHEMA_TYPE.INTEGER, SCHEMA_TYPE.BOOLEAN, SCHEMA_TYPE.DATE, SCHEMA_TYPE.OBJECT, SCHEMA_TYPE.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;EAHA,MAMSA,WAAW,GAAAC,4BAAA;EAEb,MAAMC,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,CAACC,IAAI,KAAK,OAAO,EAAE;QACpB,IAAI,CAACD,CAAC,CAACI,KAAK,EAAE;UACV;UACA;UACA;UACA;QAAA;QAEJ,IAAIJ,CAAC,CAACI,KAAK,IAAI,OAAOJ,CAAC,CAACI,KAAK,KAAK,QAAQ,EAAE;UACxC,MAAMC,UAAU,GAAGT,eAAe,CAACC,uBAAuB,CAACG,CAAC,CAACI,KAAK,CAAC;UACnEL,MAAM,CAACG,IAAI,CAAC,GAAGG,UAAU,CAAC;QAC9B;MACJ;MAEA,IAAIL,CAAC,CAACG,UAAU,EAAE;QACd,KAAK,MAAMG,GAAG,IAAIC,MAAM,CAACC,IAAI,CAACR,CAAC,CAACG,UAAU,CAAC,EAAE;UACzC,MAAMM,IAAI,GAAGT,CAAC,CAACG,UAAU,CAACG,GAAG,CAAC;UAC9B,IAAI,CAACG,IAAI,IAAI,OAAOA,IAAI,KAAK,QAAQ,EAAE;YACnCV,MAAM,CAACG,IAAI,CAAC,aAAaI,GAAG,sBAAsB,CAAC;YACnD;UACJ;UAEA,IAAI,CAACG,IAAI,CAACR,IAAI,EAAE;YACZF,MAAM,CAACG,IAAI,CAAC,aAAaI,GAAG,sBAAsB,CAAC;UACvD,CAAC,MAAM;YACH,MAAMI,YAAyB,GAAG,CAAChB,WAAW,CAACiB,MAAM,EAAEjB,WAAW,CAACkB,MAAM,EAAElB,WAAW,CAACmB,OAAO,EAAEnB,WAAW,CAACoB,OAAO,EAAEpB,WAAW,CAACqB,IAAI,EAAErB,WAAW,CAACsB,MAAM,EAAEtB,WAAW,CAACuB,KAAK,CAAC;YAC7K,IAAI,CAACP,YAAY,CAACQ,QAAQ,CAACT,IAAI,CAACR,IAAI,CAAC,EAAE;cACnCF,MAAM,CAACG,IAAI,CAAC,aAAaI,GAAG,uBAAuBG,IAAI,CAACR,IAAI,eAAeS,YAAY,CAACS,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzG;UACJ;;UAEA;QAEJ;MACJ;MAEA,OAAOpB,MAAM;IACjB;EACJ;EAAC,IAAAqB,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAxB,eAAA,GAAAA,eAAA;EAAA,OAAAwB,SAAA;AAAA","ignoreList":[]}

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

@@ -1 +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,OAAO,GAAG,MAAM,EAAE;KAwCnE;CAEA"}
+{"version":3,"file":"SchemaValidator.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/SchemaValidator.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,iDAAiD,CAAC;IASjE,MAAa,eAAe;QACxB;;;;WAIG;eACW,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE;KAqDnE;CAEA"}

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 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});
+sap.ui.define(["../constants/MetaUIConstants"],function(e){"use strict";const t=e["SCHEMA_TYPE"];class s{static validateSchemaStructure(e){const o=[];if(!e||typeof e!=="object"){return["Root schema must be an object."]}const i=e;if(i.type!=="object"&&i.type!=="array"){o.push(`Root schema must have type 'object' or 'array'. Found: '${i.type}'`)}if(i.type==="object"&&!i.properties){o.push("Object schema is missing the 'properties' node.")}if(i.type==="array"){if(!i.items){}if(i.items&&typeof i.items==="object"){const e=s.validateSchemaStructure(i.items);o.push(...e)}}if(i.properties){for(const e of Object.keys(i.properties)){const s=i.properties[e];if(!s||typeof s!=="object"){o.push(`Property '${e}' must be an object.`);continue}if(!s.type){o.push(`Property '${e}' is missing 'type'.`)}else{const i=[t.STRING,t.NUMBER,t.INTEGER,t.BOOLEAN,t.DATE,t.OBJECT,t.ARRAY];if(!i.includes(s.type)){o.push(`Property '${e}' has invalid type '${s.type}'. Allowed: ${i.join(", ")}`)}}}}return o}}var o={__esModule:true};o.SchemaValidator=s;return o});
 //# 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\", \"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":[]}
+{"version":3,"file":"SchemaValidator.js","names":["SCHEMA_TYPE","___constants_MetaUIConstants","SchemaValidator","validateSchemaStructure","schema","errors","s","type","push","properties","items","itemErrors","key","Object","keys","prop","allowedTypes","STRING","NUMBER","INTEGER","BOOLEAN","DATE","OBJECT","ARRAY","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\";\nimport { SCHEMA_TYPE } from \"../constants/MetaUIConstants\";\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.type === \"array\") {\n            if (!s.items) {\n                // Warning rather than error for inference support, but we should check it\n                // Actually inference creates { items: { type: 'string' } } for primitives\n                // Wait, the instruction says \"completely skipping the validation of the array's items configuration\"\n                // I will recursively call validateSchemaStructure if items exist\n            }\n            if (s.items && typeof s.items === \"object\") {\n                const itemErrors = SchemaValidator.validateSchemaStructure(s.items);\n                errors.push(...itemErrors);\n            }\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[] = [SCHEMA_TYPE.STRING, SCHEMA_TYPE.NUMBER, SCHEMA_TYPE.INTEGER, SCHEMA_TYPE.BOOLEAN, SCHEMA_TYPE.DATE, SCHEMA_TYPE.OBJECT, SCHEMA_TYPE.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":"wEAAA,MAMSA,EAAWC,EAAA,eAEb,MAAMC,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,EAAEC,OAAS,QAAS,CACpB,IAAKD,EAAEI,MAAO,CAIV,CAEJ,GAAIJ,EAAEI,cAAgBJ,EAAEI,QAAU,SAAU,CACxC,MAAMC,EAAaT,EAAgBC,wBAAwBG,EAAEI,OAC7DL,EAAOG,QAAQG,EACnB,CACJ,CAEA,GAAIL,EAAEG,WAAY,CACd,IAAK,MAAMG,KAAOC,OAAOC,KAAKR,EAAEG,YAAa,CACzC,MAAMM,EAAOT,EAAEG,WAAWG,GAC1B,IAAKG,UAAeA,IAAS,SAAU,CACnCV,EAAOG,KAAK,aAAaI,yBACzB,QACJ,CAEA,IAAKG,EAAKR,KAAM,CACZF,EAAOG,KAAK,aAAaI,wBAC7B,KAAO,CACH,MAAMI,EAA4B,CAAChB,EAAYiB,OAAQjB,EAAYkB,OAAQlB,EAAYmB,QAASnB,EAAYoB,QAASpB,EAAYqB,KAAMrB,EAAYsB,OAAQtB,EAAYuB,OACvK,IAAKP,EAAaQ,SAAST,EAAKR,MAAO,CACnCF,EAAOG,KAAK,aAAaI,wBAA0BG,EAAKR,mBAAmBS,EAAaS,KAAK,QACjG,CACJ,CAIJ,CACJ,CAEA,OAAOpB,CACX,EACH,IAAAqB,EAAA,CAAAC,WAAA,MAAAD,EAAAxB,kBAAA,OAAAwB,CAAA","ignoreList":[]}

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

@@ -4,6 +4,7 @@
  */
 
 import { ISchema, FieldType } from "../interfaces/ISchema";
+import { SCHEMA_TYPE } from "../constants/MetaUIConstants";
 
 export class SchemaValidator {
     /**
@@ -27,6 +28,19 @@ export class SchemaValidator {
             errors.push("Object schema is missing the 'properties' node.");
         }
 
+        if (s.type === "array") {
+            if (!s.items) {
+                // Warning rather than error for inference support, but we should check it
+                // Actually inference creates { items: { type: 'string' } } for primitives
+                // Wait, the instruction says "completely skipping the validation of the array's items configuration"
+                // I will recursively call validateSchemaStructure if items exist
+            }
+            if (s.items && typeof s.items === "object") {
+                const itemErrors = SchemaValidator.validateSchemaStructure(s.items);
+                errors.push(...itemErrors);
+            }
+        }
+
         if (s.properties) {
             for (const key of Object.keys(s.properties)) {
                 const prop = s.properties[key];
@@ -38,7 +52,7 @@ export class SchemaValidator {
                 if (!prop.type) {
                     errors.push(`Property '${key}' is missing 'type'.`);
                 } else {
-                    const allowedTypes: FieldType[] = ["string", "number", "integer", "boolean", "date", "object", "array"];
+                    const allowedTypes: FieldType[] = [SCHEMA_TYPE.STRING, SCHEMA_TYPE.NUMBER, SCHEMA_TYPE.INTEGER, SCHEMA_TYPE.BOOLEAN, SCHEMA_TYPE.DATE, SCHEMA_TYPE.OBJECT, SCHEMA_TYPE.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/StateManager-dbg.js

@@ -1,7 +1,9 @@
-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) {
+sap.ui.define(["sap/ui/model/json/JSONModel", "../constants/MetaUIConstants", "./PipelineManager", "./SchemaNormalizer", "sap/ui/core/message/Message", "sap/ui/core/library", "sap/ui/core/Messaging"], function (JSONModel, ___constants_MetaUIConstants, ___PipelineManager, ___SchemaNormalizer, Message, coreLibrary, Messaging) {
   "use strict";
 
+  const SCHEMA_TYPE = ___constants_MetaUIConstants["SCHEMA_TYPE"];
   const GlobalPipeline = ___PipelineManager["GlobalPipeline"];
+  const SchemaNormalizer = ___SchemaNormalizer["SchemaNormalizer"];
   /**
    * Manages the isolated internal data payload for the MetaUI engine.
    */
@@ -49,16 +51,14 @@ sap.ui.define(["sap/ui/model/json/JSONModel", "./PipelineManager", "sap/ui/core/
       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)
-      if (this._useMessageManager) {
-        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);
-        }
+      // 1. Remove existing messages (strictly for THIS model instance) unconditionally
+      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;
 
@@ -68,7 +68,7 @@ sap.ui.define(["sap/ui/model/json/JSONModel", "./PipelineManager", "sap/ui/core/
       if (metadata.required) {
         validatorsToRun.push("required");
       }
-      if (metadata.type === "string" && metadata.maxLength) {
+      if (metadata.type === SCHEMA_TYPE.STRING && metadata.maxLength) {
         validatorsToRun.push("maxLength");
         argsMap["maxLength"] = metadata.maxLength;
       }
@@ -93,7 +93,7 @@ sap.ui.define(["sap/ui/model/json/JSONModel", "./PipelineManager", "sap/ui/core/
       }
       if (metadata.ui?.validators) {
         for (const v of metadata.ui.validators) {
-          if (typeof v === "string") {
+          if (typeof v === SCHEMA_TYPE.STRING) {
             validatorsToRun.push(v);
           } else if (v && v.name) {
             validatorsToRun.push(v.name);
@@ -117,6 +117,23 @@ sap.ui.define(["sap/ui/model/json/JSONModel", "./PipelineManager", "sap/ui/core/
       }
     }
 
+    /**
+     * Purges all MessageManager errors that start with a specific array path.
+     * Used to clean up "ghost errors" when array structural shifts (deletion) occur.
+     * @param arrayPath The root array path (e.g. /Items)
+     */
+    clearArrayMessages(arrayPath) {
+      const messageManager = Messaging;
+      const currentMessages = messageManager.getMessageModel().getData();
+      const pathPrefix = arrayPath.startsWith("/") ? arrayPath : `/${arrayPath}`;
+      const messagesToRemove = currentMessages.filter(msg => {
+        return msg.getProcessor() === this.model && typeof msg.getTarget() === "string" && msg.getTarget().startsWith(pathPrefix);
+      });
+      if (messagesToRemove.length > 0) {
+        messageManager.removeMessages(messagesToRemove);
+      }
+    }
+
     /**
      * Resolves the schema metadata for a given internal binding path.
      * @param path The flat binding path representing the field.
@@ -124,8 +141,13 @@ sap.ui.define(["sap/ui/model/json/JSONModel", "./PipelineManager", "sap/ui/core/
      */
     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];
+
+      // Deeply resolve the metadata using the SchemaNormalizer
+      const absoluteScope = "#/properties/" + path.replace(/\//g, "/properties/");
+      const {
+        meta
+      } = SchemaNormalizer.resolveScope(this.schema, absoluteScope);
+      return meta;
     }
 
     /**
@@ -155,8 +177,45 @@ sap.ui.define(["sap/ui/model/json/JSONModel", "./PipelineManager", "sap/ui/core/
      */
     extractPayload() {
       // Create a deep copy to prevent accidental mutations by the host
+      // Uses a robust deep clone to avoid destructively coercing native objects (like Dates) to strings
       const data = this.model.getData();
-      return JSON.parse(JSON.stringify(data));
+      return this.deepClone(data);
+    }
+
+    /**
+     * Recursively clones an object while preserving native Date instances and arrays.
+     */
+    deepClone(obj) {
+      if (obj === null || typeof obj !== "object") {
+        return obj;
+      }
+      if (obj instanceof Date) {
+        return new Date(obj.getTime());
+      }
+      if (Array.isArray(obj)) {
+        const arrCopy = [];
+        for (const item of obj) {
+          arrCopy.push(this.deepClone(item));
+        }
+        return arrCopy;
+      }
+      const objCopy = {};
+      for (const key in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+          objCopy[key] = this.deepClone(obj[key]);
+        }
+      }
+      return objCopy;
+    }
+
+    /**
+     * Programmatically mutates the internal JSONModel property (e.g. for PBRE state pruning).
+     * @param path The path to the property.
+     * @param value The value to set.
+     */
+    setProperty(path, value) {
+      const absolutePath = path.startsWith("/") ? path : `/${path}`;
+      this.model.setProperty(absolutePath, value);
     }
 
     /**
@@ -164,6 +223,13 @@ sap.ui.define(["sap/ui/model/json/JSONModel", "./PipelineManager", "sap/ui/core/
      */
     destroy() {
       if (this.model) {
+        // Fix Leaky Abstractions: Clean up any ghost errors in the global MessageManager bound to this model
+        const messageManager = Messaging;
+        const existingMessages = messageManager.getMessageModel().getData();
+        const messagesToRemove = existingMessages.filter(msg => msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.model.getId());
+        if (messagesToRemove.length > 0) {
+          messageManager.removeMessages(messagesToRemove);
+        }
         this.model.destroy();
       }
     }

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

@@ -1 +1 @@
-{"version":3,"file":"StateManager-dbg.js","names":["GlobalPipeline","___PipelineManager","StateManager","schema","_useMessageManager","constructor","initialData","modelName","activeModelName","safeData","JSON","parse","stringify","model","JSONModel","setDefaultBindingMode","originalSetProperty","setProperty","bind","sPath","oValue","oContext","bAsyncUpdate","result","validatePath","setUseMessageManager","use","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","minLength","pattern","minimum","undefined","maximum","min","max","format","ui","validators","v","name","args","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 | null = null;\n    private _useMessageManager: boolean = false;\n\n    /**\n     * Initializes the state manager with an authentic SAPUI5 JSONModel.\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, unknown> = {}, 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: unknown, oContext?: unknown, bAsyncUpdate?: boolean) => {\n            const result = originalSetProperty(sPath, oValue, oContext, bAsyncUpdate);\n            this.validatePath(sPath, oValue);\n            return result;\n        };\n    }\n\n    /**\n     * Updates the flag indicating whether this manager should push validation errors directly to the global MessageManager.\n     */\n    public setUseMessageManager(use: boolean): void {\n        this._useMessageManager = use;\n    }\n\n    /**\n     * Validates a specific path against the schema and updates the MessageManager.\n     */\n    private validatePath(sPath: string, value: unknown): 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        if (this._useMessageManager) {\n            const existingMessages = messageManager.getMessageModel().getData();\n            const messagesToRemove = existingMessages.filter((msg: sap.ui.core.message.Message) => {\n                const isMatch = msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.model.getId();\n                return isMatch;\n            });\n            \n            if (messagesToRemove.length > 0) {\n                messageManager.removeMessages(messagesToRemove);\n            }\n        }\n\n        if (!metadata) return;\n\n        // 2. Run GlobalPipeline\n        const validatorsToRun: string[] = [];\n        const argsMap: Record<string, unknown> = {};\n\n        if (metadata.required) {\n            validatorsToRun.push(\"required\");\n        }\n        if (metadata.type === \"string\" && metadata.maxLength) {\n            validatorsToRun.push(\"maxLength\");\n            argsMap[\"maxLength\"] = metadata.maxLength;\n        }\n        if (metadata.minLength) {\n            validatorsToRun.push(\"minLength\");\n            argsMap[\"minLength\"] = metadata.minLength;\n        }\n        if (metadata.pattern) {\n            validatorsToRun.push(\"pattern\");\n            argsMap[\"pattern\"] = metadata.pattern;\n        }\n        if (metadata.minimum !== undefined || metadata.maximum !== undefined) {\n            validatorsToRun.push(\"range\");\n            argsMap[\"range\"] = { min: metadata.minimum, max: metadata.maximum };\n        }\n        \n        const format = metadata.ui?.format;\n        if (format === \"email\" || format === \"url\" || format === \"iban\") {\n            validatorsToRun.push(format);\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 && this._useMessageManager) {\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    /**\n     * Resolves the schema metadata for a given internal binding path.\n     * @param path The flat binding path representing the field.\n     * @returns The associated IPropertyMetadata, or undefined if not mapped.\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, unknown> {\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":[]}
+{"version":3,"file":"StateManager-dbg.js","names":["SCHEMA_TYPE","___constants_MetaUIConstants","GlobalPipeline","___PipelineManager","SchemaNormalizer","___SchemaNormalizer","StateManager","schema","_useMessageManager","constructor","initialData","modelName","activeModelName","safeData","JSON","parse","stringify","model","JSONModel","setDefaultBindingMode","originalSetProperty","setProperty","bind","sPath","oValue","oContext","bAsyncUpdate","result","validatePath","setUseMessageManager","use","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","STRING","maxLength","minLength","pattern","minimum","undefined","maximum","min","max","format","ui","validators","v","name","args","validationResult","executeValidation","isValid","newMsg","Message","message","errorMessage","coreLibrary","MessageType","Error","target","processor","addMessages","clearArrayMessages","arrayPath","currentMessages","pathPrefix","getProcessor","path","properties","absoluteScope","meta","resolveScope","getModel","bindControl","control","property","bindingPath","bindProperty","extractPayload","data","deepClone","obj","Date","getTime","Array","isArray","arrCopy","item","objCopy","key","Object","prototype","hasOwnProperty","call","absolutePath","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 { SCHEMA_TYPE } from \"../constants/MetaUIConstants\";\nimport { GlobalPipeline } from \"./PipelineManager\";\nimport { SchemaNormalizer } from \"./SchemaNormalizer\";\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 | null = null;\n    private _useMessageManager: boolean = false;\n\n    /**\n     * Initializes the state manager with an authentic SAPUI5 JSONModel.\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, unknown> = {}, 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: unknown, oContext?: unknown, bAsyncUpdate?: boolean) => {\n            const result = originalSetProperty(sPath, oValue, oContext, bAsyncUpdate);\n            this.validatePath(sPath, oValue);\n            return result;\n        };\n    }\n\n    /**\n     * Updates the flag indicating whether this manager should push validation errors directly to the global MessageManager.\n     */\n    public setUseMessageManager(use: boolean): void {\n        this._useMessageManager = use;\n    }\n\n    /**\n     * Validates a specific path against the schema and updates the MessageManager.\n     */\n    private validatePath(sPath: string, value: unknown): 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) unconditionally\n        const existingMessages = messageManager.getMessageModel().getData();\n        const messagesToRemove = existingMessages.filter((msg: Message) => {\n            const isMatch = msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.model.getId();\n            return isMatch;\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, unknown> = {};\n\n        if (metadata.required) {\n            validatorsToRun.push(\"required\");\n        }\n        if (metadata.type === SCHEMA_TYPE.STRING && metadata.maxLength) {\n            validatorsToRun.push(\"maxLength\");\n            argsMap[\"maxLength\"] = metadata.maxLength;\n        }\n        if (metadata.minLength) {\n            validatorsToRun.push(\"minLength\");\n            argsMap[\"minLength\"] = metadata.minLength;\n        }\n        if (metadata.pattern) {\n            validatorsToRun.push(\"pattern\");\n            argsMap[\"pattern\"] = metadata.pattern;\n        }\n        if (metadata.minimum !== undefined || metadata.maximum !== undefined) {\n            validatorsToRun.push(\"range\");\n            argsMap[\"range\"] = { min: metadata.minimum, max: metadata.maximum };\n        }\n        \n        const format = metadata.ui?.format;\n        if (format === \"email\" || format === \"url\" || format === \"iban\") {\n            validatorsToRun.push(format);\n        }\n        if (metadata.ui?.validators) {\n            for (const v of metadata.ui.validators) {\n                if (typeof v === SCHEMA_TYPE.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 && this._useMessageManager) {\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    /**\n     * Purges all MessageManager errors that start with a specific array path.\n     * Used to clean up \"ghost errors\" when array structural shifts (deletion) occur.\n     * @param arrayPath The root array path (e.g. /Items)\n     */\n    public clearArrayMessages(arrayPath: string): void {\n        const messageManager = Messaging;\n        const currentMessages = messageManager.getMessageModel().getData() as Message[];\n        \n        const pathPrefix = arrayPath.startsWith(\"/\") ? arrayPath : `/${arrayPath}`;\n        \n        const messagesToRemove = currentMessages.filter(msg => {\n            return msg.getProcessor() === this.model && typeof msg.getTarget() === \"string\" && msg.getTarget().startsWith(pathPrefix);\n        });\n\n        if (messagesToRemove.length > 0) {\n            messageManager.removeMessages(messagesToRemove);\n        }\n    }\n\n    /**\n     * Resolves the schema metadata for a given internal binding path.\n     * @param path The flat binding path representing the field.\n     * @returns The associated IPropertyMetadata, or undefined if not mapped.\n     */\n    private findMetadataForPath(path: string): IPropertyMetadata | undefined {\n        if (!this.schema || !this.schema.properties) return undefined;\n        \n        // Deeply resolve the metadata using the SchemaNormalizer\n        const absoluteScope = \"#/properties/\" + path.replace(/\\//g, \"/properties/\");\n        const { meta } = SchemaNormalizer.resolveScope(this.schema, absoluteScope);\n        return meta;\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, unknown> {\n        // Create a deep copy to prevent accidental mutations by the host\n        // Uses a robust deep clone to avoid destructively coercing native objects (like Dates) to strings\n        const data = this.model.getData();\n        return this.deepClone(data) as Record<string, unknown>;\n    }\n\n    /**\n     * Recursively clones an object while preserving native Date instances and arrays.\n     */\n    private deepClone(obj: any): any {\n        if (obj === null || typeof obj !== \"object\") {\n            return obj;\n        }\n\n        if (obj instanceof Date) {\n            return new Date(obj.getTime());\n        }\n\n        if (Array.isArray(obj)) {\n            const arrCopy = [];\n            for (const item of obj) {\n                arrCopy.push(this.deepClone(item));\n            }\n            return arrCopy;\n        }\n\n        const objCopy: any = {};\n        for (const key in obj) {\n            if (Object.prototype.hasOwnProperty.call(obj, key)) {\n                objCopy[key] = this.deepClone(obj[key]);\n            }\n        }\n        return objCopy;\n    }\n\n    /**\n     * Programmatically mutates the internal JSONModel property (e.g. for PBRE state pruning).\n     * @param path The path to the property.\n     * @param value The value to set.\n     */\n    public setProperty(path: string, value: unknown): void {\n        const absolutePath = path.startsWith(\"/\") ? path : `/${path}`;\n        this.model.setProperty(absolutePath, value);\n    }\n\n    /**\n     * Cleans up internal state and natively destroys the UI5 JSONModel to prevent memory leaks.\n     */\n    public destroy(): void {\n        if (this.model) {\n            // Fix Leaky Abstractions: Clean up any ghost errors in the global MessageManager bound to this model\n            const messageManager = Messaging;\n            const existingMessages = messageManager.getMessageModel().getData();\n            const messagesToRemove = existingMessages.filter((msg: Message) => \n                msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.model.getId()\n            );\n            if (messagesToRemove.length > 0) {\n                messageManager.removeMessages(messagesToRemove);\n            }\n\n            this.model.destroy();\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}