vest 4.4.0-dev-08ec91 → 4.4.2-dev-afe5de

package/dist/cjs/vest.development.js

@@ -3,44 +3,14 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var n4s = require('n4s');
+var vestUtils = require('vest-utils');
 var context$1 = require('context');
 
-/**
- * @returns a unique numeric id.
- */
-var genId = (function (n) { return function () {
-    return "".concat(n++);
-}; })(0);
-
-function isStringValue(v) {
-    return String(v) === v;
-}
-
-function bindNot(fn) {
-    return function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        return !fn.apply(void 0, args);
-    };
-}
-
-function isUndefined(value) {
-    return value === undefined;
-}
-
 function shouldUseErrorAsMessage(message, error) {
     // kind of cheating with this safe guard, but it does the job
-    return isUndefined(message) && isStringValue(error);
+    return vestUtils.isUndefined(message) && vestUtils.isStringValue(error);
 }
 
-function asArray(possibleArg) {
-    return [].concat(possibleArg);
-}
-
-var assign = Object.assign;
-
 function isNumeric(value) {
     var str = String(value);
     var num = Number(value);
@@ -101,119 +71,6 @@ function createCache(maxSize) {
     }
 }
 
-// The module is named "isArrayValue" since it
-// is conflicting with a nested npm dependency.
-// We may need to revisit this in the future.
-function isArray(value) {
-    return Boolean(Array.isArray(value));
-}
-
-function isNull(value) {
-    return value === null;
-}
-var isNotNull = bindNot(isNull);
-
-function isFunction(value) {
-    return typeof value === 'function';
-}
-
-function optionalFunctionValue(value) {
-    var args = [];
-    for (var _i = 1; _i < arguments.length; _i++) {
-        args[_i - 1] = arguments[_i];
-    }
-    return isFunction(value) ? value.apply(void 0, args) : value;
-}
-
-function defaultTo(callback, defaultValue) {
-    var _a;
-    return (_a = optionalFunctionValue(callback)) !== null && _a !== void 0 ? _a : defaultValue;
-}
-
-function last(values) {
-    var valuesArray = asArray(values);
-    return valuesArray[valuesArray.length - 1];
-}
-
-// This is kind of a map/filter in one function.
-// Normally, behaves like a nested-array map,
-// but returning `null` will drop the element from the array
-function transform(array, cb) {
-    var res = [];
-    for (var _i = 0, array_1 = array; _i < array_1.length; _i++) {
-        var v = array_1[_i];
-        if (isArray(v)) {
-            res.push(transform(v, cb));
-        }
-        else {
-            var output = cb(v);
-            if (isNotNull(output)) {
-                res.push(output);
-            }
-        }
-    }
-    return res;
-}
-function valueAtPath(array, path) {
-    return getCurrent(array, path)[last(path)];
-}
-function setValueAtPath(array, path, value) {
-    var current = getCurrent(array, path);
-    current[last(path)] = value;
-    return array;
-}
-function flatten(values) {
-    return asArray(values).reduce(function (acc, value) {
-        if (isArray(value)) {
-            return acc.concat(flatten(value));
-        }
-        return asArray(acc).concat(value);
-    }, []);
-}
-function getCurrent(array, path) {
-    var current = array;
-    for (var _i = 0, _a = path.slice(0, -1); _i < _a.length; _i++) {
-        var p = _a[_i];
-        current[p] = defaultTo(current[p], []);
-        current = current[p];
-    }
-    return current;
-}
-
-function createCursor() {
-    var storage = {
-        cursor: []
-    };
-    function addLevel() {
-        storage.cursor.push(0);
-    }
-    function removeLevel() {
-        storage.cursor.pop();
-    }
-    function cursorAt() {
-        return last(storage.cursor);
-    }
-    function getCursor() {
-        return asArray(storage.cursor);
-    }
-    function next() {
-        storage.cursor[storage.cursor.length - 1]++;
-        return last(storage.cursor);
-    }
-    function reset() {
-        storage.cursor = [0];
-    }
-    reset();
-    return {
-        addLevel: addLevel,
-        cursorAt: cursorAt,
-        getCursor: getCursor,
-        next: next,
-        removeLevel: removeLevel,
-        reset: reset
-    };
-}
-
 var IsolateTypes;
 (function (IsolateTypes) {
     IsolateTypes[IsolateTypes["DEFAULT"] = 0] = "DEFAULT";
@@ -230,24 +87,52 @@ var Modes;
     Modes[Modes["EAGER"] = 1] = "EAGER";
 })(Modes || (Modes = {}));
 
