@sitevision/api 1.1.0-alpha.2 → 2.0.0-alpha.1

package/server/NodeComparatorUtil/index.d.ts

@@ -1,5 +1,5 @@
 import CompoundComparatorBuilder from "../CompoundComparatorBuilder";
-import Resolver from "../../hidden/senselogic/sitevision/api/base/Resolver";
+import type { Resolver } from "../../types/senselogic/sitevision/api/base/Resolver";
 
 /**
  * Returns a comparator that compares nodes by the string value of a property in a case-insensitive manner.
@@ -227,163 +227,11 @@ export function getResolverComparator(aResolver: Resolver): unknown;
  *    An instance of the Sitevision class implementing this interface can be obtained via
  *    {@link senselogic.sitevision.api.Utils#getNodeComparatorUtil()}.
  *    See {@link senselogic.sitevision.api.Utils} for how to obtain an instance of the <code>Utils</code> interface.
- * </p>Returns a comparator that compares nodes by the string value of a property in a case-insensitive manner.
- *
- * <p>
- *    This is a convenience for the {@link #getPropertyComparator(String, java.util.Locale)} method, using the
- *    current locale as returned by {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentLocale()}.
- * </p>
- * <p>
- *    <strong>Example</strong>
- *    <br>This Velocity code will sort the $listOfNodes List by comparing the 'displayName' property for each Node
- * </p>
- * <pre><code>
- *    #set ($nodeComparatorUtil = $sitevisionUtils.NodeComparatorUtil)
- *    #set ($displayNameComparator = $nodeComparatorUtil.getPropertyComparator('displayName'))
- *
- *    #set ($instanceCreatorUtil = $sitevisionUtils.InstanceCreatorUtil)
- *    #set ($collections = $instanceCreatorUtil.CollectionsInstance)
- *
- *    $collections.sort($listOfNodes, $displayNameComparator)
- * </code></pre>
- * <p>
- *    <em>Note! This comparator imposes orderings that are inconsistent with equals.</em>
- * </p>Returns a comparator that compares nodes by the string value of a property in a case-insensitive manner using a specified locale.
- *
- * <p>
- *    The property value will be extracted as a string using {@link senselogic.sitevision.api.property.PropertyUtil},
- *    and a <code>null</code> value will be treated as an empty string.
- * </p>
- *
- * <p><strong>Why using proper Locale is important</strong></p>
- * <p>
- *    The comparators returned from this method will rely on a <code>Collator</code> and they have different comparison
- *    rules for different locales. The returned comparator might give unexpected results if a locale is used that doesn't
- *    match actual property values.
- *
- *    This is best illustrated by an example of how typical <em>swedish</em> values will be compared with different locales.
- *    Assume we have a List of nodes that should be compared by a certain property and these are the actual string values
- *    for the property of the nodes in the list:
- * </p>
- * <p>
- *    <code>"a", "A", "b", "B", "z", "Z", "å", "Å", "ä", "Ä", "ö", "Ö"</code>
- * </p>
- * <p>
- *    When using the
- *    {@link senselogic.sitevision.api.script.factory.CollectionsInstance#sort(java.util.List, java.util.Comparator)
- *    Collections.sort(List&lt;Node&gt;, Comparator&lt;Node&gt;)}
- *    method to sort the list, this is how they typically(*) will be sorted with different locales:
- * </p>
- * <table style="border:1px solid black" summary="">
- *    <caption style="text-align:left">Some examples</caption>
- *    <tr>
- *       <th style="text-align:left">Locale</th><th style="text-align:left">Result (*)</th>
- *    </tr>
- *    <tr>
- *       <td>Swedish</td><td><code>"a", "A", "b", "B", "z", "Z", "å", "Å", "ä", "Ä", "ö", "Ö"</code></td>
- *    </tr>
- *    <tr>
- *       <td>Norwegian</td><td><code>"a", "A", "b", "B", "z", "Z", "ä", "Ä", "ö", "Ö", "å", "Å"</code></td>
- *    </tr>
- *    <tr>
- *       <td>English</td><td><code>"a", "A", "å", "Å", "ä", "Ä", "b", "B", "ö", "Ö", "z", "Z"</code></td>
- *    </tr>
- *    <tr>
- *       <td>German</td><td><code>"a", "A", "å", "Å", "ä", "Ä", "b", "B", "ö", "Ö", "z", "Z"</code></td>
- *    </tr>
- * </table>
- * <p>
- *    <em>(* this comparator is case-insensitive so <code>["a", "A"]</code> can as well be ordered <code>["A", "a"]</code>
- *    depending on initial order)</em>
- * </p>
- *
- * <p>
- *    <em>Note! This comparator imposes orderings that are inconsistent with equals.</em>
- * </p>Returns a comparator that compares nodes by the value of a calendar property.
- *
- * <p>
- *    The property value will be extracted as a calendar using {@link senselogic.sitevision.api.property.PropertyUtil},
- *    and comparing a <code>null</code> value will result in <code>-1</code> (i.e. less than a non-null).
- * </p>
- *
- * <p>
- *    <em>Note! This comparator imposes orderings that are inconsistent with equals.</em>
- * </p>Returns a comparator that compares nodes by the value of a calendar property.
- *
- * <p>
- *    The property value will be extracted as an int using {@link senselogic.sitevision.api.property.PropertyUtil},
- *    and a <em>no value</em> value will be treated as <code>0</code>.
- * </p>
- *
- * <p>
- *    <em>Note! This comparator imposes orderings that are inconsistent with equals.</em>
- * </p>Returns a comparator that reverses the result of another.
- *
- * <p>
- *    The compareTo method of this comparator multiplies the result of another comparator's compareTo method with -1.
- *    This will typically lead to a completely reversed order when sorted.
- * </p>
- *
- * <p>
- *    <em>Note! This comparator imposes orderings that are inconsistent with equals.</em>
- * </p>Gets a builder for creating a compound comparator that allows comparison based on multiple node comparators.Gets a comparator that compares nodes by the values extracted by a resolver.
- *
- * <p>
- *    <strong>Example</strong><br>
- *    This Comparator can be helpful when you want to sort <code>sv:collaborationGroup</code> nodes in "most active" order.
- *    An example of how this can be implemented this in server-side Javascript is demonstrated below:
- * </p>
- * <pre><code>    var myIdentity = require('PortletContextUtil').getCurrentUserIdentity(),
- *       userIdentityWrapper = require('UserFactory').getUserIdentityWrapper(myIdentity),
- *       myGroups,
- *       group,
- *       count,
- *       i;
- *
- *    if (userIdentityWrapper) {
- *       myGroups = userIdentityWrapper.getCollaborationGroups();
- *       myGroups = toSortedList(myGroups);
- *       count = myGroups.size();
- *
- *       <em>// Render my groups</em>
- *       for (i = 0; i &lt; count; i++) {
- *          group = myGroups.get(i);
- *          ...
- *       }
- *    }
- *
- *    <em>// Helper function that uses a ResolverComparator to sort a collection of Collaboration groups</em>
- *    function toSortedList(groups) {
- *       var sortedGroups = require('InstanceCreatorUtil').getList(),
- *          collections,
- *          groupDateResolver,
- *          resolverComparator;
- *
- *       sortedGroups.addAll(groups); <em>// Wrap in list to make it sortable</em>
- *
- *       if (sortedGroups.size() &gt; 1) {
- *          <em>// Create a resolver that can resolve appropriate Date from a collaboration group</em>
- *          groupDateResolver = require('NodeResolverUtil').getCollaborationDateResolver();
- *
- *          <em>// Create a comparator that compares values extracted by the resolver</em>
- *          resolverComparator = require('NodeComparatorUtil').getResolverComparator(groupDateResolver);
- *
- *          <em>// Get Collections and Sort!</em>
- *          collections = require('CollectionsInstance');
- *          collections.sort(sortedGroups, resolverComparator);
- *          collections.reverse(sortedGroups); <em>// ...and reverse result to get 'latest' first</em>
- *       }
- *       return sortedGroups;
- *    }
- * </code></pre>
- *
- * <p>
- *    <em>Note!</em> Beware of resolved <code>null</code> values (null will always be "less" than a non-null)!
  * </p>
  * @author Magnus Lövgren
  * @since Sitevision 3.6
  */
