@siliconst/metaui 1.0.2 → 1.4.4

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

@@ -1,37 +1,197 @@
-sap.ui.define([], function () {
-  "use strict";
-
-  /**
-   * @file SchemaNormalizer.ts
-   * @description Transforms and validates incoming JSON payloads into the strict ISchema matrix.
-   */
-
-  /**
-   * Utility class ensuring data fidelity before layout construction begins.
-   */
-  class SchemaNormalizer {
-    /**
-     * Validates that the provided raw payload conforms to the required ISchema structures.
-     * @param rawSchema The heterogeneous JSON object provided to the Engine.
-     * @returns The strictly cast ISchema matrix.
-     * @throws Error if the mandatory schema properties are missing.
-     */
-    static normalize(rawSchema) {
-      if (!rawSchema || typeof rawSchema !== 'object') {
-        throw new Error("[MetaUI] Invalid Schema Payload: Payload is not an object.");
-      }
-      if (!rawSchema.mode || !rawSchema.rootFields || !rawSchema.tables) {
-        throw new Error("[MetaUI] Invalid Schema Payload: Missing required structures (mode, rootFields, tables).");
-      }
-
-      // Return the strongly typed and validated schema block.
-      return rawSchema;
-    }
-  }
-  var __exports = {
-    __esModule: true
-  };
-  __exports.SchemaNormalizer = SchemaNormalizer;
-  return __exports;
-});
+sap.ui.define(["../utils/Logger"], function (___utils_Logger) {
+  "use strict";
+
+  /**
+   * @file SchemaNormalizer.ts
+   * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.
+   */
+  const Logger = ___utils_Logger["Logger"];
+  class SchemaNormalizer {
+    /**
+     * Validates that the provided raw payload conforms to the required ISchema structures.
+     */
+    static normalize(rawSchema, data) {
+      let schemaObj = rawSchema;
+      if (typeof schemaObj === "string") {
+        try {
+          schemaObj = JSON.parse(schemaObj);
+        } catch (e) {
+          const msg = e.message;
+          Logger.error("[MetaUI SchemaNormalizer] Failed to parse schema string.", msg);
+          Logger.showErrorPopup(`Failed to parse the provided JSON schema.\n\nDetails: ${msg}`);
+          schemaObj = null;
+        }
+      }
+      if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {
+        return this.inferSchemaFromData(data);
+      }
+      try {
+        // It is an object. Ensure it conforms to v2 structure.
+        const normalized = {
+          title: schemaObj.title,
+          type: schemaObj.type || (schemaObj.items ? "array" : "object"),
+          layoutStrategy: schemaObj.layoutStrategy,
+          uiLayout: schemaObj.uiLayout,
+          additionalProperties: schemaObj.additionalProperties
+        };
+        let targetProperties = schemaObj.properties || {};
+        if (schemaObj.additionalProperties === true && data) {
+          const inferred = this.inferSchemaFromData(data);
+          if (inferred.type === "object" && inferred.properties) {
+            targetProperties = this.deepMergeProperties(inferred.properties, targetProperties);
+          } else if (inferred.type === "array" && inferred.items && inferred.items.properties) {
+            // Array schema merging could be added here if we want full support.
+          }
+        }
+        if (normalized.type === "object") {
+          normalized.properties = this.normalizeProperties(targetProperties);
+        } else if (normalized.type === "array") {
+          // Future expansion: array deep merge
+          normalized.items = this.normalizePropertyMetadata(schemaObj.items || {
+            type: "object",
+            properties: {}
+          }, "items");
+        }
+        return normalized;
+      } catch (error) {
+        const msg = error.message;
+        Logger.error("[MetaUI SchemaNormalizer] Critical error normalizing schema object.", msg);
+        Logger.showErrorPopup(`Schema Normalization failed.\n\nDetails: ${msg}`);
+        // Fallback to empty object to prevent hard crash downstream
+        return {
+          type: "object",
+          properties: {}
+        };
+      }
+    }
+    static deepMergeProperties(base, override) {
+      const merged = {
+        ...base
+      };
+      for (const key of Object.keys(override)) {
+        const overrideVal = override[key];
+        const baseVal = merged[key];
+        if (baseVal && typeof baseVal === "object" && !Array.isArray(baseVal) && overrideVal && typeof overrideVal === "object" && !Array.isArray(overrideVal)) {
+          merged[key] = this.deepMergeProperties(baseVal, overrideVal);
+        } else {
+          merged[key] = overrideVal;
+        }
+      }
+      return merged;
+    }
+    static normalizeProperties(properties) {
+      const normalizedProps = {};
+      for (const key of Object.keys(properties)) {
+        normalizedProps[key] = this.normalizePropertyMetadata(properties[key], key);
+      }
+      return normalizedProps;
+    }
+    static normalizePropertyMetadata(prop, keyName) {
+      const normalized = {
+        type: prop.type || "string",
+        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),
+          visibleOn: prop.ui?.visibleOn,
+          enabledOn: prop.ui?.enabledOn,
+          format: prop.ui?.format,
+          validators: prop.ui?.validators,
+          formatter: prop.ui?.formatter,
+          args: prop.ui?.args,
+          rows: prop.ui?.rows,
+          fullWidth: prop.ui?.fullWidth
+        },
+        required: !!prop.required,
+        maxLength: prop.maxLength,
+        minimum: prop.minimum,
+        maximum: prop.maximum,
+        pattern: prop.pattern,
+        precision: prop.precision,
+        scale: prop.scale,
+        valueHelp: prop.valueHelp,
+        enum: prop.enum
+      };
+      if (normalized.type === "object" && prop.properties) {
+        normalized.properties = this.normalizeProperties(prop.properties);
+        normalized.uiLayout = prop.uiLayout;
+      } else if (normalized.type === "array" && prop.items) {
+        normalized.items = this.normalizePropertyMetadata(prop.items, "items");
+        normalized.uiLayout = prop.uiLayout;
+      }
+      return normalized;
+    }
+
+    /**
+     * Generates a Title Case label from camelCase or snake_case technical names.
+     */
+    static generateLabel(name) {
+      if (!name) return "";
+      let spaced = name.replace(/([A-Z])/g, " $1").replace(/_/g, " ");
+      return spaced.split(' ').filter(w => w.length > 0).map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(' ').trim();
+    }
+
+    /**
+     * Infers a v2 ISchema structure dynamically from a plain data payload.
+     */
+    static inferSchemaFromData(data) {
+      const schema = {
+        type: "object",
+        properties: {},
+        layoutStrategy: "compact",
+        title: ""
+      };
+      if (!data || typeof data !== "object") {
+        return schema;
+      }
+      if (Array.isArray(data)) {
+        schema.type = "array";
+        schema.layoutStrategy = "table";
+        schema.items = {
+          type: "object",
+          layoutStrategy: "compact",
+          properties: data.length > 0 ? this.inferPropertiesFromObject(data[0]) : {}
+        };
+      } else {
+        schema.type = "object";
+        schema.properties = this.inferPropertiesFromObject(data);
+      }
+      return schema;
+    }
+    static inferPropertiesFromObject(obj) {
+      const properties = {};
+      if (!obj || typeof obj !== "object") return properties;
+      for (const key of Object.keys(obj)) {
+        const val = obj[key];
+        if (val === null || val === undefined) continue;
+        if (typeof val === "object" && !Array.isArray(val)) continue;
+        let type = "string";
+        let items;
+        if (typeof val === "number") type = "number";else if (typeof val === "boolean") type = "boolean";else if (Array.isArray(val)) {
+          type = "array";
+          items = {
+            type: "object",
+            properties: val.length > 0 ? this.inferPropertiesFromObject(val[0]) : {}
+          };
+        }
+        properties[key] = {
+          type,
+          items,
+          ui: {
+            label: this.generateLabel(key),
+            isKey: false,
+            readOnly: false
+          }
+        };
+      }
+      return properties;
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.SchemaNormalizer = SchemaNormalizer;
+  return __exports;
+});
 //# sourceMappingURL=SchemaNormalizer-dbg.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"SchemaNormalizer-dbg.js","names":["SchemaNormalizer","normalize","rawSchema","Error","mode","rootFields","tables","__exports","__esModule"],"sources":["SchemaNormalizer.ts"],"sourcesContent":["/**\r\n * @file SchemaNormalizer.ts\r\n * @description Transforms and validates incoming JSON payloads into the strict ISchema matrix.\r\n */\r\n\r\nimport { ISchema } from \"../interfaces/ISchema\";\r\n\r\n/**\r\n * Utility class ensuring data fidelity before layout construction begins.\r\n */\r\nexport class SchemaNormalizer {\r\n    \r\n    /**\r\n     * Validates that the provided raw payload conforms to the required ISchema structures.\r\n     * @param rawSchema The heterogeneous JSON object provided to the Engine.\r\n     * @returns The strictly cast ISchema matrix.\r\n     * @throws Error if the mandatory schema properties are missing.\r\n     */\r\n    public static normalize(rawSchema: any): ISchema {\r\n        if (!rawSchema || typeof rawSchema !== 'object') {\r\n            throw new Error(\"[MetaUI] Invalid Schema Payload: Payload is not an object.\");\r\n        }\r\n        \r\n        if (!rawSchema.mode || !rawSchema.rootFields || !rawSchema.tables) {\r\n            throw new Error(\"[MetaUI] Invalid Schema Payload: Missing required structures (mode, rootFields, tables).\");\r\n        }\r\n\r\n        // Return the strongly typed and validated schema block.\r\n        return rawSchema as ISchema;\r\n    }\r\n}\r\n"],"mappings":";;;EAAA;AACA;AACA;AACA;;EAIA;AACA;AACA;EACO,MAAMA,gBAAgB,CAAC;IAE1B;AACJ;AACA;AACA;AACA;AACA;IACI,OAAcC,SAASA,CAACC,SAAc,EAAW;MAC7C,IAAI,CAACA,SAAS,IAAI,OAAOA,SAAS,KAAK,QAAQ,EAAE;QAC7C,MAAM,IAAIC,KAAK,CAAC,4DAA4D,CAAC;MACjF;MAEA,IAAI,CAACD,SAAS,CAACE,IAAI,IAAI,CAACF,SAAS,CAACG,UAAU,IAAI,CAACH,SAAS,CAACI,MAAM,EAAE;QAC/D,MAAM,IAAIH,KAAK,CAAC,0FAA0F,CAAC;MAC/G;;MAEA;MACA,OAAOD,SAAS;IACpB;EACJ;EAAC,IAAAK,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAP,gBAAA,GAAAA,gBAAA;EAAA,OAAAO,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"SchemaNormalizer-dbg.js","names":["Logger","___utils_Logger","SchemaNormalizer","normalize","rawSchema","data","schemaObj","JSON","parse","e","msg","message","error","showErrorPopup","Array","isArray","inferSchemaFromData","normalized","title","type","items","layoutStrategy","uiLayout","additionalProperties","targetProperties","properties","inferred","deepMergeProperties","normalizeProperties","normalizePropertyMetadata","base","override","merged","key","Object","keys","overrideVal","baseVal","normalizedProps","prop","keyName","ui","label","generateLabel","isKey","readOnly","widget","valueHelp","enum","undefined","visibleOn","enabledOn","format","validators","formatter","args","rows","fullWidth","required","maxLength","minimum","maximum","pattern","precision","scale","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","trim","schema","inferPropertiesFromObject","obj","val","__exports","__esModule"],"sources":["SchemaNormalizer.ts"],"sourcesContent":["/**\n * @file SchemaNormalizer.ts\n * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.\n */\n\nimport { ISchema, IPropertyMetadata, FieldType } from \"../interfaces/ISchema\";\nimport { Logger } from \"../utils/Logger\";\n\nexport class SchemaNormalizer {\n\n    /**\n     * Validates that the provided raw payload conforms to the required ISchema structures.\n     */\n    public static normalize(rawSchema?: any, data?: any): ISchema {\n        let schemaObj = rawSchema;\n\n        if (typeof schemaObj === \"string\") {\n            try {\n                schemaObj = JSON.parse(schemaObj);\n            } catch (e) {\n                const msg = (e as Error).message;\n                Logger.error(\"[MetaUI SchemaNormalizer] Failed to parse schema string.\", msg);\n                Logger.showErrorPopup(`Failed to parse the provided JSON schema.\\n\\nDetails: ${msg}`);\n                schemaObj = null;\n            }\n        }\n\n        if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {\n            return this.inferSchemaFromData(data);\n        }\n\n        try {\n            // It is an object. Ensure it conforms to v2 structure.\n            const normalized: ISchema = {\n                title: schemaObj.title,\n                type: schemaObj.type || (schemaObj.items ? \"array\" : \"object\"),\n                layoutStrategy: schemaObj.layoutStrategy,\n                uiLayout: schemaObj.uiLayout,\n                additionalProperties: schemaObj.additionalProperties\n            };\n\n            let targetProperties = schemaObj.properties || {};\n\n            if (schemaObj.additionalProperties === true && data) {\n                const inferred = this.inferSchemaFromData(data);\n                if (inferred.type === \"object\" && inferred.properties) {\n                    targetProperties = this.deepMergeProperties(inferred.properties, targetProperties);\n                } else if (inferred.type === \"array\" && inferred.items && inferred.items.properties) {\n                    // Array schema merging could be added here if we want full support.\n                }\n            }\n\n            if (normalized.type === \"object\") {\n                normalized.properties = this.normalizeProperties(targetProperties);\n            } else if (normalized.type === \"array\") {\n                // Future expansion: array deep merge\n                normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: \"object\", properties: {} }, \"items\");\n            }\n\n            return normalized;\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(\"[MetaUI SchemaNormalizer] Critical error normalizing schema object.\", msg);\n            Logger.showErrorPopup(`Schema Normalization failed.\\n\\nDetails: ${msg}`);\n            // Fallback to empty object to prevent hard crash downstream\n            return { type: \"object\", properties: {} };\n        }\n    }\n\n    private static deepMergeProperties(base: any, override: any): any {\n        const merged = { ...base };\n        for (const key of Object.keys(override)) {\n            const overrideVal = override[key];\n            const baseVal = merged[key];\n\n            if (baseVal && typeof baseVal === \"object\" && !Array.isArray(baseVal) &&\n                overrideVal && typeof overrideVal === \"object\" && !Array.isArray(overrideVal)) {\n                merged[key] = this.deepMergeProperties(baseVal, overrideVal);\n            } else {\n                merged[key] = overrideVal;\n            }\n        }\n        return merged;\n    }\n\n    private static normalizeProperties(properties: any): Record<string, IPropertyMetadata> {\n        const normalizedProps: Record<string, IPropertyMetadata> = {};\n        for (const key of Object.keys(properties)) {\n            normalizedProps[key] = this.normalizePropertyMetadata(properties[key], key);\n        }\n        return normalizedProps;\n    }\n\n    private static normalizePropertyMetadata(prop: any, keyName: string): IPropertyMetadata {\n        const normalized: IPropertyMetadata = {\n            type: prop.type || \"string\",\n            ui: {\n                label: prop.ui?.label || this.generateLabel(keyName),\n                isKey: !!prop.ui?.isKey,\n                readOnly: !!prop.ui?.readOnly,\n                widget: prop.ui?.widget || (prop.valueHelp || prop.enum ? \"select\" : undefined),\n                visibleOn: prop.ui?.visibleOn,\n                enabledOn: prop.ui?.enabledOn,\n                format: prop.ui?.format,\n                validators: prop.ui?.validators,\n                formatter: prop.ui?.formatter,\n                args: prop.ui?.args,\n                rows: prop.ui?.rows,\n                fullWidth: prop.ui?.fullWidth\n            },\n            required: !!prop.required,\n            maxLength: prop.maxLength,\n            minimum: prop.minimum,\n            maximum: prop.maximum,\n            pattern: prop.pattern,\n            precision: prop.precision,\n            scale: prop.scale,\n            valueHelp: prop.valueHelp,\n            enum: prop.enum\n        };\n\n        if (normalized.type === \"object\" && prop.properties) {\n            normalized.properties = this.normalizeProperties(prop.properties);\n            normalized.uiLayout = prop.uiLayout;\n        } else if (normalized.type === \"array\" && prop.items) {\n            normalized.items = this.normalizePropertyMetadata(prop.items, \"items\");\n            normalized.uiLayout = prop.uiLayout;\n        }\n\n        return normalized;\n    }\n\n    /**\n     * Generates a Title Case label from camelCase or snake_case technical names.\n     */\n    private static generateLabel(name: string): string {\n        if (!name) return \"\";\n        let spaced = name.replace(/([A-Z])/g, \" $1\").replace(/_/g, \" \");\n        return spaced.split(' ')\n            .filter(w => w.length > 0)\n            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n            .join(' ')\n            .trim();\n    }\n\n    /**\n     * Infers a v2 ISchema structure dynamically from a plain data payload.\n     */\n    private static inferSchemaFromData(data: any): ISchema {\n        const schema: ISchema = { type: \"object\", properties: {}, layoutStrategy: \"compact\", title: \"\" };\n\n        if (!data || typeof data !== \"object\") {\n            return schema;\n        }\n\n        if (Array.isArray(data)) {\n            schema.type = \"array\";\n            schema.layoutStrategy = \"table\";\n            schema.items = {\n                type: \"object\",\n                layoutStrategy: \"compact\",\n                properties: data.length > 0 ? this.inferPropertiesFromObject(data[0]) : {}\n            };\n        } else {\n            schema.type = \"object\";\n            schema.properties = this.inferPropertiesFromObject(data);\n        }\n\n        return schema;\n    }\n\n    private static inferPropertiesFromObject(obj: any): Record<string, IPropertyMetadata> {\n        const properties: Record<string, IPropertyMetadata> = {};\n        if (!obj || typeof obj !== \"object\") return properties;\n\n        for (const key of Object.keys(obj)) {\n            const val = obj[key];\n            if (val === null || val === undefined) continue;\n\n            if (typeof val === \"object\" && !Array.isArray(val)) continue;\n\n            let type: FieldType = \"string\";\n            let items: IPropertyMetadata | undefined;\n\n            if (typeof val === \"number\") type = \"number\";\n            else if (typeof val === \"boolean\") type = \"boolean\";\n            else if (Array.isArray(val)) {\n                type = \"array\";\n                items = {\n                    type: \"object\",\n                    properties: val.length > 0 ? this.inferPropertiesFromObject(val[0]) : {}\n                };\n            }\n\n            properties[key] = {\n                type,\n                items,\n                ui: {\n                    label: this.generateLabel(key),\n                    isKey: false,\n                    readOnly: false\n                }\n            };\n        }\n\n        return properties;\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -1,20 +1,26 @@
 declare module "nz/co/siliconst/ui5/metaui/core/SchemaNormalizer" {
     /**
      * @file SchemaNormalizer.ts
-     * @description Transforms and validates incoming JSON payloads into the strict ISchema matrix.
+     * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.
      */
     import { ISchema } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
-    /**
-     * Utility class ensuring data fidelity before layout construction begins.
-     */
     export class SchemaNormalizer {
         /**
          * Validates that the provided raw payload conforms to the required ISchema structures.
-         * @param rawSchema The heterogeneous JSON object provided to the Engine.
-         * @returns The strictly cast ISchema matrix.
-         * @throws Error if the mandatory schema properties are missing.
          */
-        static normalize(rawSchema: any): ISchema;
+        static normalize(rawSchema?: any, data?: any): ISchema;
+        private static deepMergeProperties;
+        private static normalizeProperties;
+        private static normalizePropertyMetadata;
+        /**
+         * Generates a Title Case label from camelCase or snake_case technical names.
+         */
+        private static generateLabel;
+        /**
+         * Infers a v2 ISchema structure dynamically from a plain data payload.
+         */
+        private static inferSchemaFromData;
+        private static inferPropertiesFromObject;
     }
 }
 //# sourceMappingURL=SchemaNormalizer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SchemaNormalizer.d.ts","sourceRoot":"..\\..\\..\\..\\..\\..\\..\\..","sources":["src\\nz\\co\\siliconst\\ui5\\metaui\\core\\SchemaNormalizer.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,kDAAkD,CAAC;IAClE;;;OAGG;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;IAExE;;OAEG;IACH,MAAa,gBAAgB;QAEzB;;;;;WAKG;eACW,SAAS,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO;KAYnD;CAEA"}
