@d-matrix/utils 1.27.1 → 1.28.0

package/dist/file.js

@@ -1,154 +1,154 @@
-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) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-/**
- * 转换BlobPart或者文件地址为图片对象
- * @param file 传入文件 或者 url
- * @returns 返回 一个图片详情对象
- */
-export const toImage = (file, options) => {
-    return new Promise((resolve, reject) => {
-        const image = new Image();
-        if (typeof file === 'string') {
-            image.src = file;
-        }
-        else {
-            const blob = URL.createObjectURL(new Blob([file], options));
-            image.src = blob;
-        }
-        // 如果有缓存，读缓存
-        if (image.complete) {
-            resolve(image);
-        }
-        else {
-            //否则加载图片
-            image.onload = function () {
-                resolve(image);
-                image.onload = null; // 避免重复加载
-            };
-            image.onerror = function () {
-                reject('图片加载失败');
-            };
-        }
-    });
-};
-/**
- * 图片宽，高校验
- * @param file 传入文件 或者 url
- * @param limitSize 限制宽度, 高度
- * @returns isOK: 是否超出宽高; width, height: 图片的宽高
- */
-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>
- */
-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);
-        });
-    });
-}
-/**
- * 从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
- *
- */
-export function getFilenameFromContentDispositionHeader(header) {
-    const contentDisposition = header['content-disposition'];
-    if (!contentDisposition)
-        return '';
-    const filename = contentDisposition.split('filename=')[1].split(';')[0];
-    return decodeURIComponent(filename);
-}
-const HyperLinkTargets = ['_self', '_blank', '_parent', '_top'];
-/**
- * 文件下载
- * @param source 文件地址或blob对象
- * @param fileName 文件名
- * @param isPreview 是否
- */
-// `a.click()` doesn't work for all browsers (#465)
-function click(node) {
-    try {
-        node.dispatchEvent(new MouseEvent('click'));
-    }
-    catch (e) {
-        var evt = document.createEvent('MouseEvents');
-        evt.initMouseEvent('click', true, true, window, 0, 0, 0, 80, 20, false, false, false, false, 0, null);
-        node.dispatchEvent(evt);
-    }
-}
-export function download(source, fileName = '', target) {
-    const link = document.createElement('a');
-    if (typeof source === 'string') {
-        if (!source.length) {
-            if (process.env.NODE_ENV === 'development') {
-                console.error('下载失败，原因：source为空字符串');
-                return;
-            }
-        }
-        if (typeof target === 'string' && HyperLinkTargets.includes(target)) {
-            link.target = target;
-        }
-        else {
-            // https://stackoverflow.com/questions/33909763/download-attribute-with-a-file-name-not-working
-            // download 只在同源 URL 或 blob:、data: 协议起作用, 如果下载不同源的oss文件，download属性无效
-            link.download = fileName;
-        }
-        link.href = source;
-    }
-    let objectURL;
-    if (source instanceof Blob) {
-        const objectURL = window.URL.createObjectURL(source);
-        link.href = objectURL;
-        link.download = fileName;
-    }
-    document.body.appendChild(link);
-    click(link);
-    setTimeout(() => {
-        if (typeof objectURL === 'string') {
-            window.URL.revokeObjectURL(objectURL);
-        }
-        document.body.removeChild(link);
-    }, 4e4); // 40S
-}
-/**
- * 通过创建iframe进行文件下载
- * @param source
- * @returns
- */
-export function downloadFileByIframe(source) {
-    const httpsPath = source.replace(/http:\/\//, "https://");
-    const iframes = document.getElementsByTagName("iframe");
-    if (iframes.length === 0 ||
-        (iframes.length > 0 && iframes[0].className === "fill" && iframes[iframes.length - 1].className === "fill")) {
-        const element = document.createElement("iframe");
-        element.style.display = "none";
-        element.src = httpsPath;
-        document.body.appendChild(element);
-        return true;
-    }
-    if (iframes.length > 0 && iframes[iframes.length - 1].className !== "fill") {
-        iframes[0].src = httpsPath;
-        return true;
-    }
-    return false;
-}
+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) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * 转换BlobPart或者文件地址为图片对象
+ * @param file 传入文件 或者 url
+ * @returns 返回 一个图片详情对象
+ */
+export const toImage = (file, options) => {
+    return new Promise((resolve, reject) => {
+        const image = new Image();
+        if (typeof file === 'string') {
+            image.src = file;
+        }
+        else {
+            const blob = URL.createObjectURL(new Blob([file], options));
+            image.src = blob;
+        }
+        // 如果有缓存，读缓存
+        if (image.complete) {
+            resolve(image);
+        }
+        else {
+            //否则加载图片
+            image.onload = function () {
+                resolve(image);
+                image.onload = null; // 避免重复加载
+            };
+            image.onerror = function () {
+                reject('图片加载失败');
+            };
+        }
+    });
+};
+/**
+ * 图片宽，高校验
+ * @param file 传入文件 或者 url
+ * @param limitSize 限制宽度, 高度
+ * @returns isOK: 是否超出宽高; width, height: 图片的宽高
+ */
+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>
+ */
+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);
+        });
+    });
+}
+/**
+ * 从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
+ *
+ */
+export function getFilenameFromContentDispositionHeader(header) {
+    const contentDisposition = header['content-disposition'];
+    if (!contentDisposition)
+        return '';
+    const filename = contentDisposition.split('filename=')[1].split(';')[0];
+    return decodeURIComponent(filename);
+}
+const HyperLinkTargets = ['_self', '_blank', '_parent', '_top'];
+/**
+ * 文件下载
+ * @param source 文件地址或blob对象
+ * @param fileName 文件名
+ * @param isPreview 是否
+ */
+// `a.click()` doesn't work for all browsers (#465)
+function click(node) {
+    try {
+        node.dispatchEvent(new MouseEvent('click'));
+    }
+    catch (e) {
+        var evt = document.createEvent('MouseEvents');
+        evt.initMouseEvent('click', true, true, window, 0, 0, 0, 80, 20, false, false, false, false, 0, null);
+        node.dispatchEvent(evt);
+    }
+}
+export function download(source, fileName = '', target) {
+    const link = document.createElement('a');
+    if (typeof source === 'string') {
+        if (!source.length) {
+            if (process.env.NODE_ENV === 'development') {
+                console.error('下载失败，原因：source为空字符串');
+                return;
+            }
+        }
+        if (typeof target === 'string' && HyperLinkTargets.includes(target)) {
+            link.target = target;
+        }
+        else {
+            // https://stackoverflow.com/questions/33909763/download-attribute-with-a-file-name-not-working
+            // download 只在同源 URL 或 blob:、data: 协议起作用, 如果下载不同源的oss文件，download属性无效
+            link.download = fileName;
+        }
+        link.href = source;
+    }
+    let objectURL;
+    if (source instanceof Blob) {
+        const objectURL = window.URL.createObjectURL(source);
+        link.href = objectURL;
+        link.download = fileName;
+    }
+    document.body.appendChild(link);
+    click(link);
+    setTimeout(() => {
+        if (typeof objectURL === 'string') {
+            window.URL.revokeObjectURL(objectURL);
+        }
+        document.body.removeChild(link);
+    }, 4e4); // 40S
+}
+/**
+ * 通过创建iframe进行文件下载
+ * @param source
+ * @returns
+ */
+export function downloadFileByIframe(source) {
+    const httpsPath = source.replace(/http:\/\//, "https://");
+    const iframes = document.getElementsByTagName("iframe");
+    if (iframes.length === 0 ||
+        (iframes.length > 0 && iframes[0].className === "fill" && iframes[iframes.length - 1].className === "fill")) {
+        const element = document.createElement("iframe");
+        element.style.display = "none";
+        element.src = httpsPath;
+        document.body.appendChild(element);
+        return true;
+    }
+    if (iframes.length > 0 && iframes[iframes.length - 1].className !== "fill") {
+        iframes[0].src = httpsPath;
+        return true;
+    }
+    return false;
+}

package/dist/i18n.d.ts

@@ -1,10 +1,10 @@
-export declare const i18n: {
-    readonly en: {
-        readonly months: readonly ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];
-        readonly dayOfWeek: readonly ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
-    };
-    readonly zh: {
-        readonly months: readonly ["一月", "二月", "三月", "四月", "五月", "六月", "七月", "八月", "九月", "十月", "十一月", "十二月"];
-        readonly dayOfWeek: readonly ["日", "一", "二", "三", "四", "五", "六"];
-    };
-};
+export declare const i18n: {
+    readonly en: {
+        readonly months: readonly ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];
+        readonly dayOfWeek: readonly ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+    };
+    readonly zh: {
+        readonly months: readonly ["一月", "二月", "三月", "四月", "五月", "六月", "七月", "八月", "九月", "十月", "十一月", "十二月"];
+        readonly dayOfWeek: readonly ["日", "一", "二", "三", "四", "五", "六"];
+    };
+};

