@sitevision/api 2023.2.1 → 2023.2.2-beta.1

package/server/LinkRenderer/index.d.ts

@@ -1,236 +1,237 @@
 import type { Node } from "../../types/javax/jcr/Node";
+import type { String } from "../../types/java/lang/String";
 
 /**
  * LinkRenderer is a stateful utility interface that can be used to build valid html text links that uses link icons according to the
- * website settings.
+ *  website settings.
  *
- * <p>
- * An instance of the Sitevision class implementing this interface can be obtained via {@link senselogic.sitevision.api.Utils#getLinkRenderer()}.
- * See {@link senselogic.sitevision.api.Utils} for how to obtain an instance of the <code>Utils</code> interface.
- * </p>
+ *  <p>
+ *  An instance of the Sitevision class implementing this interface can be obtained via {@link senselogic.sitevision.api.Utils#getLinkRenderer()}.
+ *  See {@link senselogic.sitevision.api.Utils} for how to obtain an instance of the <code>Utils</code> interface.
+ *  </p>
  *
- * <p>
- * LinkRenderer is very suitable when rendering more than one link (for instance when rendering a menu) or if you don't want to bother whether or not
- * the site prescribes your link(s) should use link icons or file icons.
- * </p>
+ *  <p>
+ *  LinkRenderer is very suitable when rendering more than one link (for instance when rendering a menu) or if you don't want to bother whether or not
+ *  the site prescribes your link(s) should use link icons or file icons.
+ *  </p>
  *
- * <p>
- * LinkRenderer attributes comes in different flavors:
- * </p>
- * <ul>
- * <li><strong>Mandatory</strong> (link data):
- *   <ul>
- *     <li style="margin-top:5px">
- *       <em>target</em> - The target of the link. Can be a <code>String</code> or a {@link #isRenderableTarget(javax.jcr.Node) renderable Node}.<br>
- *       Example: <code>&lt;a class="xyz" href="<strong>xyz</strong>" title="xyz"&gt;Linked text&lt;/a&gt;</code>
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>fontClass</em> - The class name of the link.<br>
- *       Example: <code>&lt;a class="<strong>xyz</strong>" href="xyz" title="xyz"&gt;Linked text&lt;/a&gt;</code>
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>text</em> - The text that should be linked.<br>
- *       Example: <code>&lt;a class="xyz" href="xyz" title="xyz"&gt;<strong>Linked text</strong>&lt;/a&gt;</code>
- *     </li>
- *   </ul>
- * </li>
+ *  <p>
+ *  LinkRenderer attributes comes in different flavors:
+ *  </p>
+ *  <ul>
+ *  <li><strong>Mandatory</strong> (link data):
+ *    <ul>
+ *      <li style="margin-top:5px">
+ *        <em>target</em> - The target of the link. Can be a <code>String</code> or a {@link #isRenderableTarget(javax.jcr.Node) renderable Node}.<br>
+ *        Example: <code>&lt;a class="xyz" href="<strong>xyz</strong>" title="xyz"&gt;Linked text&lt;/a&gt;</code>
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>fontClass</em> - The class name of the link.<br>
+ *        Example: <code>&lt;a class="<strong>xyz</strong>" href="xyz" title="xyz"&gt;Linked text&lt;/a&gt;</code>
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>text</em> - The text that should be linked.<br>
+ *        Example: <code>&lt;a class="xyz" href="xyz" title="xyz"&gt;<strong>Linked text</strong>&lt;/a&gt;</code>
+ *      </li>
+ *    </ul>
+ *  </li>
  *
- * <li style="margin-top:10px"><strong>Optional</strong> (link data):
- *   <ul>
- *     <li style="margin-top:5px">
- *       <em>title</em> - The title of the link.<br>
- *       Example: <code>&lt;a class="xyz" href="xyz" title="<strong>xyz</strong>"&gt;Linked text&lt;/a&gt;</code><br>
- *       Default is <code>null</code>
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>style</em> - The style of the link.<br>
- *       Example: <code>&lt;a class="xyz" href="xyz" title="xyz" style="<strong>xyz</strong>"&gt;Linked text&lt;/a&gt;</code><br>
- *       Default is <code>null</code>
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>onclick</em> - The onclick and onkeypress of the link.<br>
- *       Example: <code>&lt;a class="xyz" href="xyz" title="xyz" onclick="<strong>xyz</strong>"
- *       onkeypress="<strong>xyz</strong>&gt;Linked text&lt;/a&gt;</code><br>
- *       Default is <code>null</code>
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>id</em> - The id of the link.<br>
- *       Example: <code>&lt;a class="xyz" href="xyz" title="xyz" id="<strong>xyz</strong>"&gt;Linked text&lt;/a&gt;</code><br>
- *       Default is <code>null</code>
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>targetParameters</em> - Additional target parameters for the target.<br>
- *       Example: <code>&lt;a class="xyz" href="xyz<strong>?a=b&amp;c=d</strong>" title="xyz"&gt;Linked text&lt;/a&gt;</code><br>
- *       Default is no target parameters.
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>rel</em> - The rel value of the link.<br>
- *       Example: <code>&lt;a class="xyz" href="xyz" title="xyz" rel="<strong>xyz</strong>"&gt;Linked text&lt;/a&gt;</code><br>
- *       Default is <code>null</code>
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>accessKey</em> - The accesskey value of the link.<br>
- *       Example: <code>&lt;a class="xyz" href="xyz" title="xyz" accesskey="<strong>xyz</strong>"&gt;Linked text&lt;/a&gt;</code><br>
- *       Default is <code>null</code>
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>openNewWindow</em> - Whether or not the link should be opened in a new window.<br>
- *       Default is <code>false</code>
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>dataAttributes</em> - Additional HTML5 data-* attributes.<br>
- *       Default is no data attributes
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>download</em> - Whether or not to add the HTML5-specific <em>download</em> attribute
- *       (indication to the browser to download the link target instead of navigating to it).<br>
- *       Default is <code>false</code>
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>lang</em> - Defines the language of the link element.<br>
- *       Example: <code>&lt;a class="xyz" href="xyz" title="xyz" lang="<strong>en</strong>"&gt;Linked text&lt;/a&gt;</code><br>
- *       Default is <code>null</code>
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>hreflang</em> - Hints at the language of the linked resource.<br>
- *        Example: <code>&lt;a class="xyz" href="xyz" title="xyz" hreflang="<strong>en</strong>"&gt;Linked text&lt;/a&gt;</code><br>
+ *  <li style="margin-top:10px"><strong>Optional</strong> (link data):
+ *    <ul>
+ *      <li style="margin-top:5px">
+ *        <em>title</em> - The title of the link.<br>
+ *        Example: <code>&lt;a class="xyz" href="xyz" title="<strong>xyz</strong>"&gt;Linked text&lt;/a&gt;</code><br>
  *        Default is <code>null</code>
- *     </li>
- *   </ul>
- * </li>
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>style</em> - The style of the link.<br>
+ *        Example: <code>&lt;a class="xyz" href="xyz" title="xyz" style="<strong>xyz</strong>"&gt;Linked text&lt;/a&gt;</code><br>
+ *        Default is <code>null</code>
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>onclick</em> - The onclick and onkeypress of the link.<br>
+ *        Example: <code>&lt;a class="xyz" href="xyz" title="xyz" onclick="<strong>xyz</strong>"
+ *        onkeypress="<strong>xyz</strong>&gt;Linked text&lt;/a&gt;</code><br>
+ *        Default is <code>null</code>
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>id</em> - The id of the link.<br>
+ *        Example: <code>&lt;a class="xyz" href="xyz" title="xyz" id="<strong>xyz</strong>"&gt;Linked text&lt;/a&gt;</code><br>
+ *        Default is <code>null</code>
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>targetParameters</em> - Additional target parameters for the target.<br>
+ *        Example: <code>&lt;a class="xyz" href="xyz<strong>?a=b&amp;c=d</strong>" title="xyz"&gt;Linked text&lt;/a&gt;</code><br>
+ *        Default is no target parameters.
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>rel</em> - The rel value of the link.<br>
+ *        Example: <code>&lt;a class="xyz" href="xyz" title="xyz" rel="<strong>xyz</strong>"&gt;Linked text&lt;/a&gt;</code><br>
+ *        Default is <code>null</code>
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>accessKey</em> - The accesskey value of the link.<br>
+ *        Example: <code>&lt;a class="xyz" href="xyz" title="xyz" accesskey="<strong>xyz</strong>"&gt;Linked text&lt;/a&gt;</code><br>
+ *        Default is <code>null</code>
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>openNewWindow</em> - Whether or not the link should be opened in a new window.<br>
+ *        Default is <code>false</code>
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>dataAttributes</em> - Additional HTML5 data-* attributes.<br>
+ *        Default is no data attributes
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>download</em> - Whether or not to add the HTML5-specific <em>download</em> attribute
+ *        (indication to the browser to download the link target instead of navigating to it).<br>
+ *        Default is <code>false</code>
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>lang</em> - Defines the language of the link element.<br>
+ *        Example: <code>&lt;a class="xyz" href="xyz" title="xyz" lang="<strong>en</strong>"&gt;Linked text&lt;/a&gt;</code><br>
+ *        Default is <code>null</code>
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>hreflang</em> - Hints at the language of the linked resource.<br>
+ *         Example: <code>&lt;a class="xyz" href="xyz" title="xyz" hreflang="<strong>en</strong>"&gt;Linked text&lt;/a&gt;</code><br>
+ *         Default is <code>null</code>
+ *      </li>
+ *    </ul>
+ *  </li>
  *
- * <li style="margin-top:10px"><strong>Additional</strong> (rendering helpers/settings):
- *   <ul>
- *     <li style="margin-top:5px">
- *       <em>useAutoTitle</em> - Whether or not the title automatically should get a calculated title value (if it is null).<br>
- *       Default is <code>false</code>.
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>useEncoding</em> - Whether or not all attributes should be encoded.<br>
- *       Default is <code>true</code>.
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>useParameterEncoding</em> - Whether or not <em>targetParameters</em> should be encoded.<br>
- *       Default is <code>true</code>.
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>useLinkDecorationSettings</em> - Whether or not to use the link type icons settings (i.e. "Show icon next to external links",
- *       "Show icon next to links that opens in a new window") of the current site.<br>
- *       Default is <code>true</code>.
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>useResourceDecorationSettings</em> - Whether or not to use the file resource setting (i.e. "Show icon next to known file types" and
- *       "Show file description and size next to known file types") of the current site.<br>
- *       Default is <code>true</code>.
- *     </li>
- *     <li style="margin-top:5px">
- *       <em>useCrossSiteTargetChecking</em> - Whether or not to check Node targets for cross-site URL's.<br>
- *       Default is <code>false</code>.
- *     </li>
- *   </ul>
- * </li>
- * </ul>
+ *  <li style="margin-top:10px"><strong>Additional</strong> (rendering helpers/settings):
+ *    <ul>
+ *      <li style="margin-top:5px">
+ *        <em>useAutoTitle</em> - Whether or not the title automatically should get a calculated title value (if it is null).<br>
+ *        Default is <code>false</code>.
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>useEncoding</em> - Whether or not all attributes should be encoded.<br>
+ *        Default is <code>true</code>.
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>useParameterEncoding</em> - Whether or not <em>targetParameters</em> should be encoded.<br>
+ *        Default is <code>true</code>.
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>useLinkDecorationSettings</em> - Whether or not to use the link type icons settings (i.e. "Show icon next to external links",
+ *        "Show icon next to links that opens in a new window") of the current site.<br>
+ *        Default is <code>true</code>.
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>useResourceDecorationSettings</em> - Whether or not to use the file resource setting (i.e. "Show icon next to known file types" and
+ *        "Show file description and size next to known file types") of the current site.<br>
+ *        Default is <code>true</code>.
+ *      </li>
+ *      <li style="margin-top:5px">
+ *        <em>useCrossSiteTargetChecking</em> - Whether or not to check Node targets for cross-site URL's.<br>
+ *        Default is <code>false</code>.
+ *      </li>
+ *    </ul>
+ *  </li>
+ *  </ul>
  *
- * <p>
- * ----------------------------------------------------------------------------------------------------
- * </p>
+ *  <p>
+ *  ----------------------------------------------------------------------------------------------------
+ *  </p>
  *
- * <p>
- *   Using the LinkRenderer is pretty straightforward, if you remember that it is <strong>stateful</strong>.<br>
- *   Conceptually you would typically use it like this:
- * </p>
- * <ol>
- *   <li>Get the LinkRenderer</li>
- *   <li>Possibly init the renderer with additional settings (useEncoding, autoTitle etc.)</li>
- *   <li>Init the renderer with mandatory attributes (text, target and fontClass)</li>
- *   <li>Possibly init the renderer with recommended attributes (title) if you need it.</li>
- *   <li>Possibly init the renderer with optional attributes (style, rel etc.)</li>
- *   <li>Do render</li>
- * </ol>
- * <p>
- * When you have rendered once, you can re-use the LinkRenderer until you are done. Something like:
- * </p>
- * <ol>
- *   <li>Update the LinkRenderer
- *     <ul>
- *       <li>Update mandatory attributes (text, target, fontClass) that needs to be updated.</li>
- *       <li>Possibly update optional attributes and clear the ones you don't need anymore.</li>
- *       <li>Possibly update the additional settings that needs to be updated.</li>
- *     </ul>
- *   </li>
- *   <li>Do render.</li>
- * </ol>
+ *  <p>
+ *    Using the LinkRenderer is pretty straightforward, if you remember that it is <strong>stateful</strong>.<br>
+ *    Conceptually you would typically use it like this:
+ *  </p>
+ *  <ol>
+ *    <li>Get the LinkRenderer</li>
+ *    <li>Possibly init the renderer with additional settings (useEncoding, autoTitle etc.)</li>
+ *    <li>Init the renderer with mandatory attributes (text, target and fontClass)</li>
+ *    <li>Possibly init the renderer with recommended attributes (title) if you need it.</li>
+ *    <li>Possibly init the renderer with optional attributes (style, rel etc.)</li>
+ *    <li>Do render</li>
+ *  </ol>
+ *  <p>
+ *  When you have rendered once, you can re-use the LinkRenderer until you are done. Something like:
+ *  </p>
+ *  <ol>
+ *    <li>Update the LinkRenderer
+ *      <ul>
+ *        <li>Update mandatory attributes (text, target, fontClass) that needs to be updated.</li>
+ *        <li>Possibly update optional attributes and clear the ones you don't need anymore.</li>
+ *        <li>Possibly update the additional settings that needs to be updated.</li>
+ *      </ul>
+ *    </li>
+ *    <li>Do render.</li>
+ *  </ol>
  *
- * <p>
- *    <strong>Example of how this strategy could be implemented in Velocity:</strong><br>
- *    (You want to do a simple menu, i.e. iterate the nodes in a collection/iterator "$pages", and use LinkRenderer to render links to them
- *    as a html list)
- * </p>
- * <pre><code>
- *   <em>## Get PropertyUtil to ease Node property fetching</em>
- *   #set ($propertyUtil = $sitevisionUtils.propertyUtil)
+ *  <p>
+ *     <strong>Example of how this strategy could be implemented in Velocity:</strong><br>
+ *     (You want to do a simple menu, i.e. iterate the nodes in a collection/iterator "$pages", and use LinkRenderer to render links to them
+ *     as a html list)
+ *  </p>
+ *  <pre><code>
+ *    <em>## Get PropertyUtil to ease Node property fetching</em>
+ *    #set ($propertyUtil = $sitevisionUtils.propertyUtil)
  *
- *   <em>## Use font class 'normal' for all links</em>
- *   #set ($font = 'normal')
+ *    <em>## Use font class 'normal' for all links</em>
+ *    #set ($font = 'normal')
  *
- *   <em>## Get LinkRenderer</em>
- *   #set ($linkRenderer = $sitevisionUtils.linkRenderer)
+ *    <em>## Get LinkRenderer</em>
+ *    #set ($linkRenderer = $sitevisionUtils.linkRenderer)
  *
- *   <em>## Iterate through pages and render links to them</em>
- *   &lt;ul style="list-style:none"&gt;
- *   #foreach ($page in $pages)
- *     <em>## Fetch the name of the node</em>
- *     #set ($pageName = $propertyUtil.getString($page, 'displayName', $page.toString()))
+ *    <em>## Iterate through pages and render links to them</em>
+ *    &lt;ul style="list-style:none"&gt;
+ *    #foreach ($page in $pages)
+ *      <em>## Fetch the name of the node</em>
+ *      #set ($pageName = $propertyUtil.getString($page, 'displayName', $page.toString()))
  *
- *     <em>## Update the renderer and render</em>
- *     $linkRenderer.update($page, $font, $pageName)
- *     &lt;li&gt;
- *       $linkRenderer.render()
- *     &lt;/li&gt;
- *   #end
- *   &lt;/ul&gt;
- * </code></pre>
+ *      <em>## Update the renderer and render</em>
+ *      $linkRenderer.update($page, $font, $pageName)
+ *      &lt;li&gt;
+ *        $linkRenderer.render()
+ *      &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ *  </code></pre>
  *
- * <p>
- * ----------------------------------------------------------------------------------------------------
- * </p>
+ *  <p>
+ *  ----------------------------------------------------------------------------------------------------
+ *  </p>
  *
- * <p>
- * Since LinkRenderer is stateful and likely will be used in Velocity frequently, there are some "shortcuts" that might be useful:
- * </p>
- * <ul>
- *   <li style="margin-top:5px">
- *     A quick way to update the mandatory attributes is to use one of the <code>update(...)</code> methods.
- *     If you at the same time want to clear all optional attributes, use one of the <code>updateClean(...)</code> methods instead.
- *   </li>
- *   <li style="margin-top:5px">
- *     A smooth way to clear all optional attributes is to call the <code>clearAllOptional()</code> method
- *   </li>
- *   <li style="margin-top:5px">
- *     Due to the lack of proper boolean support in Velocity, all the boolean attributes has corresponding force/clear methods to set the boolean
- *     to true/false. For example: <br>
- *     &nbsp;&nbsp;&nbsp;Executing <code>forceOpenNewWindow()</code> results in an execution of <code>setOpenNewWindow(true)</code> <br>
- *     &nbsp;&nbsp;&nbsp;Executing <code>clearOpenNewWindow()</code> results in an execution of <code>setOpenNewWindow(false)</code>
- *   </li>
- *   <li style="margin-top:5px">
- *     Due to the lack of proper null support in Velocity, some attributes has clear methods to set the attribute to <code>null</code>.
- *     For example: <br>
- *     &nbsp;&nbsp;&nbsp;Executing <code>clearAccessKey()</code> results in an execution of <code>setAccessKey(null)</code>
- *   </li>
- * </ul>
+ *  <p>
+ *  Since LinkRenderer is stateful and likely will be used in Velocity frequently, there are some "shortcuts" that might be useful:
+ *  </p>
+ *  <ul>
+ *    <li style="margin-top:5px">
+ *      A quick way to update the mandatory attributes is to use one of the <code>update(...)</code> methods.
+ *      If you at the same time want to clear all optional attributes, use one of the <code>updateClean(...)</code> methods instead.
+ *    </li>
+ *    <li style="margin-top:5px">
+ *      A smooth way to clear all optional attributes is to call the <code>clearAllOptional()</code> method
+ *    </li>
+ *    <li style="margin-top:5px">
+ *      Due to the lack of proper boolean support in Velocity, all the boolean attributes has corresponding force/clear methods to set the boolean
+ *      to true/false. For example: <br>
+ *      &nbsp;&nbsp;&nbsp;Executing <code>forceOpenNewWindow()</code> results in an execution of <code>setOpenNewWindow(true)</code> <br>
+ *      &nbsp;&nbsp;&nbsp;Executing <code>clearOpenNewWindow()</code> results in an execution of <code>setOpenNewWindow(false)</code>
+ *    </li>
+ *    <li style="margin-top:5px">
+ *      Due to the lack of proper null support in Velocity, some attributes has clear methods to set the attribute to <code>null</code>.
+ *      For example: <br>
+ *      &nbsp;&nbsp;&nbsp;Executing <code>clearAccessKey()</code> results in an execution of <code>setAccessKey(null)</code>
+ *    </li>
+ *  </ul>
  *
- * <p>
- *   <a name="threadnote"></a>
- *   <strong>Thread Note!</strong> The render method is <em>NOT</em> thread safe! If two threads simultaneously executes
- *   the render method on the <em>SAME</em> LinkRenderer instance, the rendered result is undeterminable. This is in almost
- *   all cases nothing you need to worry about, unless your portlet or servlet actually creates a separate <code>Thread</code>
- *   and starts it. If so - ensure all your created threads creates and uses their own LinkRenderer instance!
- * </p>
+ *  <p>
+ *    <a name="threadnote"></a>
+ *    <strong>Thread Note!</strong> The render method is <em>NOT</em> thread safe! If two threads simultaneously executes
+ *    the render method on the <em>SAME</em> LinkRenderer instance, the rendered result is undeterminable. This is in almost
+ *    all cases nothing you need to worry about, unless your portlet or servlet actually creates a separate <code>Thread</code>
+ *    and starts it. If so - ensure all your created threads creates and uses their own LinkRenderer instance!
+ *  </p>
  *
- * <p>
- *  <strong>Note/Tip!</strong> This interface helps rendering textual links. If you want to render <em>image</em> links, you would typically
- *  use the {@link senselogic.sitevision.api.render.ImageLinkRenderer} instead.
- * </p>
+ *  <p>
+ *   <strong>Note/Tip!</strong> This interface helps rendering textual links. If you want to render <em>image</em> links, you would typically
+ *   use the {@link senselogic.sitevision.api.render.ImageLinkRenderer} instead.
+ *  </p>
  * @author Magnus Lövgren
  */
 export interface LinkRenderer {
@@ -244,9 +245,9 @@ export interface LinkRenderer {
    */
   update(
     aTarget: Node,
-    aFontClass: string,
-    aText: string,
-    aTitle: string
+    aFontClass: String | string,
+    aText: String | string,
+    aTitle: String | string
   ): void;
 
   /**
@@ -256,7 +257,11 @@ export interface LinkRenderer {
    * @param aText the link text
    * @see #isValidTarget(javax.jcr.Node)
    */
-  update(aTarget: Node, aFontClass: string, aText: string): void;
+  update(
+    aTarget: Node,
+    aFontClass: String | string,
+    aText: String | string
+  ): void;
 
   /**
    * Updates current state and removes previous title.
@@ -264,15 +269,15 @@ export interface LinkRenderer {
    * @param aText the link text
    * @see #isValidTarget(javax.jcr.Node)
    */
-  update(aTarget: Node, aText: string): void;
+  update(aTarget: Node, aText: String | string): void;
 
   /**
    * Updates current state and removes previous title and text.
    *
-   * <p>
-   *    Note. If no text exists when rendering, the target Node will be used to determine an appropriate text
-   *    (e.g. the display name if the node is a page).
-   * </p>
+   *  <p>
+   *     Note. If no text exists when rendering, the target Node will be used to determine an appropriate text
+   *     (e.g. the display name if the node is a page).
+   *  </p>
    * @param aTarget the target of the link (href attribute for the a element)
    * @see #isValidTarget(javax.jcr.Node)
    */
@@ -289,9 +294,9 @@ export interface LinkRenderer {
    */
   updateClean(
     aTarget: Node,
-    aFontClass: string,
-    aText: string,
-    aTitle: string
+    aFontClass: String | string,
+    aText: String | string,
+    aTitle: String | string
   ): void;
 
   /**
@@ -302,7 +307,11 @@ export interface LinkRenderer {
    * @see #clearAllOptional()
    * @see #isValidTarget(javax.jcr.Node)
    */
-  updateClean(aTarget: Node, aFontClass: string, aText: string): void;
+  updateClean(
+    aTarget: Node,
+    aFontClass: String | string,
+    aText: String | string
+  ): void;
 
   /**
    * Updates current state and removes all optional attributes and title.
@@ -311,15 +320,15 @@ export interface LinkRenderer {
    * @see #clearAllOptional()
    * @see #isValidTarget(javax.jcr.Node)
    */
-  updateClean(aTarget: Node, aText: string): void;
+  updateClean(aTarget: Node, aText: String | string): void;
 
   /**
    * Updates current state and removes all optional attributes, title and text.
    *
-   * <p>
-   *    Note. If no text exists when rendering, the target Node will be used to determine an appropriate text
-   *    (e.g. the display name if the node is a page).
-   * </p>
+   *  <p>
+   *     Note. If no text exists when rendering, the target Node will be used to determine an appropriate text
+   *     (e.g. the display name if the node is a page).
+   *  </p>
    * @param aTarget the target of the link (href attribute for the a element)
    * @see #clearAllOptional()
    * @see #isValidTarget(javax.jcr.Node)
@@ -328,20 +337,20 @@ export interface LinkRenderer {
 
   /**
    * Removes all optional settings.
-   * In other words - executing this method has the same effect as executing:
-   * <ul>
-   *   <li><code>clearStyle()</code></li>
-   *   <li><code>clearOnclick()</code></li>
-   *   <li><code>clearId()</code></li>
-   *   <li><code>clearTargetParameters()</code></li>
-   *   <li><code>clearRel()</code></li>
-   *   <li><code>clearAccessKey()</code></li>
-   *   <li><code>clearOpenNewWindow()</code></li>
-   *   <li><code>clearDataAttributes()</code></li>
-   *   <li><code>clearUseDownload()</code></li>
-   *   <li><code>clearLang()</code></li>
-   *   <li><code>clearHrefLang()</code></li>
-   * </ul>
+   *  In other words - executing this method has the same effect as executing:
+   *  <ul>
+   *    <li><code>clearStyle()</code></li>
+   *    <li><code>clearOnclick()</code></li>
+   *    <li><code>clearId()</code></li>
+   *    <li><code>clearTargetParameters()</code></li>
+   *    <li><code>clearRel()</code></li>
+   *    <li><code>clearAccessKey()</code></li>
+   *    <li><code>clearOpenNewWindow()</code></li>
+   *    <li><code>clearDataAttributes()</code></li>
+   *    <li><code>clearUseDownload()</code></li>
+   *    <li><code>clearLang()</code></li>
+   *    <li><code>clearHrefLang()</code></li>
+   *  </ul>
    * @see #clearStyle()
    * @see #clearOnclick()
    * @see #clearId()
@@ -359,16 +368,16 @@ export interface LinkRenderer {
   /**
    * Builds a html link based on current state.
    *
-   * <p>
-   * <em>Note!</em> The render method is not thread safe, see <a href="#threadnote">thread note above</a>.
-   * </p>
+   *  <p>
+   *  <em>Note!</em> The render method is not thread safe, see <a href="#threadnote">thread note above</a>.
+   *  </p>
    * @return a html link, ready to print out on a page
    */
   render(): string;
 
   /**
    * Sets what the link target is, i.e "what the link links to" (href attribute on the a element).
-   * The target attribute is mandatory when the result is rendered.
+   *  The target attribute is mandatory when the result is rendered.
    * @param aTarget a Node identifying the target
    * @see #isValidTarget(javax.jcr.Node)
    */
@@ -376,72 +385,72 @@ export interface LinkRenderer {
 
   /**
    * Sets what the link target is, i.e "what the link links to" (href attribute on the a element).
-   * The target attribute is mandatory when the result is rendered.
+   *  The target attribute is mandatory when the result is rendered.
    * @param aTarget a String identifying the target (i.e "http://xyz.com", "?name=a&amp;value=b", "/images/a.gif", "#anchor")
    */
-  setStringTarget(aTarget: string): void;
+  setStringTarget(aTarget: String | string): void;
 
   /**
    * Checks if a Node is a renderable target or not (node type accepted).
    *
-   * <p>
-   *    This method can be used to avoid updating this renderer with nodes that can't be rendered. Since nodes that aren't
-   *    renderable will be ignored, updating the renderer with such nodes will result in rendering of previous target.
-   * </p>
+   *  <p>
+   *     This method can be used to avoid updating this renderer with nodes that can't be rendered. Since nodes that aren't
+   *     renderable will be ignored, updating the renderer with such nodes will result in rendering of previous target.
+   *  </p>
    *
-   * <p>
-   *    <code>LinkRenderer</code> will accept nodes with the following primary node type as targets
-   *    (i.e. this method will return <code>true</code> for such nodes):
-   * </p>
-   * <ul>
-   *    <li><code>sv:article</code></li>
-   *    <li><code>sv:collaborationGroup</code></li>
-   *    <li><code>sv:collaborationGroupPage</code></li>
-   *    <li><code>sv:collaborationGroupTemplate</code></li>
-   *    <li><code>sv:file</code></li>
-   *    <li><code>sv:image</code></li>
-   *    <li><code>sv:link</code> <em>(the actual target of the link must also be a valid target)</em></li>
-   *    <li><code>sv:page</code></li>
-   *    <li><code>sv:sitePage</code></li>
-   *    <li><code>sv:structureLink</code> <em>(the actual target of the structure link must also be a valid target)</em></li>
-   *    <li><code>sv:structurePage</code></li>
-   *    <li><code>sv:systemUser</code> <em>(the system user must have a mail address)</em></li>
-   *    <li><code>sv:template</code></li>
-   *    <li><code>sv:user</code> <em>(the user must have a mail address)</em></li>
-   *    <li><code>sv:userIdentity</code> <em>(the site must have a profile page, or backing user must have a mail address)</em></li>
-   * </ul>
+   *  <p>
+   *     <code>LinkRenderer</code> will accept nodes with the following primary node type as targets
+   *     (i.e. this method will return <code>true</code> for such nodes):
+   *  </p>
+   *  <ul>
+   *     <li><code>sv:article</code></li>
+   *     <li><code>sv:collaborationGroup</code></li>
+   *     <li><code>sv:collaborationGroupPage</code></li>
+   *     <li><code>sv:collaborationGroupTemplate</code></li>
+   *     <li><code>sv:file</code></li>
+   *     <li><code>sv:image</code></li>
+   *     <li><code>sv:link</code> <em>(the actual target of the link must also be a valid target)</em></li>
+   *     <li><code>sv:page</code></li>
+   *     <li><code>sv:sitePage</code></li>
+   *     <li><code>sv:structureLink</code> <em>(the actual target of the structure link must also be a valid target)</em></li>
+   *     <li><code>sv:structurePage</code></li>
+   *     <li><code>sv:systemUser</code> <em>(the system user must have a mail address)</em></li>
+   *     <li><code>sv:template</code></li>
+   *     <li><code>sv:user</code> <em>(the user must have a mail address)</em></li>
+   *     <li><code>sv:userIdentity</code> <em>(the site must have a profile page, or backing user must have a mail address)</em></li>
+   *  </ul>
    *
-   * <p>
-   * Always use this method if you are not sure all nodes you are rendering will be accepted as targets.
-   * </p>
+   *  <p>
+   *  Always use this method if you are not sure all nodes you are rendering will be accepted as targets.
+   *  </p>
    *
-   * <p>
-   * <strong>Example:</strong><br>
-   * Velocity code like this:
-   * </p>
-   * <pre><code>&lt;ul style="list-style:none"&gt;
-   * #foreach ($node in $myNodes)
-   *    <em>## Update the renderer and render</em>
-   *    $linkRenderer.update($node)
-   *    &lt;li&gt;$linkRenderer.render()&lt;/li&gt;
-   *#end
-   *&lt;/ul&gt;</code></pre>
-   * could be replaced with Velocity code like this:<pre><code>&lt;ul style="list-style:none"&gt;
-   * #foreach ($node in $myNodes)
-   *    <em>## Ensure node actually can be rendered</em>
-   *    #if ($linkRenderer.isRenderableTarget($node))
-   *       <em>## Update the renderer and render</em>
-   *       $linkRenderer.update($node)
-   *       &lt;li&gt;$linkRenderer.render()&lt;/li&gt;
-   *    #end
+   *  <p>
+   *  <strong>Example:</strong><br>
+   *  Velocity code like this:
+   *  </p>
+   *  <pre><code>&lt;ul style="list-style:none"&gt;
+   *  #foreach ($node in $myNodes)
+   *     <em>## Update the renderer and render</em>
+   *     $linkRenderer.update($node)
+   *     &lt;li&gt;$linkRenderer.render()&lt;/li&gt;
    * #end
    * &lt;/ul&gt;</code></pre>
+   *  could be replaced with Velocity code like this:<pre><code>&lt;ul style="list-style:none"&gt;
+   *  #foreach ($node in $myNodes)
+   *     <em>## Ensure node actually can be rendered</em>
+   *     #if ($linkRenderer.isRenderableTarget($node))
+   *        <em>## Update the renderer and render</em>
+   *        $linkRenderer.update($node)
+   *        &lt;li&gt;$linkRenderer.render()&lt;/li&gt;
+   *     #end
+   *  #end
+   *  &lt;/ul&gt;</code></pre>
    *
-   * <p>
-   *    <em>Performance note!</em> Calling this method prior to calling an <code>update</code> method (or the <code>setTarget</code> method)
-   *    will not have any noticeable negative performance impact. The result of this method is internally cached and the <code>update</code>
-   *    methods (and the <code>setTarget</code> method) will re-use that cached data.
-   * </p>
+   *  <p>
+   *     <em>Performance note!</em> Calling this method prior to calling an <code>update</code> method (or the <code>setTarget</code> method)
+   *     will not have any noticeable negative performance impact. The result of this method is internally cached and the <code>update</code>
+   *     methods (and the <code>setTarget</code> method) will re-use that cached data.
+   *  </p>
    * @param aNode the node to check
    * @return <code>true</code> if <code>aNode</code> is a target that can be rendered, <code>false</code> if not
    * @since Sitevision 3.0
@@ -452,42 +461,42 @@ export interface LinkRenderer {
   /**
    * Checks if a Node is a valid target or not (node type accepted and target is valid).
    *
-   * <p>
-   * This method is similar to the {@link senselogic.sitevision.api.render.LinkRenderer#isRenderableTarget(javax.jcr.Node)} method,
-   * but this method does more extensive checking to ensure rendered links will be ok. <em>Note! "External" link targets (e.g.
-   * a link to "www.whatever.com") of a sv:link Node will NOT be checked.</em>
-   * </p>
-   * <p>
-   * This method can be used to avoid updating this renderer with nodes that can't be rendered or nodes that have invalid targets.
-   * An invalid target is typically an existing link that has an empty or trashed target (i.e. target is in trashcan).
-   * </p>
+   *  <p>
+   *  This method is similar to the {@link senselogic.sitevision.api.render.LinkRenderer#isRenderableTarget(javax.jcr.Node)} method,
+   *  but this method does more extensive checking to ensure rendered links will be ok. <em>Note! "External" link targets (e.g.
+   *  a link to "www.whatever.com") of a sv:link Node will NOT be checked.</em>
+   *  </p>
+   *  <p>
+   *  This method can be used to avoid updating this renderer with nodes that can't be rendered or nodes that have invalid targets.
+   *  An invalid target is typically an existing link that has an empty or trashed target (i.e. target is in trashcan).
+   *  </p>
    *
-   * <p>
-   * <strong>Example:</strong><br>
-   * Velocity code like this:
-   * </p>
-   * <pre><code>&lt;ul style="list-style:none"&gt;
-   * #foreach ($node in $myNodes)
-   *    <em>## Update the renderer and render</em>
-   *    $linkRenderer.update($node)
-   *    &lt;li&gt;$linkRenderer.render()&lt;/li&gt;
-   *#end
-   *&lt;/ul&gt;</code></pre>
-   * could be replaced with Velocity code like this:<pre><code>&lt;ul style="list-style:none"&gt;
-   * #foreach ($node in $myNodes)
-   *    <em>## Ensure node actually can be rendered</em>
-   *    #if ($linkRenderer.isValidTarget($node))
-   *       <em>## Update the renderer and render</em>
-   *       $linkRenderer.update($node)
-   *       &lt;li&gt;$linkRenderer.render()&lt;/li&gt;
-   *    #end
+   *  <p>
+   *  <strong>Example:</strong><br>
+   *  Velocity code like this:
+   *  </p>
+   *  <pre><code>&lt;ul style="list-style:none"&gt;
+   *  #foreach ($node in $myNodes)
+   *     <em>## Update the renderer and render</em>
+   *     $linkRenderer.update($node)
+   *     &lt;li&gt;$linkRenderer.render()&lt;/li&gt;
    * #end
    * &lt;/ul&gt;</code></pre>
+   *  could be replaced with Velocity code like this:<pre><code>&lt;ul style="list-style:none"&gt;
+   *  #foreach ($node in $myNodes)
+   *     <em>## Ensure node actually can be rendered</em>
+   *     #if ($linkRenderer.isValidTarget($node))
+   *        <em>## Update the renderer and render</em>
+   *        $linkRenderer.update($node)
+   *        &lt;li&gt;$linkRenderer.render()&lt;/li&gt;
+   *     #end
+   *  #end
+   *  &lt;/ul&gt;</code></pre>
    *
-   * <p>
-   * <em>Performance note!</em> Avoid subsequent calls to this method for same <code>Node</code>. If performance is a top
-   * priority, consider using {@link senselogic.sitevision.api.render.LinkRenderer#isRenderableTarget(javax.jcr.Node)} instead.
-   * </p>
+   *  <p>
+   *  <em>Performance note!</em> Avoid subsequent calls to this method for same <code>Node</code>. If performance is a top
+   *  priority, consider using {@link senselogic.sitevision.api.render.LinkRenderer#isRenderableTarget(javax.jcr.Node)} instead.
+   *  </p>
    * @param aNode the node to check
    * @return <code>true</code> if <code>aNode</code> is a target that can be rendered as a functional link, <code>false</code> if not
    * @since Sitevision 2.6.2
@@ -497,21 +506,21 @@ export interface LinkRenderer {
 
   /**
    * Sets the class name the link should use (class attribute on the a element).
-   * The fontClass attribute is mandatory when the result is rendered.
+   *  The fontClass attribute is mandatory when the result is rendered.
    * @param aFontClass the class name of the font to use
    */
-  setFontClass(aFontClass: string): void;
+  setFontClass(aFontClass: String | string): void;
 
   /**
    * Sets the class name the link should use (class attribute on an a element) based on a given font node.
    *
-   * <p>
-   *    The actual font class is extracted from aFontNode and if aFontNode is <code>null</code> or not a valid font node the
-   *    font class will not be set.
-   * </p>
-   * <p>
-   *    When subsequently setting the font class, use the {@link #setFontClass(String)} method instead for best performance.
-   * </p>
+   *  <p>
+   *     The actual font class is extracted from aFontNode and if aFontNode is <code>null</code> or not a valid font node the
+   *     font class will not be set.
+   *  </p>
+   *  <p>
+   *     When subsequently setting the font class, use the {@link #setFontClass(String)} method instead for best performance.
+   *  </p>
    * @param aFontNode the font node that has a font class that can be extracted
    * @see #setFontClass(String)
    */
@@ -519,21 +528,21 @@ export interface LinkRenderer {
 
   /**
    * Sets the text that the link should display, i.e. "the text the user clicks on".
-   * The text attribute is mandatory when the result is rendered.
+   *  The text attribute is mandatory when the result is rendered.
    * @param aText a link text
    */
-  setText(aText: string): void;
+  setText(aText: String | string): void;
 
   /**
    * Sets the title the link should have (title attribute on the a element).
    *
-   * <p>
-   * If there are no title (i.e. it is <code>null</code>) when the result is rendered, it will get the same
-   * value as text attribute if autoTitle is activated, otherwise it will be empty. Default is <code>null</code>.
-   * </p>
+   *  <p>
+   *  If there are no title (i.e. it is <code>null</code>) when the result is rendered, it will get the same
+   *  value as text attribute if autoTitle is activated, otherwise it will be empty. Default is <code>null</code>.
+   *  </p>
    * @param aTitle a title describing the link
    */
-  setTitle(aTitle: string): void;
+  setTitle(aTitle: String | string): void;
 
   /**
    * Removes the title, i.e. executes <code>setTitle(null)</code>
@@ -543,10 +552,10 @@ export interface LinkRenderer {
 
   /**
    * Sets the css style the link should have (style attribute on the a element).
-   * The style attribute is optional when the result is rendered. Default is <code>null</code>.
+   *  The style attribute is optional when the result is rendered. Default is <code>null</code>.
    * @param aStyle the style of the link
    */
-  setStyle(aStyle: string): void;
+  setStyle(aStyle: String | string): void;
 
   /**
    * Removes the style, i.e executes <code>setStyle(null)</code>
@@ -559,7 +568,7 @@ export interface LinkRenderer {
    * @param aLang a single language code
    * @since Sitevision 2022.10.1
    */
-  setLang(aLang: string): void;
+  setLang(aLang: String | string): void;
 
   /**
    * Removes the lang, i.e executes <code>setLang(null)</code>
@@ -573,7 +582,7 @@ export interface LinkRenderer {
    * @param aHrefLang a single language code
    * @since Sitevision 2022.10.1
    */
-  setHrefLang(aHrefLang: string): void;
+  setHrefLang(aHrefLang: String | string): void;
 
   /**
    * Removes the hreflang, i.e executes <code>setHrefLang(null)</code>
@@ -585,17 +594,17 @@ export interface LinkRenderer {
   /**
    * Adds target parameters (key=value) to the link target (href attribute on the a element).
    *
-   * <p>
-   *    Target parameters is optional when the result is rendered. Default is no target parameters.
-   * </p>
-   * <p>
-   *    There can only be one target parameter per key (i.e. when a target parameter is added it will always replace the possibly existing
-   *    target parameter that already use that key).
-   * </p>
+   *  <p>
+   *     Target parameters is optional when the result is rendered. Default is no target parameters.
+   *  </p>
+   *  <p>
+   *     There can only be one target parameter per key (i.e. when a target parameter is added it will always replace the possibly existing
+   *     target parameter that already use that key).
+   *  </p>
    * @param key the key of the target parameter
    * @param value the value of the target parameter
    */
-  addTargetParameter(key: string, value: string): void;
+  addTargetParameter(key: String | string, value: String | string): void;
 
   /**
  * Removes all existing target parameters
@@ -605,7 +614,7 @@ export interface LinkRenderer {
 
   /**
    * Should target parameters be URL encoded or not?
-   * Default is <code>true</code>.
+   *  Default is <code>true</code>.
    * @param performParameterEncoding whether parameters should be URL encoded or not.
    * @see senselogic.sitevision.api.text.EndecUtil#encodeURL(String)
    * @since Sitevision 3.0
@@ -628,35 +637,35 @@ export interface LinkRenderer {
 
   /**
    * Adds an HTML5 data-* attribute to the link element.
-   * Data attributes is optional when the result is rendered. Default is no data attributes.
-   * <p>
-   *    There can only be one data attribute per name (i.e. when a data attribute is added it will always replace the possibly existing
-   *    data attribute that already use that name).
-   * </p>
+   *  Data attributes is optional when the result is rendered. Default is no data attributes.
+   *  <p>
+   *     There can only be one data attribute per name (i.e. when a data attribute is added it will always replace the possibly existing
+   *     data attribute that already use that name).
+   *  </p>
    *
-   * <p>
-   *    Notes about names and values:
-   * </p>
-   * <ul>
-   *    <li>
-   *       A <strong>name</strong> that is <code>null</code> or <em>whitespace-only</em> will be completely ignored,
-   *       i.e. no data attribute will be rendered.
-   *    </li>
-   *    <li>
-   *       A <strong>name</strong> that isn't properly prefixed with <em>"data-"</em> will be prefixed when the data attribute is rendered.
-   *    </li>
-   *    <li>
-   *       A <strong>value</strong> that is <code>null</code> or <em>whitespace-only</em> will be rendered as a data attribute without value.
-   *    </li>
-   *    <li>
-   *       A <strong>value</strong> should not be escaped/encoded. The <em>useEncoding</em> attribute will determine what to do
-   *       when the data attributes are rendered.
-   * </ul>
+   *  <p>
+   *     Notes about names and values:
+   *  </p>
+   *  <ul>
+   *     <li>
+   *        A <strong>name</strong> that is <code>null</code> or <em>whitespace-only</em> will be completely ignored,
+   *        i.e. no data attribute will be rendered.
+   *     </li>
+   *     <li>
+   *        A <strong>name</strong> that isn't properly prefixed with <em>"data-"</em> will be prefixed when the data attribute is rendered.
+   *     </li>
+   *     <li>
+   *        A <strong>value</strong> that is <code>null</code> or <em>whitespace-only</em> will be rendered as a data attribute without value.
+   *     </li>
+   *     <li>
+   *        A <strong>value</strong> should not be escaped/encoded. The <em>useEncoding</em> attribute will determine what to do
+   *        when the data attributes are rendered.
+   *  </ul>
    * @param aName the name of the data attribute
    * @param aValue the value of the data attribute
    * @since Sitevision 3.0
    */
-  addDataAttribute(aName: string, aValue: string): void;
+  addDataAttribute(aName: String | string, aValue: String | string): void;
 
   /**
    * Removes all existing data attributes
@@ -666,10 +675,10 @@ export interface LinkRenderer {
 
   /**
    * Sets what access key the link should have (accesskey attribute on the a element)
-   * The accesskey attribute is optional when the result is rendered. Default is <code>null</code>.
+   *  The accesskey attribute is optional when the result is rendered. Default is <code>null</code>.
    * @param anAccessKey the access key that should be used
    */
-  setAccessKey(anAccessKey: string): void;
+  setAccessKey(anAccessKey: String | string): void;
 
   /**
    * Removes the accesskey, i.e. executes <code>setAccessKey(null)</code>
@@ -679,10 +688,10 @@ export interface LinkRenderer {
 
   /**
    * Sets the rel that should be used (rel attribute on the a element)
-   * The rel attribute is optional when the result is rendered. Default is <code>null</code>.
+   *  The rel attribute is optional when the result is rendered. Default is <code>null</code>.
    * @param aRel the rel that should be used. Note! If "external" is used, the rendered link will be opened in a new window via JavaScript
    */
-  setRel(aRel: string): void;
+  setRel(aRel: String | string): void;
 
   /**
    * Removes the rel value, i.e executes <code>setRel(null)</code>
@@ -692,12 +701,12 @@ export interface LinkRenderer {
 
   /**
    * Sets the onclick value (onclick attribute and onkeypress attribute on the a element), typically some kind of Javascript
-   * The onclick attribute is optional when the result is rendered. Default is <code>null</code>.
+   *  The onclick attribute is optional when the result is rendered. Default is <code>null</code>.
    *
-   * <p><em>Note!</em> The events (onclick, onkeypress) will be added with non-obtrusive javascript when render() is called.</p>
+   *  <p><em>Note!</em> The events (onclick, onkeypress) will be added with non-obtrusive javascript when render() is called.</p>
    * @param anOnclick the onClick value that should be used
    */
-  setOnclick(anOnclick: string): void;
+  setOnclick(anOnclick: String | string): void;
 
   /**
    * Removes the onclick value, i.e executes <code>setOnclick(null)</code>
@@ -707,20 +716,20 @@ export interface LinkRenderer {
 
   /**
    * Sets the id value (id attribute on the a element), most likely only needed if some kind of javascript/ajax code needs to access the
-   * rendered link via its id.
+   *  rendered link via its id.
    *
-   * <p>
-   *    The id attribute is optional when the result is rendered. Default is <code>null</code>.
-   * </p>
-   * <p>
-   *    This method does <em>not</em> perform any checks of the id. All values will be accepted.
-   *    <em>(Note! A valid id should be unique - i.e. should not appear more than once in a html/xhtml document - and not all characters are allowed.
-   *    See <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#sec-attribute-types">W3C 3.3.1 Attribute types</a>.)</em>
-   * </p>
+   *  <p>
+   *     The id attribute is optional when the result is rendered. Default is <code>null</code>.
+   *  </p>
+   *  <p>
+   *     This method does <em>not</em> perform any checks of the id. All values will be accepted.
+   *     <em>(Note! A valid id should be unique - i.e. should not appear more than once in a html/xhtml document - and not all characters are allowed.
+   *     See <a href="http://www.w3.org/TR/2006/REC-xml-20060816/#sec-attribute-types">W3C 3.3.1 Attribute types</a>.)</em>
+   *  </p>
    * @param anId the id value that should be used
    * @since Sitevision 3.0
    */
-  setId(anId: string): void;
+  setId(anId: String | string): void;
 
   /**
    * Removes the id value, i.e executes <code>setId(null)</code>
@@ -731,7 +740,7 @@ export interface LinkRenderer {
 
   /**
    * Use icons for "external", "new window" and "new window, external" according to Site's settings or not.
-   * Default is <code>true</code>.
+   *  Default is <code>true</code>.
    * @param useLinkDecorationSettings whether or not Site's settings for link type icons should be used
    */
   setUseLinkDecorationSettings(useLinkDecorationSettings: boolean): void;
@@ -750,7 +759,7 @@ export interface LinkRenderer {
 
   /**
    * Use icons/descriptions for known file types according to Site's settings or not.
-   * Default is <code>true</code>.
+   *  Default is <code>true</code>.
    * @param useResourceDecorationSettings whether or not Site's settings for icons/descriptions for known file types should be used
    */
   setUseResourceDecorationSettings(
@@ -771,7 +780,7 @@ export interface LinkRenderer {
 
   /**
    * Should the link target be opened in a new window or not?
-   * Default is <code>false</code>.
+   *  Default is <code>false</code>.
    * @param openNewWindow whether or not the link target should be opened in a new window
    */
   setOpenNewWindow(openNewWindow: boolean): void;
@@ -790,7 +799,7 @@ export interface LinkRenderer {
 
   /**
    * Should the browser download the link target instead of navigating to it?
-   * Default is <code>false</code>.
+   *  Default is <code>false</code>.
    * @param useDownload whether a browser is suggested to download the link target directly
    * @since Sitevision 5.2
    */
@@ -812,7 +821,7 @@ export interface LinkRenderer {
 
   /**
    * Should text and attributes be properly encoded or not?
-   * Default is <code>true</code>.
+   *  Default is <code>true</code>.
    * @param performEncoding whether text should be encoded or not.
    */
   setUseEncoding(performEncoding: boolean): void;
@@ -831,8 +840,8 @@ export interface LinkRenderer {
 
   /**
    * Ensures title always will have a value. If non-existing, the title will be set to the title of the target target (or
-   * the same as the linked text if the target isn't a page or the title of the page is lacking)
-   * Default is <code>false</code>.
+   *  the same as the linked text if the target isn't a page or the title of the page is lacking)
+   *  Default is <code>false</code>.
    * @param useAutoTitle whether or not the link always should get the title automatically if title is missing
    */
   setUseAutoTitle(useAutoTitle: boolean): void;
@@ -852,14 +861,14 @@ export interface LinkRenderer {
   /**
    * Should cross-site internal Node links be handled or not?
    *
-   * <p>
-   *    Default is <code>false</code>.
-   * </p>
-   * <p>
-   *    <em>Note! For best performance: enable only if your site actually contains internal links to
-   *    pages on other sites (e.g. The System user creates an internal link and selects a page
-   *    on another site in the target browse tree).</em>
-   * </p>
+   *  <p>
+   *     Default is <code>false</code>.
+   *  </p>
+   *  <p>
+   *     <em>Note! For best performance: enable only if your site actually contains internal links to
+   *     pages on other sites (e.g. The System user creates an internal link and selects a page
+   *     on another site in the target browse tree).</em>
+   *  </p>
    * @param useCrossSiteTargetChecking whether or not to check for cross-site Node targets
    * @since Sitevision 3.0.2
    */