Add test and update API surface

MaggieKimani1 · MaggieKimani1 · commit 733185f4ea2b · 2025-01-20T11:15:23.000+03:00
diff --git a/test/Microsoft.OpenApi.Tests/Models/References/OpenApiHeaderReferenceTests.cs b/test/Microsoft.OpenApi.Tests/Models/References/OpenApiHeaderReferenceTests.cs
@@ -19,7 +19,7 @@ namespace Microsoft.OpenApi.Tests.Models.References
     public class OpenApiHeaderReferenceTests
     {
         // OpenApi doc with external $ref
-        private const string OpenApi= @"
+        private const string OpenApi = @"
 openapi: 3.0.0
 info:
   title: Sample API
@@ -149,7 +149,7 @@ public async Task SerializeHeaderReferenceAsV2JsonWorksAsync(bool produceTerseOu
         {
             // Arrange
             var outputStringWriter = new StringWriter(CultureInfo.InvariantCulture);
-            var writer = new OpenApiJsonWriter(outputStringWriter, new OpenApiJsonWriterSettings { Terse = produceTerseOutput, InlineLocalReferences = true});
+            var writer = new OpenApiJsonWriter(outputStringWriter, new OpenApiJsonWriterSettings { Terse = produceTerseOutput, InlineLocalReferences = true });
 
             // Act
             _localHeaderReference.SerializeAsV2(writer);
@@ -158,5 +158,34 @@ public async Task SerializeHeaderReferenceAsV2JsonWorksAsync(bool produceTerseOu
             // Assert
             await Verifier.Verify(outputStringWriter).UseParameters(produceTerseOutput);
         }
+
+        [Fact]
+        public void OpenApiHeaderTargetShouldResolveReference()
+        {
+            var doc = new OpenApiDocument
+            {
+                Components = new OpenApiComponents
+                {
+                    Headers = new System.Collections.Generic.Dictionary<string, OpenApiHeader>
+                    {
+                        { "header1", new OpenApiHeader
+                            {
+                                Description = "test header",
+                                Schema = new OpenApiSchema
+                                {
+                                    Type = JsonSchemaType.String
+                                }
+                            }
+                        }
+                    }
+                }
+            };
+
+            doc.Workspace.RegisterComponents(doc);
+
+            var headerReference = new OpenApiHeaderReference("header1", doc);
+            Assert.Equal("test header", headerReference.Description);
+            Assert.Equal(JsonSchemaType.String, headerReference.Schema.Type);
+        }
     }
 }
diff --git a/test/Microsoft.OpenApi.Tests/PublicApi/PublicApi.approved.txt b/test/Microsoft.OpenApi.Tests/PublicApi/PublicApi.approved.txt
@@ -222,6 +222,10 @@ namespace Microsoft.OpenApi.Interfaces
         Microsoft.OpenApi.Models.OpenApiReference Reference { get; set; }
         bool UnresolvedReference { get; set; }
     }
+    public interface IOpenApiReferenceableWithTarget<T> : Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiSerializable
+    {
+        T Target { get; }
+    }
     public interface IOpenApiSerializable : Microsoft.OpenApi.Interfaces.IOpenApiElement
     {
         void SerializeAsV2(Microsoft.OpenApi.Writers.IOpenApiWriter writer);
@@ -1095,17 +1099,19 @@ namespace Microsoft.OpenApi.Models
 }
 namespace Microsoft.OpenApi.Models.References
 {
-    public class OpenApiCallbackReference : Microsoft.OpenApi.Models.OpenApiCallback
+    public class OpenApiCallbackReference : Microsoft.OpenApi.Models.OpenApiCallback, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiCallback>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable
     {
         public OpenApiCallbackReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }
+        public Microsoft.OpenApi.Models.OpenApiCallback Target { get; }
         public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension> Extensions { get; set; }
         public override System.Collections.Generic.Dictionary<Microsoft.OpenApi.Expressions.RuntimeExpression, Microsoft.OpenApi.Models.OpenApiPathItem> PathItems { get; set; }
         public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
         public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
     }
