@siliconst/metaui 1.4.17 → 1.4.21

package/src/nz/co/siliconst/ui5/metaui/swagger/OpenApiExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiExtractor.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/swagger/OpenApiExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,qDAAqD,CAAC;IACrE,OAAO,SAAS,MAAM,oBAAoB,CAAC;IAE3C,UAAiB,aAAa;QAC1B,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KAChB;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,SAAS;QAEnD;;;;;;WAMG;eACW,cAAc,CAAC,SAAS,EAAE,OAAO,GAAG,aAAa,EAAE;KAsIpE;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/swagger/OpenApiExtractor.js

@@ -0,0 +1,2 @@
+sap.ui.define(["sap/ui/base/Object"],function(e){"use strict";const t=e.extend("nz.co.siliconst.ui5.metaui.swagger.OpenApiExtractor",{});t.extractTargets=function e(t){const s=[];if(!t||typeof t!=="object"){return s}const o=t;if(typeof o.openapi==="string"&&o.openapi.startsWith("3.")&&o.components&&typeof o.components.schemas==="object"){Object.keys(o.components.schemas).forEach(e=>{s.push({key:"#/components/schemas/"+e,text:"Schema: "+e})})}if(typeof o.swagger==="string"&&o.swagger.startsWith("2.")&&typeof o.definitions==="object"&&o.definitions!==null){Object.keys(o.definitions).forEach(e=>{s.push({key:"#/definitions/"+e,text:"Definition: "+e})})}if(typeof o.paths==="object"&&o.paths!==null){Object.keys(o.paths).forEach(e=>{const t=o.paths[e];if(t&&typeof t==="object"){Object.keys(t).forEach(t=>{const o=e.replace(/\//g,"~1");s.push({key:"#/paths/"+o+"/"+t,text:"Operation: "+t.toUpperCase()+" "+e})})}})}if(s.length>1){let e=-1;let t=-1;const i=o.info;const n=i&&typeof i.title==="string"?i.title.toLowerCase().replace(/[^a-z0-9]/g,""):"";const c=i&&typeof i.title==="string"?i.title.toLowerCase().split(/[\s_-]+/):[];s.forEach((s,i)=>{let f=0;if(s.key.includes("/schemas/")||s.key.includes("/definitions/")){const e=s.key.split("/").pop()||"";const t=e.toLowerCase();const i=t.replace(/[^a-z0-9]/g,"");if(n&&i===n)f+=30;else if(n&&n.includes(i))f+=15;else if(n&&i.includes(n))f+=15;c.forEach(e=>{if(e.length>3&&t.includes(e))f+=5});const r=["root","main","app","application","payload","document"];if(r.some(e=>t.includes(e)))f+=5;let a=null;if(s.key.startsWith("#/components/schemas/")&&typeof o.components==="object"&&o.components!==null){const t=o.components;if(typeof t.schemas==="object"&&t.schemas!==null){a=t.schemas[e]||null}}else if(s.key.startsWith("#/definitions/")&&typeof o.definitions==="object"&&o.definitions!==null){a=o.definitions[e]||null}if(a&&typeof a==="object"){const e=e=>{if(!e||typeof e!=="object")return;const t=e;if(t.properties&&typeof t.properties==="object"){f+=Object.keys(t.properties).length*2;Object.values(t.properties).forEach(e=>{if(e&&typeof e==="object"){const t=e;if(t.$ref)f+=20;if(t.items&&typeof t.items==="object"&&t.items.$ref)f+=20}})}if(t.required&&Array.isArray(t.required)){f+=t.required.length*5}};e(a);if(a.allOf&&Array.isArray(a.allOf)){a.allOf.forEach(e)}if(a.anyOf&&Array.isArray(a.anyOf)){a.anyOf.forEach(e)}if(a.oneOf&&Array.isArray(a.oneOf)){a.oneOf.forEach(e)}}}if(f>e){e=f;t=i}});if(t!==-1&&e>0){const e=s.splice(t,1)[0];e.text=`(Recommended) ${e.text}`;s.unshift(e)}}return s};return t});
+//# sourceMappingURL=OpenApiExtractor.js.map

package/src/nz/co/siliconst/ui5/metaui/swagger/OpenApiExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiExtractor.js","names":["OpenApiExtractor","UI5Object","extend","extractTargets","rawSchema","aTargets","oSchema","openapi","startsWith","components","schemas","Object","keys","forEach","sKey","push","key","text","swagger","definitions","paths","sPath","methods","sMethod","escapedPath","replace","toUpperCase","length","bestScore","bestIndex","info","title","toLowerCase","titleWords","split","target","index","score","includes","name","pop","nameLower","nameClean","word","genericRoots","some","r","schemaDef","scoreSchemaNode","node","nodeObj","properties","values","prop","propObj","$ref","items","required","Array","isArray","allOf","anyOf","oneOf","primary","splice","unshift"],"sources":["OpenApiExtractor.ts"],"sourcesContent":["import UI5Object from \"sap/ui/base/Object\";\n\nexport interface OpenApiTarget {\n    key: string;\n    text: string;\n}\n\n/**\n * @class\n * OpenApiExtractor utility.\n * Dynamically crawls OpenAPI/Swagger JSON specifications to find all valid \n * root endpoints and schema definitions that can be used as a schemaTarget.\n * \n * @extends sap.ui.base.Object\n * @alias nz.co.siliconst.ui5.metaui.swagger.OpenApiExtractor\n */\nexport default class OpenApiExtractor extends UI5Object {\n\n    /**\n     * Parses an OpenAPI document and extracts an array of valid targets.\n     * \n     * @public\n     * @param oSchema The parsed JSON schema object.\n     * @returns Array of target bindings.\n     */\n    public static extractTargets(rawSchema: unknown): OpenApiTarget[] {\n        const aTargets: OpenApiTarget[] = [];\n        if (!rawSchema || typeof rawSchema !== \"object\") {\n            return aTargets;\n        }\n\n        const oSchema = rawSchema as Record<string, unknown>;\n\n        // OpenAPI 3.0 (components/schemas)\n        if (typeof oSchema.openapi === \"string\" && oSchema.openapi.startsWith(\"3.\") && oSchema.components && typeof (oSchema.components as Record<string,unknown>).schemas === \"object\") {\n            Object.keys((oSchema.components as Record<string,unknown>).schemas as Record<string,unknown>).forEach((sKey) => {\n                aTargets.push({\n                    key: \"#/components/schemas/\" + sKey,\n                    text: \"Schema: \" + sKey\n                });\n            });\n        }\n        \n        // Swagger 2.0 (definitions)\n        if (typeof oSchema.swagger === \"string\" && oSchema.swagger.startsWith(\"2.\") && typeof oSchema.definitions === \"object\" && oSchema.definitions !== null) {\n            Object.keys(oSchema.definitions as Record<string,unknown>).forEach((sKey) => {\n                aTargets.push({\n                    key: \"#/definitions/\" + sKey,\n                    text: \"Definition: \" + sKey\n                });\n            });\n        }\n\n        // Extract endpoints\n        if (typeof oSchema.paths === \"object\" && oSchema.paths !== null) {\n            Object.keys(oSchema.paths as Record<string,unknown>).forEach((sPath) => {\n                const methods = (oSchema.paths as Record<string,unknown>)[sPath];\n                if (methods && typeof methods === \"object\") {\n                    Object.keys(methods).forEach((sMethod) => {\n                        const escapedPath = sPath.replace(/\\//g, \"~1\");\n                        aTargets.push({\n                            key: \"#/paths/\" + escapedPath + \"/\" + sMethod,\n                            text: \"Operation: \" + sMethod.toUpperCase() + \" \" + sPath\n                        });\n                    });\n                }\n            });\n        }\n\n        // Primary Schema Detection\n        if (aTargets.length > 1) {\n            let bestScore = -1;\n            let bestIndex = -1;\n            \n                    const info = oSchema.info as Record<string, unknown> | undefined;\n            const title = (info && typeof info.title === \"string\") ? info.title.toLowerCase().replace(/[^a-z0-9]/g, \"\") : \"\";\n            const titleWords = (info && typeof info.title === \"string\") ? info.title.toLowerCase().split(/[\\s_-]+/) : [];\n            \n            aTargets.forEach((target, index) => {\n                let score = 0;\n                \n                // Only score Schemas/Definitions, not operations for the primary node heuristic\n                if (target.key.includes(\"/schemas/\") || target.key.includes(\"/definitions/\")) {\n                    const name = target.key.split(\"/\").pop() || \"\";\n                    const nameLower = name.toLowerCase();\n                    const nameClean = nameLower.replace(/[^a-z0-9]/g, \"\");\n                    \n                    if (title && nameClean === title) score += 30; // Reduced from 100\n                    else if (title && title.includes(nameClean)) score += 15; // Reduced from 50\n                    else if (title && nameClean.includes(title)) score += 15; // Reduced from 50\n                    \n                    titleWords.forEach((word: string) => {\n                        if (word.length > 3 && nameLower.includes(word)) score += 5; // Reduced from 10\n                    });\n                    \n                    const genericRoots = [\"root\", \"main\", \"app\", \"application\", \"payload\", \"document\"];\n                    if (genericRoots.some(r => nameLower.includes(r))) score += 5;\n\n                    // Complexity Fallback\n                    let schemaDef: Record<string, unknown> | null = null;\n                    if (target.key.startsWith(\"#/components/schemas/\") && typeof oSchema.components === \"object\" && oSchema.components !== null) {\n                        const components = oSchema.components as Record<string, unknown>;\n                        if (typeof components.schemas === \"object\" && components.schemas !== null) {\n                            schemaDef = (components.schemas as Record<string, Record<string, unknown>>)[name] || null;\n                        }\n                    } else if (target.key.startsWith(\"#/definitions/\") && typeof oSchema.definitions === \"object\" && oSchema.definitions !== null) {\n                        schemaDef = (oSchema.definitions as Record<string, Record<string, unknown>>)[name] || null;\n                    }\n\n                    if (schemaDef && typeof schemaDef === \"object\") {\n                        const scoreSchemaNode = (node: unknown) => {\n                            if (!node || typeof node !== \"object\") return;\n                            const nodeObj = node as Record<string, unknown>;\n                            if (nodeObj.properties && typeof nodeObj.properties === \"object\") {\n                                score += Object.keys(nodeObj.properties).length * 2; // +2 per property\n                                Object.values(nodeObj.properties).forEach((prop: unknown) => {\n                                    if (prop && typeof prop === \"object\") {\n                                        const propObj = prop as Record<string, unknown>;\n                                        if (propObj.$ref) score += 20; // +20 for referencing sub-schemas (aggregate root)\n                                        if (propObj.items && typeof propObj.items === \"object\" && (propObj.items as Record<string, unknown>).$ref) score += 20;\n                                    }\n                                });\n                            }\n                            \n                            if (nodeObj.required && Array.isArray(nodeObj.required)) {\n                                score += nodeObj.required.length * 5; // +5 per required constraint\n                            }\n                        };\n\n                        scoreSchemaNode(schemaDef);\n\n                        // Handle OpenAPI composition structures\n                        if (schemaDef.allOf && Array.isArray(schemaDef.allOf)) {\n                            schemaDef.allOf.forEach(scoreSchemaNode);\n                        }\n                        if (schemaDef.anyOf && Array.isArray(schemaDef.anyOf)) {\n                            schemaDef.anyOf.forEach(scoreSchemaNode);\n                        }\n                        if (schemaDef.oneOf && Array.isArray(schemaDef.oneOf)) {\n                            schemaDef.oneOf.forEach(scoreSchemaNode);\n                        }\n                    }\n                }\n                \n                if (score > bestScore) {\n                    bestScore = score;\n                    bestIndex = index;\n                }\n            });\n\n            if (bestIndex !== -1 && bestScore > 0) {\n                const primary = aTargets.splice(bestIndex, 1)[0];\n                primary.text = `(Recommended) ${primary.text}`;\n                aTargets.unshift(primary);\n            }\n        }\n\n        return aTargets;\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/swagger/OpenApiExtractor.ts

@@ -0,0 +1,160 @@
+import UI5Object from "sap/ui/base/Object";
+
+export interface OpenApiTarget {
+    key: string;
+    text: string;
+}
+
+/**
+ * @class
+ * OpenApiExtractor utility.
+ * Dynamically crawls OpenAPI/Swagger JSON specifications to find all valid 
+ * root endpoints and schema definitions that can be used as a schemaTarget.
+ * 
+ * @extends sap.ui.base.Object
+ * @alias nz.co.siliconst.ui5.metaui.swagger.OpenApiExtractor
+ */
+export default class OpenApiExtractor extends UI5Object {
+
+    /**
+     * Parses an OpenAPI document and extracts an array of valid targets.
+     * 
+     * @public
+     * @param oSchema The parsed JSON schema object.
+     * @returns Array of target bindings.
+     */
+    public static extractTargets(rawSchema: unknown): OpenApiTarget[] {
+        const aTargets: OpenApiTarget[] = [];
+        if (!rawSchema || typeof rawSchema !== "object") {
+            return aTargets;
+        }
+
+        const oSchema = rawSchema as Record<string, unknown>;
+
+        // OpenAPI 3.0 (components/schemas)
+        if (typeof oSchema.openapi === "string" && oSchema.openapi.startsWith("3.") && oSchema.components && typeof (oSchema.components as Record<string,unknown>).schemas === "object") {
+            Object.keys((oSchema.components as Record<string,unknown>).schemas as Record<string,unknown>).forEach((sKey) => {
+                aTargets.push({
+                    key: "#/components/schemas/" + sKey,
+                    text: "Schema: " + sKey
+                });
+            });
+        }
+        
+        // Swagger 2.0 (definitions)
+        if (typeof oSchema.swagger === "string" && oSchema.swagger.startsWith("2.") && typeof oSchema.definitions === "object" && oSchema.definitions !== null) {
+            Object.keys(oSchema.definitions as Record<string,unknown>).forEach((sKey) => {
+                aTargets.push({
+                    key: "#/definitions/" + sKey,
+                    text: "Definition: " + sKey
+                });
+            });
+        }
+
+        // Extract endpoints
+        if (typeof oSchema.paths === "object" && oSchema.paths !== null) {
+            Object.keys(oSchema.paths as Record<string,unknown>).forEach((sPath) => {
+                const methods = (oSchema.paths as Record<string,unknown>)[sPath];
+                if (methods && typeof methods === "object") {
+                    Object.keys(methods).forEach((sMethod) => {
+                        const escapedPath = sPath.replace(/\//g, "~1");
+                        aTargets.push({
+                            key: "#/paths/" + escapedPath + "/" + sMethod,
+                            text: "Operation: " + sMethod.toUpperCase() + " " + sPath
+                        });
+                    });
+                }
+            });
+        }
+
+        // Primary Schema Detection
+        if (aTargets.length > 1) {
+            let bestScore = -1;
+            let bestIndex = -1;
+            
+                    const info = oSchema.info as Record<string, unknown> | undefined;
+            const title = (info && typeof info.title === "string") ? info.title.toLowerCase().replace(/[^a-z0-9]/g, "") : "";
+            const titleWords = (info && typeof info.title === "string") ? info.title.toLowerCase().split(/[\s_-]+/) : [];
+            
+            aTargets.forEach((target, index) => {
+                let score = 0;
+                
+                // Only score Schemas/Definitions, not operations for the primary node heuristic
+                if (target.key.includes("/schemas/") || target.key.includes("/definitions/")) {
+                    const name = target.key.split("/").pop() || "";
+                    const nameLower = name.toLowerCase();
+                    const nameClean = nameLower.replace(/[^a-z0-9]/g, "");
+                    
+                    if (title && nameClean === title) score += 30; // Reduced from 100
+                    else if (title && title.includes(nameClean)) score += 15; // Reduced from 50
+                    else if (title && nameClean.includes(title)) score += 15; // Reduced from 50
+                    
+                    titleWords.forEach((word: string) => {
+                        if (word.length > 3 && nameLower.includes(word)) score += 5; // Reduced from 10
+                    });
+                    
+                    const genericRoots = ["root", "main", "app", "application", "payload", "document"];
+                    if (genericRoots.some(r => nameLower.includes(r))) score += 5;
+
+                    // Complexity Fallback
+                    let schemaDef: Record<string, unknown> | null = null;
+                    if (target.key.startsWith("#/components/schemas/") && typeof oSchema.components === "object" && oSchema.components !== null) {
+                        const components = oSchema.components as Record<string, unknown>;
+                        if (typeof components.schemas === "object" && components.schemas !== null) {
+                            schemaDef = (components.schemas as Record<string, Record<string, unknown>>)[name] || null;
+                        }
+                    } else if (target.key.startsWith("#/definitions/") && typeof oSchema.definitions === "object" && oSchema.definitions !== null) {
+                        schemaDef = (oSchema.definitions as Record<string, Record<string, unknown>>)[name] || null;
+                    }
+
+                    if (schemaDef && typeof schemaDef === "object") {
+                        const scoreSchemaNode = (node: unknown) => {
+                            if (!node || typeof node !== "object") return;
+                            const nodeObj = node as Record<string, unknown>;
+                            if (nodeObj.properties && typeof nodeObj.properties === "object") {
+                                score += Object.keys(nodeObj.properties).length * 2; // +2 per property
+                                Object.values(nodeObj.properties).forEach((prop: unknown) => {
+                                    if (prop && typeof prop === "object") {
+                                        const propObj = prop as Record<string, unknown>;
+                                        if (propObj.$ref) score += 20; // +20 for referencing sub-schemas (aggregate root)
+                                        if (propObj.items && typeof propObj.items === "object" && (propObj.items as Record<string, unknown>).$ref) score += 20;
+                                    }
+                                });
+                            }
+                            
+                            if (nodeObj.required && Array.isArray(nodeObj.required)) {
+                                score += nodeObj.required.length * 5; // +5 per required constraint
+                            }
+                        };
+
+                        scoreSchemaNode(schemaDef);
+
+                        // Handle OpenAPI composition structures
+                        if (schemaDef.allOf && Array.isArray(schemaDef.allOf)) {
+                            schemaDef.allOf.forEach(scoreSchemaNode);
+                        }
+                        if (schemaDef.anyOf && Array.isArray(schemaDef.anyOf)) {
+                            schemaDef.anyOf.forEach(scoreSchemaNode);
+                        }
+                        if (schemaDef.oneOf && Array.isArray(schemaDef.oneOf)) {
+                            schemaDef.oneOf.forEach(scoreSchemaNode);
+                        }
+                    }
+                }
+                
+                if (score > bestScore) {
+                    bestScore = score;
+                    bestIndex = index;
+                }
+            });
+
+            if (bestIndex !== -1 && bestScore > 0) {
+                const primary = aTargets.splice(bestIndex, 1)[0];
+                primary.text = `(Recommended) ${primary.text}`;
+                aTargets.unshift(primary);
+            }
+        }
+
+        return aTargets;
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/swagger/SwaggerBuilder-dbg.js

@@ -1,226 +0,0 @@
-sap.ui.define(["../utils/Logger", "./SwaggerTypeMapper", "./SwaggerUIMapper", "./SwaggerRefResolver"], function (___utils_Logger, ___SwaggerTypeMapper, ___SwaggerUIMapper, ___SwaggerRefResolver) {
-  "use strict";
-
-  /**
-   * @file SwaggerBuilder.ts
-   * @description Facade orchestration for translating Swagger/OpenAPI JSON into native MetaUI ISchema.
-   * Strict Single Responsibility architecture delegates mapping logic to dedicated utilities.
-   */
-  const Logger = ___utils_Logger["Logger"];
-  const SwaggerTypeMapper = ___SwaggerTypeMapper["SwaggerTypeMapper"];
-  const SwaggerUIMapper = ___SwaggerUIMapper["SwaggerUIMapper"];
-  const SwaggerRefResolver = ___SwaggerRefResolver["SwaggerRefResolver"];
-  class SwaggerBuilder {
-    /**
-     * Determines if the provided JSON payload is a Swagger or OpenAPI document.
-     * 
-     * @param {any} rawSchema The raw JSON schema to test.
-     * @returns {boolean} True if the document contains 'openapi' or 'swagger' root keys.
-     */
-    canHandle(rawSchema) {
-      return !!(rawSchema && (rawSchema.openapi || rawSchema.swagger));
-    }
-
-    /**
-     * Builds a strict MetaUI ISchema from the provided OpenAPI payload.
-     * 
-     * @param {any} rawSchema The OpenAPI root document.
-     * @returns {ISchema} The translated MetaUI schema.
-     */
-    build(rawSchema) {
-      return SwaggerBuilder.build(rawSchema);
-    }
-
-    /**
-     * Asynchronously fetches a remote OpenAPI document and compiles it into a MetaUI ISchema.
-     * 
-     * @param {string} url The URL to fetch the JSON payload from.
-     * @param {string} [targetDefinition] Optional. The specific entity schema to extract.
-     * @returns {Promise<ISchema>} A Promise resolving to the compiled ISchema.
-     */
-    static async fetchAndBuild(url, targetDefinition) {
-      try {
-        const response = await fetch(url);
-        if (!response.ok) {
-          throw new Error(`HTTP error! status: ${response.status}`);
-        }
-        const swaggerRoot = await response.json();
-        return this.build(swaggerRoot, targetDefinition);
-      } catch (error) {
-        const msg = "Failed to fetch Swagger JSON from URL: " + error.message;
-        Logger.error("[MetaUI SwaggerBuilder]", msg);
-        throw new Error(msg);
-      }
-    }
-
-    /**
-     * Synchronously builds a MetaUI ISchema from a provided OpenAPI root document.
-     * Automatically extracts the requested definition from `components.schemas` or falls back to the first available.
-     * 
-     * @param {any} swaggerRoot The OpenAPI root document.
-     * @param {string} [targetDefinition] Optional. The specific entity schema to extract.
-     * @returns {ISchema} The translated MetaUI schema.
-     */
-    static build(swaggerRoot, targetDefinition) {
-      if (!swaggerRoot || typeof swaggerRoot !== "object") {
-        throw new Error("[MetaUI SwaggerBuilder] Invalid Swagger root object provided.");
-      }
-      let targetObject = swaggerRoot;
-      if (!targetDefinition) {
-        if (swaggerRoot.components && swaggerRoot.components.schemas) {
-          const keys = Object.keys(swaggerRoot.components.schemas);
-          if (keys.length > 0) targetDefinition = keys[0];
-        } else if (swaggerRoot.definitions) {
-          const keys = Object.keys(swaggerRoot.definitions);
-          if (keys.length > 0) targetDefinition = keys[0];
-        }
-      }
-      if (targetDefinition) {
-        let found = false;
-        if (swaggerRoot.components && swaggerRoot.components.schemas && swaggerRoot.components.schemas[targetDefinition]) {
-          targetObject = swaggerRoot.components.schemas[targetDefinition];
-          found = true;
-        } else if (swaggerRoot.definitions && swaggerRoot.definitions[targetDefinition]) {
-          targetObject = swaggerRoot.definitions[targetDefinition];
-          found = true;
-        }
-        if (!found) {
-          throw new Error(`[MetaUI SwaggerBuilder] Could not find target definition '${targetDefinition}' in components/schemas or definitions.`);
-        }
-      }
-      const schema = {
-        title: targetObject.title || swaggerRoot.info?.title || targetDefinition,
-        type: targetObject.type === "array" ? "array" : "object",
-        layoutStrategy: targetObject.type === "array" ? "table" : "form"
-      };
-      if (targetObject.additionalProperties === true) {
-        schema.additionalProperties = true;
-      }
-      if (schema.type === "object") {
-        const requiredKeys = Array.isArray(targetObject.required) ? targetObject.required : [];
-        schema.properties = this.mapProperties(targetObject.properties || {}, requiredKeys, swaggerRoot);
-      } else if (schema.type === "array" && targetObject.items) {
-        schema.items = this.mapPropertyMetadata(targetObject.items, "items", false, swaggerRoot);
-      }
-      return schema;
-    }
-
-    /**
-     * Recursively traverses and translates an OpenAPI properties block into MetaUI IPropertyMetadata.
-     * 
-     * @param {Record<string, any>} properties The OpenAPI properties object.
-     * @param {string[]} requiredKeys An array of keys marked as required in the parent schema.
-     * @param {any} swaggerRoot The root document (used for $ref resolution).
-     * @returns {Record<string, IPropertyMetadata>} The mapped MetaUI properties object.
-     */
-    static mapProperties(properties, requiredKeys, swaggerRoot) {
-      const normalizedProps = {};
-      for (const key of Object.keys(properties)) {
-        const isRequired = requiredKeys.includes(key);
-        let propDef = properties[key];
-        if (propDef.$ref) {
-          const resolved = SwaggerRefResolver.resolve(propDef.$ref, swaggerRoot);
-          if (resolved) {
-            propDef = {
-              ...resolved,
-              ...propDef
-            };
-          }
-        }
-        normalizedProps[key] = this.mapPropertyMetadata(propDef, key, isRequired, swaggerRoot);
-      }
-      return normalizedProps;
-    }
-
-    /**
-     * Translates a single OpenAPI property schema into a MetaUI IPropertyMetadata block.
-     * Handles local $ref resolution, allOf merging, type mapping, and UI directive injection.
-     * 
-     * @param {any} swaggerProp The OpenAPI property definition.
-     * @param {string} keyName The technical key of the property.
-     * @param {boolean} isRequired Whether this property is strictly required.
-     * @param {any} swaggerRoot The root document (used for $ref resolution).
-     * @returns {IPropertyMetadata} The compiled MetaUI property metadata.
-     */
-    static mapPropertyMetadata(swaggerProp, keyName, isRequired, swaggerRoot) {
-      let currentProp = swaggerProp;
-      if (currentProp.$ref) {
-        const resolved = SwaggerRefResolver.resolve(currentProp.$ref, swaggerRoot);
-        if (resolved) {
-          currentProp = {
-            ...resolved,
-            ...currentProp
-          };
-        }
-      }
-      if (Array.isArray(currentProp.allOf)) {
-        let merged = {
-          ...currentProp
-        };
-        delete merged.allOf;
-        for (const subSchema of currentProp.allOf) {
-          let resolvedSub = subSchema;
-          if (subSchema.$ref) {
-            resolvedSub = SwaggerRefResolver.resolve(subSchema.$ref, swaggerRoot) || {};
-          }
-          merged = {
-            ...merged,
-            ...resolvedSub
-          };
-        }
-        currentProp = merged;
-      }
-      const type = SwaggerTypeMapper.mapType(currentProp.type);
-      const metaProp = {
-        type: type,
-        required: isRequired
-      };
-      const uiDirective = SwaggerUIMapper.build(currentProp, keyName);
-      if (Object.keys(uiDirective).length > 0) {
-        metaProp.ui = uiDirective;
-      }
-      if (typeof currentProp.maxLength === "number") metaProp.maxLength = currentProp.maxLength;
-      if (typeof currentProp.minLength === "number") metaProp.minLength = currentProp.minLength;
-      if (typeof currentProp.maximum === "number") metaProp.maximum = currentProp.maximum;
-      if (typeof currentProp.minimum === "number") metaProp.minimum = currentProp.minimum;
-      if (typeof currentProp.pattern === "string") metaProp.pattern = currentProp.pattern;
-      if (typeof currentProp.multipleOf === "number") metaProp.multipleOf = currentProp.multipleOf;
-      if (currentProp.default !== undefined) metaProp.default = currentProp.default;
-      if (typeof currentProp.nullable === "boolean") metaProp.nullable = currentProp.nullable;
-      if (typeof currentProp.writeOnly === "boolean") metaProp.writeOnly = currentProp.writeOnly;
-      if (currentProp.example !== undefined) metaProp.example = currentProp.example;
-      if (typeof currentProp.deprecated === "boolean") metaProp.deprecated = currentProp.deprecated;
-      if (currentProp.exclusiveMinimum !== undefined) metaProp.exclusiveMinimum = currentProp.exclusiveMinimum;
-      if (currentProp.exclusiveMaximum !== undefined) metaProp.exclusiveMaximum = currentProp.exclusiveMaximum;
-      if (Array.isArray(currentProp.enum)) {
-        metaProp.enum = currentProp.enum;
-        if (!metaProp.ui) metaProp.ui = {};
-        if (!metaProp.ui.widget) {
-          if (type === "array") {
-            metaProp.ui.widget = "multiSelect";
-          } else {
-            metaProp.ui.widget = "select";
-          }
-        }
-      }
-      if (type === "object") {
-        if (currentProp.properties) {
-          const childRequired = Array.isArray(currentProp.required) ? currentProp.required : [];
-          metaProp.properties = this.mapProperties(currentProp.properties, childRequired, swaggerRoot);
-        }
-        if (currentProp.additionalProperties === true) {
-          metaProp.additionalProperties = true;
-        }
-      } else if (type === "array" && currentProp.items) {
-        metaProp.items = this.mapPropertyMetadata(currentProp.items, "items", false, swaggerRoot);
-      }
-      return metaProp;
-    }
-  }
-  var __exports = {
-    __esModule: true
-  };
-  __exports.SwaggerBuilder = SwaggerBuilder;
-  return __exports;
-});
-//# sourceMappingURL=SwaggerBuilder-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/swagger/SwaggerBuilder-dbg.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SwaggerBuilder-dbg.js","names":["Logger","___utils_Logger","SwaggerTypeMapper","___SwaggerTypeMapper","SwaggerUIMapper","___SwaggerUIMapper","SwaggerRefResolver","___SwaggerRefResolver","SwaggerBuilder","canHandle","rawSchema","openapi","swagger","build","fetchAndBuild","url","targetDefinition","response","fetch","ok","Error","status","swaggerRoot","json","error","msg","message","targetObject","components","schemas","keys","Object","length","definitions","found","schema","title","info","type","layoutStrategy","additionalProperties","requiredKeys","Array","isArray","required","properties","mapProperties","items","mapPropertyMetadata","normalizedProps","key","isRequired","includes","propDef","$ref","resolved","resolve","swaggerProp","keyName","currentProp","allOf","merged","subSchema","resolvedSub","mapType","metaProp","uiDirective","ui","maxLength","minLength","maximum","minimum","pattern","multipleOf","default","undefined","nullable","writeOnly","example","deprecated","exclusiveMinimum","exclusiveMaximum","enum","widget","childRequired","__exports","__esModule"],"sources":["SwaggerBuilder.ts"],"sourcesContent":["/**\n * @file SwaggerBuilder.ts\n * @description Facade orchestration for translating Swagger/OpenAPI JSON into native MetaUI ISchema.\n * Strict Single Responsibility architecture delegates mapping logic to dedicated utilities.\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { ISchemaBuilderPlugin } from \"../interfaces/ISchemaBuilderPlugin\";\nimport { Logger } from \"../utils/Logger\";\nimport { SwaggerTypeMapper } from \"./SwaggerTypeMapper\";\nimport { SwaggerUIMapper } from \"./SwaggerUIMapper\";\nimport { SwaggerRefResolver } from \"./SwaggerRefResolver\";\n\nexport class SwaggerBuilder implements ISchemaBuilderPlugin {\n\n    /**\n     * Determines if the provided JSON payload is a Swagger or OpenAPI document.\n     * \n     * @param {any} rawSchema The raw JSON schema to test.\n     * @returns {boolean} True if the document contains 'openapi' or 'swagger' root keys.\n     */\n    public canHandle(rawSchema: any): boolean {\n        return !!(rawSchema && (rawSchema.openapi || rawSchema.swagger));\n    }\n\n    /**\n     * Builds a strict MetaUI ISchema from the provided OpenAPI payload.\n     * \n     * @param {any} rawSchema The OpenAPI root document.\n     * @returns {ISchema} The translated MetaUI schema.\n     */\n    public build(rawSchema: any): ISchema {\n        return SwaggerBuilder.build(rawSchema);\n    }\n\n    /**\n     * Asynchronously fetches a remote OpenAPI document and compiles it into a MetaUI ISchema.\n     * \n     * @param {string} url The URL to fetch the JSON payload from.\n     * @param {string} [targetDefinition] Optional. The specific entity schema to extract.\n     * @returns {Promise<ISchema>} A Promise resolving to the compiled ISchema.\n     */\n    public static async fetchAndBuild(url: string, targetDefinition?: string): Promise<ISchema> {\n        try {\n            const response = await fetch(url);\n            if (!response.ok) {\n                throw new Error(`HTTP error! status: ${response.status}`);\n            }\n            const swaggerRoot = await response.json();\n            return this.build(swaggerRoot, targetDefinition);\n        } catch (error) {\n            const msg = \"Failed to fetch Swagger JSON from URL: \" + (error as Error).message;\n            Logger.error(\"[MetaUI SwaggerBuilder]\", msg);\n            throw new Error(msg);\n        }\n    }\n\n    /**\n     * Synchronously builds a MetaUI ISchema from a provided OpenAPI root document.\n     * Automatically extracts the requested definition from `components.schemas` or falls back to the first available.\n     * \n     * @param {any} swaggerRoot The OpenAPI root document.\n     * @param {string} [targetDefinition] Optional. The specific entity schema to extract.\n     * @returns {ISchema} The translated MetaUI schema.\n     */\n    public static build(swaggerRoot: any, targetDefinition?: string): ISchema {\n        if (!swaggerRoot || typeof swaggerRoot !== \"object\") {\n            throw new Error(\"[MetaUI SwaggerBuilder] Invalid Swagger root object provided.\");\n        }\n\n        let targetObject = swaggerRoot;\n\n        if (!targetDefinition) {\n            if (swaggerRoot.components && swaggerRoot.components.schemas) {\n                const keys = Object.keys(swaggerRoot.components.schemas);\n                if (keys.length > 0) targetDefinition = keys[0];\n            } else if (swaggerRoot.definitions) {\n                const keys = Object.keys(swaggerRoot.definitions);\n                if (keys.length > 0) targetDefinition = keys[0];\n            }\n        }\n\n        if (targetDefinition) {\n            let found = false;\n            if (swaggerRoot.components && swaggerRoot.components.schemas && swaggerRoot.components.schemas[targetDefinition]) {\n                targetObject = swaggerRoot.components.schemas[targetDefinition];\n                found = true;\n            } else if (swaggerRoot.definitions && swaggerRoot.definitions[targetDefinition]) {\n                targetObject = swaggerRoot.definitions[targetDefinition];\n                found = true;\n            }\n\n            if (!found) {\n                throw new Error(`[MetaUI SwaggerBuilder] Could not find target definition '${targetDefinition}' in components/schemas or definitions.`);\n            }\n        }\n\n        const schema: ISchema = {\n            title: targetObject.title || swaggerRoot.info?.title || targetDefinition,\n            type: targetObject.type === \"array\" ? \"array\" : \"object\",\n            layoutStrategy: targetObject.type === \"array\" ? \"table\" : \"form\"\n        };\n\n        if (targetObject.additionalProperties === true) {\n            schema.additionalProperties = true;\n        }\n\n        if (schema.type === \"object\") {\n            const requiredKeys = Array.isArray(targetObject.required) ? targetObject.required : [];\n            schema.properties = this.mapProperties(targetObject.properties || {}, requiredKeys, swaggerRoot);\n        } else if (schema.type === \"array\" && targetObject.items) {\n            schema.items = this.mapPropertyMetadata(targetObject.items, \"items\", false, swaggerRoot);\n        }\n\n        return schema;\n    }\n\n    /**\n     * Recursively traverses and translates an OpenAPI properties block into MetaUI IPropertyMetadata.\n     * \n     * @param {Record<string, any>} properties The OpenAPI properties object.\n     * @param {string[]} requiredKeys An array of keys marked as required in the parent schema.\n     * @param {any} swaggerRoot The root document (used for $ref resolution).\n     * @returns {Record<string, IPropertyMetadata>} The mapped MetaUI properties object.\n     */\n    private static mapProperties(properties: Record<string, any>, requiredKeys: string[], swaggerRoot: any): Record<string, IPropertyMetadata> {\n        const normalizedProps: Record<string, IPropertyMetadata> = {};\n        \n        for (const key of Object.keys(properties)) {\n            const isRequired = requiredKeys.includes(key);\n            let propDef = properties[key];\n\n            if (propDef.$ref) {\n                const resolved = SwaggerRefResolver.resolve(propDef.$ref, swaggerRoot);\n                if (resolved) {\n                    propDef = { ...resolved, ...propDef };\n                }\n            }\n\n            normalizedProps[key] = this.mapPropertyMetadata(propDef, key, isRequired, swaggerRoot);\n        }\n        \n        return normalizedProps;\n    }\n\n    /**\n     * Translates a single OpenAPI property schema into a MetaUI IPropertyMetadata block.\n     * Handles local $ref resolution, allOf merging, type mapping, and UI directive injection.\n     * \n     * @param {any} swaggerProp The OpenAPI property definition.\n     * @param {string} keyName The technical key of the property.\n     * @param {boolean} isRequired Whether this property is strictly required.\n     * @param {any} swaggerRoot The root document (used for $ref resolution).\n     * @returns {IPropertyMetadata} The compiled MetaUI property metadata.\n     */\n    private static mapPropertyMetadata(swaggerProp: any, keyName: string, isRequired: boolean, swaggerRoot: any): IPropertyMetadata {\n        let currentProp = swaggerProp;\n\n        if (currentProp.$ref) {\n            const resolved = SwaggerRefResolver.resolve(currentProp.$ref, swaggerRoot);\n            if (resolved) {\n                currentProp = { ...resolved, ...currentProp };\n            }\n        }\n\n        if (Array.isArray(currentProp.allOf)) {\n            let merged = { ...currentProp };\n            delete merged.allOf;\n            for (const subSchema of currentProp.allOf) {\n                let resolvedSub = subSchema;\n                if (subSchema.$ref) {\n                    resolvedSub = SwaggerRefResolver.resolve(subSchema.$ref, swaggerRoot) || {};\n                }\n                merged = { ...merged, ...resolvedSub };\n            }\n            currentProp = merged;\n        }\n\n        const type = SwaggerTypeMapper.mapType(currentProp.type);\n\n        const metaProp: IPropertyMetadata = {\n            type: type,\n            required: isRequired\n        };\n\n        const uiDirective = SwaggerUIMapper.build(currentProp, keyName);\n        if (Object.keys(uiDirective).length > 0) {\n            metaProp.ui = uiDirective;\n        }\n\n        if (typeof currentProp.maxLength === \"number\") metaProp.maxLength = currentProp.maxLength;\n        if (typeof currentProp.minLength === \"number\") metaProp.minLength = currentProp.minLength;\n        if (typeof currentProp.maximum === \"number\") metaProp.maximum = currentProp.maximum;\n        if (typeof currentProp.minimum === \"number\") metaProp.minimum = currentProp.minimum;\n        if (typeof currentProp.pattern === \"string\") metaProp.pattern = currentProp.pattern;\n\n        if (typeof currentProp.multipleOf === \"number\") metaProp.multipleOf = currentProp.multipleOf;\n        \n        if (currentProp.default !== undefined) metaProp.default = currentProp.default;\n        if (typeof currentProp.nullable === \"boolean\") metaProp.nullable = currentProp.nullable;\n        if (typeof currentProp.writeOnly === \"boolean\") metaProp.writeOnly = currentProp.writeOnly;\n        if (currentProp.example !== undefined) metaProp.example = currentProp.example;\n        if (typeof currentProp.deprecated === \"boolean\") metaProp.deprecated = currentProp.deprecated;\n        if (currentProp.exclusiveMinimum !== undefined) metaProp.exclusiveMinimum = currentProp.exclusiveMinimum;\n        if (currentProp.exclusiveMaximum !== undefined) metaProp.exclusiveMaximum = currentProp.exclusiveMaximum;\n\n        if (Array.isArray(currentProp.enum)) {\n            metaProp.enum = currentProp.enum;\n            if (!metaProp.ui) metaProp.ui = {};\n            if (!metaProp.ui.widget) {\n                if (type === \"array\") {\n                    metaProp.ui.widget = \"multiSelect\";\n                } else {\n                    metaProp.ui.widget = \"select\";\n                }\n            }\n        }\n\n        if (type === \"object\") {\n            if (currentProp.properties) {\n                const childRequired = Array.isArray(currentProp.required) ? currentProp.required : [];\n                metaProp.properties = this.mapProperties(currentProp.properties, childRequired, swaggerRoot);\n            }\n            if (currentProp.additionalProperties === true) {\n                metaProp.additionalProperties = true;\n            }\n        } else if (type === \"array\" && currentProp.items) {\n            metaProp.items = this.mapPropertyMetadata(currentProp.items, \"items\", false, swaggerRoot);\n        }\n\n        return metaProp;\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/swagger/SwaggerBuilder.d.ts

@@ -1,63 +0,0 @@
-declare module "nz/co/siliconst/ui5/metaui/swagger/SwaggerBuilder" {
-    /**
-     * @file SwaggerBuilder.ts
-     * @description Facade orchestration for translating Swagger/OpenAPI JSON into native MetaUI ISchema.
-     * Strict Single Responsibility architecture delegates mapping logic to dedicated utilities.
-     */
-    import { ISchema } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
-    import { ISchemaBuilderPlugin } from "nz/co/siliconst/ui5/metaui/interfaces/ISchemaBuilderPlugin";
-    export class SwaggerBuilder implements ISchemaBuilderPlugin {
-        /**
-         * Determines if the provided JSON payload is a Swagger or OpenAPI document.
-         *
-         * @param {any} rawSchema The raw JSON schema to test.
-         * @returns {boolean} True if the document contains 'openapi' or 'swagger' root keys.
-         */
-        canHandle(rawSchema: any): boolean;
-        /**
-         * Builds a strict MetaUI ISchema from the provided OpenAPI payload.
-         *
-         * @param {any} rawSchema The OpenAPI root document.
-         * @returns {ISchema} The translated MetaUI schema.
-         */
-        build(rawSchema: any): ISchema;
-        /**
-         * Asynchronously fetches a remote OpenAPI document and compiles it into a MetaUI ISchema.
-         *
-         * @param {string} url The URL to fetch the JSON payload from.
-         * @param {string} [targetDefinition] Optional. The specific entity schema to extract.
-         * @returns {Promise<ISchema>} A Promise resolving to the compiled ISchema.
-         */
-        static fetchAndBuild(url: string, targetDefinition?: string): Promise<ISchema>;
-        /**
-         * Synchronously builds a MetaUI ISchema from a provided OpenAPI root document.
-         * Automatically extracts the requested definition from `components.schemas` or falls back to the first available.
-         *
-         * @param {any} swaggerRoot The OpenAPI root document.
-         * @param {string} [targetDefinition] Optional. The specific entity schema to extract.
-         * @returns {ISchema} The translated MetaUI schema.
-         */
-        static build(swaggerRoot: any, targetDefinition?: string): ISchema;
-        /**
-         * Recursively traverses and translates an OpenAPI properties block into MetaUI IPropertyMetadata.
-         *
-         * @param {Record<string, any>} properties The OpenAPI properties object.
-         * @param {string[]} requiredKeys An array of keys marked as required in the parent schema.
-         * @param {any} swaggerRoot The root document (used for $ref resolution).
-         * @returns {Record<string, IPropertyMetadata>} The mapped MetaUI properties object.
-         */
-        private static mapProperties;
-        /**
-         * Translates a single OpenAPI property schema into a MetaUI IPropertyMetadata block.
-         * Handles local $ref resolution, allOf merging, type mapping, and UI directive injection.
-         *
-         * @param {any} swaggerProp The OpenAPI property definition.
-         * @param {string} keyName The technical key of the property.
-         * @param {boolean} isRequired Whether this property is strictly required.
-         * @param {any} swaggerRoot The root document (used for $ref resolution).
-         * @returns {IPropertyMetadata} The compiled MetaUI property metadata.
-         */
-        private static mapPropertyMetadata;
-    }
-}
-//# sourceMappingURL=SwaggerBuilder.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/swagger/SwaggerBuilder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SwaggerBuilder.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/swagger/SwaggerBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,mDAAmD,CAAC;IACnE;;;;OAIG;IAEH,OAAO,EAAE,OAAO,EAAqB,MAAM,+CAA+C,CAAC;IAC3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,4DAA4D,CAAC;IAMlG,MAAa,cAAe,YAAW,oBAAoB;QAEvD;;;;;WAKG;QACI,SAAS,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO;QAIzC;;;;;WAKG;QACI,KAAK,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO;QAIrC;;;;;;WAMG;eACiB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;QAe3F;;;;;;;WAOG;eACW,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO;QAoDzE;;;;;;;WAOG;QACH,OAAO,CAAC,MAAM,CAAC,aAAa;QAoB5B;;;;;;;;;WASG;QACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;KA6ErC;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/swagger/SwaggerBuilder.js

@@ -1,2 +0,0 @@
-sap.ui.define(["../utils/Logger","./SwaggerTypeMapper","./SwaggerUIMapper","./SwaggerRefResolver"],function(e,t,i,r){"use strict";const a=e["Logger"];const n=t["SwaggerTypeMapper"];const s=i["SwaggerUIMapper"];const o=r["SwaggerRefResolver"];class f{canHandle(e){return!!(e&&(e.openapi||e.swagger))}build(e){return f.build(e)}static async fetchAndBuild(e,t){try{const i=await fetch(e);if(!i.ok){throw new Error(`HTTP error! status: ${i.status}`)}const r=await i.json();return this.build(r,t)}catch(e){const t="Failed to fetch Swagger JSON from URL: "+e.message;a.error("[MetaUI SwaggerBuilder]",t);throw new Error(t)}}static build(e,t){if(!e||typeof e!=="object"){throw new Error("[MetaUI SwaggerBuilder] Invalid Swagger root object provided.")}let i=e;if(!t){if(e.components&&e.components.schemas){const i=Object.keys(e.components.schemas);if(i.length>0)t=i[0]}else if(e.definitions){const i=Object.keys(e.definitions);if(i.length>0)t=i[0]}}if(t){let r=false;if(e.components&&e.components.schemas&&e.components.schemas[t]){i=e.components.schemas[t];r=true}else if(e.definitions&&e.definitions[t]){i=e.definitions[t];r=true}if(!r){throw new Error(`[MetaUI SwaggerBuilder] Could not find target definition '${t}' in components/schemas or definitions.`)}}const r={title:i.title||e.info?.title||t,type:i.type==="array"?"array":"object",layoutStrategy:i.type==="array"?"table":"form"};if(i.additionalProperties===true){r.additionalProperties=true}if(r.type==="object"){const t=Array.isArray(i.required)?i.required:[];r.properties=this.mapProperties(i.properties||{},t,e)}else if(r.type==="array"&&i.items){r.items=this.mapPropertyMetadata(i.items,"items",false,e)}return r}static mapProperties(e,t,i){const r={};for(const a of Object.keys(e)){const n=t.includes(a);let s=e[a];if(s.$ref){const e=o.resolve(s.$ref,i);if(e){s={...e,...s}}}r[a]=this.mapPropertyMetadata(s,a,n,i)}return r}static mapPropertyMetadata(e,t,i,r){let a=e;if(a.$ref){const e=o.resolve(a.$ref,r);if(e){a={...e,...a}}}if(Array.isArray(a.allOf)){let e={...a};delete e.allOf;for(const t of a.allOf){let i=t;if(t.$ref){i=o.resolve(t.$ref,r)||{}}e={...e,...i}}a=e}const f=n.mapType(a.type);const l={type:f,required:i};const u=s.build(a,t);if(Object.keys(u).length>0){l.ui=u}if(typeof a.maxLength==="number")l.maxLength=a.maxLength;if(typeof a.minLength==="number")l.minLength=a.minLength;if(typeof a.maximum==="number")l.maximum=a.maximum;if(typeof a.minimum==="number")l.minimum=a.minimum;if(typeof a.pattern==="string")l.pattern=a.pattern;if(typeof a.multipleOf==="number")l.multipleOf=a.multipleOf;if(a.default!==undefined)l.default=a.default;if(typeof a.nullable==="boolean")l.nullable=a.nullable;if(typeof a.writeOnly==="boolean")l.writeOnly=a.writeOnly;if(a.example!==undefined)l.example=a.example;if(typeof a.deprecated==="boolean")l.deprecated=a.deprecated;if(a.exclusiveMinimum!==undefined)l.exclusiveMinimum=a.exclusiveMinimum;if(a.exclusiveMaximum!==undefined)l.exclusiveMaximum=a.exclusiveMaximum;if(Array.isArray(a.enum)){l.enum=a.enum;if(!l.ui)l.ui={};if(!l.ui.widget){if(f==="array"){l.ui.widget="multiSelect"}else{l.ui.widget="select"}}}if(f==="object"){if(a.properties){const e=Array.isArray(a.required)?a.required:[];l.properties=this.mapProperties(a.properties,e,r)}if(a.additionalProperties===true){l.additionalProperties=true}}else if(f==="array"&&a.items){l.items=this.mapPropertyMetadata(a.items,"items",false,r)}return l}}var l={__esModule:true};l.SwaggerBuilder=f;return l});
-//# sourceMappingURL=SwaggerBuilder.js.map

package/src/nz/co/siliconst/ui5/metaui/swagger/SwaggerBuilder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SwaggerBuilder.js","names":["Logger","___utils_Logger","SwaggerTypeMapper","___SwaggerTypeMapper","SwaggerUIMapper","___SwaggerUIMapper","SwaggerRefResolver","___SwaggerRefResolver","SwaggerBuilder","canHandle","rawSchema","openapi","swagger","build","fetchAndBuild","url","targetDefinition","response","fetch","ok","Error","status","swaggerRoot","json","this","error","msg","message","targetObject","components","schemas","keys","Object","length","definitions","found","schema","title","info","type","layoutStrategy","additionalProperties","requiredKeys","Array","isArray","required","properties","mapProperties","items","mapPropertyMetadata","normalizedProps","key","isRequired","includes","propDef","$ref","resolved","resolve","swaggerProp","keyName","currentProp","allOf","merged","subSchema","resolvedSub","mapType","metaProp","uiDirective","ui","maxLength","minLength","maximum","minimum","pattern","multipleOf","default","undefined","nullable","writeOnly","example","deprecated","exclusiveMinimum","exclusiveMaximum","enum","widget","childRequired","__exports","__esModule"],"sources":["SwaggerBuilder.ts"],"sourcesContent":["/**\n * @file SwaggerBuilder.ts\n * @description Facade orchestration for translating Swagger/OpenAPI JSON into native MetaUI ISchema.\n * Strict Single Responsibility architecture delegates mapping logic to dedicated utilities.\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { ISchemaBuilderPlugin } from \"../interfaces/ISchemaBuilderPlugin\";\nimport { Logger } from \"../utils/Logger\";\nimport { SwaggerTypeMapper } from \"./SwaggerTypeMapper\";\nimport { SwaggerUIMapper } from \"./SwaggerUIMapper\";\nimport { SwaggerRefResolver } from \"./SwaggerRefResolver\";\n\nexport class SwaggerBuilder implements ISchemaBuilderPlugin {\n\n    /**\n     * Determines if the provided JSON payload is a Swagger or OpenAPI document.\n     * \n     * @param {any} rawSchema The raw JSON schema to test.\n     * @returns {boolean} True if the document contains 'openapi' or 'swagger' root keys.\n     */\n    public canHandle(rawSchema: any): boolean {\n        return !!(rawSchema && (rawSchema.openapi || rawSchema.swagger));\n    }\n\n    /**\n     * Builds a strict MetaUI ISchema from the provided OpenAPI payload.\n     * \n     * @param {any} rawSchema The OpenAPI root document.\n     * @returns {ISchema} The translated MetaUI schema.\n     */\n    public build(rawSchema: any): ISchema {\n        return SwaggerBuilder.build(rawSchema);\n    }\n\n    /**\n     * Asynchronously fetches a remote OpenAPI document and compiles it into a MetaUI ISchema.\n     * \n     * @param {string} url The URL to fetch the JSON payload from.\n     * @param {string} [targetDefinition] Optional. The specific entity schema to extract.\n     * @returns {Promise<ISchema>} A Promise resolving to the compiled ISchema.\n     */\n    public static async fetchAndBuild(url: string, targetDefinition?: string): Promise<ISchema> {\n        try {\n            const response = await fetch(url);\n            if (!response.ok) {\n                throw new Error(`HTTP error! status: ${response.status}`);\n            }\n            const swaggerRoot = await response.json();\n            return this.build(swaggerRoot, targetDefinition);\n        } catch (error) {\n            const msg = \"Failed to fetch Swagger JSON from URL: \" + (error as Error).message;\n            Logger.error(\"[MetaUI SwaggerBuilder]\", msg);\n            throw new Error(msg);\n        }\n    }\n\n    /**\n     * Synchronously builds a MetaUI ISchema from a provided OpenAPI root document.\n     * Automatically extracts the requested definition from `components.schemas` or falls back to the first available.\n     * \n     * @param {any} swaggerRoot The OpenAPI root document.\n     * @param {string} [targetDefinition] Optional. The specific entity schema to extract.\n     * @returns {ISchema} The translated MetaUI schema.\n     */\n    public static build(swaggerRoot: any, targetDefinition?: string): ISchema {\n        if (!swaggerRoot || typeof swaggerRoot !== \"object\") {\n            throw new Error(\"[MetaUI SwaggerBuilder] Invalid Swagger root object provided.\");\n        }\n\n        let targetObject = swaggerRoot;\n\n        if (!targetDefinition) {\n            if (swaggerRoot.components && swaggerRoot.components.schemas) {\n                const keys = Object.keys(swaggerRoot.components.schemas);\n                if (keys.length > 0) targetDefinition = keys[0];\n            } else if (swaggerRoot.definitions) {\n                const keys = Object.keys(swaggerRoot.definitions);\n                if (keys.length > 0) targetDefinition = keys[0];\n            }\n        }\n\n        if (targetDefinition) {\n            let found = false;\n            if (swaggerRoot.components && swaggerRoot.components.schemas && swaggerRoot.components.schemas[targetDefinition]) {\n                targetObject = swaggerRoot.components.schemas[targetDefinition];\n                found = true;\n            } else if (swaggerRoot.definitions && swaggerRoot.definitions[targetDefinition]) {\n                targetObject = swaggerRoot.definitions[targetDefinition];\n                found = true;\n            }\n\n            if (!found) {\n                throw new Error(`[MetaUI SwaggerBuilder] Could not find target definition '${targetDefinition}' in components/schemas or definitions.`);\n            }\n        }\n\n        const schema: ISchema = {\n            title: targetObject.title || swaggerRoot.info?.title || targetDefinition,\n            type: targetObject.type === \"array\" ? \"array\" : \"object\",\n            layoutStrategy: targetObject.type === \"array\" ? \"table\" : \"form\"\n        };\n\n        if (targetObject.additionalProperties === true) {\n            schema.additionalProperties = true;\n        }\n\n        if (schema.type === \"object\") {\n            const requiredKeys = Array.isArray(targetObject.required) ? targetObject.required : [];\n            schema.properties = this.mapProperties(targetObject.properties || {}, requiredKeys, swaggerRoot);\n        } else if (schema.type === \"array\" && targetObject.items) {\n            schema.items = this.mapPropertyMetadata(targetObject.items, \"items\", false, swaggerRoot);\n        }\n\n        return schema;\n    }\n\n    /**\n     * Recursively traverses and translates an OpenAPI properties block into MetaUI IPropertyMetadata.\n     * \n     * @param {Record<string, any>} properties The OpenAPI properties object.\n     * @param {string[]} requiredKeys An array of keys marked as required in the parent schema.\n     * @param {any} swaggerRoot The root document (used for $ref resolution).\n     * @returns {Record<string, IPropertyMetadata>} The mapped MetaUI properties object.\n     */\n    private static mapProperties(properties: Record<string, any>, requiredKeys: string[], swaggerRoot: any): Record<string, IPropertyMetadata> {\n        const normalizedProps: Record<string, IPropertyMetadata> = {};\n        \n        for (const key of Object.keys(properties)) {\n            const isRequired = requiredKeys.includes(key);\n            let propDef = properties[key];\n\n            if (propDef.$ref) {\n                const resolved = SwaggerRefResolver.resolve(propDef.$ref, swaggerRoot);\n                if (resolved) {\n                    propDef = { ...resolved, ...propDef };\n                }\n            }\n\n            normalizedProps[key] = this.mapPropertyMetadata(propDef, key, isRequired, swaggerRoot);\n        }\n        \n        return normalizedProps;\n    }\n\n    /**\n     * Translates a single OpenAPI property schema into a MetaUI IPropertyMetadata block.\n     * Handles local $ref resolution, allOf merging, type mapping, and UI directive injection.\n     * \n     * @param {any} swaggerProp The OpenAPI property definition.\n     * @param {string} keyName The technical key of the property.\n     * @param {boolean} isRequired Whether this property is strictly required.\n     * @param {any} swaggerRoot The root document (used for $ref resolution).\n     * @returns {IPropertyMetadata} The compiled MetaUI property metadata.\n     */\n    private static mapPropertyMetadata(swaggerProp: any, keyName: string, isRequired: boolean, swaggerRoot: any): IPropertyMetadata {\n        let currentProp = swaggerProp;\n\n        if (currentProp.$ref) {\n            const resolved = SwaggerRefResolver.resolve(currentProp.$ref, swaggerRoot);\n            if (resolved) {\n                currentProp = { ...resolved, ...currentProp };\n            }\n        }\n\n        if (Array.isArray(currentProp.allOf)) {\n            let merged = { ...currentProp };\n            delete merged.allOf;\n            for (const subSchema of currentProp.allOf) {\n                let resolvedSub = subSchema;\n                if (subSchema.$ref) {\n                    resolvedSub = SwaggerRefResolver.resolve(subSchema.$ref, swaggerRoot) || {};\n                }\n                merged = { ...merged, ...resolvedSub };\n            }\n            currentProp = merged;\n        }\n\n        const type = SwaggerTypeMapper.mapType(currentProp.type);\n\n        const metaProp: IPropertyMetadata = {\n            type: type,\n            required: isRequired\n        };\n\n        const uiDirective = SwaggerUIMapper.build(currentProp, keyName);\n        if (Object.keys(uiDirective).length > 0) {\n            metaProp.ui = uiDirective;\n        }\n\n        if (typeof currentProp.maxLength === \"number\") metaProp.maxLength = currentProp.maxLength;\n        if (typeof currentProp.minLength === \"number\") metaProp.minLength = currentProp.minLength;\n        if (typeof currentProp.maximum === \"number\") metaProp.maximum = currentProp.maximum;\n        if (typeof currentProp.minimum === \"number\") metaProp.minimum = currentProp.minimum;\n        if (typeof currentProp.pattern === \"string\") metaProp.pattern = currentProp.pattern;\n\n        if (typeof currentProp.multipleOf === \"number\") metaProp.multipleOf = currentProp.multipleOf;\n        \n        if (currentProp.default !== undefined) metaProp.default = currentProp.default;\n        if (typeof currentProp.nullable === \"boolean\") metaProp.nullable = currentProp.nullable;\n        if (typeof currentProp.writeOnly === \"boolean\") metaProp.writeOnly = currentProp.writeOnly;\n        if (currentProp.example !== undefined) metaProp.example = currentProp.example;\n        if (typeof currentProp.deprecated === \"boolean\") metaProp.deprecated = currentProp.deprecated;\n        if (currentProp.exclusiveMinimum !== undefined) metaProp.exclusiveMinimum = currentProp.exclusiveMinimum;\n        if (currentProp.exclusiveMaximum !== undefined) metaProp.exclusiveMaximum = currentProp.exclusiveMaximum;\n\n        if (Array.isArray(currentProp.enum)) {\n            metaProp.enum = currentProp.enum;\n            if (!metaProp.ui) metaProp.ui = {};\n            if (!metaProp.ui.widget) {\n                if (type === \"array\") {\n                    metaProp.ui.widget = \"multiSelect\";\n                } else {\n                    metaProp.ui.widget = \"select\";\n                }\n            }\n        }\n\n        if (type === \"object\") {\n            if (currentProp.properties) {\n                const childRequired = Array.isArray(currentProp.required) ? currentProp.required : [];\n                metaProp.properties = this.mapProperties(currentProp.properties, childRequired, swaggerRoot);\n            }\n            if (currentProp.additionalProperties === true) {\n                metaProp.additionalProperties = true;\n            }\n        } else if (type === \"array\" && currentProp.items) {\n            metaProp.items = this.mapPropertyMetadata(currentProp.items, \"items\", false, swaggerRoot);\n        }\n\n        return metaProp;\n    }\n}\n"],"mappings":"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","ignoreList":[]}