@scx-js/scx-common 0.0.1 → 0.0.2

package/index.js

@@ -1,13 +1,13 @@
-export * from "../scx-dom/Download.js";
-export * from "../scx-dom/FixedElement.js";
-export * from "../scx-dom/HtmlToText.js";
-export * from "../scx-dom/Watermark.js";
-export * from "./multi_map/MultiMap.js";
-export * from "./tree/ScxTreeHelper.js";
-export * from "./util/ArrayUtils.js";
-export * from "./util/MathUtils.js";
-export * from "./util/ObjectUtils.js";
-export * from "./util/RandomUtils.js";
-export * from "./util/ThrottleUtils.js";
-export * from "./util/TypeUtils.js";
-export * from "./util/URLUtils.js";
+export * from "../scx-dom/Download.js";
+export * from "../scx-dom/FixedElement.js";
+export * from "../scx-dom/HtmlToText.js";
+export * from "../scx-dom/Watermark.js";
+export * from "./multi_map/MultiMap.js";
+export * from "./tree/ScxTreeHelper.js";
+export * from "./util/ArrayUtils.js";
+export * from "./util/MathUtils.js";
+export * from "./util/ObjectUtils.js";
+export * from "./util/RandomUtils.js";
+export * from "./util/ThrottleUtils.js";
+export * from "./util/TypeUtils.js";
+export * from "./util/URLUtils.js";

package/multi_map/MultiMap.js

@@ -1,51 +1,51 @@
-class MultiMap {
-
-    map = {};
-
-    clear() {
-        this.map = {};
-    }
-
-    delete(key, value) {
-        const values = this.map[key];
-        if (values) {
-            let index = values.indexOf(value);
-            //可能会添加多个
-            while (index !== -1) {
-                values.splice(index, 1);
-                index = values.indexOf(value);
-            }
-            if (values.length === 0) {
-                delete this.map[key];
-            }
-        }
-    }
-
-    forEach(callback) {
-        for (let mapKey in this.map) {
-            const mapValues = this.map[mapKey];
-            for (let mapValue of mapValues) {
-                callback(mapKey, mapValue);
-            }
-        }
-    }
-
-    get(key) {
-        return key in this.map ? this.map[key] : [];
-    }
-
-    has(key) {
-        return key in this.map;
-    }
-
-    set(key, value) {
-        if (key in this.map) {
-            this.map[key].push(value);
-        } else {
-            this.map[key] = [value];
-        }
-    }
-
-}
-
-export {MultiMap};
+class MultiMap {
+
+    map = {};
+
+    clear() {
+        this.map = {};
+    }
+
+    delete(key, value) {
+        const values = this.map[key];
+        if (values) {
+            let index = values.indexOf(value);
+            //可能会添加多个
+            while (index !== -1) {
+                values.splice(index, 1);
+                index = values.indexOf(value);
+            }
+            if (values.length === 0) {
+                delete this.map[key];
+            }
+        }
+    }
+
+    forEach(callback) {
+        for (let mapKey in this.map) {
+            const mapValues = this.map[mapKey];
+            for (let mapValue of mapValues) {
+                callback(mapKey, mapValue);
+            }
+        }
+    }
+
+    get(key) {
+        return key in this.map ? this.map[key] : [];
+    }
+
+    has(key) {
+        return key in this.map;
+    }
+
+    set(key, value) {
+        if (key in this.map) {
+            this.map[key].push(value);
+        } else {
+            this.map[key] = [value];
+        }
+    }
+
+}
+
+export {MultiMap};

package/package.json

@@ -1,13 +1,13 @@
-{
-  "name": "@scx-js/scx-common",
-  "version": "0.0.1",
-  "description": "SCX Common",
-  "license": "MIT",
-  "author": "scx567888",
-  "main": "index.js",
-  "type": "module",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/scx567888/scx-js.git"
-  }
-}
+{
+  "name": "@scx-js/scx-common",
+  "version": "0.0.2",
+  "description": "SCX Common",
+  "license": "MIT",
+  "author": "scx567888",
+  "main": "index.js",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/scx567888/scx-js.git"
+  }
+}

