@sitevision/api 1.0.20 → 1.1.0-alpha.1

package/server/PropertyUtil/index.d.ts

@@ -1,458 +1,2382 @@
-import Binary from '../../builtins/Binary';
-import Calendar from '../../builtins/Calendar';
-import List from '../../builtins/List';
-import Node from '../../builtins/Node';
+import Node from "../../hidden/javax/jcr/Node";
+import Binary from "../../hidden/javax/jcr/Binary";
 
 /**
-* Gets a Binary property from a Node.
-* @returns {Binary} the value for aPropertyName as Binary. If no property exists, null is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-*/
+ * Gets a String property from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code> has a
+ * <code>String</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @return the value for aPropertyName as <code>String</code>. If no property exists, <code>null</code> is returned.
+ * @see #getNestedStringEscaped(javax.jcr.Node, String, String)
+ */
+export function getNestedString(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string
+): string;
+
+/**
+ * Gets a String property from a "nested" Node's property and returns it XML escaped.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code> has a
+ * <code>String</code> property).
+ *
+ * <p>
+ *    This is a convenience method for getting a "nested" String property that also should be XML escaped. A String that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $endecUtil.escapeXML($propertyUtil.getNestedString($myNode, 'aNodeProperty', 'aProperty'))
+ *    &lt;/p&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $!propertyUtil.getNestedStringEscaped($myNode, 'aNodeProperty', 'aProperty')
+ *    &lt;/p&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @return the value for aPropertyName as an XML escaped <code>String</code>. If no property exists, <code>null</code> is returned.
+ * @see #getNestedString(javax.jcr.Node, String, String)
+ * @see senselogic.sitevision.api.text.EndecUtil#escapeXML(String)
+ * @since Sitevision 3.5
+ */
+export function getNestedStringEscaped(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string
+): string;
+
+/**
+ * Gets a String property from a "nested" Node's property with a fallback value if the property doesn't exist.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code> has a
+ * <code>String</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @param aDefaultValue fallback value if no value exists
+ * @return the value for aPropertyName as <code>String</code>. If no property exists, aDefaultValue is returned.
+ * @see #getNestedStringEscaped(javax.jcr.Node, String, String, String)
+ */
+export function getNestedString(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string,
+  aDefaultValue: string
+): string;
+
+/**
+ * Gets a String property from a "nested" Node's property with a fallback value if the property doesn't exist, and returns it XML escaped.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>String</code> property).
+ *
+ * <p>
+ *    This is a convenience method for getting a "nested" String property that also should be XML escaped. A String that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $endecUtil.escapeXML($propertyUtil.getNestedString($myNode, 'aNodeProperty', 'aProperty', 'a default value'))
+ *    &lt;/p&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $propertyUtil.getNestedStringEscaped($myNode, 'aNodeProperty', 'aProperty', 'a default value')
+ *    &lt;/p&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @param aDefaultValue a (non XML escaped) fallback value if no value exists
+ * @return the value for aPropertyName as an XML escaped <code>String</code>. If no property exists, aDefaultValue is XML escaped and returned.
+ * @see #getNestedString(javax.jcr.Node, String, String, String)
+ * @see senselogic.sitevision.api.text.EndecUtil#escapeXML(String)
+ * @since Sitevision 3.5
+ */
+export function getNestedStringEscaped(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string,
+  aDefaultValue: string
+): string;
+
+/**
+ * Gets an int property from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has an <code>int/Integer</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @return the value for aPropertyName as <code>int</code>. If no property exists or it isn't compatible with an <code>int</code>, 0 is returned.
+ */
+export function getNestedInt(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string
+): number;
+
+/**
+ * Gets an int property from a "nested" Node's property with a fallback value if the property doesn't exist or is incompatible with the int type.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has an <code>int/Integer</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @param aDefaultValue fallback value if no value exists
+ * @return the value for aPropertyName as <code>int</code>. If no property exists or it isn't compatible with an <code>int</code>, aDefaultValue is returned.
+ */
+export function getNestedInt(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string,
+  aDefaultValue: number
+): number;
+
+/**
+ * Gets a double property from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>double/Double</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @return the value for aPropertyName as <code>double</code>. If no property exists or it isn't compatible with a <code>double</code>, 0.0 is returned.
+ * @since Sitevision 2.6.1_09
+ */
+export function getNestedDouble(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string
+): number;
+
+/**
+ * Gets a double property from a "nested" Node's property with a fallback value if the property doesn't exist or is incompatible
+ * with the double type.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>double/Double</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @param aDefaultValue fallback value if no value exists
+ * @return the value for aPropertyName as <code>double</code>. If no property exists or it isn't compatible with a <code>double</code>, aDefaultValue is returned.
+ * @since Sitevision 2.6.1_09
+ */
+export function getNestedDouble(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string,
+  aDefaultValue: number
+): number;
+
+/**
+ * Gets a boolean property from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Boolean</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @return the value for aPropertyName as <code>boolean</code>. If no property exists or it isn't compatible with a <code>boolean</code>, <code>false</code> is returned.
+ */
+export function getNestedBoolean(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string
+): boolean;
+
+/**
+ * Gets a boolean property from a "nested" Node's property with a fallback value if the property doesn't exist or is incompatible
+ * with the boolean type.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Boolean</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @param aDefaultValue fallback value if no value exists
+ * @return the value for aPropertyName as <code>boolean</code>. If no property exists or it isn't compatible with a <code>boolean</code>, aDefaultValue is returned.
+ */
+export function getNestedBoolean(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string,
+  aDefaultValue: boolean
+): boolean;
+
+/**
+ * Gets a Node property from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Node</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @return the value for aPropertyName as <code>Node</code>. If no property exists or it isn't a <code>Node</code>, <code>null</code> is returned.
+ */
+export function getNestedNode(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string
+): Node;
+
+/**
+ * Gets a Node property from a "nested" Node's property with a fallback value if the property doesn't exist.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Node</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @param aDefaultValue fallback value if no value exists
+ * @return the value for aPropertyName as <code>Node</code>. If no property exists or it isn't a <code>Node</code>, aDefaultValue is returned.
+ */
+export function getNestedNode(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string,
+  aDefaultValue: Node
+): Node;
+
+/**
+ * Gets a Binary property from a Node.
+ *
+ * <p>
+ *    Ensure to always handle resources appropriately when working with Binary! If you get a stream via {@link javax.jcr.Binary#getStream()},
+ *    you must also <code>close</code> the stream when you are done.
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> The <code>Binary</code> support is limited, see {@link javax.jcr.Property#getBinary()} for more information!
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @return the value for aPropertyName as <code>Binary</code>. If no property exists, <code>null</code> is returned.
+ * @since Sitevision 3.5
+ */
 export function getBinary(aNode: Node, aPropertyName: string): Binary;
 
 /**
-* Gets a Binary property from a node with a fallback value if the property doesn't exist.
-* @returns {Binary} the value for aPropertyName as Binary. If no property exists, aDefaultValue is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-* @param {Binary} aDefaultValue - fallback value if no value exists
-*/
-export function getBinary(aNode: Node, aPropertyName: string, aDefaultValue: Binary): Binary;
+ * Gets a Binary property from a node with a fallback value if the property doesn't exist.
+ *
+ * <p>
+ *    Ensure to always handle resources appropriately when working with Binary! If you get a stream via {@link javax.jcr.Binary#getStream()},
+ *    you must also <code>close</code> the stream when you are done.
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> The <code>Binary</code> support is limited, see {@link javax.jcr.Property#getBinary()} for more information!
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @param aDefaultValue fallback value if no value exists
+ * @return the value for aPropertyName as <code>Binary</code>. If no property exists, aDefaultValue is returned.
+ * @since Sitevision 3.5
+ */
+export function getBinary(
+  aNode: Node,
+  aPropertyName: string,
+  aDefaultValue: Binary
+): Binary;
 
 /**
-* Gets a boolean property from a Node.
-* @returns {boolean} the value for aPropertyName as boolean. If no property exists or it isn't compatible with a boolean,false is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-*/
-export function getBoolean(aNode: Node, aPropertyName: string): boolean;
+ * Gets a Binary property from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Binary</code> property).
+ *
+ * <p>
+ *    Ensure to always handle resources appropriately when working with Binary! If you get a stream via {@link javax.jcr.Binary#getStream()},
+ *    you must also <code>close</code> the stream when you are done.
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> The <code>Binary</code> support is limited, see {@link javax.jcr.Property#getBinary()} for more information!
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on <code>aNode</code>
+ * @param aPropertyName the name of the Binary property for the "inner/nested" <code>Node</code>
+ * @return the value for aPropertyName as <code>Binary</code>. If no property exists or it isn't a <code>Binary</code>, <code>null</code> is returned.
+ * @since Sitevision 3.5
+ */
+export function getNestedBinary(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string
+): Binary;
+
+/**
+ * Gets a Binary property from a "nested" Node's property with a fallback value if the property doesn't exist.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Binary</code> property).
+ *
+ * <p>
+ *    Ensure to always handle resources appropriately when working with Binary! If you get a stream via {@link javax.jcr.Binary#getStream()},
+ *    you must also <code>close</code> the stream when you are done.
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> The <code>Binary</code> support is limited, see {@link javax.jcr.Property#getBinary()} for more information!
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on <code>aNode</code>
+ * @param aPropertyName the name of the Binary property for the "inner/nested" <code>Node</code>
+ * @param aDefaultValue fallback value if no value exists
+ * @return the value for aPropertyName as <code>Binary</code>. If no property exists or it isn't a <code>Binary</code>, aDefaultValue is returned.
+ * @since Sitevision 3.5
+ */
+export function getNestedBinary(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string,
+  aDefaultValue: Binary
+): Binary;
 
 /**
-* Gets a boolean property from a Node with a fallback value if the property doesn't exist or is incompatible with the boolean type.
-* @returns {boolean} the value for aPropertyName as boolean. If no property exists or it isn't compatible with a boolean,aDefaultValue is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-* @param {boolean} aDefaultValue - fallback value if no value exists
-*/
-export function getBoolean(aNode: Node, aPropertyName: string, aDefaultValue: boolean): boolean;
+ * Gets a String property from a Node.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @return the value for aPropertyName as <code>String</code>. If no property exists, <code>null</code> is returned.
+ * @see #getStringEscaped(javax.jcr.Node, String)
+ */
+export function getString(aNode: Node, aPropertyName: string): string;
 
 /**
-* Gets a Calendar property from a Node.
-* @returns {Calendar} the value for aPropertyName as Calendar. If no property exists or it isn't a Calendar,null is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-*/
-export function getCalendar(aNode: Node, aPropertyName: string): Calendar;
+ * Gets a String property from a Node and returns it XML escaped.
+ *
+ * <p>
+ *    This is a convenience method for getting a String property that also should be XML escaped. A String that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $endecUtil.escapeXML($propertyUtil.getString($myNode, 'aProperty'))
+ *    &lt;/p&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $!propertyUtil.getStringEscaped($myNode, 'aProperty')
+ *    &lt;/p&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @return the value for aPropertyName as an XML escaped <code>String</code>. If no property exists, <code>null</code> is returned.
+ * @see #getString(javax.jcr.Node, String)
+ * @see senselogic.sitevision.api.text.EndecUtil#escapeXML(String)
+ * @since Sitevision 3.5
+ */
+export function getStringEscaped(aNode: Node, aPropertyName: string): string;
 
 /**
-* Gets a Calendar property from a Node with a fallback value if the property doesn't exist or is incompatible with the Calendar type.
-* @returns {Calendar} the value for aPropertyName as Calendar. If no property exists or it isn't compatible with a Calendar,aDefaultValue is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-* @param {Calendar} aDefaultValue - fallback value if no value exists
-*/
-export function getCalendar(aNode: Node, aPropertyName: string, aDefaultValue: Calendar): Calendar;
+ * Gets a String property from a node with a fallback value if the property doesn't exist.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @param aDefaultValue fallback value if no value exists
+ * @return the value for aPropertyName as <code>String</code>. If no property exists, aDefaultValue is returned.
+ * @see #getStringEscaped(javax.jcr.Node, String, String)
+ */
+export function getString(
+  aNode: Node,
+  aPropertyName: string,
+  aDefaultValue: string
+): string;
 
 /**
-* Gets a double property from a Node.
-* @returns {number} the double value for aPropertyName. If no property exists or it isn't compatible with a double,0.0 is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-*/
-export function getDouble(aNode: Node, aPropertyName: string): number;
+ * Gets a String property from a Node, with a fallback value, and returns it XML escaped.
+ *
+ * <p>
+ *    This is a convenience method for getting a String property that also should be XML escaped. A String that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $endecUtil.escapeXML($propertyUtil.getString($myNode, 'aProperty', 'a default value'))
+ *    &lt;/p&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $propertyUtil.getStringEscaped($myNode, 'aProperty', 'a default value')
+ *    &lt;/p&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @param aDefaultValue a (non XML escaped) fallback value if no value exists
+ * @return the value for aPropertyName as an XML escaped <code>String</code>. If no property exists, aDefaultValue is XML escaped and returned.
+ * @see #getString(javax.jcr.Node, String, String)
+ * @see senselogic.sitevision.api.text.EndecUtil#escapeXML(String)
+ * @since Sitevision 3.5
+ */
+export function getStringEscaped(
+  aNode: Node,
+  aPropertyName: string,
+  aDefaultValue: string
+): string;
 
 /**
-* Gets a double property from a node with a fallback value if the property doesn't exist or is incompatible with the double type.
-* @returns {number} the double value for aPropertyName. If no property exists or it isn't compatible with a double,aDefaultValue is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-* @param {number} aDefaultValue - fallback value if no value exists
-*/
-export function getDouble(aNode: Node, aPropertyName: string, aDefaultValue: number): number;
-
-/**
-* Gets a Node property from a Node if an enabling property allows it.
-* @returns {Node} the value for aNodePropertyName as Node. If no property exists or it isn't a Node,null is returned.A Node will never be returned if aEnablingPropertyName doesn't exist, isn't compatible with aboolean or isn't true.
-* @param {Node} aNode - the Node that has the properties
-* @param {string} aEnablingPropertyName - the name of the boolean property that enables the Node denoted by aPropertyName
-* @param {string} aNodePropertyName - the name of the property
-*/
-export function getEnabledNode(aNode: Node, aEnablingPropertyName: string, aNodePropertyName: string): Node;
-
-/**
-* Gets a Node property from a Node if an enabling property allows it, with a fallback Node value.
-* @returns {Node} the value for aNodePropertyName as Node. If no property exists or it isn't a Node,aDefaultValue is returned.If aEnablingPropertyName doesn't exist, isn't compatible with a boolean or isn't true,aDefaultValue is returned.
-* @param {Node} aNode - the Node that has the properties
-* @param {string} aEnablingPropertyName - the name of the boolean property that enables the Node denoted by aPropertyName
-* @param {string} aNodePropertyName - the name of the property
-* @param {Node} aDefaultValue - fallback value if no value exists
-*/
-export function getEnabledNode(aNode: Node, aEnablingPropertyName: string, aNodePropertyName: string, aDefaultValue: Node): Node;
-
-/**
-* Gets a String property from a Node if an enabling boolean property allows it.
-* @returns {string} the value for aStringPropertyName as String. If no property exists, null is returned.Null will always be returned if aEnablingPropertyName doesn't exist, isn't compatible with a booleanor isn't true.
-* @param {Node} aNode - the Node that has the properties
-* @param {string} aEnablingPropertyName - the name of the boolean property that enables the String denoted by aStringPropertyName
-* @param {string} aStringPropertyName - the name of the String property
-*/
-export function getEnabledString(aNode: Node, aEnablingPropertyName: string, aStringPropertyName: string): string;
-
-/**
-* Gets a String property from a Node if an enabling boolean property allows it, with a fallback value.
-* @returns {string} the value for aStringPropertyName as String. If no property exists, aDefaultValue is returned. aDefaultValue will always be returned if aEnablingPropertyName doesn't exist, isn't compatible with a boolean or isn't true.
-* @param {Node} aNode - the Node that has the properties
-* @param {string} aEnablingPropertyName - the name of the boolean property that enables the String denoted by aStringPropertyName
-* @param {string} aStringPropertyName - the name of the String property
-* @param {string} aDefaultValue - fallback value to return if no value exist
-*/
-export function getEnabledString(aNode: Node, aEnablingPropertyName: string, aStringPropertyName: string, aDefaultValue: string): string;
-
-/**
-* Gets a String property from a Node if an enabling boolean property allows it, and returns it XML escaped.
-* @returns {string} the value for aStringPropertyName as a XML escaped String. If no property exists, null is returned. Null will always be returned if aEnablingPropertyName doesn't exist, isn't compatible with a boolean or isn't true.
-* @param {Node} aNode - the Node that has the properties
-* @param {string} aEnablingPropertyName - the name of the boolean property that enables the String denoted by aStringPropertyName
-* @param {string} aStringPropertyName - the name of the String property
-*/
-export function getEnabledStringEscaped(aNode: Node, aEnablingPropertyName: string, aStringPropertyName: string): string;
-
-/**
-* Gets a String property from a Node if an enabling boolean property allows it, and returns it XML escaped with a fallback value.
-* @returns {string} the value for aStringPropertyName as a XML escaped String. If no property exists, aDefaultValue isXML escaped and returned.aDefaultValue will always be XML escaped and returned if aEnablingPropertyName doesn't exist,isn't compatible with a boolean or isn't true.
-* @param {Node} aNode - the Node that has the properties
-* @param {string} aEnablingPropertyName - the name of the boolean property that enables the String denoted by aStringPropertyName
-* @param {string} aStringPropertyName - the name of the String property
-* @param {string} aDefaultValue - the (non XML escaped) fallback value to return if no value exist
-*/
-export function getEnabledStringEscaped(aNode: Node, aEnablingPropertyName: string, aStringPropertyName: string, aDefaultValue: string): string;
-
-/**
-* Gets an int property from a Node.
-* @returns {number} the int value for aPropertyName. If no property exists or it isn't compatible with an int, 0 is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-*/
+ * Gets an int property from a Node.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @return the <code>int</code> value for aPropertyName. If no property exists or it isn't compatible with an <code>int</code>, 0 is returned.
+ */
 export function getInt(aNode: Node, aPropertyName: string): number;
 
 /**
-* Gets an int property from a node with a fallback value if the property doesn't exist or is incompatible with the int type.
-* @returns {number} the int value for aPropertyName. If no property exists or it isn't compatible with an int,aDefaultValue is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-* @param {number} aDefaultValue - fallback value if no value exists
-*/
-export function getInt(aNode: Node, aPropertyName: string, aDefaultValue: number): number;
-
-/**
-* Gets a Binary property from a "nested" Node's property.
-* @returns {Binary} the value for aPropertyName as Binary. If no property exists or it isn't a Binary,null is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the Binary property for the "inner/nested" Node
-*/
-export function getNestedBinary(aNode: Node, aNodePropertyName: string, aPropertyName: string): Binary;
-
-/**
-* Gets a Binary property from a "nested" Node's property with a fallback value if the property doesn't exist.
-* @returns {Binary} the value for aPropertyName as Binary. If no property exists or it isn't a Binary, aDefaultValue is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the Binary property for the "inner/nested" Node
-* @param {Binary} aDefaultValue - fallback value if no value exists
-*/
-export function getNestedBinary(aNode: Node, aNodePropertyName: string, aPropertyName: string, aDefaultValue: Binary): Binary;
-
-/**
-* Gets a boolean property from a "nested" Node's property.
-* @returns {boolean} the value for aPropertyName as boolean. If no property exists or it isn't compatible with a boolean,false is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-*/
-export function getNestedBoolean(aNode: Node, aNodePropertyName: string, aPropertyName: string): boolean;
-
-/**
-* Gets a boolean property from a "nested" Node's property with a fallback value if the property doesn't exist or is incompatible
- with the boolean type.
-* @returns {boolean} the value for aPropertyName as boolean. If no property exists or it isn't compatible with a boolean, aDefaultValue is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-* @param {boolean} aDefaultValue - fallback value if no value exists
-*/
-export function getNestedBoolean(aNode: Node, aNodePropertyName: string, aPropertyName: string, aDefaultValue: boolean): boolean;
-
-/**
-* Gets a Calendar property from a "nested" Node's property.
-* @returns {Calendar} the value for aPropertyName as Calendar. If no property exists or it isn't a Calendar,null is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the Calendar property for the "inner/nested" Node
-*/
-export function getNestedCalendar(aNode: Node, aNodePropertyName: string, aPropertyName: string): Calendar;
-
-/**
-* Gets a Calendar property from a "nested" Node's property with a fallback value if the property doesn't exist.
-* @returns {Calendar} the value for aPropertyName as Calendar. If no property exists or it isn't a Calendar,aDefaultValue is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the Calendar property for the "inner/nested" Node
-* @param {Calendar} aDefaultValue - fallback value if no value exists
-*/
-export function getNestedCalendar(aNode: Node, aNodePropertyName: string, aPropertyName: string, aDefaultValue: Calendar): Calendar;
-
-/**
-* Gets a double property from a "nested" Node's property.
-* @returns {number} the value for aPropertyName as double. If no property exists or it isn't compatible with a double,0.0 is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-*/
-export function getNestedDouble(aNode: Node, aNodePropertyName: string, aPropertyName: string): number;
-
-/**
-* Gets a double property from a "nested" Node's property with a fallback value if the property doesn't exist or is incompatible
- with the double type.
-* @returns {number} the value for aPropertyName as double. If no property exists or it isn't compatible with a double, aDefaultValue is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-* @param {number} aDefaultValue - fallback value if no value exists
-*/
-export function getNestedDouble(aNode: Node, aNodePropertyName: string, aPropertyName: string, aDefaultValue: number): number;
-
-/**
-* Gets an int property from a "nested" Node's property.
-* @returns {number} the value for aPropertyName as int. If no property exists or it isn't compatible with an int, 0 is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-*/
-export function getNestedInt(aNode: Node, aNodePropertyName: string, aPropertyName: string): number;
-
-/**
-* Gets an int property from a "nested" Node's property with a fallback value if the property doesn't exist or is incompatible with the int type.
-* @returns {number} the value for aPropertyName as int. If no property exists or it isn't compatible with an int,aDefaultValue is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-* @param {number} aDefaultValue - fallback value if no value exists
-*/
-export function getNestedInt(aNode: Node, aNodePropertyName: string, aPropertyName: string, aDefaultValue: number): number;
-
-/**
-* Gets a Node property from a "nested" Node's property.
-* @returns {Node} the value for aPropertyName as Node. If no property exists or it isn't a Node, null is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-*/
-export function getNestedNode(aNode: Node, aNodePropertyName: string, aPropertyName: string): Node;
-
-/**
-* Gets a Node property from a "nested" Node's property with a fallback value if the property doesn't exist.
-* @returns {Node} the value for aPropertyName as Node. If no property exists or it isn't a Node, aDefaultValue is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-* @param {Node} aDefaultValue - fallback value if no value exists
-*/
-export function getNestedNode(aNode: Node, aNodePropertyName: string, aPropertyName: string, aDefaultValue: Node): Node;
-
-/**
-* Gets a String property from a "nested" Node's property.
-* @returns {string} the value for aPropertyName as String. If no property exists, null is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-*/
-export function getNestedString(aNode: Node, aNodePropertyName: string, aPropertyName: string): string;
-
-/**
-* Gets a String property from a "nested" Node's property with a fallback value if the property doesn't exist.
-* @returns {string} the value for aPropertyName as String. If no property exists, aDefaultValue is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-* @param {string} aDefaultValue - fallback value if no value exists
-*/
-export function getNestedString(aNode: Node, aNodePropertyName: string, aPropertyName: string, aDefaultValue: string): string;
-
-/**
-* Gets a String property from a "nested" Node's property and returns it XML escaped.
-* @returns {string} the value for aPropertyName as an XML escaped String. If no property exists, null is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-*/
-export function getNestedStringEscaped(aNode: Node, aNodePropertyName: string, aPropertyName: string): string;
-
-/**
-* Gets a String property from a "nested" Node's property with a fallback value if the property doesn't exist, and returns it XML escaped.
-* @returns {string} the value for aPropertyName as an XML escaped String. If no property exists, aDefaultValue is XML escaped and returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-* @param {string} aDefaultValue - a (non XML escaped) fallback value if no value exists
-*/
-export function getNestedStringEscaped(aNode: Node, aNodePropertyName: string, aPropertyName: string, aDefaultValue: string): string;
-
-/**
-* Gets a List of property values from a "nested" Node's property.
-* @returns {List<string>} the string value(s) for aPropertyName as a List. If no property exists, null is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-*/
-export function getNestedStrings(aNode: Node, aNodePropertyName: string, aPropertyName: string): List<string>;
-
-/**
-* Gets a List of property values from a "nested" Node's property with a fallback value if the property doesn't exist.
-* @returns {List<string>} the string value(s) for aPropertyName as a List. If no property exists, aDefaultValue is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-* @param {List<string>} aDefaultValue - fallback value if no value exists
-*/
-export function getNestedStrings(aNode: Node, aNodePropertyName: string, aPropertyName: string, aDefaultValue: List<string>): List<string>;
-
-/**
-* Gets a List of XML escaped property values from a "nested" Node's property.
-* @returns {List<string>} the string value(s) for aPropertyName as a List. If no property exists, null is returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-*/
-export function getNestedStringsEscaped(aNode: Node, aNodePropertyName: string, aPropertyName: string): List<string>;
-
-/**
-* Gets a List of property values from a "nested" Node's property with a fallback value if the property doesn't exist,
- and returns it XML escaped.
-* @returns {List<string>} the string value(s) for aPropertyName as a List. If no property exists, aDefaultValueis XML escaped and returned.
-* @param {Node} aNode - the base Node that has a property that is a Node
-* @param {string} aNodePropertyName - the name of the "inner/nested" Node that is a property on aNode
-* @param {string} aPropertyName - the name of the property for the "inner/nested" Node
-* @param {List<string>} aDefaultValue - fallback list if no value exists. Note! The actual fallback list is never returned,
-* but it's values might be used. If the fallback list are about to be returned, a copy of it will be created and all values from the fallback list will
-* be XML escaped and added to the new list before it is returned.
-*/
-export function getNestedStringsEscaped(aNode: Node, aNodePropertyName: string, aPropertyName: string, aDefaultValue: List<string>): List<string>;
-
-/**
-* Gets a Node property from a Node.
-* @returns {Node} the value for aPropertyName as Node. If no property exists or it isn't a Node, null is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-*/
+ * Gets an int property from a node with a fallback value if the property doesn't exist or is incompatible with the int type.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @param aDefaultValue fallback value if no value exists
+ * @return the <code>int</code> value for aPropertyName. If no property exists or it isn't compatible with an <code>int</code>, aDefaultValue is returned.
+ */
+export function getInt(
+  aNode: Node,
+  aPropertyName: string,
+  aDefaultValue: number
+): number;
+
+/**
+ * Gets a double property from a Node.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @return the <code>double</code> value for aPropertyName. If no property exists or it isn't compatible with a <code>double</code>, 0.0 is returned.
+ * @since Sitevision 2.6.1_09
+ */
+export function getDouble(aNode: Node, aPropertyName: string): number;
+
+/**
+ * Gets a double property from a node with a fallback value if the property doesn't exist or is incompatible with the double type.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @param aDefaultValue fallback value if no value exists
+ * @return the <code>double</code> value for aPropertyName. If no property exists or it isn't compatible with a <code>double</code>, aDefaultValue is returned.
+ * @since Sitevision 2.6.1_09
+ */
+export function getDouble(
+  aNode: Node,
+  aPropertyName: string,
+  aDefaultValue: number
+): number;
+
+/**
+ * Gets a boolean property from a Node.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @return the value for aPropertyName as <code>boolean</code>. If no property exists or it isn't compatible with a <code>boolean</code>, <code>false</code> is returned.
+ */
+export function getBoolean(aNode: Node, aPropertyName: string): boolean;
+
+/**
+ * Gets a boolean property from a Node with a fallback value if the property doesn't exist or is incompatible with the boolean type.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @param aDefaultValue fallback value if no value exists
+ * @return the value for aPropertyName as <code>boolean</code>. If no property exists or it isn't compatible with a <code>boolean</code>, aDefaultValue is returned.
+ */
+export function getBoolean(
+  aNode: Node,
+  aPropertyName: string,
+  aDefaultValue: boolean
+): boolean;
+
+/**
+ * Gets a Node property from a Node.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @return the value for aPropertyName as <code>Node</code>. If no property exists or it isn't a <code>Node</code>, <code>null</code> is returned.
+ */
 export function getNode(aNode: Node, aPropertyName: string): Node;
 
 /**
-* Gets a Node property from a Node with a fallback value if the property doesn't exist.
-* @returns {Node} the value for aPropertyName as Node. If no property exists or it isn't a Node, aDefaultValue is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-* @param {Node} aDefaultValue - fallback value if no value exists
-*/
-export function getNode(aNode: Node, aPropertyName: string, aDefaultValue: Node): Node;
+ * Gets a Node property from a Node if an enabling property allows it.
+ *
+ * <p>
+ *    In some Sitevision portlet configs there are a "boolean" property that enables a "Node" property and the "Node" might be <code>null</code>.
+ *    This is a convenience method for such cases. In Velocity, code like this:
+ * </p>
+ * <pre><code>
+ *    #set ($startPage = ...) <em>## Ensure start page value...</em>
+ *    #if ($propertyUtil.getBoolean($portlet, 'useCustomStartPage'))
+ *       #set ($customStartPage = $scriptUtil.getNonNull(${propertyUtil.getNode($portlet, 'customStartPage')}))
+ *       #if ($customStartPage)
+ *          #set ($startPage = $customStartPage)
+ *       #end
+ *    #end
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($startPage = $scriptUtil.getNonNull(${propertyUtil.getEnabledNode($portlet, 'useCustomStartPage', 'customStartPage')}))
+ *    #if (!$startPage)
+ *       #set ($startPage = ...) <em>## Set default start page value if no custom start page was set...</em>
+ *    #end
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names
+ *    (i.e. <code>aEnablingPropertyName</code> and <code>aNodePropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has the properties
+ * @param aEnablingPropertyName the name of the boolean property that enables the Node denoted by <code>aPropertyName</code>
+ * @param aNodePropertyName the name of the property
+ * @return the value for aNodePropertyName as <code>Node</code>. If no property exists or it isn't a <code>Node</code>, <code>null</code> is returned. A <code>Node</code> will never be returned if <code>aEnablingPropertyName</code> doesn't exist, isn't compatible with a <code>boolean</code> or isn't <code>true</code>.
+ * @see #getEnabledNode(javax.jcr.Node, String, String, javax.jcr.Node)
+ * @since Sitevision 3.0
+ */
+export function getEnabledNode(
+  aNode: Node,
+  aEnablingPropertyName: string,
+  aNodePropertyName: string
+): Node;
 
 /**
-* Gets a String property from a Node.
-* @returns {string} the value for aPropertyName as String. If no property exists, null is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-*/
-export function getString(aNode: Node, aPropertyName: string): string;
+ * Gets a Node property from a Node if an enabling property allows it, with a fallback Node value.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names
+ *    (i.e. <code>aEnablingPropertyName</code> and <code>aNodePropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has the properties
+ * @param aEnablingPropertyName the name of the boolean property that enables the Node denoted by <code>aPropertyName</code>
+ * @param aNodePropertyName the name of the property
+ * @param aDefaultValue fallback value if no value exists
+ * @return the value for aNodePropertyName as <code>Node</code>. If no property exists or it isn't a <code>Node</code>, <code>aDefaultValue</code> is returned. If <code>aEnablingPropertyName</code> doesn't exist, isn't compatible with a <code>boolean</code> or isn't <code>true</code>, <code>aDefaultValue</code> is returned.
+ * @see #getEnabledNode(javax.jcr.Node, String, String)
+ * @since Sitevision 3.0
+ */
+export function getEnabledNode(
+  aNode: Node,
+  aEnablingPropertyName: string,
+  aNodePropertyName: string,
+  aDefaultValue: Node
+): Node;
 
 /**
-* Gets a String property from a node with a fallback value if the property doesn't exist.
-* @returns {string} the value for aPropertyName as String. If no property exists, aDefaultValue is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-* @param {string} aDefaultValue - fallback value if no value exists
-*/
-export function getString(aNode: Node, aPropertyName: string, aDefaultValue: string): string;
+ * Gets a String property from a Node if an enabling boolean property allows it.
+ *
+ * <p>
+ *    In some Sitevision portlet configs there are a "boolean" property that enables a "String" property and the "String" might
+ *    be <code>null</code>. This is a convenience method for such cases. In Velocity, code like this:
+ * </p>
+ * <pre><code>
+ *    #set ($name = ...) <em>## Set default name...</em>
+ *    #if ($propertyUtil.getBoolean($portlet, 'useCustomName'))
+ *       #set ($customName = $scriptUtil.getNonNull(${propertyUtil.getNode($portlet, 'customName')}))
+ *       #if ($customName)
+ *          #set ($name = $customName)
+ *       #end
+ *    #end
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($name = $scriptUtil.getNonNull(${propertyUtil.getEnabledString($portlet, 'useCustomName', 'customName')}))
+ *    #if (!$name)
+ *       #set ($name = ...) <em>## Set default name if no custom name was set...</em>
+ *    #end
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names
+ *    (i.e. <code>aEnablingPropertyName</code> and <code>aStringPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has the properties
+ * @param aEnablingPropertyName the name of the boolean property that enables the String denoted by <code>aStringPropertyName</code>
+ * @param aStringPropertyName the name of the String property
+ * @return the value for aStringPropertyName as <code>String</code>. If no property exists, <code>null</code> is returned. Null will always be returned if <code>aEnablingPropertyName</code> doesn't exist, isn't compatible with a <code>boolean</code> or isn't <code>true</code>.
+ * @see #getEnabledString(javax.jcr.Node, String, String, String)
+ * @since Sitevision 4.0
+ */
+export function getEnabledString(
+  aNode: Node,
+  aEnablingPropertyName: string,
+  aStringPropertyName: string
+): string;
 
 /**
-* Gets a String property from a Node and returns it XML escaped.
-* @returns {string} the value for aPropertyName as an XML escaped String. If no property exists, null is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-*/
-export function getStringEscaped(aNode: Node, aPropertyName: string): string;
+ * Gets a String property from a Node if an enabling boolean property allows it, with a fallback value.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names
+ *    (i.e. <code>aEnablingPropertyName</code> and <code>aStringPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has the properties
+ * @param aEnablingPropertyName the name of the boolean property that enables the String denoted by <code>aStringPropertyName</code>
+ * @param aStringPropertyName the name of the String property
+ * @param aDefaultValue fallback value to return if no value exist
+ * @return the value for aStringPropertyName as <code>String</code>. If no property exists, <code>aDefaultValue</code> is returned. <code>aDefaultValue</code> will always be returned if <code>aEnablingPropertyName</code> doesn't exist, isn't compatible with a <code>boolean</code> or isn't <code>true</code>.
+ * @see #getEnabledString(javax.jcr.Node, String, String)
+ * @since Sitevision 4.0
+ */
+export function getEnabledString(
+  aNode: Node,
+  aEnablingPropertyName: string,
+  aStringPropertyName: string,
+  aDefaultValue: string
+): string;
+
+/**
+ * Gets a String property from a Node if an enabling boolean property allows it, and returns it XML escaped.
+ *
+ * <p>
+ *    In some Sitevision portlet configs there are a "boolean" property that enables a "String" property and the "String"
+ *    might be <code>null</code>. This is a convenience method for such cases where you want the value XML escaped. In Velocity, code like this:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($escapedName = ...) <em>## Set default escaped name...</em>
+ *    #if ($propertyUtil.getBoolean($portlet, 'useCustomName'))
+ *       #set ($customName = $scriptUtil.getNonNull(${propertyUtil.getNode($portlet, 'customName')}))
+ *       #if ($customName)
+ *          #set ($escapedName = $endecUtil.escapeXML($customName))
+ *       #end
+ *    #end
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($escapedName = $scriptUtil.getNonNull(${propertyUtil.getEnabledStringEscaped($portlet, 'useCustomName', 'customName')}))
+ *    #if (!$escapedName)
+ *       #set ($escapedName = ...) <em>## Set default escaped name if no custom name was set...</em>
+ *    #end
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names
+ *    (i.e. <code>aEnablingPropertyName</code> and <code>aStringPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has the properties
+ * @param aEnablingPropertyName the name of the boolean property that enables the String denoted by <code>aStringPropertyName</code>
+ * @param aStringPropertyName the name of the String property
+ * @return the value for aStringPropertyName as a XML escaped <code>String</code>. If no property exists, <code>null</code> is returned. Null will always be returned if <code>aEnablingPropertyName</code> doesn't exist, isn't compatible with a <code>boolean</code> or isn't <code>true</code>.
+ * @see #getEnabledStringEscaped(javax.jcr.Node, String, String, String)
+ * @since Sitevision 4.0
+ */
+export function getEnabledStringEscaped(
+  aNode: Node,
+  aEnablingPropertyName: string,
+  aStringPropertyName: string
+): string;
+
+/**
+ * Gets a String property from a Node if an enabling boolean property allows it, and returns it XML escaped with a fallback value.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names
+ *    (i.e. <code>aEnablingPropertyName</code> and <code>aStringPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has the properties
+ * @param aEnablingPropertyName the name of the boolean property that enables the String denoted by <code>aStringPropertyName</code>
+ * @param aStringPropertyName the name of the String property
+ * @param aDefaultValue the (non XML escaped) fallback value to return if no value exist
+ * @return the value for aStringPropertyName as a XML escaped <code>String</code>. If no property exists, <code>aDefaultValue</code> is XML escaped and returned. <code>aDefaultValue</code> will always be XML escaped and returned if <code>aEnablingPropertyName</code> doesn't exist, isn't compatible with a <code>boolean</code> or isn't <code>true</code>.
+ * @see #getEnabledStringEscaped(javax.jcr.Node, String, String)
+ * @since Sitevision 4.0
+ */
+export function getEnabledStringEscaped(
+  aNode: Node,
+  aEnablingPropertyName: string,
+  aStringPropertyName: string,
+  aDefaultValue: string
+): string;
 
 /**
-* Gets a String property from a Node, with a fallback value, and returns it XML escaped.
-* @returns {string} the value for aPropertyName as an XML escaped String. If no property exists, aDefaultValue is XML escaped and returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-* @param {string} aDefaultValue - a (non XML escaped) fallback value if no value exists
-*/
-export function getStringEscaped(aNode: Node, aPropertyName: string, aDefaultValue: string): string;
+ * Gets a Calendar property from a Node.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @return the value for aPropertyName as <code>Calendar</code>. If no property exists or it isn't a <code>Calendar</code>, <code>null</code> is returned.
+ * @since Sitevision 2.6.1_02
+ */
+export function getCalendar(aNode: Node, aPropertyName: string): unknown;
 
 /**
-* Gets a List of property values from a Node.
-* @returns {List<string>} the string value(s) for aPropertyName as a List. If no property exists, null is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-*/
-export function getStrings(aNode: Node, aPropertyName: string): List<string>;
+ * Gets a Calendar property from a Node with a fallback value if the property doesn't exist or is incompatible with the Calendar type.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @param aDefaultValue fallback value if no value exists
+ * @return the value for aPropertyName as <code>Calendar</code>. If no property exists or it isn't compatible with a <code>Calendar</code>, aDefaultValue is returned.
+ * @since Sitevision 2.6.1_02
+ */
+export function getCalendar(
+  aNode: Node,
+  aPropertyName: string,
+  aDefaultValue: unknown
+): unknown;
 
 /**
-* Gets a List of property values from a Node with a fallback value if the property doesn't exist.
-* @returns {List<string>} the string value(s) for aPropertyName as a List. If no property exists, aDefaultValue is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-* @param {List<string>} aDefaultValue - fallback value if no value exists
-*/
-export function getStrings(aNode: Node, aPropertyName: string, aDefaultValue: List<string>): List<string>;
+ * Gets a Calendar property from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Calendar/Date</code> property).
+ * <p>
+ * Note! The name of this method might seem awkward since a <code>Calendar</code> is returned, but this is to resemble the pattern of a
+ * <code>javax.jcr.Node</code> that has the method <code>getDate()</code> that returns a <code>Calendar</code>.
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on <code>aNode</code>
+ * @param aPropertyName the name of the Calendar property for the "inner/nested" <code>Node</code>
+ * @return the value for aPropertyName as <code>Calendar</code>. If no property exists or it isn't a <code>Calendar</code>, <code>null</code> is returned.
+ * @since Sitevision 2.6.1_02
+ */
+export function getNestedCalendar(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string
+): unknown;
 
 /**
-* Gets a List of XML escaped property values from a Node.
-* @returns {List<string>} the string value(s) for aPropertyName, XML escaped and embedded in a List.If no property exists, null is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-*/
-export function getStringsEscaped(aNode: Node, aPropertyName: string): List<string>;
+ * Gets a Calendar property from a "nested" Node's property with a fallback value if the property doesn't exist.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Calendar/Date</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on <code>aNode</code>
+ * @param aPropertyName the name of the Calendar property for the "inner/nested" <code>Node</code>
+ * @param aDefaultValue fallback value if no value exists
+ * @return the value for aPropertyName as <code>Calendar</code>. If no property exists or it isn't a <code>Calendar</code>, aDefaultValue is returned.
+ * @since Sitevision 2.6.1_02
+ */
+export function getNestedCalendar(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string,
+  aDefaultValue: unknown
+): unknown;
 
 /**
-* Gets a List of XML escaped property values from a Node with a fallback value if the property doesn't exist.
-* @returns {List<string>} the string value(s) for aPropertyName, XML escaped and embedded in a List.If no property exists, aDefaultValue is returned.
-* @param {Node} aNode - the Node that has a property
-* @param {string} aPropertyName - the name of the property
-* @param {List<string>} aDefaultValue - fallback list if no value exists. Note! The actual fallback list is never returned
-* but it's values might be used. If the fallback list are about to be returned, a copy of it will be created and
-* all values from the fallback list will be XML escaped and added to the new list before it is returned.
-*/
-export function getStringsEscaped(aNode: Node, aPropertyName: string, aDefaultValue: List<string>): List<string>;
+ * Gets a Node property from a Node with a fallback value if the property doesn't exist.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @param aDefaultValue fallback value if no value exists
+ * @return the value for aPropertyName as <code>Node</code>. If no property exists or it isn't a <code>Node</code>, aDefaultValue is returned.
+ */
+export function getNode(
+  aNode: Node,
+  aPropertyName: string,
+  aDefaultValue: Node
+): Node;
 
-declare namespace propertyUtil {
+/**
+ * Gets a <code>List</code> of property values from a Node.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @return the string value(s) for aPropertyName as a <code>List</code>. If no property exists, <code>null</code> is returned.
+ * @see #getStringsEscaped(javax.jcr.Node, String)
+ * @since Sitevision 2.6_06
+ */
+export function getStrings(aNode: Node, aPropertyName: string): unknown[];
+
+/**
+ * Gets a <code>List</code> of XML escaped property values from a Node.
+ *
+ * <p>
+ *    This is a convenience method for getting a list of property values that also should be XML escaped. Strings that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    #set ($valueList = $propertyUtil.getStrings($myNode, 'aProperty'))
+ *    &lt;ul&gt;
+ *    #foreach ($value in $valueList)
+ *       &lt;li&gt;
+ *          $endecUtil.escapeXML($value)
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    #set ($escapedValueList = $propertyUtil.getStringsEscaped($myNode, 'aProperty'))
+ *    &lt;ul&gt;
+ *    #foreach ($escapedValue in $escapedValueList)
+ *       &lt;li&gt;
+ *          $escapedValue
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @return the string value(s) for aPropertyName, XML escaped and embedded in a <code>List</code>. If no property exists, <code>null</code> is returned.
+ * @see #getString(javax.jcr.Node, String)
+ * @see senselogic.sitevision.api.text.EndecUtil#escapeXML(String)
+ * @since Sitevision 3.5
+ */
+export function getStringsEscaped(
+  aNode: Node,
+  aPropertyName: string
+): unknown[];
+
+/**
+ * Gets a <code>List</code> of property values from a Node with a fallback value if the property doesn't exist.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @return the string value(s) for aPropertyName as a <code>List</code>. If no property exists, <code>aDefaultValue</code> is returned.
+ * @param aDefaultValue fallback value if no value exists
+ * @see #getStringsEscaped(javax.jcr.Node, String, java.util.List)
+ * @since Sitevision 3.0
+ */
+export function getStrings(
+  aNode: Node,
+  aPropertyName: string,
+  aDefaultValue: unknown[]
+): unknown[];
+
+/**
+ * Gets a <code>List</code> of XML escaped property values from a Node with a fallback value if the property doesn't exist.
+ *
+ * <p>
+ *    This is a convenience method for getting a list of property values that also should be XML escaped. Strings that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    #set ($myDefaultList = ...)
+ *    ...
+ *    #set ($valueList = $propertyUtil.getStrings($myNode, 'aProperty', $myDefaultList))
+ *    &lt;ul&gt;
+ *    #foreach ($value in $valueList)
+ *       &lt;li&gt;
+ *          $endecUtil.escapeXML($value)
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    #set ($myDefaultList = ...)
+ *    ...
+ *    #set ($escapedValueList = $propertyUtil.getStringsEscaped($myNode, 'aProperty', $myDefaultList))
+ *    &lt;ul&gt;
+ *    #foreach ($escapedValue in $escapedValueList)
+ *       &lt;li&gt;
+ *          $escapedValue
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the <code>Node</code> that has a property
+ * @param aPropertyName the name of the property
+ * @return the string value(s) for aPropertyName, XML escaped and embedded in a <code>List</code>. If no property exists, <code>aDefaultValue</code> is returned.
+ * @param aDefaultValue fallback list if no value exists. <strong>Note!</strong> The actual fallback list is <em>never</em> returned but it's values might be used. If the fallback list are about to be returned, a copy of it will be created and all values from the fallback list will be XML escaped and added to the new list before it is returned.
+ * @see #getString(javax.jcr.Node, String, String)
+ * @see senselogic.sitevision.api.text.EndecUtil#escapeXML(String)
+ * @since Sitevision 3.5
+ */
+export function getStringsEscaped(
+  aNode: Node,
+  aPropertyName: string,
+  aDefaultValue: unknown[]
+): unknown[];
+
+/**
+ * Gets a <code>List</code> of property values from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>String</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @return the string value(s) for aPropertyName as a <code>List</code>. If no property exists, <code>null</code> is returned.
+ * @since Sitevision 2.6_06
+ */
+export function getNestedStrings(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string
+): unknown[];
+
+/**
+ * Gets a <code>List</code> of XML escaped property values from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>String</code> property).
+ *
+ * <p>
+ *    This is a convenience method for getting a list of property values that also should be XML escaped. Strings that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    #set ($valueList = $propertyUtil.getNestedStrings($myNode, 'aNodeProperty', 'aProperty'))
+ *    &lt;ul&gt;
+ *    #foreach ($value in $valueList)
+ *       &lt;li&gt;
+ *          $endecUtil.escapeXML($value)
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    #set ($escapedValueList = $propertyUtil.getNestedStringsEscaped($myNode, 'aNodeProperty', 'aProperty'))
+ *    &lt;ul&gt;
+ *    #foreach ($escapedValue in $escapedValueList)
+ *       &lt;li&gt;
+ *          $escapedValue
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @return the string value(s) for aPropertyName as a <code>List</code>. If no property exists, <code>null</code> is returned.
+ * @see #getNestedStrings(javax.jcr.Node, String, String)
+ * @see senselogic.sitevision.api.text.EndecUtil#escapeXML(String)
+ * @since Sitevision 3.5
+ */
+export function getNestedStringsEscaped(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string
+): unknown[];
+
+/**
+ * Gets a <code>List</code> of property values from a "nested" Node's property with a fallback value if the property doesn't exist.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>String</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @param aDefaultValue fallback value if no value exists
+ * @return the string value(s) for aPropertyName as a <code>List</code>. If no property exists, <code>aDefaultValue</code> is returned.
+ * @since Sitevision 3.0
+ */
+export function getNestedStrings(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string,
+  aDefaultValue: unknown[]
+): unknown[];
+
+/**
+ * Gets a <code>List</code> of property values from a "nested" Node's property with a fallback value if the property doesn't exist,
+ * and returns it XML escaped.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>String</code> property).
+ *
+ * <p>
+ *    This is a convenience method for getting a list of property values that also should be XML escaped. Strings that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    #set ($myDefaultList = ...)
+ *    ...
+ *    #set ($valueList = $propertyUtil.getNestedStrings($myNode, 'aNodeProperty', 'aProperty', $myDefaultList))
+ *    &lt;ul&gt;
+ *    #foreach ($value in $valueList)
+ *       &lt;li&gt;
+ *          $endecUtil.escapeXML($value)
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    #set ($myDefaultList = ...)
+ *    ...
+ *    #set ($escapedValueList = $propertyUtil.getNestedStringsEscaped($myNode, 'aNodeProperty', 'aProperty', $myDefaultList))
+ *    &lt;ul&gt;
+ *    #foreach ($escapedValue in $escapedValueList)
+ *       &lt;li&gt;
+ *          $escapedValue
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @param aNode the base <code>Node</code> that has a property that is a <code>Node</code>
+ * @param aNodePropertyName the name of the "inner/nested" <code>Node</code> that is a property on aNode
+ * @param aPropertyName the name of the property for the "inner/nested" <code>Node</code>
+ * @param aDefaultValue fallback list if no value exists. <strong>Note!</strong> The actual fallback list is <em>never</em> returned, but it's values might be used. If the fallback list are about to be returned, a copy of it will be created and all values from the fallback list will be XML escaped and added to the new list before it is returned.
+ * @return the string value(s) for aPropertyName as a <code>List</code>. If no property exists, <code>aDefaultValue</code> is XML escaped and returned.
+ * @see #getNestedStrings(javax.jcr.Node, String, String, java.util.List)
+ * @see senselogic.sitevision.api.text.EndecUtil#escapeXML(String)
+ * @since Sitevision 3.5
+ */
+export function getNestedStringsEscaped(
+  aNode: Node,
+  aNodePropertyName: string,
+  aPropertyName: string,
+  aDefaultValue: unknown[]
+): unknown[];
+
+/**
+ * Utility interface for getting Node property values.
+ *
+ * <p>
+ *    An instance of the Sitevision class implementing this interface can be obtained via
+ *    {@link senselogic.sitevision.api.Utils#getPropertyUtil()}.
+ *    See {@link senselogic.sitevision.api.Utils} for how to obtain an instance of the <code>Utils</code> interface.
+ * </p>
+ *
+ * <p>
+ *    The advantage of using these methods instead of explicitly use the "get property" methods as defined in JCR is that none of the
+ *    methods defined here throw Exceptions. (Exception handling can of course be handled properly if you implements your own JSR 286
+ *    portlet in Java, but when rendering in Velocity you can't catch Exceptions.)
+ * </p>
+ * --------------------------------------------------------- <br>
+ * <strong>Example 1:</strong> You use Velocity and strongly suspect that a <code>Node</code> have a
+ * <code>boolean</code> property called "isInUse"<br>
+ * ---------------------------------------------------------
+ * <p>
+ *    <strong>1. The JCR way:</strong>
+ * </p>
+ * <p>
+ *    a) This can return <code>true</code>, <code>false</code> or throw an <code>Exception</code>:
+ * </p>
+ * <pre><code>
+ *   #if ($aNode.getProperty('isInUse').boolean)
+ *     ...
+ *   #end</code></pre>
+ * <p>
+ *    b) Even if you ensure there actually are a property called "isInUse" it can still throw an <code>Exception</code> if the property isn't a
+ *    <code>boolean</code>:
+ * </p>
+ * <pre><code>
+ *   #if ($aNode.hasProperty('isInUse') &amp;&amp; $aNode.getProperty('isInUse').boolean)
+ *     ...
+ *   #end</code></pre>
+ * <p>
+ *    c) Your best possible effort to avoid Exceptions is to ensure that there are a property and that it actually is of <code>boolean</code>
+ *    type before you check its value:<br>
+ *    (Note! Property types are defined in <code>javax.jcr.PropertyType</code> and the <code>BOOLEAN</code> type is represented by the
+ *    <code>int</code> value 6):
+ * </p>
+ * <pre><code>
+ *   #if ($aNode.hasProperty('isInUse') &amp;&amp; $aNode.getProperty('isInUse').type == 6 &amp;&amp; $aNode.getProperty('isInUse').boolean)
+ *     ...
+ *   #end</code></pre>
+ * <p>
+ *    &nbsp;&nbsp;&nbsp;<em>The drawback with this alternative is that you miss boolean properties that isn't registered as the
+ *    <code>BOOLEAN</code> type (e.g. a <code>String</code> property with the value "true" or "false")</em>
+ * </p>
+ *
+ * <p>
+ *    <strong>2. The PropertyUtil way:</strong>
+ * </p>
+ * <p>
+ *    This always returns <code>true</code> or <code>false</code>:
+ * </p>
+ * <pre><code>
+ *   #set ($propertyUtil = $sitevisionUtils.propertyUtil)
+ *   ...
+ *   #if ($propertyUtil.getBoolean($aNode, 'isInUse')
+ *     ...
+ *   #end</code></pre>
+ *
+ * --------------------------------------------------------- <br>
+ * <strong>Example 2:</strong> You use Velocity and want to do an integer addition of a fixed <code>int</code> value and a <code>int</code>
+ * property "myNumber".<br>
+ * (Note! An addition in Velocity must be executed in a <code>#set</code> statement)<br>
+ * ---------------------------------------------------------
+ * <p>
+ *    <strong>1. The JCR way:</strong>
+ * </p>
+ * <p>
+ *    This can't be achieved in Velocity! You can only fetch the value as a long (<code>$aNode.getProperty('myNumber').long</code>)
+ *    but Velocity needs an <code>int</code> or an <code>Integer</code> to perform addition.
+ * </p>
+ * <p>
+ *    <strong>2. The PropertyUtil way:</strong>
+ * </p>
+ * <p>
+ *    This will work in Velocity (i.e. use <code>PropertyUtil</code> to get the <code>int</code>):
+ * </p>
+ * <pre><code>
+ *   #set ($propertyUtil = $sitevisionUtils.propertyUtil)
+ *   ...
+ *   #set ($result = $propertyUtil.getInt($aNode, 'myNumber') + 45)</code></pre>
+ * --------------------------------------------------------- <br>
+ * <strong>Example 3:</strong> You use Velocity and want to get two int property values from a node and one of the property names contains
+ * illegal characters.<br>
+ * (Note! Illegal characters in node names and property names must always be escaped)<br>
+ * ---------------------------------------------------------
+ * <p>
+ * Since the property name "<code>anIllegal[./]name</code>" contains illegal characters it must be escaped.
+ * To do this you typically use the {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String) escapeJcrName(String)}
+ * method in {@link senselogic.sitevision.api.text.EndecUtil}.
+ * Note that the property name "<code>aLegalName</code>" is <em>not</em> escaped since it doesn't contain any illegal characters.
+ * For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ * </p>
+ * <pre><code>
+ *   #set ($propertyUtil = $sitevisionUtils.propertyUtil)
+ *   #set ($endecUtil = $sitevisionUtils.endecUtil)
+ *   ...
+ *   #set ($escapedName = $endecUtil.escapeJcrName('anIllegal[./]name'))
+ *   #set ($firstValue = $propertyUtil.getInt($aNode, $escapedName)
+ *
+ *   #set ($secondValue = $propertyUtil.getInt($aNode, 'aLegalName')
+ * </code></pre>Gets a String property from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code> has a
+ * <code>String</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a String property from a "nested" Node's property and returns it XML escaped.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code> has a
+ * <code>String</code> property).
+ *
+ * <p>
+ *    This is a convenience method for getting a "nested" String property that also should be XML escaped. A String that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $endecUtil.escapeXML($propertyUtil.getNestedString($myNode, 'aNodeProperty', 'aProperty'))
+ *    &lt;/p&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $!propertyUtil.getNestedStringEscaped($myNode, 'aNodeProperty', 'aProperty')
+ *    &lt;/p&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a String property from a "nested" Node's property with a fallback value if the property doesn't exist.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code> has a
+ * <code>String</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a String property from a "nested" Node's property with a fallback value if the property doesn't exist, and returns it XML escaped.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>String</code> property).
+ *
+ * <p>
+ *    This is a convenience method for getting a "nested" String property that also should be XML escaped. A String that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $endecUtil.escapeXML($propertyUtil.getNestedString($myNode, 'aNodeProperty', 'aProperty', 'a default value'))
+ *    &lt;/p&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $propertyUtil.getNestedStringEscaped($myNode, 'aNodeProperty', 'aProperty', 'a default value')
+ *    &lt;/p&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets an int property from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has an <code>int/Integer</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets an int property from a "nested" Node's property with a fallback value if the property doesn't exist or is incompatible with the int type.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has an <code>int/Integer</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a double property from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>double/Double</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a double property from a "nested" Node's property with a fallback value if the property doesn't exist or is incompatible
+ * with the double type.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>double/Double</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a boolean property from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Boolean</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a boolean property from a "nested" Node's property with a fallback value if the property doesn't exist or is incompatible
+ * with the boolean type.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Boolean</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a Node property from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Node</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a Node property from a "nested" Node's property with a fallback value if the property doesn't exist.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Node</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a Binary property from a Node.
+ *
+ * <p>
+ *    Ensure to always handle resources appropriately when working with Binary! If you get a stream via {@link javax.jcr.Binary#getStream()},
+ *    you must also <code>close</code> the stream when you are done.
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> The <code>Binary</code> support is limited, see {@link javax.jcr.Property#getBinary()} for more information!
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a Binary property from a node with a fallback value if the property doesn't exist.
+ *
+ * <p>
+ *    Ensure to always handle resources appropriately when working with Binary! If you get a stream via {@link javax.jcr.Binary#getStream()},
+ *    you must also <code>close</code> the stream when you are done.
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> The <code>Binary</code> support is limited, see {@link javax.jcr.Property#getBinary()} for more information!
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a Binary property from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Binary</code> property).
+ *
+ * <p>
+ *    Ensure to always handle resources appropriately when working with Binary! If you get a stream via {@link javax.jcr.Binary#getStream()},
+ *    you must also <code>close</code> the stream when you are done.
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> The <code>Binary</code> support is limited, see {@link javax.jcr.Property#getBinary()} for more information!
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a Binary property from a "nested" Node's property with a fallback value if the property doesn't exist.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Binary</code> property).
+ *
+ * <p>
+ *    Ensure to always handle resources appropriately when working with Binary! If you get a stream via {@link javax.jcr.Binary#getStream()},
+ *    you must also <code>close</code> the stream when you are done.
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> The <code>Binary</code> support is limited, see {@link javax.jcr.Property#getBinary()} for more information!
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a String property from a Node.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a String property from a Node and returns it XML escaped.
+ *
+ * <p>
+ *    This is a convenience method for getting a String property that also should be XML escaped. A String that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $endecUtil.escapeXML($propertyUtil.getString($myNode, 'aProperty'))
+ *    &lt;/p&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $!propertyUtil.getStringEscaped($myNode, 'aProperty')
+ *    &lt;/p&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a String property from a node with a fallback value if the property doesn't exist.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a String property from a Node, with a fallback value, and returns it XML escaped.
+ *
+ * <p>
+ *    This is a convenience method for getting a String property that also should be XML escaped. A String that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $endecUtil.escapeXML($propertyUtil.getString($myNode, 'aProperty', 'a default value'))
+ *    &lt;/p&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    &lt;p&gt;
+ *       $propertyUtil.getStringEscaped($myNode, 'aProperty', 'a default value')
+ *    &lt;/p&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets an int property from a Node.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets an int property from a node with a fallback value if the property doesn't exist or is incompatible with the int type.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a double property from a Node.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a double property from a node with a fallback value if the property doesn't exist or is incompatible with the double type.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a boolean property from a Node.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a boolean property from a Node with a fallback value if the property doesn't exist or is incompatible with the boolean type.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a Node property from a Node.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a Node property from a Node if an enabling property allows it.
+ *
+ * <p>
+ *    In some Sitevision portlet configs there are a "boolean" property that enables a "Node" property and the "Node" might be <code>null</code>.
+ *    This is a convenience method for such cases. In Velocity, code like this:
+ * </p>
+ * <pre><code>
+ *    #set ($startPage = ...) <em>## Ensure start page value...</em>
+ *    #if ($propertyUtil.getBoolean($portlet, 'useCustomStartPage'))
+ *       #set ($customStartPage = $scriptUtil.getNonNull(${propertyUtil.getNode($portlet, 'customStartPage')}))
+ *       #if ($customStartPage)
+ *          #set ($startPage = $customStartPage)
+ *       #end
+ *    #end
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($startPage = $scriptUtil.getNonNull(${propertyUtil.getEnabledNode($portlet, 'useCustomStartPage', 'customStartPage')}))
+ *    #if (!$startPage)
+ *       #set ($startPage = ...) <em>## Set default start page value if no custom start page was set...</em>
+ *    #end
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names
+ *    (i.e. <code>aEnablingPropertyName</code> and <code>aNodePropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a Node property from a Node if an enabling property allows it, with a fallback Node value.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names
+ *    (i.e. <code>aEnablingPropertyName</code> and <code>aNodePropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a String property from a Node if an enabling boolean property allows it.
+ *
+ * <p>
+ *    In some Sitevision portlet configs there are a "boolean" property that enables a "String" property and the "String" might
+ *    be <code>null</code>. This is a convenience method for such cases. In Velocity, code like this:
+ * </p>
+ * <pre><code>
+ *    #set ($name = ...) <em>## Set default name...</em>
+ *    #if ($propertyUtil.getBoolean($portlet, 'useCustomName'))
+ *       #set ($customName = $scriptUtil.getNonNull(${propertyUtil.getNode($portlet, 'customName')}))
+ *       #if ($customName)
+ *          #set ($name = $customName)
+ *       #end
+ *    #end
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($name = $scriptUtil.getNonNull(${propertyUtil.getEnabledString($portlet, 'useCustomName', 'customName')}))
+ *    #if (!$name)
+ *       #set ($name = ...) <em>## Set default name if no custom name was set...</em>
+ *    #end
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names
+ *    (i.e. <code>aEnablingPropertyName</code> and <code>aStringPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a String property from a Node if an enabling boolean property allows it, with a fallback value.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names
+ *    (i.e. <code>aEnablingPropertyName</code> and <code>aStringPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a String property from a Node if an enabling boolean property allows it, and returns it XML escaped.
+ *
+ * <p>
+ *    In some Sitevision portlet configs there are a "boolean" property that enables a "String" property and the "String"
+ *    might be <code>null</code>. This is a convenience method for such cases where you want the value XML escaped. In Velocity, code like this:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($escapedName = ...) <em>## Set default escaped name...</em>
+ *    #if ($propertyUtil.getBoolean($portlet, 'useCustomName'))
+ *       #set ($customName = $scriptUtil.getNonNull(${propertyUtil.getNode($portlet, 'customName')}))
+ *       #if ($customName)
+ *          #set ($escapedName = $endecUtil.escapeXML($customName))
+ *       #end
+ *    #end
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($escapedName = $scriptUtil.getNonNull(${propertyUtil.getEnabledStringEscaped($portlet, 'useCustomName', 'customName')}))
+ *    #if (!$escapedName)
+ *       #set ($escapedName = ...) <em>## Set default escaped name if no custom name was set...</em>
+ *    #end
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names
+ *    (i.e. <code>aEnablingPropertyName</code> and <code>aStringPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a String property from a Node if an enabling boolean property allows it, and returns it XML escaped with a fallback value.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names
+ *    (i.e. <code>aEnablingPropertyName</code> and <code>aStringPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a Calendar property from a Node.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a Calendar property from a Node with a fallback value if the property doesn't exist or is incompatible with the Calendar type.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a Calendar property from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Calendar/Date</code> property).
+ * <p>
+ * Note! The name of this method might seem awkward since a <code>Calendar</code> is returned, but this is to resemble the pattern of a
+ * <code>javax.jcr.Node</code> that has the method <code>getDate()</code> that returns a <code>Calendar</code>.
+ * </p>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a Calendar property from a "nested" Node's property with a fallback value if the property doesn't exist.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>Calendar/Date</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a Node property from a Node with a fallback value if the property doesn't exist.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a <code>List</code> of property values from a Node.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a <code>List</code> of XML escaped property values from a Node.
+ *
+ * <p>
+ *    This is a convenience method for getting a list of property values that also should be XML escaped. Strings that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    #set ($valueList = $propertyUtil.getStrings($myNode, 'aProperty'))
+ *    &lt;ul&gt;
+ *    #foreach ($value in $valueList)
+ *       &lt;li&gt;
+ *          $endecUtil.escapeXML($value)
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    #set ($escapedValueList = $propertyUtil.getStringsEscaped($myNode, 'aProperty'))
+ *    &lt;ul&gt;
+ *    #foreach ($escapedValue in $escapedValueList)
+ *       &lt;li&gt;
+ *          $escapedValue
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a <code>List</code> of property values from a Node with a fallback value if the property doesn't exist.
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a <code>List</code> of XML escaped property values from a Node with a fallback value if the property doesn't exist.
+ *
+ * <p>
+ *    This is a convenience method for getting a list of property values that also should be XML escaped. Strings that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    #set ($myDefaultList = ...)
+ *    ...
+ *    #set ($valueList = $propertyUtil.getStrings($myNode, 'aProperty', $myDefaultList))
+ *    &lt;ul&gt;
+ *    #foreach ($value in $valueList)
+ *       &lt;li&gt;
+ *          $endecUtil.escapeXML($value)
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    #set ($myDefaultList = ...)
+ *    ...
+ *    #set ($escapedValueList = $propertyUtil.getStringsEscaped($myNode, 'aProperty', $myDefaultList))
+ *    &lt;ul&gt;
+ *    #foreach ($escapedValue in $escapedValueList)
+ *       &lt;li&gt;
+ *          $escapedValue
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape the property name (i.e. <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a <code>List</code> of property values from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>String</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a <code>List</code> of XML escaped property values from a "nested" Node's property.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>String</code> property).
+ *
+ * <p>
+ *    This is a convenience method for getting a list of property values that also should be XML escaped. Strings that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    #set ($valueList = $propertyUtil.getNestedStrings($myNode, 'aNodeProperty', 'aProperty'))
+ *    &lt;ul&gt;
+ *    #foreach ($value in $valueList)
+ *       &lt;li&gt;
+ *          $endecUtil.escapeXML($value)
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    ...
+ *    #set ($escapedValueList = $propertyUtil.getNestedStringsEscaped($myNode, 'aNodeProperty', 'aProperty'))
+ *    &lt;ul&gt;
+ *    #foreach ($escapedValue in $escapedValueList)
+ *       &lt;li&gt;
+ *          $escapedValue
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a <code>List</code> of property values from a "nested" Node's property with a fallback value if the property doesn't exist.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>String</code> property).
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>Gets a <code>List</code> of property values from a "nested" Node's property with a fallback value if the property doesn't exist,
+ * and returns it XML escaped.
+ * (i.e. the base <code>Node</code> has a property that is a <code>Node</code>, and that "inner/nested" <code>Node</code>
+ * has a <code>String</code> property).
+ *
+ * <p>
+ *    This is a convenience method for getting a list of property values that also should be XML escaped. Strings that should be included
+ *    in the html output should typically always be XML escaped to be valid XHTML and avoid XSS problems.
+ * </p>
+ * <p>
+ *    This Velocity code:
+ * </p>
+ * <pre><code>
+ *    #set ($endecUtil = ...)
+ *    #set ($propertyUtil = ...)
+ *    #set ($myDefaultList = ...)
+ *    ...
+ *    #set ($valueList = $propertyUtil.getNestedStrings($myNode, 'aNodeProperty', 'aProperty', $myDefaultList))
+ *    &lt;ul&gt;
+ *    #foreach ($value in $valueList)
+ *       &lt;li&gt;
+ *          $endecUtil.escapeXML($value)
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ * would typically be replaced with this:
+ * <pre><code>
+ *    #set ($propertyUtil = ...)
+ *    #set ($myDefaultList = ...)
+ *    ...
+ *    #set ($escapedValueList = $propertyUtil.getNestedStringsEscaped($myNode, 'aNodeProperty', 'aProperty', $myDefaultList))
+ *    &lt;ul&gt;
+ *    #foreach ($escapedValue in $escapedValueList)
+ *       &lt;li&gt;
+ *          $escapedValue
+ *       &lt;/li&gt;
+ *    #end
+ *    &lt;/ul&gt;
+ * </code></pre>
+ *
+ * <p>
+ *    <strong>Note!</strong> This method does <em>not</em> escape names (i.e. <code>aNodePropertyName</code> and <code>aPropertyName</code>).
+ *    Illegal characters in node names and property names must always be escaped, typically via
+ *    {@link senselogic.sitevision.api.text.EndecUtil#escapeJcrName(String)}.
+ *    For best performance - never escape a name if you are certain that it doesn't contain any illegal characters.
+ *    Sitevision model properties never contain illegal characters. Though, depending on configuration "dynamic" ones
+ *    (e.g. metadata properties) might contain illegal characters.
+ * </p>
+ * @author Magnus Lövgren
+ */
+declare namespace PropertyUtil {
   export {
+    getNestedString,
+    getNestedStringEscaped,
+    getNestedInt,
+    getNestedDouble,
+    getNestedBoolean,
+    getNestedNode,
     getBinary,
-    getBoolean,
-    getCalendar,
+    getNestedBinary,
+    getString,
+    getStringEscaped,
+    getInt,
     getDouble,
+    getBoolean,
+    getNode,
     getEnabledNode,
     getEnabledString,
     getEnabledStringEscaped,
-    getInt,
-    getNestedBinary,
-    getNestedBoolean,
+    getCalendar,
     getNestedCalendar,
-    getNestedDouble,
-    getNestedInt,
-    getNestedNode,
-    getNestedString,
-    getNestedStringEscaped,
-    getNestedStrings,
-    getNestedStringsEscaped,
-    getNode,
-    getString,
-    getStringEscaped,
     getStrings,
     getStringsEscaped,
+    getNestedStrings,
+    getNestedStringsEscaped,
   };
 }
 
-export default propertyUtil;
+export default PropertyUtil;