sculp-js 1.4.0 → 1.5.0

package/README.md

@@ -20,9 +20,18 @@
   - isNumber
   - isUndefined
   - isNull
+  - isNullOrUnDef
   - isPrimitive
+  - isFunction
   - isObject
+  - isArray
   - typeIs
+  - isJsonString
+
+- encode/decode
+
+  - weAtob
+  - weBtoa
 
 - Array
 
@@ -35,6 +44,7 @@
   - forEachMap 高性能的深度优先遍历的Map函数, 支持continue、break，可定制id、children
   - searchTreeById 在树中找到 id 为某个值的节点，并返回上游的所有父级节点
   - formatTree 高性能的数组转树函数
+  - flatTree 树转数组
   - fuzzySearchTree 模糊搜索函数，返回包含搜索字符的节点及其祖先节点的树
 
 - Object
@@ -54,7 +64,7 @@
 
   - stringCamelCase
   - stringKebabCase
-  - getStrWidthPx (web)
+  - parseQueryParams
 
 - Unique
 
@@ -89,6 +99,7 @@
   - setStyle
   - getStyle
   - getComputedCssVal
+  - getStrWidthPx
 
 - Watermark (web)
 

package/lib/cjs/array.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/async.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/clipboard.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/cookie.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/date.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/dom.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
@@ -154,9 +154,40 @@ function getComputedCssVal(el, property, reNumber = true) {
     const originVal = getComputedStyle(el).getPropertyValue(property) ?? '';
     return reNumber ? Number(originVal.replace(/([0-9]*)(.*)/g, '$1')) : originVal;
 }
+/**
+ * 字符串的像素宽度
+ * @param {string} str 目标字符串
+ * @param {number} fontSize 字符串字体大小
+ * @param {boolean} isRemoveDom 计算后是否移除中间dom元素
+ * @returns {*}
+ */
+function getStrWidthPx(str, fontSize = 14, isRemoveDom = false) {
+    let strWidth = 0;
+    console.assert(type.isString(str), `${str} 不是有效的字符串`);
+    if (type.isString(str) && str.length > 0) {
+        let getEle = document.querySelector('#getStrWidth1494304949567');
+        if (!getEle) {
+            const _ele = document.createElement('span');
+            _ele.id = 'getStrWidth1494304949567';
+            _ele.style.fontSize = fontSize + 'px';
+            _ele.style.whiteSpace = 'nowrap';
+            _ele.style.visibility = 'hidden';
+            _ele.textContent = str;
+            document.body.appendChild(_ele);
+            getEle = _ele;
+        }
+        getEle.textContent = str;
+        strWidth = getEle.offsetWidth;
+        if (isRemoveDom) {
+            document.body.appendChild(getEle);
+        }
+    }
+    return strWidth;
+}
 
 exports.addClass = addClass;
 exports.getComputedCssVal = getComputedCssVal;
+exports.getStrWidthPx = getStrWidthPx;
 exports.getStyle = getStyle;
 exports.hasClass = hasClass;
 exports.isDomReady = isDomReady;

package/lib/cjs/download.js

@@ -1,11 +1,12 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
+var type = require('./type.js');
 var url = require('./url.js');
 
 /**
@@ -20,25 +21,53 @@ function downloadURL(url$1, params) {
  * 通过 A 链接的方式下载
  * @param {string} href
  * @param {string} filename
+ * @param {Function} callback
  */
