iota-utools 0.0.6 → 0.0.7

package/README.md

@@ -1,124 +1,147 @@
-## iota-tools
-
-### 类型判断：
-
-```ts
-// 数据类型
-function etTypeof(value: any): string
-
-// 是否是数组
-function isArray(value: any): boolean
-
-// 是否是布尔值
-function isBoolean(value: any): boolean
-
-// 是否是字符串类型
-function isString(value: any): boolean
-
-// 是否是数字
-function isNumber(value: any): boolean
-
-// 是否是object 类型 - @::
-function isObject(value: any): boolean
-
-// 是否是一个方法
-function isFunction(value: any): boolean
-
-// 是否是一个Map
-function isMap(value: any): boolean
-
-// 是否是一个Set 类型
-function isSet(value: any): boolean
-
-// 是否是一个Symbol 类型
-function isSymbol(value: any): boolean
-```
-
-### 复制文本的方法
-
-```ts
-// 复制文本
-function copyText(text: string): void
-```
-
-### 阻塞进程方法
-
-```ts
-// 阻塞进程
-function sleep(ms: number): void
-```
-
-### LocalStorage 存取
-
-```ts
-// 向 localStorage 存数据
-function setLocalStorage(key: string, data: any)
-
-// 向 localStorage 取数据
-function getLocalStorage(key: string): any
-
-// 移除 localStorage 数据
-function removeLocalStorageKey(...args: string[])
-```
-
-### SessionStorage 存取
-
-```ts
-// 向 sessionStorage 存数据
-function setSessionStorage(key: string, data: any)
-
-// 向 sessionStorage 取数据
-function getSessionStorage(key: string): any
-
-// 移除 sessionStorage 数据
-function removeSessionStorageKey(...args: string[])
-```
-
-### params 处理
-
-```ts
-// 将字符串转成对象 {key:value}
-function decodeParams(queryString: string)
-
-// 将对象转成 ?key=value&key=value
-function encodeParams(query: Record<string, any>)
-```
-
-### 拉流、文件流下载
-
-```ts
-// 下载文件流
-function downFile(stream: string | ArrayBuffer, name: string, mimeType: string = "text/plain;charset=utf-8")
-
-// 拉流且下载文件流
-function downStream(path: string, defaultName: string, token?: string, params?: Record<string, any>)
-```
-
-### 数组处理方法
-
-```ts
-// 根据key 类型数据去去重
-function uniqueArrayByProperty<T>(array: T[], key: keyof T): T[]
-```
-
-### Tree 数据处理
-
-```ts
-// 树 -> 扁平树
-function toFlatTree(origin: TreeData[])
-
-// 扁平树 -> 树
-function toTreeFlat<T extends TreeData>(origin: T[], parentId: number | string = "root")
-
-// 深拷贝
-function deepClone<T = any>(obj: T): T
-
-// 删除某个节点 纯函数
-function deleteTreeNode<T extends TreeData>(origin: T[], id: string | number, key: keyof T = "id"): T[]
-
-// 查找某个节点
-function findTreeNode<T extends TreeData>(origin: T[], findValue: any, key: keyof T = "id"): T | null
-
-// 模糊查询 树节点
-function fuzzySearchTree<T extends TreeData>(treeData: T[], findStr: string, label: keyof T = "title"): T[]
-```
+## iota-tools
+
+### 类型判断：
+
+```ts
+// 数据类型
+function etTypeof(value: any): string
+
+// 是否是数组
+function isArray(value: any): boolean
+
+// 是否是布尔值
+function isBoolean(value: any): boolean
+
+// 是否是字符串类型
+function isString(value: any): boolean
+
+// 是否是数字
+function isNumber(value: any): boolean
+
+// 是否是object 类型 - @::
+function isObject(value: any): boolean
+
+// 是否是一个方法
+function isFunction(value: any): boolean
+
+// 是否是一个Map
+function isMap(value: any): boolean
+
+// 是否是一个Set 类型
+function isSet(value: any): boolean
+
+// 是否是一个Symbol 类型
+function isSymbol(value: any): boolean
+```
+
+### 复制文本的方法
+
+```ts
+// 复制文本
+function copyText(text: string): void
+```
+
+### 阻塞进程方法
+
+```ts
+// 进程阻塞
+function sleep(ms: number): void
+```
+
+### LocalStorage 存取
+
+```ts
+// 向 localStorage 存数据
+function setLocalStorage(key: string, data: any)
+
+// 向 localStorage 取数据
+function getLocalStorage(key: string): any
+
+// 移除 localStorage 数据
+function removeLocalStorageKey(...args: string[])
+```
+
+### SessionStorage 存取
+
+```ts
+// 向 sessionStorage 存数据
+function setSessionStorage(key: string, data: any)
+
+// 向 sessionStorage 取数据
+function getSessionStorage(key: string): any
+
+// 移除 sessionStorage 数据
+function removeSessionStorageKey(...args: string[])
+```
+
+### 拉流、文件流下载
+
+```ts
+// 下载文件流
+function downFile(stream: string | ArrayBuffer, name: string, mimeType: string = "text/plain;charset=utf-8")
+
+// 拉流且下载文件流
+function downStream(path: string, defaultName: string, token?: string, params?: Record<string, any>)
+```
+
+### 数组处理方法
+
+```ts
+// 根据key 类型数据去去重
+function uniqueArrayByProperty<T>(array: T[], key: keyof T): T[]
+```
+
+### object 数据处理
+
+```ts
+// 对象扁平话
+function flattenObject(obj: any, parentKey: string = "", res: any = {})
+
+// 扁平反转
+function unflattenObject(obj: any)
+```
+
+### 字符处理
+
+```ts
+// 字符串format 替换
+function format(str:string,...args:string[]):string
+
+// 模版字符串替换
+function templateReplace(str:string, data:Record<string,any>,egex: RegExp = /\(\((\w+)\)\)/g):string
+
+// 将字符串转成对象 {key:value}
+function decodeParams(queryString: string)
+
+// 将对象转成 ?key=value&key=value
+function encodeParams(query: Record<string, any>)
+```
+
+### Tree 数据处理
+
+```ts
+// 树 -> 扁平树
+function toFlatTree(origin: TreeData[]
+
+// 扁平树 -> 树
+function toTreeFlat<T extends TreeData>(origin: T[], parentId: number | string = "root")
+
+// 深拷贝
+function deepClone<T = any>(obj: T): T
+
+// 删除某个节点 纯函数
+function deleteTreeNode<T extends TreeData>(origin: T[], id: string | number, key: keyof T = "id"): T[]
+
+// 查找某个节点 - 返回同指针数据
+function findTreeNode<T extends TreeData>(origin: T[], findValue: any, key: keyof T = "id"): T | null
+
+// 模糊查询 树节点
+function fuzzySearchTree<T extends TreeData>(treeData: T[], findStr: string, label: keyof T = "title"): T[]
+```
+
+### 异步
+
+```ts
+// promsie 借鉴awit-to的设计 向作者致敬
+function awitto<T>(promise: Promise<T>):  Promise<[any, T | null]>
+```