package/tree/ScxTreeHelper.js

@@ -1,51 +1,51 @@
-import {isNull} from "../util/ObjectUtils.js";
-
-/**
- * 将含有 id parentID 的 list 列表转换为树形结构
- * 这里将 parentID 为 null 或 undefined 的设置为 第一层
- * list 格式要求 [{parentID:null, id:10}, {parentID:10, id:100}]
- */
-function listToTree(source, rawOptions = {}) {
-    const {
-        idFieldName = "id", // id FieId 的名称 默认为 'id'
-        parentIDFieldName = "parentID", // parentID FieId 的名称 默认为 'parentID'
-        childrenFieldName = "children", // children FieId 的名称 默认为 'children'
-        ignoreOrphans = false, // 是否忽略孤儿节点
-    } = rawOptions;
-    //只处理数组结构
-    if (!source || !Array.isArray(source)) {
-        console.warn("listToTree : 数据为空或数据格式有误 (正确情况应为 Array) !!!");
-        return [];
-    }
-    let cloneData = JSON.parse(JSON.stringify(source));  // 对源数据深度克隆
-    const idMap = new Map();
-    const parentIDMap = new Map();
-    for (let t of cloneData) {
-        idMap.set(t[idFieldName], t);
-        const v = parentIDMap.get(t[parentIDFieldName]);
-        if (v) {
-            v.push(t);
-        } else {
-            parentIDMap.set(t[parentIDFieldName], [t]);
-        }
-    }
-    // 循环所有项，并添加 children 属性
-    return cloneData.filter(my => {
-        const myID = my[idFieldName]; //我自己的 id
-        const parentID = my[parentIDFieldName]; //我父亲的 id
-        //判断是否为孤儿 , 如果查询不到他的父级节点 那么他就是孤儿
-        let isOrphan = !ignoreOrphans && (parentID == null || idMap.get(parentID) == null);
-        if (myID) {
-            // 返回每一项的子级数组
-            const myChildren = parentIDMap.get(myID);
-            if (myChildren && myChildren.length > 0) {
-                my[childrenFieldName] = myChildren;
-            }
-        }
-        //需要返回的节点 1, 是根节点 2, 是孤儿节点
-        return isNull(parentID) || isOrphan;
-    });
-
-}
-
-export {listToTree};
+import {isNull} from "../util/ObjectUtils.js";
+
+/**
+ * 将含有 id parentID 的 list 列表转换为树形结构
+ * 这里将 parentID 为 null 或 undefined 的设置为 第一层
+ * list 格式要求 [{parentID:null, id:10}, {parentID:10, id:100}]
+ */
+function listToTree(source, rawOptions = {}) {
+    const {
+        idFieldName = "id", // id FieId 的名称 默认为 'id'
+        parentIDFieldName = "parentID", // parentID FieId 的名称 默认为 'parentID'
+        childrenFieldName = "children", // children FieId 的名称 默认为 'children'
+        ignoreOrphans = false, // 是否忽略孤儿节点
+    } = rawOptions;
+    //只处理数组结构
+    if (!source || !Array.isArray(source)) {
+        console.warn("listToTree : 数据为空或数据格式有误 (正确情况应为 Array) !!!");
+        return [];
+    }
+    let cloneData = JSON.parse(JSON.stringify(source));  // 对源数据深度克隆
+    const idMap = new Map();
+    const parentIDMap = new Map();
+    for (let t of cloneData) {
+        idMap.set(t[idFieldName], t);
+        const v = parentIDMap.get(t[parentIDFieldName]);
+        if (v) {
+            v.push(t);
+        } else {
+            parentIDMap.set(t[parentIDFieldName], [t]);
+        }
+    }
+    // 循环所有项，并添加 children 属性
+    return cloneData.filter(my => {
+        const myID = my[idFieldName]; //我自己的 id
+        const parentID = my[parentIDFieldName]; //我父亲的 id
+        //判断是否为孤儿 , 如果查询不到他的父级节点 那么他就是孤儿
+        let isOrphan = !ignoreOrphans && (parentID == null || idMap.get(parentID) == null);
+        if (myID) {
+            // 返回每一项的子级数组
+            const myChildren = parentIDMap.get(myID);
+            if (myChildren && myChildren.length > 0) {
+                my[childrenFieldName] = myChildren;
+            }
+        }
+        //需要返回的节点 1, 是根节点 2, 是孤儿节点
+        return isNull(parentID) || isOrphan;
+    });
+
+}
+
+export {listToTree};

