sculp-js 0.0.1

package/lib/cjs/type.js

@@ -0,0 +1,47 @@
+/*!
+ * sculp-js v0.0.1
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const typeIs = (any) => Object.prototype.toString.call(any).slice(8, -1);
+// 基本数据类型判断
+const isString = (any) => typeof any === 'string';
+const isBoolean = (any) => typeof any === 'boolean';
+const isSymbol = (any) => typeof any === 'symbol';
+const isBigInt = (any) => typeof any === 'bigint';
+const isNumber = (any) => typeof any === 'number' && !Number.isNaN(any);
+const isUndefined = (any) => typeof any === 'undefined';
+const isNull = (any) => any === null;
+const isPrimitive = (any) => any === null || typeof any !== 'object';
+// 复合数据类型判断
+const isObject = (any) => typeIs(any) === 'Object';
+const isArray = (any) => Array.isArray(any);
+// eslint-disable-next-line @typescript-eslint/ban-types
+const isFunction = (any) => typeof any === 'function';
+// 对象类型判断
+const isNaN = (any) => Number.isNaN(any);
+const isDate = (any) => typeIs(any) === 'Date';
+const isError = (any) => typeIs(any) === 'Error';
+const isRegExp = (any) => typeIs(any) === 'RegExp';
+
+exports.default = typeIs;
+exports.isArray = isArray;
+exports.isBigInt = isBigInt;
+exports.isBoolean = isBoolean;
+exports.isDate = isDate;
+exports.isError = isError;
+exports.isFunction = isFunction;
+exports.isNaN = isNaN;
+exports.isNull = isNull;
+exports.isNumber = isNumber;
+exports.isObject = isObject;
+exports.isPrimitive = isPrimitive;
+exports.isRegExp = isRegExp;
+exports.isString = isString;
+exports.isSymbol = isSymbol;
+exports.isUndefined = isUndefined;

package/lib/cjs/url.js

@@ -0,0 +1,84 @@
+/*!
+ * sculp-js v0.0.1
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+'use strict';
+
+var path = require('./path.js');
+var qs = require('./qs.js');
+
+const anchorEl = document.createElement('a');
+/**
+ * url 解析
+ * @param {string} url
+ * @returns {Url}
+ */
+const urlParse = (url) => {
+    anchorEl.href = url;
+    const { protocol, username, password, host, port, hostname, hash, search, pathname: _pathname } = anchorEl;
+    // fix: ie 浏览器下，解析出来的 pathname 是没有 / 根的
+    const pathname = path.pathJoin('/', _pathname);
+    const auth = username && password ? `${username}:${password}` : '';
+    const query = search.replace(/^\?/, '');
+    const searchParams = qs.qsParse(query);
+    const path$1 = `${pathname}${search}`;
+    return {
+        protocol,
+        auth,
+        username,
+        password,
+        host,
+        port,
+        hostname,
+        hash,
+        search,
+        searchParams,
+        query,
+        pathname,
+        path: path$1,
+        href: url
+    };
+};
+/**
+ * url 字符化，url 对象里的 searchParams 会覆盖 url 原有的查询参数
+ * @param {Url} url
+ * @returns {string}
+ */
+const urlStringify = (url) => {
+    const { protocol, auth, host, pathname, searchParams, hash } = url;
+    const authorize = auth ? `${auth}@` : '';
+    const querystring = qs.qsStringify(searchParams);
+    const search = querystring ? `?${querystring}` : '';
+    let hashstring = hash.replace(/^#/, '');
+    hashstring = hashstring ? '#' + hashstring : '';
+    return `${protocol}//${authorize}${host}${pathname}${search}${hashstring}`;
+};
+/**
+ * 设置 url 查询参数
+ * @param {string} url
+ * @param {AnyObject} setter
+ * @returns {string}
+ */
+const urlSetParams = (url, setter) => {
+    const p = urlParse(url);
+    Object.assign(p.searchParams, setter);
+    return urlStringify(p);
+};
+/**
+ * 删除 url 查询参数
+ * @param {string} url
+ * @param {string[]} removeKeys
+ * @returns {string}
+ */
+const urlDelParams = (url, removeKeys) => {
+    const p = urlParse(url);
+    removeKeys.forEach(key => delete p.searchParams[key]);
+    return urlStringify(p);
+};
+
+exports.urlDelParams = urlDelParams;
+exports.urlParse = urlParse;
+exports.urlSetParams = urlSetParams;
+exports.urlStringify = urlStringify;

package/lib/cjs/watermark.js

@@ -0,0 +1,91 @@
+/*!
+ * sculp-js v0.0.1
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+'use strict';
+
+/*
+ * @created: Saturday, 2020-04-18 14:38:23
+ * @author: chendq
+ * ---------
+ * @desc 网页加水印的工具类
+ */
+/**
+ * canvas 实现 watermark
+ * @param {ICanvasWM} canvasWM
+ */
+const genCanvasWM = (canvasWM) => {
+    const { container = document.body, width = '300px', height = '200px', textAlign = 'center', textBaseline = 'middle', font = '20px PingFangSC-Medium,PingFang SC', 
+    // fontWeight = 500,
+    fillStyle = 'rgba(189, 177, 167, .3)', content = '请勿外传', rotate = 30, zIndex = 2147483647 } = canvasWM;
+    // 仅限主页面添加水印
+    if (!location.pathname.includes('/home')) {
+        return;
+    }
+    const args = canvasWM;
+    const canvas = document.createElement('canvas');
+    canvas.setAttribute('width', width);
+    canvas.setAttribute('height', height);
+    const ctx = canvas.getContext('2d');
+    ctx.textAlign = textAlign;
+    ctx.textBaseline = textBaseline;
+    ctx.font = font;
+    // ctx!.fontWeight = fontWeight;
+    ctx.fillStyle = fillStyle;
+    ctx.rotate((Math.PI / 180) * rotate);
+    ctx.fillText(content, parseFloat(width) / 4, parseFloat(height) / 2);
+    const base64Url = canvas.toDataURL();
+    const __wm = document.querySelector('.__wm');
+    const watermarkDiv = __wm || document.createElement('div');
+    const styleStr = `opacity: 1 !important; display: block !important; visibility: visible !important;         position:absolute;          left:0; top:0;         width:100%;          height:100%;          z-index:${zIndex};          pointer-events:none;          background-repeat:repeat;          background-image:url('${base64Url}')`;
+    watermarkDiv.setAttribute('style', styleStr);
+    watermarkDiv.classList.add('__wm');
+    watermarkDiv.classList.add('nav-height');
+    if (!__wm) {
+        container.style.position = 'relative';
+        container.appendChild(watermarkDiv);
+    }
+    const getMutableStyle = (ele) => {
+        const computedStle = getComputedStyle(ele);
+        return {
+            opacity: computedStle.getPropertyValue('opacity'),
+            zIndex: computedStle.getPropertyValue('z-index'),
+            display: computedStle.getPropertyValue('display'),
+            visibility: computedStle.getPropertyValue('visibility')
+        };
+    };
+    //@ts-ignore
+    const MutationObserver = window.MutationObserver || window.WebKitMutationObserver;
+    if (MutationObserver) {
+        let mo = new MutationObserver(function () {
+            const __wm = document.querySelector('.__wm'); // 只在__wm元素变动才重新调用 __canvasWM
+            if (!__wm) {
+                // 避免一直触发
+                // console.log('regenerate watermark by delete::')
+                mo.disconnect();
+                mo = null;
+                genCanvasWM(JSON.parse(JSON.stringify(args)));
+            }
+            else {
+                const { opacity, zIndex, display, visibility } = getMutableStyle(__wm);
+                if ((__wm && __wm.getAttribute('style') !== styleStr) ||
+                    !__wm ||
+                    !(opacity === '1' && zIndex === '2147483647' && display === 'block' && visibility === 'visible')) {
+                    // 避免一直触发
+                    // console.log('regenerate watermark by inline style changed ::')
+                    mo.disconnect();
+                    mo = null;
+                    container.removeChild(__wm);
+                    genCanvasWM(JSON.parse(JSON.stringify(args)));
+                }
+            }
+        });
+        mo.observe(container, { attributes: true, subtree: true, childList: true });
+    }
+};
+// 调用
+// __canvasWM({ content: 'QQMusicFE' })
+
+exports.genCanvasWM = genCanvasWM;

package/lib/es/array.js

@@ -0,0 +1,208 @@
+/*!
+ * sculp-js v0.0.1
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+import { objectHas } from './object.js';
+import { isArray, isString, isObject } from './type.js';
+
+/**
+ * 判断一个对象是否为类数组
+ * @param any
+ * @returns {boolean}
+ */
+const arrayLike = (any) => {
+    if (isArray(any))
+        return true;
+    if (isString(any))
+        return true;
+    if (!isObject(any))
+        return false;
+    return objectHas(any, 'length');
+};
+/**
+ * 遍历数组，返回 false 中断遍历
+ * @param {ArrayLike<V>} array
+ * @param {(val: V, idx: number) => any} iterator
+ * @param reverse {boolean} 是否倒序
+ */
+const arrayEach = (array, iterator, reverse = false) => {
+    if (reverse) {
+        for (let idx = array.length - 1; idx >= 0; idx--) {
+            const val = array[idx];
+            if (iterator(val, idx) === false)
+                break;
+        }
+    }
+    else {
+        for (let idx = 0; idx < array.length; idx++) {
+            const val = array[idx];
+            if (iterator(val, idx) === false)
+                break;
+        }
+    }
+};
+/**
+ * 异步遍历数组，返回 false 中断遍历
+ * @param {ArrayLike<V>} array
+ * @param {(val: V, idx: number) => Promise<any>} iterator
+ * @param {boolean} reverse
+ */
+async function arrayEachAsync(array, iterator, reverse = false) {
+    if (reverse) {
+        for (let idx = array.length - 1; idx >= 0; idx--) {
+            const val = array[idx];
+            if ((await iterator(val, idx)) === false)
+                break;
+        }
+    }
+    else {
+        for (let idx = 0; idx < array.length; idx++) {
+            const val = array[idx];
+            if ((await iterator(val, idx)) === false)
+                break;
+        }
+    }
+}
+/**
+ * 插入到目标位置之前
+ * @param {AnyArray} array
+ * @param {number} start
+ * @param {number} to
+ */
+const arrayInsertBefore = (array, start, to) => {
+    if (start === to || start + 1 === to)
+        return;
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    const [source] = array.splice(start, 1);
+    const insertIndex = to < start ? to : to - 1;
+    array.splice(insertIndex, 0, source);
+};
+/**
+ * 数组删除指定项目
+ * @param {V[]} array
+ * @param {(val: V, idx: number) => boolean} expect
+ * @returns {V[]}
+ */
+function arrayRemove(array, expect) {
+    const indexes = [];
+    // 这里重命名一下：是为了杜绝 jest 里的 expect 与之产生检查错误
+    // eslint 的 jest 语法检查是遇到 expect 函数就以为是单元测试
+    const _expect = expect;
+    arrayEach(array, (val, idx) => {
+        if (_expect(val, idx))
+            indexes.push(idx);
+    });
+    indexes.forEach((val, idx) => array.splice(val - idx, 1));
+    return array;
+}
+/**
+ * 自定义深度优先遍历函数(支持continue和break操作)
+ * @param {array} deepList
+ * @param {function} iterator
+ * @param {array} children
+ * @param {boolean} isReverse 是否反向遍历
+ */
+const deepTraversal = (deepList, iterator, children = 'children', isReverse = false) => {
+    let level = 0;
+    const walk = (arr, parent) => {
+        if (isReverse) {
+            for (let i = arr.length - 1; i >= 0; i--) {
+                const re = iterator(arr[i], i, deepList, parent, level);
+                if (re === 'break') {
+                    break;
+                }
+                else if (re === 'continue') {
+                    continue;
+                }
+                // @ts-ignore
+                if (Array.isArray(arr[i][children])) {
+                    ++level;
+                    // @ts-ignore
+                    walk(arr[i][children], arr[i]);
+                }
+            }
+        }
+        else {
+            for (let i = 0; i < arr.length; i++) {
+                const re = iterator(arr[i], i, deepList, parent, level);
+                if (re === 'break') {
+                    break;
+                }
+                else if (re === 'continue') {
+                    continue;
+                }
+                // @ts-ignore
+                if (Array.isArray(arr[i][children])) {
+                    ++level;
+                    // @ts-ignore
+                    walk(arr[i][children], arr[i]);
+                }
+            }
+        }
+    };
+    walk(deepList, null);
+};
+/**
+ * 在树中找到 id 为某个值的节点，并返回上游的所有父级节点
+ * @param {ArrayLike<T>} tree
+ * @param {IdLike} nodeId
+ * @param {ITreeConf} config
+ * @return {[IdLike[], ITreeItem<V>[]]}
+ */
+function getTreeIds(tree, nodeId, config) {
+    const { children = 'children', id = 'id' } = config || {};
+    const toFlatArray = (tree, parentId, parent) => {
+        return tree.reduce((t, _) => {
+            const child = _[children];
+            return [
+                ...t,
+                parentId ? { ..._, parentId, parent } : _,
+                ...(child && child.length ? toFlatArray(child, _[id], _) : [])
+            ];
+        }, []);
+    };
+    const getIds = (flatArray) => {
+        let child = flatArray.find(_ => _[id] === 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);
+        }
+        return [ids, nodes];
+    };
+    return getIds(toFlatArray(tree));
+}
+/**
+ * 异步ForEach函数
+ * @param {array} array
+ * @param {asyncFuntion} callback
+ * // asyncForEach 使用范例如下
+// const start = async () => {
+//   await asyncForEach(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++;
+//    }
+// }
+ * @return {*}
+ */
+async function asyncForEach(array, callback) {
+    for (let index = 0, len = array.length; index < len; index++) {
+        await callback(array[index], index, array);
+    }
+}
+
+export { arrayEach, arrayEachAsync, arrayInsertBefore, arrayLike, arrayRemove, asyncForEach, deepTraversal, getTreeIds };

