docs-util: collapse types in references (#11888)

* docs-util: collapse types in references

* improve for arrays

www/utils/packages/typedoc-plugin-markdown-medusa/src/utils/reflection-type-parameters.ts

@@ -108,14 +108,27 @@ export function getReflectionTypeParameters({
             return
           }
 
-          componentItem[parentKey - 1].children?.push(
+          const reflectionTypeParameters = getReflectionTypeParameters({
-            ...getReflectionTypeParameters({
             reflectionType: reflectionTypeArg,
             project,
             level: level + 1,
             maxLevel,
             isReturn: false,
           })
+
+          if (
+            typeArgs.length === 1 &&
+            reflectionTypeArg.type === "reference" &&
+            reflectionTypeParameters.length === 1
+          ) {
+            componentItem[parentKey - 1].children?.push(
+              ...(reflectionTypeParameters[0].children || [])
+            )
+            return
+          }
+
+          componentItem[parentKey - 1].children?.push(
+            ...reflectionTypeParameters
           )
         })
       }
@@ -172,12 +185,21 @@ export function getReflectionTypeParameters({
       const elementTypeItem = getReflectionTypeParameters({
         reflectionType: reflectionType.elementType,
         project,
-        level: level + 1,
+        level,
         maxLevel,
         isReturn: false,
       })
+      if (
+        reflectionType.elementType.type === "reference" &&
+        elementTypeItem.length === 1
+      ) {
+        componentItem[parentKey - 1].children?.push(
+          ...(elementTypeItem[0].children || [])
+        )
+      } else {
         componentItem[parentKey - 1].children?.push(...elementTypeItem)
       }
+    }
   } else if (reflectionType.type === "tuple") {
     let pushTo: Parameter[] = []
     if (level === 1) {