Render array props of discriminated objects

Author: andrii-balitskyi

src/layouts/partials/api-resource.hbs

@@ -48,7 +48,33 @@ This object has no properties.
 {{/each}}
 {{/if}}
 {{/unless}}
-{{#if listProperties}}
+{{#if discriminatorVariants}}
+  {{#if discriminatorVariants.length}}
+
+The items in this list are objects. The specific structure of each object depends on the value of its `{{discriminator}}` field. Each object will be one of the following variants:
+{% tabs %}
+  {{#each discriminatorVariants}}
+{% tab title="{{this.name}}" %}
+{{#if this.description}}
+
+{{this.description}}
+{{/if}}
+{{#if this.properties.length}}
+
+Variant Properties:
+  {{#each this.properties}}
+
+{{> property-collapsible this}}
+  {{/each}}
+{{else}}
+
+This variant has no additional specific properties.
+{{/if}}
+{% endtab %}
+  {{/each}}
+{% endtabs %}
+  {{/if}}
+{{else if listProperties}}
 {{#each listProperties}}
 
 {{> property-collapsible this}}

src/lib/layout/api-route.ts

@@ -41,6 +41,12 @@ type ApiRouteProperty = Pick<
   listItemFormat?: string
   linkTarget?: string
   value?: string
+  discriminator?: string
+  discriminatorVariants?: Array<{
+    name: string
+    description: string
+    properties: ApiRouteProperty[]
+  }>
 }
 
 export interface ApiRouteResource {
@@ -250,6 +256,27 @@ export const mapBlueprintPropertyToRouteProperty = (
     contextRouteProp.listItemFormat = normalizePropertyFormatForDocs(
       prop.itemFormat,
     )
+
+    if (prop.itemFormat === 'discriminated_object') {
+      const discriminatedListProp = prop
+      contextRouteProp.discriminator = discriminatedListProp.discriminator
+      contextRouteProp.discriminatorVariants =
+        discriminatedListProp.variants.map((variant) => {
+          const discriminatorProperty = variant.properties.find(
+            (p) => p.name === discriminatedListProp.discriminator,
+          )
+          const variantName =
+            (discriminatorProperty as EnumProperty)?.values?.[0]?.name ??
+            'unknown_variant'
+          return {
+            name: variantName,
+            description: variant.description,
+            properties: variant.properties
+              .filter((p) => !p.isUndocumented)
+              .map(mapBlueprintPropertyToRouteProperty),
+          }
+        })
+    }
   }
 
   return contextRouteProp