extra-utils 5.2.0 → 5.4.0

package/README.md

@@ -9,6 +9,12 @@ yarn add extra-utils
 ```
 
 ## API
+### ArrayLike
+```ts
+function first<T>(arr: ArrayLike<T>): T | undefined
+function last<T>(arr: ArrayLike<T>): T | undefined
+```
+
 ### Array
 ```ts
 function isArray<T>(val: unknown): val is Array<T>
@@ -86,6 +92,10 @@ function isntPlainObject<T>(
 
 function isEmptyObject(val: object): boolean
 function isntEmptyObject(val: object): boolean
+
+function isReferenceEqual(a: unknown, b: unknown): boolean
+function isShallowEqual(a: unknown, b: unknown): boolean
+function isDeepEqual(a: unknown, b: unknown): boolean
 ```
 
 ### String

package/lib/array-like/first.d.ts

@@ -0,0 +1 @@
+export declare function first<T>(arr: ArrayLike<T>): T | undefined;

package/lib/array-like/first.js

@@ -0,0 +1,6 @@
+export function first(arr) {
+    return arr.length
+        ? arr[0]
+        : undefined;
+}
+//# sourceMappingURL=first.js.map

package/lib/array-like/first.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first.js","sourceRoot":"","sources":["../../src/array-like/first.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK,CAAI,GAAiB;IACxC,OAAO,GAAG,CAAC,MAAM;QACZ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACR,CAAC,CAAC,SAAS,CAAA;AAClB,CAAC"}

package/lib/array-like/index.d.ts

@@ -0,0 +1,2 @@
+export * from './first.js';
+export * from './last.js';

package/lib/array-like/index.js

@@ -0,0 +1,3 @@
+export * from './first.js';
+export * from './last.js';
+//# sourceMappingURL=index.js.map

package/lib/array-like/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/array-like/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA"}

package/lib/array-like/last.d.ts

@@ -0,0 +1 @@
+export declare function last<T>(arr: ArrayLike<T>): T | undefined;

package/lib/array-like/last.js

@@ -0,0 +1,6 @@
+export function last(arr) {
+    return arr.length
+        ? arr[arr.length - 1]
+        : undefined;
+}
+//# sourceMappingURL=last.js.map

package/lib/array-like/last.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"last.js","sourceRoot":"","sources":["../../src/array-like/last.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,IAAI,CAAI,GAAiB;IACvC,OAAO,GAAG,CAAC,MAAM;QACZ,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QACrB,CAAC,CAAC,SAAS,CAAA;AAClB,CAAC"}

package/lib/index.d.ts

@@ -1,3 +1,4 @@
+export * from './array-like/index.js';
 export * from './array/index.js';
 export * from './boolean/index.js';
 export * from './number/index.js';

package/lib/index.js

@@ -1,3 +1,4 @@
+export * from './array-like/index.js';
 export * from './array/index.js';
 export * from './boolean/index.js';
 export * from './number/index.js';

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA"}

package/lib/object/index.d.ts

@@ -1,3 +1,6 @@
 export * from './is-empty-object.js';
 export * from './is-object.js';
 export * from './is-plain-object.js';
+export * from './is-reference-equal.js';
+export * from './is-shallow-equal.js';
+export * from './is-deep-equal.js';

package/lib/object/index.js

@@ -1,4 +1,7 @@
 export * from './is-empty-object.js';
 export * from './is-object.js';
 export * from './is-plain-object.js';
+export * from './is-reference-equal.js';
+export * from './is-shallow-equal.js';
+export * from './is-deep-equal.js';
 //# sourceMappingURL=index.js.map

package/lib/object/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/object/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/object/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA"}

package/lib/object/is-deep-equal.d.ts

@@ -0,0 +1 @@
+export declare function isDeepEqual(a: unknown, b: unknown): boolean;

package/lib/object/is-deep-equal.js

@@ -0,0 +1,21 @@
+import { isReferenceEqual } from './is-reference-equal.js';
+import { isObject } from './is-object.js';
+export function isDeepEqual(a, b) {
+    if (isReferenceEqual(a, b))
+        return true;
+    if (isObject(a) && isObject(b)) {
+        const keysA = Reflect.ownKeys(a);
+        const keysB = Reflect.ownKeys(b);
+        if (keysA.length === keysB.length) {
+            for (const key of keysA) {
+                if (!Object.prototype.hasOwnProperty.call(b, key) ||
+                    !isDeepEqual(a[key], b[key])) {
+                    return false;
+                }
+            }
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=is-deep-equal.js.map

package/lib/object/is-deep-equal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-deep-equal.js","sourceRoot":"","sources":["../../src/object/is-deep-equal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,MAAM,UAAU,WAAW,CAAC,CAAU,EAAE,CAAU;IAChD,IAAI,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAEvC,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QAChC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QAEhC,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE;YACjC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE;gBACvB,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC;oBAC7C,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAC5B;oBACA,OAAO,KAAK,CAAA;iBACb;aACF;YAED,OAAO,IAAI,CAAA;SACZ;KACF;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

package/lib/object/is-reference-equal.d.ts

@@ -0,0 +1 @@
+export declare function isReferenceEqual(a: unknown, b: unknown): boolean;

package/lib/object/is-reference-equal.js

@@ -0,0 +1,4 @@
+export function isReferenceEqual(a, b) {
+    return a === b;
+}
+//# sourceMappingURL=is-reference-equal.js.map

package/lib/object/is-reference-equal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-reference-equal.js","sourceRoot":"","sources":["../../src/object/is-reference-equal.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,CAAU,EAAE,CAAU;IACrD,OAAO,CAAC,KAAK,CAAC,CAAA;AAChB,CAAC"}

package/lib/object/is-shallow-equal.d.ts

@@ -0,0 +1 @@
+export declare function isShallowEqual(a: unknown, b: unknown): boolean;

package/lib/object/is-shallow-equal.js

@@ -0,0 +1,21 @@
+import { isReferenceEqual } from './is-reference-equal.js';
+import { isObject } from './is-object.js';
+export function isShallowEqual(a, b) {
+    if (isReferenceEqual(a, b))
+        return true;
+    if (isObject(a) && isObject(b)) {
+        const keysA = Reflect.ownKeys(a);
+        const keysB = Reflect.ownKeys(b);
+        if (keysA.length === keysB.length) {
+            for (const key of keysA) {
+                if (!Object.prototype.hasOwnProperty.call(b, key) ||
+                    a[key] !== b[key]) {
+                    return false;
+                }
+            }
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=is-shallow-equal.js.map

package/lib/object/is-shallow-equal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-shallow-equal.js","sourceRoot":"","sources":["../../src/object/is-shallow-equal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,MAAM,UAAU,cAAc,CAAC,CAAU,EAAE,CAAU;IACnD,IAAI,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAEvC,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QAChC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QAEhC,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE;YACjC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE;gBACvB,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC;oBAC7C,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EACjB;oBACA,OAAO,KAAK,CAAA;iBACb;aACF;YAED,OAAO,IAAI,CAAA;SACZ;KACF;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "extra-utils",
-  "version": "5.2.0",
+  "version": "5.4.0",
   "description": "Utilities for JavaScript and Typescript",
   "files": [
     "src",
@@ -34,32 +34,32 @@
     }
   },
   "devDependencies": {
-    "@blackglory/jest-resolver": "^0.3.0",
-    "@blackglory/pass": "^1.1.0",
-    "@commitlint/cli": "^17.6.1",
-    "@commitlint/config-conventional": "^17.6.1",
-    "@types/jest": "^29.5.0",
+    "@blackglory/jest-resolver": "^0.3.1",
+    "@blackglory/pass": "^1.1.1",
+    "@commitlint/cli": "^17.6.7",
+    "@commitlint/config-conventional": "^17.6.7",
+    "@types/jest": "^29.5.3",
     "@types/jsdom": "^21.1.1",
-    "@types/lodash-es": "^4.17.7",
-    "@typescript-eslint/eslint-plugin": "^5.58.0",
-    "@typescript-eslint/parser": "^5.58.0",
+    "@types/lodash-es": "^4.17.8",
+    "@typescript-eslint/eslint-plugin": "^6.1.0",
+    "@typescript-eslint/parser": "^6.1.0",
     "cross-env": "^7.0.3",
-    "eslint": "^8.38.0",
+    "eslint": "^8.45.0",
     "husky": "^4.3.8",
-    "jest": "^29.5.0",
-    "jest-resolve": "^29.5.0",
+    "jest": "^29.6.1",
+    "jest-resolve": "^29.6.1",
     "npm-run-all": "^4.1.5",
-    "rimraf": "^3.0.2",
+    "rimraf": "^5.0.1",
     "standard-version": "^9.5.0",
-    "ts-jest": "^29.1.0",
-    "ts-patch": "^2.1.0",
+    "ts-jest": "^29.1.1",
+    "ts-patch": "^3.0.2",
     "tsd": "^0.28.1",
-    "tslib": "^2.5.0",
-    "typescript": "4.8",
+    "tslib": "^2.6.0",
+    "typescript": "5.1.6",
     "typescript-transform-paths": "^3.4.6"
   },
   "dependencies": {
-    "justypes": "^4.2.0",
+    "justypes": "^4.2.1",
     "lodash-es": "^4.17.21"
   }
 }

package/src/array-like/first.ts

@@ -0,0 +1,5 @@
+export function first<T>(arr: ArrayLike<T>): T | undefined {
+  return arr.length
+       ? arr[0]
+       : undefined
+}

package/src/array-like/index.ts

@@ -0,0 +1,2 @@
+export * from './first.js'
+export * from './last.js'

package/src/array-like/last.ts

@@ -0,0 +1,5 @@
+export function last<T>(arr: ArrayLike<T>): T | undefined {
+  return arr.length
+       ? arr[arr.length - 1]
+       : undefined
+}

package/src/index.ts

@@ -1,3 +1,4 @@
+export * from './array-like/index.js'
 export * from './array/index.js'
 export * from './boolean/index.js'
 export * from './number/index.js'

package/src/object/index.ts

@@ -1,3 +1,6 @@
 export * from './is-empty-object.js'
 export * from './is-object.js'
 export * from './is-plain-object.js'
+export * from './is-reference-equal.js'
+export * from './is-shallow-equal.js'
+export * from './is-deep-equal.js'

package/src/object/is-deep-equal.ts

@@ -0,0 +1,26 @@
+import { isReferenceEqual } from './is-reference-equal.js'
+import { isObject } from './is-object.js'
+
+export function isDeepEqual(a: unknown, b: unknown): boolean {
+  if (isReferenceEqual(a, b)) return true
+
+  if (isObject(a) && isObject(b)) {
+    const keysA = Reflect.ownKeys(a)
+    const keysB = Reflect.ownKeys(b)
+
+    if (keysA.length === keysB.length) {
+      for (const key of keysA) {
+        if (
+          !Object.prototype.hasOwnProperty.call(b, key) ||
+          !isDeepEqual(a[key], b[key])
+        ) {
+          return false
+        }
+      }
+
+      return true
+    }
+  }
+
+  return false
+}

package/src/object/is-reference-equal.ts

@@ -0,0 +1,3 @@
+export function isReferenceEqual(a: unknown, b: unknown): boolean {
+  return a === b
+}

package/src/object/is-shallow-equal.ts

@@ -0,0 +1,26 @@
+import { isReferenceEqual } from './is-reference-equal.js'
+import { isObject } from './is-object.js'
+
+export function isShallowEqual(a: unknown, b: unknown): boolean {
+  if (isReferenceEqual(a, b)) return true
+
+  if (isObject(a) && isObject(b)) {
+    const keysA = Reflect.ownKeys(a)
+    const keysB = Reflect.ownKeys(b)
+
+    if (keysA.length === keysB.length) {
+      for (const key of keysA) {
+        if (
+          !Object.prototype.hasOwnProperty.call(b, key) ||
+          a[key] !== b[key]
+        ) {
+          return false
+        }
+      }
+
+      return true
+    }
+  }
+
+  return false
+}