@tspro/ts-utils-lib 1.6.0 → 1.8.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [1.8.0] - 2025-10-07
+### Added
+- Utils.Math.cmp()
+
+## [1.7.0] - 2025-10-03
+### Added
+- Utils.Obj.hasProperties()
+
 ## [1.6.0] - 2025-09-16
 ### Added
 - Utils.Is.isEmptyArray()

package/README.md

@@ -0,0 +1,6 @@
+# Ts Utils Lib
+
+NPM Package: [@tspro/ts-utils-lib](https://www.npmjs.com/package/@tspro/ts-utils-lib)
+
+This typescript library contains some useful classes, modules and 
+functions shared across multiple projects.

package/dist/index.d.mts

@@ -217,9 +217,11 @@ declare function calcNormal(x1: number, y1: number, x2: number, y2: number): {
     ny: number;
 };
 declare function sum(arr: number[]): number;
+declare function cmp(a: number, b: number): -1 | 0 | 1;
 
 declare const index$3_calcNormal: typeof calcNormal;
 declare const index$3_clamp: typeof clamp;
+declare const index$3_cmp: typeof cmp;
 declare const index$3_interpolateCoord: typeof interpolateCoord;
 declare const index$3_interpolateY: typeof interpolateY;
 declare const index$3_isInteger: typeof isInteger;
@@ -229,14 +231,23 @@ declare const index$3_romanize: typeof romanize;
 declare const index$3_sum: typeof sum;
 declare const index$3_toOrdinalNumber: typeof toOrdinalNumber;
 declare namespace index$3 {
-  export { index$3_calcNormal as calcNormal, index$3_clamp as clamp, index$3_interpolateCoord as interpolateCoord, index$3_interpolateY as interpolateY, index$3_isInteger as isInteger, index$3_linearToDecibels as linearToDecibels, index$3_mod as mod, index$3_romanize as romanize, index$3_sum as sum, index$3_toOrdinalNumber as toOrdinalNumber };
+  export { index$3_calcNormal as calcNormal, index$3_clamp as clamp, index$3_cmp as cmp, index$3_interpolateCoord as interpolateCoord, index$3_interpolateY as interpolateY, index$3_isInteger as isInteger, index$3_linearToDecibels as linearToDecibels, index$3_mod as mod, index$3_romanize as romanize, index$3_sum as sum, index$3_toOrdinalNumber as toOrdinalNumber };
 }
 
-declare function isObject(value: unknown): value is Record<string, unknown>;
+declare function isObject(obj: unknown): obj is Record<string, unknown>;
+/**
+ * <pre>
+ * Usage:
+ *   hasProperties(obj, ["a", "b"]);          // Gives type Record<string, unknown>
+ *   hasProperties(obj, ["a", "b"] as const); // Gives type Record<"a" | "b", unknown>
+ * </pre>
+ */
+declare function hasProperties<T extends readonly string[]>(obj: unknown, props: T | string[]): obj is Record<T[number], unknown>;
 
+declare const index$2_hasProperties: typeof hasProperties;
 declare const index$2_isObject: typeof isObject;
 declare namespace index$2 {
-  export { index$2_isObject as isObject };
+  export { index$2_hasProperties as hasProperties, index$2_isObject as isObject };
 }
 
 /**

package/dist/index.d.ts

@@ -217,9 +217,11 @@ declare function calcNormal(x1: number, y1: number, x2: number, y2: number): {
     ny: number;
 };
 declare function sum(arr: number[]): number;
+declare function cmp(a: number, b: number): -1 | 0 | 1;
 
 declare const index$3_calcNormal: typeof calcNormal;
 declare const index$3_clamp: typeof clamp;
+declare const index$3_cmp: typeof cmp;
 declare const index$3_interpolateCoord: typeof interpolateCoord;
 declare const index$3_interpolateY: typeof interpolateY;
 declare const index$3_isInteger: typeof isInteger;
@@ -229,14 +231,23 @@ declare const index$3_romanize: typeof romanize;
 declare const index$3_sum: typeof sum;
 declare const index$3_toOrdinalNumber: typeof toOrdinalNumber;
 declare namespace index$3 {
-  export { index$3_calcNormal as calcNormal, index$3_clamp as clamp, index$3_interpolateCoord as interpolateCoord, index$3_interpolateY as interpolateY, index$3_isInteger as isInteger, index$3_linearToDecibels as linearToDecibels, index$3_mod as mod, index$3_romanize as romanize, index$3_sum as sum, index$3_toOrdinalNumber as toOrdinalNumber };
+  export { index$3_calcNormal as calcNormal, index$3_clamp as clamp, index$3_cmp as cmp, index$3_interpolateCoord as interpolateCoord, index$3_interpolateY as interpolateY, index$3_isInteger as isInteger, index$3_linearToDecibels as linearToDecibels, index$3_mod as mod, index$3_romanize as romanize, index$3_sum as sum, index$3_toOrdinalNumber as toOrdinalNumber };
 }
 
-declare function isObject(value: unknown): value is Record<string, unknown>;
+declare function isObject(obj: unknown): obj is Record<string, unknown>;
+/**
+ * <pre>
+ * Usage:
+ *   hasProperties(obj, ["a", "b"]);          // Gives type Record<string, unknown>
+ *   hasProperties(obj, ["a", "b"] as const); // Gives type Record<"a" | "b", unknown>
+ * </pre>
+ */
+declare function hasProperties<T extends readonly string[]>(obj: unknown, props: T | string[]): obj is Record<T[number], unknown>;
 
+declare const index$2_hasProperties: typeof hasProperties;
 declare const index$2_isObject: typeof isObject;
 declare namespace index$2 {
-  export { index$2_isObject as isObject };
+  export { index$2_hasProperties as hasProperties, index$2_isObject as isObject };
 }
 
 /**

package/dist/index.js

@@ -1,4 +1,4 @@
-/* TsUtilsLib v1.6.0 | (c) 2023 PahkaSoft | Licensed under the MIT License */
+/* TsUtilsLib v1.8.0 | (c) 2023 PahkaSoft | Licensed under the MIT License */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -69,6 +69,7 @@ var math_exports = {};
 __export(math_exports, {
   calcNormal: () => calcNormal,
   clamp: () => clamp,
+  cmp: () => cmp,
   interpolateCoord: () => interpolateCoord,
   interpolateY: () => interpolateY,
   isInteger: () => isInteger,
@@ -181,6 +182,9 @@ function calcNormal(x1, y1, x2, y2) {
 function sum(arr) {
   return arr.reduce((prev, cur) => cur + prev, 0);
 }
+function cmp(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
 
 // src/utils/arr/index.ts
 function isArray(a) {
@@ -195,8 +199,8 @@ function duplicate(a) {
 function removeDuplicates(a) {
   return a.filter((item, pos, arr) => arr.indexOf(item) === pos);
 }
-function removeDuplicatesCmp(arr, cmp) {
-  return arr.filter((t1, index, self) => index === self.findIndex((t2) => cmp(t1, t2)));
+function removeDuplicatesCmp(arr, cmp2) {
+  return arr.filter((t1, index, self) => index === self.findIndex((t2) => cmp2(t1, t2)));
 }
 function fillArray(fillValue, fillCount) {
   if (!isInteger(fillCount) || fillCount < 0) {
@@ -871,10 +875,14 @@ function getMapKeys(map) {
 // src/utils/obj/index.ts
 var obj_exports = {};
 __export(obj_exports, {
+  hasProperties: () => hasProperties,
   isObject: () => isObject2
 });
-function isObject2(value) {
-  return typeof value === "object" && value !== null && !isArray(value);
+function isObject2(obj) {
+  return typeof obj === "object" && obj !== null && !isArray(obj);
+}
+function hasProperties(obj, props) {
+  return isObject2(obj) && props.every((p) => p in obj);
 }
 
 // src/utils/str/index.ts

package/dist/index.mjs

@@ -1,4 +1,4 @@
-/* TsUtilsLib v1.6.0 | (c) 2023 PahkaSoft | Licensed under the MIT License */
+/* TsUtilsLib v1.8.0 | (c) 2023 PahkaSoft | Licensed under the MIT License */
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __export = (target, all) => {
@@ -42,6 +42,7 @@ var math_exports = {};
 __export(math_exports, {
   calcNormal: () => calcNormal,
   clamp: () => clamp,
+  cmp: () => cmp,
   interpolateCoord: () => interpolateCoord,
   interpolateY: () => interpolateY,
   isInteger: () => isInteger,
@@ -154,6 +155,9 @@ function calcNormal(x1, y1, x2, y2) {
 function sum(arr) {
   return arr.reduce((prev, cur) => cur + prev, 0);
 }
+function cmp(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
 
 // src/utils/arr/index.ts
 function isArray(a) {
@@ -168,8 +172,8 @@ function duplicate(a) {
 function removeDuplicates(a) {
   return a.filter((item, pos, arr) => arr.indexOf(item) === pos);
 }
-function removeDuplicatesCmp(arr, cmp) {
-  return arr.filter((t1, index, self) => index === self.findIndex((t2) => cmp(t1, t2)));
+function removeDuplicatesCmp(arr, cmp2) {
+  return arr.filter((t1, index, self) => index === self.findIndex((t2) => cmp2(t1, t2)));
 }
 function fillArray(fillValue, fillCount) {
   if (!isInteger(fillCount) || fillCount < 0) {
@@ -844,10 +848,14 @@ function getMapKeys(map) {
 // src/utils/obj/index.ts
 var obj_exports = {};
 __export(obj_exports, {
+  hasProperties: () => hasProperties,
   isObject: () => isObject2
 });
-function isObject2(value) {
-  return typeof value === "object" && value !== null && !isArray(value);
+function isObject2(obj) {
+  return typeof obj === "object" && obj !== null && !isArray(obj);
+}
+function hasProperties(obj, props) {
+  return isObject2(obj) && props.every((p) => p in obj);
 }
 
 // src/utils/str/index.ts

package/package.json

@@ -1,10 +1,17 @@
 {
     "name": "@tspro/ts-utils-lib",
-    "version": "1.6.0",
+    "version": "1.8.0",
     "author": "PahkaSoft",
     "license": "MIT",
     "private": false,
-    "description": "",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/pahkasoft/ts-utils-lib.git"
+    },
+    "bugs": {
+        "url": "https://github.com/pahkasoft/ts-utils-lib/issues/new/choose"
+    },
+    "description": "Useful library of typescript classes, modules and functions.",
     "types": "dist/index.d.ts",
     "main": "dist/index.js",
     "module": "dist/index.mjs",