foreslash 0.3.4 → 0.3.6

package/CHANGELOG.md

@@ -1,6 +1,38 @@
 # Change Log
 
-## Version 0.3.4 - 2025-11-
+## Version 0.3.6 - 2026-01-
+
+Unstable version
+
+Added some Base64 related methods
+
+- Feat 🥥 Functions added: `encodeBase64` `decodeBase64` `blobToBase64` `base64ToBlob` `deprecate` and so forth
+- Other fixes and improvements
+
+不稳定版本
+
+添加了一些 Base64 相关的方法
+
+- 功能 🥥 添加函数: `encodeBase64` `decodeBase64` `blobToBase64` `base64ToBlob` `deprecate` 等
+- 其他修复与优化
+
+## Version 0.3.5 - 2025-11-30
+
+Unstable version
+
+- Feat 🥥 Functions added: `uuidV7`
+- Feat 🥥 Function change: `isOdd` and `isEven` now support BigInt
+- Fix 🥕 Document: Added version tags to several methods
+- Other fixes and improvements
+
+不稳定版本
+
+- 功能 🥥 添加函数: `uuidV7`
+- 功能 🥥 变更函数: `isOdd` 和 `isEven` 现在支持 BigInt
+- 修复 🥕 文档: 补充部分方法的版本标签
+- 其他修复与优化
+
+## Version 0.3.4 - 2025-11-17
 
 Unstable version
 

package/lib/index.cmn.cjs

@@ -190,9 +190,9 @@ function isObject(value) {
 }
 
 const global$7 = getGlobalThis();