package/util/ArrayUtils.js

@@ -1,138 +1,138 @@
-/**
- * 拷贝数组 (浅拷贝)
- * @param list
- * @returns {*[]}
- */
-function copyArray(list) {
-    return [...list];
-}
-
-/**
- * 根据 索引 从数组中移除 项
- * @param list
- * @param index
- */
-function removeByIndex(list, index) {
-    list.splice(index, 1);
-}
-
-/**
- * 内部用 所以不进行 index 是否越界的校验
- * @param list a
- * @param oldIndex a
- * @param newIndex a
- */
-function moveItemByIndex(list, oldIndex, newIndex) {
-    //经过计算 后有可能导致 索引没变化 这时就不需要在移动一次了
-    if (oldIndex !== newIndex) {
-        //保存临时数据
-        const oldItem = list[oldIndex];
-        //从原数组中移除数据
-        list.splice(oldIndex, 1);
-        //在指定位置插入新数据
-        list.splice(newIndex, 0, oldItem);
-    }
-}
-
-/**
- * 根据 索引 从数组中上移 项
- * @param list 列表
- * @param index 索引
- * @param loop 是否采用循环
- * @param step 步长
- */
-function moveUpByIndex(list, index, loop = false, step = 1) {
-    let minIndex = 0;
-    let nextIndex = index - step;
-    if (nextIndex < minIndex) {
-        nextIndex = loop ? nextIndex % list.length + list.length : minIndex;
-    }
-    return moveItemByIndex(list, index, nextIndex);
-}
-
-/**
- * 根据 索引 从数组中下移 项
- * @param list 列表
- * @param index 索引
- * @param loop 是否采用循环
- * @param step 步长
- */
-function moveDownByIndex(list, index, loop = false, step = 1) {
-    let maxIndex = list.length - 1;
-    let nextIndex = index + step;
-    if (nextIndex > maxIndex) {
-        nextIndex = loop ? nextIndex % list.length : maxIndex;
-    }
-    return moveItemByIndex(list, index, nextIndex);
-}
-
-/**
- * 根据 项 从数组中移除 项
- * @param list
- * @param item
- */
-function removeByItem(list, item) {
-    return removeByIndex(list, list.indexOf(item));
-}
-
-/**
- * 根据 项 从数组中上移 项
- * @param list 列表
- * @param item 项
- * @param loop 是否采用循环
- * @param step 步长
- */
-function moveUpByItem(list, item, loop = false, step = 1) {
-    return moveUpByIndex(list, list.indexOf(item), loop, step);
-}
-
-/**
- * 根据 项 从数组中下移 项
- * @param list 列表
- * @param item 项
- * @param loop 是否采用循环
- * @param step 步长
- */
-function moveDownByItem(list, item, loop = false, step = 1) {
-    return moveDownByIndex(list, list.indexOf(item), loop, step);
-}
-
-/**
- * 在指定位置插入数据
- * @param list 列表
- * @param index 插入索引
- * @param items 项
- */
-function insertItem(list, index, ...items) {
-    if (index < 0) {
-        list.unshift(...items);
-    } else if (index > list.length) {
-        list.push(...items);
-    } else {
-        list.splice(index, 0, ...items);
-    }
-}
-
-function arrayEquals(array1, array2) {
-    if (array1.length !== array2.length) {
-        return false;
-    }
-    for (let i = 0; i < array1.length; i++) {
-        if (array1[i] !== array2[i]) {
-            return false;
-        }
-    }
-    return true;
-}
-
-export {
-    copyArray,
-    removeByIndex,
-    moveUpByIndex,
-    moveDownByIndex,
-    removeByItem,
-    moveUpByItem,
-    moveDownByItem,
-    insertItem,
-    arrayEquals,
-};
+/**
+ * 拷贝数组 (浅拷贝)
+ * @param list
+ * @returns {*[]}
+ */
+function copyArray(list) {
+    return [...list];
+}
+
+/**
+ * 根据 索引 从数组中移除 项
+ * @param list
+ * @param index
+ */
+function removeByIndex(list, index) {
+    list.splice(index, 1);
+}
+
+/**
+ * 内部用 所以不进行 index 是否越界的校验
+ * @param list a
+ * @param oldIndex a
+ * @param newIndex a
+ */
+function moveItemByIndex(list, oldIndex, newIndex) {
+    //经过计算 后有可能导致 索引没变化 这时就不需要在移动一次了
+    if (oldIndex !== newIndex) {
+        //保存临时数据
+        const oldItem = list[oldIndex];
+        //从原数组中移除数据
+        list.splice(oldIndex, 1);
+        //在指定位置插入新数据
+        list.splice(newIndex, 0, oldItem);
+    }
+}
+
+/**
+ * 根据 索引 从数组中上移 项
+ * @param list 列表
+ * @param index 索引
+ * @param loop 是否采用循环
+ * @param step 步长
+ */
+function moveUpByIndex(list, index, loop = false, step = 1) {
+    let minIndex = 0;
+    let nextIndex = index - step;
+    if (nextIndex < minIndex) {
+        nextIndex = loop ? nextIndex % list.length + list.length : minIndex;
+    }
+    return moveItemByIndex(list, index, nextIndex);
+}
+
+/**
+ * 根据 索引 从数组中下移 项
+ * @param list 列表
+ * @param index 索引
+ * @param loop 是否采用循环
+ * @param step 步长
+ */
+function moveDownByIndex(list, index, loop = false, step = 1) {
+    let maxIndex = list.length - 1;
+    let nextIndex = index + step;
+    if (nextIndex > maxIndex) {
+        nextIndex = loop ? nextIndex % list.length : maxIndex;
+    }
+    return moveItemByIndex(list, index, nextIndex);
+}
+
+/**
+ * 根据 项 从数组中移除 项
+ * @param list
+ * @param item
+ */
+function removeByItem(list, item) {
+    return removeByIndex(list, list.indexOf(item));
+}
+
+/**
+ * 根据 项 从数组中上移 项
+ * @param list 列表
+ * @param item 项
+ * @param loop 是否采用循环
+ * @param step 步长
+ */
+function moveUpByItem(list, item, loop = false, step = 1) {
+    return moveUpByIndex(list, list.indexOf(item), loop, step);
+}
+
+/**
+ * 根据 项 从数组中下移 项
+ * @param list 列表
+ * @param item 项
+ * @param loop 是否采用循环
+ * @param step 步长
+ */
+function moveDownByItem(list, item, loop = false, step = 1) {
+    return moveDownByIndex(list, list.indexOf(item), loop, step);
+}
+
+/**
+ * 在指定位置插入数据
+ * @param list 列表
+ * @param index 插入索引
+ * @param items 项
+ */
+function insertItem(list, index, ...items) {
+    if (index < 0) {
+        list.unshift(...items);
+    } else if (index > list.length) {
+        list.push(...items);
+    } else {
+        list.splice(index, 0, ...items);
+    }
+}
+
+function arrayEquals(array1, array2) {
+    if (array1.length !== array2.length) {
+        return false;
+    }
+    for (let i = 0; i < array1.length; i++) {
+        if (array1[i] !== array2[i]) {
+            return false;
+        }
+    }
+    return true;
+}
+
+export {
+    copyArray,
+    removeByIndex,
+    moveUpByIndex,
+    moveDownByIndex,
+    removeByItem,
+    moveUpByItem,
+    moveDownByItem,
+    insertItem,
+    arrayEquals,
+};