package/lib/cjs/datatree/deepClone.js

@@ -0,0 +1,30 @@
+
+(function(l, r) { if (!l || l.getElementById('livereloadscript')) return; r = l.createElement('script'); r.async = 1; r.src = '//' + (self.location.host || 'localhost').split(':')[0] + ':35729/livereload.js?snipver=1'; r.id = 'livereloadscript'; l.getElementsByTagName('head')[0].appendChild(r) })(self.document);
+'use strict';
+
+/**
+ * @description: 深拷贝
+ * @param {any} obj
+ * @return {*} obj
+ */
+const deepClone = (obj) => {
+    if (obj === null || typeof obj !== "object") {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        const arrCopy = [];
+        for (const item of obj) {
+            arrCopy.push(deepClone(item));
+        }
+        return arrCopy;
+    }
+    const objCopy = {};
+    for (const key in obj) {
+        if (obj.hasOwnProperty(key)) {
+            objCopy[key] = deepClone(obj[key]);
+        }
+    }
+    return objCopy;
+};
+
+exports.deepClone = deepClone;

package/lib/cjs/datatree/deleteTreeNode.js

@@ -0,0 +1,20 @@
+
+(function(l, r) { if (!l || l.getElementById('livereloadscript')) return; r = l.createElement('script'); r.async = 1; r.src = '//' + (self.location.host || 'localhost').split(':')[0] + ':35729/livereload.js?snipver=1'; r.id = 'livereloadscript'; l.getElementsByTagName('head')[0].appendChild(r) })(self.document);
+'use strict';
+
+/**
+ * @description: 过滤筛选树 -- search tree
+ * @param origin 数据源
+ * @param id
+ * @return new tree data  纯函数
+ */
+function deleteTreeNode(origin, id, key = "id") {
+    return origin.filter((node) => {
+        if (node.children) {
+            node.children = deleteTreeNode(node.children, id, key);
+        }
+        return node[key] !== id;
+    });
+}
+
+exports.deleteTreeNode = deleteTreeNode;

package/lib/cjs/datatree/findTreeNode.js