-const Blob = global$7.Blob;
+const Blob$1 = global$7.Blob;
 function isBlob(value) {
-    return !!Blob && isObject(value) && getTag(value) === 'Blob';
+    return !!Blob$1 && isObject(value) && getTag(value) === 'Blob';
 }
 
 function isBoolean(value) {
@@ -468,10 +468,10 @@ function decimalNotation(num) {
 }
 
 function isOdd(num) {
-    return !!(num & 1);
+    return !!(typeof num === 'bigint' ? num & BigInt(1) : num & 1);
 }
 function isEven(num) {
-    return !(num & 1);
+    return !(typeof num === 'bigint' ? num & BigInt(1) : num & 1);
 }
 
 function round(num, precision, type) {
@@ -1607,6 +1607,15 @@ function uuidV4() {
     return (`${r.slice(0, 8)}-${r.slice(8, 12)}-4${r.slice(12, 15)}-` +
         `${'89ab'[Math.floor(Math.random() * 4)]}${r.slice(15, 18)}-${r.slice(18)}`);
 }
+function uuidV7() {
+    const r = randomHexString(18);
+    let t = Date.now().toString(16);
+    if (t.length < 12)
+        t = '0'.repeat(12 - t.length) + t;
+    t = t.slice(t.length - 12, t.length);
+    return (`${t.slice(0, 8)}-${t.slice(8, 12)}-7${r.slice(0, 3)}-` +
+        `${'89ab'[Math.floor(Math.random() * 4)]}${r.slice(3, 6)}-${r.slice(6)}`);
+}
 
 const getDefaultVarCase = () => ({ code: '', upperCase: false, number: false });
 const isUpperCase = RegExp.prototype.test.bind(/[A-Z]/);
@@ -1739,6 +1748,49 @@ function titleCase(str, options) {
         : ({ code }) => code.slice(0, 1).toUpperCase() + code.slice(1).toLowerCase());
 }
 
+function encodeBase64(str) {
+    const utf8Bytes = new TextEncoder().encode(str);
+    let binary = '';
+    utf8Bytes.forEach((byte) => {
+        binary += String.fromCharCode(byte);
+    });
+    return btoa(binary);
+}
+function decodeBase64(base64Str) {
+    const binary = atob(base64Str);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return new TextDecoder().decode(bytes);
+}
+function blobToBase64(blob) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onloadend = () => {
+            const dataUrl = reader.result;
+            const base64 = dataUrl.split(',')[1];
+            resolve(base64);
+        };
+        reader.onerror = reject;
+        reader.readAsDataURL(blob);
+    });
+}
+function base64ToBlob(base64Str, mimeType = 'text/plain') {
+    const byteCharacters = atob(base64Str);
+    const byteArray = new Uint8Array(byteCharacters.length);
+    for (let i = 0; i < byteCharacters.length; i++) {
+        byteArray[i] = byteCharacters.charCodeAt(i);
+    }
+    return new Blob([byteArray], { type: mimeType });
+}
+function dataUrlToBlob(dataUrl) {
+    const [header, base64Str] = dataUrl.split(',');
+    const mimeMatch = header.match(/data:([^;]*)(?:;charset:.*?)?(?:;base64)?/);
+    const mimeType = mimeMatch ? mimeMatch[1] || 'text/plain' : 'text/plain';
+    return base64ToBlob(base64Str, mimeType);
+}
+
 function capitalize(str) {
     if (!str)
         return str;
@@ -2367,6 +2419,21 @@ function deepMerge(target, source, option) {
     return res;
 }
 
+function deprecate(fn, msg, code) {
+    let isWarned = false;
+    return function deprecateFn(...args) {
+        const res = fn.apply(this, args);
+        if (!isWarned) {
+            if (code)
+                console.warn(`[${code}]`, msg);
+            else
+                console.warn(msg);
+            isWarned = true;
+        }
+        return res;
+    };
+}
+
 function _fastClone(obj, map) {
     if (map.has(obj))
         return map.get(obj);
@@ -2574,6 +2641,8 @@ exports.$$Empty = $$Empty;
 exports._ = _;
 exports.acceptableFileName = acceptableFileName;
 exports.acceptableFileType = acceptableFileType;
+exports.base64ToBlob = base64ToBlob;
+exports.blobToBase64 = blobToBase64;
 exports.camelCase = camelCase;
 exports.capitalize = capitalize;
 exports.cartesianProduct = cartesianProduct;
@@ -2587,12 +2656,16 @@ exports.chunk = chunk;
 exports.clamp = clamp;
 exports.compose = compose;
 exports.curry = _curryMore;
+exports.dataUrlToBlob = dataUrlToBlob;
 exports.debounce = debounce;
 exports.decimalNotation = decimalNotation;
+exports.decodeBase64 = decodeBase64;
 exports.dedent = dedent;
 exports.deepClone = deepClone;
 exports.deepMerge = deepMerge;
 exports.defer = defer;
+exports.deprecate = deprecate;
+exports.encodeBase64 = encodeBase64;
 exports.fastClone = fastClone;
 exports.format = format;
 exports.getAcceptableExtByMIME = getAcceptableExtByMIME;
@@ -2694,4 +2767,5 @@ exports.ulid = ulid;
 exports.uncapitalize = uncapitalize;
 exports.uuidNil = uuidNil;
 exports.uuidV4 = uuidV4;
+exports.uuidV7 = uuidV7;
 exports.withResolvers = withResolvers;

package/lib/index.d.ts

@@ -1031,14 +1031,14 @@ declare function format(num: number | string, options?: {
  * @returns 如果是奇数则返回 true 否则返回 false
  * @version 0.3.2
  */
-declare function isOdd(num: number): boolean;
+declare function isOdd(num: number | bigint): boolean;
 /**
  * 检查一个数字是否为偶数
  * @param num 需要检查的数字
  * @returns 如果是偶数则返回 true 否则返回 false
  * @version 0.3.2
  */
-declare function isEven(num: number): boolean;
+declare function isEven(num: number | bigint): boolean;
 
 /**
  * 用线性插值法求取一个中间值
@@ -1456,6 +1456,7 @@ declare function randomBase32String(length: number, isCrockford?: boolean): stri
  * shuffle('abcdefg') // ['d', 'e', 'a', 'c', 'g', 'f', 'b']
  * shuffle([1, 2, 3, 4, 5, 6, 7, 8]) // [3, 2, 6, 5, 8, 1, 7, 4]
  * ```
+ * @version 0.1.1
  */
 declare function shuffle<T>(arr: ArrayLike<T> | Iterable<T>): Array<T>;
 
@@ -1474,20 +1475,32 @@ declare function shuffle<T>(arr: ArrayLike<T> | Iterable<T>): Array<T>;
  * ulid(true, 0) // 0000000000D64N3ZR75CXM1J83 同一时间戳单调递增
  * ulid(false, 0) // 0000000000Z3VJ5THVXV4ZE6CO 取消单调性
  * ```
+ * @version 0.1.2
  */
 declare function ulid(monotonic?: boolean, time?: number): string;
 
-/** 空 UUID [见标准第 4.1.7 节](https://www.ietf.org/rfc/rfc4122.txt) */
+/** 空 UUID [见标准第 5.9 节](https://www.rfc-editor.org/rfc/rfc9562.html#name-nil-uuid) */
 declare const uuidNil = "00000000-0000-0000-0000-000000000000";
 /**
- * 生成 [UUID V4](https://www.ietf.org/rfc/rfc4122.txt) 字符串（小写）
- * @returns 一个标准的 UUID V4 字符串
+ * 生成 [UUID V4](https://www.rfc-editor.org/rfc/rfc9562.html#name-uuid-version-4) 字符串（小写）
+ * @returns 一个 RFC 9562 标准的 UUID V4 字符串
  * @example
  * ```js
  * uuidV4() // "ea64fb4f-a0a2-4193-8374-d291a522d8b3"
  * ```
+ * @version 0.1.2
  */
 declare function uuidV4(): string;
+/**
+ * 生成 [UUID V7](https://www.rfc-editor.org/rfc/rfc9562.html#name-uuid-version-7) 字符串（小写）
+ * @returns 一个 RFC 9562 标准的 UUID V7 字符串
+ * @example
+ * ```js
+ * uuidV7() // "019aba02-45ad-703c-a17e-05f8d7ebe357"
+ * ```
+ * @version 0.3.4
+ */
+declare function uuidV7(): string;
 
 /**
  * 将输入的字符串处理成小驼峰格式
@@ -1599,6 +1612,77 @@ declare function titleCase(str: string, options?: {
     keepNumber?: boolean;
 }): string;
 
+/**
+ * 将一个字符串转换为 Base64 编码的字符串, 支持中文等
+ * - 内部使用到了 `btoa` 方法, 可能会有报错
+ * - 如果想在 Internet Explorer 上使用, 请 polyFill `TextEncoder` 对象
+ * @param str 需要转换的字符串
+ * @returns 输入字符串转换为 Base64 编码后的字符串
+ * @example
+ * ```js
+ * encodeBase64('abc123') // YWJjMTIz
+ * encodeBase64('文字') // 5paH5a2X
+ * ```
+ * @version 0.3.6
+ */
+declare function encodeBase64(str: string): string;
+/**
+ * 将一个 Base64 编码的字符串转换为普通字符串, 支持中文等
+ * - 内部使用到了 `atob` 方法, 可能会有报错
+ * - 如果想在 Internet Explorer 上使用, 请 polyFill `TextDecoder` 对象
+ * @param base64Str 需要转换的 Base64 编码字符串
+ * @returns 输入 Base64 编码字符串转换后的普通字符串
+ * @example
+ * ```js
+ * decodeBase64('YWJjMTIz') // abc123
+ * decodeBase64('5paH5a2X') // 文字
+ * ```
+ * @version 0.3.6
+ */
+declare function decodeBase64(base64Str: string): string;
+/**
+ * 将 Blob 对象转换为 Base64 编码的字符串
+ * - 如果想在 Internet Explorer 9 及更早的 IE 上使用, 请 polyFill `FileReader` 对象
+ * @param blob 需要转换的 Blob 对象
+ * @returns 输入 Blob 对象转换为 Base64 编码后的字符串
+ * @example
+ * ```js
+ * const blob = new Blob(['Hello, world!'], { type: 'text/plain' })
+ * blobToBase64(blob).then(base64 => {
+ *   console.log(base64) // SGVsbG8sIHdvcmxkIQ==
+ * })
+ * ```
+ * @version 0.3.6
+ */
+declare function blobToBase64(blob: Blob): Promise<string>;
+/**
+ * 将 Base64 编码的字符串转换为 Blob 对象
+ * @param base64Str 需要转换的 Base64 编码字符串
+ * @param mimeType 转换后 Blob 对象的 MIME 类型, 默认为 'text/plain'
+ * @returns 输入 Base64 编码字符串转换后的 Blob 对象
+ * @example
+ * ```js
+ * const base64 = 'SGVsbG8sIHdvcmxkIQ=='
+ * const blob = base64ToBlob(base64, 'text/plain')
+ * console.log(blob) // Blob { size: 13, type: "text/plain" }
+ * ```
+ * @version 0.3.6
+ */
+declare function base64ToBlob(base64Str: string, mimeType?: string): Blob;
+/**
+ * 将 Data URL 转换为 Blob 对象
+ * @param dataUrl 需要转换的 Data URL 字符串
+ * @returns 输入 Data URL 转换后的 Blob 对象
+ * @example
+ * ```js
+ * const dataUrl = 'data:text/plain;base64,SGVsbG8sIHdvcmxkIQ=='
+ * const blob = dataUrlToBlob(dataUrl)
+ * console.log(blob) // Blob { size: 13, type: "text/plain" }
+ * ```
+ * @version 0.3.6
+ */
+declare function dataUrlToBlob(dataUrl: string): Blob;
+
 /**
  * 将字符串的首字母大写
  * @param str 字符串
@@ -2152,6 +2236,32 @@ type MergeOption = {
  */
 declare function deepMerge<Target, Source, Result = Target & Source>(target: Target, source: Source, option?: MergeOption): Result;
 
+/**
+ * 将一个函数标记为已废弃(不推荐使用), 类似 NodeJS 的 `utils.deprecate`
+ * @param fn 需要标记为已废弃的函数
+ * @param msg 调用函数时, 在控制台发出的警报信息
+ * @param code 选填, 废弃编码
+ * @returns 一个与传入的函数输入输出一致的新函数, 区别是第一次调用时会在控制台触发一次警告
+ * @example
+ * ```js
+ * const fn = () => {
+ *   console.log('test')
+ *   return 123
+ * }
+ * const deprecateFn = deprecate(fn, 'Do not use this!', 'Foreslash')
+ * const res = deprecateFn() // res 值为 123
+ * deprecateFn()
+ * deprecateFn()
+ * // console:
+ * // test
+ * // [Foreslash] Do not use this!
+ * // test
+ * // test
+ * ```
+ * @version 0.3.6
+ */
+declare function deprecate<Fn extends Function>(fn: Fn, msg: string, code?: string): Fn;
+
 /**
  * 快速深拷贝
  * - 功能较为齐全, 相对 `deepClone` 而言运行更快
@@ -2459,5 +2569,5 @@ declare function throttle<T extends any[]>(fn: (...args: T) => any, delay: numbe
     reset: () => void;
 };
 
-export { $$Empty, _, acceptableFileName, acceptableFileType, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, castArray, chunk, clamp, compose, _curryMore as curry, debounce, decimalNotation, dedent, deepClone, deepMerge, defer, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getInitP, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isEven, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isOdd, isPlaceholder, isPlainObject, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, lerp, memo, noop, not, omit, parallel, pascalCase, pass, passWith, pick, pipe, randomBase32String, randomChoice, randomDistribution, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, romanNumerals, round, roundBank, roundBase, roundCeil, roundFloor, scientificNotation, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uncapitalize, uuidNil, uuidV4, withResolvers };
+export { $$Empty, _, acceptableFileName, acceptableFileType, base64ToBlob, blobToBase64, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, castArray, chunk, clamp, compose, _curryMore as curry, dataUrlToBlob, debounce, decimalNotation, decodeBase64, dedent, deepClone, deepMerge, defer, deprecate, encodeBase64, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getInitP, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isEven, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isOdd, isPlaceholder, isPlainObject, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, lerp, memo, noop, not, omit, parallel, pascalCase, pass, passWith, pick, pipe, randomBase32String, randomChoice, randomDistribution, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, romanNumerals, round, roundBank, roundBase, roundCeil, roundFloor, scientificNotation, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uncapitalize, uuidNil, uuidV4, uuidV7, withResolvers };
 export type { BaseMargeType, CastArray, Chunked, CloneOptions, CustomCloner, IsNegative, IsPositive, IsZero, MergeOption, MergeStrategy, MergeStrategyFunction, MergeType, MergeTypeStrategy, Not, RangeOptions, SourceMergeType, Stringify, TargetMergeType, TypedArray };

package/lib/index.mjs

@@ -188,9 +188,9 @@ function isObject(value) {
 }
 
 const global$7 = getGlobalThis();
-const Blob = global$7.Blob;
+const Blob$1 = global$7.Blob;
 function isBlob(value) {
-    return !!Blob && isObject(value) && getTag(value) === 'Blob';
+    return !!Blob$1 && isObject(value) && getTag(value) === 'Blob';
 }
 
 function isBoolean(value) {
@@ -466,10 +466,10 @@ function decimalNotation(num) {
 }
 
 function isOdd(num) {
-    return !!(num & 1);
+    return !!(typeof num === 'bigint' ? num & BigInt(1) : num & 1);
 }
 function isEven(num) {
-    return !(num & 1);
+    return !(typeof num === 'bigint' ? num & BigInt(1) : num & 1);
 }
 
 function round(num, precision, type) {
@@ -1605,6 +1605,15 @@ function uuidV4() {
     return (`${r.slice(0, 8)}-${r.slice(8, 12)}-4${r.slice(12, 15)}-` +
         `${'89ab'[Math.floor(Math.random() * 4)]}${r.slice(15, 18)}-${r.slice(18)}`);
 }
+function uuidV7() {
+    const r = randomHexString(18);
+    let t = Date.now().toString(16);
+    if (t.length < 12)
+        t = '0'.repeat(12 - t.length) + t;
+    t = t.slice(t.length - 12, t.length);
+    return (`${t.slice(0, 8)}-${t.slice(8, 12)}-7${r.slice(0, 3)}-` +
+        `${'89ab'[Math.floor(Math.random() * 4)]}${r.slice(3, 6)}-${r.slice(6)}`);
+}
 
 const getDefaultVarCase = () => ({ code: '', upperCase: false, number: false });
 const isUpperCase = RegExp.prototype.test.bind(/[A-Z]/);
@@ -1737,6 +1746,49 @@ function titleCase(str, options) {
         : ({ code }) => code.slice(0, 1).toUpperCase() + code.slice(1).toLowerCase());
 }
 
+function encodeBase64(str) {
+    const utf8Bytes = new TextEncoder().encode(str);
+    let binary = '';
+    utf8Bytes.forEach((byte) => {
+        binary += String.fromCharCode(byte);
+    });
+    return btoa(binary);
+}
+function decodeBase64(base64Str) {
+    const binary = atob(base64Str);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return new TextDecoder().decode(bytes);
+}
+function blobToBase64(blob) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onloadend = () => {
+            const dataUrl = reader.result;
+            const base64 = dataUrl.split(',')[1];
+            resolve(base64);
+        };
+        reader.onerror = reject;
+        reader.readAsDataURL(blob);
+    });
+}
+function base64ToBlob(base64Str, mimeType = 'text/plain') {
+    const byteCharacters = atob(base64Str);
+    const byteArray = new Uint8Array(byteCharacters.length);
+    for (let i = 0; i < byteCharacters.length; i++) {
+        byteArray[i] = byteCharacters.charCodeAt(i);
+    }
+    return new Blob([byteArray], { type: mimeType });
+}
+function dataUrlToBlob(dataUrl) {
+    const [header, base64Str] = dataUrl.split(',');
+    const mimeMatch = header.match(/data:([^;]*)(?:;charset:.*?)?(?:;base64)?/);
+    const mimeType = mimeMatch ? mimeMatch[1] || 'text/plain' : 'text/plain';
+    return base64ToBlob(base64Str, mimeType);
+}
+
 function capitalize(str) {
     if (!str)
         return str;
@@ -2365,6 +2417,21 @@ function deepMerge(target, source, option) {
     return res;
 }
 
+function deprecate(fn, msg, code) {
+    let isWarned = false;
+    return function deprecateFn(...args) {
+        const res = fn.apply(this, args);
+        if (!isWarned) {
+            if (code)
+                console.warn(`[${code}]`, msg);
+            else
+                console.warn(msg);
+            isWarned = true;
+        }
+        return res;
+    };
+}
+
 function _fastClone(obj, map) {
     if (map.has(obj))
         return map.get(obj);
@@ -2568,4 +2635,4 @@ function throttle(fn, delay, options) {
     return _throttle(fn, delay, Object.assign({ trailing: false, leading: true }, options));
 }
 
-export { $$Empty, _, acceptableFileName, acceptableFileType, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, castArray, chunk, clamp, compose, _curryMore as curry, debounce, decimalNotation, dedent, deepClone, deepMerge, defer, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getInitP, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isEven, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isOdd, isPlaceholder, isPlainObject, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, lerp, memo, noop, not, omit, parallel, pascalCase, pass, passWith, pick, pipe, randomBase32String, randomChoice, randomDistribution, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, romanNumerals, round, roundBank, roundBase, roundCeil, roundFloor, scientificNotation, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uncapitalize, uuidNil, uuidV4, withResolvers };
+export { $$Empty, _, acceptableFileName, acceptableFileType, base64ToBlob, blobToBase64, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, castArray, chunk, clamp, compose, _curryMore as curry, dataUrlToBlob, debounce, decimalNotation, decodeBase64, dedent, deepClone, deepMerge, defer, deprecate, encodeBase64, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getInitP, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isEven, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isOdd, isPlaceholder, isPlainObject, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, lerp, memo, noop, not, omit, parallel, pascalCase, pass, passWith, pick, pipe, randomBase32String, randomChoice, randomDistribution, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, romanNumerals, round, roundBank, roundBase, roundCeil, roundFloor, scientificNotation, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uncapitalize, uuidNil, uuidV4, uuidV7, withResolvers };

package/lib/index.umd.js

@@ -194,9 +194,9 @@ See the Mulan PSL v2 for more details.
   }
 
   const global$7 = getGlobalThis();
-  const Blob = global$7.Blob;
+  const Blob$1 = global$7.Blob;
   function isBlob(value) {
-      return !!Blob && isObject(value) && getTag(value) === 'Blob';
+      return !!Blob$1 && isObject(value) && getTag(value) === 'Blob';
   }
 
   function isBoolean(value) {
@@ -472,10 +472,10 @@ See the Mulan PSL v2 for more details.
   }
 
   function isOdd(num) {
-      return !!(num & 1);
+      return !!(typeof num === 'bigint' ? num & BigInt(1) : num & 1);
   }
   function isEven(num) {
-      return !(num & 1);
+      return !(typeof num === 'bigint' ? num & BigInt(1) : num & 1);
   }
 
   function round(num, precision, type) {
@@ -1611,6 +1611,15 @@ See the Mulan PSL v2 for more details.
       return (`${r.slice(0, 8)}-${r.slice(8, 12)}-4${r.slice(12, 15)}-` +
           `${'89ab'[Math.floor(Math.random() * 4)]}${r.slice(15, 18)}-${r.slice(18)}`);
   }
+  function uuidV7() {
+      const r = randomHexString(18);
+      let t = Date.now().toString(16);
+      if (t.length < 12)
+          t = '0'.repeat(12 - t.length) + t;
+      t = t.slice(t.length - 12, t.length);
+      return (`${t.slice(0, 8)}-${t.slice(8, 12)}-7${r.slice(0, 3)}-` +
+          `${'89ab'[Math.floor(Math.random() * 4)]}${r.slice(3, 6)}-${r.slice(6)}`);
+  }
 
   const getDefaultVarCase = () => ({ code: '', upperCase: false, number: false });
   const isUpperCase = RegExp.prototype.test.bind(/[A-Z]/);
@@ -1743,6 +1752,49 @@ See the Mulan PSL v2 for more details.
           : ({ code }) => code.slice(0, 1).toUpperCase() + code.slice(1).toLowerCase());
   }
 
+  function encodeBase64(str) {
+      const utf8Bytes = new TextEncoder().encode(str);
+      let binary = '';
+      utf8Bytes.forEach((byte) => {
+          binary += String.fromCharCode(byte);
+      });
+      return btoa(binary);
+  }
+  function decodeBase64(base64Str) {
+      const binary = atob(base64Str);
+      const bytes = new Uint8Array(binary.length);
+      for (let i = 0; i < binary.length; i++) {
+          bytes[i] = binary.charCodeAt(i);
+      }
+      return new TextDecoder().decode(bytes);
+  }
+  function blobToBase64(blob) {
+      return new Promise((resolve, reject) => {
+          const reader = new FileReader();
+          reader.onloadend = () => {
+              const dataUrl = reader.result;
+              const base64 = dataUrl.split(',')[1];
+              resolve(base64);
+          };
+          reader.onerror = reject;
+          reader.readAsDataURL(blob);
+      });
+  }
+  function base64ToBlob(base64Str, mimeType = 'text/plain') {
+      const byteCharacters = atob(base64Str);
+      const byteArray = new Uint8Array(byteCharacters.length);
+      for (let i = 0; i < byteCharacters.length; i++) {
+          byteArray[i] = byteCharacters.charCodeAt(i);
+      }
+      return new Blob([byteArray], { type: mimeType });
+  }
+  function dataUrlToBlob(dataUrl) {
+      const [header, base64Str] = dataUrl.split(',');
+      const mimeMatch = header.match(/data:([^;]*)(?:;charset:.*?)?(?:;base64)?/);
+      const mimeType = mimeMatch ? mimeMatch[1] || 'text/plain' : 'text/plain';
+      return base64ToBlob(base64Str, mimeType);
+  }
+
   function capitalize(str) {
       if (!str)
           return str;
@@ -2371,6 +2423,21 @@ See the Mulan PSL v2 for more details.
       return res;
   }
 
+  function deprecate(fn, msg, code) {
+      let isWarned = false;
+      return function deprecateFn(...args) {
+          const res = fn.apply(this, args);
+          if (!isWarned) {
+              if (code)
+                  console.warn(`[${code}]`, msg);
+              else
+                  console.warn(msg);
+              isWarned = true;
+          }
+          return res;
+      };
+  }
+
   function _fastClone(obj, map) {
       if (map.has(obj))
           return map.get(obj);
@@ -2578,6 +2645,8 @@ See the Mulan PSL v2 for more details.
   exports._ = _;
   exports.acceptableFileName = acceptableFileName;
   exports.acceptableFileType = acceptableFileType;
+  exports.base64ToBlob = base64ToBlob;
+  exports.blobToBase64 = blobToBase64;
   exports.camelCase = camelCase;
   exports.capitalize = capitalize;
   exports.cartesianProduct = cartesianProduct;
@@ -2591,12 +2660,16 @@ See the Mulan PSL v2 for more details.
   exports.clamp = clamp;
   exports.compose = compose;
   exports.curry = _curryMore;
+  exports.dataUrlToBlob = dataUrlToBlob;
   exports.debounce = debounce;
   exports.decimalNotation = decimalNotation;
+  exports.decodeBase64 = decodeBase64;
   exports.dedent = dedent;
   exports.deepClone = deepClone;
   exports.deepMerge = deepMerge;
   exports.defer = defer;
+  exports.deprecate = deprecate;
+  exports.encodeBase64 = encodeBase64;
   exports.fastClone = fastClone;
   exports.format = format;
   exports.getAcceptableExtByMIME = getAcceptableExtByMIME;
@@ -2698,6 +2771,7 @@ See the Mulan PSL v2 for more details.
   exports.uncapitalize = uncapitalize;
   exports.uuidNil = uuidNil;
   exports.uuidV4 = uuidV4;
+  exports.uuidV7 = uuidV7;
   exports.withResolvers = withResolvers;
 
 }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foreslash",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Foreslash is a Javascript utilities lib which contains plenty of practical functions.",
   "author": "moushu",
   "license": "Mulan PSL v2",
@@ -36,6 +36,7 @@
     "dev": "rollup -c -w",
     "build": "rollup -c",
     "test": "tsd --files /test/**/*.test-d.ts && jest --coverage",
+    "test:slow": "tsd --files /test/**/*.test-d.ts && jest --coverage --runInBand",
     "prepublishOnly": "jest --coverage && npm run build",
     "docs:dev": "rollup -c && vitepress dev docs",
     "docs:build": "rollup -c && vitepress build docs",