test: add schema.examples test cases

Adds test file demonstrating OpenAPI 3.1 schema.examples array support:
- Schema-level examples array
- Property-level examples arrays

Author: sserrata

demo/examples/tests/schemaExamples.yaml

@@ -0,0 +1,100 @@
+openapi: 3.1.0
+info:
+  title: Schema Examples API (OAS 3.1)
+  description: |
+    Demonstrates OpenAPI 3.1 schema.examples array support.
+    The example generator should use the first item from the examples array
+    when generating request/response examples.
+  version: 1.0.0
+tags:
+  - name: schemaExamples
+    description: OpenAPI 3.1 schema.examples tests
+paths:
+  /schema-examples:
+    post:
+      tags:
+        - schemaExamples
+      summary: Schema with examples array
+      description: |
+        The request body schema uses `examples` (array) instead of `example` (singular).
+        The API Explorer should show the first example from the array.
+
+        Schema:
+        ```yaml
+        schema:
+          type: object
+          properties:
+            name:
+              type: string
+            status:
+              type: string
+          examples:
+            - name: "John Doe"
+              status: "active"
+            - name: "Jane Smith"
+              status: "pending"
+        ```
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                name:
+                  type: string
+                status:
+                  type: string
+              examples:
+                - name: "John Doe"
+                  status: "active"
+                - name: "Jane Smith"
+                  status: "pending"
+      responses:
+        "200":
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  id:
+                    type: integer
+                  message:
+                    type: string
+                examples:
+                  - id: 1
+                    message: "Created successfully"
+                  - id: 2
+                    message: "Updated successfully"
+
+  /property-examples:
+    post:
+      tags:
+        - schemaExamples
+      summary: Properties with examples arrays
+      description: |
+        Individual properties use `examples` (array) instead of `example`.
+        The generated example should use the first item from each property's examples array.
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                email:
+                  type: string
+                  format: email
+                  examples:
+                    - "[email protected]"
+                    - "[email protected]"
+                role:
+                  type: string
+                  examples:
+                    - "user"
+                    - "admin"
+                    - "moderator"
+      responses:
+        "200":
+          description: Success