@@ -0,0 +1,32 @@
+
+(function(l, r) { if (!l || l.getElementById('livereloadscript')) return; r = l.createElement('script'); r.async = 1; r.src = '//' + (self.location.host || 'localhost').split(':')[0] + ':35729/livereload.js?snipver=1'; r.id = 'livereloadscript'; l.getElementsByTagName('head')[0].appendChild(r) })(self.document);
+'use strict';
+
+/**
+ * @description: 查找树节点
+ * @param origin 数据源
+ * @param findValue 找到节点
+ * @param key 默认id
+ * @return T
+ */
+function findTreeNode(origin, findValue, key = "id") {
+    let result = null;
+    const fun = (data) => {
+        if (Array.isArray(data)) {
+            for (let i = 0; i < data.length; i++) {
+                let item = data[i];
+                if (item[key] === findValue) {
+                    result = item;
+                    return;
+                }
+                if (item.children && item.children.length) {
+                    fun(item.children);
+                }
+            }
+        }
+    };
+    fun(origin);
+    return result;
+}
+
+exports.findTreeNode = findTreeNode;

package/lib/cjs/datatree/fuzzySearchTree.js

@@ -0,0 +1,40 @@
+
+(function(l, r) { if (!l || l.getElementById('livereloadscript')) return; r = l.createElement('script'); r.async = 1; r.src = '//' + (self.location.host || 'localhost').split(':')[0] + ':35729/livereload.js?snipver=1'; r.id = 'livereloadscript'; l.getElementsByTagName('head')[0].appendChild(r) })(self.document);
+'use strict';
+
+/**
+ * @description: 过滤筛选树 -- search tree
+ * @param treeData 数据源
+ * @param findStr 关键字
+ * @param label 关键字段
+ * @return new tree data
+ */
+const fuzzySearchTree = (treeData, findStr, label = "title") => {
+    if (!treeData)
+        return [];
+    let list = [];
+    treeData.forEach((item) => {
+        // 确保label属性是字符串并且包含findStr
+        if (typeof item[label] === "string" && item[label].includes(findStr)) {
+            // 递归处理子节点
+            let children = item.children ? fuzzySearchTree(item.children, findStr, label) : [];
+            // 如果子节点中没有匹配的项，则保留原子节点
+            children = children.length > 0 ? children : item.children;
+            // 构造新的节点，保留匹配的子节点
+            const obj = { ...item, children };
+            list.push(obj);
+        }
+        else if (item.children && item.children.length > 0) {
+            // 如果当前节点不匹配，但有子节点，则递归处理子节点
+            const children = fuzzySearchTree(item.children, findStr, label);
+            // 如果子节点中有匹配的项，则保留当前节点，并更新其子节点
+            if (children.length > 0) {
+                const obj = { ...item, children };
+                list.push(obj);
+            }
+        }
+    });
+    return list;
+};
+
+exports.fuzzySearchTree = fuzzySearchTree;

package/lib/cjs/datatree/toFlatTree.js

@@ -0,0 +1,17 @@
+
+(function(l, r) { if (!l || l.getElementById('livereloadscript')) return; r = l.createElement('script'); r.async = 1; r.src = '//' + (self.location.host || 'localhost').split(':')[0] + ':35729/livereload.js?snipver=1'; r.id = 'livereloadscript'; l.getElementsByTagName('head')[0].appendChild(r) })(self.document);
+'use strict';
+
+/**
+ * @description: tree data -> 扁平树
+ * @param origin 数据源
+ * @return treedata
+ */
+function toFlatTree(origin) {
+    return origin.reduce((res, item) => {
+        const { children, ...i } = item;
+        return res.concat(i, children && children.length ? toFlatTree(children) : []);
+    }, []);
+}
+
+exports.toFlatTree = toFlatTree;

package/lib/cjs/datatree/toTreeFlat.js

@@ -0,0 +1,25 @@
+
+(function(l, r) { if (!l || l.getElementById('livereloadscript')) return; r = l.createElement('script'); r.async = 1; r.src = '//' + (self.location.host || 'localhost').split(':')[0] + ':35729/livereload.js?snipver=1'; r.id = 'livereloadscript'; l.getElementsByTagName('head')[0].appendChild(r) })(self.document);
+'use strict';
+
+/**
+ * @description: 扁平树 -> tree data
+ * @param origins 数据源
+ * @param parentId 父级ID
+ * @return 平铺数据
+ */
+function toTreeFlat(origin, parentId = "root") {
+    // treeArr 变量数据
+    // 第一次：查找所有parentId为的数据组成第一级
+    const child = origin.filter((item) => item.parentId === parentId);
+    // 第一次：循环parentId为数组
+    return child.map((item) => {
+        return {
+            ...item,
+            // 当前存在id（id与parentId应该是必须有的）调用initTree() 查找所有parentId为本id的数据
+            children: toTreeFlat(origin, item.id),
+        };
+    });
+}
+
+exports.toTreeFlat = toTreeFlat;

