@siliconst/metaui 1.0.2 → 1.2.0

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

@@ -1,37 +1,146 @@
-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([], function () {
+  "use strict";
+
+  /**
+   * @file SchemaNormalizer.ts
+   * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.
+   */
+
+  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) {
+          console.warn("[MetaUI] Failed to parse schema string, falling back to inference.", e);
+          schemaObj = null;
+        }
+      }
+      if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {
+        return this.inferSchemaFromData(data);
+      }
+
+      // It is an object. Ensure it conforms to v2 structure.
+      const normalized = {
+        title: schemaObj.title || "MetaUI Generated Form",
+        type: schemaObj.type || (schemaObj.items ? "array" : "object")
+      };
+      if (normalized.type === "object") {
+        normalized.properties = this.normalizeProperties(schemaObj.properties || {});
+      } else if (normalized.type === "array") {
+        normalized.items = this.normalizePropertyMetadata(schemaObj.items || {
+          type: "object",
+          properties: {}
+        }, "items");
+      }
+      return normalized;
+    }
+    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,
+          group: prop.ui?.group,
+          visibleOn: prop.ui?.visibleOn,
+          enabledOn: prop.ui?.enabledOn,
+          format: prop.ui?.format
+        },
+        required: !!prop.required,
+        maxLength: prop.maxLength,
+        minimum: prop.minimum,
+        maximum: prop.maximum,
+        pattern: prop.pattern,
+        precision: prop.precision,
+        scale: prop.scale,
+        valueHelp: prop.valueHelp
+      };
+      if (normalized.type === "object" && prop.properties) {
+        normalized.properties = this.normalizeProperties(prop.properties);
+      } else if (normalized.type === "array" && prop.items) {
+        normalized.items = this.normalizePropertyMetadata(prop.items, "items");
+      }
+      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: {}
+      };
+      if (!data || typeof data !== "object") {
+        return schema;
+      }
+      if (Array.isArray(data)) {
+        schema.type = "array";
+        schema.items = {
+          type: "object",
+          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":["SchemaNormalizer","normalize","rawSchema","data","schemaObj","JSON","parse","e","console","warn","Array","isArray","inferSchemaFromData","normalized","title","type","items","properties","normalizeProperties","normalizePropertyMetadata","normalizedProps","key","Object","keys","prop","keyName","ui","label","generateLabel","isKey","readOnly","widget","group","visibleOn","enabledOn","format","required","maxLength","minimum","maximum","pattern","precision","scale","valueHelp","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","trim","schema","inferPropertiesFromObject","obj","val","undefined","__exports","__esModule"],"sources":["SchemaNormalizer.ts"],"sourcesContent":["/**\n * @file SchemaNormalizer.ts\n * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.\n */\n\nimport { ISchema, IPropertyMetadata, FieldType } from \"../interfaces/ISchema\";\n\nexport class SchemaNormalizer {\n    \n    /**\n     * Validates that the provided raw payload conforms to the required ISchema structures.\n     */\n    public static normalize(rawSchema?: any, data?: any): ISchema {\n        let schemaObj = rawSchema;\n\n        if (typeof schemaObj === \"string\") {\n            try {\n                schemaObj = JSON.parse(schemaObj);\n            } catch (e) {\n                console.warn(\"[MetaUI] Failed to parse schema string, falling back to inference.\", e);\n                schemaObj = null;\n            }\n        }\n\n        if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {\n            return this.inferSchemaFromData(data);\n        }\n\n        // It is an object. Ensure it conforms to v2 structure.\n        const normalized: ISchema = {\n            title: schemaObj.title || \"MetaUI Generated Form\",\n            type: schemaObj.type || (schemaObj.items ? \"array\" : \"object\"),\n        };\n\n        if (normalized.type === \"object\") {\n            normalized.properties = this.normalizeProperties(schemaObj.properties || {});\n        } else if (normalized.type === \"array\") {\n            normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: \"object\", properties: {} }, \"items\");\n        }\n\n        return normalized;\n    }\n\n    private static normalizeProperties(properties: any): Record<string, IPropertyMetadata> {\n        const normalizedProps: Record<string, IPropertyMetadata> = {};\n        for (const key of Object.keys(properties)) {\n            normalizedProps[key] = this.normalizePropertyMetadata(properties[key], key);\n        }\n        return normalizedProps;\n    }\n\n    private static normalizePropertyMetadata(prop: any, keyName: string): IPropertyMetadata {\n        const normalized: IPropertyMetadata = {\n            type: prop.type || \"string\",\n            ui: {\n                label: prop.ui?.label || this.generateLabel(keyName),\n                isKey: !!prop.ui?.isKey,\n                readOnly: !!prop.ui?.readOnly,\n                widget: prop.ui?.widget,\n                group: prop.ui?.group,\n                visibleOn: prop.ui?.visibleOn,\n                enabledOn: prop.ui?.enabledOn,\n                format: prop.ui?.format\n            },\n            required: !!prop.required,\n            maxLength: prop.maxLength,\n            minimum: prop.minimum,\n            maximum: prop.maximum,\n            pattern: prop.pattern,\n            precision: prop.precision,\n            scale: prop.scale,\n            valueHelp: prop.valueHelp\n        };\n\n        if (normalized.type === \"object\" && prop.properties) {\n            normalized.properties = this.normalizeProperties(prop.properties);\n        } else if (normalized.type === \"array\" && prop.items) {\n            normalized.items = this.normalizePropertyMetadata(prop.items, \"items\");\n        }\n\n        return normalized;\n    }\n\n    /**\n     * Generates a Title Case label from camelCase or snake_case technical names.\n     */\n    private static generateLabel(name: string): string {\n        if (!name) return \"\";\n        let spaced = name.replace(/([A-Z])/g, \" $1\").replace(/_/g, \" \");\n        return spaced.split(' ')\n            .filter(w => w.length > 0)\n            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n            .join(' ')\n            .trim();\n    }\n\n    /**\n     * Infers a v2 ISchema structure dynamically from a plain data payload.\n     */\n    private static inferSchemaFromData(data: any): ISchema {\n        const schema: ISchema = { type: \"object\", properties: {} };\n        \n        if (!data || typeof data !== \"object\") {\n            return schema;\n        }\n\n        if (Array.isArray(data)) {\n            schema.type = \"array\";\n            schema.items = {\n                type: \"object\",\n                properties: data.length > 0 ? this.inferPropertiesFromObject(data[0]) : {}\n            };\n        } else {\n            schema.type = \"object\";\n            schema.properties = this.inferPropertiesFromObject(data);\n        }\n\n        return schema;\n    }\n\n    private static inferPropertiesFromObject(obj: any): Record<string, IPropertyMetadata> {\n        const properties: Record<string, IPropertyMetadata> = {};\n        if (!obj || typeof obj !== \"object\") return properties;\n\n        for (const key of Object.keys(obj)) {\n            const val = obj[key];\n            if (val === null || val === undefined) continue;\n            \n            if (typeof val === \"object\" && !Array.isArray(val)) continue;\n\n            let type: FieldType = \"string\";\n            let items: IPropertyMetadata | undefined;\n\n            if (typeof val === \"number\") type = \"number\";\n            else if (typeof val === \"boolean\") type = \"boolean\";\n            else if (Array.isArray(val)) {\n                type = \"array\";\n                items = {\n                    type: \"object\",\n                    properties: val.length > 0 ? this.inferPropertiesFromObject(val[0]) : {}\n                };\n            }\n            \n            properties[key] = {\n                type,\n                items,\n                ui: {\n                    label: this.generateLabel(key),\n                    isKey: false,\n                    readOnly: false\n                }\n            };\n        }\n\n        return properties;\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -1,20 +1,25 @@
 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 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;IAEtG,MAAa,gBAAgB;QAEzB;;WAEG;eACW,SAAS,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO;QA+B7D,OAAO,CAAC,MAAM,CAAC,mBAAmB;QAQlC,OAAO,CAAC,MAAM,CAAC,yBAAyB;QAgCxC;;WAEG;QACH,OAAO,CAAC,MAAM,CAAC,aAAa;QAU5B;;WAEG;QACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;QAqBlC,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([],function(){"use strict";class e{static normalize(e,t){let r=e;if(typeof r==="string"){try{r=JSON.parse(r)}catch(e){console.warn("[MetaUI] Failed to parse schema string, falling back to inference.",e);r=null}}if(!r||typeof r!=="object"||Array.isArray(r)){return this.inferSchemaFromData(t)}const i={title:r.title||"MetaUI Generated Form",type:r.type||(r.items?"array":"object")};if(i.type==="object"){i.properties=this.normalizeProperties(r.properties||{})}else if(i.type==="array"){i.items=this.normalizePropertyMetadata(r.items||{type:"object",properties:{}},"items")}return i}static normalizeProperties(e){const t={};for(const r of Object.keys(e)){t[r]=this.normalizePropertyMetadata(e[r],r)}return t}static normalizePropertyMetadata(e,t){const r={type:e.type||"string",ui:{label:e.ui?.label||this.generateLabel(t),isKey:!!e.ui?.isKey,readOnly:!!e.ui?.readOnly,widget:e.ui?.widget,group:e.ui?.group,visibleOn:e.ui?.visibleOn,enabledOn:e.ui?.enabledOn,format:e.ui?.format},required:!!e.required,maxLength:e.maxLength,minimum:e.minimum,maximum:e.maximum,pattern:e.pattern,precision:e.precision,scale:e.scale,valueHelp:e.valueHelp};if(r.type==="object"&&e.properties){r.properties=this.normalizeProperties(e.properties)}else if(r.type==="array"&&e.items){r.items=this.normalizePropertyMetadata(e.items,"items")}return r}static generateLabel(e){if(!e)return"";let t=e.replace(/([A-Z])/g," $1").replace(/_/g," ");return t.split(" ").filter(e=>e.length>0).map(e=>e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join(" ").trim()}static inferSchemaFromData(e){const t={type:"object",properties:{}};if(!e||typeof e!=="object"){return t}if(Array.isArray(e)){t.type="array";t.items={type:"object",properties:e.length>0?this.inferPropertiesFromObject(e[0]):{}}}else{t.type="object";t.properties=this.inferPropertiesFromObject(e)}return t}static inferPropertiesFromObject(e){const t={};if(!e||typeof e!=="object")return t;for(const r of Object.keys(e)){const i=e[r];if(i===null||i===undefined)continue;if(typeof i==="object"&&!Array.isArray(i))continue;let a="string";let s;if(typeof i==="number")a="number";else if(typeof i==="boolean")a="boolean";else if(Array.isArray(i)){a="array";s={type:"object",properties:i.length>0?this.inferPropertiesFromObject(i[0]):{}}}t[r]={type:a,items:s,ui:{label:this.generateLabel(r),isKey:false,readOnly:false}}}return t}}var t={__esModule:true};t.SchemaNormalizer=e;return t});
 //# 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":["SchemaNormalizer","normalize","rawSchema","data","schemaObj","JSON","parse","e","console","warn","Array","isArray","this","inferSchemaFromData","normalized","title","type","items","properties","normalizeProperties","normalizePropertyMetadata","normalizedProps","key","Object","keys","prop","keyName","ui","label","generateLabel","isKey","readOnly","widget","group","visibleOn","enabledOn","format","required","maxLength","minimum","maximum","pattern","precision","scale","valueHelp","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","trim","schema","inferPropertiesFromObject","obj","val","undefined","__exports","__esModule"],"sources":["SchemaNormalizer.ts"],"sourcesContent":["/**\n * @file SchemaNormalizer.ts\n * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.\n */\n\nimport { ISchema, IPropertyMetadata, FieldType } from \"../interfaces/ISchema\";\n\nexport class SchemaNormalizer {\n    \n    /**\n     * Validates that the provided raw payload conforms to the required ISchema structures.\n     */\n    public static normalize(rawSchema?: any, data?: any): ISchema {\n        let schemaObj = rawSchema;\n\n        if (typeof schemaObj === \"string\") {\n            try {\n                schemaObj = JSON.parse(schemaObj);\n            } catch (e) {\n                console.warn(\"[MetaUI] Failed to parse schema string, falling back to inference.\", e);\n                schemaObj = null;\n            }\n        }\n\n        if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {\n            return this.inferSchemaFromData(data);\n        }\n\n        // It is an object. Ensure it conforms to v2 structure.\n        const normalized: ISchema = {\n            title: schemaObj.title || \"MetaUI Generated Form\",\n            type: schemaObj.type || (schemaObj.items ? \"array\" : \"object\"),\n        };\n\n        if (normalized.type === \"object\") {\n            normalized.properties = this.normalizeProperties(schemaObj.properties || {});\n        } else if (normalized.type === \"array\") {\n            normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: \"object\", properties: {} }, \"items\");\n        }\n\n        return normalized;\n    }\n\n    private static normalizeProperties(properties: any): Record<string, IPropertyMetadata> {\n        const normalizedProps: Record<string, IPropertyMetadata> = {};\n        for (const key of Object.keys(properties)) {\n            normalizedProps[key] = this.normalizePropertyMetadata(properties[key], key);\n        }\n        return normalizedProps;\n    }\n\n    private static normalizePropertyMetadata(prop: any, keyName: string): IPropertyMetadata {\n        const normalized: IPropertyMetadata = {\n            type: prop.type || \"string\",\n            ui: {\n                label: prop.ui?.label || this.generateLabel(keyName),\n                isKey: !!prop.ui?.isKey,\n                readOnly: !!prop.ui?.readOnly,\n                widget: prop.ui?.widget,\n                group: prop.ui?.group,\n                visibleOn: prop.ui?.visibleOn,\n                enabledOn: prop.ui?.enabledOn,\n                format: prop.ui?.format\n            },\n            required: !!prop.required,\n            maxLength: prop.maxLength,\n            minimum: prop.minimum,\n            maximum: prop.maximum,\n            pattern: prop.pattern,\n            precision: prop.precision,\n            scale: prop.scale,\n            valueHelp: prop.valueHelp\n        };\n\n        if (normalized.type === \"object\" && prop.properties) {\n            normalized.properties = this.normalizeProperties(prop.properties);\n        } else if (normalized.type === \"array\" && prop.items) {\n            normalized.items = this.normalizePropertyMetadata(prop.items, \"items\");\n        }\n\n        return normalized;\n    }\n\n    /**\n     * Generates a Title Case label from camelCase or snake_case technical names.\n     */\n    private static generateLabel(name: string): string {\n        if (!name) return \"\";\n        let spaced = name.replace(/([A-Z])/g, \" $1\").replace(/_/g, \" \");\n        return spaced.split(' ')\n            .filter(w => w.length > 0)\n            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n            .join(' ')\n            .trim();\n    }\n\n    /**\n     * Infers a v2 ISchema structure dynamically from a plain data payload.\n     */\n    private static inferSchemaFromData(data: any): ISchema {\n        const schema: ISchema = { type: \"object\", properties: {} };\n        \n        if (!data || typeof data !== \"object\") {\n            return schema;\n        }\n\n        if (Array.isArray(data)) {\n            schema.type = \"array\";\n            schema.items = {\n                type: \"object\",\n                properties: data.length > 0 ? this.inferPropertiesFromObject(data[0]) : {}\n            };\n        } else {\n            schema.type = \"object\";\n            schema.properties = this.inferPropertiesFromObject(data);\n        }\n\n        return schema;\n    }\n\n    private static inferPropertiesFromObject(obj: any): Record<string, IPropertyMetadata> {\n        const properties: Record<string, IPropertyMetadata> = {};\n        if (!obj || typeof obj !== \"object\") return properties;\n\n        for (const key of Object.keys(obj)) {\n            const val = obj[key];\n            if (val === null || val === undefined) continue;\n            \n            if (typeof val === \"object\" && !Array.isArray(val)) continue;\n\n            let type: FieldType = \"string\";\n            let items: IPropertyMetadata | undefined;\n\n            if (typeof val === \"number\") type = \"number\";\n            else if (typeof val === \"boolean\") type = \"boolean\";\n            else if (Array.isArray(val)) {\n                type = \"array\";\n                items = {\n                    type: \"object\",\n                    properties: val.length > 0 ? this.inferPropertiesFromObject(val[0]) : {}\n                };\n            }\n            \n            properties[key] = {\n                type,\n                items,\n                ui: {\n                    label: this.generateLabel(key),\n                    isKey: false,\n                    readOnly: false\n                }\n            };\n        }\n\n        return properties;\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -1,31 +1,157 @@
-/**
- * @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";
+
+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) {
+                console.warn("[MetaUI] Failed to parse schema string, falling back to inference.", e);
+                schemaObj = null;
+            }
+        }
+
+        if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {
+            return this.inferSchemaFromData(data);
+        }
+
+        // It is an object. Ensure it conforms to v2 structure.
+        const normalized: ISchema = {
+            title: schemaObj.title || "MetaUI Generated Form",
+            type: schemaObj.type || (schemaObj.items ? "array" : "object"),
+        };
+
+        if (normalized.type === "object") {
+            normalized.properties = this.normalizeProperties(schemaObj.properties || {});
+        } else if (normalized.type === "array") {
+            normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: "object", properties: {} }, "items");
+        }
+
+        return normalized;
+    }
+
+    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,
+                group: prop.ui?.group,
+                visibleOn: prop.ui?.visibleOn,
+                enabledOn: prop.ui?.enabledOn,
+                format: prop.ui?.format
+            },
+            required: !!prop.required,
+            maxLength: prop.maxLength,
+            minimum: prop.minimum,
+            maximum: prop.maximum,
+            pattern: prop.pattern,
+            precision: prop.precision,
+            scale: prop.scale,
+            valueHelp: prop.valueHelp
+        };
+
+        if (normalized.type === "object" && prop.properties) {
+            normalized.properties = this.normalizeProperties(prop.properties);
+        } else if (normalized.type === "array" && prop.items) {
+            normalized.items = this.normalizePropertyMetadata(prop.items, "items");
+        }
+
+        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: {} };
+        
+        if (!data || typeof data !== "object") {
+            return schema;
+        }
+
+        if (Array.isArray(data)) {
+            schema.type = "array";
+            schema.items = {
+                type: "object",
+                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;
+    }
+}

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

@@ -1,56 +1,56 @@
-sap.ui.define(["sap/ui/model/json/JSONModel"], function (JSONModel) {
-  "use strict";
-
-  /**
-   * Manages the isolated internal data payload for the MetaUI engine.
-   */
-  class StateManager {
-    /**
-     * Initializes the state manager with an optional initial payload.
-     * @param initialData The initial JSON payload to populate the fields.
-     */
-    constructor(initialData = {}) {
-      // Deep copy to ensure no reference leakage from the host application
-      const safeData = JSON.parse(JSON.stringify(initialData));
-      this.model = new JSONModel(safeData);
-      this.model.setDefaultBindingMode("TwoWay");
-    }
-
-    /**
-     * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.
-     * @returns The internal JSONModel.
-     */
-    getModel() {
-      return this.model;
-    }
-
-    /**
-     * Binds a generated UI control property to a path in the internal model.
-     * @param control The target UI5 Control.
-     * @param property The UI5 property name (e.g., 'value').
-     * @param bindingPath The exact path in the JSON payload.
-     */
-    bindControl(control, property, bindingPath) {
-      control.bindProperty(property, {
-        path: bindingPath,
-        model: "meta" // Assumes the model is bound to the root container with the name 'meta'
-      });
-    }
-
-    /**
-     * Extracts the flat JavaScript object representing the current state of the UI.
-     * @returns A serialized record of the data payload, free of UI5 wrappers.
-     */
-    extractPayload() {
-      // Create a deep copy to prevent accidental mutations by the host
-      const data = this.model.getData();
-      return JSON.parse(JSON.stringify(data));
-    }
-  }
-  var __exports = {
-    __esModule: true
-  };
-  __exports.StateManager = StateManager;
-  return __exports;
-});
+sap.ui.define(["sap/ui/model/json/JSONModel"], function (JSONModel) {
+  "use strict";
+
+  /**
+   * Manages the isolated internal data payload for the MetaUI engine.
+   */
+  class StateManager {
+    /**
+     * Initializes the state manager with an optional initial payload.
+     * @param initialData The initial JSON payload to populate the fields.
+     */
+    constructor(initialData = {}) {
+      // Deep copy to ensure no reference leakage from the host application
+      const safeData = JSON.parse(JSON.stringify(initialData));
+      this.model = new JSONModel(safeData);
+      this.model.setDefaultBindingMode("TwoWay");
+    }
+
+    /**
+     * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.
+     * @returns The internal JSONModel.
+     */
+    getModel() {
+      return this.model;
+    }
+
+    /**
+     * Binds a generated UI control property to a path in the internal model.
+     * @param control The target UI5 Control.
+     * @param property The UI5 property name (e.g., 'value').
+     * @param bindingPath The exact path in the JSON payload.
+     */
+    bindControl(control, property, bindingPath) {
+      control.bindProperty(property, {
+        path: bindingPath,
+        model: "meta" // Assumes the model is bound to the root container with the name 'meta'
+      });
+    }
+
+    /**
+     * Extracts the flat JavaScript object representing the current state of the UI.
+     * @returns A serialized record of the data payload, free of UI5 wrappers.
+     */
+    extractPayload() {
+      // Create a deep copy to prevent accidental mutations by the host
+      const data = this.model.getData();
+      return JSON.parse(JSON.stringify(data));
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.StateManager = StateManager;
+  return __exports;
+});
 //# sourceMappingURL=StateManager-dbg.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"StateManager-dbg.js","names":["StateManager","constructor","initialData","safeData","JSON","parse","stringify","model","JSONModel","setDefaultBindingMode","getModel","bindControl","control","property","bindingPath","bindProperty","path","extractPayload","data","getData","__exports","__esModule"],"sources":["StateManager.ts"],"sourcesContent":["/**\r\n * @file StateManager.ts\r\n * @description Isolated internal state management. Decouples the MetaUI engine from external host models.\r\n */\r\n\r\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\r\nimport ManagedObject from \"sap/ui/base/ManagedObject\";\r\n\r\n/**\r\n * Manages the isolated internal data payload for the MetaUI engine.\r\n */\r\nexport class StateManager {\r\n    private model: JSONModel;\r\n\r\n    /**\r\n     * Initializes the state manager with an optional initial payload.\r\n     * @param initialData The initial JSON payload to populate the fields.\r\n     */\r\n    constructor(initialData: Record<string, any> = {}) {\r\n        // Deep copy to ensure no reference leakage from the host application\r\n        const safeData = JSON.parse(JSON.stringify(initialData));\r\n        this.model = new JSONModel(safeData);\r\n        this.model.setDefaultBindingMode(\"TwoWay\");\r\n    }\r\n\r\n    /**\r\n     * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.\r\n     * @returns The internal JSONModel.\r\n     */\r\n    public getModel(): JSONModel {\r\n        return this.model;\r\n    }\r\n\r\n    /**\r\n     * Binds a generated UI control property to a path in the internal model.\r\n     * @param control The target UI5 Control.\r\n     * @param property The UI5 property name (e.g., 'value').\r\n     * @param bindingPath The exact path in the JSON payload.\r\n     */\r\n    public bindControl(control: ManagedObject, property: string, bindingPath: string): void {\r\n        control.bindProperty(property, {\r\n            path: bindingPath,\r\n            model: \"meta\" // Assumes the model is bound to the root container with the name 'meta'\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Extracts the flat JavaScript object representing the current state of the UI.\r\n     * @returns A serialized record of the data payload, free of UI5 wrappers.\r\n     */\r\n    public extractPayload(): Record<string, any> {\r\n        // Create a deep copy to prevent accidental mutations by the host\r\n        const data = this.model.getData();\r\n        return JSON.parse(JSON.stringify(data));\r\n    }\r\n}\r\n"],"mappings":";;;EAQA;AACA;AACA;EACO,MAAMA,YAAY,CAAC;IAGtB;AACJ;AACA;AACA;IACIC,WAAWA,CAACC,WAAgC,GAAG,CAAC,CAAC,EAAE;MAC/C;MACA,MAAMC,QAAQ,GAAGC,IAAI,CAACC,KAAK,CAACD,IAAI,CAACE,SAAS,CAACJ,WAAW,CAAC,CAAC;MACxD,IAAI,CAACK,KAAK,GAAG,IAAIC,SAAS,CAACL,QAAQ,CAAC;MACpC,IAAI,CAACI,KAAK,CAACE,qBAAqB,CAAC,QAAQ,CAAC;IAC9C;;IAEA;AACJ;AACA;AACA;IACWC,QAAQA,CAAA,EAAc;MACzB,OAAO,IAAI,CAACH,KAAK;IACrB;;IAEA;AACJ;AACA;AACA;AACA;AACA;IACWI,WAAWA,CAACC,OAAsB,EAAEC,QAAgB,EAAEC,WAAmB,EAAQ;MACpFF,OAAO,CAACG,YAAY,CAACF,QAAQ,EAAE;QAC3BG,IAAI,EAAEF,WAAW;QACjBP,KAAK,EAAE,MAAM,CAAC;MAClB,CAAC,CAAC;IACN;;IAEA;AACJ;AACA;AACA;IACWU,cAAcA,CAAA,EAAwB;MACzC;MACA,MAAMC,IAAI,GAAG,IAAI,CAACX,KAAK,CAACY,OAAO,CAAC,CAAC;MACjC,OAAOf,IAAI,CAACC,KAAK,CAACD,IAAI,CAACE,SAAS,CAACY,IAAI,CAAC,CAAC;IAC3C;EACJ;EAAC,IAAAE,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAApB,YAAA,GAAAA,YAAA;EAAA,OAAAoB,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"StateManager-dbg.js","names":["StateManager","constructor","initialData","safeData","JSON","parse","stringify","model","JSONModel","setDefaultBindingMode","getModel","bindControl","control","property","bindingPath","bindProperty","path","extractPayload","data","getData","__exports","__esModule"],"sources":["StateManager.ts"],"sourcesContent":["/**\n * @file StateManager.ts\n * @description Isolated internal state management. Decouples the MetaUI engine from external host models.\n */\n\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport ManagedObject from \"sap/ui/base/ManagedObject\";\n\n/**\n * Manages the isolated internal data payload for the MetaUI engine.\n */\nexport class StateManager {\n    private model: JSONModel;\n\n    /**\n     * Initializes the state manager with an optional initial payload.\n     * @param initialData The initial JSON payload to populate the fields.\n     */\n    constructor(initialData: Record<string, any> = {}) {\n        // Deep copy to ensure no reference leakage from the host application\n        const safeData = JSON.parse(JSON.stringify(initialData));\n        this.model = new JSONModel(safeData);\n        this.model.setDefaultBindingMode(\"TwoWay\");\n    }\n\n    /**\n     * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.\n     * @returns The internal JSONModel.\n     */\n    public getModel(): JSONModel {\n        return this.model;\n    }\n\n    /**\n     * Binds a generated UI control property to a path in the internal model.\n     * @param control The target UI5 Control.\n     * @param property The UI5 property name (e.g., 'value').\n     * @param bindingPath The exact path in the JSON payload.\n     */\n    public bindControl(control: ManagedObject, property: string, bindingPath: string): void {\n        control.bindProperty(property, {\n            path: bindingPath,\n            model: \"meta\" // Assumes the model is bound to the root container with the name 'meta'\n        });\n    }\n\n    /**\n     * Extracts the flat JavaScript object representing the current state of the UI.\n     * @returns A serialized record of the data payload, free of UI5 wrappers.\n     */\n    public extractPayload(): Record<string, any> {\n        // Create a deep copy to prevent accidental mutations by the host\n        const data = this.model.getData();\n        return JSON.parse(JSON.stringify(data));\n    }\n}\n"],"mappings":";;;EAQA;AACA;AACA;EACO,MAAMA,YAAY,CAAC;IAGtB;AACJ;AACA;AACA;IACIC,WAAWA,CAACC,WAAgC,GAAG,CAAC,CAAC,EAAE;MAC/C;MACA,MAAMC,QAAQ,GAAGC,IAAI,CAACC,KAAK,CAACD,IAAI,CAACE,SAAS,CAACJ,WAAW,CAAC,CAAC;MACxD,IAAI,CAACK,KAAK,GAAG,IAAIC,SAAS,CAACL,QAAQ,CAAC;MACpC,IAAI,CAACI,KAAK,CAACE,qBAAqB,CAAC,QAAQ,CAAC;IAC9C;;IAEA;AACJ;AACA;AACA;IACWC,QAAQA,CAAA,EAAc;MACzB,OAAO,IAAI,CAACH,KAAK;IACrB;;IAEA;AACJ;AACA;AACA;AACA;AACA;IACWI,WAAWA,CAACC,OAAsB,EAAEC,QAAgB,EAAEC,WAAmB,EAAQ;MACpFF,OAAO,CAACG,YAAY,CAACF,QAAQ,EAAE;QAC3BG,IAAI,EAAEF,WAAW;QACjBP,KAAK,EAAE,MAAM,CAAC;MAClB,CAAC,CAAC;IACN;;IAEA;AACJ;AACA;AACA;IACWU,cAAcA,CAAA,EAAwB;MACzC;MACA,MAAMC,IAAI,GAAG,IAAI,CAACX,KAAK,CAACY,OAAO,CAAC,CAAC;MACjC,OAAOf,IAAI,CAACC,KAAK,CAACD,IAAI,CAACE,SAAS,CAACY,IAAI,CAAC,CAAC;IAC3C;EACJ;EAAC,IAAAE,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAApB,YAAA,GAAAA,YAAA;EAAA,OAAAoB,SAAA;AAAA","ignoreList":[]}

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

@@ -1 +1 @@
-{"version":3,"file":"StateManager.d.ts","sourceRoot":"..\\..\\..\\..\\..\\..\\..\\..","sources":["src\\nz\\co\\siliconst\\ui5\\metaui\\core\\StateManager.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,8CAA8C,CAAC;IAC9D;;;OAGG;IAEH,OAAO,SAAS,MAAM,6BAA6B,CAAC;IACpD,OAAO,aAAa,MAAM,2BAA2B,CAAC;IAEtD;;OAEG;IACH,MAAa,YAAY;QACrB,OAAO,CAAC,KAAK,CAAY;QAEzB;;;WAGG;oBACS,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;QAOjD;;;WAGG;QACI,QAAQ,IAAI,SAAS;QAI5B;;;;;WAKG;QACI,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;QAOvF;;;WAGG;QACI,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;KAK/C;CAEA"}
+{"version":3,"file":"StateManager.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/StateManager.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,8CAA8C,CAAC;IAC9D;;;OAGG;IAEH,OAAO,SAAS,MAAM,6BAA6B,CAAC;IACpD,OAAO,aAAa,MAAM,2BAA2B,CAAC;IAEtD;;OAEG;IACH,MAAa,YAAY;QACrB,OAAO,CAAC,KAAK,CAAY;QAEzB;;;WAGG;oBACS,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;QAOjD;;;WAGG;QACI,QAAQ,IAAI,SAAS;QAI5B;;;;;WAKG;QACI,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;QAOvF;;;WAGG;QACI,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;KAK/C;CAEA"}