work on typename exposure

Author: Mpdreamz

Directory.Packages.props

@@ -42,7 +42,7 @@
     <PackageVersion Include="Markdig" Version="0.41.1" />
     <PackageVersion Include="NetEscapades.EnumGenerators" Version="1.0.0-beta12" PrivateAssets="all" ExcludeAssets="runtime" />
     <PackageVersion Include="Proc" Version="0.9.1" />
-    <PackageVersion Include="RazorSlices" Version="0.9.0" />
+    <PackageVersion Include="RazorSlices" Version="0.9.2" />
     <PackageVersion Include="Samboy063.Tomlet" Version="6.0.0" />
     <PackageVersion Include="Slugify.Core" Version="4.0.1" />
     <PackageVersion Include="SoftCircuits.IniFileParser" Version="2.7.0" />

src/Elastic.ApiExplorer/Operations/OperationView.cshtml

@@ -1,10 +1,59 @@
 @using Elastic.ApiExplorer.Landing
 @using Elastic.ApiExplorer.Operations
 @using Microsoft.OpenApi.Models
+@using Microsoft.OpenApi.Models.Interfaces
 @inherits RazorSliceHttpResult<Elastic.ApiExplorer.Operations.OperationViewModel>
 @implements IUsesLayout<Elastic.ApiExplorer._Layout, GlobalLayoutViewModel>
 @functions {
 	public GlobalLayoutViewModel LayoutModel => Model.CreateGlobalLayoutModel();
+
+	public string GetTypeName(JsonSchemaType? type)
+	{
+		var typeName = "";
+		if (type is null)
+			return "unknown and null";
+
+		if (type.Value.HasFlag(JsonSchemaType.Boolean))
+			typeName = "boolean";
+		else if (type.Value.HasFlag(JsonSchemaType.Integer))
+			typeName = "integer";
+		else if (type.Value.HasFlag(JsonSchemaType.String))
+			typeName = "string";
+		else if (type.Value.HasFlag(JsonSchemaType.Object))
+		{
+			typeName = "object";
+		}
+		else if (type.Value.HasFlag(JsonSchemaType.Null))
+			typeName = "null";
+		else if (type.Value.HasFlag(JsonSchemaType.Number))
+			typeName = "number";
+		else
+		{
+		}
+
+		if (type.Value.HasFlag(JsonSchemaType.Array))
+			typeName += " array";
+		return typeName;
+	}
+
+	public string GetTypeName(IOpenApiSchema propertyValue)
+	{
+		var typeName = string.Empty;
+		if (propertyValue.Type is not null)
+		{
+			typeName = GetTypeName(propertyValue.Type);
+			if (typeName is not "object" and not "array")
+				return typeName;
+		}
+
+		if (propertyValue.Schema is not null)
+			return propertyValue.Schema;
+
+		if (propertyValue.Enum is { Count: >0 } e)
+			return "enum";
+
+		return $"unknown value {typeName}";
+	}
 }
 @{
 	var self = Model.CurrentNavigationItem as OperationNavigationItem;
@@ -72,15 +121,26 @@
 	@if (operation.RequestBody is not null)
 	{
 		<h3>Request Body</h3>
+		var content = operation.RequestBody.Content.FirstOrDefault().Value;
 		if (!string.IsNullOrEmpty(operation.RequestBody.Description))
 		{
 			<p>@operation.RequestBody.Description</p>
 		}
+
+		if (content.Schema is not null)
+		{
 		<dl>
-			@foreach (var path in operation.RequestBody.Content)
+			@foreach (var property in content.Schema.Properties)
 			{
+				if (property.Value.Type is null)
+				{
+
+				}
+				<dt id="@property.Key"><a href="#@property.Key"><code>@property.Key</code> @GetTypeName(property.Value) </a></dt>
+				<dd>@Model.RenderMarkdown(property.Value.Description)</dd>
 			}
 		</dl>
+		}
 	}
 </section>
 <aside>

src/tooling/Directory.Build.props

@@ -9,6 +9,7 @@
 
     <!-- TODO ENABLE to document our code properly <GenerateDocumentationFile>true</GenerateDocumentationFile> -->
     <PublishRepositoryUrl>true</PublishRepositoryUrl>
+
   </PropertyGroup>
 
   <ItemGroup Condition="'$(OutputType)' == 'Exe'">
@@ -17,4 +18,4 @@
     <Content Include="$(SolutionRoot)\NOTICE.txt" Pack="True" PackagePath="NOTICE.txt" CopyToOutputDirectory="PreserveNewest" CopyToPublishDirectory="PreserveNewest"/>
   </ItemGroup>
 
-</Project>
+</Project>

src/tooling/docs-builder/Http/ReloadGeneratorService.cs

@@ -1,6 +1,7 @@
 // Licensed to Elasticsearch B.V under one or more agreements.
 // Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
 // See the LICENSE file in the project root for more information
+
 using Microsoft.Extensions.Hosting;
 using Microsoft.Extensions.Logging;
 
@@ -25,12 +26,12 @@ public async Task StartAsync(Cancel cancellationToken)
 		var watcher = new FileSystemWatcher(ReloadableGenerator.Generator.DocumentationSet.SourceDirectory.FullName)
 		{
 			NotifyFilter = NotifyFilters.Attributes
-							   | NotifyFilters.CreationTime
-							   | NotifyFilters.DirectoryName
-							   | NotifyFilters.FileName
-							   | NotifyFilters.LastWrite
-							   | NotifyFilters.Security
-							   | NotifyFilters.Size
+			               | NotifyFilters.CreationTime
+			               | NotifyFilters.DirectoryName
+			               | NotifyFilters.FileName
+			               | NotifyFilters.LastWrite
+			               | NotifyFilters.Security
+			               | NotifyFilters.Size
 		};
 
 		watcher.Changed += OnChanged;
@@ -144,5 +145,4 @@ public async Task ExecuteAsync(Func<Cancel, Task> innerAction, Cancel cancellati
 
 		public void Dispose() => _semaphore.Dispose();
 	}
-
 }