package/lib/es/async.js

@@ -0,0 +1,60 @@
+/*!
+ * sculp-js v0.0.1
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+/**
+ * 等待一段时间
+ * @param {number} timeout 等待时间，单位毫秒
+ * @returns {Promise<void>}
+ */
+async function wait(timeout = 1) {
+    return new Promise(resolve => setTimeout(resolve, timeout));
+}
+/**
+ * 异步遍历
+ * @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[]>}
+ */
+async function asyncMap(list, mapper, concurrency = Infinity) {
+    return new Promise((resolve, reject) => {
+        const iterator = list[Symbol.iterator]();
+        const limit = Math.min(list.length, concurrency);
+        const resolves = [];
+        let resolvedLength = 0;
+        let rejected;
+        let index = 0;
+        const next = () => {
+            if (rejected)
+                return reject(rejected);
+            const it = iterator.next();
+            if (it.done) {
+                if (resolvedLength === list.length)
+                    resolve(resolves);
+                return;
+            }
+            const current = index++;
+            mapper(it.value, current, list)
+                .then(value => {
+                resolvedLength++;
+                resolves[current] = value;
+                next();
+            })
+                .catch(err => {
+                rejected = err;
+                next();
+            });
+        };
+        // 开始
+        for (let i = 0; i < limit; i++) {
+            next();
+        }
+    });
+}
+
+export { asyncMap, wait };