-    public class OpenApiExampleReference : Microsoft.OpenApi.Models.OpenApiExample
+    public class OpenApiExampleReference : Microsoft.OpenApi.Models.OpenApiExample, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiExample>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable
     {
         public OpenApiExampleReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }
+        public Microsoft.OpenApi.Models.OpenApiExample Target { get; }
         public override string Description { get; set; }
         public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension> Extensions { get; set; }
         public override string ExternalValue { get; set; }
@@ -1114,9 +1120,10 @@ namespace Microsoft.OpenApi.Models.References
         public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
         public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
     }
-    public class OpenApiHeaderReference : Microsoft.OpenApi.Models.OpenApiHeader
+    public class OpenApiHeaderReference : Microsoft.OpenApi.Models.OpenApiHeader, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiHeader>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable
     {
         public OpenApiHeaderReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }
+        public Microsoft.OpenApi.Models.OpenApiHeader Target { get; }
         public override bool AllowEmptyValue { get; set; }
         public override bool AllowReserved { get; set; }
         public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Models.OpenApiMediaType> Content { get; set; }
@@ -1133,9 +1140,10 @@ namespace Microsoft.OpenApi.Models.References
         public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
         public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
     }
-    public class OpenApiLinkReference : Microsoft.OpenApi.Models.OpenApiLink
+    public class OpenApiLinkReference : Microsoft.OpenApi.Models.OpenApiLink, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiLink>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable
     {
         public OpenApiLinkReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }
+        public Microsoft.OpenApi.Models.OpenApiLink Target { get; }
         public override string Description { get; set; }
         public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension> Extensions { get; set; }
         public override string OperationId { get; set; }
@@ -1146,9 +1154,10 @@ namespace Microsoft.OpenApi.Models.References
         public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
         public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
     }
-    public class OpenApiParameterReference : Microsoft.OpenApi.Models.OpenApiParameter
+    public class OpenApiParameterReference : Microsoft.OpenApi.Models.OpenApiParameter, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiParameter>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable
     {
         public OpenApiParameterReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }
+        public Microsoft.OpenApi.Models.OpenApiParameter Target { get; }
         public override bool AllowEmptyValue { get; set; }
         public override bool AllowReserved { get; set; }
         public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Models.OpenApiMediaType> Content { get; set; }
@@ -1167,9 +1176,10 @@ namespace Microsoft.OpenApi.Models.References
         public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
         public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
     }
-    public class OpenApiPathItemReference : Microsoft.OpenApi.Models.OpenApiPathItem
+    public class OpenApiPathItemReference : Microsoft.OpenApi.Models.OpenApiPathItem, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiPathItem>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable
     {
         public OpenApiPathItemReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }
+        public Microsoft.OpenApi.Models.OpenApiPathItem Target { get; }
         public override string Description { get; set; }
         public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension> Extensions { get; set; }
         public override System.Collections.Generic.IDictionary<Microsoft.OpenApi.Models.OperationType, Microsoft.OpenApi.Models.OpenApiOperation> Operations { get; set; }
@@ -1178,19 +1188,21 @@ namespace Microsoft.OpenApi.Models.References
         public override string Summary { get; set; }
         public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
     }
-    public class OpenApiRequestBodyReference : Microsoft.OpenApi.Models.OpenApiRequestBody
+    public class OpenApiRequestBodyReference : Microsoft.OpenApi.Models.OpenApiRequestBody, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiRequestBody>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable
     {
         public OpenApiRequestBodyReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }
+        public Microsoft.OpenApi.Models.OpenApiRequestBody Target { get; }
         public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Models.OpenApiMediaType> Content { get; set; }
         public override string Description { get; set; }
         public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension> Extensions { get; set; }
         public override bool Required { get; set; }
         public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
         public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
     }
-    public class OpenApiResponseReference : Microsoft.OpenApi.Models.OpenApiResponse
+    public class OpenApiResponseReference : Microsoft.OpenApi.Models.OpenApiResponse, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiResponse>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable
     {
         public OpenApiResponseReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }
+        public Microsoft.OpenApi.Models.OpenApiResponse Target { get; }
         public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Models.OpenApiMediaType> Content { get; set; }
         public override string Description { get; set; }
         public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension> Extensions { get; set; }