package/lib/cjs/fileStream/downFile.js

@@ -0,0 +1,33 @@
+
+(function(l, r) { if (!l || l.getElementById('livereloadscript')) return; r = l.createElement('script'); r.async = 1; r.src = '//' + (self.location.host || 'localhost').split(':')[0] + ':35729/livereload.js?snipver=1'; r.id = 'livereloadscript'; l.getElementsByTagName('head')[0].appendChild(r) })(self.document);
+'use strict';
+
+/**
+ * @description: 下载文件
+ * @param stream 文件源，string or buffer
+ * @param name 文件名称
+ * @param mimeType type josn
+ * @return new tree data  纯函数
+ */
+const downFile = (stream, name, mimeType = "text/plain;charset=utf-8") => {
+    // 创建 Blob 对象
+    let blob;
+    if (typeof stream === "string") {
+        blob = new Blob([stream], { type: mimeType });
+    }
+    else {
+        blob = new Blob([stream], { type: mimeType });
+    }
+    // 创建下载链接并触发下载
+    const a = document.createElement("a");
+    a.href = URL.createObjectURL(blob);
+    a.download = name;
+    a.style.display = "none";
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    // 清理创建的 URL 对象
+    URL.revokeObjectURL(a.href);
+};
+
+exports.downFile = downFile;

package/lib/cjs/fileStream/downStream.js

