feat: Add new endpoints for allOf with nested array items and properties in OpenAPI schema

Author: dsuket

demo/examples/tests/allOf.yaml

@@ -367,6 +367,98 @@ paths:
                       otherOuterProp:
                         type: string
 
+  /allof-nested-array-items:
+    get:
+      tags:
+        - allOf
+      summary: allOf with Nested Array Items
+      description: |
+        A list of books demonstrating allOf with nested items as children.
+
+        Schema:
+        ```yaml
+        type: array
+        items:
+          type: object
+          properties:
+            books:
+              type: array
+              items:
+                $ref: '#/components/schemas/Book'
+            pagination:
+              type: object
+              properties:
+                page_number:
+                  type: integer
+                page_size:
+                  type: integer
+        ```
+      responses:
+        "200":
+          description: A list of books with pagination
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  books:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/Book"
+                  pagination:
+                    type: object
+                    properties:
+                      page_number:
+                        type: integer
+                      page_size:
+                        type: integer
+
+  /allof-nested-array-with-properties:
+    get:
+      tags:
+        - allOf
+      summary: allOf in Nested Array with Properties
+      description: |
+        A list of books demonstrating allOf with nested array with properties.
+
+        Schema:
+        ```yaml
+        type: array
+        items:
+          type: object
+          properties:
+            books:
+              type: array
+              items:
+                $ref: '#/components/schemas/CategorizedBook'
+            pagination:
+              type: object
+              properties:
+                page_number:
+                  type: integer
+                page_size:
+                  type: integer
+        ```
+      responses:
+        "200":
+          description: A list of books
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  books:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/CategorizedBook"
+                  pagination:
+                    type: object
+                    properties:
+                      page_number:
+                        type: integer
+                      page_size:
+                        type: integer
+
 components:
   schemas:
     # Your existing schemas are integrated here.

packages/docusaurus-theme-openapi-docs/lib/theme/Schema/index.js

@@ -625,6 +625,16 @@ const SchemaEdge = ({ name, schema, required, discriminator, schemaType }) => {
       schemaType: schemaType,
     });
   }
+  if (schema.items?.allOf) {
+    return react_1.default.createElement(SchemaNodeDetails, {
+      name: name,
+      schemaName: schemaName,
+      required: required,
+      nullable: schema.nullable,
+      schema: schema,
+      schemaType: schemaType,
+    });
+  }
   if (schema.allOf) {
     // handle circular properties
     if (
@@ -677,7 +687,7 @@ const SchemaEdge = ({ name, schema, required, discriminator, schemaType }) => {
       });
     }
     if (mergedSchemas.items?.properties) {
-      react_1.default.createElement(SchemaNodeDetails, {
+      return react_1.default.createElement(SchemaNodeDetails, {
         name: name,
         schemaName: mergedSchemaName,
         required: Array.isArray(mergedSchemas.required)

packages/docusaurus-theme-openapi-docs/src/theme/Schema/index.tsx

@@ -685,6 +685,19 @@ const SchemaEdge: React.FC<SchemaEdgeProps> = ({
     );
   }
 
+  if (schema.items?.allOf) {
+    return (
+      <SchemaNodeDetails
+        name={name}
+        schemaName={schemaName}
+        required={required}
+        nullable={schema.nullable}
+        schema={schema}
+        schemaType={schemaType}
+      />
+    );
+  }
+
   if (schema.allOf) {
     // handle circular properties
     if (
@@ -754,18 +767,20 @@ const SchemaEdge: React.FC<SchemaEdgeProps> = ({
     }
 
     if (mergedSchemas.items?.properties) {
-      <SchemaNodeDetails
-        name={name}
-        schemaName={mergedSchemaName}
-        required={
-          Array.isArray(mergedSchemas.required)
-            ? mergedSchemas.required.includes(name)
-            : mergedSchemas.required
-        }
-        nullable={mergedSchemas.nullable}
-        schema={mergedSchemas}
-        schemaType={schemaType}
-      />;
+      return (
+        <SchemaNodeDetails
+          name={name}
+          schemaName={mergedSchemaName}
+          required={
+            Array.isArray(mergedSchemas.required)
+              ? mergedSchemas.required.includes(name)
+              : mergedSchemas.required
+          }
+          nullable={mergedSchemas.nullable}
+          schema={mergedSchemas}
+          schemaType={schemaType}
+        />
+      );
     }
 
     return (