@@ -1200,7 +1212,7 @@ namespace Microsoft.OpenApi.Models.References
         public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
         public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
     }
-    public class OpenApiSchemaReference : Microsoft.OpenApi.Models.OpenApiSchema
+    public class OpenApiSchemaReference : Microsoft.OpenApi.Models.OpenApiSchema, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiSchema>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable
     {
         public OpenApiSchemaReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }
         public Microsoft.OpenApi.Models.OpenApiSchema? Target { get; }
@@ -1259,9 +1271,10 @@ namespace Microsoft.OpenApi.Models.References
         public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
         public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
     }
-    public class OpenApiSecuritySchemeReference : Microsoft.OpenApi.Models.OpenApiSecurityScheme
+    public class OpenApiSecuritySchemeReference : Microsoft.OpenApi.Models.OpenApiSecurityScheme, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiSecurityScheme>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable
     {
         public OpenApiSecuritySchemeReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }
+        public Microsoft.OpenApi.Models.OpenApiSecurityScheme Target { get; }
         public override string BearerFormat { get; set; }
         public override string Description { get; set; }
         public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension> Extensions { get; set; }
@@ -1275,7 +1288,7 @@ namespace Microsoft.OpenApi.Models.References
         public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
         public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }
     }
-    public class OpenApiTagReference : Microsoft.OpenApi.Models.OpenApiTag, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiSerializable
+    public class OpenApiTagReference : Microsoft.OpenApi.Models.OpenApiTag, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiTag>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable
     {
         public OpenApiTagReference(Microsoft.OpenApi.Models.References.OpenApiTagReference source) { }
         public OpenApiTagReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument) { }

Original file line number	Diff line number	Diff line change
`@@ -222,6 +222,10 @@ namespace Microsoft.OpenApi.Interfaces`
`222`	`222`	`Microsoft.OpenApi.Models.OpenApiReference Reference { get; set; }`
`223`	`223`	`bool UnresolvedReference { get; set; }`
`224`	`224`	`}`
	`225`	`+ public interface IOpenApiReferenceableWithTarget<T> : Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiSerializable`
	`226`	`+ {`
	`227`	`+ T Target { get; }`
	`228`	`+ }`
`225`	`229`	`public interface IOpenApiSerializable : Microsoft.OpenApi.Interfaces.IOpenApiElement`
`226`	`230`	`{`
`227`	`231`	`void SerializeAsV2(Microsoft.OpenApi.Writers.IOpenApiWriter writer);`
`@@ -1095,17 +1099,19 @@ namespace Microsoft.OpenApi.Models`
`1095`	`1099`	`}`
`1096`	`1100`	`namespace Microsoft.OpenApi.Models.References`
`1097`	`1101`	`{`
`1098`		`- public class OpenApiCallbackReference : Microsoft.OpenApi.Models.OpenApiCallback`
	`1102`	`+ public class OpenApiCallbackReference : Microsoft.OpenApi.Models.OpenApiCallback, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiCallback>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable`
`1099`	`1103`	`{`
`1100`	`1104`	`public OpenApiCallbackReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }`
	`1105`	`+ public Microsoft.OpenApi.Models.OpenApiCallback Target { get; }`
`1101`	`1106`	`public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension> Extensions { get; set; }`
`1102`	`1107`	`public override System.Collections.Generic.Dictionary<Microsoft.OpenApi.Expressions.RuntimeExpression, Microsoft.OpenApi.Models.OpenApiPathItem> PathItems { get; set; }`
`1103`	`1108`	`public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1104`	`1109`	`public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1105`	`1110`	`}`
`1106`		`- public class OpenApiExampleReference : Microsoft.OpenApi.Models.OpenApiExample`
	`1111`	`+ public class OpenApiExampleReference : Microsoft.OpenApi.Models.OpenApiExample, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiExample>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable`
`1107`	`1112`	`{`
`1108`	`1113`	`public OpenApiExampleReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }`
	`1114`	`+ public Microsoft.OpenApi.Models.OpenApiExample Target { get; }`