package/lib/es/clipboard.js

@@ -0,0 +1,34 @@
+/*!
+ * sculp-js v0.0.1
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+import { setStyle } from './dom.js';
+
+const textEl = document.createElement('textarea');
+setStyle(textEl, {
+    position: 'absolute',
+    top: '-9999px',
+    left: '-9999px',
+    opacity: 0
+});
+document.body.appendChild(textEl);
+/**
+ * 复制文本
+ * @param {string} text
+ */
+const copyText = (text) => {
+    textEl.value = text;
+    textEl.focus({ preventScroll: true });
+    textEl.select();
+    try {
+        document.execCommand('copy');
+        textEl.blur();
+    }
+    catch (err) {
+        // ignore
+    }
+};
+
+export { copyText };

package/lib/es/cookie.js

@@ -0,0 +1,59 @@
+/*!
+ * sculp-js v0.0.1
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+import { isNumber, isDate } from './type.js';
+
+/**
+ * 获取cookie
+ * @param {string} name
+ * @returns {string}
+ */
+const cookieGet = (name) => {
+    const { cookie } = document;
+    if (!cookie)
+        return '';
+    const result = cookie.split(';');
+    for (let i = 0; i < result.length; i++) {
+        const item = result[i];
+        const [key, val = ''] = item.split('=');
+        if (key === name)
+            return decodeURIComponent(val);
+    }
+    return '';
+};
+/**
+ * 设置 cookie
+ * @param {string} name
+ * @param {string} value
+ * @param {number | Date} [maxAge]
+ */
+const cookieSet = (name, value, maxAge) => {
+    const metas = [];
+    const EXPIRES = 'expires';
+    metas.push([name, encodeURIComponent(value)]);
+    if (isNumber(maxAge)) {
+        const d = new Date();
+        d.setTime(d.getTime() + maxAge);
+        metas.push([EXPIRES, d.toUTCString()]);
+    }
+    else if (isDate(maxAge)) {
+        metas.push([EXPIRES, maxAge.toUTCString()]);
+    }
+    metas.push(['path', '/']);
+    document.cookie = metas
+        .map(item => {
+        const [key, val] = item;
+        return `${key}=${val}`;
+    })
+        .join(';');
+};
+/**
+ * 删除单个 cookie
+ * @param name cookie 名称
+ */
+const cookieDel = (name) => cookieSet(name, '', -1);
+
+export { cookieDel, cookieGet, cookieSet };

