sculp-js 0.0.1 → 0.1.1

package/lib/cjs/random.js

@@ -0,0 +1,72 @@
+/*!
+ * sculp-js v0.1.0
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+'use strict';
+
+var string = require('./string.js');
+var type = require('./type.js');
+
+/**
+ * 随机整数
+ * @param {number} min
+ * @param {number} max
+ * @returns {number}
+ */
+const randomNumber = (min, max) => Math.floor(Math.random() * (max - min + 1) + min);
+const STRING_POOL = `${string.STRING_ARABIC_NUMERALS}${string.STRING_UPPERCASE_ALPHA}${string.STRING_LOWERCASE_ALPHA}`;
+/**
+ * 随机字符串
+ * @param {number | string} length
+ * @param {string} pool
+ * @returns {string}
+ */
+const randomString = (length, pool) => {
+    let _length = 0;
+    let _pool = STRING_POOL;
+    if (type.isString(pool)) {
+        _length = length;
+        _pool = pool;
+    }
+    else if (type.isNumber(length)) {
+        _length = length;
+    }
+    else if (type.isString(length)) {
+        _pool = length;
+    }
+    let times = Math.max(_length, 1);
+    let result = '';
+    const min = 0;
+    const max = _pool.length - 1;
+    if (max < 2)
+        throw new Error('字符串池长度不能少于 2');
+    while (times--) {
+        const index = randomNumber(min, max);
+        result += _pool[index];
+    }
+    return result;
+};
+/**
+ * 优先浏览器原生能力获取 UUID v4
+ * @returns {string}
+ */
+function randomUuid() {
+    if (typeof URL === 'undefined' || !URL.createObjectURL || typeof Blob === 'undefined') {
+        const hex = '0123456789abcdef';
+        const model = 'xxxxxxxx-xxxx-4xxx-xxxx-xxxxxxxxxxxx';
+        let str = '';
+        for (let i = 0; i < model.length; i++) {
+            const rnd = randomNumber(0, 15);
+            str += model[i] == '-' || model[i] == '4' ? model[i] : hex[rnd];
+        }
+        return str;
+    }
+    return /[^/]+$/.exec(URL.createObjectURL(new Blob()).slice())[0];
+}
+
+exports.STRING_POOL = STRING_POOL;
+exports.randomNumber = randomNumber;
+exports.randomString = randomString;
+exports.randomUuid = randomUuid;

package/lib/cjs/string.js

@@ -1,11 +1,13 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */
 
 'use strict';
 
+var type = require('./type.js');
+
 /**
  * 将字符串转换为驼峰格式
  * @param {string} string
@@ -122,10 +124,41 @@ const stringEscapeHtml = (html) => {
  * @returns {string}
  */
 const stringFill = (length, value = ' ') => new Array(length).fill(value).join('');
+/**
+ * 字符串的像素宽度
+ * @param {string} str 目标字符串
+ * @param {number} fontSize 字符串字体大小
+ * @param {boolean} isRemoveDom 计算后是否移除中间dom元素
+ * @return {*}
+ */
+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.STRING_ARABIC_NUMERALS = STRING_ARABIC_NUMERALS;
 exports.STRING_LOWERCASE_ALPHA = STRING_LOWERCASE_ALPHA;
 exports.STRING_UPPERCASE_ALPHA = STRING_UPPERCASE_ALPHA;
+exports.getStrWidthPx = getStrWidthPx;
 exports.stringAssign = stringAssign;
 exports.stringCamelCase = stringCamelCase;
 exports.stringEscapeHtml = stringEscapeHtml;

package/lib/cjs/type.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */
@@ -45,3 +45,4 @@ exports.isRegExp = isRegExp;
 exports.isString = isString;
 exports.isSymbol = isSymbol;
 exports.isUndefined = isUndefined;
+exports.typeIs = typeIs;

package/lib/cjs/unique.js

