sculp-js 1.2.1 → 1.3.1

package/lib/es/file.js

@@ -1,9 +1,18 @@
 /*!
- * sculp-js v1.2.1
- * (c) 2023-2023 chandq
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 
+import { weAtob } from './we-decode.js';
+
+/**
+ * 判断是否支持canvas
+ * @returns {boolean}
+ */
+function supportCanvas() {
+    return !!document.createElement('canvas').getContext;
+}
 /**
  * 选择本地文件
  * @param {string} accept 上传的文件类型，用于过滤
@@ -25,5 +34,118 @@ function chooseLocalFile(accept, changeCb) {
     };
     return inputObj;
 }
+/**
+ * Web端：等比例压缩图片批量处理 (size小于200KB，不压缩)
+ * @param {File | FileList} file 文件
+ * @param {ICompressOptions} options
+ * @returns {Promise<object> | undefined}
+ */
+function compressImg(file, options) {
+    console.assert(file instanceof File || file instanceof FileList, `${file} 必须是File或FileList类型`);
+    console.assert(supportCanvas(), `当前环境不支持 Canvas`);
+    let targetQuality = 0.52;
+    if (file instanceof File) {
+        const sizeKB = +parseInt((file.size / 1024).toFixed(2));
+        if (sizeKB < 1 * 1024) {
+            targetQuality = 0.85;
+        }
+        else if (sizeKB >= 1 * 1024 && sizeKB < 5 * 1024) {
+            targetQuality = 0.62;
+        }
+        else if (sizeKB >= 5 * 1024) {
+            targetQuality = 0.52;
+        }
+    }
+    if (options.quality) {
+        targetQuality = options.quality;
+    }
+    if (file instanceof FileList) {
+        return Promise.all(Array.from(file).map(el => compressImg(el, { mime: options.mime, quality: targetQuality }))); // 如果是 file 数组返回 Promise 数组
+    }
+    else if (file instanceof File) {
+        return new Promise(resolve => {
+            const sizeKB = +parseInt((file.size / 1024).toFixed(2));
+            if (+(file.size / 1024).toFixed(2) < 200) {
+                resolve({
+                    file: file
+                });
+            }
+            else {
+                const reader = new FileReader(); // 创建 FileReader
+                // @ts-ignore
+                reader.onload = ({ target: { result: src } }) => {
+                    const image = new Image(); // 创建 img 元素
+                    image.onload = () => {
+                        const canvas = document.createElement('canvas'); // 创建 canvas 元素
+                        const context = canvas.getContext('2d');
+                        let targetWidth = image.width;
+                        let targetHeight = image.height;
+                        const originWidth = image.width;
+                        const originHeight = image.height;
+                        if (1 * 1024 <= sizeKB && sizeKB < 10 * 1024) {
+                            const maxWidth = 1600, maxHeight = 1600;
+                            targetWidth = originWidth;
+                            targetHeight = originHeight;
+                            // 图片尺寸超过的限制
+                            if (originWidth > maxWidth || originHeight > maxHeight) {
+                                if (originWidth / originHeight > maxWidth / maxHeight) {
+                                    // 更宽，按照宽度限定尺寸
+                                    targetWidth = maxWidth;
+                                    targetHeight = Math.round(maxWidth * (originHeight / originWidth));
+                                }
+                                else {
+                                    targetHeight = maxHeight;
+                                    targetWidth = Math.round(maxHeight * (originWidth / originHeight));
+                                }
+                            }
+                        }
+                        if (10 * 1024 <= sizeKB && sizeKB <= 20 * 1024) {
+                            const maxWidth = 1400, maxHeight = 1400;
+                            targetWidth = originWidth;
+                            targetHeight = originHeight;
+                            // 图片尺寸超过的限制
+                            if (originWidth > maxWidth || originHeight > maxHeight) {
+                                if (originWidth / originHeight > maxWidth / maxHeight) {
+                                    // 更宽，按照宽度限定尺寸
+                                    targetWidth = maxWidth;
+                                    targetHeight = Math.round(maxWidth * (originHeight / originWidth));
+                                }
+                                else {
+                                    targetHeight = maxHeight;
+                                    targetWidth = Math.round(maxHeight * (originWidth / originHeight));
+                                }
+                            }
+                        }
+                        canvas.width = targetWidth;
+                        canvas.height = targetHeight;
+                        context.clearRect(0, 0, targetWidth, targetHeight);
+                        context.drawImage(image, 0, 0, targetWidth, targetHeight); // 绘制 canvas
+                        const canvasURL = canvas.toDataURL(options.mime, targetQuality);
+                        const buffer = weAtob(canvasURL.split(',')[1]);
+                        let length = buffer.length;
+                        const bufferArray = new Uint8Array(new ArrayBuffer(length));
+                        while (length--) {
+                            bufferArray[length] = buffer.charCodeAt(length);
+                        }
+                        const miniFile = new File([bufferArray], file.name, {
+                            type: options.mime
+                        });
+                        resolve({
+                            file: miniFile,
+                            bufferArray,
+                            origin: file,
+                            beforeSrc: src,
+                            afterSrc: canvasURL,
+                            beforeKB: Number((file.size / 1024).toFixed(2)),
+                            afterKB: Number((miniFile.size / 1024).toFixed(2))
+                        });
+                    };
+                    image.src = src;
+                };
+                reader.readAsDataURL(file);
+            }
+        });
+    }
+}
 
