fix(dts-generator): align deprecation/experimental tags with UI5 SDK (#469)

Fixes: #468

Author: matz3

packages/dts-generator/src/phases/dts-code-gen.ts

@@ -118,8 +118,12 @@ function JSDOC({
   }
 
   contents += since ? `@since ${since}` + NL : EMPTY_STRING;
-  contents += deprecated ? genDeprecated(deprecated) + NL : EMPTY_STRING;
-  contents += experimental ? genExperimental(experimental) + NL : EMPTY_STRING;
+  contents += deprecated
+    ? genDeprecatedOrExperimental(deprecated) + NL
+    : EMPTY_STRING;
+  contents += experimental
+    ? genDeprecatedOrExperimental(experimental) + NL
+    : EMPTY_STRING;
   contents += isProtected
     ? genProtected({ callable: kind === "FunctionDesc" }) + NL
     : EMPTY_STRING;
@@ -219,11 +223,15 @@ function NAMED_INTERFACE_MARKER(fqn: string): string {
  * @param ast
  * @return
  */
-function genDeprecated(ast: DeprecatedDesc) {
+function genDeprecatedOrExperimental(ast: DeprecatedDesc | ExperimentalDesc) {
   let contents = EMPTY_STRING;
-  contents += "@deprecated";
-  contents += ast.since ? ` (since ${ast.since})` : EMPTY_STRING;
-  contents += ast.description ? ` - ${ast.description}` : EMPTY_STRING;
+  if (ast.kind === "DeprecatedDesc") {
+    contents += "@deprecated";
+  } else if (ast.kind === "ExperimentalDesc") {
+    contents += "@experimental";
+  }
+  contents += ast.since ? ` As of version ${ast.since}.` : EMPTY_STRING;
+  contents += ast.description ? ` ${ast.description}` : EMPTY_STRING;
   return contents;
 }
 
@@ -236,18 +244,6 @@ function genProtected({ callable = false }) {
     : "@ui5-protected DO NOT USE IN APPLICATIONS (only for related classes in the framework)";
 }
 
-/**
- * @param ast
- * @return
- */
-function genExperimental(ast: ExperimentalDesc) {
-  let contents = EMPTY_STRING;
-  contents += "@experimental";
-  contents += ast.since ? ` (since ${ast.since})` : EMPTY_STRING;
-  contents += ast.description ? ` - ${ast.description}` : EMPTY_STRING;
-  return contents;
-}
-
 /**
  *
  * @param ast

packages/dts-generator/src/resources/core-preamble.d.ts

@@ -64,7 +64,7 @@ interface JQuery<TElement = HTMLElement> extends Iterable<TElement> {
 
   /**
    * Extension function to the jQuery.fn which identifies SAPUI5 controls in the given jQuery context.
-   * @deprecated since 1.106, use sap.ui.core.Element.closestTo instead.
+   * @deprecated As of version 1.106, use {@link sap.ui.core.Element.closestTo} instead.
    */
   control(
     /**
@@ -75,7 +75,7 @@ interface JQuery<TElement = HTMLElement> extends Iterable<TElement> {
 
   /**
    * Extension function to the jQuery.fn which identifies SAPUI5 controls in the given jQuery context.
-   * @deprecated since 1.106, use sap.ui.core.Element.closestTo instead.
+   * @deprecated As of version 1.106, use {@link sap.ui.core.Element.closestTo} instead.
    */
   control(
     /**