@@ -0,0 +1,83 @@
+/*!
+ * sculp-js v0.1.0
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+'use strict';
+
+var number = require('./number.js');
+var random = require('./random.js');
+var type = require('./type.js');
+
+const padStartWithZero = (str, maxLength = 2) => String(str).padStart(maxLength, '0');
+let safeNo = 0;
+let lastTimestamp = 0;
+// 安全后缀长度，按 1 毫秒运算 99999 次 JS 代码来进行估算
+// 那么，补足长度为 5
+// 时间戳模式长度为 13
+// 取最长 5 + 13 = 18
+const UNIQUE_NUMBER_SAFE_LENGTH = 18;
+const FIX_SAFE_LENGTH = 5;
+const TIMESTAMP_LENGTH = 13;
+/**
+ * 生成唯一不重复数值
+ * @param {number} length
+ * @returns {string}
+ */
+const uniqueNumber = (length = UNIQUE_NUMBER_SAFE_LENGTH) => {
+    const now = Date.now();
+    length = Math.max(length, UNIQUE_NUMBER_SAFE_LENGTH);
+    if (now !== lastTimestamp) {
+        lastTimestamp = now;
+        safeNo = 0;
+    }
+    const timestamp = `${now}`;
+    let random$1 = '';
+    const rndLength = length - FIX_SAFE_LENGTH - TIMESTAMP_LENGTH;
+    if (rndLength > 0) {
+        const rndMin = 10 ** (rndLength - 1);
+        const rndMax = 10 ** rndLength - 1;
+        const rnd = random.randomNumber(rndMin, rndMax);
+        random$1 = `${rnd}`;
+    }
+    const safe = padStartWithZero(safeNo, FIX_SAFE_LENGTH);
+    safeNo++;
+    return `${timestamp}${random$1}${safe}`;
+};
+const randomFromPool = (pool) => {
+    const poolIndex = random.randomNumber(0, pool.length - 1);
+    return pool[poolIndex];
+};
+/**
+ * 生成唯一不重复字符串
+ * @param {number | string} length
+ * @param {string} pool
+ * @returns {string}
+ */
+const uniqueString = (length, pool) => {
+    let _length = 0;
+    let _pool = number.HEX_POOL;
+    if (type.isString(pool)) {
+        _length = length;
+        _pool = pool;
+    }
+    else if (type.isNumber(length)) {
+        _length = length;
+    }
+    else if (type.isString(length)) {
+        _pool = length;
+    }
+    let uniqueString = number.numberToHex(uniqueNumber(), _pool);
+    let insertLength = _length - uniqueString.length;
+    if (insertLength <= 0)
+        return uniqueString;
+    while (insertLength--) {
+        uniqueString += randomFromPool(_pool);
+    }
+    return uniqueString;
+};
+
+exports.UNIQUE_NUMBER_SAFE_LENGTH = UNIQUE_NUMBER_SAFE_LENGTH;
+exports.uniqueNumber = uniqueNumber;
+exports.uniqueString = uniqueString;

package/lib/cjs/url.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */

package/lib/cjs/watermark.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */

package/lib/es/array.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */
@@ -31,14 +31,14 @@ const arrayEach = (array, iterator, reverse = false) => {
     if (reverse) {
         for (let idx = array.length - 1; idx >= 0; idx--) {
             const val = array[idx];
-            if (iterator(val, idx) === false)
+            if (iterator(val, idx, array) === false)
                 break;
         }
     }
     else {
         for (let idx = 0; idx < array.length; idx++) {
             const val = array[idx];
-            if (iterator(val, idx) === false)
+            if (iterator(val, idx, array) === false)
                 break;
         }
     }
@@ -170,39 +170,11 @@ function getTreeIds(tree, nodeId, config) {
         while (child && child.parentId) {
             ids = [child.parentId, ...ids];
             nodes = [child.parent, ...nodes];
-            child = flatArray.find(_ => _[id] === child.parentId);
+            child = flatArray.find(_ => _[id] === child.parentId); // eslint-disable-line
         }
         return [ids, nodes];
     };
     return getIds(toFlatArray(tree));
 }
