@arrai-innovations/reactive-helpers 8.3.3 → 8.5.0

package/README.md

@@ -447,7 +447,14 @@ We make use of the basic set operations provided as example on mdn:
 https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set#implementing_basic_set_operations
 
 ```js
-import { isSuperset, union, intersection, symmetricDifference, difference } from "@arrai-innovations/reactive-helpers";
+import {
+    isSuperset,
+    union,
+    intersection,
+    symmetricDifference,
+    difference,
+    equals,
+} from "@arrai-innovations/reactive-helpers";
 
 isSuperset(new Set([1, 2, 3, 4]), new Set([1, 2, 3])); // true
 union(new Set([1, 2, 3, 4]), new Set([1, 2, 3])); // Set { 1, 2, 3, 4 }
@@ -455,6 +462,7 @@ intersection(new Set([1, 2, 3, 4]), new Set([1, 2, 3])); // Set { 1, 2, 3 }
 symmetricDifference(new Set([1, 2, 3, 4]), new Set([1, 2, 3, 5])); // Set { 4, 5 }
 difference(new Set([1, 2, 3, 4]), new Set([1, 2, 3, 5])); // Set { 4 }
 difference(new Set([1, 2, 3, 5]), new Set([1, 2, 3, 4])); // Set { 5 }
+equals(new Set([1, 2, 3, 4]), new Set([1, 2, 3, 5])); // false
 ```
 
 #### watches

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@arrai-innovations/reactive-helpers",
-    "version": "8.3.3",
+    "version": "8.5.0",
     "description": "VueJS 3 utility composition functions to help manipulate objects and lists.",
     "main": "index.js",
     "type": "module",

package/tests/unit/utils/set.spec.js

@@ -1,4 +1,4 @@
-import { difference, intersection, isSuperset, symmetricDifference, union } from "../../../utils/set.js";
+import { difference, intersection, isSuperset, symmetricDifference, union, equals } from "../../../utils/set.js";
 
 describe("utils/set", function () {
     describe("isSuperset", function () {
@@ -57,6 +57,18 @@ describe("utils/set", function () {
             expect(difference(set2, set1)).toEqual(new Set([5, 6]));
         });
     });
+    describe("equals", function () {
+        it("should return true if the two sets are equal", function () {
+            const set1 = new Set([1, 2, 3, 4]);
+            const set2 = new Set([1, 2, 3, 4]);
+            expect(equals(set1, set2)).toBe(true);
+        });
+        it("should return false if the two sets are not equal", function () {
+            const set1 = new Set([1, 2, 3, 4]);
+            const set2 = new Set([1, 2, 3, 5]);
+            expect(equals(set1, set2)).toBe(false);
+        });
+    });
     it("should work as in the example for the readme", function () {
         expect(isSuperset(new Set([1, 2, 3, 4]), new Set([1, 2, 3]))).toBe(true);
         expect(union(new Set([1, 2, 3, 4]), new Set([1, 2, 3]))).toEqual(new Set([1, 2, 3, 4]));
@@ -64,5 +76,6 @@ describe("utils/set", function () {
         expect(symmetricDifference(new Set([1, 2, 3, 4]), new Set([1, 2, 3, 5]))).toEqual(new Set([4, 5]));
         expect(difference(new Set([1, 2, 3, 4]), new Set([1, 2, 3, 5]))).toEqual(new Set([4]));
         expect(difference(new Set([1, 2, 3, 5]), new Set([1, 2, 3, 4]))).toEqual(new Set([5]));
+        expect(equals(new Set([1, 2, 3, 4]), new Set([1, 2, 3, 5]))).toBe(false);
     });
 });

package/use/cancellableIntent.js

@@ -87,6 +87,7 @@ export function useCancellableIntent({
 
     const intentWatch = async () => {
         let newWatchValues = deepUnref(Object.values(watchArguments));
+        const guardValues = deepUnref(Object.values(guardArguments));
         if (isEqual(newWatchValues, previousWatchValues)) {
             return;
         }
@@ -94,7 +95,7 @@ export function useCancellableIntent({
         await cancel();
         if (Object.values(previousWatchValues).every(identity)) {
             // if any guards are true, delay the watch.
-            if (guardArguments && !isEmpty(guardArguments) && Object.values(guardArguments).some(identity)) {
+            if (guardValues && !isEmpty(guardValues) && guardValues.some(identity)) {
                 delayedWatch = doIntentWatch;
                 return;
             }
@@ -144,6 +145,7 @@ export function useCancellableIntent({
     return {
         state,
         watchArguments: readonly(watchArguments),
+        guardArguments: readonly(guardArguments),
         stop,
         cancel,
     };

package/use/objectInstance.js

@@ -222,6 +222,11 @@ export function useObjectInstance({ props, functions = {} }) {
         state.error = null;
     }
 
+    function clear() {
+        clearError();
+        state.object = {};
+    }
+
     return reactive({
         state,
         retrieve,
@@ -230,5 +235,6 @@ export function useObjectInstance({ props, functions = {} }) {
         patch,
         delete: deleteFn,
         clearError,
+        clear,
     });
 }

package/utils/set.js

@@ -46,3 +46,7 @@ export const difference = (setA, setB) => {
     }
     return _difference;
 };
+
+export const equals = (setA, setB) => {
+    return setA.size === setB.size && isSuperset(setA, setB);
+};