package/util/MathUtils.js

@@ -1,20 +1,20 @@
-/**
- * a
- * @param value1 {number|string}
- * @param value2 {number|string}
- * @param fractionDigits {number}
- * @returns {number}
- */
-function percentage(value1, value2, fractionDigits = 2) {
-    const v1 = parseFloat(value1);
-    const v2 = parseFloat(value2);
-    if (!isNaN(v1) && !isNaN(v2)) {
-        return parseFloat(((v1 / v2) * 100).toFixed(fractionDigits));
-    } else {
-        return NaN;
-    }
-}
-
-export {
-    percentage,
-};
+/**
+ * a
+ * @param value1 {number|string}
+ * @param value2 {number|string}
+ * @param fractionDigits {number}
+ * @returns {number}
+ */
+function percentage(value1, value2, fractionDigits = 2) {
+    const v1 = parseFloat(value1);
+    const v2 = parseFloat(value2);
+    if (!isNaN(v1) && !isNaN(v2)) {
+        return parseFloat(((v1 / v2) * 100).toFixed(fractionDigits));
+    } else {
+        return NaN;
+    }
+}
+
+export {
+    percentage,
+};

package/util/ObjectUtils.js

@@ -1,32 +1,32 @@
-/**
- *
- * @param o {any}
- * @returns {any}
- */
-function deepCopy(o) {
-    //这里用一种简单粗暴的方式实现 深拷贝 不过这样会使对象上的方法丢失 不建议用于一些复杂对象
-    return JSON.parse(JSON.stringify(o));
-}
-
-function isNull(o) {
-    return !notNull(o);
-}
-
-function notNull(o) {
-    return o !== undefined && o !== null;
-}
-
-/**
- * 判断字符串 不为空
- * @param str
- * @returns {boolean}
- */
-function notBlank(str) {
-    return notNull(str) ? str.toString().trim() !== "" : false;
-}
-
-function isBlank(str) {
-    return !notBlank(str);
-}
-
-export {deepCopy, isNull, notNull, isBlank, notBlank};
+/**
+ *
+ * @param o {any}
+ * @returns {any}
+ */
+function deepCopy(o) {
+    //这里用一种简单粗暴的方式实现 深拷贝 不过这样会使对象上的方法丢失 不建议用于一些复杂对象
+    return JSON.parse(JSON.stringify(o));
+}
+
+function isNull(o) {
+    return !notNull(o);
+}
+
+function notNull(o) {
+    return o !== undefined && o !== null;
+}
+
+/**
+ * 判断字符串 不为空
+ * @param str
+ * @returns {boolean}
+ */
+function notBlank(str) {
+    return notNull(str) ? str.toString().trim() !== "" : false;
+}
+
+function isBlank(str) {
+    return !notBlank(str);
+}
+
+export {deepCopy, isNull, notNull, isBlank, notBlank};