-declare namespace NodeComparatorUtil {
+declare namespace nodeComparatorUtil {
   export {
     getPropertyComparator,
     getCalendarPropertyComparator,
@@ -394,4 +242,4 @@ declare namespace NodeComparatorUtil {
   };
 }
 
-export default NodeComparatorUtil;
+export default nodeComparatorUtil;

package/server/NodeComparatorUtil/index.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _default = {
+  getPropertyComparator: function getPropertyComparator() {},
+  getCalendarPropertyComparator: function getCalendarPropertyComparator() {},
+  getIntPropertyComparator: function getIntPropertyComparator() {},
+  getReversedComparator: function getReversedComparator() {},
+  getCompoundComparatorBuilder: function getCompoundComparatorBuilder() {},
+  getResolverComparator: function getResolverComparator() {}
+};
+exports["default"] = _default;

package/server/NodeFactoryUtil/index.d.ts

@@ -21,12 +21,12 @@ export function getTemporaryFileNodeBuilder(): TemporaryFileNodeBuilder;
  *    An instance of the Sitevision class implementing this interface can be obtained via
  *    {@link senselogic.sitevision.api.Utils#getNodeFactoryUtil()}.
  *    See {@link senselogic.sitevision.api.Utils} for how to obtain an instance of the <code>Utils</code> interface.
- * </p>Gets a builder for creating temporary nodes (sv:temporary).Gets a builder for creating temporary file nodes (sv:temporaryFile).
+ * </p>
  * @author Magnus Lövgren
  * @since Sitevision 4.1.2
  */
-declare namespace NodeFactoryUtil {
+declare namespace nodeFactoryUtil {
   export { getTemporaryNodeBuilder, getTemporaryFileNodeBuilder };
 }
 
-export default NodeFactoryUtil;
+export default nodeFactoryUtil;

package/server/NodeFactoryUtil/index.js

@@ -0,0 +1,11 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _default = {
+  getTemporaryNodeBuilder: function getTemporaryNodeBuilder() {},
+  getTemporaryFileNodeBuilder: function getTemporaryFileNodeBuilder() {}
+};
+exports["default"] = _default;

package/server/NodeFilterUtil/index.d.ts

@@ -1,5 +1,6 @@
-import Filter from "../../hidden/senselogic/sitevision/api/base/Filter";
-import FilterSplit from "../../hidden/senselogic/sitevision/api/base/FilterSplit";
+import type { Filter } from "../../types/senselogic/sitevision/api/base/Filter";
+
+import type { FilterSplit } from "../../types/senselogic/sitevision/api/base/FilterSplit";
 import CompoundAndFilterBuilder from "../CompoundAndFilterBuilder";
 import CompoundOrFilterBuilder from "../CompoundOrFilterBuilder";
 
@@ -10,9 +11,9 @@ import CompoundOrFilterBuilder from "../CompoundOrFilterBuilder";
  * @return a list of all nodes of <code>aNodeList</code> that is accepted by <code>aNodeFilter</code>, never <code>null</code>. <code>aNodeList</code> itself is returned if it's empty or if <code>aNodeFilter</code> is <code>null</code>
  */
 export function getFilteredList(
-  aNodeList: unknown[],
+  aNodeList: unknown,
   aNodeFilter: Filter
-): unknown[];
+): unknown;
 
 /**
  * Applies a node filter to a Map with Node values and gets the result.
@@ -22,9 +23,9 @@ export function getFilteredList(
  * @since Sitevision 4.3.1
  */
 export function getFilteredValueMap(
-  aNodeValueMap: Record<unknown, unknown>,
+  aNodeValueMap: unknown,
   aNodeFilter: Filter
-): Record<unknown, unknown>;
+): unknown;
 
 /**
  * Applies a node filter to a Map with Node keys and gets the result.
@@ -34,9 +35,9 @@ export function getFilteredValueMap(
  * @since Sitevision 4.3.1
  */
 export function getFilteredKeyMap(
-  aNodeKeyMap: Record<unknown, unknown>,
+  aNodeKeyMap: unknown,
   aNodeFilter: Filter
-): Record<unknown, unknown>;
+): unknown;
 
 /**
  * Gets the filtering result of a split operation for a collection of nodes with a node filter as divider.
@@ -775,98 +776,11 @@ export function getRangeNestedCalendarPropertyFilter(
  * <p>
  *    An instance of the Sitevision class implementing this interface can be obtained via {@link senselogic.sitevision.api.Utils#getNodeFilterUtil()}.
  *    See {@link senselogic.sitevision.api.Utils} for how to obtain an instance of the <code>Utils</code> interface.
- * </p>Applies a node filter to a list and gets the result.Applies a node filter to a Map with Node values and gets the result.Applies a node filter to a Map with Node keys and gets the result.Gets the filtering result of a split operation for a collection of nodes with a node filter as divider.
- *
- * <p>
- *    This method would typically be used instead of {@link #getFilteredList(java.util.List, senselogic.sitevision.api.base.Filter)}
- *    when you are also interested in the nodes that does NOT match the filter.
- * </p>
- *
- * <p>
- *    When nodes are available via a <code>NodeIterator</code>, you would typically use the
- *    {@link senselogic.sitevision.api.node.NodeIteratorUtil#split(javax.jcr.NodeIterator, senselogic.sitevision.api.base.Filter)}
- *    instead!
- * </p>Gets a builder for creating a compound filter that requires that <em>all</em> of the containing filters matches.
- *
- * <p>
- *    The CompoundAndFilterBuilder builds a node filter of multiple filters that are combined using the logical
- *    <em>AND</em> operator.
- * </p>Gets a builder for creating a compound filter that requires that <em>any</em> of the containing filters matches.
- *
- * <p>
- *    The CompoundOrFilterBuilder builds a node filter of multiple filters that are combined using the logical
- *    <em>OR</em> operator.
- * </p>Gets a filter that always matches.Gets a filter that never matches.Gets a filter that matches null nodes.Gets a filter that matches non-null nodes.Gets a filter that inverts the result of another filter.Gets a filter that matches by a specified node identifier.Gets a filter that matches by a specified node identifier prefix.Gets a filter that matches by a specified node identifier suffix.Gets a filter that matches by a specified primary node type.Gets a filter that matches all nodes that has a primary node type that is present in given collection.
- *
- * <p>
- *    This convenience method is conceptually equivalent - but also more efficient - than building a "match any of" filter via
- *    {@link #getCompoundOrFilterBuilder() CompoundOrFilter} with a number of {@link #getPrimaryNodeTypeFilter(String) PrimaryNodeTypeFilters}.
- * </p>Gets a filter that matches all nodes that does not have a primary node type present in given collection.
- *
- * <p>
- *    This convenience method is conceptually equivalent - but also more efficient - than building a "match none of" filter via
- *    {@link #getCompoundOrFilterBuilder() CompoundOrFilter} with a number of {@link #getPrimaryNodeTypeFilter(String) PrimaryNodeTypeFilters}
- *    and a {@link #getInvertedFilter(Filter) InvertedFilter}
- * </p>Gets a filter that matches by the existence of a specified property.Gets a filter that matches by a specified string property.Gets a filter that matches by a specified multi-valued string property.Gets a filter that matches case-insensitive by a specified string property.Gets a filter that matches by the value-starts-with of a specified string property.
- *
- * <p>
- *    <em>The starts-with check is performed using the <code>String.startsWith(String)</code> method.</em>
- * </p>Gets a filter that matches by the value-ends-with of a specified string property.
- *
- * <p>
- *    <em>The ends-with check is performed using the <code>String.endsWith(String)</code> method.</em>
- * </p>Gets a filter that matches by the value-contains of a specified string property.
- *
- * <p>
- *    <em>The contains check is performed using the <code>String.contains(String)</code> method.</em>
- * </p>Gets a filter that matches by the value-contains of a specified multi-valued string property.
- *
- * <p>
- *    <em>The contains check is performed using the <code>String.contains(String)</code> method for each extracted property value.</em>
- * </p>Gets a filter that matches by a regular expression of a specified string property.
- *
- * <p>
- *    <em>The regular expression is compiled to a <code>Pattern</code> and the check is performed using the
- *    <code>matches()</code> method of the <code>Matcher</code> extracted from the compiled pattern via
- *    <code>Pattern.matcher(String)</code>.</em>
- * </p>Gets a filter that matches by a regular expression of a specified multi-valued string property.
- *
- * <p>
- *    <em>The regular expression is compiled to a <code>Pattern</code> and the check for each extracted property value is performed using the
- *    <code>matches()</code> method of the <code>Matcher</code> extracted from the compiled pattern via
- *    <code>Pattern.matcher(String)</code>.</em>
- * </p>Gets a filter that matches by a specified boolean property.Gets a filter that matches by a nested node's specified boolean property.Gets a filter that matches by a specified int property.Gets a filter that matches by the min value of a specified int property.Gets a filter that matches by the max value of a specified int property.Gets a filter that matches by the range of a specified int property.
- *
- * <p>
- *    <em>This is a convenience method that combines the min int filter ({@link #getMinIntPropertyFilter(String, int)})
- *    and the max int filter ({@link #getMinIntPropertyFilter(String, int)}) to check a range for an integer.</em>
- * </p>Gets a filter that matches by a nested node's specified int property.Gets a filter that matches by a nested node's min value of a specified int property.Gets a filter that matches by a nested node's max value of a specified int property.Gets a filter that matches by a nested node's range of a specified int property.
- *
- * <p>
- *    <em>This is a convenience method that combines the nested min int filter ({@link #getMinNestedIntPropertyFilter(String, String, int)})
- *    and the nested max int filter ({@link #getMaxNestedIntPropertyFilter(String, String, int)}) to check a range for an integer.</em>
- * </p>Gets a filter that matches by a specified double property.Gets a filter that matches by a nested node's specified double property.Gets a filter that matches by the min value of a specified double property.Gets a filter that matches by the max value of a specified double property.Gets a filter that matches by the range of a specified double property.
- *
- * <p>
- *    <em>This is a convenience method that combines the min double filter ({@link #getMinDoublePropertyFilter(String, double)})
- *    and the max double filter ({@link #getMaxDoublePropertyFilter(String, double)}) to check a range for a double.</em>
- * </p>Gets a filter that matches by a specified Calendar property.Gets a filter that matches by a nested node's specified Calendar property.Gets a filter that matches by a before value for a specified Calendar property.Gets a filter that matches by a before value of a nested node's specified Calendar property.Gets a filter that matches by an after value for a specified Calendar property.Gets a filter that matches by an after value of a nested node's specified Calendar property.Gets a filter that matches by the between range of a specified Calendar property.
- *
- * <p>
- *    <em>This is a convenience method that combines the after calendar filter
- *    ({@link #getAfterCalendarPropertyFilter(String, java.util.Calendar)})
- *    and the before calendar filter ({@link #getBeforeCalendarPropertyFilter(String, java.util.Calendar)}) to check a range for a Calendar.</em>
- * </p>Gets a filter that matches by the between range of a nested node's specified Calendar property.
- *
- * <p>
- *    <em>This is a convenience method that combines the nested after calendar filter
- *    ({@link #getAfterNestedCalendarPropertyFilter(String, String, java.util.Calendar)}) and the nested before calendar filter
- *    ({@link #getBeforeNestedCalendarPropertyFilter(String, String, java.util.Calendar)}) to check a range for a Calendar.</em>
  * </p>
  * @author Magnus Lövgren
  * @since Sitevision 3.6.2
  */
-declare namespace NodeFilterUtil {
+declare namespace nodeFilterUtil {
   export {
     getFilteredList,
     getFilteredValueMap,
@@ -921,4 +835,4 @@ declare namespace NodeFilterUtil {
   };
 }
 
-export default NodeFilterUtil;
+export default nodeFilterUtil;

package/server/NodeFilterUtil/index.js

@@ -0,0 +1,59 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _default = {
+  getFilteredList: function getFilteredList() {},
+  getFilteredValueMap: function getFilteredValueMap() {},
+  getFilteredKeyMap: function getFilteredKeyMap() {},
+  split: function split() {},
+  getCompoundAndFilterBuilder: function getCompoundAndFilterBuilder() {},
+  getCompoundOrFilterBuilder: function getCompoundOrFilterBuilder() {},
+  getAlwaysAcceptFilter: function getAlwaysAcceptFilter() {},
+  getNeverAcceptFilter: function getNeverAcceptFilter() {},
+  getNullFilter: function getNullFilter() {},
+  getNonNullFilter: function getNonNullFilter() {},
+  getInvertedFilter: function getInvertedFilter() {},
+  getIdentifierFilter: function getIdentifierFilter() {},
+  getIdentifierPrefixFilter: function getIdentifierPrefixFilter() {},
+  getIdentifierSuffixFilter: function getIdentifierSuffixFilter() {},
+  getPrimaryNodeTypeFilter: function getPrimaryNodeTypeFilter() {},
+  getAnyOfPrimaryNodeTypesFilter: function getAnyOfPrimaryNodeTypesFilter() {},
+  getNoneOfPrimaryNodeTypesFilter: function getNoneOfPrimaryNodeTypesFilter() {},
+  getHasPropertyFilter: function getHasPropertyFilter() {},
+  getStringPropertyFilter: function getStringPropertyFilter() {},
+  getStringMultiPropertyFilter: function getStringMultiPropertyFilter() {},
+  getIgnoreCaseStringPropertyFilter: function getIgnoreCaseStringPropertyFilter() {},
+  getStartsWithStringPropertyFilter: function getStartsWithStringPropertyFilter() {},
+  getEndsWithStringPropertyFilter: function getEndsWithStringPropertyFilter() {},
+  getContainsStringPropertyFilter: function getContainsStringPropertyFilter() {},
+  getContainsStringMultiPropertyFilter: function getContainsStringMultiPropertyFilter() {},
+  getPatternStringPropertyFilter: function getPatternStringPropertyFilter() {},
+  getPatternStringMultiPropertyFilter: function getPatternStringMultiPropertyFilter() {},
+  getBooleanPropertyFilter: function getBooleanPropertyFilter() {},
+  getNestedBooleanPropertyFilter: function getNestedBooleanPropertyFilter() {},
+  getIntPropertyFilter: function getIntPropertyFilter() {},
+  getMinIntPropertyFilter: function getMinIntPropertyFilter() {},
+  getMaxIntPropertyFilter: function getMaxIntPropertyFilter() {},
+  getRangeIntPropertyFilter: function getRangeIntPropertyFilter() {},
+  getNestedIntPropertyFilter: function getNestedIntPropertyFilter() {},
+  getMinNestedIntPropertyFilter: function getMinNestedIntPropertyFilter() {},
+  getMaxNestedIntPropertyFilter: function getMaxNestedIntPropertyFilter() {},
+  getRangeNestedIntPropertyFilter: function getRangeNestedIntPropertyFilter() {},
+  getDoublePropertyFilter: function getDoublePropertyFilter() {},
+  getNestedDoublePropertyFilter: function getNestedDoublePropertyFilter() {},
+  getMinDoublePropertyFilter: function getMinDoublePropertyFilter() {},
+  getMaxDoublePropertyFilter: function getMaxDoublePropertyFilter() {},
+  getRangeDoublePropertyFilter: function getRangeDoublePropertyFilter() {},
+  getCalendarPropertyFilter: function getCalendarPropertyFilter() {},
+  getNestedCalendarPropertyFilter: function getNestedCalendarPropertyFilter() {},
+  getBeforeCalendarPropertyFilter: function getBeforeCalendarPropertyFilter() {},
+  getBeforeNestedCalendarPropertyFilter: function getBeforeNestedCalendarPropertyFilter() {},
+  getAfterCalendarPropertyFilter: function getAfterCalendarPropertyFilter() {},
+  getAfterNestedCalendarPropertyFilter: function getAfterNestedCalendarPropertyFilter() {},
+  getRangeCalendarPropertyFilter: function getRangeCalendarPropertyFilter() {},
+  getRangeNestedCalendarPropertyFilter: function getRangeNestedCalendarPropertyFilter() {}
+};
+exports["default"] = _default;

package/server/NodeIteratorUtil/index.d.ts

@@ -1,7 +1,9 @@
-import NodeIterator from "../../hidden/javax/jcr/NodeIterator";
-import Filter from "../../hidden/senselogic/sitevision/api/base/Filter";
-import Node from "../../hidden/javax/jcr/Node";
-import FilterSplit from "../../hidden/senselogic/sitevision/api/base/FilterSplit";
+import type { NodeIterator } from "../../types/javax/jcr/NodeIterator";
+import type { Filter } from "../../types/senselogic/sitevision/api/base/Filter";
+
+import type { Node } from "../../types/javax/jcr/Node";
+
+import type { FilterSplit } from "../../types/senselogic/sitevision/api/base/FilterSplit";
 
 /**
  * Gets a filtered NodeIterator.
@@ -158,7 +160,7 @@ export function findNodes(
   aNodeIterator: NodeIterator,
   aFilter: Filter,
   aMaxNodesToFind: number
-): unknown[];
+): unknown;
 
 /**
  * Gets a list of all nodes from a node iterator that matches a specified filter.
@@ -174,10 +176,7 @@ export function findNodes(
  * @return a list of nodes that matches <code>aFilter</code>, never <code>null</code>. If <code>aFilter</code> is <code>null</code>, the filter will be ignored (all nodes will be accepted). If <code>aNodeIterator</code> is <code>null</code>, an empty list will be returned.
  * @since Sitevision 3.6.2
  */
-export function findAll(
-  aNodeIterator: NodeIterator,
-  aFilter: Filter
-): unknown[];
+export function findAll(aNodeIterator: NodeIterator, aFilter: Filter): unknown;
 
 /**
  * Gets a list of all nodes of a node iterator.
@@ -197,7 +196,7 @@ export function findAll(
  * @return a list of all nodes provided by <code>aNodeIterator</code>, never <code>null</code>.
  * @since Sitevision 3.6.2
  */
-export function toList(aNodeIterator: NodeIterator): unknown[];
+export function toList(aNodeIterator: NodeIterator): unknown;
 
 /**
  * Gets the filtering result of a split operation for a node iterator with a node filter as divider.
@@ -228,115 +227,10 @@ export function split(
  *    An instance of the Sitevision class implementing this interface can be obtained via
  *    {@link senselogic.sitevision.api.Utils#getNodeIteratorUtil()}.
  *    See {@link senselogic.sitevision.api.Utils} for how to obtain an instance of the <code>Utils</code> interface.
- * </p>Gets a filtered NodeIterator.
- *
- * <p>
- *    This NodeIterator decorates a NodeIterator with a Filter, i.e. it will only return nodes that matches given filter.
- * </p>
- *
- * <p>
- *    This <strong>server-side Javascript example</strong> demonstrates how to create a node iterator that is very similar to the
- *    {@link #getMenuItems(Node) MenuItems} iterator but this node iterator is not respecting the "visibleInMenus" property.
- * </p>
- * <pre><code>    const nodeFilterUtil = require('NodeFilterUtil');
- *    const nodeIteratorUtil = require('NodeIteratorUtil');
- *    const startNode = ...
- *
- *    const filter = nodeFilterUtil.getAnyOfPrimaryNodeTypesFilter([
- *       'sv:page', 'sv:structurePage', 'sv:article', 'sv:link', 'sv:structureLink', 'sv:collaborationGroupPage'
- *    ]);
- *    const nodes = nodeIteratorUtil.getFilteredNodeIterator(startNode.getNodes(), filter);
- *
- *    while (nodes.hasNext()) {
- *       let node = nodes.nextNode();
- *       ...
- *    }</code></pre>Gets a node iterator via a node identifier.
- *
- * <p>
- *    The purpose of this method is twofold:
- * </p>
- * <ul>
- *    <li>
- *       <em>Convenience.</em> This method combines {@link javax.jcr.Session#getNodeByIdentifier(String)} and {@link Node#getNodes()},
- *       i.e. a shortcut to get an iterator without having to actually lookup/resolve the parent node.
- *    </li>
- *    <li>
- *       <em>Permission workaround.</em> This method does <em>not</em> do any permission checks on the resolved parent Node, i.e.
- *       a shortcut to get an iterator of children where you (potentially) have permission from a parent where you don't.
- *    </li>
- * </ul>Gets an iterator for default menu items (i.e. non-hidden pages, link pages etc. where current user has read permission)Gets an iterator for default menu items via a node identifier.
- *
- * <p>
- *    The purpose of this method is twofold:
- * </p>
- * <ul>
- *    <li>
- *       <em>Convenience.</em> This method combines {@link javax.jcr.Session#getNodeByIdentifier(String)} and {@link #getMenuItems(Node)},
- *       i.e. a shortcut to get a menu iterator without having to actually lookup/resolve the parent node.
- *    </li>
- *    <li>
- *       <em>Permission workaround.</em> This method does <em>not</em> do any permission checks on the resolved parent Node, i.e.
- *       a shortcut to get an iterator of children where you (potentially) have permission from a parent where you don't.
- *    </li>
- * </ul>Gets an iterator for default menu items (i.e. getMenuItems(Node)), including foldersGets an iterator for default menu items (including folders) via a node identifier.
- *
- * <p>
- *    The purpose of this method is twofold:
- * </p>
- * <ul>
- *    <li>
- *       <em>Convenience.</em> This method combines {@link javax.jcr.Session#getNodeByIdentifier(String)} and
- *       {@link #getMenuItemsIncludingFolders(Node)}, i.e. a shortcut to get a menu iterator without having to actually
- *       lookup/resolve the parent node.
- *    </li>
- *    <li>
- *       <em>Permission workaround.</em> This method does <em>not</em> do any permission checks on the resolved parent Node, i.e.
- *       a shortcut to get an iterator of children where you (potentially) have permission from a parent where you don't.
- *    </li>
- * </ul>Gets the first node from a node iterator that matches a specified filter.
- *
- * <p>
- *    <em>Tip!</em> Use {@link senselogic.sitevision.api.node.NodeFilterUtil} to get
- *    an appropriate node filter.
- * </p>Gets a max-sized node list from a node iterator that matches a specified filter.
- *
- * <p>
- *    <em>Tip!</em> Use {@link senselogic.sitevision.api.node.NodeFilterUtil} to get
- *    an appropriate node filter. If the list of nodes should be sorted by a specific property value,
- *    you would typically use {@link senselogic.sitevision.api.node.NodeComparatorUtil}
- *    to get an appropriate <code>Comparator</code>.
- * </p>Gets a list of all nodes from a node iterator that matches a specified filter.
- *
- * <p>
- *    <em>Tip!</em> Use {@link senselogic.sitevision.api.node.NodeFilterUtil} to get
- *    an appropriate node filter. If the list of nodes should be sorted by a specific property value,
- *    you would typically use {@link senselogic.sitevision.api.node.NodeComparatorUtil}
- *    to get an appropriate <code>Comparator</code>.
- * </p>Gets a list of all nodes of a node iterator.
- *
- * <p>
- *    <strong>Note!</strong> This is a convenience method to use <strong>only when you must</strong> get nodes as a list!
- *    The only apparent reason is when you need need to <em>sort</em> the nodes! If you don't, you should use
- *    the <code>NodeIterator</code> instead and do your processing for each node.
- * </p>
- * <p>
- *    <strong>Sorting tip!</strong> When the list of nodes should be sorted by a specific <em>property value</em>,
- *    you would typically use {@link senselogic.sitevision.api.node.NodeComparatorUtil}to get an appropriate
- *    <code>Comparator</code>. The list can then be sorted by <code>Collections.sort(List, Comparator)</code>.
- *    When using Velocity, you must use the non-static class {@link senselogic.sitevision.api.script.factory.CollectionsInstance}.
- * </p>Gets the filtering result of a split operation for a node iterator with a node filter as divider.
- *
- * <p>
- *    This method would typically be used instead of {@link #findAll(javax.jcr.NodeIterator, senselogic.sitevision.api.base.Filter)}
- *    when you are also interested in the nodes that does NOT match the filter.
- * </p>
- * <p>
- *    <em>Note!</em> If <code>aFilter</code> is <code>null</code>, no nodes will match (all nodes
- *    gathered via <code>aNodeIterator</code> will be <em>rejected</em> in the resulting filter split).
  * </p>
  * @author Magnus Lövgren
  */
-declare namespace NodeIteratorUtil {
+declare namespace nodeIteratorUtil {
   export {
     getFilteredNodeIterator,
     getNodeIteratorByIdentifier,
@@ -352,4 +246,4 @@ declare namespace NodeIteratorUtil {
   };
 }
 
-export default NodeIteratorUtil;
+export default nodeIteratorUtil;

package/server/NodeIteratorUtil/index.js

@@ -5,16 +5,16 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 var _default = {
-  findAll: function findAll() {},
-  findFirst: function findFirst() {},
-  findNodes: function findNodes() {},
   getFilteredNodeIterator: function getFilteredNodeIterator() {},
+  getNodeIteratorByIdentifier: function getNodeIteratorByIdentifier() {},
   getMenuItems: function getMenuItems() {},
   getMenuItemsByIdentifier: function getMenuItemsByIdentifier() {},
   getMenuItemsIncludingFolders: function getMenuItemsIncludingFolders() {},
   getMenuItemsIncludingFoldersByIdentifier: function getMenuItemsIncludingFoldersByIdentifier() {},
-  getNodeIteratorByIdentifier: function getNodeIteratorByIdentifier() {},
-  split: function split() {},
-  toList: function toList() {}
+  findFirst: function findFirst() {},
+  findNodes: function findNodes() {},
+  findAll: function findAll() {},
+  toList: function toList() {},
+  split: function split() {}
 };
 exports["default"] = _default;