[INTERNAL] lib/processors/jsdoc: Simplify base type handling

Improved handling of compound types, including union types (e.g.,
string | boolean) and array notations (e.g., string[]).

This update ensures accurate and efficient identification of built-in
types, reducing the likelihood of incorrect links in documentation due
to unrecognized types.

Cherry-picked from UI5/openui5@2dc53cf86.

Author: codeworrior

lib/processors/jsdoc/lib/transformApiJson.js

@@ -1,4 +1,4 @@
-/*
+/**
  * Node script to preprocess api.json files for use in the UI5 SDKs.
  *
  * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
@@ -43,7 +43,7 @@ function fnCreateTypesArr(sTypes) {
 	});
 }
 
-/*
+/**
  * Transforms the api.json as created by the JSDoc build into a pre-processed api.json file suitable for the SDK.
  *
  * The pre-processing includes formatting of type references, rewriting of links and other time consuming calculations.
@@ -121,8 +121,66 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 	 * @param {object} oChainObject chain object
 	 */
 	let transformApiJson = function (oChainObject) {
+		/**
+		 * Check if a type is a built-in type, handling both simple
+		 * and compound types gracefully.
+		 *
+		 * @param {string} type A type to check
+		 * @returns {boolean} true if the type is built-in, otherwise false
+		 */
 		function isBuiltInType(type) {
-			return formatters._baseTypes.indexOf(type) >= 0;
+			const builtInTypes = formatters._baseTypes;
+
+			// Early return if the type is directly in baseTypes
+			if (builtInTypes.includes(type)) {
+				return true;
+			}
+
+			// Handle array notation directly
+			if (type.endsWith("[]")) {
+				return builtInTypes.includes(type.slice(0, -2));
+			}
+
+			// Check if the type is a union type
+			if (type.includes("|")) {
+				const unionParts = type.split("|").map(part => part.trim());
+				return unionParts.every(part => isBuiltInType(part));
+			}
+
+			// Predefined regex patterns for reuse
+			const arrayRegex = /Array<(.+)>/;
+			const arrayDotRegex = /Array\.<(.+)>/;
+			const objectRegex = /Object<([^,]+),([^>]+)>/;
+			const objectDotRegex = /Object\.<([^,]+),([^>]+)>/;
+
+			// Check if the type is a generic Array type
+			const arrayMatch = arrayRegex.exec(type);
+			if (arrayMatch) {
+				const innerType = arrayMatch[1];
+				return isBuiltInType(innerType);
+			}
+
+			const arrayDotMatch = arrayDotRegex.exec(type);
+			if (arrayDotMatch) {
+				const innerType = arrayDotMatch[1];
+				return isBuiltInType(innerType);
+			}
+
+			// Check if the type is a generic Object type
+			const objectMatch = objectRegex.exec(type);
+			if (objectMatch) {
+				const innerTypes = [objectMatch[1], objectMatch[2]].map(t => t.trim());
+				return innerTypes.every(innerType => isBuiltInType(innerType));
+			}
+
+			const objectDotMatch = objectDotRegex.exec(type);
+			if (objectDotMatch) {
+				const innerTypes = [objectDotMatch[1], objectDotMatch[2]].map(t => t.trim());
+				return innerTypes.every(innerType => isBuiltInType(innerType));
+			}
+
+			// Fallback case: if none of the above matched, return false
+			return false;
 		}
 
 		/**
@@ -1106,32 +1164,28 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 		});
 	}
 
-	/*
+	/**
 	 * =====================================================================================================================
 	 * IMPORTANT NOTE: Formatter code is a copy from APIDetail.controller.js with a very little modification and mocking and
 	 * code can be significantly improved
 	 * =====================================================================================================================
 	 */
 	let formatters = {
-
 		_sTopicId: "",
 		_oTopicData: {},
 		_baseTypes: [
-			// TODO this list URGENTLY needs to be replaced by the Type parser and a much smaller list
 			"sap.ui.core.any",
 			"sap.ui.core.object",
 			"sap.ui.core.function",
-			"sap.ui.core.number", // TODO discuss with Thomas, type does not exist
+			"sap.ui.core.number",
 			"sap.ui.core.float",
 			"sap.ui.core.int",
 			"sap.ui.core.boolean",
 			"sap.ui.core.string",
 			"sap.ui.core.void",
 			"null",
 			"any",
-			"any[]",
 			"Error",
-			"Error[]",
 			"array",
 			"element",
 			"Element",
@@ -1141,19 +1195,11 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 			"QUnit.Assert",
 			"object",
 			"Object",
-			"object[]",
-			"object|object[]",
-			"[object Object][]",
-			"Array<[object Object]>",
-			"Array.<[object Object]>",
-			"Object<string,string>",
-			"Object.<string,string>",
 			"function",
 			"float",
 			"int",
 			"boolean",
 			"string",
-			"string[]",
 			"number",
 			"map",
 			"promise",
@@ -1163,7 +1209,8 @@ function transformer(sInputFile, sOutputFile, sLibraryFile, vDependencyAPIFiles,
 			"Touch",
 			"TouchList",
 			"undefined",
-			"this"
+			"this",
+			"[object Object]"
 		],
 		ANNOTATIONS_LINK: 'http://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part3-csdl.html',
 		ANNOTATIONS_NAMESPACE_LINK: 'http://docs.oasis-open.org/odata/odata/v4.0/errata02/os/complete/vocabularies/',