@longlast/equals 0.3.0 → 0.4.1

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 /**
  * @module equals
  */
+import { type Curried2 } from "@longlast/curry";
 /**
+ * @function
  * Deeply compares two values, returning true if they're equal and false
  * otherwise. The following criteria are used to determine equality:
  *
@@ -24,5 +26,7 @@
  * `equals()` can throw a `RangeError` if one of its arguments contains a
  * reference cycle. Avoid passing mutable objects to `equals()` unless you know
  * that they do not contain cycles.
+ *
+ * `equals()` is curried.
  */
-export declare function equals(a: unknown, b: unknown): boolean;
+export declare const equals: Curried2<unknown, unknown, boolean>;

package/dist/index.js

@@ -1,7 +1,9 @@
 /**
  * @module equals
  */
+import { curry } from "@longlast/curry";
 /**
+ * @function
  * Deeply compares two values, returning true if they're equal and false
  * otherwise. The following criteria are used to determine equality:
  *
@@ -24,8 +26,13 @@
  * `equals()` can throw a `RangeError` if one of its arguments contains a
  * reference cycle. Avoid passing mutable objects to `equals()` unless you know
  * that they do not contain cycles.
+ *
+ * `equals()` is curried.
  */
-export function equals(a, b) {
+export const equals = curry(_equals);
+function _equals(a, b) {
+    // This is an optimized implementation. There is a simpler, equivalent one
+    // in pkg/equals/alt/reference.ts.
     if (Object.is(a, b)) {
         return true;
     }
@@ -40,23 +47,23 @@ export function equals(a, b) {
             Object.getPrototypeOf(a) === Object.getPrototypeOf(b));
     }
     if (a instanceof Set && b instanceof Set) {
-        return equalSets(a, b);
+        return a.size === b.size && [...a].every((v) => b.has(v));
     }
     if (Array.isArray(a) && Array.isArray(b)) {
         return a.length === b.length && a.every((_, i) => equals(a[i], b[i]));
     }
-    if (isObject(a) && isObject(b)) {
-        const aKeys = Object.keys(a);
-        const bKeys = Object.keys(b);
-        return (equalSets(new Set(aKeys), new Set(bKeys)) &&
-            aKeys.every((k) => equals(a[k], b[k])) &&
-            Object.getPrototypeOf(a) === Object.getPrototypeOf(b));
+    if (a && b && typeof a === "object" && protoOf(a) === protoOf(b)) {
+        const bKeys = new Set(Object.keys(b));
+        for (const key of Object.keys(a)) {
+            if (!bKeys.has(key)) {
+                return false;
+            }
+            if (!equals(a[key], b[key])) {
+                return false;
+            }
+        }
+        return true;
     }
     return false;
 }
-function equalSets(a, b) {
-    return a.size === b.size && [...a].every((v) => b.has(v));
-}
-function isObject(x) {
-    return !!x && typeof x === "object";
-}
+const protoOf = Object.getPrototypeOf;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longlast/equals",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "type": "module",
   "files": [
     "dist"
@@ -9,5 +9,8 @@
   "types": "dist/index.d.ts",
   "imports": {
     "#@longlast/equals": "./src/index.ts"
+  },
+  "dependencies": {
+    "@longlast/curry": "^0.2.1"
   }
 }