-/**
- * 异步ForEach函数
- * @param {array} array
- * @param {asyncFuntion} callback
- * // asyncForEach 使用范例如下
-// const start = async () => {
-//   await asyncForEach(result, async (item) => {
-//     await request(item);
-//     count++;
-//   });
-
-//   console.log('发送次数', count);
-// }
-
-// for await...of 使用范例如下
-// const loadImages =  async (images) => {
-//   for await (const item of images) {
-//      await request(item);
-//      count++;
-//    }
-// }
- * @return {*}
- */
-async function asyncForEach(array, callback) {
-    for (let index = 0, len = array.length; index < len; index++) {
-        await callback(array[index], index, array);
-    }
-}
 
-export { arrayEach, arrayEachAsync, arrayInsertBefore, arrayLike, arrayRemove, asyncForEach, deepTraversal, getTreeIds };
+export { arrayEach, arrayEachAsync, arrayInsertBefore, arrayLike, arrayRemove, deepTraversal, getTreeIds };

package/lib/es/async.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */

package/lib/es/clipboard.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */

package/lib/es/cookie.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */

package/lib/es/date.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */
@@ -54,16 +54,16 @@ const formatDate = (date = new Date(), format = 'YYYY-MM-DD HH:mm:ss') => {
  */
 function calculateDate(strDate, n, sep = '-') {
     //strDate 为字符串日期 如:'2019-01-01' n为你要传入的参数，当前为0，前一天为-1，后一天为1
-    let dateArr = strDate.split(sep); //这边给定一个特定时间
-    let newDate = new Date(+dateArr[0], +dateArr[1] - 1, +dateArr[2]);
-    let befminuts = newDate.getTime() + 1000 * 60 * 60 * 24 * parseInt(String(n)); //计算前几天用减，计算后几天用加，最后一个就是多少天的数量
-    let beforeDat = new Date();
+    const dateArr = strDate.split(sep); //这边给定一个特定时间
+    const newDate = new Date(+dateArr[0], +dateArr[1] - 1, +dateArr[2]);
+    const befminuts = newDate.getTime() + 1000 * 60 * 60 * 24 * parseInt(String(n)); //计算前几天用减，计算后几天用加，最后一个就是多少天的数量
+    const beforeDat = new Date();
     beforeDat.setTime(befminuts);
-    let befMonth = beforeDat.getMonth() + 1;
-    let mon = befMonth >= 10 ? befMonth : '0' + befMonth;
-    let befDate = beforeDat.getDate();
-    let da = befDate >= 10 ? befDate : '0' + befDate;
-    let finalNewDate = beforeDat.getFullYear() + '-' + mon + '-' + da;
+    const befMonth = beforeDat.getMonth() + 1;
+    const mon = befMonth >= 10 ? befMonth : '0' + befMonth;
+    const befDate = beforeDat.getDate();
+    const da = befDate >= 10 ? befDate : '0' + befDate;
+    const finalNewDate = beforeDat.getFullYear() + '-' + mon + '-' + da;
     return finalNewDate;
 }
 /**
@@ -74,9 +74,9 @@ function calculateDate(strDate, n, sep = '-') {
  * @return {*}
  */
 function calculateDateTime(n, dateSep = '-', timeSep = ':') {
-    let date = new Date();
-    let separator1 = '-';
-    let separator2 = ':';
+    const date = new Date();
+    const separator1 = '-';
+    const separator2 = ':';
     let year = date.getFullYear();
     let month = date.getMonth() + 1;
     let strDate = date.getDate() + n;

package/lib/es/dom.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */
@@ -139,5 +139,16 @@ function onDomReady(callback) {
         domReadyCallbacks.push(callback);
     }
 }
+/**
+ * 获取元素样式属性的计算值
+ * @param {HTMLElement} el
+ * @param {string} property
+ * @param {boolean} reNumber
+ * @return {string|number}
+ */
+function getComputedCssVal(el, property, reNumber = true) {
+    const originVal = getComputedStyle(el).getPropertyValue(property) ?? '';
+    return reNumber ? Number(originVal.replace(/([0-9]*)(.*)/g, '$1')) : originVal;
+}
 
-export { addClass, getStyle, hasClass, isDomReady, onDomReady, removeClass, setStyle, smoothScroll };
+export { addClass, getComputedCssVal, getStyle, hasClass, isDomReady, onDomReady, removeClass, setStyle, smoothScroll };

package/lib/es/download.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */

package/lib/es/easing.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */

package/lib/es/file.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */

package/lib/es/func.js

@@ -0,0 +1,154 @@
+/*!
+ * sculp-js v0.1.0
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+/**
+ * 防抖函数
+ * 当函数被连续调用时，该函数并不执行，只有当其全部停止调用超过一定时间后才执行1次。
+ * 例如：上电梯的时候，大家陆陆续续进来，电梯的门不会关上，只有当一段时间都没有人上来，电梯才会关门。
+ * @param {F} func
+ * @param {number} wait
+ * @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;
+};
+/**
+ * 节流函数
+ * 节流就是节约流量，将连续触发的事件稀释成预设评率。 比如每间隔1秒执行一次函数，无论这期间触发多少次事件。
+ * 这有点像公交车，无论在站点等车的人多不多，公交车只会按时来一班，不会来一个人就来一辆公交车。
+ * @param {F} func
+ * @param {number} wait
+ * @param {boolean} immediate
+ * @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();
+        }
+    };
+    f.cancel = () => {
+        clearTimeout(timeout);
+        canceled = true;
+    };
+    return f;
+};
+/**
+ * 单次函数
+ * @param {AnyFunc} func
+ * @returns {AnyFunc}
+ */
+const once = (func) => {
+    let called = false;
+    let result;
+    return function (...args) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        if (called)
+            return result;
+        called = true;
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        result = func.call(this, ...args);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return result;
+    };
+};
+/**
+ * 设置全局变量
+ * @param {string | number | symbol} key
+ * @param val
+ */
+function setGlobal(key, val) {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    if (typeof globalThis !== 'undefined')
+        globalThis[key] = val;
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    else if (typeof window !== 'undefined')
+        window[key] = val;
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    else if (typeof global !== 'undefined')
+        global[key] = val;
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    else if (typeof self !== 'undefined')
+        self[key] = val;
+    else
+        throw new SyntaxError('当前环境下无法设置全局属性');
+}
+/**
+ * 设置全局变量
+ * @param {string | number | symbol} key
+ * @param val
+ */
+function getGlobal(key) {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    if (typeof globalThis !== 'undefined')
+        return globalThis[key];
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    else if (typeof window !== 'undefined')
+        return window[key];
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    else if (typeof global !== 'undefined')
+        return global[key];
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    else if (typeof self !== 'undefined')
+        return self[key];
+}
+
+export { debounce, getGlobal, once, setGlobal, throttle };