+function createIsolateCursor() {
+    var cursor = {
+        value: 0
+    };
+    return {
+        current: current,
+        next: next
+    };
+    /**
+     * @returns {number} The current value of the cursor
+     */
+    function current() {
+        return cursor.value;
+    }
+    /**
+     * Moves the isolate cursor forward by 1
+     */
+    function next() {
+        cursor.value++;
+    }
+}
+
+function generateIsolate(type, path) {
+    if (path === void 0) { path = []; }
+    return {
+        cursor: createIsolateCursor(),
+        keys: {
+            current: {},
+            prev: {}
+        },
+        path: path,
+        type: type
+    };
+}
+
 var context = context$1.createContext(function (ctxRef, parentContext) {
     return parentContext
         ? null
-        : assign({}, {
+        : vestUtils.assign({}, {
             exclusion: {
                 tests: {},
                 groups: {}
             },
             inclusion: {},
-            isolate: {
-                type: IsolateTypes.DEFAULT,
-                keys: {
-                    current: {},
-                    prev: {}
-                }
-            },
-            mode: [Modes.ALL],
-            testCursor: createCursor()
+            isolate: generateIsolate(IsolateTypes.DEFAULT),
+            mode: [Modes.ALL]
         }, ctxRef);
 });
 
@@ -278,8 +163,8 @@ function useSetOptionalField(fieldName, setter) {
     var _a = useOptionalFields(), setOptionalFields = _a[1];
     setOptionalFields(function (optionalFields) {
         var _a;
-        return assign(optionalFields, (_a = {},
-            _a[fieldName] = optionalFunctionValue(setter, optionalFields[fieldName]),
+        return vestUtils.assign(optionalFields, (_a = {},
+            _a[fieldName] = vestUtils.optionalFunctionValue(setter, optionalFields[fieldName]),
             _a));
     });
 }
@@ -304,7 +189,7 @@ function useSetTests(handler) {
         var current = _a.current, prev = _a.prev;
         return ({
             prev: prev,
-            current: asArray(handler(current))
+            current: vestUtils.asArray(handler(current))
         });
     });
 }
@@ -315,7 +200,7 @@ function useAllIncomplete() {
 var flatCache = createCache();
 function useTestsFlat() {
     var current = useTestObjects()[0].current;
-    return flatCache([current], function () { return flatten(current); });
+    return flatCache([current], function () { return vestUtils.nestedArray.flatten(current); });
 }
 function useEachTestObject(handler) {
     var testObjects = useTestsFlat();
@@ -331,7 +216,7 @@ var VestTest = /** @class */ (function () {
     function VestTest(fieldName, testFn, _a) {
         var _b = _a === void 0 ? {} : _a, message = _b.message, groupName = _b.groupName, key = _b.key;
         this.key = null;
-        this.id = genId();
+        this.id = vestUtils.genId();
         this.severity = TestSeverity.Error;
         this.status = STATUS_UNTESTED;
         this.fieldName = fieldName;
@@ -466,20 +351,6 @@ var STATUS_PENDING = 'PENDING';
 var STATUS_CANCELED = 'CANCELED';
 var STATUS_OMITTED = 'OMITTED';
 
-function invariant(condition, 
-// eslint-disable-next-line @typescript-eslint/ban-types
-message) {
-    if (condition) {
-        return;
-    }
-    // If message is a string object (rather than string literal)
-    // Throw the value directly as a string
-    // Alternatively, throw an error with the message
-    throw message instanceof String
-        ? message.valueOf()
-        : new Error(message ? optionalFunctionValue(message) : message);
-}
-
 // eslint-disable-next-line max-lines-per-function
 function createState(onStateChange) {
     var state = {
@@ -518,12 +389,12 @@ function createState(onStateChange) {
     }
     function initKey(key, initialState, prevState) {
         current().push();
-        set(key, optionalFunctionValue(initialState, prevState));
+        set(key, vestUtils.optionalFunctionValue(initialState, prevState));
         return function useStateKey() {
             return [
                 current()[key],
                 function (nextState) {
-                    return set(key, optionalFunctionValue(nextState, current()[key]));
+                    return set(key, vestUtils.optionalFunctionValue(nextState, current()[key]));
                 },
             ];
         };
@@ -535,10 +406,10 @@ function createState(onStateChange) {
         var prevValue = state.references[index];
         state.references[index] = value;
         var _a = registrations[index], onUpdate = _a[1];
-        if (isFunction(onUpdate)) {
+        if (vestUtils.isFunction(onUpdate)) {
             onUpdate(value, prevValue);
         }
-        if (isFunction(onStateChange)) {
+        if (vestUtils.isFunction(onStateChange)) {
             onStateChange();
         }
     }
@@ -563,44 +434,13 @@ function createStateRef(state, _a) {
     };
 }
 
-function isNullish(value) {
-    return isNull(value) || isUndefined(value);
-}
-
-function deferThrow(message) {
-    setTimeout(function () {
-        throw new Error(message);
-    }, 0);
-}
-
-function usePath() {
-    var context$1 = context.useX();
-    return context$1.testCursor.getCursor();
-}
-function useCursorAt() {
-    var context$1 = context.useX();
-    return context$1.testCursor.cursorAt();
-}
-function moveForward() {
-    var context$1 = context.useX();
-    return context$1.testCursor.next();
-}
-function addLevel() {
-    var context$1 = context.useX();
-    context$1.testCursor.addLevel();
-}
-function removeLevel() {
-    var context$1 = context.useX();
-    context$1.testCursor.removeLevel();
-}
-
 function usePrevKeys() {
     var prev = useTestObjects()[0].prev;
-    return asArray(getCurrent(prev, usePath())).reduce(function (prevKeys, testObject) {
+    return vestUtils.asArray(vestUtils.nestedArray.getCurrent(prev, useCurrentPath())).reduce(function (prevKeys, testObject) {
         if (!(testObject instanceof VestTest)) {
             return prevKeys;
         }
-        if (isNullish(testObject.key)) {
+        if (vestUtils.isNullish(testObject.key)) {
             return prevKeys;
         }
         prevKeys[testObject.key] = testObject;
@@ -608,40 +448,58 @@ function usePrevKeys() {
     }, {});
 }
 function usePrevTestByKey(key) {
-    var prev = context.useX().isolate.keys.prev;
+    var prev = useIsolate().keys.prev;
     return prev[key];
 }
 function useRetainTestKey(key, testObject) {
-    var context$1 = context.useX();
-    var current = context$1.isolate.keys.current;
-    if (isNullish(current[key])) {
+    var current = useIsolate().keys.current;
+    if (vestUtils.isNullish(current[key])) {
         current[key] = testObject;
     }
     else {
-        deferThrow("Encountered the same test key \"".concat(key, "\" twice. This may lead to tests overriding each other's results, or to tests being unexpectedly omitted."));
+        vestUtils.deferThrow("Encountered the same test key \"".concat(key, "\" twice. This may lead to tests overriding each other's results, or to tests being unexpectedly omitted."));
     }
 }
 
 function isolate(_a, callback) {
     var _b = _a.type, type = _b === void 0 ? IsolateTypes.DEFAULT : _b;
-    invariant(isFunction(callback));
-    var keys = {
-        current: {},
-        prev: {}
-    };
-    var path = usePath();
-    return context.run({ isolate: { type: type, keys: keys } }, function () {
-        addLevel();
-        keys.prev = usePrevKeys();
-        useSetTests(function (tests) { return setValueAtPath(tests, path, []); });
+    vestUtils.invariant(vestUtils.isFunction(callback));
+    // Generate a new Isolate layer, with its own cursor
+    var isolate = generateIsolate(type, useCurrentPath());
+    var output = context.run({ isolate: isolate }, function () {
+        isolate.keys.prev = usePrevKeys();
+        useSetTests(function (tests) { return vestUtils.nestedArray.setValueAtPath(tests, isolate.path, []); });
         var res = callback();
-        removeLevel();
-        moveForward();
         return res;
     });
+    // Move the parent cursor forward once we're done
+    useCursor().next();
+    return output;
+}
+/**
+ * @returns {Isolate} The current isolate layer
+ */
+function useIsolate() {
+    return context.useX().isolate;
 }
+/**
+ * @returns {boolean} Whether or not the current isolate allows tests to be reordered
+ */
 function shouldAllowReorder() {
-    return context.useX().isolate.type === IsolateTypes.EACH;
+    return useIsolate().type === IsolateTypes.EACH;
+}
+/**
+ * @returns {number[]} The current cursor path of the isolate tree
+ */
+function useCurrentPath() {
+    var isolate = useIsolate();
+    return isolate.path.concat(isolate.cursor.current());
+}
+/**
+ * @returns {IsolateCursor} The cursor object for the current isolate
+ */
+function useCursor() {
+    return useIsolate().cursor;
 }
 
 var Severity;
@@ -660,34 +518,6 @@ function countKeyBySeverity(severity) {
         : SeverityCount.WARN_COUNT;
 }
 
-/**
- * A safe hasOwnProperty access
- */
-function hasOwnProperty(obj, key) {
-    return Object.prototype.hasOwnProperty.call(obj, key);
-}
-
-function isNumber(value) {
-    return Boolean(typeof value === 'number');
-}
-
-function isEmpty(value) {
-    if (!value) {
-        return true;
-    }
-    else if (isNumber(value)) {
-        return value === 0;
-    }
-    else if (hasOwnProperty(value, 'length')) {
-        return lengthEquals(value, 0);
-    }
-    else if (typeof value === 'object') {
-        return lengthEquals(Object.keys(value), 0);
-    }
-    return false;
-}
-var isNotEmpty = bindNot(isEmpty);
-
 function nonMatchingFieldName(testObject, fieldName) {
     return !!fieldName && !matchingFieldName(testObject, fieldName);
 }
@@ -695,20 +525,16 @@ function matchingFieldName(testObject, fieldName) {
     return !!(fieldName && testObject.fieldName === fieldName);
 }
 
-var nonMatchingGroupName = bindNot(matchingGroupName);
+var nonMatchingGroupName = vestUtils.bindNot(matchingGroupName);
 function matchingGroupName(testObject, groupName) {
     return testObject.groupName === groupName;
 }
 
-function either(a, b) {
-    return !!a !== !!b;
-}
-
 /**
  * Checks that a given test object matches the currently specified severity level
  */
 function nonMatchingSeverityProfile(severity, testObject) {
-    return either(severity === Severity.WARNINGS, testObject.warns());
+    return vestUtils.either(severity === Severity.WARNINGS, testObject.warns());
 }
 
 /**
@@ -758,7 +584,7 @@ function shouldAddValidProperty(fieldName) {
         return false;
     }
     var testObjects = useTestsFlat();
-    if (isEmpty(testObjects)) {
+    if (vestUtils.isEmpty(testObjects)) {
         return false;
     }
     // Does the given field have any pending tests that are not optional?
@@ -788,13 +614,13 @@ function fieldIsOmitted(fieldName) {
 }
 // Does the given field have any pending tests that are not optional?
 function hasNonOptionalIncomplete(fieldName) {
-    return isNotEmpty(useAllIncomplete().filter(function (testObject) {
+    return vestUtils.isNotEmpty(useAllIncomplete().filter(function (testObject) {
         return isOptionalFieldIncomplete(testObject, fieldName);
     }));
 }
 // Do the given group/field have any pending tests that are not optional?
 function hasNonOptionalIncompleteByGroup(groupName, fieldName) {
-    return isNotEmpty(useAllIncomplete().filter(function (testObject) {
+    return vestUtils.isNotEmpty(useAllIncomplete().filter(function (testObject) {
         if (nonMatchingGroupName(testObject, groupName)) {
             return false;
         }
@@ -836,7 +662,7 @@ function missingTestsLogic(testObject, fieldName) {
 
 function useSummary() {
     var summary = context.useX().summary;
-    invariant(summary);
+    vestUtils.invariant(summary);
     return summary;
 }
 /**
@@ -844,7 +670,7 @@ function useSummary() {
  */
 function genTestsSummary() {
     var testObjects = useTestsFlat();
-    var summary = assign(baseStats(), {
+    var summary = vestUtils.assign(baseStats(), {
         groups: {},
         tests: {},
         valid: false
@@ -921,16 +747,12 @@ function baseStats() {
     };
 }
 function baseTestStats() {
-    return assign(baseStats(), {
+    return vestUtils.assign(baseStats(), {
         errors: [],
         warnings: []
     });
 }
 
-function isPositive(value) {
-    return greaterThan(value, 0);
-}
-
 // calls collectAll or getByFieldName depending on whether fieldName is provided
 function gatherFailures(testGroup, severityKey, fieldName) {
     return fieldName
@@ -945,7 +767,7 @@ function collectAll(testGroup, severityKey) {
     var output = {};
     var countKey = countKeyBySeverity(severityKey);
     for (var field in testGroup) {
-        if (isPositive(testGroup[field][countKey])) {
+        if (vestUtils.isPositive(testGroup[field][countKey])) {
             // We will probably never get to the fallback array
             // leaving it just in case the implementation changes
             output[field] = testGroup[field][severityKey] || [];
@@ -989,9 +811,9 @@ function hasFailures(severityCount, fieldName) {
     var _a;
     var summary = useSummary();
     if (fieldName) {
-        return isPositive((_a = summary.tests[fieldName]) === null || _a === void 0 ? void 0 : _a[severityCount]);
+        return vestUtils.isPositive((_a = summary.tests[fieldName]) === null || _a === void 0 ? void 0 : _a[severityCount]);
     }
-    return isPositive(summary[severityCount]);
+    return vestUtils.isPositive(summary[severityCount]);
 }
 
 function hasErrorsByGroup(groupName, fieldName) {
@@ -1010,10 +832,10 @@ function hasFailuresByGroup(severityKey, groupName, fieldName) {
         return false;
     }
     if (fieldName) {
-        return isPositive((_a = group[fieldName]) === null || _a === void 0 ? void 0 : _a[severityCount]);
+        return vestUtils.isPositive((_a = group[fieldName]) === null || _a === void 0 ? void 0 : _a[severityCount]);
     }
     for (var field in group) {
-        if (isPositive((_b = group[field]) === null || _b === void 0 ? void 0 : _b[severityCount])) {
+        if (vestUtils.isPositive((_b = group[field]) === null || _b === void 0 ? void 0 : _b[severityCount])) {
             return true;
         }
     }
@@ -1055,7 +877,7 @@ function produceSuiteResult() {
         var summary = genTestsSummary();
         var suiteName = useSuiteName();
         var ref = { summary: summary };
-        return assign(summary, {
+        return vestUtils.assign(summary, {
             getErrors: context.bind(ref, getErrors),
             getErrorsByGroup: context.bind(ref, getErrorsByGroup),
             getWarnings: context.bind(ref, getWarnings),
@@ -1076,7 +898,7 @@ function produceSuiteResult() {
  */
 function hasRemainingTests(fieldName) {
     var allIncomplete = useAllIncomplete();
-    if (isEmpty(allIncomplete)) {
+    if (vestUtils.isEmpty(allIncomplete)) {
         return false;
     }
     if (fieldName) {
@@ -1084,7 +906,7 @@ function hasRemainingTests(fieldName) {
             return matchingFieldName(testObject, fieldName);
         });
     }
-    return isNotEmpty(allIncomplete);
+    return vestUtils.isNotEmpty(allIncomplete);
 }
 
 var cache = createCache(20);
@@ -1092,7 +914,7 @@ function produceFullResult() {
     var testObjects = useTestsFlat();
     var ctxRef = { stateRef: useStateRef() };
     return cache([testObjects], context.bind(ctxRef, function () {
-        return assign({}, produceSuiteResult(), {
+        return vestUtils.assign({}, produceSuiteResult(), {
             done: context.bind(ctxRef, done)
         });
     }));
@@ -1102,9 +924,9 @@ function produceFullResult() {
  */
 function shouldSkipDoneRegistration(callback, fieldName, output) {
     // If we do not have any test runs for the current field
-    return !!(!isFunction(callback) ||
+    return !!(!vestUtils.isFunction(callback) ||
         (fieldName &&
-            (!output.tests[fieldName] || isEmpty(output.tests[fieldName].testCount))));
+            (!output.tests[fieldName] || vestUtils.isEmpty(output.tests[fieldName].testCount))));
 }
 function shouldRunDoneCallback(fieldName) {
     // is suite finished || field name exists, and test is finished;
@@ -1146,38 +968,16 @@ function deferDoneCallback(doneCallback, fieldName) {
     });
 }
 
-function createBus() {
-    var listeners = {};
-    return {
-        emit: function (event, data) {
-            listener(event).forEach(function (handler) {
-                handler(data);
-            });
-        },
-        on: function (event, handler) {
-            listeners[event] = listener(event).concat(handler);
-            return {
-                off: function () {
-                    listeners[event] = listener(event).filter(function (h) { return h !== handler; });
-                }
-            };
-        }
-    };
-    function listener(event) {
-        return listeners[event] || [];
-    }
-}
-
 function omitOptionalFields() {
     var optionalFields = useOptionalFields()[0];
-    if (isEmpty(optionalFields)) {
+    if (vestUtils.isEmpty(optionalFields)) {
         return;
     }
     var shouldOmit = {};
     useSetTests(function (tests) {
-        return transform(tests, function (testObject) {
+        return vestUtils.nestedArray.transform(tests, function (testObject) {
             var fieldName = testObject.fieldName;
-            if (hasOwnProperty(shouldOmit, fieldName)) {
+            if (vestUtils.hasOwnProperty(shouldOmit, fieldName)) {
                 verifyAndOmit(testObject);
             }
             else {
@@ -1194,7 +994,7 @@ function omitOptionalFields() {
     }
     function runOptionalConfig(testObject) {
         var optionalConfig = useOptionalFieldConfig(testObject.fieldName);
-        if (isFunction(optionalConfig)) {
+        if (vestUtils.isFunction(optionalConfig)) {
             shouldOmit[testObject.fieldName] = optionalConfig();
             verifyAndOmit(testObject);
         }
@@ -1206,14 +1006,10 @@ function omitOptionalFields() {
  */
 function removeTestFromState (testObject) {
     useSetTests(function (tests) {
-        return transform(tests, function (test) { return (testObject !== test ? test : null); });
+        return vestUtils.nestedArray.transform(tests, function (test) { return (testObject !== test ? test : null); });
     });
 }
 
-function callEach(arr) {
-    return arr.forEach(function (fn) { return fn(); });
-}
-
 /**
  * Runs done callback per field when async tests are finished running.
  */
@@ -1221,8 +1017,8 @@ function runFieldCallbacks(fieldName) {
     var fieldCallbacks = useTestCallbacks()[0].fieldCallbacks;
     if (fieldName &&
         !hasRemainingTests(fieldName) &&
-        isArray(fieldCallbacks[fieldName])) {
-        callEach(fieldCallbacks[fieldName]);
+        vestUtils.isArray(fieldCallbacks[fieldName])) {
+        vestUtils.callEach(fieldCallbacks[fieldName]);
     }
 }
 /**
@@ -1230,15 +1026,15 @@ function runFieldCallbacks(fieldName) {
  */
 function runDoneCallbacks() {
     var doneCallbacks = useTestCallbacks()[0].doneCallbacks;
-    callEach(doneCallbacks);
+    vestUtils.callEach(doneCallbacks);
 }
 
 // eslint-disable-next-line max-lines-per-function
 function initBus() {
-    var bus = createBus();
+    var vestBus = vestUtils.bus.createBus();
     // Report a the completion of a test. There may be other tests with the same
     // name that are still running, or not yet started.
-    bus.on(Events.TEST_COMPLETED, function (testObject) {
+    vestBus.on(Events.TEST_COMPLETED, function (testObject) {
         if (testObject.isCanceled()) {
             return;
         }
@@ -1246,21 +1042,21 @@ function initBus() {
         runFieldCallbacks(testObject.fieldName);
         if (!hasRemainingTests()) {
             // When no more tests are running, emit the done event
-            bus.emit(Events.ALL_RUNNING_TESTS_FINISHED);
+            vestBus.emit(Events.ALL_RUNNING_TESTS_FINISHED);
         }
     });
     // Report that the suite completed its synchronous test run.
     // Async operations may still be running.
-    bus.on(Events.SUITE_CALLBACK_DONE_RUNNING, function () {
+    vestBus.on(Events.SUITE_CALLBACK_DONE_RUNNING, function () {
         // Remove tests that are optional and need to be omitted
         omitOptionalFields();
     });
     // Called when all the tests, including async, are done running
-    bus.on(Events.ALL_RUNNING_TESTS_FINISHED, function () {
+    vestBus.on(Events.ALL_RUNNING_TESTS_FINISHED, function () {
         runDoneCallbacks();
     });
     // Removes a certain field from the state.
-    bus.on(Events.REMOVE_FIELD, function (fieldName) {
+    vestBus.on(Events.REMOVE_FIELD, function (fieldName) {
         useEachTestObject(function (testObject) {
             if (matchingFieldName(testObject, fieldName)) {
                 testObject.cancel();
@@ -1269,18 +1065,18 @@ function initBus() {
         });
     });
     // Resets a certain field in the state.
-    bus.on(Events.RESET_FIELD, function (fieldName) {
+    vestBus.on(Events.RESET_FIELD, function (fieldName) {
         useEachTestObject(function (testObject) {
             if (matchingFieldName(testObject, fieldName)) {
                 testObject.reset();
             }
         });
     });
-    return bus;
+    return vestBus;
 }
 function useBus() {
     var context$1 = context.useX();
-    invariant(context$1.bus);
+    vestUtils.invariant(context$1.bus);
     return context$1.bus;
 }
 var Events;
@@ -1299,16 +1095,16 @@ function create() {
         args[_i] = arguments[_i];
     }
     var _a = args.reverse(), suiteCallback = _a[0], suiteName = _a[1];
-    invariant(isFunction(suiteCallback), 'vest.create: Expected callback to be a function.');
+    vestUtils.invariant(vestUtils.isFunction(suiteCallback), 'vest.create: Expected callback to be a function.');
     // Event bus initialization
     var bus = initBus();
     // State initialization
     var state = createState();
     // State reference - this holds the actual state values
-    var stateRef = createStateRef(state, { suiteId: genId(), suiteName: suiteName });
+    var stateRef = createStateRef(state, { suiteId: vestUtils.genId(), suiteName: suiteName });
     // Create base context reference. All hooks will derive their data from this
     var ctxRef = { stateRef: stateRef, bus: bus };
-    var suite = assign(
+    var suite = vestUtils.assign(
     // Bind the suite body to the context
     context.bind(ctxRef, function () {
         var args = [];
@@ -1354,7 +1150,7 @@ function create() {
  * })
  */
 function each(list, callback) {
-    invariant(isFunction(callback), 'each callback must be a function');
+    vestUtils.invariant(vestUtils.isFunction(callback), 'each callback must be a function');
     isolate({ type: IsolateTypes.EACH }, function () {
         list.forEach(function (arg, index) {
             callback(arg, index);
@@ -1384,7 +1180,7 @@ function skipWhen(conditional, callback) {
             // we should skip the test if the parent conditional is true.
             isExcludedIndividually() ||
                 // Otherwise, we should skip the test if the conditional is true.
-                optionalFunctionValue(conditional, optionalFunctionValue(produceSuiteResult))
+                vestUtils.optionalFunctionValue(conditional, vestUtils.optionalFunctionValue(produceSuiteResult))
         }, function () { return callback(); });
     });
 }
@@ -1460,7 +1256,7 @@ function isExcluded(testObject) {
         // Check if inclusion rules for this field (`include` hook)
         // TODO: Check if this may need to be moved outside of the condition.
         // What if there are no included tests? This shouldn't run then?
-        return !optionalFunctionValue(inclusion[fieldName]);
+        return !vestUtils.optionalFunctionValue(inclusion[fieldName]);
     }
     // We're done here. This field is not excluded
     return false;
@@ -1472,7 +1268,7 @@ function isGroupExcluded(groupName) {
     var context$1 = context.useX();
     var exclusion = context$1.exclusion;
     var keyGroups = exclusion.groups;
-    var groupPresent = hasOwnProperty(keyGroups, groupName);
+    var groupPresent = vestUtils.hasOwnProperty(keyGroups, groupName);
     // When group is either only'ed or skipped
     if (groupPresent) {
         // Return true if group is skipped and false if only'ed
@@ -1490,8 +1286,8 @@ function addTo(exclusionGroup, itemType, item) {
     if (!item) {
         return;
     }
-    asArray(item).forEach(function (itemName) {
-        if (!isStringValue(itemName)) {
+    vestUtils.asArray(item).forEach(function (itemName) {
+        if (!vestUtils.isStringValue(itemName)) {
             return;
         }
         context$1.exclusion[itemType][itemName] =
@@ -1538,8 +1334,8 @@ function hasIncludedGroups() {
  * });
  */
 function group(groupName, tests) {
-    invariant(isStringValue(groupName), groupErrorMsg('name must be a string'));
-    invariant(isFunction(tests), groupErrorMsg('callback must be a function'));
+    vestUtils.invariant(vestUtils.isStringValue(groupName), groupErrorMsg('name must be a string'));
+    vestUtils.invariant(vestUtils.isFunction(tests), groupErrorMsg('callback must be a function'));
     // Running with the context applied
     isolate({ type: IsolateTypes.GROUP }, function () {
         context.run({ groupName: groupName }, tests);
@@ -1552,24 +1348,24 @@ function groupErrorMsg(error) {
 function include(fieldName) {
     var context$1 = context.useX();
     var inclusion = context$1.inclusion, exclusion = context$1.exclusion;
-    invariant(isStringValue(fieldName));
-    inclusion[fieldName] = defaultTo(exclusion.tests[fieldName], true);
+    vestUtils.invariant(vestUtils.isStringValue(fieldName));
+    inclusion[fieldName] = vestUtils.defaultTo(exclusion.tests[fieldName], true);
     return { when: when };
     function when(condition) {
         var context$1 = context.useX();
         var inclusion = context$1.inclusion, exclusion = context$1.exclusion;
         // This callback will run as part of the "isExcluded" series of checks
         inclusion[fieldName] = function () {
-            if (hasOwnProperty(exclusion.tests, fieldName)) {
+            if (vestUtils.hasOwnProperty(exclusion.tests, fieldName)) {
                 // I suspect this code is technically unreachable because
                 // if there are any skip/only rules applied to the current
                 // field, the "isExcluded" function will have already bailed
-                return defaultTo(exclusion.tests[fieldName], true);
+                return vestUtils.defaultTo(exclusion.tests[fieldName], true);
             }
-            if (isStringValue(condition)) {
+            if (vestUtils.isStringValue(condition)) {
                 return Boolean(exclusion.tests[condition]);
             }
-            return optionalFunctionValue(condition, optionalFunctionValue(produceSuiteResult));
+            return vestUtils.optionalFunctionValue(condition, vestUtils.optionalFunctionValue(produceSuiteResult));
         };
     }
 }
@@ -1597,9 +1393,7 @@ function eager() {
     setMode(Modes.EAGER);
 }
 function shouldSkipBasedOnMode(testObject) {
-    if (isEager() && hasErrorsByTestObjects(testObject.fieldName))
-        return true;
-    return false;
+    return isEager() && hasErrorsByTestObjects(testObject.fieldName);
 }
 function isEager() {
     return isMode(Modes.EAGER);
@@ -1626,7 +1420,7 @@ function omitWhen(conditional, callback) {
     isolate({ type: IsolateTypes.OMIT_WHEN }, function () {
         context.run({
             omitted: isOmitted() ||
-                optionalFunctionValue(conditional, optionalFunctionValue(produceSuiteResult))
+                vestUtils.optionalFunctionValue(conditional, vestUtils.optionalFunctionValue(produceSuiteResult))
         }, function () { return callback(); });
     });
 }
@@ -1648,8 +1442,8 @@ function isOmitted() {
 function optional(optionals) {
     // When the optional is given as a string or a list of strings
     // we just add them to the list of optional fields.
-    if (isArray(optionals) || isStringValue(optionals)) {
-        asArray(optionals).forEach(function (optionalField) {
+    if (vestUtils.isArray(optionals) || vestUtils.isStringValue(optionals)) {
+        vestUtils.asArray(optionals).forEach(function (optionalField) {
             useSetOptionalField(optionalField, [true, false]);
         });
     }
@@ -1663,7 +1457,7 @@ function optional(optionals) {
     }
 }
 
-/*! *****************************************************************************
+/******************************************************************************
 Copyright (c) Microsoft Corporation.
 
 Permission to use, copy, modify, and/or distribute this software for any
@@ -1688,9 +1482,7 @@ function __spreadArray(to, from, pack) {
     return to.concat(ar || Array.prototype.slice.call(from));
 }
 
-function isPromise(value) {
-    return value && isFunction(value.then);
-}
+vestUtils.bindNot(vestUtils.isStringValue);
 
 function isSameProfileTest(testObject1, testObject2) {
     return (testObject1.fieldName === testObject2.fieldName &&
@@ -1710,7 +1502,7 @@ function cancelOverriddenPendingTest(prevRunTestObject, currentRunTestObject) {
  */
 function runAsyncTest(testObject) {
     var asyncTest = testObject.asyncTest, message = testObject.message;
-    if (!isPromise(asyncTest))
+    if (!vestUtils.isPromise(asyncTest))
         return;
     var emit = useBus().emit;
     var stateRef = useStateRef();
@@ -1723,7 +1515,7 @@ function runAsyncTest(testObject) {
         if (testObject.isCanceled()) {
             return;
         }
-        testObject.message = isStringValue(rejectionMessage)
+        testObject.message = vestUtils.isStringValue(rejectionMessage)
             ? rejectionMessage
             : message;
         testObject.fail();
@@ -1758,7 +1550,7 @@ function registerTest(testObject) {
     try {
         // try catch for safe property access
         // in case object is an enforce chain
-        if (isPromise(result)) {
+        if (vestUtils.isPromise(result)) {
             testObject.asyncTest = result;
             testObject.setPending();
             runAsyncTest(testObject);
@@ -1785,12 +1577,12 @@ function registerTest(testObject) {
 function useTestAtCursor(newTestObject) {
     var testObjects = useTestObjects()[0];
     var prevTests = testObjects.prev;
-    if (isEmpty(prevTests)) {
+    if (vestUtils.isEmpty(prevTests)) {
         useSetTestAtCursor(newTestObject);
         return newTestObject;
     }
     var prevTest = useGetTestAtCursor(prevTests);
-    if (!isNullish(newTestObject.key)) {
+    if (!vestUtils.isNullish(newTestObject.key)) {
         var nextTest_1 = handleKeyTest(newTestObject.key, newTestObject);
         useSetTestAtCursor(nextTest_1);
         return nextTest_1;
@@ -1801,45 +1593,38 @@ function useTestAtCursor(newTestObject) {
         // Need to see if this has any effect at all.
         prevTest = null;
     }
-    var nextTest = defaultTo(prevTest, newTestObject);
+    var nextTest = vestUtils.defaultTo(prevTest, newTestObject);
     useSetTestAtCursor(nextTest);
     return nextTest;
 }
 function removeAllNextTestsInIsolate() {
-    var _a = useTestObjects(), testObjects = _a[0], setTestObjects = _a[1];
-    var prevTests = testObjects.prev;
-    var current = getCurrent(prevTests, usePath());
-    var cursorAt = useCursorAt();
-    current.splice(cursorAt);
+    var cursorAt = useCursor().current();
     // We actually don't mind mutating the state directly (as can be seen above). There is no harm in it
     // since we're only touching the "prev" state. The reason we still use the setter function is
     // to prevent future headaches if we ever do need to rely on prev-state immutability.
-    setTestObjects(function (_a) {
-        var current = _a.current;
-        return ({
-            prev: prevTests,
-            current: current
-        });
+    useSetTests(function (current) {
+        current.splice(cursorAt);
+        return current;
     });
 }
 function useSetTestAtCursor(testObject) {
-    var cursorPath = usePath();
+    var cursorPath = useCurrentPath();
     useSetTests(function (tests) {
-        return setValueAtPath(tests, cursorPath, testObject);
+        return vestUtils.nestedArray.setValueAtPath(tests, cursorPath, testObject);
     });
 }
 function useGetTestAtCursor(tests) {
-    var cursorPath = usePath();
-    return valueAtPath(tests, cursorPath);
+    var cursorPath = useCurrentPath();
+    return vestUtils.nestedArray.valueAtPath(tests, cursorPath);
 }
 function testReorderDetected(prevTest, newTest) {
-    return isNotEmpty(prevTest) && !isSameProfileTest(prevTest, newTest);
+    return vestUtils.isNotEmpty(prevTest) && !isSameProfileTest(prevTest, newTest);
 }
 function throwTestOrderError(prevTest, newTestObject) {
     if (shouldAllowReorder()) {
         return;
     }
-    deferThrow("Vest Critical Error: Tests called in different order than previous run.\n    expected: ".concat(prevTest.fieldName, "\n    received: ").concat(newTestObject.fieldName, "\n    This can happen on one of two reasons:\n    1. You're using if/else statements to conditionally select tests. Instead, use \"skipWhen\".\n    2. You are iterating over a list of tests, and their order changed. Use \"each\" and a custom key prop so that Vest retains their state."));
+    vestUtils.deferThrow("Vest Critical Error: Tests called in different order than previous run.\n    expected: ".concat(prevTest.fieldName, "\n    received: ").concat(newTestObject.fieldName, "\n    This can happen on one of two reasons:\n    1. You're using if/else statements to conditionally select tests. Instead, use \"skipWhen\".\n    2. You are iterating over a list of tests, and their order changed. Use \"each\" and a custom key prop so that Vest retains their state."));
 }
 function handleKeyTest(key, newTestObject) {
     var prevTestByKey = usePrevTestByKey(key);
@@ -1853,16 +1638,17 @@ function handleKeyTest(key, newTestObject) {
 
 // eslint-disable-next-line max-statements
 function registerPrevRunTest(testObject) {
+    var cursor = useCursor();
     if (shouldSkipBasedOnMode(testObject)) {
         testObject.skip();
         useTestAtCursor(testObject);
-        moveForward();
+        cursor.next();
         return testObject;
     }
     var prevRunTest = useTestAtCursor(testObject);
     if (isOmitted()) {
         prevRunTest.omit();
-        moveForward();
+        cursor.next();
         return prevRunTest;
     }
     if (isExcluded(testObject)) {
@@ -1871,20 +1657,20 @@ function registerPrevRunTest(testObject) {
         // This mostly means that we're probably giving
         // up on this async test intentionally.
         prevRunTest.skip(isExcludedIndividually());
-        moveForward();
+        cursor.next();
         return prevRunTest;
     }
     cancelOverriddenPendingTest(prevRunTest, testObject);
     useSetTestAtCursor(testObject);
-    moveForward();
     registerTestObjectByTier(testObject);
+    cursor.next();
     return testObject;
 }
 function registerTestObjectByTier(testObject) {
     if (testObject.isUntested()) {
         registerTest(testObject);
     }
-    else if (isPromise(testObject.asyncTest)) {
+    else if (vestUtils.isPromise(testObject.asyncTest)) {
         testObject.setPending();
         runAsyncTest(testObject);
     }
@@ -1900,12 +1686,12 @@ function bindTestMemo(test) {
         for (var _i = 1; _i < arguments.length; _i++) {
             args[_i - 1] = arguments[_i];
         }
-        var cursorAt = useCursorAt();
+        var cursorAt = useCursor().current();
         var _a = args.reverse(), deps = _a[0], testFn = _a[1], msg = _a[2];
         // Implicit dependency for more specificity
         var dependencies = [useSuiteId(), fieldName, cursorAt].concat(deps);
         var cached = cache.get(dependencies);
-        if (isNull(cached)) {
+        if (vestUtils.isNull(cached)) {
             // cache miss
             return cache(dependencies, function () { return test(fieldName, msg, testFn); });
         }
@@ -1924,9 +1710,9 @@ function testBase(fieldName) {
     for (var _i = 1; _i < arguments.length; _i++) {
         args[_i - 1] = arguments[_i];
     }
-    var _a = (isFunction(args[1]) ? args : __spreadArray([undefined], args, true)), message = _a[0], testFn = _a[1], key = _a[2];
-    invariant(isStringValue(fieldName), incompatibleParamsError('fieldName', 'string'));
-    invariant(isFunction(testFn), incompatibleParamsError('Test callback', 'function'));
+    var _a = (vestUtils.isFunction(args[1]) ? args : __spreadArray([undefined], args, true)), message = _a[0], testFn = _a[1], key = _a[2];
+    vestUtils.invariant(vestUtils.isStringValue(fieldName), incompatibleParamsError('fieldName', 'string'));
+    vestUtils.invariant(vestUtils.isFunction(testFn), incompatibleParamsError('Test callback', 'function'));
     var context$1 = context.useX();
     var testObject = new VestTest(fieldName, testFn, {
         message: message,
@@ -1944,7 +1730,7 @@ function testBase(fieldName) {
  *  enforce(data.username).isNotBlank();
  * });
  */
-var test = assign(testBase, {
+var test = vestUtils.assign(testBase, {
     memo: bindTestMemo(testBase)
 });
 function incompatibleParamsError(name, expected) {
@@ -1958,11 +1744,11 @@ var ERROR_OUTSIDE_OF_TEST = "warn hook called outside of a test callback. It won
  */
 function warn() {
     var ctx = context.useX('warn ' + ERROR_HOOK_CALLED_OUTSIDE);
-    invariant(ctx.currentTest, ERROR_OUTSIDE_OF_TEST);
+    vestUtils.invariant(ctx.currentTest, ERROR_OUTSIDE_OF_TEST);
     ctx.currentTest.warn();
 }
 
-var VERSION = "4.4.0-dev-08ec91";
+var VERSION = "4.4.2-dev-afe5de";
 
 Object.defineProperty(exports, 'enforce', {
   enumerable: true,