@d-matrix/utils 1.27.0 → 1.28.0

package/dist/clipboard.d.ts

@@ -1,12 +1,12 @@
-/**
- * 复制图片到剪贴板
- * @param element
- * @returns
- */
-export declare function writeImage(element: HTMLImageElement | null | string): Promise<unknown>;
-/**
- * 复制文本到剪贴板
- * @param text
- * @returns
- */
-export declare function writeText(text: string): Promise<void>;
+/**
+ * 复制图片到剪贴板
+ * @param element
+ * @returns
+ */
+export declare function writeImage(element: HTMLImageElement | null | string): Promise<unknown>;
+/**
+ * 复制文本到剪贴板
+ * @param text
+ * @returns
+ */
+export declare function writeText(text: string): Promise<void>;

package/dist/clipboard.js

@@ -1,107 +1,107 @@
-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());
-    });
-};
-/**
- * 复制图片到剪贴板
- * @param element
- * @returns
- */
-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;
-            }
-            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;
-                    }
-                    navigator.clipboard
-                        .write([
-                        new ClipboardItem({
-                            [blob.type]: blob,
-                        }),
-                    ])
-                        .then(resolve, reject);
-                });
-            };
-        });
-    });
-}
-const legacyWriteText = (text) => {
-    const $textarea = document.createElement('textarea');
-    $textarea.value = text;
-    $textarea.id = '__textarea_for_clipboard__';
-    $textarea.style.cssText = 'position: fixed; width: 20px; height: 20px; opacity: 0; top: -20px;';
-    document.body.appendChild($textarea);
-    $textarea.select();
-    try {
-        const isSuccess = document.execCommand('copy');
-        if (!isSuccess && process.env.NODE_ENV === 'development') {
-            console.error('复制文本失败, 操作不被支持或未被启用');
-        }
-    }
-    catch (error) {
-        if (process.env.NODE_ENV === 'development') {
-            console.error('复制文本失败', error);
-        }
-        throw error;
-    }
-    finally {
-        document.body.removeChild($textarea);
-    }
-};
-/**
- * 复制文本到剪贴板
- * @param text
- * @returns
- */
-export function writeText(text) {
-    return __awaiter(this, void 0, void 0, function* () {
-        if (!navigator.clipboard) {
-            legacyWriteText(text);
-            return;
-        }
-        return navigator.clipboard.writeText(text).catch((error) => {
-            if (process.env.NODE_ENV === 'development') {
-                console.error('复制文本失败', error);
-            }
-            return Promise.reject(error);
-        });
-    });
-}
+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());
+    });
+};
+/**
+ * 复制图片到剪贴板
+ * @param element
+ * @returns
+ */
+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;
+            }
+            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;
+                    }
+                    navigator.clipboard
+                        .write([
+                        new ClipboardItem({
+                            [blob.type]: blob,
+                        }),
+                    ])
+                        .then(resolve, reject);
+                });
+            };
+        });
+    });
+}
+const legacyWriteText = (text) => {
+    const $textarea = document.createElement('textarea');
+    $textarea.value = text;
+    $textarea.id = '__textarea_for_clipboard__';
+    $textarea.style.cssText = 'position: fixed; width: 20px; height: 20px; opacity: 0; top: -20px;';
+    document.body.appendChild($textarea);
+    $textarea.select();
+    try {
+        const isSuccess = document.execCommand('copy');
+        if (!isSuccess && process.env.NODE_ENV === 'development') {
+            console.error('复制文本失败, 操作不被支持或未被启用');
+        }
+    }
+    catch (error) {
+        if (process.env.NODE_ENV === 'development') {
+            console.error('复制文本失败', error);
+        }
+        throw error;
+    }
+    finally {
+        document.body.removeChild($textarea);
+    }
+};
+/**
+ * 复制文本到剪贴板
+ * @param text
+ * @returns
+ */
+export function writeText(text) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!navigator || !navigator.clipboard || typeof navigator.clipboard.writeText !== 'function') {
+            legacyWriteText(text);
+            return;
+        }
+        return navigator.clipboard.writeText(text).catch((error) => {
+            if (process.env.NODE_ENV === 'development') {
+                console.error('复制文本失败', error);
+            }
+            return Promise.reject(error);
+        });
+    });
+}

package/dist/color.d.ts

@@ -1,7 +1,7 @@
-/**
- * 将十六进制颜色转换为 RGBA 颜色
- * @param hex 十六进制颜色
- * @param alpha 透明度，默认值为 1
- * @returns RGBA 颜色
- */
-export declare function hexToRGBA(hex: string, alpha?: number | string): string;
+/**
+ * 将十六进制颜色转换为 RGBA 颜色
+ * @param hex 十六进制颜色
+ * @param alpha 透明度，默认值为 1
+ * @returns RGBA 颜色
+ */
+export declare function hexToRGBA(hex: string, alpha?: number | string): string;