package/util/RandomUtils.js

@@ -1,10 +1,10 @@
-function randomUUID() {
-    const temp_url = URL.createObjectURL(new Blob());
-    const uuid = temp_url.toString();
-    URL.revokeObjectURL(temp_url);
-    return uuid.substring(uuid.lastIndexOf("/") + 1);
-}
-
-export {
-    randomUUID,
-};
+function randomUUID() {
+    const temp_url = URL.createObjectURL(new Blob());
+    const uuid = temp_url.toString();
+    URL.revokeObjectURL(temp_url);
+    return uuid.substring(uuid.lastIndexOf("/") + 1);
+}
+
+export {
+    randomUUID,
+};

package/util/ThrottleUtils.js

@@ -1,26 +1,26 @@
-/**
- * 使用 requestAnimationFrame 进行节流
- * @param callback
- * @return 带有节流的 callback
- */
-function rafThrottle(callback) {
-    let requestId = null;
-    const throttled = function (...arg) {
-        if (requestId) {
-            return;
-        }
-        requestId = requestAnimationFrame(() => {
-            requestId = null;
-            callback.apply(this, arg);
-        });
-    };
-    throttled.cancel = () => {
-        cancelAnimationFrame(requestId);
-        requestId = null;
-    };
-    return throttled;
-}
-
-export {
-    rafThrottle,
-};
+/**
+ * 使用 requestAnimationFrame 进行节流
+ * @param callback
+ * @return 带有节流的 callback
+ */
+function rafThrottle(callback) {
+    let requestId = null;
+    const throttled = function (...arg) {
+        if (requestId) {
+            return;
+        }
+        requestId = requestAnimationFrame(() => {
+            requestId = null;
+            callback.apply(this, arg);
+        });
+    };
+    throttled.cancel = () => {
+        cancelAnimationFrame(requestId);
+        requestId = null;
+    };
+    return throttled;
+}
+
+export {
+    rafThrottle,
+};

