From 18ee9f0866f16e71fba235a001ddc82d9c1ad151 Mon Sep 17 00:00:00 2001
From: "Henry H. Andrews" <andrews_henry@yahoo.com>
Date: Sun, 20 Aug 2023 12:41:10 -0700
Subject: [PATCH] Fix 3.1 Path Item schema

Path Item Objects allow "$ref", and despite the syntactic overlap,
it is neither accurate nor semantically meaningful to parse
a Path Item Object as a Reference Object, even if such parsing
would be successful.
---
 schemas/v3.1/schema.yaml | 19 ++++++-------------
 1 file changed, 6 insertions(+), 13 deletions(-)

diff --git a/schemas/v3.1/schema.yaml b/schemas/v3.1/schema.yaml
index 92b8d52c26..82973b1221 100644
--- a/schemas/v3.1/schema.yaml
+++ b/schemas/v3.1/schema.yaml
@@ -25,7 +25,7 @@ properties:
   webhooks:
     type: object
     additionalProperties:
-      $ref: '#/$defs/path-item-or-reference'
+      $ref: '#/$defs/path-item'
   components:
     $ref: '#/$defs/components'
   security:
@@ -192,7 +192,7 @@ $defs:
       pathItems:
         type: object
         additionalProperties:
-          $ref: '#/$defs/path-item-or-reference'
+          $ref: '#/$defs/path-item'
     patternProperties:
       '^(schemas|responses|parameters|examples|requestBodies|headers|securitySchemes|links|callbacks|pathItems)$':
         $comment: Enumerating all of the property names in the regex above is necessary for unevaluatedProperties to work as expected
@@ -214,6 +214,9 @@ $defs:
     $comment: https://spec.openapis.org/oas/v3.1.0#path-item-object
     type: object
     properties:
+      $ref:
+        type: string
+        format: uri-reference
       summary:
         type: string
       description:
@@ -245,16 +248,6 @@ $defs:
     $ref: '#/$defs/specification-extensions'
     unevaluatedProperties: false
 
-  path-item-or-reference:
-    if:
-      type: object
-      required:
-        - $ref
-    then:
-      $ref: '#/$defs/reference'
-    else:
-      $ref: '#/$defs/path-item'
-
   operation:
     $comment: https://spec.openapis.org/oas/v3.1.0#operation-object
     type: object
@@ -617,7 +610,7 @@ $defs:
     type: object
     $ref: '#/$defs/specification-extensions'
     additionalProperties:
-      $ref: '#/$defs/path-item-or-reference'
+      $ref: '#/$defs/path-item'
 
   callbacks-or-reference:
     if: