sculp-js 1.8.4 → 1.9.0

package/lib/cjs/array.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/async.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/base64.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/clipboard.js

@@ -1,32 +1,28 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-var dom = require('./dom.js');
-
-const textEl = document.createElement('textarea');
-dom.setStyle(textEl, {
-    position: 'absolute',
-    top: '-9999px',
-    left: '-9999px',
-    opacity: 0
-});
-document.body.appendChild(textEl);
 /**
  * 复制文本
  * @param {string} text
  */
 function copyText(text) {
+    const textEl = document.createElement('textarea');
+    textEl.style.position = 'absolute';
+    textEl.style.top = '-9999px';
+    textEl.style.left = '-9999px';
     textEl.value = text;
+    document.body.appendChild(textEl);
     textEl.focus({ preventScroll: true });
     textEl.select();
     try {
         document.execCommand('copy');
         textEl.blur();
+        document.body.removeChild(textEl);
     }
     catch (err) {
         // ignore

package/lib/cjs/cloneDeep.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/cookie.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/date.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/dom.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/download.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/easing.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/file.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/func.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/index.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -131,7 +131,9 @@ exports.randomNumber = random.randomNumber;
 exports.randomString = random.randomString;
 exports.randomUuid = random.randomUuid;
 exports.HEX_POOL = number.HEX_POOL;
+exports.formatMoney = number.formatNumber;
 exports.formatNumber = number.formatNumber;
+exports.humanFileSize = number.humanFileSize;
 exports.numberAbbr = number.numberAbbr;
 exports.numberToHex = number.numberToHex;
 exports.UNIQUE_NUMBER_SAFE_LENGTH = unique.UNIQUE_NUMBER_SAFE_LENGTH;

package/lib/cjs/isEqual.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/math.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/number.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -8,6 +8,7 @@
 
 var func = require('./func.js');
 var string = require('./string.js');
+var type = require('./type.js');
 
 const HEX_POOL = `${string.STRING_ARABIC_NUMERALS}${string.STRING_UPPERCASE_ALPHA}${string.STRING_LOWERCASE_ALPHA}`;
 const supportBigInt = typeof BigInt !== 'undefined';
@@ -45,38 +46,74 @@ function numberToHex(decimal, hexPool = HEX_POOL) {
     return ret.join('');
 }
 /**
- * 缩写
+ * 将数字转换为携带单位的字符串
  * @param {number | string} num
  * @param {Array<string>} units
- * @param {number} ratio
- * @param {number} exponent
+ * @param {INumberAbbr} options default: { ratio: 1000, decimals: 0, separator: ' ' }
  * @returns {string}
  */
-const numberAbbr = (num, units, ratio = 1000, exponent) => {
+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('至少需要一个单位');
+        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(exponent);
+    const value = num2.toFixed(decimals);
     const unit = units[times];
-    return value.toString() + '' + unit;
+    return String(value) + separator + unit;
 };
+/**
+ * Converting file size in bytes to human-readable string
+ *  reference: https://zh.wikipedia.org/wiki/%E5%8D%83%E5%AD%97%E8%8A%82
+ * @param {number | string} num bytes Number in Bytes
+ * @param {IHumanFileSizeOptions} options default: { decimals = 0, si = false, separator = ' ' }
+ *        si: True to use metric (SI) units, aka powers of 1000, the units is
+ *            ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'].
+ *            False to use binary (IEC), aka powers of 1024, the units is
+ *            ['Byte', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB']
+ * @returns
+ */
+function humanFileSize(num, options) {
+    const { decimals = 0, si = false, separator = ' ', maxUnit } = options;
+    const units = si
+        ? ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB']
+        : ['Byte', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'];
+    if (!type.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 });
+}
 /**
  * 将数字格式化成千位分隔符显示的字符串
- * @param {number} val 数字
- * @param {'int' | 'float'} type 展示分段显示的类型 int:整型 | float:浮点型
+ * @param {number|string} num 数字
+ * @param {number} decimals 格式化成指定小数位精度的参数
  * @returns {string}
  */
-function formatNumber(val, type = 'int') {
-    return type === 'int' ? parseInt(String(val)).toLocaleString() : Number(val).toLocaleString('en-US');
+function formatNumber(num, decimals) {
+    if (type.isNullOrUnDef(decimals)) {
+        return parseInt(String(num)).toLocaleString();
+    }
+    let prec = 0;
+    if (!type.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');
 }
 
 exports.HEX_POOL = HEX_POOL;
+exports.formatMoney = formatNumber;
 exports.formatNumber = formatNumber;
+exports.humanFileSize = humanFileSize;
 exports.numberAbbr = numberAbbr;
 exports.numberToHex = numberToHex;

package/lib/cjs/object.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/path.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/qs.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/random.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/string.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/tooltip.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/tree.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -212,7 +212,7 @@ function flatTree(treeList, options = defaultFieldOptions) {
             ...node,
             [childField]: [] // 清空子级
         };
-        item.hasOwnProperty([childField]) && delete item[childField];
+        type.objectHas(item, childField) && delete item[childField];
         res.push(item);
         if (node[childField]) {
             const children = node[childField].map(item => ({

package/lib/cjs/type.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/unique.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/url.js

@@ -1,29 +1,39 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
+var type = require('./type.js');
 var path = require('./path.js');
 var qs = require('./qs.js');
 
-const anchorEl = document.createElement('a');
 /**
  * url 解析
  * @param {string} url
+ * @param {boolean} isModernApi 使用现代API:URL, 默认true (对无效url解析会抛错), 否则使用a标签来解析（兼容性更强）
  * @returns {Url}
  */
-const urlParse = (url) => {
-    anchorEl.href = url;
-    const { protocol, username, password, host, port, hostname, hash, search, pathname: _pathname } = anchorEl;
+const urlParse = (url, isModernApi = true) => {
+    // @ts-ignore
+    let urlObj = null;
+    if (type.isFunction(URL) && isModernApi) {
+        urlObj = new URL(url);
+    }
+    else {
+        urlObj = document.createElement('a');
+        urlObj.href = url;
+    }
+    const { protocol, username, password, host, port, hostname, hash, search, pathname: _pathname } = urlObj;
     // fix: ie 浏览器下，解析出来的 pathname 是没有 / 根的
     const pathname = path.pathJoin('/', _pathname);
     const auth = username && password ? `${username}:${password}` : '';
     const query = search.replace(/^\?/, '');
     const searchParams = qs.qsParse(query);
     const path$1 = `${pathname}${search}`;
+    urlObj = null;
     return {
         protocol,
         auth,

package/lib/cjs/validator.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/variable.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/watermark.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/cjs/we-decode.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/es/array.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/es/async.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/es/base64.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/es/clipboard.js

@@ -1,30 +1,26 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
 
-import { setStyle } from './dom.js';
-
-const textEl = document.createElement('textarea');
-setStyle(textEl, {
-    position: 'absolute',
-    top: '-9999px',
-    left: '-9999px',
-    opacity: 0
-});
-document.body.appendChild(textEl);
 /**
  * 复制文本
  * @param {string} text
  */
 function copyText(text) {
+    const textEl = document.createElement('textarea');
+    textEl.style.position = 'absolute';
+    textEl.style.top = '-9999px';
+    textEl.style.left = '-9999px';
     textEl.value = text;
+    document.body.appendChild(textEl);
     textEl.focus({ preventScroll: true });
     textEl.select();
     try {
         document.execCommand('copy');
         textEl.blur();
+        document.body.removeChild(textEl);
     }
     catch (err) {
         // ignore

package/lib/es/cloneDeep.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/es/cookie.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/es/date.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/es/dom.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/es/download.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/es/easing.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/es/file.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/es/func.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/es/index.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -21,7 +21,7 @@ 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, 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';

package/lib/es/isEqual.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/lib/es/math.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.8.4
+ * sculp-js v1.9.0
  * (c) 2023-present chandq
  * Released under the MIT License.
  */