sculp-js 1.13.3-beta.0 → 1.13.6

package/dist/esm/func.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.13.3-beta.0
+ * sculp-js v1.13.6
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -13,21 +13,20 @@
  * @returns {DebounceFunc<F>}
  */
 const debounce = (func, wait) => {
-    let timeout;
-    let canceled = false;
-    const f = function (...args) {
-        if (canceled)
-            return;
-        clearTimeout(timeout);
-        timeout = setTimeout(() => {
-            func.call(this, ...args);
-        }, wait);
-    };
-    f.cancel = () => {
-        clearTimeout(timeout);
-        canceled = true;
-    };
-    return f;
+  let timeout;
+  let canceled = false;
+  const f = function (...args) {
+    if (canceled) return;
+    clearTimeout(timeout);
+    timeout = setTimeout(() => {
+      func.call(this, ...args);
+    }, wait);
+  };
+  f.cancel = () => {
+    clearTimeout(timeout);
+    canceled = true;
+  };
+  return f;
 };
 /**
  * 节流函数
@@ -39,57 +38,53 @@ const debounce = (func, wait) => {
  * @returns {ThrottleFunc<F>}
  */
 const throttle = (func, wait, immediate) => {
-    let timeout;
-    let canceled = false;
-    let lastCalledTime = 0;
-    const f = function (...args) {
-        if (canceled)
-            return;
-        const now = Date.now();
-        const call = () => {
-            lastCalledTime = now;
-            func.call(this, ...args);
-        };
-        // 第一次执行
-        if (lastCalledTime === 0) {
-            if (immediate) {
-                return call();
-            }
-            else {
-                lastCalledTime = now;
-                return;
-            }
-        }
-        const remain = lastCalledTime + wait - now;
-        if (remain > 0) {
-            clearTimeout(timeout);
-            timeout = setTimeout(() => call(), wait);
-        }
-        else {
-            call();
-        }
+  let timeout;
+  let canceled = false;
+  let lastCalledTime = 0;
+  const f = function (...args) {
+    if (canceled) return;
+    const now = Date.now();
+    const call = () => {
+      lastCalledTime = now;
+      func.call(this, ...args);
     };
-    f.cancel = () => {
-        clearTimeout(timeout);
-        canceled = true;
-    };
-    return f;
+    // 第一次执行
+    if (lastCalledTime === 0) {
+      if (immediate) {
+        return call();
+      } else {
+        lastCalledTime = now;
+        return;
+      }
+    }
+    const remain = lastCalledTime + wait - now;
+    if (remain > 0) {
+      clearTimeout(timeout);
+      timeout = setTimeout(() => call(), wait);
+    } else {
+      call();
+    }
+  };
+  f.cancel = () => {
+    clearTimeout(timeout);
+    canceled = true;
+  };
+  return f;
 };
 /**
  * 单次函数
  * @param {AnyFunc} func
  * @returns {AnyFunc}
  */
-const once = (func) => {
-    let called = false;
-    let result;
-    return function (...args) {
-        if (called)
-            return result;
-        called = true;
-        result = func.call(this, ...args);
-        return result;
-    };
+const once = func => {
+  let called = false;
+  let result;
+  return function (...args) {
+    if (called) return result;
+    called = true;
+    result = func.call(this, ...args);
+    return result;
+  };
 };
 /**
  * 设置全局变量
@@ -97,16 +92,11 @@ const once = (func) => {
  * @param val
  */
 function setGlobal(key, val) {
-    if (typeof globalThis !== 'undefined')
-        globalThis[key] = val;
-    else if (typeof window !== 'undefined')
-        window[key] = val;
-    else if (typeof global !== 'undefined')
-        global[key] = val;
-    else if (typeof self !== 'undefined')
-        self[key] = val;
-    else
-        throw new SyntaxError('当前环境下无法设置全局属性');
+  if (typeof globalThis !== 'undefined') globalThis[key] = val;
+  else if (typeof window !== 'undefined') window[key] = val;
+  else if (typeof global !== 'undefined') global[key] = val;
+  else if (typeof self !== 'undefined') self[key] = val;
+  else throw new SyntaxError('当前环境下无法设置全局属性');
 }
 /**
  * 获取全局变量
@@ -114,14 +104,10 @@ function setGlobal(key, val) {
  * @param val
  */
 function getGlobal(key) {
-    if (typeof globalThis !== 'undefined')
-        return globalThis[key];
-    else if (typeof window !== 'undefined')
-        return window[key];
-    else if (typeof global !== 'undefined')
-        return global[key];
-    else if (typeof self !== 'undefined')
-        return self[key];
+  if (typeof globalThis !== 'undefined') return globalThis[key];
+  else if (typeof window !== 'undefined') return window[key];
+  else if (typeof global !== 'undefined') return global[key];
+  else if (typeof self !== 'undefined') return self[key];
 }
 
 export { debounce, getGlobal, once, setGlobal, throttle };

package/dist/esm/index.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.13.3-beta.0
+ * sculp-js v1.13.6
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -7,27 +7,115 @@
 export { arrayEach, arrayEachAsync, arrayInsertBefore, arrayRemove } from './array.js';
 export { copyText, fallbackCopyText } from './clipboard.js';
 export { cookieDel, cookieGet, cookieSet } from './cookie.js';
-export { calculateDate, calculateDateTime, dateParse, dateToEnd, dateToStart, formatDate, isValidDate } from './date.js';
-export { addClass, getComputedCssVal, getStrWidthPx, getStyle, hasClass, removeClass, select, setStyle, smoothScroll } from './dom.js';
+export {
+  calculateDate,
+  calculateDateTime,
+  dateParse,
+  dateToEnd,
+  dateToStart,
+  formatDate,
+  isValidDate
+} from './date.js';
+export {
+  addClass,
+  getComputedCssVal,
+  getStrWidthPx,
+  getStyle,
+  hasClass,
+  removeClass,
+  select,
+  setStyle,
+  smoothScroll
+} from './dom.js';
 export { crossOriginDownload, downloadBlob, downloadData, downloadHref, downloadURL } from './download.js';
-export { isPlainObject, objectAssign, objectEach, objectEachAsync, objectFill, objectGet, objectMap, objectAssign as objectMerge, objectOmit, objectPick } from './object.js';
+export {
+  isPlainObject,
+  objectAssign,
+  objectEach,
+  objectEachAsync,
+  objectFill,
+  objectGet,
+  objectMap,
+  objectAssign as objectMerge,
+  objectOmit,
+  objectPick
+} from './object.js';
 export { pathJoin, pathNormalize } from './path.js';
 export { qsParse, qsStringify } from './qs.js';
-export { STRING_ARABIC_NUMERALS, STRING_LOWERCASE_ALPHA, STRING_UPPERCASE_ALPHA, parseQueryParams, stringAssign, stringCamelCase, stringEscapeHtml, stringFill, stringFormat, stringKebabCase } from './string.js';
-export { arrayLike, isArray, isBigInt, isBoolean, isDate, isEmpty, isError, isFunction, isJsonString, isNaN, isNodeList, isNull, isNullOrUnDef, isNullOrUnDef as isNullish, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, objectHas, typeIs } from './type.js';
+export {
+  STRING_ARABIC_NUMERALS,
+  STRING_LOWERCASE_ALPHA,
+  STRING_UPPERCASE_ALPHA,
+  parseQueryParams,
+  stringAssign,
+  stringCamelCase,
+  stringEscapeHtml,
+  stringFill,
+  stringFormat,
+  stringKebabCase
+} from './string.js';
+export {
+  arrayLike,
+  isArray,
+  isBigInt,
+  isBoolean,
+  isDate,
+  isEmpty,
+  isError,
+  isFunction,
+  isJsonString,
+  isNaN,
+  isNodeList,
+  isNull,
+  isNullOrUnDef,
+  isNullOrUnDef as isNullish,
+  isNumber,
+  isObject,
+  isPrimitive,
+  isRegExp,
+  isString,
+  isSymbol,
+  isUndefined,
+  objectHas,
+  typeIs
+} from './type.js';
 export { urlDelParams, urlParse, urlSetParams, urlStringify } from './url.js';
 export { asyncMap, safeAwait, wait } from './async.js';
 export { chooseLocalFile, compressImg, supportCanvas } from './file.js';
 export { genCanvasWM } from './watermark.js';
 export { debounce, getGlobal, once, setGlobal, throttle } from './func.js';
 export { STRING_POOL, randomNumber, randomString, randomUuid } from './random.js';
-export { HEX_POOL, formatNumber as formatMoney, formatNumber, humanFileSize, numberAbbr, numberToHex } from './number.js';
+export {
+  HEX_POOL,
+  formatNumber as formatMoney,
+  formatNumber,
+  humanFileSize,
+  numberAbbr,
+  numberToHex
+} from './number.js';
 export { UNIQUE_NUMBER_SAFE_LENGTH, uniqueNumber, uniqueString } from './unique.js';
 export { tooltipEvent } from './tooltip.js';
 export { flatTree, forEachDeep, formatTree, fuzzySearchTree, mapDeep, searchTreeById } from './tree.js';
 export { add, divide, multiply, strip, subtract } from './math.js';
 export { b64decode, b64encode, weAtob, weBtoa } from './base64.js';
-export { EMAIL_REGEX, HTTP_URL_REGEX, IPV4_REGEX, IPV6_REGEX, PHONE_REGEX, URL_REGEX, isDigit, isEmail, isFloat, isIdNo, isInteger, isIpV4, isIpV6, isNumerical, isPhone, isUrl } from './validator.js';
+export {
+  EMAIL_REGEX,
+  HTTP_URL_REGEX,
+  IPV4_REGEX,
+  IPV6_REGEX,
+  PHONE_REGEX,
+  URL_REGEX,
+  isDigit,
+  isEmail,
+  isFloat,
+  isIdNo,
+  isInteger,
+  isIpV4,
+  isIpV6,
+  isNumerical,
+  isPhone,
+  isUrl
+} from './validator.js';
 export { escapeRegExp, executeInScope, parseVarFromString, replaceVarFromString, uniqueSymbol } from './variable.js';
 export { cloneDeep } from './cloneDeep.js';
 export { easingFunctional, easingStringify, getEasing, setEasing } from './easing.js';

package/dist/esm/math.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.13.3-beta.0
+ * sculp-js v1.13.6
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -10,14 +10,12 @@
  * @param arg2 数值2
  */
 const multiply = (arg1, arg2) => {
-    let m = 0;
-    const s1 = arg1.toString();
-    const s2 = arg2.toString();
-    if (s1.split('.')[1] !== undefined)
-        m += s1.split('.')[1].length;
-    if (s2.split('.')[1] !== undefined)
-        m += s2.split('.')[1].length;
-    return (Number(s1.replace('.', '')) * Number(s2.replace('.', ''))) / Math.pow(10, m);
+  let m = 0;
+  const s1 = arg1.toString();
+  const s2 = arg2.toString();
+  if (s1.split('.')[1] !== undefined) m += s1.split('.')[1].length;
+  if (s2.split('.')[1] !== undefined) m += s2.split('.')[1].length;
+  return (Number(s1.replace('.', '')) * Number(s2.replace('.', ''))) / Math.pow(10, m);
 };
 /**
  * 数值安全加法
@@ -25,23 +23,21 @@ const multiply = (arg1, arg2) => {
  * @param arg2 数值2
  */
 const add = (arg1, arg2) => {
-    let r1 = 0;
-    let r2 = 0;
-    let m = 0;
-    try {
-        r1 = arg1.toString().split('.')[1].length;
-    }
-    catch (e) {
-        r1 = 0;
-    }
-    try {
-        r2 = arg2.toString().split('.')[1].length;
-    }
-    catch (e) {
-        r2 = 0;
-    }
-    m = 10 ** Math.max(r1, r2);
-    return (multiply(arg1, m) + multiply(arg2, m)) / m;
+  let r1 = 0;
+  let r2 = 0;
+  let m = 0;
+  try {
+    r1 = arg1.toString().split('.')[1].length;
+  } catch (e) {
+    r1 = 0;
+  }
+  try {
+    r2 = arg2.toString().split('.')[1].length;
+  } catch (e) {
+    r2 = 0;
+  }
+  m = 10 ** Math.max(r1, r2);
+  return (multiply(arg1, m) + multiply(arg2, m)) / m;
 };
 /**
  * 数值安全减法
@@ -55,17 +51,15 @@ const subtract = (arg1, arg2) => add(arg1, -arg2);
  * @param arg2 数值2
  */
 const divide = (arg1, arg2) => {
-    let t1 = 0;
-    let t2 = 0;
-    let r1 = 0;
-    let r2 = 0;
-    if (arg1.toString().split('.')[1] !== undefined)
-        t1 = arg1.toString().split('.')[1].length;
-    if (arg2.toString().split('.')[1] !== undefined)
-        t2 = arg2.toString().split('.')[1].length;
-    r1 = Number(arg1.toString().replace('.', ''));
-    r2 = Number(arg2.toString().replace('.', ''));
-    return (r1 / r2) * Math.pow(10, t2 - t1);
+  let t1 = 0;
+  let t2 = 0;
+  let r1 = 0;
+  let r2 = 0;
+  if (arg1.toString().split('.')[1] !== undefined) t1 = arg1.toString().split('.')[1].length;
+  if (arg2.toString().split('.')[1] !== undefined) t2 = arg2.toString().split('.')[1].length;
+  r1 = Number(arg1.toString().replace('.', ''));
+  r2 = Number(arg2.toString().replace('.', ''));
+  return (r1 / r2) * Math.pow(10, t2 - t1);
 };
 /**
  * Correct the given number to specifying significant digits.
@@ -76,7 +70,7 @@ const divide = (arg1, arg2) => {
  * @example strip(0.09999999999999998) === 0.1 // true
  */
 function strip(num, precision = 15) {
-    return +parseFloat(Number(num).toPrecision(precision));
+  return +parseFloat(Number(num).toPrecision(precision));
 }
 
 export { add, divide, multiply, strip, subtract };

package/dist/esm/number.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.13.3-beta.0
+ * sculp-js v1.13.6
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -11,7 +11,7 @@ import { isNullOrUnDef, isNumber } from './type.js';
 const HEX_POOL = `${STRING_ARABIC_NUMERALS}${STRING_UPPERCASE_ALPHA}${STRING_LOWERCASE_ALPHA}`;
 const supportBigInt = typeof BigInt !== 'undefined';
 const jsbi = () => getGlobal('JSBI');
-const toBigInt = (n) => (supportBigInt ? BigInt(n) : jsbi().BigInt(n));
+const toBigInt = n => (supportBigInt ? BigInt(n) : jsbi().BigInt(n));
 const divide = (x, y) => (supportBigInt ? x / y : jsbi().divide(x, y));
 const remainder = (x, y) => (supportBigInt ? x % y : jsbi().remainder(x, y));
 /**
@@ -21,27 +21,26 @@ const remainder = (x, y) => (supportBigInt ? x % y : jsbi().remainder(x, y));
  * @returns {string}
  */
 function numberToHex(decimal, hexPool = HEX_POOL) {
-    if (hexPool.length < 2)
-        throw new Error('进制池长度不能少于 2');
-    if (!supportBigInt) {
-        throw new Error('需要安装 jsbi 模块并将 JSBI 设置为全局变量：\nimport JSBI from "jsbi"; window.JSBI = JSBI;');
+  if (hexPool.length < 2) throw new Error('进制池长度不能少于 2');
+  if (!supportBigInt) {
+    throw new Error('需要安装 jsbi 模块并将 JSBI 设置为全局变量：\nimport JSBI from "jsbi"; window.JSBI = JSBI;');
+  }
+  // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+  let bigInt = toBigInt(decimal);
+  const ret = [];
+  const { length } = hexPool;
+  // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+  const bigLength = toBigInt(length);
+  const execute = () => {
+    const y = Number(remainder(bigInt, bigLength));
+    bigInt = divide(bigInt, bigLength);
+    ret.unshift(hexPool[y]);
+    if (bigInt > 0) {
+      execute();
     }
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-    let bigInt = toBigInt(decimal);
-    const ret = [];
-    const { length } = hexPool;
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-    const bigLength = toBigInt(length);
-    const execute = () => {
-        const y = Number(remainder(bigInt, bigLength));
-        bigInt = divide(bigInt, bigLength);
-        ret.unshift(hexPool[y]);
-        if (bigInt > 0) {
-            execute();
-        }
-    };
-    execute();
-    return ret.join('');
+  };
+  execute();
+  return ret.join('');
 }
 /**
  * 将数字转换为携带单位的字符串
@@ -51,19 +50,18 @@ function numberToHex(decimal, hexPool = HEX_POOL) {
  * @returns {string}
  */
 const numberAbbr = (num, units, options = { ratio: 1000, decimals: 0, separator: ' ' }) => {
-    const { ratio = 1000, decimals = 0, separator = ' ' } = options;
-    const { length } = units;
-    if (length === 0)
-        throw new Error('At least one unit is required');
-    let num2 = Number(num);
-    let times = 0;
-    while (num2 >= ratio && times < length - 1) {
-        num2 = num2 / ratio;
-        times++;
-    }
-    const value = num2.toFixed(decimals);
-    const unit = units[times];
-    return String(value) + separator + unit;
+  const { ratio = 1000, decimals = 0, separator = ' ' } = options;
+  const { length } = units;
+  if (length === 0) throw new Error('At least one unit is required');
+  let num2 = Number(num);
+  let times = 0;
+  while (num2 >= ratio && times < length - 1) {
+    num2 = num2 / ratio;
+    times++;
+  }
+  const value = num2.toFixed(decimals);
+  const unit = units[times];
+  return String(value) + separator + unit;
 };
 /**
  * Converting file size in bytes to human-readable string
@@ -77,23 +75,23 @@ const numberAbbr = (num, units, options = { ratio: 1000, decimals: 0, separator:
  * @returns
  */
 function humanFileSize(num, options = { decimals: 0, si: false, separator: ' ' }) {
-    const { decimals = 0, si = false, separator = ' ', baseUnit, maxUnit } = options;
-    let units = si
-        ? ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB']
-        : ['Byte', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'];
-    if (!isNullOrUnDef(baseUnit)) {
-        const targetIndex = units.findIndex(el => el === baseUnit);
-        if (targetIndex !== -1) {
-            units = units.slice(targetIndex);
-        }
+  const { decimals = 0, si = false, separator = ' ', baseUnit, maxUnit } = options;
+  let units = si
+    ? ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB']
+    : ['Byte', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'];
+  if (!isNullOrUnDef(baseUnit)) {
+    const targetIndex = units.findIndex(el => el === baseUnit);
+    if (targetIndex !== -1) {
+      units = units.slice(targetIndex);
     }
-    if (!isNullOrUnDef(maxUnit)) {
-        const targetIndex = units.findIndex(el => el === maxUnit);
-        if (targetIndex !== -1) {
-            units.splice(targetIndex + 1);
-        }
+  }
+  if (!isNullOrUnDef(maxUnit)) {
+    const targetIndex = units.findIndex(el => el === maxUnit);
+    if (targetIndex !== -1) {
+      units.splice(targetIndex + 1);
     }
-    return numberAbbr(num, units, { ratio: si ? 1000 : 1024, decimals, separator });
+  }
+  return numberAbbr(num, units, { ratio: si ? 1000 : 1024, decimals, separator });
 }
 /**
  * 将数字格式化成千位分隔符显示的字符串
@@ -102,17 +100,16 @@ function humanFileSize(num, options = { decimals: 0, si: false, separator: ' ' }
  * @returns {string}
  */
 function formatNumber(num, decimals) {
-    if (isNullOrUnDef(decimals)) {
-        return parseInt(String(num)).toLocaleString();
-    }
-    let prec = 0;
-    if (!isNumber(decimals)) {
-        throw new Error('Decimals must be a positive number not less than zero');
-    }
-    else if (decimals > 0) {
-        prec = decimals;
-    }
-    return Number(Number(num).toFixed(prec)).toLocaleString('en-US');
+  if (isNullOrUnDef(decimals)) {
+    return parseInt(String(num)).toLocaleString();
+  }
+  let prec = 0;
+  if (!isNumber(decimals)) {
+    throw new Error('Decimals must be a positive number not less than zero');
+  } else if (decimals > 0) {
+    prec = decimals;
+  }
+  return Number(Number(num).toFixed(prec)).toLocaleString('en-US');
 }
 
 export { HEX_POOL, formatNumber as formatMoney, formatNumber, humanFileSize, numberAbbr, numberToHex };