@siliconst/metaui 1.4.17 → 1.4.21

package/src/nz/co/siliconst/ui5/metaui/openapi/OpenApiRefResolver.ts

@@ -0,0 +1,61 @@
+/**
+ * @file OpenApiRefResolver.ts
+ * @description Utility class for resolving local $ref pointers within an OpenAPI document.
+ */
+import { Logger } from "../utils/Logger";
+
+/**
+ * Utility class for resolving local $ref pointers within an OpenAPI document.
+ * 
+ * @public
+ */
+export class OpenApiRefResolver {
+    /**
+     * Recursively traverses a local JSON Pointer $ref path (e.g., '#/components/schemas/Pet')
+     * and extracts the target object from the Swagger root document.
+     * External URLs or invalid references are safely ignored.
+     * 
+     * @param {string} refUrl The $ref string path.
+     * @param {any} openApiRoot The root OpenAPI document to query against.
+     * @param {number} depth The current recursive depth count, used to prevent infinite loops.
+     * @returns {any} The resolved schema object, or null if unresolvable.
+     */
+    public static resolve(refUrl: string, openApiRoot: unknown, depth: number = 0): unknown {
+        if (!refUrl || !refUrl.startsWith("#/")) {
+            Logger.debug(`[MetaUI OpenApiBuilder] Ignoring non-local or empty $ref: ${refUrl}`, "OpenApiBuilder");
+            return null; // Ignore external URLs per architectural rules
+        }
+
+        // Circular Reference Limit:
+        // A hard limit is enforced to prevent stack overflow exceptions caused by infinitely 
+        // recursive structures (e.g., a Tree node that references another Tree node).
+        if (depth > 10) {
+            Logger.error(`[MetaUI OpenApiBuilder] Circular or overly deep $ref detected: ${refUrl}`, null, "OpenApiBuilder");
+            return null;
+        }
+
+        // Path Segment Parsing:
+        // The '#/' prefix is stripped, and the remaining path is split by '/'.
+        // We incrementally descend into the swagger root using these segments.
+        const pathSegments = refUrl.substring(2).split("/");
+        let current = openApiRoot;
+
+        for (const segment of pathSegments) {
+            if (current && typeof current === "object" && segment in current) {
+                current = current[segment];
+            } else {
+                Logger.error(`[MetaUI OpenApiBuilder] Failed to resolve local $ref: ${refUrl}`, null, "OpenApiBuilder");
+                return null;
+            }
+        }
+
+        // Deep Resolution Recursion:
+        // If the resolved target is itself a reference pointer, recursively resolve again
+        // until we reach a terminal structure or hit the recursion depth limit.
+        if (current && typeof current === "object" && current.$ref) {
+            return this.resolve(current.$ref, openApiRoot, depth + 1);
+        }
+
+        return current;
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/openapi/OpenApiTypeMapper-dbg.js

@@ -0,0 +1,45 @@
+sap.ui.define([], function () {
+  "use strict";
+
+  /**
+   * @file OpenApiTypeMapper.ts
+   * @description Utility class for mapping OpenAPI primitive types to MetaUI FieldTypes.
+   */
+
+  /**
+   * Acts as the translation boundary between raw OpenAPI types and the internal MetaUI FieldType enumerations.
+   * This ensures that the core layout engine never has to parse or understand Swagger-specific semantics.
+   * 
+   * @public
+   */
+  class OpenApiTypeMapper {
+    /**
+     * Maps an OpenAPI primitive type string to the closest MetaUI FieldType.
+     * If the type is omitted (common for objects) or unknown, it defaults to "object"
+     * to trigger a safe nested-form fallback behavior.
+     * 
+     * @param {string} openApiType The raw OpenAPI type (e.g., 'string', 'integer').
+     * @returns {FieldType} The mapped MetaUI FieldType strictly understood by the core engine.
+     */
+    static mapType(openApiType) {
+      const typeMap = {
+        "string": "string",
+        "number": "number",
+        "integer": "integer",
+        "boolean": "boolean",
+        "array": "array",
+        "object": "object",
+        "date": "date"
+      };
+
+      // Default to "object" if the type is unknown or omitted by the API specification.
+      return typeMap[openApiType] || "object";
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.OpenApiTypeMapper = OpenApiTypeMapper;
+  return __exports;
+});
+//# sourceMappingURL=OpenApiTypeMapper-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/openapi/OpenApiTypeMapper-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiTypeMapper-dbg.js","names":["OpenApiTypeMapper","mapType","openApiType","typeMap","__exports","__esModule"],"sources":["OpenApiTypeMapper.ts"],"sourcesContent":["/**\n * @file OpenApiTypeMapper.ts\n * @description Utility class for mapping OpenAPI primitive types to MetaUI FieldTypes.\n */\nimport { FieldType } from \"../interfaces/ISchema\";\n\n/**\n * Acts as the translation boundary between raw OpenAPI types and the internal MetaUI FieldType enumerations.\n * This ensures that the core layout engine never has to parse or understand Swagger-specific semantics.\n * \n * @public\n */\nexport class OpenApiTypeMapper {\n    /**\n     * Maps an OpenAPI primitive type string to the closest MetaUI FieldType.\n     * If the type is omitted (common for objects) or unknown, it defaults to \"object\"\n     * to trigger a safe nested-form fallback behavior.\n     * \n     * @param {string} openApiType The raw OpenAPI type (e.g., 'string', 'integer').\n     * @returns {FieldType} The mapped MetaUI FieldType strictly understood by the core engine.\n     */\n    public static mapType(openApiType: string): FieldType {\n        const typeMap: Record<string, FieldType> = {\n            \"string\": \"string\",\n            \"number\": \"number\",\n            \"integer\": \"integer\",\n            \"boolean\": \"boolean\",\n            \"array\": \"array\",\n            \"object\": \"object\",\n            \"date\": \"date\"\n        };\n        \n        // Default to \"object\" if the type is unknown or omitted by the API specification.\n        return typeMap[openApiType] || \"object\";\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;;EAGA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMA,iBAAiB,CAAC;IAC3B;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;IACI,OAAcC,OAAOA,CAACC,WAAmB,EAAa;MAClD,MAAMC,OAAkC,GAAG;QACvC,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE;MACZ,CAAC;;MAED;MACA,OAAOA,OAAO,CAACD,WAAW,CAAC,IAAI,QAAQ;IAC3C;EACJ;EAAC,IAAAE,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAJ,iBAAA,GAAAA,iBAAA;EAAA,OAAAI,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/openapi/OpenApiTypeMapper.d.ts

@@ -0,0 +1,25 @@
+declare module "nz/co/siliconst/ui5/metaui/openapi/OpenApiTypeMapper" {
+    /**
+     * @file OpenApiTypeMapper.ts
+     * @description Utility class for mapping OpenAPI primitive types to MetaUI FieldTypes.
+     */
+    import { FieldType } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    /**
+     * Acts as the translation boundary between raw OpenAPI types and the internal MetaUI FieldType enumerations.
+     * This ensures that the core layout engine never has to parse or understand Swagger-specific semantics.
+     *
+     * @public
+     */
+    export class OpenApiTypeMapper {
+        /**
+         * Maps an OpenAPI primitive type string to the closest MetaUI FieldType.
+         * If the type is omitted (common for objects) or unknown, it defaults to "object"
+         * to trigger a safe nested-form fallback behavior.
+         *
+         * @param {string} openApiType The raw OpenAPI type (e.g., 'string', 'integer').
+         * @returns {FieldType} The mapped MetaUI FieldType strictly understood by the core engine.
+         */
+        static mapType(openApiType: string): FieldType;
+    }
+}
+//# sourceMappingURL=OpenApiTypeMapper.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/openapi/OpenApiTypeMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiTypeMapper.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/openapi/OpenApiTypeMapper.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,sDAAsD,CAAC;IACtE;;;OAGG;IACH,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;IAE1E;;;;;OAKG;IACH,MAAa,iBAAiB;QAC1B;;;;;;;WAOG;eACW,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;KAcxD;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/{swagger/SwaggerTypeMapper.js → openapi/OpenApiTypeMapper.js}

@@ -1,2 +1,2 @@
-sap.ui.define([],function(){"use strict";class e{static mapType(e){const r={string:"string",number:"number",integer:"integer",boolean:"boolean",array:"array",object:"object",date:"date"};return r[e]||"object"}}var r={__esModule:true};r.SwaggerTypeMapper=e;return r});
-//# sourceMappingURL=SwaggerTypeMapper.js.map
+sap.ui.define([],function(){"use strict";class e{static mapType(e){const r={string:"string",number:"number",integer:"integer",boolean:"boolean",array:"array",object:"object",date:"date"};return r[e]||"object"}}var r={__esModule:true};r.OpenApiTypeMapper=e;return r});
+//# sourceMappingURL=OpenApiTypeMapper.js.map

package/src/nz/co/siliconst/ui5/metaui/openapi/OpenApiTypeMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiTypeMapper.js","names":["OpenApiTypeMapper","mapType","openApiType","typeMap","string","number","integer","boolean","array","object","date","__exports","__esModule"],"sources":["OpenApiTypeMapper.ts"],"sourcesContent":["/**\n * @file OpenApiTypeMapper.ts\n * @description Utility class for mapping OpenAPI primitive types to MetaUI FieldTypes.\n */\nimport { FieldType } from \"../interfaces/ISchema\";\n\n/**\n * Acts as the translation boundary between raw OpenAPI types and the internal MetaUI FieldType enumerations.\n * This ensures that the core layout engine never has to parse or understand Swagger-specific semantics.\n * \n * @public\n */\nexport class OpenApiTypeMapper {\n    /**\n     * Maps an OpenAPI primitive type string to the closest MetaUI FieldType.\n     * If the type is omitted (common for objects) or unknown, it defaults to \"object\"\n     * to trigger a safe nested-form fallback behavior.\n     * \n     * @param {string} openApiType The raw OpenAPI type (e.g., 'string', 'integer').\n     * @returns {FieldType} The mapped MetaUI FieldType strictly understood by the core engine.\n     */\n    public static mapType(openApiType: string): FieldType {\n        const typeMap: Record<string, FieldType> = {\n            \"string\": \"string\",\n            \"number\": \"number\",\n            \"integer\": \"integer\",\n            \"boolean\": \"boolean\",\n            \"array\": \"array\",\n            \"object\": \"object\",\n            \"date\": \"date\"\n        };\n        \n        // Default to \"object\" if the type is unknown or omitted by the API specification.\n        return typeMap[openApiType] || \"object\";\n    }\n}\n"],"mappings":"yCAYO,MAAMA,EAST,cAAcC,CAAQC,GAClB,MAAMC,EAAqC,CACvCC,OAAU,SACVC,OAAU,SACVC,QAAW,UACXC,QAAW,UACXC,MAAS,QACTC,OAAU,SACVC,KAAQ,QAIZ,OAAOP,EAAQD,IAAgB,QACnC,EACH,IAAAS,EAAA,CAAAC,WAAA,MAAAD,EAAAX,oBAAA,OAAAW,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/openapi/OpenApiTypeMapper.ts

@@ -0,0 +1,36 @@
+/**
+ * @file OpenApiTypeMapper.ts
+ * @description Utility class for mapping OpenAPI primitive types to MetaUI FieldTypes.
+ */
+import { FieldType } from "../interfaces/ISchema";
+
+/**
+ * Acts as the translation boundary between raw OpenAPI types and the internal MetaUI FieldType enumerations.
+ * This ensures that the core layout engine never has to parse or understand Swagger-specific semantics.
+ * 
+ * @public
+ */
+export class OpenApiTypeMapper {
+    /**
+     * Maps an OpenAPI primitive type string to the closest MetaUI FieldType.
+     * If the type is omitted (common for objects) or unknown, it defaults to "object"
+     * to trigger a safe nested-form fallback behavior.
+     * 
+     * @param {string} openApiType The raw OpenAPI type (e.g., 'string', 'integer').
+     * @returns {FieldType} The mapped MetaUI FieldType strictly understood by the core engine.
+     */
+    public static mapType(openApiType: string): FieldType {
+        const typeMap: Record<string, FieldType> = {
+            "string": "string",
+            "number": "number",
+            "integer": "integer",
+            "boolean": "boolean",
+            "array": "array",
+            "object": "object",
+            "date": "date"
+        };
+        
+        // Default to "object" if the type is unknown or omitted by the API specification.
+        return typeMap[openApiType] || "object";
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/{swagger/SwaggerUIMapper-dbg.js → openapi/OpenApiUIMapper-dbg.js}

@@ -2,38 +2,42 @@ sap.ui.define([], function () {
   "use strict";
 
   /**
-   * @file SwaggerUIMapper.ts
+   * @file OpenApiUIMapper.ts
    * @description Utility class for mapping OpenAPI properties and formats into MetaUI IUIDirectives.
    */
 
-  class SwaggerUIMapper {
+  /**
+   * Utility class responsible for evaluating OpenAPI metadata and generating the corresponding 
+   * MetaUI UI rendering directives. This isolates all visual layout assumptions from the parsing engine.
+   * 
+   * @public
+   */
+  class OpenApiUIMapper {
     /**
      * Evaluates an OpenAPI property definition and constructs a MetaUI IUIDirective block.
      * Extracts labels from title/description, maps readOnly state, and assigns 
-     * specific Fiori widgets based on the OpenAPI 'format' property.
+     * specific UI5 Fiori widgets based on the OpenAPI 'format' property.
      * 
-     * @param {any} swaggerProp The raw OpenAPI property schema.
+     * @param {any} swaggerProp The raw OpenAPI property schema chunk.
      * @param {string} keyName The technical JSON key of the property.
      * @returns {IUIDirective} The constructed MetaUI UI orchestration directive.
      */
     static build(swaggerProp, keyName) {
       const ui = {};
 
-      // Labeling
+      // Label Synthesis
       if (swaggerProp.title) {
         ui.label = swaggerProp.title;
-      } else if (swaggerProp.description) {
-        ui.label = swaggerProp.description;
       } else {
         ui.label = this.generateLabel(keyName);
       }
 
-      // State
+      // State Mapping
       if (swaggerProp.readOnly === true) {
         ui.readOnly = true;
       }
 
-      // Formats to Widgets
+      // Format to Widget Translation
       if (swaggerProp.format) {
         switch (swaggerProp.format) {
           case "date-time":
@@ -43,13 +47,20 @@ sap.ui.define([], function () {
             ui.widget = "date";
             break;
           case "password":
-            ui.format = "password";
+            ui.widget = "password";
+            ui.format = "password"; // Kept for schema validation
             break;
           case "email":
-            ui.format = "email";
+            ui.widget = "email";
+            ui.format = "email"; // Kept for schema validation
             break;
           case "uri":
-            ui.format = "url";
+            ui.widget = "link";
+            ui.format = "url"; // Kept for schema validation
+            break;
+          case "binary":
+          case "byte":
+            ui.widget = "fileUploader";
             break;
           case "uuid":
           case "ipv4":
@@ -64,10 +75,11 @@ sap.ui.define([], function () {
     }
 
     /**
-     * Generates a human-readable Title Case label from camelCase or snake_case technical keys.
+     * Synthesizes a human-readable Title Case label from camelCase or snake_case technical keys.
      * 
-     * @param {string} name The technical property key.
-     * @returns {string} The formatted human-readable label.
+     * @param {string} name The raw technical property key (e.g., 'creationTimestamp').
+     * @returns {string} The formatted human-readable label (e.g., 'Creation Timestamp').
+     * @private
      */
     static generateLabel(name) {
       if (!name) return "";
@@ -78,7 +90,7 @@ sap.ui.define([], function () {
   var __exports = {
     __esModule: true
   };
-  __exports.SwaggerUIMapper = SwaggerUIMapper;
+  __exports.OpenApiUIMapper = OpenApiUIMapper;
   return __exports;
 });
-//# sourceMappingURL=SwaggerUIMapper-dbg.js.map
+//# sourceMappingURL=OpenApiUIMapper-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/openapi/OpenApiUIMapper-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiUIMapper-dbg.js","names":["OpenApiUIMapper","build","swaggerProp","keyName","ui","title","label","generateLabel","readOnly","format","widget","validators","push","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","trim","__exports","__esModule"],"sources":["OpenApiUIMapper.ts"],"sourcesContent":["/**\n * @file OpenApiUIMapper.ts\n * @description Utility class for mapping OpenAPI properties and formats into MetaUI IUIDirectives.\n */\nimport { IUIDirective } from \"../interfaces/ISchema\";\n\n/**\n * Utility class responsible for evaluating OpenAPI metadata and generating the corresponding \n * MetaUI UI rendering directives. This isolates all visual layout assumptions from the parsing engine.\n * \n * @public\n */\nexport class OpenApiUIMapper {\n    /**\n     * Evaluates an OpenAPI property definition and constructs a MetaUI IUIDirective block.\n     * Extracts labels from title/description, maps readOnly state, and assigns \n     * specific UI5 Fiori widgets based on the OpenAPI 'format' property.\n     * \n     * @param {any} swaggerProp The raw OpenAPI property schema chunk.\n     * @param {string} keyName The technical JSON key of the property.\n     * @returns {IUIDirective} The constructed MetaUI UI orchestration directive.\n     */\n    public static build(swaggerProp: unknown, keyName: string): IUIDirective {\n        const ui: IUIDirective = {};\n\n        // Label Synthesis\n        if (swaggerProp.title) {\n            ui.label = swaggerProp.title;\n        } else {\n            ui.label = this.generateLabel(keyName);\n        }\n\n        // State Mapping\n        if (swaggerProp.readOnly === true) {\n            ui.readOnly = true;\n        }\n\n        // Format to Widget Translation\n        if (swaggerProp.format) {\n            switch (swaggerProp.format) {\n                case \"date-time\":\n                    ui.widget = \"datetime\";\n                    break;\n                case \"date\":\n                    ui.widget = \"date\";\n                    break;\n                case \"password\":\n                    ui.widget = \"password\";\n                    ui.format = \"password\"; // Kept for schema validation\n                    break;\n                case \"email\":\n                    ui.widget = \"email\";\n                    ui.format = \"email\"; // Kept for schema validation\n                    break;\n                case \"uri\":\n                    ui.widget = \"link\";\n                    ui.format = \"url\"; // Kept for schema validation\n                    break;\n                case \"binary\":\n                case \"byte\":\n                    ui.widget = \"fileUploader\";\n                    break;\n                case \"uuid\":\n                case \"ipv4\":\n                case \"ipv6\":\n                case \"hostname\":\n                    if (!ui.validators) ui.validators = [];\n                    ui.validators.push(swaggerProp.format);\n                    break;\n            }\n        }\n\n        return ui;\n    }\n\n    /**\n     * Synthesizes a human-readable Title Case label from camelCase or snake_case technical keys.\n     * \n     * @param {string} name The raw technical property key (e.g., 'creationTimestamp').\n     * @returns {string} The formatted human-readable label (e.g., 'Creation Timestamp').\n     * @private\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"],"mappings":";;;EAAA;AACA;AACA;AACA;;EAGA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMA,eAAe,CAAC;IACzB;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACI,OAAcC,KAAKA,CAACC,WAAoB,EAAEC,OAAe,EAAgB;MACrE,MAAMC,EAAgB,GAAG,CAAC,CAAC;;MAE3B;MACA,IAAIF,WAAW,CAACG,KAAK,EAAE;QACnBD,EAAE,CAACE,KAAK,GAAGJ,WAAW,CAACG,KAAK;MAChC,CAAC,MAAM;QACHD,EAAE,CAACE,KAAK,GAAG,IAAI,CAACC,aAAa,CAACJ,OAAO,CAAC;MAC1C;;MAEA;MACA,IAAID,WAAW,CAACM,QAAQ,KAAK,IAAI,EAAE;QAC/BJ,EAAE,CAACI,QAAQ,GAAG,IAAI;MACtB;;MAEA;MACA,IAAIN,WAAW,CAACO,MAAM,EAAE;QACpB,QAAQP,WAAW,CAACO,MAAM;UACtB,KAAK,WAAW;YACZL,EAAE,CAACM,MAAM,GAAG,UAAU;YACtB;UACJ,KAAK,MAAM;YACPN,EAAE,CAACM,MAAM,GAAG,MAAM;YAClB;UACJ,KAAK,UAAU;YACXN,EAAE,CAACM,MAAM,GAAG,UAAU;YACtBN,EAAE,CAACK,MAAM,GAAG,UAAU,CAAC,CAAC;YACxB;UACJ,KAAK,OAAO;YACRL,EAAE,CAACM,MAAM,GAAG,OAAO;YACnBN,EAAE,CAACK,MAAM,GAAG,OAAO,CAAC,CAAC;YACrB;UACJ,KAAK,KAAK;YACNL,EAAE,CAACM,MAAM,GAAG,MAAM;YAClBN,EAAE,CAACK,MAAM,GAAG,KAAK,CAAC,CAAC;YACnB;UACJ,KAAK,QAAQ;UACb,KAAK,MAAM;YACPL,EAAE,CAACM,MAAM,GAAG,cAAc;YAC1B;UACJ,KAAK,MAAM;UACX,KAAK,MAAM;UACX,KAAK,MAAM;UACX,KAAK,UAAU;YACX,IAAI,CAACN,EAAE,CAACO,UAAU,EAAEP,EAAE,CAACO,UAAU,GAAG,EAAE;YACtCP,EAAE,CAACO,UAAU,CAACC,IAAI,CAACV,WAAW,CAACO,MAAM,CAAC;YACtC;QACR;MACJ;MAEA,OAAOL,EAAE;IACb;;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;IACI,OAAeG,aAAaA,CAACM,IAAY,EAAU;MAC/C,IAAI,CAACA,IAAI,EAAE,OAAO,EAAE;MACpB,IAAIC,MAAM,GAAGD,IAAI,CAACE,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAACA,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;MAC/D,OAAOD,MAAM,CAACE,KAAK,CAAC,GAAG,CAAC,CACnBC,MAAM,CAACC,CAAC,IAAIA,CAAC,CAACC,MAAM,GAAG,CAAC,CAAC,CACzBC,GAAG,CAACC,IAAI,IAAIA,IAAI,CAACC,MAAM,CAAC,CAAC,CAAC,CAACC,WAAW,CAAC,CAAC,GAAGF,IAAI,CAACG,KAAK,CAAC,CAAC,CAAC,CAACC,WAAW,CAAC,CAAC,CAAC,CACvEC,IAAI,CAAC,GAAG,CAAC,CACTC,IAAI,CAAC,CAAC;IACf;EACJ;EAAC,IAAAC,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAA5B,eAAA,GAAAA,eAAA;EAAA,OAAA4B,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/openapi/OpenApiUIMapper.d.ts

@@ -0,0 +1,34 @@
+declare module "nz/co/siliconst/ui5/metaui/openapi/OpenApiUIMapper" {
+    /**
+     * @file OpenApiUIMapper.ts
+     * @description Utility class for mapping OpenAPI properties and formats into MetaUI IUIDirectives.
+     */
+    import { IUIDirective } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    /**
+     * Utility class responsible for evaluating OpenAPI metadata and generating the corresponding
+     * MetaUI UI rendering directives. This isolates all visual layout assumptions from the parsing engine.
+     *
+     * @public
+     */
+    export class OpenApiUIMapper {
+        /**
+         * Evaluates an OpenAPI property definition and constructs a MetaUI IUIDirective block.
+         * Extracts labels from title/description, maps readOnly state, and assigns
+         * specific UI5 Fiori widgets based on the OpenAPI 'format' property.
+         *
+         * @param {any} swaggerProp The raw OpenAPI property schema chunk.
+         * @param {string} keyName The technical JSON key of the property.
+         * @returns {IUIDirective} The constructed MetaUI UI orchestration directive.
+         */
+        static build(swaggerProp: unknown, keyName: string): IUIDirective;
+        /**
+         * Synthesizes a human-readable Title Case label from camelCase or snake_case technical keys.
+         *
+         * @param {string} name The raw technical property key (e.g., 'creationTimestamp').
+         * @returns {string} The formatted human-readable label (e.g., 'Creation Timestamp').
+         * @private
+         */
+        private static generateLabel;
+    }
+}
+//# sourceMappingURL=OpenApiUIMapper.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/openapi/OpenApiUIMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiUIMapper.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/openapi/OpenApiUIMapper.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,oDAAoD,CAAC;IACpE;;;OAGG;IACH,OAAO,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAC;IAE7E;;;;;OAKG;IACH,MAAa,eAAe;QACxB;;;;;;;;WAQG;eACW,KAAK,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY;QAqDxE;;;;;;WAMG;QACH,OAAO,CAAC,MAAM,CAAC,aAAa;KAS/B;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/openapi/OpenApiUIMapper.js

@@ -0,0 +1,2 @@
+sap.ui.define([],function(){"use strict";class e{static build(e,a){const t={};if(e.title){t.label=e.title}else{t.label=this.generateLabel(a)}if(e.readOnly===true){t.readOnly=true}if(e.format){switch(e.format){case"date-time":t.widget="datetime";break;case"date":t.widget="date";break;case"password":t.widget="password";t.format="password";break;case"email":t.widget="email";t.format="email";break;case"uri":t.widget="link";t.format="url";break;case"binary":case"byte":t.widget="fileUploader";break;case"uuid":case"ipv4":case"ipv6":case"hostname":if(!t.validators)t.validators=[];t.validators.push(e.format);break}}return t}static generateLabel(e){if(!e)return"";let a=e.replace(/([A-Z])/g," $1").replace(/_/g," ");return a.split(" ").filter(e=>e.length>0).map(e=>e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join(" ").trim()}}var a={__esModule:true};a.OpenApiUIMapper=e;return a});
+//# sourceMappingURL=OpenApiUIMapper.js.map

package/src/nz/co/siliconst/ui5/metaui/openapi/OpenApiUIMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiUIMapper.js","names":["OpenApiUIMapper","build","swaggerProp","keyName","ui","title","label","this","generateLabel","readOnly","format","widget","validators","push","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","trim","__exports","__esModule"],"sources":["OpenApiUIMapper.ts"],"sourcesContent":["/**\n * @file OpenApiUIMapper.ts\n * @description Utility class for mapping OpenAPI properties and formats into MetaUI IUIDirectives.\n */\nimport { IUIDirective } from \"../interfaces/ISchema\";\n\n/**\n * Utility class responsible for evaluating OpenAPI metadata and generating the corresponding \n * MetaUI UI rendering directives. This isolates all visual layout assumptions from the parsing engine.\n * \n * @public\n */\nexport class OpenApiUIMapper {\n    /**\n     * Evaluates an OpenAPI property definition and constructs a MetaUI IUIDirective block.\n     * Extracts labels from title/description, maps readOnly state, and assigns \n     * specific UI5 Fiori widgets based on the OpenAPI 'format' property.\n     * \n     * @param {any} swaggerProp The raw OpenAPI property schema chunk.\n     * @param {string} keyName The technical JSON key of the property.\n     * @returns {IUIDirective} The constructed MetaUI UI orchestration directive.\n     */\n    public static build(swaggerProp: unknown, keyName: string): IUIDirective {\n        const ui: IUIDirective = {};\n\n        // Label Synthesis\n        if (swaggerProp.title) {\n            ui.label = swaggerProp.title;\n        } else {\n            ui.label = this.generateLabel(keyName);\n        }\n\n        // State Mapping\n        if (swaggerProp.readOnly === true) {\n            ui.readOnly = true;\n        }\n\n        // Format to Widget Translation\n        if (swaggerProp.format) {\n            switch (swaggerProp.format) {\n                case \"date-time\":\n                    ui.widget = \"datetime\";\n                    break;\n                case \"date\":\n                    ui.widget = \"date\";\n                    break;\n                case \"password\":\n                    ui.widget = \"password\";\n                    ui.format = \"password\"; // Kept for schema validation\n                    break;\n                case \"email\":\n                    ui.widget = \"email\";\n                    ui.format = \"email\"; // Kept for schema validation\n                    break;\n                case \"uri\":\n                    ui.widget = \"link\";\n                    ui.format = \"url\"; // Kept for schema validation\n                    break;\n                case \"binary\":\n                case \"byte\":\n                    ui.widget = \"fileUploader\";\n                    break;\n                case \"uuid\":\n                case \"ipv4\":\n                case \"ipv6\":\n                case \"hostname\":\n                    if (!ui.validators) ui.validators = [];\n                    ui.validators.push(swaggerProp.format);\n                    break;\n            }\n        }\n\n        return ui;\n    }\n\n    /**\n     * Synthesizes a human-readable Title Case label from camelCase or snake_case technical keys.\n     * \n     * @param {string} name The raw technical property key (e.g., 'creationTimestamp').\n     * @returns {string} The formatted human-readable label (e.g., 'Creation Timestamp').\n     * @private\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"],"mappings":"yCAYO,MAAMA,EAUT,YAAcC,CAAMC,EAAsBC,GACtC,MAAMC,EAAmB,CAAC,EAG1B,GAAIF,EAAYG,MAAO,CACnBD,EAAGE,MAAQJ,EAAYG,KAC3B,KAAO,CACHD,EAAGE,MAAQC,KAAKC,cAAcL,EAClC,CAGA,GAAID,EAAYO,WAAa,KAAM,CAC/BL,EAAGK,SAAW,IAClB,CAGA,GAAIP,EAAYQ,OAAQ,CACpB,OAAQR,EAAYQ,QAChB,IAAK,YACDN,EAAGO,OAAS,WACZ,MACJ,IAAK,OACDP,EAAGO,OAAS,OACZ,MACJ,IAAK,WACDP,EAAGO,OAAS,WACZP,EAAGM,OAAS,WACZ,MACJ,IAAK,QACDN,EAAGO,OAAS,QACZP,EAAGM,OAAS,QACZ,MACJ,IAAK,MACDN,EAAGO,OAAS,OACZP,EAAGM,OAAS,MACZ,MACJ,IAAK,SACL,IAAK,OACDN,EAAGO,OAAS,eACZ,MACJ,IAAK,OACL,IAAK,OACL,IAAK,OACL,IAAK,WACD,IAAKP,EAAGQ,WAAYR,EAAGQ,WAAa,GACpCR,EAAGQ,WAAWC,KAAKX,EAAYQ,QAC/B,MAEZ,CAEA,OAAON,CACX,CASA,oBAAeI,CAAcM,GACzB,IAAKA,EAAM,MAAO,GAClB,IAAIC,EAASD,EAAKE,QAAQ,WAAY,OAAOA,QAAQ,KAAM,KAC3D,OAAOD,EAAOE,MAAM,KACfC,OAAOC,GAAKA,EAAEC,OAAS,GACvBC,IAAIC,GAAQA,EAAKC,OAAO,GAAGC,cAAgBF,EAAKG,MAAM,GAAGC,eACzDC,KAAK,KACLC,MACT,EACH,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAA7B,kBAAA,OAAA6B,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/{swagger/SwaggerUIMapper.ts → openapi/OpenApiUIMapper.ts}

@@ -1,37 +1,41 @@
 /**
- * @file SwaggerUIMapper.ts
+ * @file OpenApiUIMapper.ts
  * @description Utility class for mapping OpenAPI properties and formats into MetaUI IUIDirectives.
  */
 import { IUIDirective } from "../interfaces/ISchema";
 
-export class SwaggerUIMapper {
+/**
+ * Utility class responsible for evaluating OpenAPI metadata and generating the corresponding 
+ * MetaUI UI rendering directives. This isolates all visual layout assumptions from the parsing engine.
+ * 
+ * @public
+ */
+export class OpenApiUIMapper {
     /**
      * Evaluates an OpenAPI property definition and constructs a MetaUI IUIDirective block.
      * Extracts labels from title/description, maps readOnly state, and assigns 
-     * specific Fiori widgets based on the OpenAPI 'format' property.
+     * specific UI5 Fiori widgets based on the OpenAPI 'format' property.
      * 
-     * @param {any} swaggerProp The raw OpenAPI property schema.
+     * @param {any} swaggerProp The raw OpenAPI property schema chunk.
      * @param {string} keyName The technical JSON key of the property.
      * @returns {IUIDirective} The constructed MetaUI UI orchestration directive.
      */
-    public static build(swaggerProp: any, keyName: string): IUIDirective {
+    public static build(swaggerProp: unknown, keyName: string): IUIDirective {
         const ui: IUIDirective = {};
 
-        // Labeling
+        // Label Synthesis
         if (swaggerProp.title) {
             ui.label = swaggerProp.title;
-        } else if (swaggerProp.description) {
-            ui.label = swaggerProp.description;
         } else {
             ui.label = this.generateLabel(keyName);
         }
 
-        // State
+        // State Mapping
         if (swaggerProp.readOnly === true) {
             ui.readOnly = true;
         }
 
-        // Formats to Widgets
+        // Format to Widget Translation
         if (swaggerProp.format) {
             switch (swaggerProp.format) {
                 case "date-time":
@@ -41,13 +45,20 @@ export class SwaggerUIMapper {
                     ui.widget = "date";
                     break;
                 case "password":
-                    ui.format = "password";
+                    ui.widget = "password";
+                    ui.format = "password"; // Kept for schema validation
                     break;
                 case "email":
-                    ui.format = "email";
+                    ui.widget = "email";
+                    ui.format = "email"; // Kept for schema validation
                     break;
                 case "uri":
-                    ui.format = "url";
+                    ui.widget = "link";
+                    ui.format = "url"; // Kept for schema validation
+                    break;
+                case "binary":
+                case "byte":
+                    ui.widget = "fileUploader";
                     break;
                 case "uuid":
                 case "ipv4":
@@ -63,10 +74,11 @@ export class SwaggerUIMapper {
     }
 
     /**
-     * Generates a human-readable Title Case label from camelCase or snake_case technical keys.
+     * Synthesizes a human-readable Title Case label from camelCase or snake_case technical keys.
      * 
-     * @param {string} name The technical property key.
-     * @returns {string} The formatted human-readable label.
+     * @param {string} name The raw technical property key (e.g., 'creationTimestamp').
+     * @returns {string} The formatted human-readable label (e.g., 'Creation Timestamp').
+     * @private
      */
     private static generateLabel(name: string): string {
         if (!name) return "";

package/src/nz/co/siliconst/ui5/metaui/openapi/heuristics/OpenApiHeuristicEngine-dbg.js

@@ -0,0 +1,50 @@
+sap.ui.define(["./plugins/ProtobufVariantHeuristic"], function (___plugins_ProtobufVariantHeuristic) {
+  "use strict";
+
+  /**
+   * @file OpenApiHeuristicEngine.ts
+   * @description Orchestrator that registers and executes all IHeuristicPlugin implementations against the raw schema.
+   */
+  const ProtobufVariantHeuristic = ___plugins_ProtobufVariantHeuristic["ProtobufVariantHeuristic"];
+  /**
+   * Orchestration engine that initializes and executes heuristic plugins sequentially.
+   * This pipeline mutates the raw OpenAPI document in-place to normalize non-standard constructs
+   * (like Protobuf unions) before the primary parsing phase occurs.
+   * 
+   * @public
+   */
+  class OpenApiHeuristicEngine {
+    plugins = [];
+
+    /**
+     * Initializes a new instance of the HeuristicEngine and registers default heuristics.
+     */
+    constructor() {
+      // Register default heuristics
+      this.plugins.push(new ProtobufVariantHeuristic());
+    }
+
+    /**
+     * Runs all registered heuristic plugins sequentially against the raw OpenAPI document.
+     * Captures and bubbles plugin-specific execution failures to prevent silent pipeline corruption.
+     * 
+     * @param {any} openApiRoot The entire OpenAPI root document, to be mutated in-place.
+     * @throws {Error} If any heuristic plugin crashes during execution.
+     */
+    run(openApiRoot) {
+      for (const plugin of this.plugins) {
+        try {
+          plugin.apply(openApiRoot);
+        } catch (error) {
+          throw new Error(`[MetaUI HeuristicEngine] Plugin execution failed: ${error.message}`);
+        }
+      }
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.OpenApiHeuristicEngine = OpenApiHeuristicEngine;
+  return __exports;
+});
+//# sourceMappingURL=OpenApiHeuristicEngine-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/openapi/heuristics/OpenApiHeuristicEngine-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiHeuristicEngine-dbg.js","names":["ProtobufVariantHeuristic","___plugins_ProtobufVariantHeuristic","OpenApiHeuristicEngine","plugins","constructor","push","run","openApiRoot","plugin","apply","error","Error","message","__exports","__esModule"],"sources":["OpenApiHeuristicEngine.ts"],"sourcesContent":["/**\n * @file OpenApiHeuristicEngine.ts\n * @description Orchestrator that registers and executes all IHeuristicPlugin implementations against the raw schema.\n */\n\nimport { IHeuristicPlugin } from \"./interfaces/IHeuristicPlugin\";\nimport { ProtobufVariantHeuristic } from \"./plugins/ProtobufVariantHeuristic\";\n\n/**\n * Orchestration engine that initializes and executes heuristic plugins sequentially.\n * This pipeline mutates the raw OpenAPI document in-place to normalize non-standard constructs\n * (like Protobuf unions) before the primary parsing phase occurs.\n * \n * @public\n */\nexport class OpenApiHeuristicEngine {\n    private plugins: IHeuristicPlugin[] = [];\n\n    /**\n     * Initializes a new instance of the HeuristicEngine and registers default heuristics.\n     */\n    constructor() {\n        // Register default heuristics\n        this.plugins.push(new ProtobufVariantHeuristic());\n    }\n\n    /**\n     * Runs all registered heuristic plugins sequentially against the raw OpenAPI document.\n     * Captures and bubbles plugin-specific execution failures to prevent silent pipeline corruption.\n     * \n     * @param {any} openApiRoot The entire OpenAPI root document, to be mutated in-place.\n     * @throws {Error} If any heuristic plugin crashes during execution.\n     */\n    public run(openApiRoot: unknown): void {\n        for (const plugin of this.plugins) {\n            try {\n                plugin.apply(openApiRoot);\n            } catch (error: Error) {\n                throw new Error(`[MetaUI HeuristicEngine] Plugin execution failed: ${error.message}`);\n            }\n        }\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;EAHA,MAMSA,wBAAwB,GAAAC,mCAAA;EAEjC;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMC,sBAAsB,CAAC;IACxBC,OAAO,GAAuB,EAAE;;IAExC;AACJ;AACA;IACIC,WAAWA,CAAA,EAAG;MACV;MACA,IAAI,CAACD,OAAO,CAACE,IAAI,CAAC,IAAIL,wBAAwB,CAAC,CAAC,CAAC;IACrD;;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;IACWM,GAAGA,CAACC,WAAoB,EAAQ;MACnC,KAAK,MAAMC,MAAM,IAAI,IAAI,CAACL,OAAO,EAAE;QAC/B,IAAI;UACAK,MAAM,CAACC,KAAK,CAACF,WAAW,CAAC;QAC7B,CAAC,CAAC,OAAOG,KAAY,EAAE;UACnB,MAAM,IAAIC,KAAK,CAAC,qDAAqDD,KAAK,CAACE,OAAO,EAAE,CAAC;QACzF;MACJ;IACJ;EACJ;EAAC,IAAAC,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAX,sBAAA,GAAAA,sBAAA;EAAA,OAAAW,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/openapi/heuristics/OpenApiHeuristicEngine.d.ts

@@ -0,0 +1,25 @@
+declare module "nz/co/siliconst/ui5/metaui/openapi/heuristics/OpenApiHeuristicEngine" {
+    /**
+     * Orchestration engine that initializes and executes heuristic plugins sequentially.
+     * This pipeline mutates the raw OpenAPI document in-place to normalize non-standard constructs
+     * (like Protobuf unions) before the primary parsing phase occurs.
+     *
+     * @public
+     */
+    export class OpenApiHeuristicEngine {
+        private plugins;
+        /**
+         * Initializes a new instance of the HeuristicEngine and registers default heuristics.
+         */
+        constructor();
+        /**
+         * Runs all registered heuristic plugins sequentially against the raw OpenAPI document.
+         * Captures and bubbles plugin-specific execution failures to prevent silent pipeline corruption.
+         *
+         * @param {any} openApiRoot The entire OpenAPI root document, to be mutated in-place.
+         * @throws {Error} If any heuristic plugin crashes during execution.
+         */
+        run(openApiRoot: unknown): void;
+    }
+}
+//# sourceMappingURL=OpenApiHeuristicEngine.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/openapi/heuristics/OpenApiHeuristicEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiHeuristicEngine.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/openapi/heuristics/OpenApiHeuristicEngine.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,sEAAsE,CAAC;IAStF;;;;;;OAMG;IACH,MAAa,sBAAsB;QAC/B,OAAO,CAAC,OAAO,CAA0B;QAEzC;;WAEG;;QAMH;;;;;;WAMG;QACI,GAAG,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI;KASzC;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/openapi/heuristics/OpenApiHeuristicEngine.js

@@ -0,0 +1,2 @@
+sap.ui.define(["./plugins/ProtobufVariantHeuristic"],function(i){"use strict";const t=i["ProtobufVariantHeuristic"];class n{plugins=[];constructor(){this.plugins.push(new t)}run(i){for(const t of this.plugins){try{t.apply(i)}catch(i){throw new Error(`[MetaUI HeuristicEngine] Plugin execution failed: ${i.message}`)}}}}var e={__esModule:true};e.OpenApiHeuristicEngine=n;return e});
+//# sourceMappingURL=OpenApiHeuristicEngine.js.map

package/src/nz/co/siliconst/ui5/metaui/openapi/heuristics/OpenApiHeuristicEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiHeuristicEngine.js","names":["ProtobufVariantHeuristic","___plugins_ProtobufVariantHeuristic","OpenApiHeuristicEngine","plugins","constructor","this","push","run","openApiRoot","plugin","apply","error","Error","message","__exports","__esModule"],"sources":["OpenApiHeuristicEngine.ts"],"sourcesContent":["/**\n * @file OpenApiHeuristicEngine.ts\n * @description Orchestrator that registers and executes all IHeuristicPlugin implementations against the raw schema.\n */\n\nimport { IHeuristicPlugin } from \"./interfaces/IHeuristicPlugin\";\nimport { ProtobufVariantHeuristic } from \"./plugins/ProtobufVariantHeuristic\";\n\n/**\n * Orchestration engine that initializes and executes heuristic plugins sequentially.\n * This pipeline mutates the raw OpenAPI document in-place to normalize non-standard constructs\n * (like Protobuf unions) before the primary parsing phase occurs.\n * \n * @public\n */\nexport class OpenApiHeuristicEngine {\n    private plugins: IHeuristicPlugin[] = [];\n\n    /**\n     * Initializes a new instance of the HeuristicEngine and registers default heuristics.\n     */\n    constructor() {\n        // Register default heuristics\n        this.plugins.push(new ProtobufVariantHeuristic());\n    }\n\n    /**\n     * Runs all registered heuristic plugins sequentially against the raw OpenAPI document.\n     * Captures and bubbles plugin-specific execution failures to prevent silent pipeline corruption.\n     * \n     * @param {any} openApiRoot The entire OpenAPI root document, to be mutated in-place.\n     * @throws {Error} If any heuristic plugin crashes during execution.\n     */\n    public run(openApiRoot: unknown): void {\n        for (const plugin of this.plugins) {\n            try {\n                plugin.apply(openApiRoot);\n            } catch (error: Error) {\n                throw new Error(`[MetaUI HeuristicEngine] Plugin execution failed: ${error.message}`);\n            }\n        }\n    }\n}\n"],"mappings":"8EAAA,MAMSA,EAAwBC,EAAA,4BAS1B,MAAMC,EACDC,QAA8B,GAKtCC,cAEIC,KAAKF,QAAQG,KAAK,IAAIN,EAC1B,CASOO,IAAIC,GACP,IAAK,MAAMC,KAAUJ,KAAKF,QAAS,CAC/B,IACIM,EAAOC,MAAMF,EACjB,CAAE,MAAOG,GACL,MAAM,IAAIC,MAAM,qDAAqDD,EAAME,UAC/E,CACJ,CACJ,EACH,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAAZ,yBAAA,OAAAY,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/openapi/heuristics/OpenApiHeuristicEngine.ts

@@ -0,0 +1,43 @@
+/**
+ * @file OpenApiHeuristicEngine.ts
+ * @description Orchestrator that registers and executes all IHeuristicPlugin implementations against the raw schema.
+ */
+
+import { IHeuristicPlugin } from "./interfaces/IHeuristicPlugin";
+import { ProtobufVariantHeuristic } from "./plugins/ProtobufVariantHeuristic";
+
+/**
+ * Orchestration engine that initializes and executes heuristic plugins sequentially.
+ * This pipeline mutates the raw OpenAPI document in-place to normalize non-standard constructs
+ * (like Protobuf unions) before the primary parsing phase occurs.
+ * 
+ * @public
+ */
+export class OpenApiHeuristicEngine {
+    private plugins: IHeuristicPlugin[] = [];
+
+    /**
+     * Initializes a new instance of the HeuristicEngine and registers default heuristics.
+     */
+    constructor() {
+        // Register default heuristics
+        this.plugins.push(new ProtobufVariantHeuristic());
+    }
+
+    /**
+     * Runs all registered heuristic plugins sequentially against the raw OpenAPI document.
+     * Captures and bubbles plugin-specific execution failures to prevent silent pipeline corruption.
+     * 
+     * @param {any} openApiRoot The entire OpenAPI root document, to be mutated in-place.
+     * @throws {Error} If any heuristic plugin crashes during execution.
+     */
+    public run(openApiRoot: unknown): void {
+        for (const plugin of this.plugins) {
+            try {
+                plugin.apply(openApiRoot);
+            } catch (error: Error) {
+                throw new Error(`[MetaUI HeuristicEngine] Plugin execution failed: ${error.message}`);
+            }
+        }
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/openapi/heuristics/interfaces/IHeuristicPlugin-dbg.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=IHeuristicPlugin-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/openapi/heuristics/interfaces/IHeuristicPlugin-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IHeuristicPlugin-dbg.js","names":[],"sources":["IHeuristicPlugin.ts"],"sourcesContent":["/**\n * @file IHeuristicPlugin.ts\n * @description Contract for plugins that inspect and mutate the raw OpenAPI AST before translation.\n */\n\n/**\n * Interface defining the operational boundaries for structural heuristic plugins.\n * Implementations are executed synchronously during the pre-processing phase to normalize\n * non-standard schema constructs (like generic object unions) before translation occurs.\n * \n * @public\n */\nexport interface IHeuristicPlugin {\n    /**\n     * Evaluates and mutates the provided OpenAPI AST in-place.\n     * Heuristics are expected to strictly scope their mutations to patterns they explicitly recognize.\n     * \n     * @param {any} openApiRoot The mutable OpenAPI root document block.\n     */\n    apply(openApiRoot: unknown): void;\n}\n"],"mappings":"","ignoreList":[]}