`1109`	`1115`	`public override string Description { get; set; }`
`1110`	`1116`	`public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension> Extensions { get; set; }`
`1111`	`1117`	`public override string ExternalValue { get; set; }`
`@@ -1114,9 +1120,10 @@ namespace Microsoft.OpenApi.Models.References`
`1114`	`1120`	`public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1115`	`1121`	`public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1116`	`1122`	`}`
`1117`		`- public class OpenApiHeaderReference : Microsoft.OpenApi.Models.OpenApiHeader`
	`1123`	`+ public class OpenApiHeaderReference : Microsoft.OpenApi.Models.OpenApiHeader, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiHeader>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable`
`1118`	`1124`	`{`
`1119`	`1125`	`public OpenApiHeaderReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }`
	`1126`	`+ public Microsoft.OpenApi.Models.OpenApiHeader Target { get; }`
`1120`	`1127`	`public override bool AllowEmptyValue { get; set; }`
`1121`	`1128`	`public override bool AllowReserved { get; set; }`
`1122`	`1129`	`public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Models.OpenApiMediaType> Content { get; set; }`
`@@ -1133,9 +1140,10 @@ namespace Microsoft.OpenApi.Models.References`
`1133`	`1140`	`public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1134`	`1141`	`public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1135`	`1142`	`}`
`1136`		`- public class OpenApiLinkReference : Microsoft.OpenApi.Models.OpenApiLink`
	`1143`	`+ public class OpenApiLinkReference : Microsoft.OpenApi.Models.OpenApiLink, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiLink>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable`
`1137`	`1144`	`{`
`1138`	`1145`	`public OpenApiLinkReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }`
	`1146`	`+ public Microsoft.OpenApi.Models.OpenApiLink Target { get; }`
`1139`	`1147`	`public override string Description { get; set; }`
`1140`	`1148`	`public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension> Extensions { get; set; }`
`1141`	`1149`	`public override string OperationId { get; set; }`
`@@ -1146,9 +1154,10 @@ namespace Microsoft.OpenApi.Models.References`
`1146`	`1154`	`public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1147`	`1155`	`public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1148`	`1156`	`}`
`1149`		`- public class OpenApiParameterReference : Microsoft.OpenApi.Models.OpenApiParameter`
	`1157`	`+ public class OpenApiParameterReference : Microsoft.OpenApi.Models.OpenApiParameter, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiParameter>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable`
`1150`	`1158`	`{`
`1151`	`1159`	`public OpenApiParameterReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }`
	`1160`	`+ public Microsoft.OpenApi.Models.OpenApiParameter Target { get; }`
`1152`	`1161`	`public override bool AllowEmptyValue { get; set; }`
`1153`	`1162`	`public override bool AllowReserved { get; set; }`
`1154`	`1163`	`public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Models.OpenApiMediaType> Content { get; set; }`
`@@ -1167,9 +1176,10 @@ namespace Microsoft.OpenApi.Models.References`
`1167`	`1176`	`public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1168`	`1177`	`public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1169`	`1178`	`}`
`1170`		`- public class OpenApiPathItemReference : Microsoft.OpenApi.Models.OpenApiPathItem`
	`1179`	`+ public class OpenApiPathItemReference : Microsoft.OpenApi.Models.OpenApiPathItem, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiPathItem>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable`
`1171`	`1180`	`{`
`1172`	`1181`	`public OpenApiPathItemReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }`
	`1182`	`+ public Microsoft.OpenApi.Models.OpenApiPathItem Target { get; }`
`1173`	`1183`	`public override string Description { get; set; }`
`1174`	`1184`	`public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension> Extensions { get; set; }`
`1175`	`1185`	`public override System.Collections.Generic.IDictionary<Microsoft.OpenApi.Models.OperationType, Microsoft.OpenApi.Models.OpenApiOperation> Operations { get; set; }`
`@@ -1178,19 +1188,21 @@ namespace Microsoft.OpenApi.Models.References`
`1178`	`1188`	`public override string Summary { get; set; }`
`1179`	`1189`	`public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1180`	`1190`	`}`
`1181`		`- public class OpenApiRequestBodyReference : Microsoft.OpenApi.Models.OpenApiRequestBody`
	`1191`	`+ public class OpenApiRequestBodyReference : Microsoft.OpenApi.Models.OpenApiRequestBody, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiRequestBody>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable`