package/dist/i18n.js

@@ -1,12 +1,12 @@
-export const i18n = {
-    en: {
-        // English
-        months: ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'],
-        dayOfWeek: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'],
-    },
-    zh: {
-        // Simplified Chinese (简体中文)
-        months: ['一月', '二月', '三月', '四月', '五月', '六月', '七月', '八月', '九月', '十月', '十一月', '十二月'],
-        dayOfWeek: ['日', '一', '二', '三', '四', '五', '六'],
-    },
-};
+export const i18n = {
+    en: {
+        // English
+        months: ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'],
+        dayOfWeek: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'],
+    },
+    zh: {
+        // Simplified Chinese (简体中文)
+        months: ['一月', '二月', '三月', '四月', '五月', '六月', '七月', '八月', '九月', '十月', '十一月', '十二月'],
+        dayOfWeek: ['日', '一', '二', '三', '四', '五', '六'],
+    },
+};

package/dist/index.d.ts

@@ -1,16 +1,16 @@
-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';
-export * as timer from './timer';
-export * as operator from './operator';
-export * as decimal from './decimal';
-export * as object from './object';
-export * as echarts from './echarts';
-export * as array from './array';
-export * as number from './number';
-export * as color from './color';
+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';
+export * as timer from './timer';
+export * as operator from './operator';
+export * as decimal from './decimal';
+export * as object from './object';
+export * as echarts from './echarts';
+export * as array from './array';
+export * as number from './number';
+export * as color from './color';

