@siliconst/metaui 1.4.13 → 1.4.17

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

@@ -0,0 +1,226 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,63 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,2 @@
+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

@@ -0,0 +1 @@
+{"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":[]}

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

@@ -0,0 +1,233 @@
+/**
+ * @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, IPropertyMetadata } from "../interfaces/ISchema";
+import { ISchemaBuilderPlugin } from "../interfaces/ISchemaBuilderPlugin";
+import { Logger } from "../utils/Logger";
+import { SwaggerTypeMapper } from "./SwaggerTypeMapper";
+import { SwaggerUIMapper } from "./SwaggerUIMapper";
+import { SwaggerRefResolver } from "./SwaggerRefResolver";
+
+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.
+     */
+    public canHandle(rawSchema: any): boolean {
+        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.
+     */
+    public build(rawSchema: any): ISchema {
+        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.
+     */
+    public static async fetchAndBuild(url: string, targetDefinition?: string): Promise<ISchema> {
+        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 as 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.
+     */
+    public static build(swaggerRoot: any, targetDefinition?: string): ISchema {
+        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: ISchema = {
+            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.
+     */
+    private static mapProperties(properties: Record<string, any>, requiredKeys: string[], swaggerRoot: any): Record<string, IPropertyMetadata> {
+        const normalizedProps: Record<string, IPropertyMetadata> = {};
+        
+        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.
+     */
+    private static mapPropertyMetadata(swaggerProp: any, keyName: string, isRequired: boolean, swaggerRoot: any): IPropertyMetadata {
+        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: IPropertyMetadata = {
+            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;
+    }
+}