package/dist/color.js

@@ -1,41 +1,41 @@
-/**
- * 将十六进制颜色转换为 RGBA 颜色
- * @param hex 十六进制颜色
- * @param alpha 透明度，默认值为 1
- * @returns RGBA 颜色
- */
-export function hexToRGBA(hex, alpha = 1) {
-    // 移除井号并转为小写
-    const processedHex = hex.replace(/^#/, '').toLowerCase();
-    // 验证十六进制字符合法性
-    if (!/^[0-9a-f]+$/.test(processedHex)) {
-        throw new Error('Invalid hex character(s)');
-    }
-    // 验证长度合法性
-    if (![3, 6].includes(processedHex.length)) {
-        throw new Error('Hex must be 3 or 6 characters long');
-    }
-    // 扩展三位缩写为六位
-    const fullHex = processedHex.length === 3
-        ? processedHex
-            .split('')
-            .map((c) => c + c)
-            .join('')
-        : processedHex;
-    // 解析颜色通道
-    const parseChannel = (start, end) => parseInt(fullHex.substring(start, end), 16);
-    const r = parseChannel(0, 2);
-    const g = parseChannel(2, 4);
-    const b = parseChannel(4, 6);
-    // 处理透明度
-    const numericAlpha = Number(alpha);
-    if (isNaN(numericAlpha)) {
-        throw new Error('Alpha must be a valid number');
-    }
-    if (numericAlpha < 0 || numericAlpha > 1) {
-        throw new Error('Alpha must be between 0 and 1');
-    }
-    // 标准化输出格式
-    const formattedAlpha = numericAlpha % 1 === 0 ? numericAlpha.toFixed(0) : numericAlpha.toFixed(2).replace(/0+$/, '').replace(/\.$/, '');
-    return `rgba(${r}, ${g}, ${b}, ${formattedAlpha})`;
-}
+/**
+ * 将十六进制颜色转换为 RGBA 颜色
+ * @param hex 十六进制颜色
+ * @param alpha 透明度，默认值为 1
+ * @returns RGBA 颜色
+ */
+export function hexToRGBA(hex, alpha = 1) {
+    // 移除井号并转为小写
+    const processedHex = hex.replace(/^#/, '').toLowerCase();
+    // 验证十六进制字符合法性
+    if (!/^[0-9a-f]+$/.test(processedHex)) {
+        throw new Error('Invalid hex character(s)');
+    }
+    // 验证长度合法性
+    if (![3, 6].includes(processedHex.length)) {
+        throw new Error('Hex must be 3 or 6 characters long');
+    }
+    // 扩展三位缩写为六位
+    const fullHex = processedHex.length === 3
+        ? processedHex
+            .split('')
+            .map((c) => c + c)
+            .join('')
+        : processedHex;
+    // 解析颜色通道
+    const parseChannel = (start, end) => parseInt(fullHex.substring(start, end), 16);
+    const r = parseChannel(0, 2);
+    const g = parseChannel(2, 4);
+    const b = parseChannel(4, 6);
+    // 处理透明度
+    const numericAlpha = Number(alpha);
+    if (isNaN(numericAlpha)) {
+        throw new Error('Alpha must be a valid number');
+    }
+    if (numericAlpha < 0 || numericAlpha > 1) {
+        throw new Error('Alpha must be between 0 and 1');
+    }
+    // 标准化输出格式
+    const formattedAlpha = numericAlpha % 1 === 0 ? numericAlpha.toFixed(0) : numericAlpha.toFixed(2).replace(/0+$/, '').replace(/\.$/, '');
+    return `rgba(${r}, ${g}, ${b}, ${formattedAlpha})`;
+}

package/dist/date.d.ts

@@ -1,34 +1,34 @@
-import { i18n } from './i18n';
-/**
- * Generates an array of numbers representing a range of years between the start year and the end year.
- *
- * @param {number} start - the starting year of the range
- * @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
- */
-export declare function rangeOfYears(start: number, end?: number): number[];
-export declare enum YearOptionKind {
-    Numbers = 0,
-    Objects = 1
-}
-export interface YearOption {
-    label: string;
-    value: number;
-}
-export declare type GetYearsOptions = {
-    startYear?: number;
-    recentYears?: number;
-    endYear?: number;
-    suffix?: string;
-};
-/**
- * 获取n年, 从大到小
- * @param options
- */
-export declare function getYears(options: GetYearsOptions & {
-    type: YearOptionKind.Numbers;
-}): number[];
-export declare function getYears(options: GetYearsOptions & {
-    type: YearOptionKind.Objects;
-}): YearOption[];
-export declare const dayOfWeek: (num: number, lang?: keyof typeof i18n) => string;
+import { i18n } from './i18n';
+/**
+ * Generates an array of numbers representing a range of years between the start year and the end year.
+ *
+ * @param {number} start - the starting year of the range
+ * @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
+ */
+export declare function rangeOfYears(start: number, end?: number): number[];
+export declare enum YearOptionKind {
+    Numbers = 0,
+    Objects = 1
+}
+export interface YearOption {
+    label: string;
+    value: number;
+}
+export declare type GetYearsOptions = {
+    startYear?: number;
+    recentYears?: number;
+    endYear?: number;
+    suffix?: string;
+};
+/**
+ * 获取n年, 从大到小
+ * @param options
+ */
+export declare function getYears(options: GetYearsOptions & {
+    type: YearOptionKind.Numbers;
+}): number[];
+export declare function getYears(options: GetYearsOptions & {
+    type: YearOptionKind.Objects;
+}): YearOption[];
+export declare const dayOfWeek: (num: number, lang?: keyof typeof i18n) => string;

package/dist/date.js

@@ -1,62 +1,62 @@
-import { i18n } from './i18n';
-/**
- * Generates an array of numbers representing a range of years between the start year and the end year.
- *
- * @param {number} start - the starting year of the range
- * @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
- */
-export function rangeOfYears(start, end = new Date().getFullYear()) {
-    return Array(end - start + 1)
-        .fill(start)
-        .map((year, index) => year + index);
-}
-export var YearOptionKind;
-(function (YearOptionKind) {
-    YearOptionKind[YearOptionKind["Numbers"] = 0] = "Numbers";
-    YearOptionKind[YearOptionKind["Objects"] = 1] = "Objects";
-})(YearOptionKind || (YearOptionKind = {}));
-export function getYears(options) {
-    const { recentYears = 0, startYear, endYear, suffix = '年', type } = options;
-    const endY = endYear ? endYear : new Date().getFullYear();
-    let ranges = recentYears;
-    if (typeof startYear === 'number') {
-        // 包含startYear
-        ranges = endY - startYear + 1;
-        if (ranges <= 0) {
-            if (process.env.NODE_ENV === 'development') {
-                if (endYear === undefined) {
-                    console.error('startYear不能大于当前年份');
-                }
-                else if (typeof endYear === 'number') {
-                    console.error('endYear不能小于startYear');
-                }
-            }
-            return [];
-        }
-    }
-    if (type === YearOptionKind.Numbers) {
-        const result = [];
-        for (let i = 0; i < ranges; i++) {
-            result.push(endY - i);
-        }
-        return result;
-    }
-    if (type === YearOptionKind.Objects) {
-        const result = [];
-        for (let i = 0; i < ranges; i++) {
-            result.push({
-                value: endY - i,
-                label: `${endY - i}${suffix}`,
-            });
-        }
-        return result;
-    }
-    throw new Error('type must be enum: YearOptionKind.Numbers or YearOptionKind.Objects');
-}
-export const dayOfWeek = (num, lang = 'zh') => {
-    if (!Number.isInteger(num)) {
-        throw new Error('请输入一个整数');
-    }
-    return i18n[lang].dayOfWeek[num % 7];
-};
+import { i18n } from './i18n';
+/**
+ * Generates an array of numbers representing a range of years between the start year and the end year.
+ *
+ * @param {number} start - the starting year of the range
+ * @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
+ */
+export function rangeOfYears(start, end = new Date().getFullYear()) {
+    return Array(end - start + 1)
+        .fill(start)
+        .map((year, index) => year + index);
+}
+export var YearOptionKind;
+(function (YearOptionKind) {
+    YearOptionKind[YearOptionKind["Numbers"] = 0] = "Numbers";
+    YearOptionKind[YearOptionKind["Objects"] = 1] = "Objects";
+})(YearOptionKind || (YearOptionKind = {}));
+export function getYears(options) {
+    const { recentYears = 0, startYear, endYear, suffix = '年', type } = options;
+    const endY = endYear ? endYear : new Date().getFullYear();
+    let ranges = recentYears;
+    if (typeof startYear === 'number') {
+        // 包含startYear
+        ranges = endY - startYear + 1;
+        if (ranges <= 0) {
+            if (process.env.NODE_ENV === 'development') {
+                if (endYear === undefined) {
+                    console.error('startYear不能大于当前年份');
+                }
+                else if (typeof endYear === 'number') {
+                    console.error('endYear不能小于startYear');
+                }
+            }
+            return [];
+        }
+    }
+    if (type === YearOptionKind.Numbers) {
+        const result = [];
+        for (let i = 0; i < ranges; i++) {
+            result.push(endY - i);
+        }
+        return result;
+    }
+    if (type === YearOptionKind.Objects) {
+        const result = [];
+        for (let i = 0; i < ranges; i++) {
+            result.push({
+                value: endY - i,
+                label: `${endY - i}${suffix}`,
+            });
+        }
+        return result;
+    }
+    throw new Error('type must be enum: YearOptionKind.Numbers or YearOptionKind.Objects');
+}
+export const dayOfWeek = (num, lang = 'zh') => {
+    if (!Number.isInteger(num)) {
+        throw new Error('请输入一个整数');
+    }
+    return i18n[lang].dayOfWeek[num % 7];
+};

package/dist/decimal.d.ts

@@ -1,17 +1,17 @@
-export declare type FormatOptions = {
-    decimalPlaces?: number | false;
-    suffix?: string;
-    prefix?: string;
-    defaultValue?: string;
-    operation?: {
-        operator: 'add' | 'sub' | 'mul' | 'div' | 'toDecimalPlaces';
-        value: number;
-    }[];
-};
-/**
- * 格式化数字，默认保留3位小数，可添加前缀，后缀，默认值为'--'
- * @param value
- * @param options
- * @returns
- */
-export declare function format(value: number | string | undefined | null, options?: FormatOptions): string;
+export declare type FormatOptions = {
+    decimalPlaces?: number | false;
+    suffix?: string;
+    prefix?: string;
+    defaultValue?: string;
+    operation?: {
+        operator: 'add' | 'sub' | 'mul' | 'div' | 'toDecimalPlaces';
+        value: number;
+    }[];
+};
+/**
+ * 格式化数字，默认保留3位小数，可添加前缀，后缀，默认值为'--'
+ * @param value
+ * @param options
+ * @returns
+ */
+export declare function format(value: number | string | undefined | null, options?: FormatOptions): string;

package/dist/decimal.js

@@ -1,23 +1,23 @@
-import Decimal from 'decimal.js-light';
-/**
- * 格式化数字，默认保留3位小数，可添加前缀，后缀，默认值为'--'
- * @param value
- * @param options
- * @returns
- */
-export function format(value, options) {
-    const { decimalPlaces = 3, suffix = '', defaultValue = '--', prefix = '', operation } = options !== null && options !== void 0 ? options : {};
-    if (value === null || value === undefined || isNaN(Number(value)) || value === '') {
-        return defaultValue;
-    }
-    let decimalValue = new Decimal(value);
-    if (Array.isArray(operation) && operation.length > 0) {
-        operation.forEach((item) => {
-            decimalValue = decimalValue[item.operator](item.value);
-        });
-    }
-    if (decimalPlaces == false) {
-        return prefix + decimalValue.toString() + suffix;
-    }
-    return prefix + decimalValue.toFixed(decimalPlaces) + suffix;
-}
+import Decimal from 'decimal.js-light';
+/**
+ * 格式化数字，默认保留3位小数，可添加前缀，后缀，默认值为'--'
+ * @param value
+ * @param options
+ * @returns
+ */
+export function format(value, options) {
+    const { decimalPlaces = 3, suffix = '', defaultValue = '--', prefix = '', operation } = options !== null && options !== void 0 ? options : {};
+    if (value === null || value === undefined || isNaN(Number(value)) || value === '') {
+        return defaultValue;
+    }
+    let decimalValue = new Decimal(value);
+    if (Array.isArray(operation) && operation.length > 0) {
+        operation.forEach((item) => {
+            decimalValue = decimalValue[item.operator](item.value);
+        });
+    }
+    if (decimalPlaces == false) {
+        return prefix + decimalValue.toString() + suffix;
+    }
+    return prefix + decimalValue.toFixed(decimalPlaces) + suffix;
+}

package/dist/dom.d.ts

@@ -1,11 +1,11 @@
-/**
- * 元素滚动条滚动到顶部
- */
-export declare function scrollToTop(element: Element | null | undefined): void;
-/**
- * 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.
- */
-export declare function strip(html: string): string;
+/**
+ * 元素滚动条滚动到顶部
+ */
+export declare function scrollToTop(element: Element | null | undefined): void;
+/**
+ * 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.
+ */
+export declare function strip(html: string): string;