package/dist/index.js

@@ -1,16 +1,16 @@
-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';
-export * as timer from './timer';
-export * as operator from './operator';
-export * as decimal from './decimal';
-export * as object from './object';
-export * as echarts from './echarts';
-export * as array from './array';
-export * as number from './number';
-export * as color from './color';
+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';
+export * as timer from './timer';
+export * as operator from './operator';
+export * as decimal from './decimal';
+export * as object from './object';
+export * as echarts from './echarts';
+export * as array from './array';
+export * as number from './number';
+export * as color from './color';

package/dist/number.d.ts

@@ -1,2 +1,2 @@
-/** 返回[min, max]之间的随机整数 */
-export declare function randomInt(min: number, max: number): number;
+/** 返回[min, max]之间的随机整数 */
+export declare function randomInt(min: number, max: number): number;

package/dist/number.js

@@ -1,4 +1,4 @@
-/** 返回[min, max]之间的随机整数 */
-export function randomInt(min, max) {
-    return Math.floor(Math.random() * (max - min + 1) + min);
-}
+/** 返回[min, max]之间的随机整数 */
+export function randomInt(min, max) {
+    return Math.floor(Math.random() * (max - min + 1) + min);
+}

package/dist/object.d.ts

@@ -1,13 +1,13 @@
-export declare const ZeroValues: ({} | null | undefined)[];
-/**
- * 移除零值的键
- * 默认的零值是：undefined、null、空字符串, NaN, [], {}
- */
-export declare const removeZeroValueKeys: <T extends Record<string, any>>(obj: T, zeroValues?: ({} | null | undefined)[]) => T;
-/**
- * 返回tuple，而不是string[]
- * const obj = { a: 1, b: '2' };
- * Object.keys(obj) => string[]
- * typedKeys({ a: 1, b: '2' }) => ('a' | 'b')[]
- */
-export declare const typedKeys: <T extends object>(obj: T) => (keyof T)[];
+export declare const ZeroValues: ({} | null | undefined)[];
+/**
+ * 移除零值的键
+ * 默认的零值是：undefined、null、空字符串, NaN, [], {}
+ */
+export declare const removeZeroValueKeys: <T extends Record<string, any>>(obj: T, zeroValues?: ({} | null | undefined)[]) => T;
+/**
+ * 返回tuple，而不是string[]
+ * const obj = { a: 1, b: '2' };
+ * Object.keys(obj) => string[]
+ * typedKeys({ a: 1, b: '2' }) => ('a' | 'b')[]
+ */
+export declare const typedKeys: <T extends object>(obj: T) => (keyof T)[];

