Merge branch 'refactor-createExample' into support-schema-property-examples

Author: dsuket

demo/examples/tests/examples.yaml

@@ -453,3 +453,39 @@ paths:
                     examples:
                       - true
                       - false
+
+  /response/schema/properties/multipleTypes/examples:
+    get:
+      tags:
+        - examples
+      summary: examples of schema properties with multiple types in response
+      description: "description of response schema properties with multiple types examples"
+      responses:
+        "200":
+          description: successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  name:
+                    type:
+                      - string
+                      - "null"
+                    examples:
+                      - "John Doe"
+                      - "Jane Smith"
+                  age:
+                    type:
+                      - number
+                      - "null"
+                    examples:
+                      - 25
+                      - 30
+                  isStudent:
+                    type:
+                      - boolean
+                      - "null"
+                    examples:
+                      - true
+                      - false

packages/docusaurus-plugin-openapi-docs/src/openapi/createSchemaExample.ts

@@ -234,14 +234,27 @@ function primitive(schema: SchemaObject = {}) {
     return;
   }
 
-  let fn = schema.default ? () => schema.default : primitives[type].default;
+  // If type is an array, use the first type
+  if (Array.isArray(type)) {
+    type = type[0];
+    if (type === undefined) {
+      return;
+    }
+  }
 
-  if (format !== undefined) {
-    fn = primitives[type][format] || fn;
+  // Use schema default if available, otherwise use type default
+  if (schema.default !== undefined) {
+    return schema.default;
   }
 
-  if (fn) {
-    return fn(schema);
+  const typeConfig = primitives[type];
+  if (typeConfig) {
+    if (format !== undefined && typeConfig[format] !== undefined) {
+      return typeConfig[format](schema);
+    }
+    if (typeConfig.default !== undefined) {
+      return typeConfig.default(schema);
+    }
   }
 
   return "Unknown Type: " + schema.type;