-function downloadHref(href, filename) {
+function downloadHref(href, filename, callback) {
     const eleLink = document.createElement('a');
     eleLink.download = filename;
     eleLink.style.display = 'none';
     eleLink.href = href;
     document.body.appendChild(eleLink);
     eleLink.click();
-    setTimeout(() => document.body.removeChild(eleLink));
+    setTimeout(() => {
+        document.body.removeChild(eleLink);
+        if (type.isFunction(callback)) {
+            callback();
+        }
+    });
 }
 /**
  * 将大文件对象通过 A 链接的方式下载
  * @param {Blob} blob
  * @param {string} filename
+ * @param {Function} callback
  */
-function downloadBlob(blob, filename) {
+function downloadBlob(blob, filename, callback) {
     const objURL = URL.createObjectURL(blob);
     downloadHref(objURL, filename);
-    setTimeout(() => URL.revokeObjectURL(objURL));
+    setTimeout(() => {
+        URL.revokeObjectURL(objURL);
+        if (type.isFunction(callback)) {
+            callback();
+        }
+    });
+}
+/**
+ * 根据URL下载文件（解决跨域a.download不生效问题)
+ * @param {string} url
+ * @param {string} filename
+ * @param {Function} callback
+ */
+function crossDomainDownload(url, filename, callback) {
+    const xhr = new XMLHttpRequest();
+    xhr.open('GET', url, true);
+    xhr.responseType = 'blob';
+    xhr.onload = function () {
+        if (xhr.status === 200)
+            downloadBlob(xhr.response, filename, callback);
+    };
+    xhr.send();
 }
 /**
  * 将指定数据格式通过 A 链接的方式下载
@@ -76,6 +105,7 @@ function downloadData(data, fileType, filename, headers) {
     }
 }
 
+exports.crossDomainDownload = crossDomainDownload;
 exports.downloadBlob = downloadBlob;
 exports.downloadData = downloadData;
 exports.downloadHref = downloadHref;

package/lib/cjs/easing.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/file.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/func.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/index.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
@@ -49,6 +49,7 @@ exports.formatDate = date.formatDate;
 exports.isValidDate = date.isValidDate;
 exports.addClass = dom.addClass;
 exports.getComputedCssVal = dom.getComputedCssVal;
+exports.getStrWidthPx = dom.getStrWidthPx;
 exports.getStyle = dom.getStyle;
 exports.hasClass = dom.hasClass;
 exports.isDomReady = dom.isDomReady;
@@ -56,6 +57,7 @@ exports.onDomReady = dom.onDomReady;
 exports.removeClass = dom.removeClass;
 exports.setStyle = dom.setStyle;
 exports.smoothScroll = dom.smoothScroll;
+exports.crossDomainDownload = download.crossDomainDownload;
 exports.downloadBlob = download.downloadBlob;
 exports.downloadData = download.downloadData;
 exports.downloadHref = download.downloadHref;
@@ -79,7 +81,7 @@ exports.qsStringify = qs.qsStringify;
 exports.STRING_ARABIC_NUMERALS = string.STRING_ARABIC_NUMERALS;
 exports.STRING_LOWERCASE_ALPHA = string.STRING_LOWERCASE_ALPHA;
 exports.STRING_UPPERCASE_ALPHA = string.STRING_UPPERCASE_ALPHA;
-exports.getStrWidthPx = string.getStrWidthPx;
+exports.parseQueryParams = string.parseQueryParams;
 exports.stringAssign = string.stringAssign;
 exports.stringCamelCase = string.stringCamelCase;
 exports.stringEscapeHtml = string.stringEscapeHtml;
@@ -92,6 +94,7 @@ exports.isBoolean = type.isBoolean;
 exports.isDate = type.isDate;
 exports.isError = type.isError;
 exports.isFunction = type.isFunction;
+exports.isJsonString = type.isJsonString;
 exports.isNaN = type.isNaN;
 exports.isNull = type.isNull;
 exports.isNullOrUnDef = type.isNullOrUnDef;
@@ -137,6 +140,5 @@ exports.forEachMap = tree.forEachMap;
 exports.formatTree = tree.formatTree;
 exports.fuzzySearchTree = tree.fuzzySearchTree;
 exports.searchTreeById = tree.searchTreeById;
-exports.weAppJwtDecode = weDecode.weAppJwtDecode;
 exports.weAtob = weDecode.weAtob;
 exports.weBtoa = weDecode.weBtoa;

package/lib/cjs/number.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/object.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/path.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/qs.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/random.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/string.js

@@ -1,13 +1,11 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-var type = require('./type.js');
-
 /**
  * 将字符串转换为驼峰格式
  * @param {string} string
@@ -125,40 +123,30 @@ const stringEscapeHtml = (html) => {
  */
 const stringFill = (length, value = ' ') => new Array(length).fill(value).join('');
 /**
- * 字符串的像素宽度
- * @param {string} str 目标字符串
- * @param {number} fontSize 字符串字体大小
- * @param {boolean} isRemoveDom 计算后是否移除中间dom元素
- * @returns {*}
+ * 解析URL查询参数
+ * @param {string} searchStr
+ * @return {Record<string, string | string[]>}
  */
-function getStrWidthPx(str, fontSize = 14, isRemoveDom = false) {
-    let strWidth = 0;
-    console.assert(type.isString(str), `${str} 不是有效的字符串`);
-    if (type.isString(str) && str.length > 0) {
-        let getEle = document.querySelector('#getStrWidth1494304949567');
-        if (!getEle) {
-            const _ele = document.createElement('span');
-            _ele.id = 'getStrWidth1494304949567';
-            _ele.style.fontSize = fontSize + 'px';
-            _ele.style.whiteSpace = 'nowrap';
-            _ele.style.visibility = 'hidden';
-            _ele.textContent = str;
-            document.body.appendChild(_ele);
-            getEle = _ele;
+function parseQueryParams(searchStr = location.search) {
+    const queryObj = {};
+    Array.from(searchStr.matchAll(/[&?]?([^=&]+)=?([^=&]*)/g)).forEach((item, i) => {
+        if (!queryObj[item[1]]) {
+            queryObj[item[1]] = item[2];
         }
-        getEle.textContent = str;
-        strWidth = getEle.offsetWidth;
-        if (isRemoveDom) {
-            document.body.appendChild(getEle);
+        else if (typeof queryObj[item[1]] === 'string') {
+            queryObj[item[1]] = [queryObj[item[1]], item[2]];
         }
-    }
-    return strWidth;
+        else {
+            queryObj[item[1]].push(item[2]);
+        }
+    });
+    return queryObj;
 }
 
 exports.STRING_ARABIC_NUMERALS = STRING_ARABIC_NUMERALS;
 exports.STRING_LOWERCASE_ALPHA = STRING_LOWERCASE_ALPHA;
 exports.STRING_UPPERCASE_ALPHA = STRING_UPPERCASE_ALPHA;
-exports.getStrWidthPx = getStrWidthPx;
+exports.parseQueryParams = parseQueryParams;
 exports.stringAssign = stringAssign;
 exports.stringCamelCase = stringCamelCase;
 exports.stringEscapeHtml = stringEscapeHtml;

package/lib/cjs/tooltip.js

@@ -1,12 +1,12 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
-var string = require('./string.js');
+var dom = require('./dom.js');
 
 /**
  * @title tooltip
@@ -79,10 +79,10 @@ function mouseenter($customTitle, title, e) {
     let x = 13;
     const y = 23;
     const $contentEle = $customTitle.children[0];
-    if (string.getStrWidthPx(title, 12) < 180 + 50) {
+    if (dom.getStrWidthPx(title, 12) < 180 + 50) {
         //【弹出div自适应字符串宽度】若显示的字符串占用宽度小于180，则设置弹出div的宽度为“符串占用宽度”+20
-        $contentEle.style.maxWidth = string.getStrWidthPx(title, 12) + 20 + 50 + 'px';
-        diffValueX = e.clientX + (string.getStrWidthPx(title, 12) + 50) - document.body.offsetWidth;
+        $contentEle.style.maxWidth = dom.getStrWidthPx(title, 12) + 20 + 50 + 'px';
+        diffValueX = e.clientX + (dom.getStrWidthPx(title, 12) + 50) - document.body.offsetWidth;
     }
     else {
         $contentEle.style.maxWidth = '250px';

package/lib/cjs/tree.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/type.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
@@ -40,6 +40,20 @@ const isNaN = (any) => Number.isNaN(any);
 const isDate = (any) => typeIs(any) === 'Date';
 const isError = (any) => typeIs(any) === 'Error';
 const isRegExp = (any) => typeIs(any) === 'RegExp';
+/**
+ * 判断一个字符串是否为有效的 JSON, 若有效则返回有效的JSON对象，否则false
+ * @param {string} str
+ * @return {Object | boolean}
+ */
+function isJsonString(str) {
+    try {
+        const parsed = JSON.parse(str);
+        return typeof parsed === 'object' && parsed !== null ? parsed : false;
+    }
+    catch (e) {
+        return false;
+    }
+}
 
 exports.default = typeIs;
 exports.isArray = isArray;
@@ -48,6 +62,7 @@ exports.isBoolean = isBoolean;
 exports.isDate = isDate;
 exports.isError = isError;
 exports.isFunction = isFunction;
+exports.isJsonString = isJsonString;
 exports.isNaN = isNaN;
 exports.isNull = isNull;
 exports.isNullOrUnDef = isNullOrUnDef;

package/lib/cjs/unique.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/url.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/watermark.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/cjs/we-decode.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
@@ -58,50 +58,49 @@ function weAtob(string) {
     }
     return result;
 }
-function b64DecodeUnicode(str) {
-    return decodeURIComponent(exports.weAtob(str).replace(/(.)/g, function (p) {
-        let code = p.charCodeAt(0).toString(16).toUpperCase();
-        if (code.length < 2) {
-            code = '0' + code;
-        }
-        return '%' + code;
-    }));
-}
-function base64_url_decode(str) {
-    let output = str.replace(/-/g, '+').replace(/_/g, '/');
-    switch (output.length % 4) {
-        case 0:
-            break;
-        case 2:
-            output += '==';
-            break;
-        case 3:
-            output += '=';
-            break;
-        default:
-            throw new Error('Illegal base64url string!');
-    }
-    try {
-        return b64DecodeUnicode(output);
-    }
-    catch (err) {
-        return exports.weAtob(output);
-    }
-}
-function weAppJwtDecode(token, options) {
-    if (typeof token !== 'string') {
-        throw new Error('Invalid token specified');
-    }
-    options = options || {};
-    const pos = options.header === true ? 0 : 1;
-    try {
-        return JSON.parse(base64_url_decode(token.split('.')[pos]));
-    }
-    catch (e) {
-        throw new Error('Invalid token specified: ' + e.message);
-    }
-}
+// function b64DecodeUnicode(str) {
+//   return decodeURIComponent(
+//     exports.weAtob(str).replace(/(.)/g, function (p) {
+//       let code = p.charCodeAt(0).toString(16).toUpperCase();
+//       if (code.length < 2) {
+//         code = '0' + code;
+//       }
+//       return '%' + code;
+//     })
+//   );
+// }
+// function base64_url_decode(str) {
+//   let output = str.replace(/-/g, '+').replace(/_/g, '/');
+//   switch (output.length % 4) {
+//     case 0:
+//       break;
+//     case 2:
+//       output += '==';
+//       break;
+//     case 3:
+//       output += '=';
+//       break;
+//     default:
+//       throw new Error('Illegal base64url string!');
+//   }
+//   try {
+//     return b64DecodeUnicode(output);
+//   } catch (err) {
+//     return exports.weAtob(output);
+//   }
+// }
+// export function weAppJwtDecode(token, options) {
+//   if (typeof token !== 'string') {
+//     throw new Error('Invalid token specified');
+//   }
+//   options = options || {};
+//   const pos = options.header === true ? 0 : 1;
+//   try {
+//     return JSON.parse(base64_url_decode(token.split('.')[pos]));
+//   } catch (e) {
+//     throw new Error('Invalid token specified: ' + (e as Error).message);
+//   }
+// }
 
-exports.weAppJwtDecode = weAppJwtDecode;
 exports.weAtob = weAtob;
 exports.weBtoa = weBtoa;

package/lib/es/array.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/es/async.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/es/clipboard.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/es/cookie.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */

package/lib/es/date.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.4.0
+ * sculp-js v1.4.1
  * (c) 2023-2024 chandq
  * Released under the MIT License.
  */