package/lib/es/date.js

@@ -0,0 +1,110 @@
+/*!
+ * sculp-js v0.0.1
+ * (c) 2023-2023 chandq
+ * Released under the MIT License.
+ */
+
+/**
+ * 格式化为日期对象(带自定义格式化模板)
+ * @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：毫秒
+ * - ww: 周
+ * @returns {string}
+ */
+const formatDate = (date = new Date(), format = 'YYYY-MM-DD HH:mm:ss') => {
+    let fmt = format;
+    let ret;
+    const opt = {
+        'Y+': `${date.getFullYear()}`,
+        'y+': `${date.getFullYear()}`,
+        'M+': `${date.getMonth() + 1}`,
+        'D+': `${date.getDate()}`,
+        'd+': `${date.getDate()}`,
+        'H+': `${date.getHours()}`,
+        'm+': `${date.getMinutes()}`,
+        's+': `${date.getSeconds()}`,
+        'S+': `${date.getMilliseconds()}`,
+        'w+': ['周日', '周一', '周二', '周三', '周四', '周五', '周六'][date.getDay()] // 周
+        // 有其他格式化字符需求可以继续添加，必须转化成字符串
+    };
+    for (const k in opt) {
+        ret = new RegExp('(' + k + ')').exec(fmt);
+        if (ret) {
+            fmt = fmt.replace(ret[1], ret[1].length === 1 ? opt[k] : opt[k].padStart(ret[1].length, '0'));
+        }
+    }
+    return fmt;
+};
+/**
+ * 计算向前或向后N天的具体日期
+ * @param {string} strDate 参考日期
+ * @param {number} n 正数：向后推算；负数：向前推算
+ * @param {string} sep 日期格式的分隔符
+ * @return {*} 目标日期
+ */
+function calculateDate(strDate, n, sep = '-') {
+    //strDate 为字符串日期 如:'2019-01-01' n为你要传入的参数，当前为0，前一天为-1，后一天为1
+    let dateArr = strDate.split(sep); //这边给定一个特定时间
+    let newDate = new Date(+dateArr[0], +dateArr[1] - 1, +dateArr[2]);
+    let befminuts = newDate.getTime() + 1000 * 60 * 60 * 24 * parseInt(String(n)); //计算前几天用减，计算后几天用加，最后一个就是多少天的数量
+    let beforeDat = new Date();
+    beforeDat.setTime(befminuts);
+    let befMonth = beforeDat.getMonth() + 1;
+    let mon = befMonth >= 10 ? befMonth : '0' + befMonth;
+    let befDate = beforeDat.getDate();
+    let da = befDate >= 10 ? befDate : '0' + befDate;
+    let finalNewDate = beforeDat.getFullYear() + '-' + mon + '-' + da;
+    return finalNewDate;
+}
+/**
+ * 计算向前或向后N天的具体时间日期
+ * @param {number} n 正数：向后推算；负数：向前推算
+ * @param {string} dateSep 日期分隔符
+ * @param {string} timeSep 时间分隔符
+ * @return {*}
+ */
+function calculateDateTime(n, dateSep = '-', timeSep = ':') {
+    let date = new Date();
+    let separator1 = '-';
+    let separator2 = ':';
+    let year = date.getFullYear();
+    let month = date.getMonth() + 1;
+    let strDate = date.getDate() + n;
+    if (strDate > new Date(year, month, 0).getDate()) {
+        month += 1;
+        strDate -= new Date(year, month, 0).getDate();
+        if (month > 12) {
+            year += 1;
+            month = 1;
+        }
+    }
+    if (month >= 1 && month <= 9) {
+        month = '0' + month;
+    }
+    if (strDate >= 0 && strDate <= 9) {
+        strDate = '0' + strDate;
+    }
+    return (year +
+        separator1 +
+        month +
+        separator1 +
+        strDate +
+        ' ' +
+        date.getHours() +
+        separator2 +
+        date.getMinutes() +
+        separator2 +
+        date.getSeconds());
+}
+
+export { calculateDate, calculateDateTime, formatDate };