@tspro/ts-utils-lib 2.1.0 → 2.2.1

package/dist/index.js

@@ -1,8 +1,8 @@
 'use strict';
 
 /*!
- * TsUtilsLib v2.1.0 (cjs)
- * (c) 2023–2025 PahkaSoft
+ * TsUtilsLib v2.2.1 (cjs)
+ * (c) 2023-2025 PahkaSoft
  * Licensed under the MIT License
  */
 var __defProp = Object.defineProperty;
@@ -70,6 +70,11 @@ __export(assert_exports, {
   isNumber: () => isNumber2,
   isNumberBetween: () => isNumberBetween2,
   isNumberBetweenExclusive: () => isNumberBetweenExclusive2,
+  isNumberEq: () => isNumberEq2,
+  isNumberGt: () => isNumberGt2,
+  isNumberGte: () => isNumberGte2,
+  isNumberLt: () => isNumberLt2,
+  isNumberLte: () => isNumberLte2,
   isNumberOrUndefined: () => isNumberOrUndefined2,
   isNumericString: () => isNumericString2,
   isObject: () => isObject2,
@@ -81,6 +86,7 @@ __export(assert_exports, {
   isPosZero: () => isPosZero2,
   isPowerOfTwo: () => isPowerOfTwo2,
   isSafeInteger: () => isSafeInteger2,
+  isSafeNumber: () => isSafeNumber2,
   isStrictEqual: () => isStrictEqual2,
   isString: () => isString2,
   isStringOrUndefined: () => isStringOrUndefined2,
@@ -106,6 +112,9 @@ __export(str_exports, {
   removeAt: () => removeAt,
   repeatString: () => repeatString,
   replaceAt: () => replaceAt,
+  splitByCaps: () => splitByCaps,
+  splitByChars: () => splitByChars,
+  splitByStrings: () => splitByStrings,
   stringify: () => stringify,
   toCharArray: () => toCharArray
 });
@@ -174,6 +183,11 @@ __export(guard_exports, {
   isNumber: () => isNumber,
   isNumberBetween: () => isNumberBetween,
   isNumberBetweenExclusive: () => isNumberBetweenExclusive,
+  isNumberEq: () => isNumberEq,
+  isNumberGt: () => isNumberGt,
+  isNumberGte: () => isNumberGte,
+  isNumberLt: () => isNumberLt,
+  isNumberLte: () => isNumberLte,
   isNumberOrUndefined: () => isNumberOrUndefined,
   isNumericString: () => isNumericString,
   isObject: () => isObject,
@@ -185,6 +199,7 @@ __export(guard_exports, {
   isPosZero: () => isPosZero,
   isPowerOfTwo: () => isPowerOfTwo,
   isSafeInteger: () => isSafeInteger,
+  isSafeNumber: () => isSafeNumber,
   isStrictEqual: () => isStrictEqual,
   isString: () => isString,
   isStringOrUndefined: () => isStringOrUndefined,
@@ -340,9 +355,33 @@ function isBigInt(val) {
 function isNumber(val) {
   return typeof val === "number";
 }
+function isSafeNumber(val) {
+  return isNumber(val) && Number.isSafeInteger(val);
+}
 function isNumberOrUndefined(val) {
   return typeof val === "number" || val === void 0;
 }
+function isNumberEq(val, ref) {
+  return isNumber(val) && val === ref;
+}
+function isNumberGt(val, ref) {
+  return isNumber(val) && isNumber(ref) && val > ref;
+}
+function isNumberGte(val, ref) {
+  return isNumber(val) && isNumber(ref) && val >= ref;
+}
+function isNumberLt(val, ref) {
+  return isNumber(val) && isNumber(ref) && val < ref;
+}
+function isNumberLte(val, ref) {
+  return isNumber(val) && isNumber(ref) && val <= ref;
+}
+function isNumberBetween(val, min, max) {
+  return isNumber(val) && isNumber(min) && isNumber(max) && val >= min && val <= max;
+}
+function isNumberBetweenExclusive(val, min, max) {
+  return isNumber(val) && isNumber(min) && isNumber(max) && val > min && val < max;
+}
 function isFinite2(val) {
   return typeof val === "number" && Number.isFinite(val);
 }
@@ -379,12 +418,6 @@ function isIntegerBetween(val, min, max) {
 function isIntegerBetweenExclusive(val, min, max) {
   return isInteger(val) && isNumber(min) && isNumber(max) && val > min && val < max;
 }
-function isNumberBetween(val, min, max) {
-  return isNumber(val) && isNumber(min) && isNumber(max) && val >= min && val <= max;
-}
-function isNumberBetweenExclusive(val, min, max) {
-  return isNumber(val) && isNumber(min) && isNumber(max) && val > min && val < max;
-}
 function isNaNValue(val) {
   return typeof val === "number" && Number.isNaN(val);
 }
@@ -654,6 +687,18 @@ function stringify(value, maxDepth = 5, seen = /* @__PURE__ */ new WeakSet()) {
   }
   return String(value);
 }
+function splitByCaps(str2) {
+  return str2.split(/(?=[A-Z])/).filter((x) => !!x);
+}
+function splitByStrings(str2, ...splitters) {
+  if (splitters.length === 0) return [str2];
+  const escaped = splitters.map((s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
+  const regex = new RegExp(escaped.join("|"), "g");
+  return str2.split(regex);
+}
+function splitByChars(str2, splitters) {
+  return splitByStrings(str2, ...splitters.split(""));
+}
 
 // src/assert/index.ts
 var fmt = stringify;
@@ -873,11 +918,51 @@ function isNumber2(val, msg) {
     _fail(`Expected ${fmt(val)} to be number`, msg);
   return val;
 }
+function isSafeNumber2(val, msg) {
+  if (!guard_exports.isSafeNumber(val))
+    _fail(`Expected ${fmt(val)} to be safe number`, msg);
+  return val;
+}
 function isNumberOrUndefined2(val, msg) {
   if (!guard_exports.isNumberOrUndefined(val))
     _fail(`Expected ${fmt(val)} to be number or undefined`, msg);
   return val;
 }
+function isNumberEq2(val, ref, msg) {
+  if (!guard_exports.isNumberEq(val, ref))
+    _fail(`Expected ${fmt(val)} to be number equal to ${fmt(ref)}`, msg);
+  return val;
+}
+function isNumberGt2(val, ref, msg) {
+  if (!guard_exports.isNumberGt(val, ref))
+    _fail(`Expected ${fmt(val)} to be number > ${fmt(ref)}`, msg);
+  return val;
+}
+function isNumberGte2(val, ref, msg) {
+  if (!guard_exports.isNumberGte(val, ref))
+    _fail(`Expected ${fmt(val)} to be number >= ${fmt(ref)}`, msg);
+  return val;
+}
+function isNumberLt2(val, ref, msg) {
+  if (!guard_exports.isNumberLt(val, ref))
+    _fail(`Expected ${fmt(val)} to be number < ${fmt(ref)}`, msg);
+  return val;
+}
+function isNumberLte2(val, ref, msg) {
+  if (!guard_exports.isNumberLte(val, ref))
+    _fail(`Expected ${fmt(val)} to be number <= ${fmt(ref)}`, msg);
+  return val;
+}
+function isNumberBetween2(val, min, max, msg) {
+  if (!guard_exports.isNumberBetween(val, min, max))
+    _fail(`Expected number ${fmt(min)} <= ${fmt(val)} <= ${fmt(max)}`, msg);
+  return val;
+}
+function isNumberBetweenExclusive2(val, min, max, msg) {
+  if (!guard_exports.isNumberBetweenExclusive(val, min, max))
+    _fail(`Expected number ${fmt(min)} < ${fmt(val)} < ${fmt(max)}`, msg);
+  return val;
+}
 function isFinite3(val, msg) {
   if (!guard_exports.isFinite(val))
     _fail(`Expected ${fmt(val)} to be finite`, msg);
@@ -938,16 +1023,6 @@ function isIntegerBetweenExclusive2(val, min, max, msg) {
     _fail(`Expected integer ${fmt(min)} < ${fmt(val)} < ${fmt(max)}`, msg);
   return val;
 }
-function isNumberBetween2(val, min, max, msg) {
-  if (!guard_exports.isNumberBetween(val, min, max))
-    _fail(`Expected number ${fmt(min)} <= ${fmt(val)} <= ${fmt(max)}`, msg);
-  return val;
-}
-function isNumberBetweenExclusive2(val, min, max, msg) {
-  if (!guard_exports.isNumberBetweenExclusive(val, min, max))
-    _fail(`Expected number ${fmt(min)} < ${fmt(val)} < ${fmt(max)}`, msg);
-  return val;
-}
 function isNaNValue2(val, msg) {
   if (!guard_exports.isNaNValue(val))
     _fail(`Expected ${fmt(val)} to be NaN`, msg);
@@ -1070,7 +1145,9 @@ var _consent;
 var _expires;
 var str = _read(ConsentCookieName);
 _consent = str === "accept" /* Accept */ || str === "decline" /* Decline */ ? str : void 0;
-function _getList() {
+function _getCookieList() {
+  if (typeof document === "undefined")
+    return [];
   let s = document.cookie;
   return s.split(";").map((c) => c.trim());
 }
@@ -1079,15 +1156,17 @@ function _save(name, value) {
   if (_expires) {
     cookie += "expires=" + _expires.toUTCString() + ";";
   }
-  document.cookie = cookie;
+  if (typeof document !== "undefined")
+    document.cookie = cookie;
   return value;
 }
 function _read(name, defaultValue) {
-  let str2 = _getList().find((c) => c.startsWith(name + "="));
+  let str2 = _getCookieList().find((c) => c.startsWith(name + "="));
   return str2 === void 0 ? defaultValue : str2.substring(name.length + 1);
 }
 function _erase(name) {
-  document.cookie = name + "=;expires=Thu, 01 Jan 1970 00:00:00 UTC;";
+  if (typeof document !== "undefined")
+    document.cookie = name + "=;expires=Thu, 01 Jan 1970 00:00:00 UTC;";
 }
 function setExpireDays(days) {
   _expires = /* @__PURE__ */ new Date();
@@ -1136,7 +1215,8 @@ function erase(name) {
     _erase(name);
 }
 function eraseAll() {
-  document.cookie.split(";").forEach((c) => erase(c.trim().split("=")[0]));
+  if (typeof document !== "undefined")
+    document.cookie.split(";").forEach((c) => erase(c.trim().split("=")[0]));
 }
 
 // src/web/device.ts
@@ -1154,12 +1234,16 @@ __export(device_exports, {
   toPx: () => toPx
 });
 function getDPI() {
-  let el = document.createElement("div");
-  el.style.width = "1in";
-  document.body.appendChild(el);
-  let dpi = el.offsetWidth;
-  el.remove();
-  return dpi || 96;
+  try {
+    let el = document.createElement("div");
+    el.style.width = "1in";
+    document.body.appendChild(el);
+    let dpi = el.offsetWidth;
+    el.remove();
+    return dpi || 96;
+  } catch (e) {
+    return 96;
+  }
 }
 function getScrollBarWidth() {
   try {
@@ -1182,18 +1266,23 @@ function getScrollBarWidth() {
   }
 }
 function getSystemFontSize() {
-  let tmpDiv = document.createElement("div");
-  tmpDiv.style.cssText = "display:inline-block; padding:0; line-height:1; position:absolute; visibility:hidden; font-size:1em";
-  tmpDiv.appendChild(document.createTextNode("M"));
-  document.body.appendChild(tmpDiv);
-  let fontsize = tmpDiv.offsetHeight;
-  document.body.removeChild(tmpDiv);
-  return fontsize;
+  try {
+    let tmpDiv = document.createElement("div");
+    tmpDiv.style.cssText = "display:inline-block; padding:0; line-height:1; position:absolute; visibility:hidden; font-size:1em";
+    tmpDiv.appendChild(document.createTextNode("M"));
+    document.body.appendChild(tmpDiv);
+    let fontsize = tmpDiv.offsetHeight;
+    document.body.removeChild(tmpDiv);
+    return fontsize;
+  } catch (e) {
+    return 16;
+  }
 }
 function getIsTouchDevice() {
-  if ("ontouchstart" in window || "DocumentTouch" in window || "createTouch" in document && "createTouchList" in document) {
+  if (typeof window === "undefined")
+    return false;
+  if ("ontouchstart" in window || "DocumentTouch" in window || "createTouch" in document && "createTouchList" in document)
     return true;
-  }
   var prefixes = " -webkit- -moz- -o- -ms- ".split(" ");
   var mq = function(query2) {
     return window.matchMedia(query2).matches;
@@ -1206,7 +1295,10 @@ function getIsMobileDevice() {
   return /(android|bb\d+|meego).+mobile|avantgo|bada\/|blackberry|blazer|compal|elaine|fennec|hiptop|iemobile|ip(hone|od)|iris|kindle|lge |maemo|midp|mmp|mobile.+firefox|netfront|opera m(ob|in)i|palm( os)?|phone|p(ixi|re)\/|plucker|pocket|psp|series(4|6)0|symbian|treo|up\.(browser|link)|vodafone|wap|windows ce|xda|xiino/i.test(a) || /1207|6310|6590|3gso|4thp|50[1-6]i|770s|802s|a wa|abac|ac(er|oo|s\-)|ai(ko|rn)|al(av|ca|co)|amoi|an(ex|ny|yw)|aptu|ar(ch|go)|as(te|us)|attw|au(di|\-m|r |s )|avan|be(ck|ll|nq)|bi(lb|rd)|bl(ac|az)|br(e|v)w|bumb|bw\-(n|u)|c55\/|capi|ccwa|cdm\-|cell|chtm|cldc|cmd\-|co(mp|nd)|craw|da(it|ll|ng)|dbte|dc\-s|devi|dica|dmob|do(c|p)o|ds(12|\-d)|el(49|ai)|em(l2|ul)|er(ic|k0)|esl8|ez([4-7]0|os|wa|ze)|fetc|fly(\-|_)|g1 u|g560|gene|gf\-5|g\-mo|go(\.w|od)|gr(ad|un)|haie|hcit|hd\-(m|p|t)|hei\-|hi(pt|ta)|hp( i|ip)|hs\-c|ht(c(\-| |_|a|g|p|s|t)|tp)|hu(aw|tc)|i\-(20|go|ma)|i230|iac( |\-|\/)|ibro|idea|ig01|ikom|im1k|inno|ipaq|iris|ja(t|v)a|jbro|jemu|jigs|kddi|keji|kgt( |\/)|klon|kpt |kwc\-|kyo(c|k)|le(no|xi)|lg( g|\/(k|l|u)|50|54|\-[a-w])|libw|lynx|m1\-w|m3ga|m50\/|ma(te|ui|xo)|mc(01|21|ca)|m\-cr|me(rc|ri)|mi(o8|oa|ts)|mmef|mo(01|02|bi|de|do|t(\-| |o|v)|zz)|mt(50|p1|v )|mwbp|mywa|n10[0-2]|n20[2-3]|n30(0|2)|n50(0|2|5)|n7(0(0|1)|10)|ne((c|m)\-|on|tf|wf|wg|wt)|nok(6|i)|nzph|o2im|op(ti|wv)|oran|owg1|p800|pan(a|d|t)|pdxg|pg(13|\-([1-8]|c))|phil|pire|pl(ay|uc)|pn\-2|po(ck|rt|se)|prox|psio|pt\-g|qa\-a|qc(07|12|21|32|60|\-[2-7]|i\-)|qtek|r380|r600|raks|rim9|ro(ve|zo)|s55\/|sa(ge|ma|mm|ms|ny|va)|sc(01|h\-|oo|p\-)|sdk\/|se(c(\-|0|1)|47|mc|nd|ri)|sgh\-|shar|sie(\-|m)|sk\-0|sl(45|id)|sm(al|ar|b3|it|t5)|so(ft|ny)|sp(01|h\-|v\-|v )|sy(01|mb)|t2(18|50)|t6(00|10|18)|ta(gt|lk)|tcl\-|tdg\-|tel(i|m)|tim\-|t\-mo|to(pl|sh)|ts(70|m\-|m3|m5)|tx\-9|up(\.b|g1|si)|utst|v400|v750|veri|vi(rg|te)|vk(40|5[0-3]|\-v)|vm40|voda|vulc|vx(52|53|60|61|70|80|81|83|85|98)|w3c(\-| )|webc|whit|wi(g |nc|nw)|wmlb|wonu|x700|yas\-|your|zeto|zte\-/i.test(a.substr(0, 4));
 }
 function getHostAddress() {
-  return location.protocol + "//" + location.host;
+  if (typeof location === "undefined" || !location.host) {
+    return "localhost";
+  }
+  return `${location.protocol}//${location.host}`;
 }
 var UnitRegExp = /^(mm|cm|in|inch|px|em)$/;
 var ValueUnitRegExp = /^([0-9\\.]+)(.*)$/;
@@ -1366,6 +1458,9 @@ __export(dom_exports, {
   setWidth: () => setWidth,
   styleLayoutChanged: () => styleLayoutChanged
 });
+function _getElemById(id) {
+  return typeof document === "undefined" ? void 0 : document.getElementById(id) ?? void 0;
+}
 function toPx2(value) {
   return value === void 0 ? void 0 : device_exports.toPx(value);
 }
@@ -1402,12 +1497,17 @@ function setOffset(el, left, top, unit = "px") {
   el.style.top = top + unit;
 }
 function getOffset(el) {
-  let box = el.getBoundingClientRect();
-  let docElem = document.documentElement;
-  return {
-    top: box.top + window.pageYOffset - docElem.clientTop,
-    left: box.left + window.pageXOffset - docElem.clientLeft
-  };
+  let { left, top } = el.getBoundingClientRect();
+  if (typeof window !== "undefined") {
+    left += window.pageXOffset;
+    top += window.pageYOffset;
+  }
+  if (typeof document !== "undefined") {
+    let de = document.documentElement;
+    left -= de.clientLeft;
+    top -= de.clientTop;
+  }
+  return { left, top };
 }
 function getWidth(el) {
   if (el instanceof Window) {
@@ -1447,11 +1547,11 @@ function setRect(el, left, top, width, height, unit = "px") {
   el.style.height = height + unit;
 }
 function getButton(btn) {
-  let el = typeof btn === "string" ? document.getElementById(btn) : btn;
+  let el = typeof btn === "string" ? _getElemById(btn) : btn;
   return el instanceof HTMLButtonElement ? el : void 0;
 }
 function getCanvas(canvas2) {
-  let el = typeof canvas2 === "string" ? document.getElementById(canvas2) : canvas2;
+  let el = typeof canvas2 === "string" ? _getElemById(canvas2) : canvas2;
   return el instanceof HTMLCanvasElement ? el : void 0;
 }
 function getPadding(style) {
@@ -1524,11 +1624,11 @@ function styleLayoutChanged(style1, style2) {
 }
 var canvas;
 function getCanvasTextWidth(text, font) {
-  canvas ?? (canvas = document.createElement("canvas"));
-  let ctx = canvas.getContext("2d");
-  if (!ctx) {
+  if (!canvas && typeof document !== "undefined")
+    canvas = document.createElement("canvas");
+  let ctx = canvas?.getContext("2d");
+  if (!ctx)
     return 0;
-  }
   ctx.font = font;
   return ctx.measureText(text).width;
 }
@@ -4269,7 +4369,7 @@ var LinkedList = class _LinkedList extends BaseContainer {
 
 // src/index.ts
 function getLibInfo() {
-  return "TsUtilsLib v2.1.0 (cjs)";
+  return "TsUtilsLib v2.2.1 (cjs)";
 }
 
 exports.AnchoredRect = AnchoredRect;