package/util/TypeUtils.js

@@ -1,27 +1,27 @@
-function isString(s) {
-    return typeof s === "string" || s instanceof String;
-}
-
-function isNumber(n) {
-    return typeof n === "number" || n instanceof Number;
-}
-
-function isFunction(f) {
-    return typeof f === "function" || f instanceof Function;
-}
-
-function isObject(o) {
-    return Object.prototype.toString.call(o) === "[object Object]";
-}
-
-function isArray(value) {
-    return Array.isArray(value);
-}
-
-export {
-    isFunction,
-    isString,
-    isObject,
-    isNumber,
-    isArray,
-};
+function isString(s) {
+    return typeof s === "string" || s instanceof String;
+}
+
+function isNumber(n) {
+    return typeof n === "number" || n instanceof Number;
+}
+
+function isFunction(f) {
+    return typeof f === "function" || f instanceof Function;
+}
+
+function isObject(o) {
+    return Object.prototype.toString.call(o) === "[object Object]";
+}
+
+function isArray(value) {
+    return Array.isArray(value);
+}
+
+export {
+    isFunction,
+    isString,
+    isObject,
+    isNumber,
+    isArray,
+};

package/util/URLUtils.js

@@ -1,43 +1,43 @@
-import {notBlank} from "./ObjectUtils.js";
-
-/**
- * 是否是外链
- * @param {string} url
- * @returns {boolean}
- */
-function isExternal(url) {
-    return /^(https?:|mailto:|tel:)/.test(url);
-}
-
-/**
- * 是否是 http 路径
- * @param url
- * @returns {boolean}
- */
-function isHttpURL(url) {
-    return /^(https?:)/.test(url);
-}
-
-/**
- * 清理路径
- * @param url
- * @returns {*|string}
- */
-function cleanURL(url) {
-    return url.join("/").split("/").filter(notBlank).join("/");
-}
-
-
-/**
- * 拼接 http url
- * @returns {*}
- * @param baseURL
- * @param urls
- */
-function joinURL(baseURL, ...urls) {
-    return new URL(cleanURL(urls), baseURL);
-}
-
-export {
-    isExternal, isHttpURL, cleanURL, joinURL,
-};
+import {notBlank} from "./ObjectUtils.js";
+
+/**
+ * 是否是外链
+ * @param {string} url
+ * @returns {boolean}
+ */
+function isExternal(url) {
+    return /^(https?:|mailto:|tel:)/.test(url);
+}
+
+/**
+ * 是否是 http 路径
+ * @param url
+ * @returns {boolean}
+ */
+function isHttpURL(url) {
+    return /^(https?:)/.test(url);
+}
+
+/**
+ * 清理路径
+ * @param url
+ * @returns {*|string}
+ */
+function cleanURL(url) {
+    return url.join("/").split("/").filter(notBlank).join("/");
+}
+
+
+/**
+ * 拼接 http url
+ * @returns {*}
+ * @param baseURL
+ * @param urls
+ */
+function joinURL(baseURL, ...urls) {
+    return new URL(cleanURL(urls), baseURL);
+}
+
+export {
+    isExternal, isHttpURL, cleanURL, joinURL,
+};