@siliconst/metaui 1.4.13 → 1.4.14

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

@@ -0,0 +1 @@
+{"version":3,"file":"SwaggerUIMapper.js","names":["SwaggerUIMapper","build","swaggerProp","keyName","ui","title","label","description","this","generateLabel","readOnly","format","widget","validators","push","name","spaced","replace","split","filter","w","length","map","word","charAt","toUpperCase","slice","toLowerCase","join","trim","__exports","__esModule"],"sources":["SwaggerUIMapper.ts"],"sourcesContent":["/**\n * @file SwaggerUIMapper.ts\n * @description Utility class for mapping OpenAPI properties and formats into MetaUI IUIDirectives.\n */\nimport { IUIDirective } from \"../interfaces/ISchema\";\n\nexport class SwaggerUIMapper {\n    /**\n     * Evaluates an OpenAPI property definition and constructs a MetaUI IUIDirective block.\n     * Extracts labels from title/description, maps readOnly state, and assigns \n     * specific Fiori widgets based on the OpenAPI 'format' property.\n     * \n     * @param {any} swaggerProp The raw OpenAPI property schema.\n     * @param {string} keyName The technical JSON key of the property.\n     * @returns {IUIDirective} The constructed MetaUI UI orchestration directive.\n     */\n    public static build(swaggerProp: any, keyName: string): IUIDirective {\n        const ui: IUIDirective = {};\n\n        // Labeling\n        if (swaggerProp.title) {\n            ui.label = swaggerProp.title;\n        } else if (swaggerProp.description) {\n            ui.label = swaggerProp.description;\n        } else {\n            ui.label = this.generateLabel(keyName);\n        }\n\n        // State\n        if (swaggerProp.readOnly === true) {\n            ui.readOnly = true;\n        }\n\n        // Formats to Widgets\n        if (swaggerProp.format) {\n            switch (swaggerProp.format) {\n                case \"date-time\":\n                    ui.widget = \"datetime\";\n                    break;\n                case \"date\":\n                    ui.widget = \"date\";\n                    break;\n                case \"password\":\n                    ui.format = \"password\";\n                    break;\n                case \"email\":\n                    ui.format = \"email\";\n                    break;\n                case \"uri\":\n                    ui.format = \"url\";\n                    break;\n                case \"uuid\":\n                case \"ipv4\":\n                case \"ipv6\":\n                case \"hostname\":\n                    if (!ui.validators) ui.validators = [];\n                    ui.validators.push(swaggerProp.format);\n                    break;\n            }\n        }\n\n        return ui;\n    }\n\n    /**\n     * Generates a human-readable Title Case label from camelCase or snake_case technical keys.\n     * \n     * @param {string} name The technical property key.\n     * @returns {string} The formatted human-readable label.\n     */\n    private static generateLabel(name: string): string {\n        if (!name) return \"\";\n        let spaced = name.replace(/([A-Z])/g, \" $1\").replace(/_/g, \" \");\n        return spaced.split(' ')\n            .filter(w => w.length > 0)\n            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n            .join(' ')\n            .trim();\n    }\n}\n"],"mappings":"yCAMO,MAAMA,EAUT,YAAcC,CAAMC,EAAkBC,GAClC,MAAMC,EAAmB,CAAC,EAG1B,GAAIF,EAAYG,MAAO,CACnBD,EAAGE,MAAQJ,EAAYG,KAC3B,MAAO,GAAIH,EAAYK,YAAa,CAChCH,EAAGE,MAAQJ,EAAYK,WAC3B,KAAO,CACHH,EAAGE,MAAQE,KAAKC,cAAcN,EAClC,CAGA,GAAID,EAAYQ,WAAa,KAAM,CAC/BN,EAAGM,SAAW,IAClB,CAGA,GAAIR,EAAYS,OAAQ,CACpB,OAAQT,EAAYS,QAChB,IAAK,YACDP,EAAGQ,OAAS,WACZ,MACJ,IAAK,OACDR,EAAGQ,OAAS,OACZ,MACJ,IAAK,WACDR,EAAGO,OAAS,WACZ,MACJ,IAAK,QACDP,EAAGO,OAAS,QACZ,MACJ,IAAK,MACDP,EAAGO,OAAS,MACZ,MACJ,IAAK,OACL,IAAK,OACL,IAAK,OACL,IAAK,WACD,IAAKP,EAAGS,WAAYT,EAAGS,WAAa,GACpCT,EAAGS,WAAWC,KAAKZ,EAAYS,QAC/B,MAEZ,CAEA,OAAOP,CACX,CAQA,oBAAeK,CAAcM,GACzB,IAAKA,EAAM,MAAO,GAClB,IAAIC,EAASD,EAAKE,QAAQ,WAAY,OAAOA,QAAQ,KAAM,KAC3D,OAAOD,EAAOE,MAAM,KACfC,OAAOC,GAAKA,EAAEC,OAAS,GACvBC,IAAIC,GAAQA,EAAKC,OAAO,GAAGC,cAAgBF,EAAKG,MAAM,GAAGC,eACzDC,KAAK,KACLC,MACT,EACH,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAA9B,kBAAA,OAAA8B,CAAA","ignoreList":[]}

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

@@ -0,0 +1,80 @@
+/**
+ * @file SwaggerUIMapper.ts
+ * @description Utility class for mapping OpenAPI properties and formats into MetaUI IUIDirectives.
+ */
+import { IUIDirective } from "../interfaces/ISchema";
+
+export class SwaggerUIMapper {
+    /**
+     * Evaluates an OpenAPI property definition and constructs a MetaUI IUIDirective block.
+     * Extracts labels from title/description, maps readOnly state, and assigns 
+     * specific Fiori widgets based on the OpenAPI 'format' property.
+     * 
+     * @param {any} swaggerProp The raw OpenAPI property schema.
+     * @param {string} keyName The technical JSON key of the property.
+     * @returns {IUIDirective} The constructed MetaUI UI orchestration directive.
+     */
+    public static build(swaggerProp: any, keyName: string): IUIDirective {
+        const ui: IUIDirective = {};
+
+        // Labeling
+        if (swaggerProp.title) {
+            ui.label = swaggerProp.title;
+        } else if (swaggerProp.description) {
+            ui.label = swaggerProp.description;
+        } else {
+            ui.label = this.generateLabel(keyName);
+        }
+
+        // State
+        if (swaggerProp.readOnly === true) {
+            ui.readOnly = true;
+        }
+
+        // Formats to Widgets
+        if (swaggerProp.format) {
+            switch (swaggerProp.format) {
+                case "date-time":
+                    ui.widget = "datetime";
+                    break;
+                case "date":
+                    ui.widget = "date";
+                    break;
+                case "password":
+                    ui.format = "password";
+                    break;
+                case "email":
+                    ui.format = "email";
+                    break;
+                case "uri":
+                    ui.format = "url";
+                    break;
+                case "uuid":
+                case "ipv4":
+                case "ipv6":
+                case "hostname":
+                    if (!ui.validators) ui.validators = [];
+                    ui.validators.push(swaggerProp.format);
+                    break;
+            }
+        }
+
+        return ui;
+    }
+
+    /**
+     * Generates a human-readable Title Case label from camelCase or snake_case technical keys.
+     * 
+     * @param {string} name The technical property key.
+     * @returns {string} The formatted human-readable label.
+     */
+    private static generateLabel(name: string): string {
+        if (!name) return "";
+        let spaced = name.replace(/([A-Z])/g, " $1").replace(/_/g, " ");
+        return spaced.split(' ')
+            .filter(w => w.length > 0)
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+            .join(' ')
+            .trim();
+    }
+}