@rimbu/deep 0.12.1 → 0.13.0

package/dist/main/match.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.match = void 0;
+var tslib_1 = require("tslib");
 var base_1 = require("@rimbu/base");
 /**
  * Returns true if the given `value` object matches the given `matcher`, false otherwise.
@@ -8,7 +9,7 @@ var base_1 = require("@rimbu/base");
  * @typeparam C - utility type
  * @param source - the value to match (should be a plain object)
  * @param matcher - a matcher object or a function taking the matcher API and returning a match object
- * @param errorCollector - (optional) a string array that can be passed to collect reasons why the match failed
+ * @param failureLog - (optional) a string array that can be passed to collect reasons why the match failed
  * @example
  * ```ts
  * const input = { a: 1, b: { c: true, d: 'a' } }
@@ -21,15 +22,14 @@ var base_1 = require("@rimbu/base");
  *  // => true
  * ```
  */
-function match(source, matcher, errorCollector) {
-    if (errorCollector === void 0) { errorCollector = undefined; }
-    return matchEntry(source, source, source, matcher, errorCollector);
+function match(source, matcher, failureLog) {
+    return matchEntry(source, source, source, matcher, failureLog);
 }
 exports.match = match;
 /**
  * Match a generic match entry against the given source.
  */
-function matchEntry(source, parent, root, matcher, errorCollector) {
+function matchEntry(source, parent, root, matcher, failureLog) {
     if (Object.is(source, matcher)) {
         // value and target are exactly the same, always will be true
         return true;
@@ -37,14 +37,14 @@ function matchEntry(source, parent, root, matcher, errorCollector) {
     if (matcher === null || matcher === undefined) {
         // these matchers can only be direct matches, and previously it was determined that
         // they are not equal
-        errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push("value ".concat(JSON.stringify(source), " did not match matcher ").concat(matcher));
+        failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("value ".concat(JSON.stringify(source), " did not match matcher ").concat(matcher));
         return false;
     }
     if (typeof source === 'function') {
         // function source values can only be directly matched
         var result = Object.is(source, matcher);
         if (!result) {
-            errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push("both value and matcher are functions, but they do not have the same reference");
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("both value and matcher are functions, but they do not have the same reference");
         }
         return result;
     }
@@ -54,62 +54,87 @@ function matchEntry(source, parent, root, matcher, errorCollector) {
         if (typeof matcherResult === 'boolean') {
             // function resulted in a direct match result
             if (!matcherResult) {
-                errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push("function matcher returned false for value ".concat(JSON.stringify(source)));
+                failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("function matcher returned false for value ".concat(JSON.stringify(source)));
             }
             return matcherResult;
         }
         // function resulted in a value that needs to be further matched
-        return matchEntry(source, parent, root, matcherResult, errorCollector);
+        return matchEntry(source, parent, root, matcherResult, failureLog);
     }
     if ((0, base_1.isPlainObj)(source)) {
         // source ia a plain object, can be partially matched
-        return matchPlainObj(source, parent, root, matcher, errorCollector);
+        return matchPlainObj(source, parent, root, matcher, failureLog);
     }
     if (Array.isArray(source)) {
         // source is an array
-        return matchArr(source, root, matcher, errorCollector);
+        return matchArr(source, parent, root, matcher, failureLog);
     }
     // already determined above that the source and matcher are not equal
-    errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push("value ".concat(JSON.stringify(source), " does not match given matcher ").concat(JSON.stringify(matcher)));
+    failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("value ".concat(JSON.stringify(source), " does not match given matcher ").concat(JSON.stringify(matcher)));
     return false;
 }
 /**
  * Match an array matcher against the given source.
  */
-function matchArr(source, root, matcher, errorCollector) {
+function matchArr(source, parent, root, matcher, failureLog) {
     if (Array.isArray(matcher)) {
         // directly compare array contents
         var length_1 = source.length;
         if (length_1 !== matcher.length) {
             // if lengths not equal, arrays are not equal
-            errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push("array lengths are not equal: value length ".concat(source.length, " !== matcher length ").concat(matcher.length));
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("array lengths are not equal: value length ".concat(source.length, " !== matcher length ").concat(matcher.length));
             return false;
         }
         // loop over arrays, matching every value
         var index = -1;
         while (++index < length_1) {
-            if (!Object.is(source[index], matcher[index])) {
+            if (!matchEntry(source[index], source, root, matcher[index], failureLog)) {
                 // item did not match, return false
-                errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push("index ".concat(index, " does not match with value ").concat(JSON.stringify(source[index]), " and matcher ").concat(matcher[index]));
+                failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("index ".concat(index, " does not match with value ").concat(JSON.stringify(source[index]), " and matcher ").concat(matcher[index]));
                 return false;
             }
         }
         // all items are equal
         return true;
     }
+    // matcher is plain object
+    if ("every" in matcher) {
+        return matchCompound(source, parent, root, tslib_1.__spreadArray(['every'], tslib_1.__read(matcher.every), false), failureLog);
+    }
+    if ("some" in matcher) {
+        return matchCompound(source, parent, root, tslib_1.__spreadArray(['some'], tslib_1.__read(matcher.some), false), failureLog);
+    }
+    if ("none" in matcher) {
+        return matchCompound(source, parent, root, tslib_1.__spreadArray(['none'], tslib_1.__read(matcher.none), false), failureLog);
+    }
+    if ("single" in matcher) {
+        return matchCompound(source, parent, root, tslib_1.__spreadArray(['single'], tslib_1.__read(matcher.single), false), failureLog);
+    }
+    if ("someItem" in matcher) {
+        return matchTraversal(source, root, 'someItem', matcher.someItem, failureLog);
+    }
+    if ("everyItem" in matcher) {
+        return matchTraversal(source, root, 'everyItem', matcher.everyItem, failureLog);
+    }
+    if ("noneItem" in matcher) {
+        return matchTraversal(source, root, 'noneItem', matcher.noneItem, failureLog);
+    }
+    if ("singleItem" in matcher) {
+        return matchTraversal(source, root, 'singleItem', matcher.singleItem, failureLog);
+    }
     // matcher is plain object with index keys
     for (var index in matcher) {
         var matcherAtIndex = matcher[index];
         if (!(index in source)) {
             // source does not have item at given index
-            errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push("index ".concat(index, " does not exist in source ").concat(JSON.stringify(source), " but should match matcher ").concat(JSON.stringify(matcherAtIndex)));
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("index ".concat(index, " does not exist in source ").concat(JSON.stringify(source), " but should match matcher ").concat(JSON.stringify(matcherAtIndex)));
             return false;
         }
         // match the source item at the given index
-        var result = matchEntry(source[index], source, root, matcherAtIndex, errorCollector);
+        var result = matchEntry(source[index], source, root, matcherAtIndex, failureLog);
         if (!result) {
             // item did not match
-            errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push("index ".concat(index, " does not match with value ").concat(JSON.stringify(source[index]), " and matcher ").concat(JSON.stringify(matcherAtIndex)));
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("index ".concat(index, " does not match with value ").concat(JSON.stringify(source[index]), " and matcher ").concat(JSON.stringify(matcherAtIndex)));
             return false;
         }
     }
@@ -119,22 +144,22 @@ function matchArr(source, root, matcher, errorCollector) {
 /**
  * Match an object matcher against the given source.
  */
-function matchPlainObj(source, parent, root, matcher, errorCollector) {
+function matchPlainObj(source, parent, root, matcher, failureLog) {
     if (Array.isArray(matcher)) {
         // the matcher is of compound type
-        return matchCompound(source, parent, root, matcher, errorCollector);
+        return matchCompound(source, parent, root, matcher, failureLog);
     }
     // partial object props matcher
     for (var key in matcher) {
         if (!(key in source)) {
             // the source does not have the given key
-            errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push("key ".concat(key, " is specified in matcher but not present in value ").concat(JSON.stringify(source)));
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("key ".concat(key, " is specified in matcher but not present in value ").concat(JSON.stringify(source)));
             return false;
         }
         // match the source value at the given key with the matcher at given key
-        var result = matchEntry(source[key], source, root, matcher[key], errorCollector);
+        var result = matchEntry(source[key], source, root, matcher[key], failureLog);
         if (!result) {
-            errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push("key ".concat(key, " does not match in value ").concat(JSON.stringify(source[key]), " with matcher ").concat(JSON.stringify(matcher[key])));
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("key ".concat(key, " does not match in value ").concat(JSON.stringify(source[key]), " with matcher ").concat(JSON.stringify(matcher[key])));
             return false;
         }
     }
@@ -144,7 +169,7 @@ function matchPlainObj(source, parent, root, matcher, errorCollector) {
 /**
  * Match a compound matcher against the given source.
  */
-function matchCompound(source, parent, root, compound, errorCollector) {
+function matchCompound(source, parent, root, compound, failureLog) {
     // first item indicates compound match type
     var matchType = compound[0];
     var length = compound.length;
@@ -154,9 +179,9 @@ function matchCompound(source, parent, root, compound, errorCollector) {
         case 'every': {
             while (++index < length) {
                 // if any item does not match, return false
-                var result = matchEntry(source, parent, root, compound[index], errorCollector);
+                var result = matchEntry(source, parent, root, compound[index], failureLog);
                 if (!result) {
-                    errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push("in compound \"every\": match at index ".concat(index, " failed"));
+                    failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("in compound \"every\": match at index ".concat(index, " failed"));
                     return false;
                 }
             }
@@ -165,9 +190,9 @@ function matchCompound(source, parent, root, compound, errorCollector) {
         case 'none': {
             // if any item matches, return false
             while (++index < length) {
-                var result = matchEntry(source, parent, root, compound[index], errorCollector);
+                var result = matchEntry(source, parent, root, compound[index], failureLog);
                 if (result) {
-                    errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push("in compound \"none\": match at index ".concat(index, " succeeded"));
+                    failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("in compound \"none\": match at index ".concat(index, " succeeded"));
                     return false;
                 }
             }
@@ -177,31 +202,81 @@ function matchCompound(source, parent, root, compound, errorCollector) {
             // if not exactly one item matches, return false
             var onePassed = false;
             while (++index < length) {
-                var result = matchEntry(source, parent, root, compound[index], errorCollector);
+                var result = matchEntry(source, parent, root, compound[index], failureLog);
                 if (result) {
                     if (onePassed) {
-                        errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push("in compound \"single\": multiple matches succeeded");
+                        failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("in compound \"single\": multiple matches succeeded");
                         return false;
                     }
                     onePassed = true;
                 }
             }
             if (!onePassed) {
-                errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push("in compound \"single\": no matches succeeded");
+                failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("in compound \"single\": no matches succeeded");
             }
             return onePassed;
         }
         case 'some': {
             // if any item matches, return true
             while (++index < length) {
-                var result = matchEntry(source, parent, root, compound[index], errorCollector);
+                var result = matchEntry(source, parent, root, compound[index], failureLog);
                 if (result) {
                     return true;
                 }
             }
-            errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push("in compound \"some\": no matches succeeded");
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("in compound \"some\": no matches succeeded");
             return false;
         }
     }
 }
+function matchTraversal(source, root, matchType, matcher, failureLog) {
+    var index = -1;
+    var length = source.length;
+    switch (matchType) {
+        case 'someItem': {
+            while (++index < length) {
+                if (matchEntry(source[index], source, root, matcher, failureLog)) {
+                    return true;
+                }
+            }
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("in array traversal \"someItem\": no items matched given matcher");
+            return false;
+        }
+        case 'everyItem': {
+            while (++index < length) {
+                if (!matchEntry(source[index], source, root, matcher, failureLog)) {
+                    failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("in array traversal \"everyItem\": at least one item did not match given matcher");
+                    return false;
+                }
+            }
+            return true;
+        }
+        case 'noneItem': {
+            while (++index < length) {
+                if (matchEntry(source[index], source, root, matcher, failureLog)) {
+                    failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("in array traversal \"noneItem\": at least one item matched given matcher");
+                    return false;
+                }
+            }
+            return true;
+        }
+        case 'singleItem': {
+            var singleMatched = false;
+            while (++index < length) {
+                if (matchEntry(source[index], source, root, matcher, failureLog)) {
+                    if (singleMatched) {
+                        failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("in array traversal \"singleItem\": more than one item matched given matcher");
+                        return false;
+                    }
+                    singleMatched = true;
+                }
+            }
+            if (!singleMatched) {
+                failureLog === null || failureLog === void 0 ? void 0 : failureLog.push("in array traversal \"singleItem\": no item matched given matcher");
+                return false;
+            }
+            return true;
+        }
+    }
+}
 //# sourceMappingURL=match.js.map

package/dist/main/match.js.map

@@ -1 +1 @@
-{"version":3,"file":"match.js","sourceRoot":"","sources":["../../src/match.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../../src/match.ts"],"names":[],"mappings":"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"}

package/dist/module/match.js

@@ -5,7 +5,7 @@ import { isPlainObj, } from '@rimbu/base';
  * @typeparam C - utility type
  * @param source - the value to match (should be a plain object)
  * @param matcher - a matcher object or a function taking the matcher API and returning a match object
- * @param errorCollector - (optional) a string array that can be passed to collect reasons why the match failed
+ * @param failureLog - (optional) a string array that can be passed to collect reasons why the match failed
  * @example
  * ```ts
  * const input = { a: 1, b: { c: true, d: 'a' } }
@@ -18,13 +18,13 @@ import { isPlainObj, } from '@rimbu/base';
  *  // => true
  * ```
  */
-export function match(source, matcher, errorCollector = undefined) {
-    return matchEntry(source, source, source, matcher, errorCollector);
+export function match(source, matcher, failureLog) {
+    return matchEntry(source, source, source, matcher, failureLog);
 }
 /**
  * Match a generic match entry against the given source.
  */
-function matchEntry(source, parent, root, matcher, errorCollector) {
+function matchEntry(source, parent, root, matcher, failureLog) {
     if (Object.is(source, matcher)) {
         // value and target are exactly the same, always will be true
         return true;
@@ -32,14 +32,14 @@ function matchEntry(source, parent, root, matcher, errorCollector) {
     if (matcher === null || matcher === undefined) {
         // these matchers can only be direct matches, and previously it was determined that
         // they are not equal
-        errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push(`value ${JSON.stringify(source)} did not match matcher ${matcher}`);
+        failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`value ${JSON.stringify(source)} did not match matcher ${matcher}`);
         return false;
     }
     if (typeof source === 'function') {
         // function source values can only be directly matched
         const result = Object.is(source, matcher);
         if (!result) {
-            errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push(`both value and matcher are functions, but they do not have the same reference`);
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`both value and matcher are functions, but they do not have the same reference`);
         }
         return result;
     }
@@ -49,62 +49,87 @@ function matchEntry(source, parent, root, matcher, errorCollector) {
         if (typeof matcherResult === 'boolean') {
             // function resulted in a direct match result
             if (!matcherResult) {
-                errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push(`function matcher returned false for value ${JSON.stringify(source)}`);
+                failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`function matcher returned false for value ${JSON.stringify(source)}`);
             }
             return matcherResult;
         }
         // function resulted in a value that needs to be further matched
-        return matchEntry(source, parent, root, matcherResult, errorCollector);
+        return matchEntry(source, parent, root, matcherResult, failureLog);
     }
     if (isPlainObj(source)) {
         // source ia a plain object, can be partially matched
-        return matchPlainObj(source, parent, root, matcher, errorCollector);
+        return matchPlainObj(source, parent, root, matcher, failureLog);
     }
     if (Array.isArray(source)) {
         // source is an array
-        return matchArr(source, root, matcher, errorCollector);
+        return matchArr(source, parent, root, matcher, failureLog);
     }
     // already determined above that the source and matcher are not equal
-    errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push(`value ${JSON.stringify(source)} does not match given matcher ${JSON.stringify(matcher)}`);
+    failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`value ${JSON.stringify(source)} does not match given matcher ${JSON.stringify(matcher)}`);
     return false;
 }
 /**
  * Match an array matcher against the given source.
  */
-function matchArr(source, root, matcher, errorCollector) {
+function matchArr(source, parent, root, matcher, failureLog) {
     if (Array.isArray(matcher)) {
         // directly compare array contents
         const length = source.length;
         if (length !== matcher.length) {
             // if lengths not equal, arrays are not equal
-            errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push(`array lengths are not equal: value length ${source.length} !== matcher length ${matcher.length}`);
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`array lengths are not equal: value length ${source.length} !== matcher length ${matcher.length}`);
             return false;
         }
         // loop over arrays, matching every value
         let index = -1;
         while (++index < length) {
-            if (!Object.is(source[index], matcher[index])) {
+            if (!matchEntry(source[index], source, root, matcher[index], failureLog)) {
                 // item did not match, return false
-                errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push(`index ${index} does not match with value ${JSON.stringify(source[index])} and matcher ${matcher[index]}`);
+                failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`index ${index} does not match with value ${JSON.stringify(source[index])} and matcher ${matcher[index]}`);
                 return false;
             }
         }
         // all items are equal
         return true;
     }
+    // matcher is plain object
+    if (`every` in matcher) {
+        return matchCompound(source, parent, root, ['every', ...matcher.every], failureLog);
+    }
+    if (`some` in matcher) {
+        return matchCompound(source, parent, root, ['some', ...matcher.some], failureLog);
+    }
+    if (`none` in matcher) {
+        return matchCompound(source, parent, root, ['none', ...matcher.none], failureLog);
+    }
+    if (`single` in matcher) {
+        return matchCompound(source, parent, root, ['single', ...matcher.single], failureLog);
+    }
+    if (`someItem` in matcher) {
+        return matchTraversal(source, root, 'someItem', matcher.someItem, failureLog);
+    }
+    if (`everyItem` in matcher) {
+        return matchTraversal(source, root, 'everyItem', matcher.everyItem, failureLog);
+    }
+    if (`noneItem` in matcher) {
+        return matchTraversal(source, root, 'noneItem', matcher.noneItem, failureLog);
+    }
+    if (`singleItem` in matcher) {
+        return matchTraversal(source, root, 'singleItem', matcher.singleItem, failureLog);
+    }
     // matcher is plain object with index keys
     for (const index in matcher) {
         const matcherAtIndex = matcher[index];
         if (!(index in source)) {
             // source does not have item at given index
-            errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push(`index ${index} does not exist in source ${JSON.stringify(source)} but should match matcher ${JSON.stringify(matcherAtIndex)}`);
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`index ${index} does not exist in source ${JSON.stringify(source)} but should match matcher ${JSON.stringify(matcherAtIndex)}`);
             return false;
         }
         // match the source item at the given index
-        const result = matchEntry(source[index], source, root, matcherAtIndex, errorCollector);
+        const result = matchEntry(source[index], source, root, matcherAtIndex, failureLog);
         if (!result) {
             // item did not match
-            errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push(`index ${index} does not match with value ${JSON.stringify(source[index])} and matcher ${JSON.stringify(matcherAtIndex)}`);
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`index ${index} does not match with value ${JSON.stringify(source[index])} and matcher ${JSON.stringify(matcherAtIndex)}`);
             return false;
         }
     }
@@ -114,22 +139,22 @@ function matchArr(source, root, matcher, errorCollector) {
 /**
  * Match an object matcher against the given source.
  */
-function matchPlainObj(source, parent, root, matcher, errorCollector) {
+function matchPlainObj(source, parent, root, matcher, failureLog) {
     if (Array.isArray(matcher)) {
         // the matcher is of compound type
-        return matchCompound(source, parent, root, matcher, errorCollector);
+        return matchCompound(source, parent, root, matcher, failureLog);
     }
     // partial object props matcher
     for (const key in matcher) {
         if (!(key in source)) {
             // the source does not have the given key
-            errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push(`key ${key} is specified in matcher but not present in value ${JSON.stringify(source)}`);
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`key ${key} is specified in matcher but not present in value ${JSON.stringify(source)}`);
             return false;
         }
         // match the source value at the given key with the matcher at given key
-        const result = matchEntry(source[key], source, root, matcher[key], errorCollector);
+        const result = matchEntry(source[key], source, root, matcher[key], failureLog);
         if (!result) {
-            errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push(`key ${key} does not match in value ${JSON.stringify(source[key])} with matcher ${JSON.stringify(matcher[key])}`);
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`key ${key} does not match in value ${JSON.stringify(source[key])} with matcher ${JSON.stringify(matcher[key])}`);
             return false;
         }
     }
@@ -139,7 +164,7 @@ function matchPlainObj(source, parent, root, matcher, errorCollector) {
 /**
  * Match a compound matcher against the given source.
  */
-function matchCompound(source, parent, root, compound, errorCollector) {
+function matchCompound(source, parent, root, compound, failureLog) {
     // first item indicates compound match type
     const matchType = compound[0];
     const length = compound.length;
@@ -149,9 +174,9 @@ function matchCompound(source, parent, root, compound, errorCollector) {
         case 'every': {
             while (++index < length) {
                 // if any item does not match, return false
-                const result = matchEntry(source, parent, root, compound[index], errorCollector);
+                const result = matchEntry(source, parent, root, compound[index], failureLog);
                 if (!result) {
-                    errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push(`in compound "every": match at index ${index} failed`);
+                    failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`in compound "every": match at index ${index} failed`);
                     return false;
                 }
             }
@@ -160,9 +185,9 @@ function matchCompound(source, parent, root, compound, errorCollector) {
         case 'none': {
             // if any item matches, return false
             while (++index < length) {
-                const result = matchEntry(source, parent, root, compound[index], errorCollector);
+                const result = matchEntry(source, parent, root, compound[index], failureLog);
                 if (result) {
-                    errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push(`in compound "none": match at index ${index} succeeded`);
+                    failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`in compound "none": match at index ${index} succeeded`);
                     return false;
                 }
             }
@@ -172,31 +197,81 @@ function matchCompound(source, parent, root, compound, errorCollector) {
             // if not exactly one item matches, return false
             let onePassed = false;
             while (++index < length) {
-                const result = matchEntry(source, parent, root, compound[index], errorCollector);
+                const result = matchEntry(source, parent, root, compound[index], failureLog);
                 if (result) {
                     if (onePassed) {
-                        errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push(`in compound "single": multiple matches succeeded`);
+                        failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`in compound "single": multiple matches succeeded`);
                         return false;
                     }
                     onePassed = true;
                 }
             }
             if (!onePassed) {
-                errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push(`in compound "single": no matches succeeded`);
+                failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`in compound "single": no matches succeeded`);
             }
             return onePassed;
         }
         case 'some': {
             // if any item matches, return true
             while (++index < length) {
-                const result = matchEntry(source, parent, root, compound[index], errorCollector);
+                const result = matchEntry(source, parent, root, compound[index], failureLog);
                 if (result) {
                     return true;
                 }
             }
-            errorCollector === null || errorCollector === void 0 ? void 0 : errorCollector.push(`in compound "some": no matches succeeded`);
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`in compound "some": no matches succeeded`);
             return false;
         }
     }
 }
+function matchTraversal(source, root, matchType, matcher, failureLog) {
+    let index = -1;
+    const length = source.length;
+    switch (matchType) {
+        case 'someItem': {
+            while (++index < length) {
+                if (matchEntry(source[index], source, root, matcher, failureLog)) {
+                    return true;
+                }
+            }
+            failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`in array traversal "someItem": no items matched given matcher`);
+            return false;
+        }
+        case 'everyItem': {
+            while (++index < length) {
+                if (!matchEntry(source[index], source, root, matcher, failureLog)) {
+                    failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`in array traversal "everyItem": at least one item did not match given matcher`);
+                    return false;
+                }
+            }
+            return true;
+        }
+        case 'noneItem': {
+            while (++index < length) {
+                if (matchEntry(source[index], source, root, matcher, failureLog)) {
+                    failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`in array traversal "noneItem": at least one item matched given matcher`);
+                    return false;
+                }
+            }
+            return true;
+        }
+        case 'singleItem': {
+            let singleMatched = false;
+            while (++index < length) {
+                if (matchEntry(source[index], source, root, matcher, failureLog)) {
+                    if (singleMatched) {
+                        failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`in array traversal "singleItem": more than one item matched given matcher`);
+                        return false;
+                    }
+                    singleMatched = true;
+                }
+            }
+            if (!singleMatched) {
+                failureLog === null || failureLog === void 0 ? void 0 : failureLog.push(`in array traversal "singleItem": no item matched given matcher`);
+                return false;
+            }
+            return true;
+        }
+    }
+}
 //# sourceMappingURL=match.js.map