package/lib/es/index.js

@@ -1,35 +1,25 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */
 
-import * as array from './array.js';
-export { array };
-import * as clipboard from './clipboard.js';
-export { clipboard };
-import * as cookie from './cookie.js';
-export { cookie };
-import * as date from './date.js';
-export { date };
-import * as dom from './dom.js';
-export { dom };
-import * as download from './download.js';
-export { download };
-import * as object from './object.js';
-export { object };
-import * as path from './path.js';
-export { path };
-import * as qs from './qs.js';
-export { qs };
-import * as string from './string.js';
-export { string };
-import * as type from './type.js';
-export { type };
-import * as url from './url.js';
-export { url };
-import * as async from './async.js';
-export { async };
-import * as file from './file.js';
-export { file };
+export { arrayEach, arrayEachAsync, arrayInsertBefore, arrayLike, arrayRemove, deepTraversal, getTreeIds } from './array.js';
+export { copyText } from './clipboard.js';
+export { cookieDel, cookieGet, cookieSet } from './cookie.js';
+export { calculateDate, calculateDateTime, formatDate } from './date.js';
+export { addClass, getComputedCssVal, getStyle, hasClass, isDomReady, onDomReady, removeClass, setStyle, smoothScroll } from './dom.js';
+export { downloadBlob, downloadData, downloadHref, downloadURL } from './download.js';
+export { cloneDeep, isPlainObject, objectAssign, objectEach, objectEachAsync, objectFill, objectGet, objectHas, 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, 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 { urlDelParams, urlParse, urlSetParams, urlStringify } from './url.js';
+export { asyncMap, wait } from './async.js';
+export { chooseLocalFile } 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 { UNIQUE_NUMBER_SAFE_LENGTH, uniqueNumber, uniqueString } from './unique.js';