[INTERNAL] lib/processors/jsdoc: Enable sap/base enums to be used as sap/ui/base/DataTypes

The JSDoc template now detects when a managed property
uses a global type name but the type itself has a `module:*` name.
In that case, the `module:*` name is used for the generated API
documentation.

Cherry-picked from UI5/openui5@e4d070423.

Author: codeworrior

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

@@ -2525,6 +2525,37 @@ function postProcessAPIJSON(api) {
 					`doesn't match containing library '${api.library}'. Library must be explicitly defined in class metadata!`);
 			}
 		}
+		if (Array.isArray(symbol["ui5-metadata"].properties)) {
+			for (const prop of symbol["ui5-metadata"].properties) {
+				let moduleType;
+				// cut off array brackets for symbol lookup
+				const arrType = isArrayType(prop.type);
+				let lookupType = prop.type;
+				if (arrType) {
+					lookupType = lookupType.replace("[]", "");
+				}
+				if (prop.dataType === undefined
+					&& findSymbol(lookupType) == null
+					&& !lookupType?.startsWith("module:")
+					&& findSymbol(moduleType = `module:${lookupType.replace(/\./g, "/")}`) != null) {
+					// note: the dataType must be the original, including array brackets if present
+					prop.dataType = prop.type;
+					// the moduleType also needs to include the array brackets if present in the original dataType
+					prop.type = moduleType + (arrType ? "[]" : "");
+					for (const methodName of prop.methods) {
+						const method = symbol.methods?.find((m) => m.name === methodName);
+						if (methodName.startsWith("get")
+							&& method?.returnValue?.type === prop.dataType) {
+							method.returnValue.type = prop.type;
+						} else if (methodName.startsWith("set")
+							&& method?.parameters?.[0]?.type === prop.dataType) {
+							method.parameters[0].type = prop.type;
+						}
+					}
+					info(`${symbol.name}: adapted type of ${prop.name} and its accessors from '${prop.dataType}' to '${prop.type}'`);
+				}
+			}
+		}
 	});
 
 }