sculp-js 0.0.1 → 0.1.1

package/lib/es/number.js

@@ -0,0 +1,77 @@
+/*!
+ * sculp-js v0.1.0
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+import { getGlobal } from './func.js';
+import { STRING_ARABIC_NUMERALS, STRING_UPPERCASE_ALPHA, STRING_LOWERCASE_ALPHA } from './string.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 divide = (x, y) => (supportBigInt ? x / y : jsbi().divide(x, y));
+const remainder = (x, y) => (supportBigInt ? x % y : jsbi().remainder(x, y));
+/**
+ * 将十进制转换成任意进制
+ * @param {number | string} decimal 十进制数值或字符串，可以是任意长度，会使用大数进行计算
+ * @param {string} [hexPool] 进制池，默认 62 进制
+ * @returns {string}
+ */
+const 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;');
+    }
+    // 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('');
+};
+/**
+ * 缩写
+ * @param {number | string} num
+ * @param {Array<string>} units
+ * @param {number} ratio
+ * @param {number} exponent
+ * @returns {string}
+ */
+const numberAbbr = (num, units, ratio = 1000, exponent) => {
+    const { length } = units;
+    if (length === 0)
+        throw new Error('至少需要一个单位');
+    let num2 = Number(num);
+    let times = 0;
+    while (num2 >= ratio && times < length - 1) {
+        num2 = num2 / ratio;
+        times++;
+    }
+    const value = num2.toFixed(exponent);
+    const unit = units[times];
+    return value.toString() + '' + unit;
+};
+/**
+ * 将数字格式化成千位分隔符显示的字符串
+ * @param {number} val 数字
+ * @param {'int' | 'float'} type 展示分段显示的类型 int:整型 | float:浮点型
+ * @return {string}
+ */
+function formatNumber(val, type = 'int') {
+    return type === 'int' ? parseInt(String(val)).toLocaleString() : Number(val).toLocaleString('en-US');
+}
+
+export { HEX_POOL, formatNumber, numberAbbr, numberToHex };

package/lib/es/object.js

@@ -1,10 +1,10 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */
 
-import typeIs, { isObject, isUndefined, isArray } from './type.js';
+import { isObject, isUndefined, typeIs, isArray } from './type.js';
 
 /**
  * 判断对象是否为纯对象

package/lib/es/path.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/qs.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/random.js

@@ -0,0 +1,67 @@
+/*!
+ * sculp-js v0.1.0
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+import { STRING_ARABIC_NUMERALS, STRING_UPPERCASE_ALPHA, STRING_LOWERCASE_ALPHA } from './string.js';
+import { isString, isNumber } from './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_ARABIC_NUMERALS}${STRING_UPPERCASE_ALPHA}${STRING_LOWERCASE_ALPHA}`;
+/**
+ * 随机字符串
+ * @param {number | string} length
+ * @param {string} pool
+ * @returns {string}
+ */
+const randomString = (length, pool) => {
+    let _length = 0;
+    let _pool = STRING_POOL;
+    if (isString(pool)) {
+        _length = length;
+        _pool = pool;
+    }
+    else if (isNumber(length)) {
+        _length = length;
+    }
+    else if (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];
+}
+
+export { STRING_POOL, randomNumber, randomString, randomUuid };

package/lib/es/string.js

@@ -1,9 +1,11 @@
 /*!
- * sculp-js v0.0.1
+ * sculp-js v0.1.0
  * (c) 2023-2023 chandq
  * Released under the MIT License.
  */
 
+import { isString } from './type.js';
+
 /**
  * 将字符串转换为驼峰格式
  * @param {string} string
@@ -120,5 +122,35 @@ 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(isString(str), `${str} 不是有效的字符串`);
+    if (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;
+}
 
-export { STRING_ARABIC_NUMERALS, STRING_LOWERCASE_ALPHA, STRING_UPPERCASE_ALPHA, stringAssign, stringCamelCase, stringEscapeHtml, stringFill, stringFormat, stringKebabCase };
+export { STRING_ARABIC_NUMERALS, STRING_LOWERCASE_ALPHA, STRING_UPPERCASE_ALPHA, getStrWidthPx, stringAssign, stringCamelCase, stringEscapeHtml, stringFill, stringFormat, stringKebabCase };

package/lib/es/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.
  */
@@ -25,4 +25,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 };
+export { typeIs as default, isArray, isBigInt, isBoolean, isDate, isError, isFunction, isNaN, isNull, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, typeIs };

package/lib/es/unique.js

@@ -0,0 +1,79 @@
+/*!
+ * sculp-js v0.1.0
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+import { numberToHex, HEX_POOL } from './number.js';
+import { randomNumber } from './random.js';
+import { isString, isNumber } from './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 = '';
+    const rndLength = length - FIX_SAFE_LENGTH - TIMESTAMP_LENGTH;
+    if (rndLength > 0) {
+        const rndMin = 10 ** (rndLength - 1);
+        const rndMax = 10 ** rndLength - 1;
+        const rnd = randomNumber(rndMin, rndMax);
+        random = `${rnd}`;
+    }
+    const safe = padStartWithZero(safeNo, FIX_SAFE_LENGTH);
+    safeNo++;
+    return `${timestamp}${random}${safe}`;
+};
+const randomFromPool = (pool) => {
+    const poolIndex = 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 = HEX_POOL;
+    if (isString(pool)) {
+        _length = length;
+        _pool = pool;
+    }
+    else if (isNumber(length)) {
+        _length = length;
+    }
+    else if (isString(length)) {
+        _pool = length;
+    }
+    let uniqueString = numberToHex(uniqueNumber(), _pool);
+    let insertLength = _length - uniqueString.length;
+    if (insertLength <= 0)
+        return uniqueString;
+    while (insertLength--) {
+        uniqueString += randomFromPool(_pool);
+    }
+    return uniqueString;
+};
+
+export { UNIQUE_NUMBER_SAFE_LENGTH, uniqueNumber, uniqueString };

package/lib/es/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/es/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.
  */