`1182`	`1192`	`{`
`1183`	`1193`	`public OpenApiRequestBodyReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }`
	`1194`	`+ public Microsoft.OpenApi.Models.OpenApiRequestBody Target { get; }`
`1184`	`1195`	`public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Models.OpenApiMediaType> Content { get; set; }`
`1185`	`1196`	`public override string Description { get; set; }`
`1186`	`1197`	`public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension> Extensions { get; set; }`
`1187`	`1198`	`public override bool Required { get; set; }`
`1188`	`1199`	`public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1189`	`1200`	`public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1190`	`1201`	`}`
`1191`		`- public class OpenApiResponseReference : Microsoft.OpenApi.Models.OpenApiResponse`
	`1202`	`+ public class OpenApiResponseReference : Microsoft.OpenApi.Models.OpenApiResponse, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiResponse>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable`
`1192`	`1203`	`{`
`1193`	`1204`	`public OpenApiResponseReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }`
	`1205`	`+ public Microsoft.OpenApi.Models.OpenApiResponse Target { get; }`
`1194`	`1206`	`public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Models.OpenApiMediaType> Content { get; set; }`
`1195`	`1207`	`public override string Description { get; set; }`
`1196`	`1208`	`public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension> Extensions { get; set; }`
`@@ -1200,7 +1212,7 @@ namespace Microsoft.OpenApi.Models.References`
`1200`	`1212`	`public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1201`	`1213`	`public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1202`	`1214`	`}`
`1203`		`- public class OpenApiSchemaReference : Microsoft.OpenApi.Models.OpenApiSchema`
	`1215`	`+ public class OpenApiSchemaReference : Microsoft.OpenApi.Models.OpenApiSchema, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiSchema>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable`
`1204`	`1216`	`{`
`1205`	`1217`	`public OpenApiSchemaReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }`
`1206`	`1218`	`public Microsoft.OpenApi.Models.OpenApiSchema? Target { get; }`
`@@ -1259,9 +1271,10 @@ namespace Microsoft.OpenApi.Models.References`
`1259`	`1271`	`public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1260`	`1272`	`public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1261`	`1273`	`}`
`1262`		`- public class OpenApiSecuritySchemeReference : Microsoft.OpenApi.Models.OpenApiSecurityScheme`
	`1274`	`+ public class OpenApiSecuritySchemeReference : Microsoft.OpenApi.Models.OpenApiSecurityScheme, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiSecurityScheme>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable`
`1263`	`1275`	`{`
`1264`	`1276`	`public OpenApiSecuritySchemeReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument, string externalResource = null) { }`
	`1277`	`+ public Microsoft.OpenApi.Models.OpenApiSecurityScheme Target { get; }`
`1265`	`1278`	`public override string BearerFormat { get; set; }`
`1266`	`1279`	`public override string Description { get; set; }`
`1267`	`1280`	`public override System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension> Extensions { get; set; }`
`@@ -1275,7 +1288,7 @@ namespace Microsoft.OpenApi.Models.References`
`1275`	`1288`	`public override void SerializeAsV3(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1276`	`1289`	`public override void SerializeAsV31(Microsoft.OpenApi.Writers.IOpenApiWriter writer) { }`
`1277`	`1290`	`}`
`1278`		`- public class OpenApiTagReference : Microsoft.OpenApi.Models.OpenApiTag, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiSerializable`
	`1291`	`+ public class OpenApiTagReference : Microsoft.OpenApi.Models.OpenApiTag, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReferenceable, Microsoft.OpenApi.Interfaces.IOpenApiReferenceableWithTarget<Microsoft.OpenApi.Models.OpenApiTag>, Microsoft.OpenApi.Interfaces.IOpenApiSerializable`
`1279`	`1292`	`{`
`1280`	`1293`	`public OpenApiTagReference(Microsoft.OpenApi.Models.References.OpenApiTagReference source) { }`
`1281`	`1294`	`public OpenApiTagReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument hostDocument) { }`