sculp-js 1.13.0 → 1.13.2

package/{lib/es → dist/esm}/tree.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.13.0
+ * sculp-js v1.13.2
  * (c) 2023-present chandq
  * Released under the MIT License.
  */
@@ -53,19 +53,15 @@ function forEachDeep(tree, iterator, options = {
                     else if (re === true) {
                         continue;
                     }
-                    // @ts-ignore
                     if (item && Array.isArray(item[childField])) {
-                        // @ts-ignore
                         walk(item[childField], item, level + 1);
                     }
                 }
             }
             if (breadthFirst) {
                 // Process queue
-                while (!isBreak) {
+                while (queue.length > 0 && !isBreak) {
                     const current = queue.shift();
-                    // iterate(info);
-                    // @ts-ignore
                     const { item, index, array, tree, parent, level } = current;
                     const re = iterator(item, index, array, tree, parent, level);
                     if (re === false) {
@@ -75,9 +71,7 @@ function forEachDeep(tree, iterator, options = {
                     else if (re === true) {
                         continue;
                     }
-                    // @ts-ignore
                     if (item && Array.isArray(item[childField])) {
-                        // @ts-ignore
                         walk(item[childField], item, level + 1);
                     }
                 }
@@ -103,19 +97,16 @@ function forEachDeep(tree, iterator, options = {
                     else if (re === true) {
                         continue;
                     }
-                    // @ts-ignore
                     if (item && Array.isArray(item[childField])) {
-                        // @ts-ignore
                         walk(item[childField], item, level + 1);
                     }
                 }
             }
             if (breadthFirst) {
-                while (!isBreak) {
+                while (queue.length > 0 && !isBreak) {
                     const current = queue.shift();
                     if (!current)
                         break;
-                    // @ts-ignore
                     const { item, index, array, tree, parent, level } = current;
                     const re = iterator(item, index, array, tree, parent, level);
                     if (re === false) {
@@ -125,9 +116,7 @@ function forEachDeep(tree, iterator, options = {
                     else if (re === true) {
                         continue;
                     }
-                    // @ts-ignore
                     if (item && Array.isArray(item[childField])) {
-                        // @ts-ignore
                         walk(item[childField], item, level + 1);
                     }
                 }
@@ -144,20 +133,27 @@ function forEachDeep(tree, iterator, options = {
  * 可遍历任何带有 length 属性和数字键的类数组对象
  * @param {ArrayLike<V>} tree  树形数据
  * @param {Function} iterator  迭代函数, 返回值为true时continue, 返回值为false时break
- * @param {string} children 定制子元素的key
- * @param {boolean} isReverse  是否反向遍历
+ * @param {options} options 支持定制子元素名称、反向遍历，默认{
+    childField: 'children',
+    reverse: false,
+  }
  * @returns {any[]} 新的一棵树
  */
-function mapDeep(tree, iterator, children = 'children', isReverse = false) {
+function mapDeep(tree, iterator, options = {
+    childField: 'children',
+    reverse: false
+}) {
+    const { childField = 'children', reverse = false } = isObject(options) ? options : {};
     let isBreak = false;
     const newTree = [];
     const walk = (arr, parent, newTree, level = 0) => {
-        if (isReverse) {
+        if (reverse) {
             for (let i = arr.length - 1; i >= 0; i--) {
                 if (isBreak) {
                     break;
                 }
-                const re = iterator(arr[i], i, arr, tree, parent, level);
+                const item = arr[i];
+                const re = iterator(item, i, arr, tree, parent, level);
                 if (re === false) {
                     isBreak = true;
                     break;
@@ -165,16 +161,14 @@ function mapDeep(tree, iterator, children = 'children', isReverse = false) {
                 else if (re === true) {
                     continue;
                 }
-                newTree.push(objectOmit(re, [children]));
-                // @ts-ignore
-                if (arr[i] && Array.isArray(arr[i][children])) {
-                    newTree[newTree.length - 1][children] = [];
-                    // @ts-ignore
-                    walk(arr[i][children], arr[i], newTree[newTree.length - 1][children], level + 1);
+                newTree.push(objectOmit(re, [childField]));
+                if (item && Array.isArray(item[childField])) {
+                    newTree[newTree.length - 1][childField] = [];
+                    walk(item[childField], item, newTree[newTree.length - 1][childField], level + 1);
                 }
                 else {
                     // children非有效数组时，移除该属性字段
-                    delete re[children];
+                    delete re[childField];
                 }
             }
         }
@@ -183,7 +177,8 @@ function mapDeep(tree, iterator, children = 'children', isReverse = false) {
                 if (isBreak) {
                     break;
                 }
-                const re = iterator(arr[i], i, arr, tree, parent, level);
+                const item = arr[i];
+                const re = iterator(item, i, arr, tree, parent, level);
                 if (re === false) {
                     isBreak = true;
                     break;
@@ -191,16 +186,14 @@ function mapDeep(tree, iterator, children = 'children', isReverse = false) {
                 else if (re === true) {
                     continue;
                 }
-                newTree.push(objectOmit(re, [children]));
-                // @ts-ignore
-                if (arr[i] && Array.isArray(arr[i][children])) {
-                    newTree[newTree.length - 1][children] = [];
-                    // @ts-ignore
-                    walk(arr[i][children], arr[i], newTree[newTree.length - 1][children], level + 1);
+                newTree.push(objectOmit(re, [childField]));
+                if (item && Array.isArray(item[childField])) {
+                    newTree[newTree.length - 1][childField] = [];
+                    walk(item[childField], item, newTree[newTree.length - 1][childField], level + 1);
                 }
                 else {
                     // children非有效数组时，移除该属性字段
-                    delete re[children];
+                    delete re[childField];
                 }
             }
         }
@@ -214,30 +207,30 @@ function mapDeep(tree, iterator, children = 'children', isReverse = false) {
  * 在树中找到 id 为某个值的节点，并返回上游的所有父级节点
  *
  * @param {ArrayLike<T>} tree - 树形数据
- * @param {IdLike} nodeId - 元素ID
- * @param {ITreeConf} config - 迭代配置项
- * @returns {[IdLike[], ITreeItem<V>[]]} - 由parentId...childId, parentObject-childObject组成的二维数组
+ * @param {number | string} nodeId - 目标元素ID
+ * @param {ITreeConf} options - 迭代配置项, 默认：{ children = 'children', id = 'id' }
+ * @returns {[(number | string)[], V[]]} - 由parentId...childId, parentObject-childObject组成的二维数组
  */
-function searchTreeById(tree, nodeId, config) {
-    const { children = 'children', id = 'id' } = config || {};
+function searchTreeById(tree, nodeId, options = { childField: 'children', keyField: 'id' }) {
+    const { childField = 'children', keyField = 'id' } = isObject(options) ? options : {};
     const toFlatArray = (tree, parentId, parent) => {
         return tree.reduce((t, _) => {
-            const child = _[children];
+            const child = _[childField];
             return [
                 ...t,
                 parentId ? { ..._, parentId, parent } : _,
-                ...(child && child.length ? toFlatArray(child, _[id], _) : [])
+                ...(child && child.length ? toFlatArray(child, _[keyField], _) : [])
             ];
         }, []);
     };
     const getIds = (flatArray) => {
-        let child = flatArray.find(_ => _[id] === nodeId);
+        let child = flatArray.find(_ => _[keyField] === nodeId);
         const { parent, parentId, ...other } = child;
         let ids = [nodeId], nodes = [other];
         while (child && child.parentId) {
             ids = [child.parentId, ...ids];
             nodes = [child.parent, ...nodes];
-            child = flatArray.find(_ => _[id] === child.parentId); // eslint-disable-line
+            child = flatArray.find(_ => _[keyField] === child.parentId); // eslint-disable-line
         }
         return [ids, nodes];
     };

package/{lib/es → dist/esm}/type.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.13.0
+ * sculp-js v1.13.2
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/{lib/es → dist/esm}/unique.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.13.0
+ * sculp-js v1.13.2
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/{lib/es → dist/esm}/url.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.13.0
+ * sculp-js v1.13.2
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/{lib/es → dist/esm}/validator.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.13.0
+ * sculp-js v1.13.2
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/{lib/es → dist/esm}/variable.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.13.0
+ * sculp-js v1.13.2
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/{lib/es → dist/esm}/watermark.js

@@ -1,5 +1,5 @@
 /*!
- * sculp-js v1.13.0
+ * sculp-js v1.13.2
  * (c) 2023-present chandq
  * Released under the MIT License.
  */

package/dist/types/array.d.ts

@@ -0,0 +1,50 @@
+import { AnyArray } from './type';
+/**
+ * 遍历数组，返回 false 中断遍历(支持continue和break操作)
+ *
+ * @param {ArrayLike<V>} array
+ * @param {(val: V, idx: number) => any} iterator 迭代函数, 返回值为true时continue, 返回值为false时break
+ * @param {boolean} reverse  是否倒序
+ * @returns {*}
+ */
+export declare function arrayEach<V>(array: ArrayLike<V>, iterator: (val: V, idx: number, arr: ArrayLike<V>) => boolean | void, reverse?: boolean): void;
+/**
+ * 异步遍历数组，返回 false 中断遍历
+ * @param {ArrayLike<V>} array 数组
+ * @param {(val: V, idx: number) => Promise<any>} iterator  支持Promise类型的回调函数
+ * @param {boolean} reverse  是否反向遍历
+ * @example
+ *    使用范例如下:
+ * const start = async () => {
+ *   await arrayEachAsync(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++;
+ *    }
+ * }
+ */
+export declare function arrayEachAsync<V>(array: ArrayLike<V>, iterator: (val: V, idx: number) => Promise<any> | any, reverse?: boolean): Promise<void>;
+/**
+ * 插入到目标位置之前
+ * @param {AnyArray} array
+ * @param {number} start
+ * @param {number} to
+ * @returns {*}
+ */
+export declare function arrayInsertBefore(array: AnyArray, start: number, to: number): void;
+/**
+ * 数组删除指定项目
+ * @param {V[]} array
+ * @param {(val: V, idx: number) => boolean} expect
+ * @returns {V[]}
+ */
+export declare function arrayRemove<V>(array: V[], expect: (val: V, idx: number) => boolean): V[];
+//# sourceMappingURL=array.d.ts.map

package/dist/types/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/array.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAqB,MAAM,QAAQ,CAAC;AAErD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,OAAO,GAAG,IAAI,EACpE,OAAO,UAAQ,GACd,IAAI,CAgBN;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,EACrD,OAAO,UAAQ,GACd,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAOlF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,CAAC,EAAE,CAexF"}

package/dist/types/async.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 等待一段时间
+ * @param {number} timeout 等待时间，单位毫秒
+ * @returns {Promise<void>}
+ */
+export declare function wait(timeout?: number): Promise<void>;
+/**
+ * 异步遍历
+ * @ref https://github.com/Kevnz/async-tools/blob/master/src/mapper.js
+ * @ref https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/@@iterator
+ * @param {Array<T>} list
+ * @param {(val: T, idx: number, list: ArrayLike<T>) => Promise<R>} mapper
+ * @param {number} concurrency 并发数量，默认无限
+ * @returns {Promise<R[]>}
+ */
+export declare function asyncMap<T, R>(list: Array<T>, mapper: (val: T, idx: number, list: Array<T>) => Promise<R>, concurrency?: number): Promise<R[]>;
+/**
+ * Execute a promise safely
+ *
+ * @param { Promise } promise
+ * @param { Object= } errorExt - Additional Information you can pass safeAwait the err object
+ * @return { Promise }
+ * @example
+ * async function asyncTaskWithCb(cb) {
+     let err, user, savedTask, notification;
+
+     [ err, user ] = await safeAwait(UserModel.findById(1));
+     if(!user) return cb('No user found');
+
+     [ err, savedTask ] = await safeAwait(TaskModel({userId: user.id, name: 'Demo Task'}));
+     if(err) return cb('Error occurred while saving task')
+
+    cb(null, savedTask);
+}
+ */
+export declare function safeAwait<T, U = Error>(promise: Promise<T>, errorExt?: object): Promise<[U, undefined] | [null, T]>;
+//# sourceMappingURL=async.d.ts.map

package/dist/types/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../src/async.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAC3B,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC3D,WAAW,SAAW,GACrB,OAAO,CAAC,CAAC,EAAE,CAAC,CAsCd;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAWnH"}

package/dist/types/base64.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 字符串编码成Base64, 平替浏览器的btoa, 不包含中文的处理 （适用于任何环境，包括小程序）
+ * @param {string} string
+ * @returns {string}
+ */
+export declare function weBtoa(string: string): string;
+/**
+ * Base64解码为原始字符串，平替浏览器的atob, 不包含中文的处理（适用于任何环境，包括小程序）
+ * @param {string} string
+ * @returns {string}
+ */
+export declare function weAtob(string: string): string;
+/**
+ * 将base64编码的字符串转换为原始字符串，包括对中文内容的处理(高性能，且支持Web、Node、小程序等任意平台)
+ * @param base64 base64编码的字符串
+ * @returns 原始字符串，包括中文内容
+ */
+export declare function b64decode(base64: string): string;
+/**
+ * 将原始字符串，包括中文内容，转换为base64编码的字符串(高性能，且支持Web、Node、小程序等任意平台)
+ * @param rawStr 原始字符串，包括中文内容
+ * @returns base64编码的字符串
+ */
+export declare function b64encode(rawStr: string): string;
+//# sourceMappingURL=base64.d.ts.map

package/dist/types/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../src/base64.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAwB7C;AACD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAyB7C;AAcD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAYhD;AACD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAahD"}

package/dist/types/clipboard.d.ts

@@ -0,0 +1,20 @@
+import { AsyncCallback } from './type';
+type CopyTextOptions = AsyncCallback & {
+    container?: HTMLElement;
+};
+/**
+ * 复制文本，优先使用navigator.clipboard，仅在安全上下文(HTTPS/localhost)下生效，若不支持则回退使用execCommand方式
+ * @param {string} text
+ * @param {CopyTextOptions} options 可选参数：成功回调successCallback、失败回调failCallback、容器元素container
+ *                      （默认document.body, 当不支持clipboard时必须传复制按钮元素，包裹模拟选择操作的临时元素，
+ *                        解决脱离文档流的元素无法复制的问题，如Modal内复制操作)
+ */
+export declare function copyText(text: string, options?: CopyTextOptions): void;
+/**
+ * 使用execCommand方式复制文本
+ * @param text
+ * @param options
+ */
+export declare function fallbackCopyText(text: string, options?: CopyTextOptions): void;
+export {};
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/types/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../src/clipboard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAyB,MAAM,QAAQ,CAAC;AAE9D,KAAK,eAAe,GAAG,aAAa,GAAG;IAAE,SAAS,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAEnE;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAiBtE;AACD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAyB9E"}

package/dist/types/cloneDeep.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 深拷贝堪称完全体 即：任何类型的数据都会被深拷贝
+ *
+ * 包含对null、原始值、对象循环引用的处理
+ *
+ * 对Map、Set、ArrayBuffer、Date、RegExp、Array、Object及原型链属性方法执行深拷贝
+ * @param {T} source
+ * @param {WeakMap} map
+ * @returns {T}
+ */
+export declare function cloneDeep<T>(source: T, map?: WeakMap<any, any>): T;
+//# sourceMappingURL=cloneDeep.d.ts.map

package/dist/types/cloneDeep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloneDeep.d.ts","sourceRoot":"","sources":["../../src/cloneDeep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,oBAA0B,GAAG,CAAC,CA+GxE"}

package/dist/types/cookie.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 获取cookie
+ * @param {string} name
+ * @returns {string}
+ */
+export declare function cookieGet(name: string): string;
+/**
+ * 设置 cookie
+ * @param {string} name
+ * @param {string} value
+ * @param {number | Date} [maxAge]
+ */
+export declare function cookieSet(name: string, value: string, maxAge?: number | Date): void;
+/**
+ * 删除单个 cookie
+ * @param name cookie 名称
+ */
+export declare const cookieDel: (name: string) => void;
+//# sourceMappingURL=cookie.d.ts.map

package/dist/types/cookie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../../src/cookie.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAe9C;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAsBnF;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,IAA+B,CAAC"}

package/dist/types/core-index.d.ts

@@ -0,0 +1,17 @@
+export * from './array';
+export * from './date';
+export * from './object';
+export * from './path';
+export * from './string';
+export * from './type';
+export * from './async';
+export * from './func';
+export * from './random';
+export * from './number';
+export * from './unique';
+export * from './tree';
+export * from './math';
+export * from './base64';
+export * from './validator';
+export * from './variable';
+//# sourceMappingURL=core-index.d.ts.map

package/dist/types/core-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-index.d.ts","sourceRoot":"","sources":["../../src/core-index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/types/date.d.ts

@@ -0,0 +1,74 @@
+export declare const isValidDate: (any: unknown) => any is Date;
+export interface DateObj {
+    [propName: string]: string;
+}
+export type DateValue = number | string | Date;
+/**
+ * 解析为Date对象
+ * @param {DateValue} value - 可以是数值、字符串或 Date 对象
+ * @returns {Date} - 转换后的目标Date
+ */
+export declare function dateParse(value: DateValue): Date;
+/**
+ * 格式化为日期对象(带自定义格式化模板)
+ * @param {DateValue} value 可以是数值、字符串或 Date 对象
+ * @param {string} [format] 模板，默认是 YYYY-MM-DD HH:mm:ss，模板字符：
+ * - YYYY：年
+ * - yyyy: 年
+ * - MM：月
+ * - DD：日
+ * - dd: 日
+ * - HH：时（24 小时制）
+ * - hh：时（12 小时制）
+ * - mm：分
+ * - ss：秒
+ * - SSS：毫秒
+ * @returns {string}
+ */
+/**
+ * 将日期转换为一天的开始时间，即0点0分0秒0毫秒
+ * @param {DateValue} value
+ * @returns {Date}
+ */
+export declare function dateToStart(value: DateValue): Date;
+/**
+ * 将日期转换为一天的结束时间，即23点59分59秒999毫秒
+ * @param {DateValue} value
+ * @returns {Date}
+ */
+export declare function dateToEnd(value: DateValue): Date;
+/**
+ * 格式化为日期对象(带自定义格式化模板)
+ * @param {Date} value - 可以是数值、字符串或 Date 对象
+ * @param {string} [format] - 模板，默认是 YYYY-MM-DD HH:mm:ss，模板字符：
+ * - YYYY：年
+ * - yyyy: 年
+ * - MM：月
+ * - DD：日
+ * - dd: 日
+ * - HH：时（24 小时制）
+ * - mm：分
+ * - ss：秒
+ * - SSS：毫秒
+ * - ww: 周
+ * @returns {string}  格式化后的日期字符串
+ */
+export declare function formatDate(value: DateValue, format?: string): string;
+/**
+ * 计算向前或向后N天的具体日期
+ * @param {DateValue} originDate - 参考日期
+ * @param {number} n - 正数：向后推算；负数：向前推算
+ * @param {string} sep - 日期格式的分隔符
+ * @returns {string} 计算后的目标日期
+ */
+export declare function calculateDate(originDate: DateValue, n: number, sep?: string): string;
+/**
+ * 计算向前或向后N天的具体日期时间
+ * @param {DateValue} originDateTime - 参考日期时间
+ * @param {number} n - 正数：向后推算；负数：向前推算
+ * @param {string} dateSep - 日期分隔符
+ * @param {string} timeSep - 时间分隔符
+ * @returns {string} 转换后的目标日期时间
+ */
+export declare function calculateDateTime(originDateTime: DateValue, n: number, dateSep?: string, timeSep?: string): string;
+//# sourceMappingURL=date.d.ts.map

package/dist/types/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/date.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,QAAS,OAAO,gBAAsD,CAAC;AAE/F,MAAM,WAAW,OAAO;IACtB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAqC/C;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAmBhD;AAED;;;;;;;;;;;;;;;GAeG;AA2BH;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAGlD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAIhD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,SAAwB,GAAG,MAAM,CA0BnF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,MAAY,GAAG,MAAM,CAazF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,SAAS,EACzB,CAAC,EAAE,MAAM,EACT,OAAO,GAAE,MAAY,EACrB,OAAO,GAAE,MAAY,GACpB,MAAM,CA2BR"}

package/dist/types/dom.d.ts

@@ -0,0 +1,74 @@
+import { EasingName } from './easing';
+export interface Style {
+    [propName: string]: string | number;
+}
+/**
+ * 判断元素是否包含某个样式名
+ * @param {HTMLElement} el
+ * @param {string} className
+ * @returns {boolean}
+ */
+export declare function hasClass(el: HTMLElement, className: string): boolean;
+/**
+ * 给元素增加样式名
+ * @param {HTMLElement} el
+ * @param {string} classNames
+ */
+export declare function addClass(el: HTMLElement, classNames: string): void;
+/**
+ * 给元素移除样式名
+ * @param {HTMLElement} el
+ * @param {string} classNames
+ */
+export declare function removeClass(el: HTMLElement, classNames: string): void;
+export interface SetStyle {
+    (el: HTMLElement, key: string, val: string): void;
+    (el: HTMLElement, style: Style): void;
+}
+/**
+ * 设置元素样式
+ * @param {HTMLElement} el
+ * @param {string | Style} key
+ * @param {string} val
+ */
+export declare const setStyle: SetStyle;
+/**
+ * 获取元素样式
+ * @param {HTMLElement} el 元素
+ * @param {string} key
+ * @returns {string}
+ */
+export declare function getStyle(el: HTMLElement, key: string): string;
+type ScrollElement = HTMLElement | Document | Window;
+export interface SmoothScrollOptions {
+    el: ScrollElement;
+    to: number;
+    duration: number;
+    easing: EasingName;
+}
+export declare function smoothScroll(options?: Partial<SmoothScrollOptions>): Promise<void>;
+/**
+ * 获取元素样式属性的计算值
+ * @param {HTMLElement} el
+ * @param {string} property
+ * @param {boolean} reNumber
+ * @returns {string|number}
+ */
+export declare function getComputedCssVal(el: HTMLElement, property: string, reNumber?: boolean): string | number;
+/**
+ * 字符串的像素宽度
+ * @param {string} str 目标字符串
+ * @param {number} fontSize 字符串字体大小
+ * @param {boolean} isRemove 计算后是否移除创建的dom元素
+ * @returns {*}
+ */
+export declare function getStrWidthPx(str: string, fontSize?: number, isRemove?: boolean): number;
+/**
+ * Programmatically select the text of a HTML element
+ *
+ * @param {HTMLElement} element The element whose text you wish to select
+ * @returns
+ */
+export declare function select(element: HTMLElement): any;
+export {};
+//# sourceMappingURL=dom.d.ts.map

package/dist/types/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/dom.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,UAAU,EAAE,MAAM,UAAU,CAAC;AAKxD,MAAM,WAAW,KAAK;IACpB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAGpE;AAQD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAElE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAErE;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACvC;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,QAQtB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,KAAK,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;AACrD,MAAM,WAAW,mBAAmB;IAElC,EAAE,EAAE,aAAa,CAAC;IAElB,EAAE,EAAE,MAAM,CAAC;IAEX,QAAQ,EAAE,MAAM,CAAC;IAEjB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDlF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAc,GAAG,MAAM,GAAG,MAAM,CAG9G;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,EAAE,QAAQ,GAAE,OAAc,GAAG,MAAM,CA2BlG;AACD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,WAAW,OAyC1C"}