package/dist/object.js

@@ -1,28 +1,28 @@
-import isEqual from 'react-fast-compare';
-export const ZeroValues = [undefined, null, '', NaN, [], {}];
-/**
- * 移除零值的键
- * 默认的零值是：undefined、null、空字符串, NaN, [], {}
- */
-// TODO: improve TS type
-export const removeZeroValueKeys = (obj, zeroValues = ZeroValues) => {
-    if (!Array.isArray(zeroValues)) {
-        throw new Error('zeroValues must be an array');
-    }
-    const r = {};
-    for (const key in obj) {
-        const value = obj[key];
-        const shouldRemove = zeroValues.some((v) => isEqual(v, value));
-        if (shouldRemove)
-            continue;
-        r[key] = value;
-    }
-    return r;
-};
-/**
- * 返回tuple，而不是string[]
- * const obj = { a: 1, b: '2' };
- * Object.keys(obj) => string[]
- * typedKeys({ a: 1, b: '2' }) => ('a' | 'b')[]
- */
-export const typedKeys = Object.keys;
+import isEqual from 'react-fast-compare';
+export const ZeroValues = [undefined, null, '', NaN, [], {}];
+/**
+ * 移除零值的键
+ * 默认的零值是：undefined、null、空字符串, NaN, [], {}
+ */
+// TODO: improve TS type
+export const removeZeroValueKeys = (obj, zeroValues = ZeroValues) => {
+    if (!Array.isArray(zeroValues)) {
+        throw new Error('zeroValues must be an array');
+    }
+    const r = {};
+    for (const key in obj) {
+        const value = obj[key];
+        const shouldRemove = zeroValues.some((v) => isEqual(v, value));
+        if (shouldRemove)
+            continue;
+        r[key] = value;
+    }
+    return r;
+};
+/**
+ * 返回tuple，而不是string[]
+ * const obj = { a: 1, b: '2' };
+ * Object.keys(obj) => string[]
+ * typedKeys({ a: 1, b: '2' }) => ('a' | 'b')[]
+ */
+export const typedKeys = Object.keys;

package/dist/operator.d.ts

@@ -1,6 +1,6 @@
-/**
- * 检查数据类型
- * @param obj
- * @returns
- */
-export declare const trueTypeOf: (obj: unknown) => string;
+/**
+ * 检查数据类型
+ * @param obj
+ * @returns
+ */
+export declare const trueTypeOf: (obj: unknown) => string;

package/dist/operator.js

@@ -1,6 +1,6 @@
-/**
- * 检查数据类型
- * @param obj
- * @returns
- */
-export const trueTypeOf = (obj) => Object.prototype.toString.call(obj).slice(8, -1).toLowerCase();
+/**
+ * 检查数据类型
+ * @param obj
+ * @returns
+ */
+export const trueTypeOf = (obj) => Object.prototype.toString.call(obj).slice(8, -1).toLowerCase();

package/dist/react/enhancedComponent.d.ts

@@ -1,12 +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>;
-}
+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

@@ -1,16 +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);
-        });
-    }
-}
+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

@@ -1,12 +1,15 @@
-export * from './useDisableContextMenu';
-export * from './useStateCallback';
-export * from './renderToString';
-export * from './useIsMounted';
-export * from './useCopyToClipboard';
-export * from './enhancedComponent';
-export * from './useDeepCompareRef';
-export * from './types';
-export * from './useForwardRef';
-export * from './useIsomorphicLayoutEffect';
-export * from './useMediaQuery';
-export * from './useIsFirstRender';
+export * from './useDisableContextMenu';
+export * from './useStateCallback';
+export * from './renderToString';
+export * from './useIsMounted';
+export * from './useCopyToClipboard';
+export * from './enhancedComponent';
+export * from './useDeepCompareRef';
+export * from './types';
+export * from './useForwardRef';
+export * from './useIsomorphicLayoutEffect';
+export * from './useMediaQuery';
+export * from './useIsFirstRender';
+export * from './useStateCallback';
+export * from './useSafeTimeout';
+export * from './useId';