@@ -0,0 +1,48 @@
+
+(function(l, r) { if (!l || l.getElementById('livereloadscript')) return; r = l.createElement('script'); r.async = 1; r.src = '//' + (self.location.host || 'localhost').split(':')[0] + ':35729/livereload.js?snipver=1'; r.id = 'livereloadscript'; l.getElementsByTagName('head')[0].appendChild(r) })(self.document);
+'use strict';
+
+var downFile = require('./downFile.js');
+
+/**
+ * @description: 拉流下载方法
+ * @param path 下载url
+ * @param defaultName 匹配请求如果没有使用名称
+ * @param token 鉴权 Authorization
+ * @param params 参数 object
+ */
+const downStream = (path, defaultName, token, params) => {
+    // 处理查询参数
+    const queryParams = new URLSearchParams(params).toString();
+    const urlWithParams = queryParams ? `${path}?${queryParams}` : path;
+    const xhr = new XMLHttpRequest();
+    xhr.open("GET", urlWithParams);
+    xhr.responseType = "blob";
+    if (token)
+        xhr.setRequestHeader("Authorization", token);
+    xhr.onload = function () {
+        if (xhr.status === 200 || xhr.status === 304) {
+            const disposition = xhr.getResponseHeader("Content-Disposition");
+            let filename = defaultName;
+            // 从 Content-Disposition 中提取文件名
+            if (disposition && disposition.indexOf("attachment") !== -1) {
+                const filenameRegex = /filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/;
+                const matches = filenameRegex.exec(disposition);
+                if (matches != null && matches[1]) {
+                    filename = matches[1].replace(/['"]/g, "");
+                }
+            }
+            // 下载文件
+            downFile.downFile(this.response, filename);
+        }
+        else {
+            console.error(`Failed to download file. Status: ${xhr.status}`);
+        }
+    };
+    xhr.onerror = function () {
+        console.error("Request failed.");
+    };
+    xhr.send();
+};
+
+exports.downStream = downStream;

package/lib/cjs/index.js

@@ -0,0 +1,57 @@
+
+(function(l, r) { if (!l || l.getElementById('livereloadscript')) return; r = l.createElement('script'); r.async = 1; r.src = '//' + (self.location.host || 'localhost').split(':')[0] + ':35729/livereload.js?snipver=1'; r.id = 'livereloadscript'; l.getElementsByTagName('head')[0].appendChild(r) })(self.document);
+'use strict';
+
+var index = require('./storage/index.js');
+var _typeof = require('./utools/typeof.js');
+var sleep = require('./utools/sleep.js');
+var copyText = require('./utools/copyText.js');
+var debounce = require('./utools/debounce.js');
+var throttle = require('./utools/throttle.js');
+var downFile = require('./fileStream/downFile.js');
+var downStream = require('./fileStream/downStream.js');
+var toFlatTree = require('./datatree/toFlatTree.js');
+var toTreeFlat = require('./datatree/toTreeFlat.js');
+var findTreeNode = require('./datatree/findTreeNode.js');
+var fuzzySearchTree = require('./datatree/fuzzySearchTree.js');
+var deleteTreeNode = require('./datatree/deleteTreeNode.js');
+var deepClone = require('./datatree/deepClone.js');
+var generateUUID = require('./uuid/generateUUID.js');
+var generateString = require('./uuid/generateString.js');
+var local = require('./storage/local.js');
+var session = require('./storage/session.js');
+
+
+
+exports.monitorLocalStorage = index.monitorLocalStorage;
+exports.monitorSessionStorage = index.monitorSessionStorage;
+exports.getTypeof = _typeof.getTypeof;
+exports.isArray = _typeof.isArray;
+exports.isBoolean = _typeof.isBoolean;
+exports.isFunction = _typeof.isFunction;
+exports.isMap = _typeof.isMap;
+exports.isNumber = _typeof.isNumber;
+exports.isObject = _typeof.isObject;
+exports.isSet = _typeof.isSet;
+exports.isString = _typeof.isString;
+exports.isSymbol = _typeof.isSymbol;
+exports.sleep = sleep.sleep;
+exports.copyText = copyText.copyText;
+exports.debounce = debounce.debounce;
+exports.throttle = throttle.throttle;
+exports.downFile = downFile.downFile;
+exports.downStream = downStream.downStream;
+exports.toFlatTree = toFlatTree.toFlatTree;
+exports.toTreeFlat = toTreeFlat.toTreeFlat;
+exports.findTreeNode = findTreeNode.findTreeNode;
+exports.fuzzySearchTree = fuzzySearchTree.fuzzySearchTree;
+exports.deleteTreeNode = deleteTreeNode.deleteTreeNode;
+exports.deepClone = deepClone.deepClone;
+exports.generateUUID = generateUUID.generateUUID;
+exports.generateString = generateString.generateString;
+exports.getLocalStorage = local.getLocalStorage;
+exports.removeLocalStorageKey = local.removeLocalStorageKey;
+exports.setLocalStorage = local.setLocalStorage;
+exports.getSessionStorage = session.getSessionStorage;
+exports.removeSessionStorageKey = session.removeSessionStorageKey;
+exports.setSessionStorage = session.setSessionStorage;

package/lib/{storage → cjs/storage}/index.d.ts

@@ -5,3 +5,8 @@
  */
 export * from "./local";
 export * from "./session";
+export declare const monitorLocalStorage: () => void;
+/**
+ * @这个方法实际没多大用
+ */
+export declare const monitorSessionStorage: () => void;

package/lib/cjs/storage/index.js

@@ -0,0 +1,50 @@
+
+(function(l, r) { if (!l || l.getElementById('livereloadscript')) return; r = l.createElement('script'); r.async = 1; r.src = '//' + (self.location.host || 'localhost').split(':')[0] + ':35729/livereload.js?snipver=1'; r.id = 'livereloadscript'; l.getElementsByTagName('head')[0].appendChild(r) })(self.document);
+'use strict';
+
+/**
+ * @web 环境下才能使用注册
+ * 包含了storage 增删改查封装 存储监听等功能
+ * 监听的方式使用的浏览器evet 事件模型
+ */
+// init envet storage change
+const monitorLocalStorage = () => {
+    let originalSetItem = localStorage.setItem;
+    //重写setItem函数
+    localStorage.setItem = function (key, newValue) {
+        //创建setItemEvent事件
+        let event = new Event("localStorage");
+        event.key = key;
+        event.newValue = newValue;
+        //提交setItemEvent事件
+        window.dispatchEvent(event);
+        //执行原setItem函数
+        originalSetItem.call(this, key, newValue);
+    };
+};
+/**
+ * @这个方法实际没多大用
+ */
+const monitorSessionStorage = () => {
+    let originalSetItem = sessionStorage.setItem;
+    //重写setItem函数
+    sessionStorage.setItem = function (key, newValue) {
+        //创建setItemEvent事件
+        let event = new Event("sessionStorage");
+        event.key = key;
+        event.newValue = newValue;
+        //提交setItemEvent事件
+        window.dispatchEvent(event);
+        //执行原setItem函数
+        originalSetItem.call(this, key, newValue);
+    };
+};
+// 用于local 监听
+const monitorStorage = () => {
+    monitorLocalStorage();
+    monitorSessionStorage();
+};
+monitorStorage();
+
+exports.monitorLocalStorage = monitorLocalStorage;
+exports.monitorSessionStorage = monitorSessionStorage;