[INTERNAL] lib/processors/jsdoc: support construct functions and this types

Cherry-picked from UI5/openui5@5852fc19e

Author: codeworrior

lib/processors/jsdoc/lib/ui5/plugin.js

@@ -3317,11 +3317,17 @@ exports.astNodeVisitor = {
 				typeString = 'function';
 				// #### BEGIN: MODIFIED BY SAP
 				paramTypes = [];
+				// add only one of 'new:' or 'this:' type, 'new:' is preferred as it implies a 'this:'
 				if (parsedType.new) {
-					paramTypes.push(toTypeString(parsedType.new));
+					paramTypes.push("new:" + toTypeString(parsedType.new));
+				} else if (parsedType.this) {
+					paramTypes.push("this:" + toTypeString(parsedType.this));
 				}
+
 				if (Array.isArray(parsedType.params)) {
-					paramTypes.push(...parsedType.params.map(toTypeString));
+					paramTypes.push(...parsedType.params.map((paramType) => {
+						return toTypeString(paramType) + (paramType.optional ? "=" : "");
+					}));
 				}
 				if (paramTypes.length || parsedType.result) {
 					typeString += `(${paramTypes.join(", ")})`;

lib/processors/jsdoc/lib/ui5/template/publish.js

@@ -730,10 +730,18 @@ class TypeStringBuilder {
 			str: 'Promise' + this.lt + this.safe(fulfillmentType) + this.gt
 		};
 	}
-	"function"(paramTypes, returnType) {
+	"function"(paramTypes, returnType, thisType, constructorType) {
+		paramTypes = paramTypes.map(
+			(type) => type.str + (type.optional ? "=" : "")
+		);
+		if (constructorType != null) {
+			paramTypes.unshift(`new:${constructorType.str}`);
+		} else if (thisType != null) {
+			paramTypes.unshift(`this:${thisType.str}`);
+		}
 		return {
 			simpleComponent: false,
-			str: "function(" + paramTypes.map((type) => type.str).join(',') + ")" + ( returnType ? " : " + this.safe(returnType) : "")
+			str: `function(${paramTypes.join(",")})${returnType ? " : " + this.safe(returnType) : ""}`
 		};
 	}
 	structure(structure) {

lib/processors/jsdoc/lib/ui5/template/utils/typeParser.js

@@ -414,9 +414,19 @@ function TypeParser(defaultBuilder = new ASTBuilder()) {
 				case "function":
 					const aParamTemplates = [];
 					let aParamsimpleTypes = [];
+					if (Object.hasOwn(parsed, "constructor") && parsed.constructor) {
+						const types = findSimpleTypes(parsed.constructor);
+						aParamTemplates.push("new:" + types.template);
+						aParamsimpleTypes = aParamsimpleTypes.concat(types.simpleTypes);
+					}
+					if (parsed.this) {
+						const types = findSimpleTypes(parsed.this);
+						aParamTemplates.push("this:" + types.template);
+						aParamsimpleTypes = aParamsimpleTypes.concat(types.simpleTypes);
+					}
 					parsed.params.forEach(function(paramType) {
 						const types = findSimpleTypes(paramType);
-						aParamTemplates.push(types.template);
+						aParamTemplates.push(types.template + (paramType.optional ? "?" : ""));
 						aParamsimpleTypes = aParamsimpleTypes.concat(types.simpleTypes);
 					});
 					const returnType = parsed.return ? findSimpleTypes(parsed.return) : {simpleTypes: []};