+{"version":3,"file":"SchemaNormalizer.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/SchemaNormalizer.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,kDAAkD,CAAC;IAClE;;;OAGG;IAEH,OAAO,EAAE,OAAO,EAAgC,MAAM,+CAA+C,CAAC;IAGtG,MAAa,gBAAgB;QAEzB;;WAEG;eACW,SAAS,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO;QAwD7D,OAAO,CAAC,MAAM,CAAC,mBAAmB;QAgBlC,OAAO,CAAC,MAAM,CAAC,mBAAmB;QAQlC,OAAO,CAAC,MAAM,CAAC,yBAAyB;QAuCxC;;WAEG;QACH,OAAO,CAAC,MAAM,CAAC,aAAa;QAU5B;;WAEG;QACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;QAuBlC,OAAO,CAAC,MAAM,CAAC,yBAAyB;KAoC3C;CAEA"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"SchemaNormalizer.js","names":["SchemaNormalizer","normalize","rawSchema","Error","mode","rootFields","tables","__exports","__esModule"],"sources":["SchemaNormalizer.ts"],"sourcesContent":["/**\r\n * @file SchemaNormalizer.ts\r\n * @description Transforms and validates incoming JSON payloads into the strict ISchema matrix.\r\n */\r\n\r\nimport { ISchema } from \"../interfaces/ISchema\";\r\n\r\n/**\r\n * Utility class ensuring data fidelity before layout construction begins.\r\n */\r\nexport class SchemaNormalizer {\r\n    \r\n    /**\r\n     * Validates that the provided raw payload conforms to the required ISchema structures.\r\n     * @param rawSchema The heterogeneous JSON object provided to the Engine.\r\n     * @returns The strictly cast ISchema matrix.\r\n     * @throws Error if the mandatory schema properties are missing.\r\n     */\r\n    public static normalize(rawSchema: any): ISchema {\r\n        if (!rawSchema || typeof rawSchema !== 'object') {\r\n            throw new Error(\"[MetaUI] Invalid Schema Payload: Payload is not an object.\");\r\n        }\r\n        \r\n        if (!rawSchema.mode || !rawSchema.rootFields || !rawSchema.tables) {\r\n            throw new Error(\"[MetaUI] Invalid Schema Payload: Missing required structures (mode, rootFields, tables).\");\r\n        }\r\n\r\n        // Return the strongly typed and validated schema block.\r\n        return rawSchema as ISchema;\r\n    }\r\n}\r\n"],"mappings":"yCAUO,MAAMA,EAQT,gBAAcC,CAAUC,GACpB,IAAKA,UAAoBA,IAAc,SAAU,CAC7C,MAAM,IAAIC,MAAM,6DACpB,CAEA,IAAKD,EAAUE,OAASF,EAAUG,aAAeH,EAAUI,OAAQ,CAC/D,MAAM,IAAIH,MAAM,2FACpB,CAGA,OAAOD,CACX,EACH,IAAAK,EAAA,CAAAC,WAAA,MAAAD,EAAAP,mBAAA,OAAAO,CAAA","ignoreList":[]}
+{"version":3,"file":"SchemaNormalizer.js","names":["Logger","___utils_Logger","SchemaNormalizer","normalize","rawSchema","data","schemaObj","JSON","parse","e","msg","message","error","showErrorPopup","Array","isArray","this","inferSchemaFromData","normalized","title","type","items","layoutStrategy","uiLayout","additionalProperties","targetProperties","properties","inferred","deepMergeProperties","normalizeProperties","normalizePropertyMetadata","base","override","merged","key","Object","keys","overrideVal","baseVal","normalizedProps","prop","keyName","ui","label","generateLabel","isKey","readOnly","widget","valueHelp","enum","undefined","visibleOn","enabledOn","format","validators","formatter","args","rows","fullWidth","required","maxLength","minimum","maximum","pattern","precision","scale","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","trim","schema","inferPropertiesFromObject","obj","val","__exports","__esModule"],"sources":["SchemaNormalizer.ts"],"sourcesContent":["/**\n * @file SchemaNormalizer.ts\n * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.\n */\n\nimport { ISchema, IPropertyMetadata, FieldType } from \"../interfaces/ISchema\";\nimport { Logger } from \"../utils/Logger\";\n\nexport class SchemaNormalizer {\n\n    /**\n     * Validates that the provided raw payload conforms to the required ISchema structures.\n     */\n    public static normalize(rawSchema?: any, data?: any): ISchema {\n        let schemaObj = rawSchema;\n\n        if (typeof schemaObj === \"string\") {\n            try {\n                schemaObj = JSON.parse(schemaObj);\n            } catch (e) {\n                const msg = (e as Error).message;\n                Logger.error(\"[MetaUI SchemaNormalizer] Failed to parse schema string.\", msg);\n                Logger.showErrorPopup(`Failed to parse the provided JSON schema.\\n\\nDetails: ${msg}`);\n                schemaObj = null;\n            }\n        }\n\n        if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {\n            return this.inferSchemaFromData(data);\n        }\n\n        try {\n            // It is an object. Ensure it conforms to v2 structure.\n            const normalized: ISchema = {\n                title: schemaObj.title,\n                type: schemaObj.type || (schemaObj.items ? \"array\" : \"object\"),\n                layoutStrategy: schemaObj.layoutStrategy,\n                uiLayout: schemaObj.uiLayout,\n                additionalProperties: schemaObj.additionalProperties\n            };\n\n            let targetProperties = schemaObj.properties || {};\n\n            if (schemaObj.additionalProperties === true && data) {\n                const inferred = this.inferSchemaFromData(data);\n                if (inferred.type === \"object\" && inferred.properties) {\n                    targetProperties = this.deepMergeProperties(inferred.properties, targetProperties);\n                } else if (inferred.type === \"array\" && inferred.items && inferred.items.properties) {\n                    // Array schema merging could be added here if we want full support.\n                }\n            }\n\n            if (normalized.type === \"object\") {\n                normalized.properties = this.normalizeProperties(targetProperties);\n            } else if (normalized.type === \"array\") {\n                // Future expansion: array deep merge\n                normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: \"object\", properties: {} }, \"items\");\n            }\n\n            return normalized;\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(\"[MetaUI SchemaNormalizer] Critical error normalizing schema object.\", msg);\n            Logger.showErrorPopup(`Schema Normalization failed.\\n\\nDetails: ${msg}`);\n            // Fallback to empty object to prevent hard crash downstream\n            return { type: \"object\", properties: {} };\n        }\n    }\n\n    private static deepMergeProperties(base: any, override: any): any {\n        const merged = { ...base };\n        for (const key of Object.keys(override)) {\n            const overrideVal = override[key];\n            const baseVal = merged[key];\n\n            if (baseVal && typeof baseVal === \"object\" && !Array.isArray(baseVal) &&\n                overrideVal && typeof overrideVal === \"object\" && !Array.isArray(overrideVal)) {\n                merged[key] = this.deepMergeProperties(baseVal, overrideVal);\n            } else {\n                merged[key] = overrideVal;\n            }\n        }\n        return merged;\n    }\n\n    private static normalizeProperties(properties: any): Record<string, IPropertyMetadata> {\n        const normalizedProps: Record<string, IPropertyMetadata> = {};\n        for (const key of Object.keys(properties)) {\n            normalizedProps[key] = this.normalizePropertyMetadata(properties[key], key);\n        }\n        return normalizedProps;\n    }\n\n    private static normalizePropertyMetadata(prop: any, keyName: string): IPropertyMetadata {\n        const normalized: IPropertyMetadata = {\n            type: prop.type || \"string\",\n            ui: {\n                label: prop.ui?.label || this.generateLabel(keyName),\n                isKey: !!prop.ui?.isKey,\n                readOnly: !!prop.ui?.readOnly,\n                widget: prop.ui?.widget || (prop.valueHelp || prop.enum ? \"select\" : undefined),\n                visibleOn: prop.ui?.visibleOn,\n                enabledOn: prop.ui?.enabledOn,\n                format: prop.ui?.format,\n                validators: prop.ui?.validators,\n                formatter: prop.ui?.formatter,\n                args: prop.ui?.args,\n                rows: prop.ui?.rows,\n                fullWidth: prop.ui?.fullWidth\n            },\n            required: !!prop.required,\n            maxLength: prop.maxLength,\n            minimum: prop.minimum,\n            maximum: prop.maximum,\n            pattern: prop.pattern,\n            precision: prop.precision,\n            scale: prop.scale,\n            valueHelp: prop.valueHelp,\n            enum: prop.enum\n        };\n\n        if (normalized.type === \"object\" && prop.properties) {\n            normalized.properties = this.normalizeProperties(prop.properties);\n            normalized.uiLayout = prop.uiLayout;\n        } else if (normalized.type === \"array\" && prop.items) {\n            normalized.items = this.normalizePropertyMetadata(prop.items, \"items\");\n            normalized.uiLayout = prop.uiLayout;\n        }\n\n        return normalized;\n    }\n\n    /**\n     * Generates a Title Case label from camelCase or snake_case technical names.\n     */\n    private static generateLabel(name: string): string {\n        if (!name) return \"\";\n        let spaced = name.replace(/([A-Z])/g, \" $1\").replace(/_/g, \" \");\n        return spaced.split(' ')\n            .filter(w => w.length > 0)\n            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n            .join(' ')\n            .trim();\n    }\n\n    /**\n     * Infers a v2 ISchema structure dynamically from a plain data payload.\n     */\n    private static inferSchemaFromData(data: any): ISchema {\n        const schema: ISchema = { type: \"object\", properties: {}, layoutStrategy: \"compact\", title: \"\" };\n\n        if (!data || typeof data !== \"object\") {\n            return schema;\n        }\n\n        if (Array.isArray(data)) {\n            schema.type = \"array\";\n            schema.layoutStrategy = \"table\";\n            schema.items = {\n                type: \"object\",\n                layoutStrategy: \"compact\",\n                properties: data.length > 0 ? this.inferPropertiesFromObject(data[0]) : {}\n            };\n        } else {\n            schema.type = \"object\";\n            schema.properties = this.inferPropertiesFromObject(data);\n        }\n\n        return schema;\n    }\n\n    private static inferPropertiesFromObject(obj: any): Record<string, IPropertyMetadata> {\n        const properties: Record<string, IPropertyMetadata> = {};\n        if (!obj || typeof obj !== \"object\") return properties;\n\n        for (const key of Object.keys(obj)) {\n            const val = obj[key];\n            if (val === null || val === undefined) continue;\n\n            if (typeof val === \"object\" && !Array.isArray(val)) continue;\n\n            let type: FieldType = \"string\";\n            let items: IPropertyMetadata | undefined;\n\n            if (typeof val === \"number\") type = \"number\";\n            else if (typeof val === \"boolean\") type = \"boolean\";\n            else if (Array.isArray(val)) {\n                type = \"array\";\n                items = {\n                    type: \"object\",\n                    properties: val.length > 0 ? this.inferPropertiesFromObject(val[0]) : {}\n                };\n            }\n\n            properties[key] = {\n                type,\n                items,\n                ui: {\n                    label: this.generateLabel(key),\n                    isKey: false,\n                    readOnly: false\n                }\n            };\n        }\n\n        return properties;\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -1,31 +1,208 @@
-/**
- * @file SchemaNormalizer.ts
- * @description Transforms and validates incoming JSON payloads into the strict ISchema matrix.
- */
-
-import { ISchema } from "../interfaces/ISchema";
-
-/**
- * Utility class ensuring data fidelity before layout construction begins.
- */
-export class SchemaNormalizer {
-    
-    /**
-     * Validates that the provided raw payload conforms to the required ISchema structures.
-     * @param rawSchema The heterogeneous JSON object provided to the Engine.
-     * @returns The strictly cast ISchema matrix.
-     * @throws Error if the mandatory schema properties are missing.
-     */
-    public static normalize(rawSchema: any): ISchema {
-        if (!rawSchema || typeof rawSchema !== 'object') {
-            throw new Error("[MetaUI] Invalid Schema Payload: Payload is not an object.");
-        }
-        
-        if (!rawSchema.mode || !rawSchema.rootFields || !rawSchema.tables) {
-            throw new Error("[MetaUI] Invalid Schema Payload: Missing required structures (mode, rootFields, tables).");
-        }
-
-        // Return the strongly typed and validated schema block.
-        return rawSchema as ISchema;
-    }
-}
+/**
+ * @file SchemaNormalizer.ts
+ * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.
+ */
+
+import { ISchema, IPropertyMetadata, FieldType } from "../interfaces/ISchema";
+import { Logger } from "../utils/Logger";
+
+export class SchemaNormalizer {
+
+    /**
+     * Validates that the provided raw payload conforms to the required ISchema structures.
+     */
+    public static normalize(rawSchema?: any, data?: any): ISchema {
+        let schemaObj = rawSchema;
+
+        if (typeof schemaObj === "string") {
+            try {
+                schemaObj = JSON.parse(schemaObj);
+            } catch (e) {
+                const msg = (e as Error).message;
+                Logger.error("[MetaUI SchemaNormalizer] Failed to parse schema string.", msg);
+                Logger.showErrorPopup(`Failed to parse the provided JSON schema.\n\nDetails: ${msg}`);
+                schemaObj = null;
+            }
+        }
+
+        if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {
+            return this.inferSchemaFromData(data);
+        }
+
+        try {
+            // It is an object. Ensure it conforms to v2 structure.
+            const normalized: ISchema = {
+                title: schemaObj.title,
+                type: schemaObj.type || (schemaObj.items ? "array" : "object"),
+                layoutStrategy: schemaObj.layoutStrategy,
+                uiLayout: schemaObj.uiLayout,
+                additionalProperties: schemaObj.additionalProperties
+            };
+
+            let targetProperties = schemaObj.properties || {};
+
+            if (schemaObj.additionalProperties === true && data) {
+                const inferred = this.inferSchemaFromData(data);
+                if (inferred.type === "object" && inferred.properties) {
+                    targetProperties = this.deepMergeProperties(inferred.properties, targetProperties);
+                } else if (inferred.type === "array" && inferred.items && inferred.items.properties) {
+                    // Array schema merging could be added here if we want full support.
+                }
+            }
+
+            if (normalized.type === "object") {
+                normalized.properties = this.normalizeProperties(targetProperties);
+            } else if (normalized.type === "array") {
+                // Future expansion: array deep merge
+                normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: "object", properties: {} }, "items");
+            }
+
+            return normalized;
+        } catch (error) {
+            const msg = (error as Error).message;
+            Logger.error("[MetaUI SchemaNormalizer] Critical error normalizing schema object.", msg);
+            Logger.showErrorPopup(`Schema Normalization failed.\n\nDetails: ${msg}`);
+            // Fallback to empty object to prevent hard crash downstream
+            return { type: "object", properties: {} };
+        }
+    }
+
+    private static deepMergeProperties(base: any, override: any): any {
+        const merged = { ...base };
+        for (const key of Object.keys(override)) {
+            const overrideVal = override[key];
+            const baseVal = merged[key];
+
+            if (baseVal && typeof baseVal === "object" && !Array.isArray(baseVal) &&
+                overrideVal && typeof overrideVal === "object" && !Array.isArray(overrideVal)) {
+                merged[key] = this.deepMergeProperties(baseVal, overrideVal);
+            } else {
+                merged[key] = overrideVal;
+            }
+        }
+        return merged;
+    }
+
+    private static normalizeProperties(properties: any): Record<string, IPropertyMetadata> {
+        const normalizedProps: Record<string, IPropertyMetadata> = {};
+        for (const key of Object.keys(properties)) {
+            normalizedProps[key] = this.normalizePropertyMetadata(properties[key], key);
+        }
+        return normalizedProps;
+    }
+
+    private static normalizePropertyMetadata(prop: any, keyName: string): IPropertyMetadata {
+        const normalized: IPropertyMetadata = {
+            type: prop.type || "string",
+            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),
+                visibleOn: prop.ui?.visibleOn,
+                enabledOn: prop.ui?.enabledOn,
+                format: prop.ui?.format,
+                validators: prop.ui?.validators,
+                formatter: prop.ui?.formatter,
+                args: prop.ui?.args,
+                rows: prop.ui?.rows,
+                fullWidth: prop.ui?.fullWidth
+            },
+            required: !!prop.required,
+            maxLength: prop.maxLength,
+            minimum: prop.minimum,
+            maximum: prop.maximum,
+            pattern: prop.pattern,
+            precision: prop.precision,
+            scale: prop.scale,
+            valueHelp: prop.valueHelp,
+            enum: prop.enum
+        };
+
+        if (normalized.type === "object" && prop.properties) {
+            normalized.properties = this.normalizeProperties(prop.properties);
+            normalized.uiLayout = prop.uiLayout;
+        } else if (normalized.type === "array" && prop.items) {
+            normalized.items = this.normalizePropertyMetadata(prop.items, "items");
+            normalized.uiLayout = prop.uiLayout;
+        }
+
+        return normalized;
+    }
+
+    /**
+     * Generates a Title Case label from camelCase or snake_case technical names.
+     */
+    private static generateLabel(name: string): string {
+        if (!name) return "";
+        let spaced = name.replace(/([A-Z])/g, " $1").replace(/_/g, " ");
+        return spaced.split(' ')
+            .filter(w => w.length > 0)
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+            .join(' ')
+            .trim();
+    }
+
+    /**
+     * Infers a v2 ISchema structure dynamically from a plain data payload.
+     */
+    private static inferSchemaFromData(data: any): ISchema {
+        const schema: ISchema = { type: "object", properties: {}, layoutStrategy: "compact", title: "" };
+
+        if (!data || typeof data !== "object") {
+            return schema;
+        }
+
+        if (Array.isArray(data)) {
+            schema.type = "array";
+            schema.layoutStrategy = "table";
+            schema.items = {
+                type: "object",
+                layoutStrategy: "compact",
+                properties: data.length > 0 ? this.inferPropertiesFromObject(data[0]) : {}
+            };
+        } else {
+            schema.type = "object";
+            schema.properties = this.inferPropertiesFromObject(data);
+        }
+
+        return schema;
+    }
+
+    private static inferPropertiesFromObject(obj: any): Record<string, IPropertyMetadata> {
+        const properties: Record<string, IPropertyMetadata> = {};
+        if (!obj || typeof obj !== "object") return properties;
+
+        for (const key of Object.keys(obj)) {
+            const val = obj[key];
+            if (val === null || val === undefined) continue;
+
+            if (typeof val === "object" && !Array.isArray(val)) continue;
+
+            let type: FieldType = "string";
+            let items: IPropertyMetadata | undefined;
+
+            if (typeof val === "number") type = "number";
+            else if (typeof val === "boolean") type = "boolean";
+            else if (Array.isArray(val)) {
+                type = "array";
+                items = {
+                    type: "object",
+                    properties: val.length > 0 ? this.inferPropertiesFromObject(val[0]) : {}
+                };
+            }
+
+            properties[key] = {
+                type,
+                items,
+                ui: {
+                    label: this.generateLabel(key),
+                    isKey: false,
+                    readOnly: false
+                }
+            };
+        }
+
+        return properties;
+    }
+}