@midwayjs/swagger 3.3.14 → 3.4.0-beta.11

package/dist/interfaces/index.d.ts

@@ -336,5 +336,24 @@ export interface SwaggerOptions {
      * 可以使用 1-xxx、2-xxx、3-xxx 来定义 tag
      */
     tagSortable?: boolean;
+    /**
+     * UI 展示中需要用到的配置
+     * 可以参考 https://github.com/swagger-api/swagger-ui/blob/master/docs/usage/configuration.md#display
+     */
+    displayOptions?: {
+        deepLinking?: boolean;
+        displayOperationId?: boolean;
+        defaultModelsExpandDepth?: number;
+        defaultModelExpandDepth?: number;
+        defaultModelRendering?: 'example' | 'model';
+        displayRequestDuration?: boolean;
+        docExpansion?: 'list' | 'full' | 'none';
+        filter?: boolean | string;
+        maxDisplayedTags?: number;
+        showExtensions?: boolean;
+        showCommonExtensions?: boolean;
+        useUnsafeMarkdown?: boolean;
+        tryItOutEnabled?: boolean;
+    };
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/swaggerExplorer.js

@@ -381,7 +381,7 @@ let SwaggerExplorer = class SwaggerExplorer {
      * @param p
      */
     parseFromParamsToP(paramMeta, p) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c;
         if (paramMeta) {
             const param = paramMeta.metadata;
             if (param) {
@@ -392,7 +392,7 @@ let SwaggerExplorer = class SwaggerExplorer {
                 if (param.in === 'query') {
                     p.allowEmptyValue = param.allowEmptyValue || false;
                 }
-                if (param.example) {
+                if (typeof param.example !== undefined) {
                     p.example = param.example;
                 }
                 if (param.examples) {
@@ -432,13 +432,22 @@ let SwaggerExplorer = class SwaggerExplorer {
                             };
                         }
                         if (param.isArray) {
+                            let ref;
+                            if ((_c = p === null || p === void 0 ? void 0 : p.schema) === null || _c === void 0 ? void 0 : _c.$ref) {
+                                ref = p.schema.$ref;
+                            }
                             p.schema = {
                                 type: 'array',
                                 items: {
-                                    type: (_d = (_c = p === null || p === void 0 ? void 0 : p.schema) === null || _c === void 0 ? void 0 : _c.$ref) !== null && _d !== void 0 ? _d : convertSchemaType(param.type),
                                     format: param.format,
                                 },
                             };
+                            if (ref) {
+                                p.schema.items.$ref = ref;
+                            }
+                            else {
+                                p.schema.items.type = convertSchemaType(param.type);
+                            }
                         }
                         else {
                             if (!p.schema) {
@@ -492,7 +501,7 @@ let SwaggerExplorer = class SwaggerExplorer {
             Object.keys(props).forEach(key => {
                 var _a, _b;
                 const metadata = props[key].metadata;
-                if (metadata === null || metadata === void 0 ? void 0 : metadata.example) {
+                if (typeof (metadata === null || metadata === void 0 ? void 0 : metadata.example) !== undefined) {
                     if (!tt.example) {
                         tt.example = {};
                     }

package/dist/swaggerMiddleware.js

@@ -103,7 +103,13 @@ let SwaggerMiddleware = class SwaggerMiddleware {
         }
     }
     replaceInfo(content) {
-        return content.replace('"https://petstore.swagger.io/v2/swagger.json",', `location.href.replace('${this.swaggerConfig.swaggerPath}/index.html', '${this.swaggerConfig.swaggerPath}/index.json'),\n validatorUrl: null,`);
+        let str = `location.href.replace('${this.swaggerConfig.swaggerPath}/index.html', '${this.swaggerConfig.swaggerPath}/index.json'),\n validatorUrl: null,`;
+        if (this.swaggerConfig.displayOptions) {
+            Object.keys(this.swaggerConfig.displayOptions).forEach(key => {
+                str += `\n${key}: ${this.swaggerConfig.displayOptions[key]},`;
+            });
+        }
+        return content.replace('"https://petstore.swagger.io/v2/swagger.json",', str);
     }
     static getName() {
         return 'swagger';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midwayjs/swagger",
-  "version": "3.3.14",
+  "version": "3.4.0-beta.11",
   "main": "dist/index",
   "typings": "index.d.ts",
   "files": [
@@ -9,12 +9,12 @@
     "index.d.ts"
   ],
   "devDependencies": {
-    "@midwayjs/core": "^3.3.5",
-    "@midwayjs/decorator": "^3.3.4",
-    "@midwayjs/koa": "^3.3.6",
-    "@midwayjs/mock": "^3.3.5",
-    "@midwayjs/validate": "^3.3.11",
-    "swagger-ui-dist": "4.6.2"
+    "@midwayjs/core": "^3.4.0-beta.11",
+    "@midwayjs/decorator": "^3.4.0-beta.11",
+    "@midwayjs/koa": "^3.4.0-beta.11",
+    "@midwayjs/mock": "^3.4.0-beta.11",
+    "@midwayjs/validate": "^3.4.0-beta.11",
+    "swagger-ui-dist": "4.12.0"
   },
   "author": "Kurten Chan <chinkurten@gmail.com>",
   "license": "MIT",
@@ -28,5 +28,5 @@
     "type": "git",
     "url": "https://github.com/midwayjs/midway.git"
   },
-  "gitHead": "01bbc493f384e137751f250d3d0175773cfcabef"
+  "gitHead": "b1c7a439b0df37d3e381cd182ea3b9e74323107b"
 }