@siliconst/metaui 1.4.17 → 1.4.21

package/src/nz/co/siliconst/ui5/metaui/library.d.ts

@@ -13,6 +13,10 @@ declare module "nz/co/siliconst/ui5/metaui/library" {
     import "nz/co/siliconst/ui5/metaui/layouts/TableLayout";
     import "nz/co/siliconst/ui5/metaui/layouts/WizardLayout";
     import "nz/co/siliconst/ui5/metaui/layouts/CompactLayout";
+    import "nz/co/siliconst/ui5/metaui/ai/BaseAIGenerator";
+    import "nz/co/siliconst/ui5/metaui/ai/MockLLMProxy";
+    import "nz/co/siliconst/ui5/metaui/ai/RestLLMProxy";
+    import "nz/co/siliconst/ui5/metaui/ai/AIConfig";
     global {
         interface Window {
             nz: {

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

@@ -1 +1 @@
-{"version":3,"file":"library.d.ts","sourceRoot":"../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/library.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,oCAAoC,CAAC;IAUpD,OAAO,0DAA0D,CAAC;IAClE,OAAO,0DAA0D,CAAC;IAClE,OAAO,2DAA2D,CAAC;IACnE,OAAO,0DAA0D,CAAC;IAClE,OAAO,yDAAyD,CAAC;IACjE,OAAO,4DAA4D,CAAC;IACpE,OAAO,8DAA8D,CAAC;IACtE,OAAO,wDAAwD,CAAC;IAChE,OAAO,wDAAwD,CAAC;IAChE,OAAO,oDAAoD,CAAC;IAG5D,OAAO,+CAA+C,CAAC;IACvD,OAAO,gDAAgD,CAAC;IACxD,OAAO,iDAAiD,CAAC;IACzD,OAAO,kDAAkD,CAAC;IA6BlD,MAAM,CAAC;QACX,UAAU,MAAM;YACZ,EAAE,EAAE;gBACA,EAAE,EAAE;oBACA,SAAS,EAAE;wBACP,GAAG,EAAE;4BACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;yBACnC,CAAC;qBACL,CAAC;iBACL,CAAC;aACL,CAAC;SACL;KACJ;;IAED,wBAAiD;CAEhD"}
+{"version":3,"file":"library.d.ts","sourceRoot":"../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/library.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,oCAAoC,CAAC;IAUpD,OAAO,0DAA0D,CAAC;IAClE,OAAO,0DAA0D,CAAC;IAClE,OAAO,2DAA2D,CAAC;IACnE,OAAO,0DAA0D,CAAC;IAClE,OAAO,yDAAyD,CAAC;IACjE,OAAO,4DAA4D,CAAC;IACpE,OAAO,8DAA8D,CAAC;IACtE,OAAO,wDAAwD,CAAC;IAChE,OAAO,wDAAwD,CAAC;IAChE,OAAO,oDAAoD,CAAC;IAG5D,OAAO,+CAA+C,CAAC;IACvD,OAAO,gDAAgD,CAAC;IACxD,OAAO,iDAAiD,CAAC;IACzD,OAAO,kDAAkD,CAAC;IAG1D,OAAO,+CAA+C,CAAC;IACvD,OAAO,4CAA4C,CAAC;IACpD,OAAO,4CAA4C,CAAC;IACpD,OAAO,wCAAwC,CAAC;IA6BxC,MAAM,CAAC;QACX,UAAU,MAAM;YACZ,EAAE,EAAE;gBACA,EAAE,EAAE;oBACA,SAAS,EAAE;wBACP,GAAG,EAAE;4BACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;yBACnC,CAAC;qBACL,CAAC;iBACL,CAAC;aACL,CAAC;SACL;KACJ;;IAED,wBAAiD;CAEhD"}

package/src/nz/co/siliconst/ui5/metaui/library.js

@@ -1,2 +1,2 @@
-sap.ui.define(["sap/ui/core/Core","nz/co/siliconst/ui5/metaui/plugins/controls/StringPlugin","nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin","nz/co/siliconst/ui5/metaui/plugins/controls/BooleanPlugin","nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin","nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin","nz/co/siliconst/ui5/metaui/plugins/controls/DropdownPlugin","nz/co/siliconst/ui5/metaui/plugins/controls/MultiInputPlugin","nz/co/siliconst/ui5/metaui/plugins/controls/DatePlugin","nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator","nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder","nz/co/siliconst/ui5/metaui/layouts/FormLayout","nz/co/siliconst/ui5/metaui/layouts/TableLayout","nz/co/siliconst/ui5/metaui/layouts/WizardLayout","nz/co/siliconst/ui5/metaui/layouts/CompactLayout"],function(i,o,n,t,s,u,c,l,e,a,r,m,z,p,g){"use strict";i.initLibrary({name:"nz.co.siliconst.ui5.metaui",version:"1.0.0",dependencies:["sap.ui.core","sap.m","sap.ui.layout","sap.ui.table"],controls:["nz.co.siliconst.ui5.metaui.controls.DynamicHost","nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost","nz.co.siliconst.ui5.metaui.controls.BaseHardwareControl","nz.co.siliconst.ui5.metaui.controls.CameraControl","nz.co.siliconst.ui5.metaui.controls.BarcodeScannerControl","nz.co.siliconst.ui5.metaui.controls.SignatureControl","nz.co.siliconst.ui5.metaui.controls.VoiceInputControl","nz.co.siliconst.ui5.metaui.controls.GeolocationControl","nz.co.siliconst.ui5.metaui.controls.RichTextControl"],elements:[],interfaces:[],noLibraryCSS:true});var y=window.nz.co.siliconst.ui5.metaui;return y});
+sap.ui.define(["sap/ui/core/Core","nz/co/siliconst/ui5/metaui/plugins/controls/StringPlugin","nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin","nz/co/siliconst/ui5/metaui/plugins/controls/BooleanPlugin","nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin","nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin","nz/co/siliconst/ui5/metaui/plugins/controls/DropdownPlugin","nz/co/siliconst/ui5/metaui/plugins/controls/MultiInputPlugin","nz/co/siliconst/ui5/metaui/plugins/controls/DatePlugin","nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator","nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder","nz/co/siliconst/ui5/metaui/layouts/FormLayout","nz/co/siliconst/ui5/metaui/layouts/TableLayout","nz/co/siliconst/ui5/metaui/layouts/WizardLayout","nz/co/siliconst/ui5/metaui/layouts/CompactLayout","nz/co/siliconst/ui5/metaui/ai/BaseAIGenerator","nz/co/siliconst/ui5/metaui/ai/MockLLMProxy","nz/co/siliconst/ui5/metaui/ai/RestLLMProxy","nz/co/siliconst/ui5/metaui/ai/AIConfig"],function(i,o,n,t,s,u,c,l,a,e,r,m,z,p,g,y,C,L,P){"use strict";i.initLibrary({name:"nz.co.siliconst.ui5.metaui",version:"1.0.0",dependencies:["sap.ui.core","sap.m","sap.ui.layout","sap.ui.table"],controls:["nz.co.siliconst.ui5.metaui.controls.DynamicHost","nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost","nz.co.siliconst.ui5.metaui.controls.BaseHardwareControl","nz.co.siliconst.ui5.metaui.controls.CameraControl","nz.co.siliconst.ui5.metaui.controls.BarcodeScannerControl","nz.co.siliconst.ui5.metaui.controls.SignatureControl","nz.co.siliconst.ui5.metaui.controls.VoiceInputControl","nz.co.siliconst.ui5.metaui.controls.GeolocationControl","nz.co.siliconst.ui5.metaui.controls.RichTextControl"],elements:[],interfaces:[],noLibraryCSS:true});var d=window.nz.co.siliconst.ui5.metaui;return d});
 //# sourceMappingURL=library.js.map

package/src/nz/co/siliconst/ui5/metaui/library.js.map

@@ -1 +1 @@
-{"version":3,"file":"library.js","names":["Core","initLibrary","name","version","dependencies","controls","elements","interfaces","noLibraryCSS","__exports","window","nz","co","siliconst","ui5","metaui"],"sources":["library.ts"],"sourcesContent":["/**\n * @file library.ts\n * @description Standard SAP UI5 library registration file. Exposes the MetaUI namespace \n * and automatically bootstraps the internal PluginRegistry.\n */\n\nimport Core from \"sap/ui/core/Core\";\n\n// Explicitly import core plugins to bundle them into library-preload.js\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/StringPlugin\";\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin\";\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/BooleanPlugin\";\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin\";\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin\";\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/DropdownPlugin\";\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/MultiInputPlugin\";\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/DatePlugin\";\nimport \"nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator\";\nimport \"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\";\n\n// Explicitly import core Layouts\nimport \"nz/co/siliconst/ui5/metaui/layouts/FormLayout\";\nimport \"nz/co/siliconst/ui5/metaui/layouts/TableLayout\";\nimport \"nz/co/siliconst/ui5/metaui/layouts/WizardLayout\";\nimport \"nz/co/siliconst/ui5/metaui/layouts/CompactLayout\";\n\n// Delegate to standard library registration\nCore.initLibrary({\n    name: \"nz.co.siliconst.ui5.metaui\",\n    version: \"1.0.0\",\n    dependencies: [\n        \"sap.ui.core\",\n        \"sap.m\",\n        \"sap.ui.layout\",\n        \"sap.ui.table\"\n    ],\n    controls: [\n        \"nz.co.siliconst.ui5.metaui.controls.DynamicHost\",\n        \"nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost\",\n        \"nz.co.siliconst.ui5.metaui.controls.BaseHardwareControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.CameraControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.BarcodeScannerControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.SignatureControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.VoiceInputControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.GeolocationControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.RichTextControl\"\n    ],\n    elements: [],\n    interfaces: [],\n    noLibraryCSS: true\n});\n\n// Exporting window object safely for UI5 compatibility if needed\ndeclare global {\n    interface Window {\n        nz: {\n            co: {\n                siliconst: {\n                    ui5: {\n                        metaui: Record<string, unknown>;\n                    };\n                };\n            };\n        };\n    }\n}\n\nexport default window.nz.co.siliconst.ui5.metaui;\n"],"mappings":"w2BA2BAA,EAAKC,YAAY,CACbC,KAAM,6BACNC,QAAS,QACTC,aAAc,CACV,cACA,QACA,gBACA,gBAEJC,SAAU,CACN,kDACA,yDACA,0DACA,oDACA,4DACA,uDACA,wDACA,yDACA,uDAEJC,SAAU,GACVC,WAAY,GACZC,aAAc,OAGlB,IAAAC,EAeeC,OAAOC,GAAGC,GAAGC,UAAUC,IAAIC,OAAM,OAAAN,CAAA","ignoreList":[]}
+{"version":3,"file":"library.js","names":["Core","initLibrary","name","version","dependencies","controls","elements","interfaces","noLibraryCSS","__exports","window","nz","co","siliconst","ui5","metaui"],"sources":["library.ts"],"sourcesContent":["/**\n * @file library.ts\n * @description Standard SAP UI5 library registration file. Exposes the MetaUI namespace \n * and automatically bootstraps the internal PluginRegistry.\n */\n\nimport Core from \"sap/ui/core/Core\";\n\n// Explicitly import core plugins to bundle them into library-preload.js\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/StringPlugin\";\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/NumberPlugin\";\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/BooleanPlugin\";\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/ObjectPlugin\";\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin\";\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/DropdownPlugin\";\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/MultiInputPlugin\";\nimport \"nz/co/siliconst/ui5/metaui/plugins/controls/DatePlugin\";\nimport \"nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator\";\nimport \"nz/co/siliconst/ui5/metaui/utils/ExpressionBuilder\";\n\n// Explicitly import core Layouts\nimport \"nz/co/siliconst/ui5/metaui/layouts/FormLayout\";\nimport \"nz/co/siliconst/ui5/metaui/layouts/TableLayout\";\nimport \"nz/co/siliconst/ui5/metaui/layouts/WizardLayout\";\nimport \"nz/co/siliconst/ui5/metaui/layouts/CompactLayout\";\n\n// AI Inference\nimport \"nz/co/siliconst/ui5/metaui/ai/BaseAIGenerator\";\nimport \"nz/co/siliconst/ui5/metaui/ai/MockLLMProxy\";\nimport \"nz/co/siliconst/ui5/metaui/ai/RestLLMProxy\";\nimport \"nz/co/siliconst/ui5/metaui/ai/AIConfig\";\n\n// Delegate to standard library registration\nCore.initLibrary({\n    name: \"nz.co.siliconst.ui5.metaui\",\n    version: \"1.0.0\",\n    dependencies: [\n        \"sap.ui.core\",\n        \"sap.m\",\n        \"sap.ui.layout\",\n        \"sap.ui.table\"\n    ],\n    controls: [\n        \"nz.co.siliconst.ui5.metaui.controls.DynamicHost\",\n        \"nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost\",\n        \"nz.co.siliconst.ui5.metaui.controls.BaseHardwareControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.CameraControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.BarcodeScannerControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.SignatureControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.VoiceInputControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.GeolocationControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.RichTextControl\"\n    ],\n    elements: [],\n    interfaces: [],\n    noLibraryCSS: true\n});\n\n// Exporting window object safely for UI5 compatibility if needed\ndeclare global {\n    interface Window {\n        nz: {\n            co: {\n                siliconst: {\n                    ui5: {\n                        metaui: Record<string, unknown>;\n                    };\n                };\n            };\n        };\n    }\n}\n\nexport default window.nz.co.siliconst.ui5.metaui;\n"],"mappings":"miCAiCAA,EAAKC,YAAY,CACbC,KAAM,6BACNC,QAAS,QACTC,aAAc,CACV,cACA,QACA,gBACA,gBAEJC,SAAU,CACN,kDACA,yDACA,0DACA,oDACA,4DACA,uDACA,wDACA,yDACA,uDAEJC,SAAU,GACVC,WAAY,GACZC,aAAc,OAGlB,IAAAC,EAeeC,OAAOC,GAAGC,GAAGC,UAAUC,IAAIC,OAAM,OAAAN,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/library.ts

@@ -24,6 +24,12 @@ import "nz/co/siliconst/ui5/metaui/layouts/TableLayout";
 import "nz/co/siliconst/ui5/metaui/layouts/WizardLayout";
 import "nz/co/siliconst/ui5/metaui/layouts/CompactLayout";
 
+// AI Inference
+import "nz/co/siliconst/ui5/metaui/ai/BaseAIGenerator";
+import "nz/co/siliconst/ui5/metaui/ai/MockLLMProxy";
+import "nz/co/siliconst/ui5/metaui/ai/RestLLMProxy";
+import "nz/co/siliconst/ui5/metaui/ai/AIConfig";
+
 // Delegate to standard library registration
 Core.initLibrary({
     name: "nz.co.siliconst.ui5.metaui",

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

@@ -0,0 +1,93 @@
+sap.ui.define(["../utils/Logger", "./OpenApiParserFactory", "./heuristics/OpenApiHeuristicEngine"], function (___utils_Logger, ___OpenApiParserFactory, ___heuristics_OpenApiHeuristicEngine) {
+  "use strict";
+
+  /**
+   * @file OpenApiBuilder.ts
+   * @description Facade orchestration for translating Swagger/OpenAPI JSON into native MetaUI ISchema.
+   * Strict Single Responsibility architecture delegates mapping logic to dedicated utilities and factories.
+   */
+  const Logger = ___utils_Logger["Logger"];
+  const OpenApiParserFactory = ___OpenApiParserFactory["OpenApiParserFactory"];
+  const OpenApiHeuristicEngine = ___heuristics_OpenApiHeuristicEngine["OpenApiHeuristicEngine"];
+  /**
+   * Facade orchestration for translating Swagger/OpenAPI JSON into native MetaUI ISchema.
+   * Strict Single Responsibility architecture delegates mapping logic to dedicated utilities and factories.
+   * 
+   * @public
+   */
+  class OpenApiBuilder {
+    /**
+     * Determines if the provided JSON payload is a Swagger or OpenAPI document.
+     * 
+     * @param {unknown} rawSchema The raw JSON schema to test.
+     * @returns {boolean} True if the document contains 'openapi' or 'swagger' root keys.
+     */
+    canHandle(rawSchema) {
+      const schema = rawSchema;
+      return !!(schema && (schema.openapi || schema.swagger));
+    }
+
+    /**
+     * Builds a strict MetaUI ISchema from the provided OpenAPI payload.
+     * 
+     * @param {unknown} rawSchema The OpenAPI root document.
+     * @param {string} [targetDefinition] Optional target root definition.
+     * @returns {ISchema} The translated MetaUI schema.
+     */
+    build(rawSchema, targetDefinition) {
+      return OpenApiBuilder.build(rawSchema, targetDefinition);
+    }
+
+    /**
+     * 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 openApiRoot = await response.json();
+        return this.build(openApiRoot, targetDefinition);
+      } catch (error) {
+        const msg = "Failed to fetch Swagger JSON from URL: " + error.message;
+        Logger.error("[MetaUI OpenApiBuilder]", msg);
+        throw new Error(msg);
+      }
+    }
+
+    /**
+     * Synchronously builds a MetaUI ISchema from a provided OpenAPI root document.
+     * Delegates to HeuristicEngine and OpenApiParserFactory.
+     * 
+     * @public
+     * @param {unknown} openApiRoot The raw OpenAPI root JSON document.
+     * @param {string} [targetDefinition] Optional target definition key to extract.
+     * @returns {ISchema} The synthesized MetaUI schema.
+     * @throws {Error} If the root object is invalid.
+     */
+    static build(openApiRoot, targetDefinition) {
+      if (!openApiRoot || typeof openApiRoot !== "object") {
+        throw new Error("[MetaUI OpenApiBuilder] Invalid Swagger root object provided.");
+      }
+
+      // 1. Run Heuristics to mutate AST (e.g., simulating oneOf)
+      const heuristicEngine = new OpenApiHeuristicEngine();
+      heuristicEngine.run(openApiRoot);
+
+      // 2. Delegate to correct parser version
+      const parser = OpenApiParserFactory.getParser(openApiRoot);
+      return parser.parse(openApiRoot, targetDefinition);
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.OpenApiBuilder = OpenApiBuilder;
+  return __exports;
+});
+//# sourceMappingURL=OpenApiBuilder-dbg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiBuilder-dbg.js","names":["Logger","___utils_Logger","OpenApiParserFactory","___OpenApiParserFactory","OpenApiHeuristicEngine","___heuristics_OpenApiHeuristicEngine","OpenApiBuilder","canHandle","rawSchema","schema","openapi","swagger","build","targetDefinition","fetchAndBuild","url","response","fetch","ok","Error","status","openApiRoot","json","error","msg","message","heuristicEngine","run","parser","getParser","parse","__exports","__esModule"],"sources":["OpenApiBuilder.ts"],"sourcesContent":["/**\n * @file OpenApiBuilder.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 and factories.\n */\n\nimport { ISchema } from \"../interfaces/ISchema\";\nimport { ISchemaBuilderPlugin } from \"../interfaces/ISchemaBuilderPlugin\";\nimport { Logger } from \"../utils/Logger\";\nimport { OpenApiParserFactory } from \"./OpenApiParserFactory\";\nimport { OpenApiHeuristicEngine } from \"./heuristics/OpenApiHeuristicEngine\";\n\n/**\n * Facade orchestration for translating Swagger/OpenAPI JSON into native MetaUI ISchema.\n * Strict Single Responsibility architecture delegates mapping logic to dedicated utilities and factories.\n * \n * @public\n */\nexport class OpenApiBuilder implements ISchemaBuilderPlugin {\n\n    /**\n     * Determines if the provided JSON payload is a Swagger or OpenAPI document.\n     * \n     * @param {unknown} 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: unknown): boolean {\n        const schema = rawSchema as Record<string, unknown>;\n        return !!(schema && (schema.openapi || schema.swagger));\n    }\n\n    /**\n     * Builds a strict MetaUI ISchema from the provided OpenAPI payload.\n     * \n     * @param {unknown} rawSchema The OpenAPI root document.\n     * @param {string} [targetDefinition] Optional target root definition.\n     * @returns {ISchema} The translated MetaUI schema.\n     */\n    public build(rawSchema: unknown, targetDefinition?: string): ISchema {\n        return OpenApiBuilder.build(rawSchema, targetDefinition);\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 openApiRoot = await response.json();\n            return this.build(openApiRoot, targetDefinition);\n        } catch (error) {\n            const msg = \"Failed to fetch Swagger JSON from URL: \" + (error as Error).message;\n            Logger.error(\"[MetaUI OpenApiBuilder]\", msg);\n            throw new Error(msg);\n        }\n    }\n\n    /**\n     * Synchronously builds a MetaUI ISchema from a provided OpenAPI root document.\n     * Delegates to HeuristicEngine and OpenApiParserFactory.\n     * \n     * @public\n     * @param {unknown} openApiRoot The raw OpenAPI root JSON document.\n     * @param {string} [targetDefinition] Optional target definition key to extract.\n     * @returns {ISchema} The synthesized MetaUI schema.\n     * @throws {Error} If the root object is invalid.\n     */\n    public static build(openApiRoot: unknown, targetDefinition?: string): ISchema {\n        if (!openApiRoot || typeof openApiRoot !== \"object\") {\n            throw new Error(\"[MetaUI OpenApiBuilder] Invalid Swagger root object provided.\");\n        }\n\n        // 1. Run Heuristics to mutate AST (e.g., simulating oneOf)\n        const heuristicEngine = new OpenApiHeuristicEngine();\n        heuristicEngine.run(openApiRoot);\n\n        // 2. Delegate to correct parser version\n        const parser = OpenApiParserFactory.getParser(openApiRoot);\n        return parser.parse(openApiRoot, targetDefinition);\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;AACA;EAJA,MAQSA,MAAM,GAAAC,eAAA;EAAA,MACNC,oBAAoB,GAAAC,uBAAA;EAAA,MACpBC,sBAAsB,GAAAC,oCAAA;EAE/B;AACA;AACA;AACA;AACA;AACA;EACO,MAAMC,cAAc,CAAiC;IAExD;AACJ;AACA;AACA;AACA;AACA;IACWC,SAASA,CAACC,SAAkB,EAAW;MAC1C,MAAMC,MAAM,GAAGD,SAAoC;MACnD,OAAO,CAAC,EAAEC,MAAM,KAAKA,MAAM,CAACC,OAAO,IAAID,MAAM,CAACE,OAAO,CAAC,CAAC;IAC3D;;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;IACWC,KAAKA,CAACJ,SAAkB,EAAEK,gBAAyB,EAAW;MACjE,OAAOP,cAAc,CAACM,KAAK,CAACJ,SAAS,EAAEK,gBAAgB,CAAC;IAC5D;;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;IACI,aAAoBC,aAAaA,CAACC,GAAW,EAAEF,gBAAyB,EAAoB;MACxF,IAAI;QACA,MAAMG,QAAQ,GAAG,MAAMC,KAAK,CAACF,GAAG,CAAC;QACjC,IAAI,CAACC,QAAQ,CAACE,EAAE,EAAE;UACd,MAAM,IAAIC,KAAK,CAAC,uBAAuBH,QAAQ,CAACI,MAAM,EAAE,CAAC;QAC7D;QACA,MAAMC,WAAW,GAAG,MAAML,QAAQ,CAACM,IAAI,CAAC,CAAC;QACzC,OAAO,IAAI,CAACV,KAAK,CAACS,WAAW,EAAER,gBAAgB,CAAC;MACpD,CAAC,CAAC,OAAOU,KAAK,EAAE;QACZ,MAAMC,GAAG,GAAG,yCAAyC,GAAID,KAAK,CAAWE,OAAO;QAChFzB,MAAM,CAACuB,KAAK,CAAC,yBAAyB,EAAEC,GAAG,CAAC;QAC5C,MAAM,IAAIL,KAAK,CAACK,GAAG,CAAC;MACxB;IACJ;;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACI,OAAcZ,KAAKA,CAACS,WAAoB,EAAER,gBAAyB,EAAW;MAC1E,IAAI,CAACQ,WAAW,IAAI,OAAOA,WAAW,KAAK,QAAQ,EAAE;QACjD,MAAM,IAAIF,KAAK,CAAC,+DAA+D,CAAC;MACpF;;MAEA;MACA,MAAMO,eAAe,GAAG,IAAItB,sBAAsB,CAAC,CAAC;MACpDsB,eAAe,CAACC,GAAG,CAACN,WAAW,CAAC;;MAEhC;MACA,MAAMO,MAAM,GAAG1B,oBAAoB,CAAC2B,SAAS,CAACR,WAAW,CAAC;MAC1D,OAAOO,MAAM,CAACE,KAAK,CAACT,WAAW,EAAER,gBAAgB,CAAC;IACtD;EACJ;EAAC,IAAAkB,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAzB,cAAA,GAAAA,cAAA;EAAA,OAAAyB,SAAA;AAAA","ignoreList":[]}

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

@@ -0,0 +1,52 @@
+declare module "nz/co/siliconst/ui5/metaui/openapi/OpenApiBuilder" {
+    /**
+     * @file OpenApiBuilder.ts
+     * @description Facade orchestration for translating Swagger/OpenAPI JSON into native MetaUI ISchema.
+     * Strict Single Responsibility architecture delegates mapping logic to dedicated utilities and factories.
+     */
+    import { ISchema } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    import { ISchemaBuilderPlugin } from "nz/co/siliconst/ui5/metaui/interfaces/ISchemaBuilderPlugin";
+    /**
+     * Facade orchestration for translating Swagger/OpenAPI JSON into native MetaUI ISchema.
+     * Strict Single Responsibility architecture delegates mapping logic to dedicated utilities and factories.
+     *
+     * @public
+     */
+    export class OpenApiBuilder implements ISchemaBuilderPlugin {
+        /**
+         * Determines if the provided JSON payload is a Swagger or OpenAPI document.
+         *
+         * @param {unknown} rawSchema The raw JSON schema to test.
+         * @returns {boolean} True if the document contains 'openapi' or 'swagger' root keys.
+         */
+        canHandle(rawSchema: unknown): boolean;
+        /**
+         * Builds a strict MetaUI ISchema from the provided OpenAPI payload.
+         *
+         * @param {unknown} rawSchema The OpenAPI root document.
+         * @param {string} [targetDefinition] Optional target root definition.
+         * @returns {ISchema} The translated MetaUI schema.
+         */
+        build(rawSchema: unknown, targetDefinition?: string): 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.
+         * Delegates to HeuristicEngine and OpenApiParserFactory.
+         *
+         * @public
+         * @param {unknown} openApiRoot The raw OpenAPI root JSON document.
+         * @param {string} [targetDefinition] Optional target definition key to extract.
+         * @returns {ISchema} The synthesized MetaUI schema.
+         * @throws {Error} If the root object is invalid.
+         */
+        static build(openApiRoot: unknown, targetDefinition?: string): ISchema;
+    }
+}
+//# sourceMappingURL=OpenApiBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiBuilder.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/openapi/OpenApiBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,mDAAmD,CAAC;IACnE;;;;OAIG;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;IACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4DAA4D,CAAC;IAKlG;;;;;OAKG;IACH,MAAa,cAAe,YAAW,oBAAoB;QAEvD;;;;;WAKG;QACI,SAAS,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO;QAK7C;;;;;;WAMG;QACI,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO;QAIpE;;;;;;WAMG;eACiB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;QAe3F;;;;;;;;;WASG;eACW,KAAK,CAAC,WAAW,EAAE,OAAO,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO;KAahF;CAEA"}

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

@@ -0,0 +1,2 @@
+sap.ui.define(["../utils/Logger","./OpenApiParserFactory","./heuristics/OpenApiHeuristicEngine"],function(e,r,t){"use strict";const n=e["Logger"];const i=r["OpenApiParserFactory"];const s=t["OpenApiHeuristicEngine"];class o{canHandle(e){const r=e;return!!(r&&(r.openapi||r.swagger))}build(e,r){return o.build(e,r)}static async fetchAndBuild(e,r){try{const t=await fetch(e);if(!t.ok){throw new Error(`HTTP error! status: ${t.status}`)}const n=await t.json();return this.build(n,r)}catch(e){const r="Failed to fetch Swagger JSON from URL: "+e.message;n.error("[MetaUI OpenApiBuilder]",r);throw new Error(r)}}static build(e,r){if(!e||typeof e!=="object"){throw new Error("[MetaUI OpenApiBuilder] Invalid Swagger root object provided.")}const t=new s;t.run(e);const n=i.getParser(e);return n.parse(e,r)}}var a={__esModule:true};a.OpenApiBuilder=o;return a});
+//# sourceMappingURL=OpenApiBuilder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiBuilder.js","names":["Logger","___utils_Logger","OpenApiParserFactory","___OpenApiParserFactory","OpenApiHeuristicEngine","___heuristics_OpenApiHeuristicEngine","OpenApiBuilder","canHandle","rawSchema","schema","openapi","swagger","build","targetDefinition","fetchAndBuild","url","response","fetch","ok","Error","status","openApiRoot","json","this","error","msg","message","heuristicEngine","run","parser","getParser","parse","__exports","__esModule"],"sources":["OpenApiBuilder.ts"],"sourcesContent":["/**\n * @file OpenApiBuilder.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 and factories.\n */\n\nimport { ISchema } from \"../interfaces/ISchema\";\nimport { ISchemaBuilderPlugin } from \"../interfaces/ISchemaBuilderPlugin\";\nimport { Logger } from \"../utils/Logger\";\nimport { OpenApiParserFactory } from \"./OpenApiParserFactory\";\nimport { OpenApiHeuristicEngine } from \"./heuristics/OpenApiHeuristicEngine\";\n\n/**\n * Facade orchestration for translating Swagger/OpenAPI JSON into native MetaUI ISchema.\n * Strict Single Responsibility architecture delegates mapping logic to dedicated utilities and factories.\n * \n * @public\n */\nexport class OpenApiBuilder implements ISchemaBuilderPlugin {\n\n    /**\n     * Determines if the provided JSON payload is a Swagger or OpenAPI document.\n     * \n     * @param {unknown} 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: unknown): boolean {\n        const schema = rawSchema as Record<string, unknown>;\n        return !!(schema && (schema.openapi || schema.swagger));\n    }\n\n    /**\n     * Builds a strict MetaUI ISchema from the provided OpenAPI payload.\n     * \n     * @param {unknown} rawSchema The OpenAPI root document.\n     * @param {string} [targetDefinition] Optional target root definition.\n     * @returns {ISchema} The translated MetaUI schema.\n     */\n    public build(rawSchema: unknown, targetDefinition?: string): ISchema {\n        return OpenApiBuilder.build(rawSchema, targetDefinition);\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 openApiRoot = await response.json();\n            return this.build(openApiRoot, targetDefinition);\n        } catch (error) {\n            const msg = \"Failed to fetch Swagger JSON from URL: \" + (error as Error).message;\n            Logger.error(\"[MetaUI OpenApiBuilder]\", msg);\n            throw new Error(msg);\n        }\n    }\n\n    /**\n     * Synchronously builds a MetaUI ISchema from a provided OpenAPI root document.\n     * Delegates to HeuristicEngine and OpenApiParserFactory.\n     * \n     * @public\n     * @param {unknown} openApiRoot The raw OpenAPI root JSON document.\n     * @param {string} [targetDefinition] Optional target definition key to extract.\n     * @returns {ISchema} The synthesized MetaUI schema.\n     * @throws {Error} If the root object is invalid.\n     */\n    public static build(openApiRoot: unknown, targetDefinition?: string): ISchema {\n        if (!openApiRoot || typeof openApiRoot !== \"object\") {\n            throw new Error(\"[MetaUI OpenApiBuilder] Invalid Swagger root object provided.\");\n        }\n\n        // 1. Run Heuristics to mutate AST (e.g., simulating oneOf)\n        const heuristicEngine = new OpenApiHeuristicEngine();\n        heuristicEngine.run(openApiRoot);\n\n        // 2. Delegate to correct parser version\n        const parser = OpenApiParserFactory.getParser(openApiRoot);\n        return parser.parse(openApiRoot, targetDefinition);\n    }\n}\n"],"mappings":"8HAAA,MAQSA,EAAMC,EAAA,gBACNC,EAAoBC,EAAA,8BACpBC,EAAsBC,EAAA,0BAQxB,MAAMC,EAQFC,UAAUC,GACb,MAAMC,EAASD,EACf,SAAUC,IAAWA,EAAOC,SAAWD,EAAOE,SAClD,CASOC,MAAMJ,EAAoBK,GAC7B,OAAOP,EAAeM,MAAMJ,EAAWK,EAC3C,CASA,0BAAoBC,CAAcC,EAAaF,GAC3C,IACI,MAAMG,QAAiBC,MAAMF,GAC7B,IAAKC,EAASE,GAAI,CACd,MAAM,IAAIC,MAAM,uBAAuBH,EAASI,SACpD,CACA,MAAMC,QAAoBL,EAASM,OACnC,OAAOC,KAAKX,MAAMS,EAAaR,EACnC,CAAE,MAAOW,GACL,MAAMC,EAAM,0CAA6CD,EAAgBE,QACzE1B,EAAOwB,MAAM,0BAA2BC,GACxC,MAAM,IAAIN,MAAMM,EACpB,CACJ,CAYA,YAAcb,CAAMS,EAAsBR,GACtC,IAAKQ,UAAsBA,IAAgB,SAAU,CACjD,MAAM,IAAIF,MAAM,gEACpB,CAGA,MAAMQ,EAAkB,IAAIvB,EAC5BuB,EAAgBC,IAAIP,GAGpB,MAAMQ,EAAS3B,EAAqB4B,UAAUT,GAC9C,OAAOQ,EAAOE,MAAMV,EAAaR,EACrC,EACH,IAAAmB,EAAA,CAAAC,WAAA,MAAAD,EAAA1B,iBAAA,OAAA0B,CAAA","ignoreList":[]}

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

@@ -0,0 +1,88 @@
+/**
+ * @file OpenApiBuilder.ts
+ * @description Facade orchestration for translating Swagger/OpenAPI JSON into native MetaUI ISchema.
+ * Strict Single Responsibility architecture delegates mapping logic to dedicated utilities and factories.
+ */
+
+import { ISchema } from "../interfaces/ISchema";
+import { ISchemaBuilderPlugin } from "../interfaces/ISchemaBuilderPlugin";
+import { Logger } from "../utils/Logger";
+import { OpenApiParserFactory } from "./OpenApiParserFactory";
+import { OpenApiHeuristicEngine } from "./heuristics/OpenApiHeuristicEngine";
+
+/**
+ * Facade orchestration for translating Swagger/OpenAPI JSON into native MetaUI ISchema.
+ * Strict Single Responsibility architecture delegates mapping logic to dedicated utilities and factories.
+ * 
+ * @public
+ */
+export class OpenApiBuilder implements ISchemaBuilderPlugin {
+
+    /**
+     * Determines if the provided JSON payload is a Swagger or OpenAPI document.
+     * 
+     * @param {unknown} rawSchema The raw JSON schema to test.
+     * @returns {boolean} True if the document contains 'openapi' or 'swagger' root keys.
+     */
+    public canHandle(rawSchema: unknown): boolean {
+        const schema = rawSchema as Record<string, unknown>;
+        return !!(schema && (schema.openapi || schema.swagger));
+    }
+
+    /**
+     * Builds a strict MetaUI ISchema from the provided OpenAPI payload.
+     * 
+     * @param {unknown} rawSchema The OpenAPI root document.
+     * @param {string} [targetDefinition] Optional target root definition.
+     * @returns {ISchema} The translated MetaUI schema.
+     */
+    public build(rawSchema: unknown, targetDefinition?: string): ISchema {
+        return OpenApiBuilder.build(rawSchema, targetDefinition);
+    }
+
+    /**
+     * 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 openApiRoot = await response.json();
+            return this.build(openApiRoot, targetDefinition);
+        } catch (error) {
+            const msg = "Failed to fetch Swagger JSON from URL: " + (error as Error).message;
+            Logger.error("[MetaUI OpenApiBuilder]", msg);
+            throw new Error(msg);
+        }
+    }
+
+    /**
+     * Synchronously builds a MetaUI ISchema from a provided OpenAPI root document.
+     * Delegates to HeuristicEngine and OpenApiParserFactory.
+     * 
+     * @public
+     * @param {unknown} openApiRoot The raw OpenAPI root JSON document.
+     * @param {string} [targetDefinition] Optional target definition key to extract.
+     * @returns {ISchema} The synthesized MetaUI schema.
+     * @throws {Error} If the root object is invalid.
+     */
+    public static build(openApiRoot: unknown, targetDefinition?: string): ISchema {
+        if (!openApiRoot || typeof openApiRoot !== "object") {
+            throw new Error("[MetaUI OpenApiBuilder] Invalid Swagger root object provided.");
+        }
+
+        // 1. Run Heuristics to mutate AST (e.g., simulating oneOf)
+        const heuristicEngine = new OpenApiHeuristicEngine();
+        heuristicEngine.run(openApiRoot);
+
+        // 2. Delegate to correct parser version
+        const parser = OpenApiParserFactory.getParser(openApiRoot);
+        return parser.parse(openApiRoot, targetDefinition);
+    }
+}

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

@@ -0,0 +1,47 @@
+sap.ui.define(["./parsers/OpenApi2Parser", "./parsers/OpenApi3Parser", "../utils/Logger"], function (___parsers_OpenApi2Parser, ___parsers_OpenApi3Parser, ___utils_Logger) {
+  "use strict";
+
+  /**
+   * @file OpenApiParserFactory.ts
+   * @description Factory class to determine and instantiate the correct Swagger parser version.
+   */
+  const OpenApi2Parser = ___parsers_OpenApi2Parser["OpenApi2Parser"];
+  const OpenApi3Parser = ___parsers_OpenApi3Parser["OpenApi3Parser"];
+  const Logger = ___utils_Logger["Logger"];
+  /**
+   * Factory class responsible for analyzing a raw OpenAPI document's metadata to dynamically 
+   * instantiate the correct, version-specific parser plugin. This isolates structural version 
+   * differences from the primary Engine orchestration layer.
+   * 
+   * @public
+   */
+  class OpenApiParserFactory {
+    /**
+     * Inspects the root level structural signatures of an OpenAPI document (e.g., `swagger: "2.0"` 
+     * vs `openapi: "3.x"`) to instantiate the appropriate parsing engine.
+     * 
+     * @param {any} rawSchema The raw, unparsed OpenAPI root JSON structure.
+     * @returns {IOpenApiParserPlugin} An initialized instance of the correct concrete parser plugin.
+     */
+    static getParser(rawSchema) {
+      if (!rawSchema || typeof rawSchema !== "object") {
+        Logger.error("[MetaUI OpenApiParserFactory] Invalid OpenAPI document provided.");
+        return new OpenApi3Parser(); // Fallback
+      }
+      if (rawSchema.swagger === "2.0") {
+        return new OpenApi2Parser();
+      }
+      if (rawSchema.openapi && typeof rawSchema.openapi === "string" && rawSchema.openapi.startsWith("3")) {
+        return new OpenApi3Parser();
+      }
+      Logger.warn("[MetaUI OpenApiParserFactory] Unable to strictly determine OpenAPI version. Defaulting to OpenAPI 3.0 Parser.");
+      return new OpenApi3Parser();
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.OpenApiParserFactory = OpenApiParserFactory;
+  return __exports;
+});
+//# sourceMappingURL=OpenApiParserFactory-dbg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiParserFactory-dbg.js","names":["OpenApi2Parser","___parsers_OpenApi2Parser","OpenApi3Parser","___parsers_OpenApi3Parser","Logger","___utils_Logger","OpenApiParserFactory","getParser","rawSchema","error","swagger","openapi","startsWith","warn","__exports","__esModule"],"sources":["OpenApiParserFactory.ts"],"sourcesContent":["/**\n * @file OpenApiParserFactory.ts\n * @description Factory class to determine and instantiate the correct Swagger parser version.\n */\n\nimport { IOpenApiParserPlugin } from \"./interfaces/IOpenApiParserPlugin\";\nimport { OpenApi2Parser } from \"./parsers/OpenApi2Parser\";\nimport { OpenApi3Parser } from \"./parsers/OpenApi3Parser\";\nimport { Logger } from \"../utils/Logger\";\n\n/**\n * Factory class responsible for analyzing a raw OpenAPI document's metadata to dynamically \n * instantiate the correct, version-specific parser plugin. This isolates structural version \n * differences from the primary Engine orchestration layer.\n * \n * @public\n */\nexport class OpenApiParserFactory {\n    /**\n     * Inspects the root level structural signatures of an OpenAPI document (e.g., `swagger: \"2.0\"` \n     * vs `openapi: \"3.x\"`) to instantiate the appropriate parsing engine.\n     * \n     * @param {any} rawSchema The raw, unparsed OpenAPI root JSON structure.\n     * @returns {IOpenApiParserPlugin} An initialized instance of the correct concrete parser plugin.\n     */\n    public static getParser(rawSchema: unknown): IOpenApiParserPlugin {\n        if (!rawSchema || typeof rawSchema !== \"object\") {\n            Logger.error(\"[MetaUI OpenApiParserFactory] Invalid OpenAPI document provided.\");\n            return new OpenApi3Parser(); // Fallback\n        }\n\n        if (rawSchema.swagger === \"2.0\") {\n            return new OpenApi2Parser();\n        }\n\n        if (rawSchema.openapi && typeof rawSchema.openapi === \"string\" && rawSchema.openapi.startsWith(\"3\")) {\n            return new OpenApi3Parser();\n        }\n\n        Logger.warn(\"[MetaUI OpenApiParserFactory] Unable to strictly determine OpenAPI version. Defaulting to OpenAPI 3.0 Parser.\");\n        return new OpenApi3Parser();\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;EAHA,MAMSA,cAAc,GAAAC,yBAAA;EAAA,MACdC,cAAc,GAAAC,yBAAA;EAAA,MACdC,MAAM,GAAAC,eAAA;EAEf;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMC,oBAAoB,CAAC;IAC9B;AACJ;AACA;AACA;AACA;AACA;AACA;IACI,OAAcC,SAASA,CAACC,SAAkB,EAAwB;MAC9D,IAAI,CAACA,SAAS,IAAI,OAAOA,SAAS,KAAK,QAAQ,EAAE;QAC7CJ,MAAM,CAACK,KAAK,CAAC,kEAAkE,CAAC;QAChF,OAAO,IAAIP,cAAc,CAAC,CAAC,CAAC,CAAC;MACjC;MAEA,IAAIM,SAAS,CAACE,OAAO,KAAK,KAAK,EAAE;QAC7B,OAAO,IAAIV,cAAc,CAAC,CAAC;MAC/B;MAEA,IAAIQ,SAAS,CAACG,OAAO,IAAI,OAAOH,SAAS,CAACG,OAAO,KAAK,QAAQ,IAAIH,SAAS,CAACG,OAAO,CAACC,UAAU,CAAC,GAAG,CAAC,EAAE;QACjG,OAAO,IAAIV,cAAc,CAAC,CAAC;MAC/B;MAEAE,MAAM,CAACS,IAAI,CAAC,+GAA+G,CAAC;MAC5H,OAAO,IAAIX,cAAc,CAAC,CAAC;IAC/B;EACJ;EAAC,IAAAY,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAR,oBAAA,GAAAA,oBAAA;EAAA,OAAAQ,SAAA;AAAA","ignoreList":[]}

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

@@ -0,0 +1,25 @@
+declare module "nz/co/siliconst/ui5/metaui/openapi/OpenApiParserFactory" {
+    /**
+     * @file OpenApiParserFactory.ts
+     * @description Factory class to determine and instantiate the correct Swagger parser version.
+     */
+    import { IOpenApiParserPlugin } from "nz/co/siliconst/ui5/metaui/openapi/interfaces/IOpenApiParserPlugin";
+    /**
+     * Factory class responsible for analyzing a raw OpenAPI document's metadata to dynamically
+     * instantiate the correct, version-specific parser plugin. This isolates structural version
+     * differences from the primary Engine orchestration layer.
+     *
+     * @public
+     */
+    export class OpenApiParserFactory {
+        /**
+         * Inspects the root level structural signatures of an OpenAPI document (e.g., `swagger: "2.0"`
+         * vs `openapi: "3.x"`) to instantiate the appropriate parsing engine.
+         *
+         * @param {any} rawSchema The raw, unparsed OpenAPI root JSON structure.
+         * @returns {IOpenApiParserPlugin} An initialized instance of the correct concrete parser plugin.
+         */
+        static getParser(rawSchema: unknown): IOpenApiParserPlugin;
+    }
+}
+//# sourceMappingURL=OpenApiParserFactory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiParserFactory.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/openapi/OpenApiParserFactory.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,yDAAyD,CAAC;IACzE;;;OAGG;IAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oEAAoE,CAAC;IAK1G;;;;;;OAMG;IACH,MAAa,oBAAoB;QAC7B;;;;;;WAMG;eACW,SAAS,CAAC,SAAS,EAAE,OAAO,GAAG,oBAAoB;KAiBpE;CAEA"}

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

@@ -0,0 +1,2 @@
+sap.ui.define(["./parsers/OpenApi2Parser","./parsers/OpenApi3Parser","../utils/Logger"],function(e,r,n){"use strict";const t=e["OpenApi2Parser"];const s=r["OpenApi3Parser"];const a=n["Logger"];class p{static getParser(e){if(!e||typeof e!=="object"){a.error("[MetaUI OpenApiParserFactory] Invalid OpenAPI document provided.");return new s}if(e.swagger==="2.0"){return new t}if(e.openapi&&typeof e.openapi==="string"&&e.openapi.startsWith("3")){return new s}a.warn("[MetaUI OpenApiParserFactory] Unable to strictly determine OpenAPI version. Defaulting to OpenAPI 3.0 Parser.");return new s}}var i={__esModule:true};i.OpenApiParserFactory=p;return i});
+//# sourceMappingURL=OpenApiParserFactory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiParserFactory.js","names":["OpenApi2Parser","___parsers_OpenApi2Parser","OpenApi3Parser","___parsers_OpenApi3Parser","Logger","___utils_Logger","OpenApiParserFactory","getParser","rawSchema","error","swagger","openapi","startsWith","warn","__exports","__esModule"],"sources":["OpenApiParserFactory.ts"],"sourcesContent":["/**\n * @file OpenApiParserFactory.ts\n * @description Factory class to determine and instantiate the correct Swagger parser version.\n */\n\nimport { IOpenApiParserPlugin } from \"./interfaces/IOpenApiParserPlugin\";\nimport { OpenApi2Parser } from \"./parsers/OpenApi2Parser\";\nimport { OpenApi3Parser } from \"./parsers/OpenApi3Parser\";\nimport { Logger } from \"../utils/Logger\";\n\n/**\n * Factory class responsible for analyzing a raw OpenAPI document's metadata to dynamically \n * instantiate the correct, version-specific parser plugin. This isolates structural version \n * differences from the primary Engine orchestration layer.\n * \n * @public\n */\nexport class OpenApiParserFactory {\n    /**\n     * Inspects the root level structural signatures of an OpenAPI document (e.g., `swagger: \"2.0\"` \n     * vs `openapi: \"3.x\"`) to instantiate the appropriate parsing engine.\n     * \n     * @param {any} rawSchema The raw, unparsed OpenAPI root JSON structure.\n     * @returns {IOpenApiParserPlugin} An initialized instance of the correct concrete parser plugin.\n     */\n    public static getParser(rawSchema: unknown): IOpenApiParserPlugin {\n        if (!rawSchema || typeof rawSchema !== \"object\") {\n            Logger.error(\"[MetaUI OpenApiParserFactory] Invalid OpenAPI document provided.\");\n            return new OpenApi3Parser(); // Fallback\n        }\n\n        if (rawSchema.swagger === \"2.0\") {\n            return new OpenApi2Parser();\n        }\n\n        if (rawSchema.openapi && typeof rawSchema.openapi === \"string\" && rawSchema.openapi.startsWith(\"3\")) {\n            return new OpenApi3Parser();\n        }\n\n        Logger.warn(\"[MetaUI OpenApiParserFactory] Unable to strictly determine OpenAPI version. Defaulting to OpenAPI 3.0 Parser.\");\n        return new OpenApi3Parser();\n    }\n}\n"],"mappings":"qHAAA,MAMSA,EAAcC,EAAA,wBACdC,EAAcC,EAAA,wBACdC,EAAMC,EAAA,UASR,MAAMC,EAQT,gBAAcC,CAAUC,GACpB,IAAKA,UAAoBA,IAAc,SAAU,CAC7CJ,EAAOK,MAAM,oEACb,OAAO,IAAIP,CACf,CAEA,GAAIM,EAAUE,UAAY,MAAO,CAC7B,OAAO,IAAIV,CACf,CAEA,GAAIQ,EAAUG,gBAAkBH,EAAUG,UAAY,UAAYH,EAAUG,QAAQC,WAAW,KAAM,CACjG,OAAO,IAAIV,CACf,CAEAE,EAAOS,KAAK,iHACZ,OAAO,IAAIX,CACf,EACH,IAAAY,EAAA,CAAAC,WAAA,MAAAD,EAAAR,uBAAA,OAAAQ,CAAA","ignoreList":[]}

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

@@ -0,0 +1,43 @@
+/**
+ * @file OpenApiParserFactory.ts
+ * @description Factory class to determine and instantiate the correct Swagger parser version.
+ */
+
+import { IOpenApiParserPlugin } from "./interfaces/IOpenApiParserPlugin";
+import { OpenApi2Parser } from "./parsers/OpenApi2Parser";
+import { OpenApi3Parser } from "./parsers/OpenApi3Parser";
+import { Logger } from "../utils/Logger";
+
+/**
+ * Factory class responsible for analyzing a raw OpenAPI document's metadata to dynamically 
+ * instantiate the correct, version-specific parser plugin. This isolates structural version 
+ * differences from the primary Engine orchestration layer.
+ * 
+ * @public
+ */
+export class OpenApiParserFactory {
+    /**
+     * Inspects the root level structural signatures of an OpenAPI document (e.g., `swagger: "2.0"` 
+     * vs `openapi: "3.x"`) to instantiate the appropriate parsing engine.
+     * 
+     * @param {any} rawSchema The raw, unparsed OpenAPI root JSON structure.
+     * @returns {IOpenApiParserPlugin} An initialized instance of the correct concrete parser plugin.
+     */
+    public static getParser(rawSchema: unknown): IOpenApiParserPlugin {
+        if (!rawSchema || typeof rawSchema !== "object") {
+            Logger.error("[MetaUI OpenApiParserFactory] Invalid OpenAPI document provided.");
+            return new OpenApi3Parser(); // Fallback
+        }
+
+        if (rawSchema.swagger === "2.0") {
+            return new OpenApi2Parser();
+        }
+
+        if (rawSchema.openapi && typeof rawSchema.openapi === "string" && rawSchema.openapi.startsWith("3")) {
+            return new OpenApi3Parser();
+        }
+
+        Logger.warn("[MetaUI OpenApiParserFactory] Unable to strictly determine OpenAPI version. Defaulting to OpenAPI 3.0 Parser.");
+        return new OpenApi3Parser();
+    }
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiRefResolver-dbg.js","names":["Logger","___utils_Logger","OpenApiRefResolver","resolve","refUrl","openApiRoot","depth","startsWith","debug","error","pathSegments","substring","split","current","segment","$ref","__exports","__esModule"],"sources":["OpenApiRefResolver.ts"],"sourcesContent":["/**\n * @file OpenApiRefResolver.ts\n * @description Utility class for resolving local $ref pointers within an OpenAPI document.\n */\nimport { Logger } from \"../utils/Logger\";\n\n/**\n * Utility class for resolving local $ref pointers within an OpenAPI document.\n * \n * @public\n */\nexport class OpenApiRefResolver {\n    /**\n     * Recursively traverses a local JSON Pointer $ref path (e.g., '#/components/schemas/Pet')\n     * and extracts the target object from the Swagger root document.\n     * External URLs or invalid references are safely ignored.\n     * \n     * @param {string} refUrl The $ref string path.\n     * @param {any} openApiRoot The root OpenAPI document to query against.\n     * @param {number} depth The current recursive depth count, used to prevent infinite loops.\n     * @returns {any} The resolved schema object, or null if unresolvable.\n     */\n    public static resolve(refUrl: string, openApiRoot: unknown, depth: number = 0): unknown {\n        if (!refUrl || !refUrl.startsWith(\"#/\")) {\n            Logger.debug(`[MetaUI OpenApiBuilder] Ignoring non-local or empty $ref: ${refUrl}`, \"OpenApiBuilder\");\n            return null; // Ignore external URLs per architectural rules\n        }\n\n        // Circular Reference Limit:\n        // A hard limit is enforced to prevent stack overflow exceptions caused by infinitely \n        // recursive structures (e.g., a Tree node that references another Tree node).\n        if (depth > 10) {\n            Logger.error(`[MetaUI OpenApiBuilder] Circular or overly deep $ref detected: ${refUrl}`, null, \"OpenApiBuilder\");\n            return null;\n        }\n\n        // Path Segment Parsing:\n        // The '#/' prefix is stripped, and the remaining path is split by '/'.\n        // We incrementally descend into the swagger root using these segments.\n        const pathSegments = refUrl.substring(2).split(\"/\");\n        let current = openApiRoot;\n\n        for (const segment of pathSegments) {\n            if (current && typeof current === \"object\" && segment in current) {\n                current = current[segment];\n            } else {\n                Logger.error(`[MetaUI OpenApiBuilder] Failed to resolve local $ref: ${refUrl}`, null, \"OpenApiBuilder\");\n                return null;\n            }\n        }\n\n        // Deep Resolution Recursion:\n        // If the resolved target is itself a reference pointer, recursively resolve again\n        // until we reach a terminal structure or hit the recursion depth limit.\n        if (current && typeof current === \"object\" && current.$ref) {\n            return this.resolve(current.$ref, openApiRoot, depth + 1);\n        }\n\n        return current;\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;EAHA,MAISA,MAAM,GAAAC,eAAA;EAEf;AACA;AACA;AACA;AACA;EACO,MAAMC,kBAAkB,CAAC;IAC5B;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACI,OAAcC,OAAOA,CAACC,MAAc,EAAEC,WAAoB,EAAEC,KAAa,GAAG,CAAC,EAAW;MACpF,IAAI,CAACF,MAAM,IAAI,CAACA,MAAM,CAACG,UAAU,CAAC,IAAI,CAAC,EAAE;QACrCP,MAAM,CAACQ,KAAK,CAAC,6DAA6DJ,MAAM,EAAE,EAAE,gBAAgB,CAAC;QACrG,OAAO,IAAI,CAAC,CAAC;MACjB;;MAEA;MACA;MACA;MACA,IAAIE,KAAK,GAAG,EAAE,EAAE;QACZN,MAAM,CAACS,KAAK,CAAC,kEAAkEL,MAAM,EAAE,EAAE,IAAI,EAAE,gBAAgB,CAAC;QAChH,OAAO,IAAI;MACf;;MAEA;MACA;MACA;MACA,MAAMM,YAAY,GAAGN,MAAM,CAACO,SAAS,CAAC,CAAC,CAAC,CAACC,KAAK,CAAC,GAAG,CAAC;MACnD,IAAIC,OAAO,GAAGR,WAAW;MAEzB,KAAK,MAAMS,OAAO,IAAIJ,YAAY,EAAE;QAChC,IAAIG,OAAO,IAAI,OAAOA,OAAO,KAAK,QAAQ,IAAIC,OAAO,IAAID,OAAO,EAAE;UAC9DA,OAAO,GAAGA,OAAO,CAACC,OAAO,CAAC;QAC9B,CAAC,MAAM;UACHd,MAAM,CAACS,KAAK,CAAC,yDAAyDL,MAAM,EAAE,EAAE,IAAI,EAAE,gBAAgB,CAAC;UACvG,OAAO,IAAI;QACf;MACJ;;MAEA;MACA;MACA;MACA,IAAIS,OAAO,IAAI,OAAOA,OAAO,KAAK,QAAQ,IAAIA,OAAO,CAACE,IAAI,EAAE;QACxD,OAAO,IAAI,CAACZ,OAAO,CAACU,OAAO,CAACE,IAAI,EAAEV,WAAW,EAAEC,KAAK,GAAG,CAAC,CAAC;MAC7D;MAEA,OAAOO,OAAO;IAClB;EACJ;EAAC,IAAAG,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAd,kBAAA,GAAAA,kBAAA;EAAA,OAAAc,SAAA;AAAA","ignoreList":[]}

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

@@ -0,0 +1,21 @@
+declare module "nz/co/siliconst/ui5/metaui/openapi/OpenApiRefResolver" {
+    /**
+     * Utility class for resolving local $ref pointers within an OpenAPI document.
+     *
+     * @public
+     */
+    export class OpenApiRefResolver {
+        /**
+         * Recursively traverses a local JSON Pointer $ref path (e.g., '#/components/schemas/Pet')
+         * and extracts the target object from the Swagger root document.
+         * External URLs or invalid references are safely ignored.
+         *
+         * @param {string} refUrl The $ref string path.
+         * @param {any} openApiRoot The root OpenAPI document to query against.
+         * @param {number} depth The current recursive depth count, used to prevent infinite loops.
+         * @returns {any} The resolved schema object, or null if unresolvable.
+         */
+        static resolve(refUrl: string, openApiRoot: unknown, depth?: number): unknown;
+    }
+}
+//# sourceMappingURL=OpenApiRefResolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiRefResolver.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/openapi/OpenApiRefResolver.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,uDAAuD,CAAC;IAOvE;;;;OAIG;IACH,MAAa,kBAAkB;QAC3B;;;;;;;;;WASG;eACW,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO;KAsC1F;CAEA"}

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

@@ -0,0 +1,2 @@
+sap.ui.define(["../utils/Logger"],function(e){"use strict";const r=e["Logger"];class t{static resolve(e,t,l=0){if(!e||!e.startsWith("#/")){r.debug(`[MetaUI OpenApiBuilder] Ignoring non-local or empty $ref: ${e}`,"OpenApiBuilder");return null}if(l>10){r.error(`[MetaUI OpenApiBuilder] Circular or overly deep $ref detected: ${e}`,null,"OpenApiBuilder");return null}const i=e.substring(2).split("/");let n=t;for(const t of i){if(n&&typeof n==="object"&&t in n){n=n[t]}else{r.error(`[MetaUI OpenApiBuilder] Failed to resolve local $ref: ${e}`,null,"OpenApiBuilder");return null}}if(n&&typeof n==="object"&&n.$ref){return this.resolve(n.$ref,t,l+1)}return n}}var l={__esModule:true};l.OpenApiRefResolver=t;return l});
+//# sourceMappingURL=OpenApiRefResolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiRefResolver.js","names":["Logger","___utils_Logger","OpenApiRefResolver","resolve","refUrl","openApiRoot","depth","startsWith","debug","error","pathSegments","substring","split","current","segment","$ref","this","__exports","__esModule"],"sources":["OpenApiRefResolver.ts"],"sourcesContent":["/**\n * @file OpenApiRefResolver.ts\n * @description Utility class for resolving local $ref pointers within an OpenAPI document.\n */\nimport { Logger } from \"../utils/Logger\";\n\n/**\n * Utility class for resolving local $ref pointers within an OpenAPI document.\n * \n * @public\n */\nexport class OpenApiRefResolver {\n    /**\n     * Recursively traverses a local JSON Pointer $ref path (e.g., '#/components/schemas/Pet')\n     * and extracts the target object from the Swagger root document.\n     * External URLs or invalid references are safely ignored.\n     * \n     * @param {string} refUrl The $ref string path.\n     * @param {any} openApiRoot The root OpenAPI document to query against.\n     * @param {number} depth The current recursive depth count, used to prevent infinite loops.\n     * @returns {any} The resolved schema object, or null if unresolvable.\n     */\n    public static resolve(refUrl: string, openApiRoot: unknown, depth: number = 0): unknown {\n        if (!refUrl || !refUrl.startsWith(\"#/\")) {\n            Logger.debug(`[MetaUI OpenApiBuilder] Ignoring non-local or empty $ref: ${refUrl}`, \"OpenApiBuilder\");\n            return null; // Ignore external URLs per architectural rules\n        }\n\n        // Circular Reference Limit:\n        // A hard limit is enforced to prevent stack overflow exceptions caused by infinitely \n        // recursive structures (e.g., a Tree node that references another Tree node).\n        if (depth > 10) {\n            Logger.error(`[MetaUI OpenApiBuilder] Circular or overly deep $ref detected: ${refUrl}`, null, \"OpenApiBuilder\");\n            return null;\n        }\n\n        // Path Segment Parsing:\n        // The '#/' prefix is stripped, and the remaining path is split by '/'.\n        // We incrementally descend into the swagger root using these segments.\n        const pathSegments = refUrl.substring(2).split(\"/\");\n        let current = openApiRoot;\n\n        for (const segment of pathSegments) {\n            if (current && typeof current === \"object\" && segment in current) {\n                current = current[segment];\n            } else {\n                Logger.error(`[MetaUI OpenApiBuilder] Failed to resolve local $ref: ${refUrl}`, null, \"OpenApiBuilder\");\n                return null;\n            }\n        }\n\n        // Deep Resolution Recursion:\n        // If the resolved target is itself a reference pointer, recursively resolve again\n        // until we reach a terminal structure or hit the recursion depth limit.\n        if (current && typeof current === \"object\" && current.$ref) {\n            return this.resolve(current.$ref, openApiRoot, depth + 1);\n        }\n\n        return current;\n    }\n}\n"],"mappings":"2DAAA,MAISA,EAAMC,EAAA,UAOR,MAAMC,EAWT,cAAcC,CAAQC,EAAgBC,EAAsBC,EAAgB,GACxE,IAAKF,IAAWA,EAAOG,WAAW,MAAO,CACrCP,EAAOQ,MAAM,6DAA6DJ,IAAU,kBACpF,OAAO,IACX,CAKA,GAAIE,EAAQ,GAAI,CACZN,EAAOS,MAAM,kEAAkEL,IAAU,KAAM,kBAC/F,OAAO,IACX,CAKA,MAAMM,EAAeN,EAAOO,UAAU,GAAGC,MAAM,KAC/C,IAAIC,EAAUR,EAEd,IAAK,MAAMS,KAAWJ,EAAc,CAChC,GAAIG,UAAkBA,IAAY,UAAYC,KAAWD,EAAS,CAC9DA,EAAUA,EAAQC,EACtB,KAAO,CACHd,EAAOS,MAAM,yDAAyDL,IAAU,KAAM,kBACtF,OAAO,IACX,CACJ,CAKA,GAAIS,UAAkBA,IAAY,UAAYA,EAAQE,KAAM,CACxD,OAAOC,KAAKb,QAAQU,EAAQE,KAAMV,EAAaC,EAAQ,EAC3D,CAEA,OAAOO,CACX,EACH,IAAAI,EAAA,CAAAC,WAAA,MAAAD,EAAAf,qBAAA,OAAAe,CAAA","ignoreList":[]}