@d-matrix/utils 1.7.0 → 1.9.0

package/dist/algorithm.js

@@ -1,21 +1,12 @@
-"use strict";
-var __spreadArray = (this && this.__spreadArray) || function (to, from) {
-    for (var i = 0, il = from.length, j = to.length; i < il; i++, j++)
-        to[j] = from[i];
-    return to;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.moveMulti = void 0;
-var removeSymbol = Symbol('Placeholder for removed element');
-var moveMulti = function (arr, indexes, start) {
-    var cloned = arr.slice();
-    for (var i = 0; i < cloned.length; i++) {
+const removeSymbol = Symbol('Placeholder for removed element');
+export const moveMulti = (arr, indexes, start) => {
+    const cloned = arr.slice();
+    for (let i = 0; i < cloned.length; i++) {
         if (indexes.includes(i)) {
             cloned[i] = removeSymbol;
         }
     }
-    var els = arr.filter(function (__, i) { return indexes.includes(i); });
-    cloned.splice.apply(cloned, __spreadArray([start, 0], els));
-    return cloned.filter(function (v) { return v !== removeSymbol; });
+    const els = arr.filter((__, i) => indexes.includes(i));
+    cloned.splice(start, 0, ...els);
+    return cloned.filter((v) => v !== removeSymbol);
 };
-exports.moveMulti = moveMulti;

package/dist/clipboard.js

@@ -1,4 +1,3 @@
-"use strict";
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -8,87 +7,54 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (_) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
+export function writeImage(element) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return new Promise((resolve, reject) => {
+            if (!element)
+                return reject('element is not defined');
+            const canvas = document.createElement('canvas');
+            const ctx = canvas.getContext('2d');
+            if (ctx === null) {
+                reject('canvas 2d context初始化失败');
+                return;
             }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.writeImage = void 0;
-function writeImage(element) {
-    return __awaiter(this, void 0, void 0, function () {
-        return __generator(this, function (_a) {
-            return [2 /*return*/, new Promise(function (resolve, reject) {
-                    if (!element)
-                        return reject('element is not defined');
-                    var canvas = document.createElement('canvas');
-                    var ctx = canvas.getContext('2d');
-                    if (ctx === null) {
-                        reject('canvas 2d context初始化失败');
+            const img = new Image();
+            //浏览器在加载图像时要使用匿名身份验证，以允许跨域资源共享（CORS）。
+            img.crossOrigin = 'anonymous';
+            if (typeof element === 'string') {
+                img.src = element;
+            }
+            else {
+                img.src = element.src;
+            }
+            img.onload = () => {
+                //创建一个画布，赋予画布宽高为图片的原始宽高
+                if (typeof element === 'string') {
+                    canvas.width = img.width;
+                    canvas.height = img.height;
+                }
+                else {
+                    canvas.width = element.naturalWidth;
+                    canvas.height = element.naturalHeight;
+                }
+                //防止有缓存，绘制之前先清除画布
+                ctx.clearRect(0, 0, ctx.canvas.width, ctx.canvas.height);
+                ctx.drawImage(img, 0, 0);
+                //将canvas转为blob
+                canvas.toBlob((blob) => {
+                    if (blob === null) {
+                        reject('canvas to blob失败');
                         return;
                     }
-                    var img = new Image();
-                    //浏览器在加载图像时要使用匿名身份验证，以允许跨域资源共享（CORS）。
-                    img.crossOrigin = 'anonymous';
-                    if (typeof element === 'string') {
-                        img.src = element;
-                    }
-                    else {
-                        img.src = element.src;
-                    }
-                    img.onload = function () {
-                        //创建一个画布，赋予画布宽高为图片的原始宽高
-                        if (typeof element === 'string') {
-                            canvas.width = img.width;
-                            canvas.height = img.height;
-                        }
-                        else {
-                            canvas.width = element.naturalWidth;
-                            canvas.height = element.naturalHeight;
-                        }
-                        //防止有缓存，绘制之前先清除画布
-                        ctx.clearRect(0, 0, ctx.canvas.width, ctx.canvas.height);
-                        ctx.drawImage(img, 0, 0);
-                        //将canvas转为blob
-                        canvas.toBlob(function (blob) {
-                            var _a;
-                            if (blob === null) {
-                                reject('canvas to blob失败');
-                                return;
-                            }
-                            navigator.clipboard
-                                .write([
-                                new ClipboardItem((_a = {},
-                                    _a[blob.type] = blob,
-                                    _a)),
-                            ])
-                                .then(resolve, reject);
-                        });
-                    };
-                })];
+                    navigator.clipboard
+                        .write([
+                        new ClipboardItem({
+                            [blob.type]: blob,
+                        }),
+                    ])
+                        .then(resolve, reject);
+                });
+            };
         });
     });
 }
-exports.writeImage = writeImage;

package/dist/date.js

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRecentYears = exports.rangeOfYears = void 0;
 /**
  * Generates an array of numbers representing a range of years between the start year and the end year.
  *
@@ -8,33 +5,27 @@ exports.getRecentYears = exports.rangeOfYears = void 0;
  * @param {number} end - the ending year of the range (defaults to the current year)
  * @return {number[]} an array of numbers representing the range of years
  */
-var rangeOfYears = function (start, end) {
-    if (end === void 0) { end = new Date().getFullYear(); }
-    return Array(end - start + 1)
-        .fill(start)
-        .map(function (year, index) { return year + index; });
-};
-exports.rangeOfYears = rangeOfYears;
-function getRecentYears(recentYears, type, suffix) {
-    if (suffix === void 0) { suffix = '年'; }
-    var thisYear = new Date().getFullYear();
+export const rangeOfYears = (start, end = new Date().getFullYear()) => Array(end - start + 1)
+    .fill(start)
+    .map((year, index) => year + index);
+export function getRecentYears(recentYears, type, suffix = '年') {
+    const thisYear = new Date().getFullYear();
     if (type === 'number[]') {
-        var result = [];
-        for (var i = 0; i < recentYears; i++) {
+        const result = [];
+        for (let i = 0; i < recentYears; i++) {
             result.push(thisYear - i);
         }
         return result;
     }
     if (type === 'object[]') {
-        var result = [];
-        for (var i = 0; i < recentYears; i++) {
+        const result = [];
+        for (let i = 0; i < recentYears; i++) {
             result.push({
                 value: thisYear - i,
-                label: "" + (thisYear - i) + suffix,
+                label: `${thisYear - i}${suffix}`,
             });
         }
         return result;
     }
     throw new Error('type must be "number[]" or "object[]"');
 }
-exports.getRecentYears = getRecentYears;

package/dist/dom.js

@@ -1,10 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.strip = exports.scrollToTop = void 0;
 /**
  * 元素滚动条滚动到顶部
  */
-function scrollToTop(element) {
+export function scrollToTop(element) {
     if (element) {
         if (element.scrollTop === 0) {
             return;
@@ -18,15 +15,13 @@ function scrollToTop(element) {
         }
     }
 }
-exports.scrollToTop = scrollToTop;
 /**
  * Strips HTML tags from a given string and returns the plain text content.
  *
  * @param {string} html - The HTML string to strip tags from.
  * @return {string} The plain text content of the HTML string.
  */
-function strip(html) {
-    var doc = new DOMParser().parseFromString(html !== null && html !== void 0 ? html : '', 'text/html');
+export function strip(html) {
+    let doc = new DOMParser().parseFromString(html !== null && html !== void 0 ? html : '', 'text/html');
     return doc.body.textContent || '';
 }
-exports.strip = strip;

package/dist/file.d.ts

@@ -36,4 +36,14 @@ export declare function isImageExists(src: string, img?: HTMLImageElement): Prom
 export declare function getFilenameFromContentDispositionHeader(header: {
     ['content-disposition']: string;
 }): string;
+declare const HyperLinkTargets: readonly ["_self", "_black", "_parent", "_top"];
+export declare type HyperLinkTarget = (typeof HyperLinkTargets)[number];
+/**
+ * 文件下载
+ * @param source 文件地址或blob对象
+ * @param fileName 文件名
+ * @param isPreview 是否
+ */
+export declare function download(source: Blob, fileName?: string): void;
+export declare function download(source: string, fileName?: string, target?: HyperLinkTarget): void;
 export {};

package/dist/file.js

@@ -1,4 +1,3 @@
-"use strict";
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -8,48 +7,19 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (_) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFilenameFromContentDispositionHeader = exports.isImageExists = exports.validateImageSize = exports.toImage = void 0;
 /**
  * 转换BlobPart或者文件地址为图片对象
  * @param file 传入文件 或者 url
  * @returns 返回 一个图片详情对象
  */
-var toImage = function (file, options) {
-    return new Promise(function (resolve, reject) {
-        var image = new Image();
+export const toImage = (file, options) => {
+    return new Promise((resolve, reject) => {
+        const image = new Image();
         if (typeof file === 'string') {
             image.src = file;
         }
         else {
-            var blob = URL.createObjectURL(new Blob([file], options));
+            const blob = URL.createObjectURL(new Blob([file], options));
             image.src = blob;
         }
         // 如果有缓存，读缓存
@@ -68,57 +38,64 @@ var toImage = function (file, options) {
         }
     });
 };
-exports.toImage = toImage;
 /**
  * 图片宽，高校验
  * @param file 传入文件 或者 url
  * @param limitSize 限制宽度, 高度
  * @returns isOK: 是否超出宽高; width, height: 图片的宽高
  */
-var validateImageSize = function (file, limitSize, options) { return __awaiter(void 0, void 0, void 0, function () {
-    var image;
-    return __generator(this, function (_a) {
-        switch (_a.label) {
-            case 0: return [4 /*yield*/, exports.toImage(file, options)];
-            case 1:
-                image = _a.sent();
-                return [2 /*return*/, { isOk: image.width <= limitSize.width && image.height <= limitSize.height, width: image.width, height: image.height }];
-        }
-    });
-}); };
-exports.validateImageSize = validateImageSize;
+export const validateImageSize = (file, limitSize, options) => __awaiter(void 0, void 0, void 0, function* () {
+    const image = yield toImage(file, options);
+    return { isOk: image.width <= limitSize.width && image.height <= limitSize.height, width: image.width, height: image.height };
+});
 /**
  * 检测图片地址是否可用
  * @param src 图片地址
  * @param img HTMLImageElement
  * @returns Promise<boolean>
  */
-function isImageExists(src, img) {
-    if (img === void 0) { img = new Image(); }
-    return __awaiter(this, void 0, void 0, function () {
-        return __generator(this, function (_a) {
-            if (!src)
-                return [2 /*return*/, false];
-            return [2 /*return*/, new Promise(function (resolve) {
-                    img.src = src;
-                    img.onload = function () { return resolve(true); };
-                    img.onerror = function () { return resolve(false); };
-                })];
+export function isImageExists(src, img = new Image()) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!src)
+            return false;
+        return new Promise((resolve) => {
+            img.src = src;
+            img.onload = () => resolve(true);
+            img.onerror = () => resolve(false);
         });
     });
 }
-exports.isImageExists = isImageExists;
 /**
  * 从Content-Disposition中获取文件名
  * @param header 包含Content-Disposition, 值为'attachment;filename=%E5%A4%A7%E8%A1%8C%E6%8C%87%E5%AF%BC2024-06-27-2024-06-28.xlsx'
  * @returns string
  *
  */
-function getFilenameFromContentDispositionHeader(header) {
-    var contentDisposition = header['content-disposition'];
+export function getFilenameFromContentDispositionHeader(header) {
+    const contentDisposition = header['content-disposition'];
     if (!contentDisposition)
         return '';
-    var filename = contentDisposition.split('filename=')[1].split(';')[0];
+    const filename = contentDisposition.split('filename=')[1].split(';')[0];
     return decodeURIComponent(filename);
 }
-exports.getFilenameFromContentDispositionHeader = getFilenameFromContentDispositionHeader;
+const HyperLinkTargets = ['_self', '_black', '_parent', '_top'];
+export function download(source, fileName = '', target) {
+    const link = document.createElement('a');
+    if (typeof source === 'string') {
+        if (typeof target === 'string' && HyperLinkTargets.includes(target)) {
+            link.target = target;
+        }
+        else {
+            link.download = fileName;
+        }
+        link.href = source;
+    }
+    if (source instanceof Blob) {
+        const url = window.URL.createObjectURL(source);
+        link.href = url;
+        link.download = fileName;
+    }
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+}

package/dist/index.js

@@ -1,30 +1,8 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.support = exports.file = exports.algorithm = exports.types = exports.date = exports.dom = exports.react = exports.clipboard = void 0;
-exports.clipboard = __importStar(require("./clipboard"));
-exports.react = __importStar(require("./react"));
-exports.dom = __importStar(require("./dom"));
-exports.date = __importStar(require("./date"));
-exports.types = __importStar(require("./types"));
-exports.algorithm = __importStar(require("./algorithm"));
-exports.file = __importStar(require("./file"));
-exports.support = __importStar(require("./support"));
+export * as clipboard from './clipboard';
+export * as react from './react';
+export * as dom from './dom';
+export * as date from './date';
+export * as types from './types';
+export * as algorithm from './algorithm';
+export * as file from './file';
+export * as support from './support';

package/dist/react/enhancedComponent.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+/**
+ * react component 的增强类
+ */
+export declare class EnhancedComponent<P, S> extends React.Component<P, S> {
+    /**
+     * setState 方法的同步版本
+     * @param state
+     * @returns Promise
+     */
+    protected setStateAsync<K extends keyof S>(state: ((prevState: Readonly<S>, props: Readonly<P>) => Pick<S, K> | S | null) | (Pick<S, K> | S | null)): Promise<void>;
+}

package/dist/react/enhancedComponent.js

@@ -0,0 +1,16 @@
+import React from 'react';
+/**
+ * react component 的增强类
+ */
+export class EnhancedComponent extends React.Component {
+    /**
+     * setState 方法的同步版本
+     * @param state
+     * @returns Promise
+     */
+    setStateAsync(state) {
+        return new Promise((resolve) => {
+            this.setState(state, resolve);
+        });
+    }
+}

package/dist/react/index.d.ts

@@ -3,3 +3,5 @@ export * from './useStateCallback';
 export * from './renderToString';
 export * from './useIsMounted';
 export * from './useCopyToClipboard';
+export * from './enhancedComponent';
+export * from './useDeepCompareRef';

package/dist/react/index.js

@@ -1,17 +1,7 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./useDisableContextMenu"), exports);
-__exportStar(require("./useStateCallback"), exports);
-__exportStar(require("./renderToString"), exports);
-__exportStar(require("./useIsMounted"), exports);
-__exportStar(require("./useCopyToClipboard"), exports);
+export * from './useDisableContextMenu';
+export * from './useStateCallback';
+export * from './renderToString';
+export * from './useIsMounted';
+export * from './useCopyToClipboard';
+export * from './enhancedComponent';
+export * from './useDeepCompareRef';

package/dist/react/renderToString.js

@@ -1,13 +1,7 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.cleanup = exports.render = void 0;
-var react_dom_1 = __importDefault(require("react-dom"));
-var container;
-var render = function (element) {
-    return new Promise(function (resolve, reject) {
+import ReactDOM from 'react-dom';
+let container;
+export const render = (element) => {
+    return new Promise((resolve, reject) => {
         if (document === undefined) {
             return reject('只支持浏览器环境');
         }
@@ -15,7 +9,7 @@ var render = function (element) {
         container.id = 'template-container';
         container.style.cssText = 'position: absolute; left: -9999px;';
         document.body.appendChild(container);
-        react_dom_1.default.render(element, container, function () {
+        ReactDOM.render(element, container, () => {
             if (container) {
                 resolve(container.innerHTML);
             }
@@ -25,14 +19,12 @@ var render = function (element) {
         });
     });
 };
-exports.render = render;
-var cleanup = function () {
+export const cleanup = () => {
     if (container === null)
         return;
-    var isUnmounted = react_dom_1.default.unmountComponentAtNode(container);
+    const isUnmounted = ReactDOM.unmountComponentAtNode(container);
     if (isUnmounted) {
         document.body.removeChild(container);
         container = null;
     }
 };
-exports.cleanup = cleanup;

package/dist/react/useCopyToClipboard.js

@@ -1,32 +1,29 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useCopyToClipboard = void 0;
-var react_1 = require("react");
-var useIsMounted_1 = require("./useIsMounted");
-function useCopyToClipboard(props) {
-    var _a = props !== null && props !== void 0 ? props : {}, _b = _a.timeout, timeout = _b === void 0 ? 2000 : _b, onCopy = _a.onCopy, onError = _a.onError;
-    var isMounted = useIsMounted_1.useIsMounted();
-    var _c = react_1.useState(false), isCopied = _c[0], setIsCopied = _c[1];
-    var copyToClipboard = react_1.useCallback(function (value) {
+import { useCallback, useState } from 'react';
+import { useIsMounted } from './useIsMounted';
+export function useCopyToClipboard(props) {
+    const { timeout = 2000, onCopy, onError } = props !== null && props !== void 0 ? props : {};
+    const isMounted = useIsMounted();
+    const [isCopied, setIsCopied] = useState(false);
+    const copyToClipboard = useCallback((value) => {
         var _a;
         if (!isMounted())
             return;
         if (typeof window === 'undefined' || !((_a = navigator.clipboard) === null || _a === void 0 ? void 0 : _a.writeText)) {
-            var error = new Error("Cannot copy to clipboard, navigator.clipboard.writeText is not defined");
+            const error = new Error(`Cannot copy to clipboard, navigator.clipboard.writeText is not defined`);
             if (process.env.NODE_ENV === 'development')
                 console.error(error);
             onError === null || onError === void 0 ? void 0 : onError(error);
             return;
         }
         if (typeof value !== 'string') {
-            var error = new Error("Cannot copy typeof " + typeof value + " to clipboard, must be a string");
+            const error = new Error(`Cannot copy typeof ${typeof value} to clipboard, must be a string`);
             if (process.env.NODE_ENV === 'development')
                 console.error(error);
             onError === null || onError === void 0 ? void 0 : onError(error);
             return;
         }
         if (value === '') {
-            var error = new Error("Cannot copy empty string to clipboard.");
+            const error = new Error(`Cannot copy empty string to clipboard.`);
             if (process.env.NODE_ENV === 'development')
                 console.error(error);
             onError === null || onError === void 0 ? void 0 : onError(error);
@@ -34,15 +31,14 @@ function useCopyToClipboard(props) {
         }
         navigator.clipboard
             .writeText(value)
-            .then(function () {
+            .then(() => {
             setIsCopied(true);
             onCopy === null || onCopy === void 0 ? void 0 : onCopy(value);
-            setTimeout(function () {
+            setTimeout(() => {
                 setIsCopied(false);
             }, timeout);
         })
-            .catch(function (error) { return onError === null || onError === void 0 ? void 0 : onError(error); });
+            .catch((error) => onError === null || onError === void 0 ? void 0 : onError(error));
     }, [onCopy, onError, timeout]);
-    return { isCopied: isCopied, copyToClipboard: copyToClipboard };
+    return { isCopied, copyToClipboard };
 }
-exports.useCopyToClipboard = useCopyToClipboard;

package/dist/react/useDeepCompareRef.d.ts

@@ -0,0 +1,2 @@
+import { DependencyList } from 'react';
+export declare const useDeepCompareRef: (deps: DependencyList) => React.MutableRefObject<number>;

package/dist/react/useDeepCompareRef.js

@@ -0,0 +1,11 @@
+import { useRef } from 'react';
+import isEqual from 'react-fast-compare';
+export const useDeepCompareRef = (deps) => {
+    const ref = useRef();
+    const signalRef = useRef(0);
+    if (deps === undefined || !isEqual(deps, ref.current)) {
+        ref.current = deps;
+        signalRef.current += 1;
+    }
+    return signalRef;
+};

package/dist/react/useDisableContextMenu.js

@@ -1,29 +1,24 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useDisableContextMenu = void 0;
-var react_1 = require("react");
-var defaultContextMenuTarget = function () { return document; };
+import { useEffect, useRef } from "react";
+const defaultContextMenuTarget = () => document;
 /**
  * 在HTML元素上禁用右键菜单
  * @param target 默认为 () => document
  */
-var useDisableContextMenu = function (target) {
-    if (target === void 0) { target = defaultContextMenuTarget; }
-    var targetFn = react_1.useRef(target);
+export const useDisableContextMenu = (target = defaultContextMenuTarget) => {
+    const targetFn = useRef(target);
     targetFn.current = target;
-    react_1.useEffect(function () {
-        var el = targetFn.current();
+    useEffect(() => {
+        const el = targetFn.current();
         if (!el)
             return;
-        var onContextMenu = function (e) {
+        const onContextMenu = (e) => {
             e.preventDefault();
         };
         el.addEventListener('contextmenu', onContextMenu);
-        return function () {
+        return () => {
             if (!el)
                 return;
             el.removeEventListener('contextmenu', onContextMenu);
         };
     }, []);
 };
-exports.useDisableContextMenu = useDisableContextMenu;

package/dist/react/useIsMounted.js

@@ -1,17 +1,13 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useIsMounted = void 0;
-var react_1 = require("react");
+import { useCallback, useEffect, useRef } from 'react';
 /** 用于判断组件是否挂载 */
-function useIsMounted() {
-    var mountedRef = react_1.useRef(false);
-    var get = react_1.useCallback(function () { return mountedRef.current; }, []);
-    react_1.useEffect(function () {
+export function useIsMounted() {
+    const mountedRef = useRef(false);
+    const get = useCallback(() => mountedRef.current, []);
+    useEffect(() => {
         mountedRef.current = true;
-        return function () {
+        return () => {
             mountedRef.current = false;
         };
     }, []);
     return get;
 }
-exports.useIsMounted = useIsMounted;

package/dist/react/useStateCallback.js

@@ -1,16 +1,13 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useStateCallback = void 0;
-var react_1 = require("react");
+import { useCallback, useEffect, useRef, useState } from 'react';
 /** 等价与类组件 setState(updater[, callback]) */
-function useStateCallback(initialState) {
-    var _a = react_1.useState(initialState), state = _a[0], setState = _a[1];
-    var cbRef = react_1.useRef(undefined);
-    var setStateCallback = react_1.useCallback(function (state, cb) {
+export function useStateCallback(initialState) {
+    const [state, setState] = useState(initialState);
+    const cbRef = useRef(undefined);
+    const setStateCallback = useCallback((state, cb) => {
         cbRef.current = cb;
         setState(state);
     }, []);
-    react_1.useEffect(function () {
+    useEffect(() => {
         if (cbRef.current) {
             cbRef.current(state);
             cbRef.current = undefined;
@@ -18,4 +15,3 @@ function useStateCallback(initialState) {
     }, [state]);
     return [state, setStateCallback];
 }
-exports.useStateCallback = useStateCallback;

package/dist/support.js

@@ -1,18 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSharedWorker = exports.isWebSocket = exports.isBrowserEnv = void 0;
 /**
  * 是否是浏览器环境
  */
-var isBrowserEnv = function () { return typeof window !== 'undefined'; };
-exports.isBrowserEnv = isBrowserEnv;
+export const isBrowserEnv = () => typeof window !== 'undefined';
 /**
  * 是否支持WebSocket
  */
-var isWebSocket = function () { return typeof WebSocket !== 'undefined'; };
-exports.isWebSocket = isWebSocket;
+export const isWebSocket = () => typeof WebSocket !== 'undefined';
 /**
  * 是否支持SharedWorker
  */
-var isSharedWorker = function () { return typeof SharedWorker !== 'undefined'; };
-exports.isSharedWorker = isSharedWorker;
+export const isSharedWorker = () => typeof SharedWorker !== 'undefined';

package/dist/timer.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 睡眠
+ * @param time 睡眠时间
+ */
+export declare const sleep: (ms?: number) => Promise<unknown>;

package/dist/timer.js

@@ -0,0 +1,5 @@
+/**
+ * 睡眠
+ * @param time 睡眠时间
+ */
+export const sleep = (ms = 0) => new Promise((resolve) => setTimeout(resolve, ms));

package/dist/types.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@d-matrix/utils",
-  "version": "1.7.0",
+  "sideEffects": false,
+  "version": "1.9.0",
   "description": "A dozen of utils for Front-End Development",
   "main": "dist/index.js",
   "scripts": {
@@ -11,7 +12,8 @@
     "cy:component": "cypress run --component --spec",
     "cy:component:all": "cypress run --component",
     "test:tsd": "tsd",
-    "postversion": "git push && git push --tags"
+    "postversion": "git push && git push --tags",
+    "cnpm:sync": "cnpm sync %npm_package_name%"
   },
   "engines": {
     "node": ">=16.20.0"
@@ -42,9 +44,13 @@
   },
   "devDependencies": {
     "@vitejs/plugin-react": "^4.2.1",
+    "cnpm": "^9.4.0",
     "cypress": "^13.6.6",
     "expect-type": "^0.19.0",
     "rimraf": "^5.0.5",
     "vite": "^4.5.2"
+  },
+  "dependencies": {
+    "react-fast-compare": "^3.2.2"
   }
 }

package/readme.md

@@ -15,6 +15,7 @@ A dozen of utils for Front-End Development
 - [algorithm](#algorithm)
 - [file](#file)
 - [support](#support)
+- [timer](#timer)
 
 ### clipboard
 
@@ -88,6 +89,37 @@ const Test = () => {
 
 复制文本到剪切板, 用法见[测试](./tests/react.cy.tsx)
 
+- `EnhancedComponent.prototype.setStateAsync(state)`
+
+setState 方法的同步版本
+
+```ts
+import { react } from '@d-matrix/utils';
+
+ class TestComponent extends EnhancedComponent<unknown, { pageIndex: number }> {
+  state = {
+    pageIndex: 1,
+  };
+
+  async onClick() {
+    await this.setStateAsync({ pageIndex: 2 });
+    console.log(this.state.pageIndex); // 2
+  }
+
+  render() {
+    return (
+      <button data-cy="test-button" onClick={() => this.onClick()}>
+        click
+      </button>
+    );
+  }
+}
+```
+
+- `useDeepCompareRef(deps: DependencyList): React.MutableRefObject<number>`
+
+深比较`deps`。返回`ref`，`ref.current`是一个自增数字，每次`deps`变化，`ref.current`加`1`。用法见[测试](./tests/react.cy.tsx)
+
 ### dom
 
 - `scrollToTop(element: Element | null | undefined): void`
@@ -203,6 +235,14 @@ const filename = file.getFilenameFromContentDispositionHeader(header);
 // '大行指导2024-06-27-2024-06-28.xlsx'
 ```
 
+- `download(source: string | Blob, fileName = '', target?: HyperLinkTarget): void`
+
+文件下载，`source`是文件地址或`blob`对象。
+
+```ts
+type HyperLinkTarget = "_self" | "_black" | "_parent" | "_top"
+```
+
 ## support
 
 - `isBrowserEnv(): boolean`
@@ -217,6 +257,17 @@ const filename = file.getFilenameFromContentDispositionHeader(header);
 
 是否支持SharedWorker
 
+## timer
+
+- `sleep(ms?: number): Promise<unknown>`
+
+使用`setTimeout`与`Promise`实现，暂停执行`ms`毫秒
+
+```
+await sleep(3000); // 暂停3秒
+console.log('continue'); // 继续执行
+```
+
 ## 测试
 
 运行全部组件测试