-export { chooseLocalFile };
+export { chooseLocalFile, compressImg, supportCanvas };

package/lib/es/func.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.2.1
- * (c) 2023-2023 chandq
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 

package/lib/es/index.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.2.1
- * (c) 2023-2023 chandq
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 
@@ -14,10 +14,10 @@ export { cloneDeep, isPlainObject, objectAssign, objectEach, objectEachAsync, ob
 export { pathJoin, pathNormalize } from './path.js';
 export { qsParse, qsStringify } from './qs.js';
 export { STRING_ARABIC_NUMERALS, STRING_LOWERCASE_ALPHA, STRING_UPPERCASE_ALPHA, getStrWidthPx, stringAssign, stringCamelCase, stringEscapeHtml, stringFill, stringFormat, stringKebabCase } from './string.js';
-export { isArray, isBigInt, isBoolean, isDate, isError, isFunction, isNaN, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, typeIs } from './type.js';
+export { isArray, isBigInt, isBoolean, isDate, isError, isFunction, isNaN, isNull, isNullOrUnDef, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, typeIs } from './type.js';
 export { urlDelParams, urlParse, urlSetParams, urlStringify } from './url.js';
 export { asyncMap, wait } from './async.js';
-export { chooseLocalFile } from './file.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';
@@ -25,3 +25,4 @@ export { HEX_POOL, formatNumber, numberAbbr, numberToHex } from './number.js';
 export { UNIQUE_NUMBER_SAFE_LENGTH, uniqueNumber, uniqueString } from './unique.js';
 export { tooltipEvent } from './tooltip.js';
 export { buildTree, forEachDeep, forEachMap, formatTree, searchTreeById } from './tree.js';
+export { weAppJwtDecode, weAtob, weBtoa } from './we-decode.js';

package/lib/es/number.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.2.1
- * (c) 2023-2023 chandq
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 

package/lib/es/object.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.2.1
- * (c) 2023-2023 chandq
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 

package/lib/es/path.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.2.1
- * (c) 2023-2023 chandq
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 

package/lib/es/qs.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.2.1
- * (c) 2023-2023 chandq
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 

package/lib/es/random.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.2.1
- * (c) 2023-2023 chandq
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 

package/lib/es/string.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.2.1
- * (c) 2023-2023 chandq
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 

package/lib/es/tooltip.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.2.1
- * (c) 2023-2023 chandq
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 

package/lib/es/tree.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.2.1
- * (c) 2023-2023 chandq
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 
@@ -14,8 +14,8 @@ const defaultFieldOptions = { keyField: 'key', childField: 'children', pidField:
  * @returns {*}
  */
 function forEachDeep(tree, iterator, children = 'children', isReverse = false) {
-    let level = 0, isBreak = false;
-    const walk = (arr, parent) => {
+    let isBreak = false;
+    const walk = (arr, parent, level = 0) => {
         if (isReverse) {
             for (let i = arr.length - 1; i >= 0; i--) {
                 if (isBreak) {
@@ -31,9 +31,8 @@ function forEachDeep(tree, iterator, children = 'children', isReverse = false) {
                 }
                 // @ts-ignore
                 if (arr[i] && Array.isArray(arr[i][children])) {
-                    ++level;
                     // @ts-ignore
-                    walk(arr[i][children], arr[i]);
+                    walk(arr[i][children], arr[i], level + 1);
                 }
             }
         }
@@ -52,9 +51,8 @@ function forEachDeep(tree, iterator, children = 'children', isReverse = false) {
                 }
                 // @ts-ignore
                 if (arr[i] && Array.isArray(arr[i][children])) {
-                    ++level;
                     // @ts-ignore
-                    walk(arr[i][children], arr[i]);
+                    walk(arr[i][children], arr[i], level + 1);
                 }
             }
         }

package/lib/es/type.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.2.1
- * (c) 2023-2023 chandq
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 
@@ -19,6 +19,9 @@ const isNumber = (any) => typeof any === 'number' && !Number.isNaN(any);
 const isUndefined = (any) => typeof any === 'undefined';
 const isNull = (any) => any === null;
 const isPrimitive = (any) => any === null || typeof any !== 'object';
+function isNullOrUnDef(val) {
+    return isUndefined(val) || isNull(val);
+}
 // 复合数据类型判断
 const isObject = (any) => typeIs(any) === 'Object';
 const isArray = (any) => Array.isArray(any);
@@ -34,4 +37,4 @@ const isDate = (any) => typeIs(any) === 'Date';
 const isError = (any) => typeIs(any) === 'Error';
 const isRegExp = (any) => typeIs(any) === 'RegExp';
 
-export { typeIs as default, isArray, isBigInt, isBoolean, isDate, isError, isFunction, isNaN, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, typeIs };
+export { typeIs as default, isArray, isBigInt, isBoolean, isDate, isError, isFunction, isNaN, isNull, isNullOrUnDef, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, typeIs };

package/lib/es/unique.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.2.1
- * (c) 2023-2023 chandq
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 

package/lib/es/url.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.2.1
- * (c) 2023-2023 chandq
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 

package/lib/es/watermark.js

@@ -1,6 +1,6 @@
 /*!
- * sculp-js v1.2.1
- * (c) 2023-2023 chandq
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
  * Released under the MIT License.
  */
 

package/lib/es/we-decode.js

@@ -0,0 +1,103 @@
+/*!
+ * sculp-js v1.3.0
+ * (c) 2023-2024 chandq
+ * Released under the MIT License.
+ */
+
+const b64 = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=';
+// eslint-disable-next-line
+const b64re = /^(?:[A-Za-z\d+\/]{4})*?(?:[A-Za-z\d+\/]{2}(?:==)?|[A-Za-z\d+\/]{3}=?)?$/;
+/**
+ * 字符串编码成Base64 （适用于任何环境，包括小程序）
+ * @param {string} string
+ * @return {string}
+ */
+function weBtoa(string) {
+    // 同window.btoa: 字符串编码成Base64
+    string = String(string);
+    let bitmap, a, b, c, result = '', i = 0;
+    const rest = string.length % 3;
+    for (; i < string.length;) {
+        if ((a = string.charCodeAt(i++)) > 255 || (b = string.charCodeAt(i++)) > 255 || (c = string.charCodeAt(i++)) > 255)
+            throw new TypeError("Failed to execute 'btoa' on 'Window': The string to be encoded contains characters outside of the Latin1 range.");
+        bitmap = (a << 16) | (b << 8) | c;
+        result +=
+            b64.charAt((bitmap >> 18) & 63) +
+                b64.charAt((bitmap >> 12) & 63) +
+                b64.charAt((bitmap >> 6) & 63) +
+                b64.charAt(bitmap & 63);
+    }
+    return rest ? result.slice(0, rest - 3) + '==='.substring(rest) : result;
+}
+/**
+ * Base64解码为原始字符串（适用于任何环境，包括小程序）
+ * @param {string} string
+ * @return {string}
+ */
+function weAtob(string) {
+    // 同window.atob: Base64解码为原始字符串
+    string = String(string).replace(/[\t\n\f\r ]+/g, '');
+    if (!b64re.test(string))
+        throw new TypeError("Failed to execute 'atob' on 'Window': The string to be decoded is not correctly encoded.");
+    string += '=='.slice(2 - (string.length & 3));
+    let bitmap, result = '', r1, r2, i = 0;
+    for (; i < string.length;) {
+        bitmap =
+            (b64.indexOf(string.charAt(i++)) << 18) |
+                (b64.indexOf(string.charAt(i++)) << 12) |
+                ((r1 = b64.indexOf(string.charAt(i++))) << 6) |
+                (r2 = b64.indexOf(string.charAt(i++)));
+        result +=
+            r1 === 64
+                ? String.fromCharCode((bitmap >> 16) & 255)
+                : r2 === 64
+                    ? String.fromCharCode((bitmap >> 16) & 255, (bitmap >> 8) & 255)
+                    : String.fromCharCode((bitmap >> 16) & 255, (bitmap >> 8) & 255, bitmap & 255);
+    }
+    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);
+    }
+}
+
+export { weAppJwtDecode, weAtob, weBtoa };

package/lib/index.d.ts

@@ -23,6 +23,7 @@ declare const isNumber: (any: unknown) => any is number;
 declare const isUndefined: (any: unknown) => any is undefined;
 declare const isNull: (any: unknown) => any is null;
 declare const isPrimitive: (any: unknown) => boolean;
+declare function isNullOrUnDef(val: unknown): val is null | undefined;
 declare const isObject: (any: unknown) => any is Record<string, unknown>;
 declare const isArray: (any: unknown) => any is unknown[];
 /**
@@ -504,6 +505,11 @@ declare function wait(timeout?: number): Promise<void>;
  */
 declare function asyncMap<T, R>(list: Array<T>, mapper: (val: T, idx: number, list: Array<T>) => Promise<R>, concurrency?: number): Promise<R[]>;
 
+/**
+ * 判断是否支持canvas
+ * @returns {boolean}
+ */
+declare function supportCanvas(): boolean;
 /**
  * 选择本地文件
  * @param {string} accept 上传的文件类型，用于过滤
@@ -511,6 +517,20 @@ declare function asyncMap<T, R>(list: Array<T>, mapper: (val: T, idx: number, li
  * @returns {HTMLInputElement}
  */
 declare function chooseLocalFile(accept: string, changeCb: (FileList: any) => any): HTMLInputElement;
+type ImageType = 'image/jpeg' | 'image/png' | 'image/webp';
+interface ICompressOptions {
+    /** 压缩质量 0 ~ 1 之间*/
+    quality?: number;
+    /** 图片类型 */
+    mime?: ImageType;
+}
+/**
+ * Web端：等比例压缩图片批量处理 (size小于200KB，不压缩)
+ * @param {File | FileList} file 文件
+ * @param {ICompressOptions} options
+ * @returns {Promise<object> | undefined}
+ */
+declare function compressImg(file: File | FileList, options: ICompressOptions): Promise<object> | undefined;
 
 interface ICanvasWM {
     container: HTMLElement;
@@ -767,4 +787,18 @@ declare function buildTree<ID extends string, PID extends string, T extends {
  */
 declare function formatTree(list: any[], options?: IFieldOptions): any[];
 
-export { type AnyArray, type AnyFunc, type AnyObject, type ArrayElements, type DateObj, type DateValue, type DebounceFunc, type FileType, HEX_POOL, type ICanvasWM, type IFieldOptions, type ITreeConf, type IdLike, type LooseParamValue, type LooseParams, type ObjectAssignItem, type OnceFunc, type Params, type PartialDeep, type RandomString, type ReadyCallback, type Replacer, STRING_ARABIC_NUMERALS, STRING_LOWERCASE_ALPHA, STRING_POOL, STRING_UPPERCASE_ALPHA, type SetStyle, type SmoothScrollOptions, type Style, type ThrottleFunc, UNIQUE_NUMBER_SAFE_LENGTH, type UniqueString, type Url, type WithChildren, addClass, arrayEach, arrayEachAsync, arrayInsertBefore, arrayLike, arrayRemove, asyncMap, buildTree, calculateDate, calculateDateTime, chooseLocalFile, cloneDeep, cookieDel, cookieGet, cookieSet, copyText, dateParse, dateToEnd, dateToStart, debounce, downloadBlob, downloadData, downloadHref, downloadURL, forEachDeep, forEachMap, formatDate, formatNumber, formatTree, genCanvasWM, getComputedCssVal, getGlobal, getStrWidthPx, getStyle, hasClass, isArray, isBigInt, isBoolean, isDate, isDomReady, isError, isFunction, isNaN, isNull, isNumber, isObject, isPlainObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, isValidDate, numberAbbr, numberToHex, objectAssign, objectEach, objectEachAsync, objectFill, objectGet, objectHas, objectMap, objectAssign as objectMerge, objectOmit, objectPick, onDomReady, once, pathJoin, pathNormalize, qsParse, qsStringify, randomNumber, randomString, randomUuid, removeClass, searchTreeById, setGlobal, setStyle, smoothScroll, stringAssign, stringCamelCase, stringEscapeHtml, stringFill, stringFormat, stringKebabCase, throttle, tooltipEvent, typeIs, uniqueNumber, uniqueString, urlDelParams, urlParse, urlSetParams, urlStringify, wait };
+/**
+ * 字符串编码成Base64 （适用于任何环境，包括小程序）
+ * @param {string} string
+ * @return {string}
+ */
+declare function weBtoa(string: string): string;
+/**
+ * Base64解码为原始字符串（适用于任何环境，包括小程序）
+ * @param {string} string
+ * @return {string}
+ */
+declare function weAtob(string: string): string;
+declare function weAppJwtDecode(token: any, options: any): any;
+
+export { type AnyArray, type AnyFunc, type AnyObject, type ArrayElements, type DateObj, type DateValue, type DebounceFunc, type FileType, HEX_POOL, type ICanvasWM, type ICompressOptions, type IFieldOptions, type ITreeConf, type IdLike, type LooseParamValue, type LooseParams, type ObjectAssignItem, type OnceFunc, type Params, type PartialDeep, type RandomString, type ReadyCallback, type Replacer, STRING_ARABIC_NUMERALS, STRING_LOWERCASE_ALPHA, STRING_POOL, STRING_UPPERCASE_ALPHA, type SetStyle, type SmoothScrollOptions, type Style, type ThrottleFunc, UNIQUE_NUMBER_SAFE_LENGTH, type UniqueString, type Url, type WithChildren, addClass, arrayEach, arrayEachAsync, arrayInsertBefore, arrayLike, arrayRemove, asyncMap, buildTree, calculateDate, calculateDateTime, chooseLocalFile, cloneDeep, compressImg, cookieDel, cookieGet, cookieSet, copyText, dateParse, dateToEnd, dateToStart, debounce, downloadBlob, downloadData, downloadHref, downloadURL, forEachDeep, forEachMap, formatDate, formatNumber, formatTree, genCanvasWM, getComputedCssVal, getGlobal, getStrWidthPx, getStyle, hasClass, isArray, isBigInt, isBoolean, isDate, isDomReady, isError, isFunction, isNaN, isNull, isNullOrUnDef, isNumber, isObject, isPlainObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, isValidDate, numberAbbr, numberToHex, objectAssign, objectEach, objectEachAsync, objectFill, objectGet, objectHas, objectMap, objectAssign as objectMerge, objectOmit, objectPick, onDomReady, once, pathJoin, pathNormalize, qsParse, qsStringify, randomNumber, randomString, randomUuid, removeClass, searchTreeById, setGlobal, setStyle, smoothScroll, stringAssign, stringCamelCase, stringEscapeHtml, stringFill, stringFormat, stringKebabCase, supportCanvas, throttle, tooltipEvent, typeIs, uniqueNumber, uniqueString, urlDelParams, urlParse, urlSetParams, urlStringify, wait, weAppJwtDecode, weAtob, weBtoa };