ly-utils-lib 1.0.12 → 2.4.0

package/dist/index-D1f9Sym2.d.ts

@@ -0,0 +1,148 @@
+import html2canvas, { Options } from 'html2canvas';
+import { jsPDF } from 'jspdf';
+
+/**
+ * PDF 工具模块
+ * 基于 html2canvas 和 jspdf 封装，提供常用的 PDF 处理功能
+ */
+
+interface CaptureToPDFOptions {
+    filename?: string;
+    scale?: number;
+    useCORS?: boolean;
+    backgroundColor?: string;
+    logging?: boolean;
+    pagebreak?: {
+        mode?: string;
+        before?: string;
+        after?: string;
+    };
+    margin?: number;
+}
+interface PDFOptions {
+    orientation?: 'p' | 'portrait' | 'l' | 'landscape';
+    unit?: 'pt' | 'mm' | 'cm' | 'in';
+    format?: 'a0' | 'a1' | 'a2' | 'a3' | 'a4' | 'legal' | 'letter' | [number, number];
+}
+/**
+ * 将 DOM 元素转换为 PDF
+ * @param element DOM 元素
+ * @param options 选项
+ */
+declare const captureToPDF: (element: HTMLElement, options?: CaptureToPDFOptions) => Promise<void>;
+/**
+ * 将 DOM 元素转换为 PDF（分页）
+ * @param element DOM 元素
+ * @param options 选项
+ */
+declare const captureToPDFWithPagination: (element: HTMLElement, options?: CaptureToPDFOptions) => Promise<void>;
+/**
+ * 截取 DOM 元素为图片
+ * @param element DOM 元素
+ * @param options html2canvas 选项
+ */
+declare const captureToImage: (element: HTMLElement, options?: Partial<Options>) => Promise<string>;
+/**
+ * 截取 DOM 元素并下载为图片
+ * @param element DOM 元素
+ * @param filename 文件名
+ * @param options html2canvas 选项
+ */
+declare const captureToImageDownload: (element: HTMLElement, filename?: string, options?: Partial<Options>) => Promise<void>;
+/**
+ * 创建空白 PDF
+ * @param options PDF 选项
+ */
+declare const createPDF: (options?: PDFOptions) => jsPDF;
+/**
+ * 添加文本到 PDF
+ * @param pdf PDF 实例
+ * @param text 文本
+ * @param x X 坐标
+ * @param y Y 坐标
+ * @param options 选项
+ */
+declare const addTextToPDF: (pdf: jsPDF, text: string, x: number, y: number, options?: {
+    maxWidth?: number;
+    align?: "left" | "center" | "right";
+    fontSize?: number;
+    fontStyle?: "normal" | "bold" | "italic" | "bolditalic";
+}) => void;
+/**
+ * 添加图片到 PDF
+ * @param pdf PDF 实例
+ * @param imageData 图片数据（DataURL 或 URL）
+ * @param x X 坐标
+ * @param y Y 坐标
+ * @param width 宽度
+ * @param height 高度
+ */
+declare const addImageToPDF: (pdf: jsPDF, imageData: string, x: number, y: number, width: number, height: number) => void;
+/**
+ * 添加表格到 PDF
+ * @param pdf PDF 实例
+ * @param headers 表头
+ * @param data 数据
+ * @param options 选项
+ */
+declare const addTableToPDF: (pdf: jsPDF, headers: string[], data: string[][], options?: {
+    x?: number;
+    y?: number;
+    cellWidth?: number;
+    cellHeight?: number;
+    headerBackgroundColor?: string;
+    headerTextColor?: string;
+    textColor?: string;
+    fontSize?: number;
+    lineWidth?: number;
+    lineColor?: number[];
+}) => void;
+/**
+ * 添加新页面
+ * @param pdf PDF 实例
+ */
+declare const addPage: (pdf: jsPDF) => void;
+/**
+ * 保存 PDF
+ * @param pdf PDF 实例
+ * @param filename 文件名
+ */
+declare const savePDF: (pdf: jsPDF, filename?: string) => void;
+/**
+ * PDF 转 DataURL
+ * @param pdf PDF 实例
+ */
+declare const pdfToDataURL: (pdf: jsPDF) => string;
+/**
+ * PDF 转 Blob
+ * @param pdf PDF 实例
+ */
+declare const pdfToBlob: (pdf: jsPDF) => Blob;
+/**
+ * 合并多个 PDF（需要使用 pdf-lib 库实现）
+ * @param _pdfs PDF 实例数组
+ */
+declare const mergePDFs: (_pdfs: jsPDF[]) => Promise<jsPDF>;
+
+type index_CaptureToPDFOptions = CaptureToPDFOptions;
+type index_PDFOptions = PDFOptions;
+declare const index_addImageToPDF: typeof addImageToPDF;
+declare const index_addPage: typeof addPage;
+declare const index_addTableToPDF: typeof addTableToPDF;
+declare const index_addTextToPDF: typeof addTextToPDF;
+declare const index_captureToImage: typeof captureToImage;
+declare const index_captureToImageDownload: typeof captureToImageDownload;
+declare const index_captureToPDF: typeof captureToPDF;
+declare const index_captureToPDFWithPagination: typeof captureToPDFWithPagination;
+declare const index_createPDF: typeof createPDF;
+declare const index_html2canvas: typeof html2canvas;
+declare const index_jsPDF: typeof jsPDF;
+declare const index_mergePDFs: typeof mergePDFs;
+declare const index_pdfToBlob: typeof pdfToBlob;
+declare const index_pdfToDataURL: typeof pdfToDataURL;
+declare const index_savePDF: typeof savePDF;
+declare namespace index {
+  export { type index_CaptureToPDFOptions as CaptureToPDFOptions, type index_PDFOptions as PDFOptions, index_addImageToPDF as addImageToPDF, index_addPage as addPage, index_addTableToPDF as addTableToPDF, index_addTextToPDF as addTextToPDF, index_captureToImage as captureToImage, index_captureToImageDownload as captureToImageDownload, index_captureToPDF as captureToPDF, index_captureToPDFWithPagination as captureToPDFWithPagination, index_createPDF as createPDF, index_html2canvas as html2canvas, index_jsPDF as jsPDF, index_mergePDFs as mergePDFs, index_pdfToBlob as pdfToBlob, index_pdfToDataURL as pdfToDataURL, index_savePDF as savePDF };
+}
+
+export { type CaptureToPDFOptions as C, type PDFOptions as P, addImageToPDF as a, addPage as b, addTableToPDF as c, addTextToPDF as d, captureToImage as e, captureToImageDownload as f, captureToPDF as g, captureToPDFWithPagination as h, index as i, createPDF as j, pdfToDataURL as k, mergePDFs as m, pdfToBlob as p, savePDF as s };

package/dist/index-Dan5oF-5.d.cts

@@ -0,0 +1,213 @@
+import { camelCase, capitalize, kebabCase, lowerFirst, snakeCase, startCase, trim, upperFirst } from 'es-toolkit';
+
+/**
+ * 字符串工具模块
+ * 基于 es-toolkit 封装，提供常用的字符串处理功能
+ */
+
+/**
+ * 判断字符串是否为空
+ * @param str 字符串
+ */
+declare const isEmpty: (str: string | null | undefined) => boolean;
+/**
+ * 生成随机字符串
+ * @param length 长度
+ * @param charset 字符集
+ */
+declare const random: (length?: number, charset?: string) => string;
+/**
+ * 生成 UUID
+ */
+declare const uuid: () => string;
+/**
+ * 生成短 ID
+ * @param length 长度
+ */
+declare const shortId: (length?: number) => string;
+/**
+ * 字符串首字母大写
+ * @param str 字符串
+ */
+declare const firstUpperCase: (str: string) => string;
+/**
+ * 字符串首字母小写
+ * @param str 字符串
+ */
+declare const firstLowerCase: (str: string) => string;
+/**
+ * 反转字符串
+ * @param str 字符串
+ */
+declare const reverse: (str: string) => string;
+/**
+ * 字符串重复
+ * @param str 字符串
+ * @param count 重复次数
+ */
+declare const repeat: (str: string, count: number) => string;
+/**
+ * 填充字符串
+ * @param str 字符串
+ * @param length 目标长度
+ * @param char 填充字符
+ * @param isEnd 是否在末尾填充
+ */
+declare const pad: (str: string | number, length: number, char?: string, isEnd?: boolean) => string;
+/**
+ * 获取文件扩展名
+ * @param filename 文件名
+ */
+declare const getExtension: (filename: string) => string;
+/**
+ * 获取文件名（不带扩展名）
+ * @param filename 文件名
+ */
+declare const getFileName: (filename: string) => string;
+/**
+ * 隐藏手机号中间四位
+ * @param phone 手机号
+ */
+declare const hidePhone: (phone: string) => string;
+/**
+ * 隐藏邮箱
+ * @param email 邮箱
+ */
+declare const hideEmail: (email: string) => string;
+/**
+ * 隐藏身份证号中间部分
+ * @param idCard 身份证号
+ */
+declare const hideIdCard: (idCard: string) => string;
+/**
+ * 格式化金额
+ * @param amount 金额
+ * @param decimals 小数位数
+ * @param separator 千位分隔符
+ */
+declare const formatMoney: (amount: number, decimals?: number, separator?: string) => string;
+/**
+ * 字符串转数字
+ * @param str 字符串
+ * @param defaultValue 默认值
+ */
+declare const toNumber: (str: string | number | null | undefined, defaultValue?: number) => number;
+/**
+ * 字符串转布尔值
+ * @param str 字符串
+ * @param defaultValue 默认值
+ */
+declare const toBoolean: (str: string | boolean | null | undefined, defaultValue?: boolean) => boolean;
+/**
+ * 提取字符串中的数字
+ * @param str 字符串
+ */
+declare const extractNumbers: (str: string) => number[];
+/**
+ * 提取字符串中的手机号
+ * @param str 字符串
+ */
+declare const extractPhones: (str: string) => string[];
+/**
+ * 提取字符串中的邮箱
+ * @param str 字符串
+ */
+declare const extractEmails: (str: string) => string[];
+/**
+ * 验证手机号
+ * @param phone 手机号
+ */
+declare const isPhone: (phone: string) => boolean;
+/**
+ * 验证邮箱
+ * @param email 邮箱
+ */
+declare const isEmail: (email: string) => boolean;
+/**
+ * 验证身份证号
+ * @param idCard 身份证号
+ */
+declare const isIdCard: (idCard: string) => boolean;
+/**
+ * 验证 URL
+ * @param url URL
+ */
+declare const isUrl: (url: string) => boolean;
+/**
+ * 高亮关键词
+ * @param text 文本
+ * @param keyword 关键词
+ * @param highlightClass 高亮样式类名
+ */
+declare const highlight: (text: string, keyword: string, highlightClass?: string) => string;
+/**
+ * 截断文本（支持 HTML）
+ * @param text 文本
+ * @param length 最大长度
+ * @param suffix 后缀
+ */
+declare const truncateText: (text: string, length?: number, suffix?: string) => string;
+/**
+ * 转义 HTML
+ * @param str 字符串
+ */
+declare const escapeHtml: (str: string) => string;
+/**
+ * 反转义 HTML
+ * @param str 字符串
+ */
+declare const unescapeHtml: (str: string) => string;
+/**
+ * 移除 HTML 标签
+ * @param str 字符串
+ */
+declare const stripTags: (str: string) => string;
+/**
+ * 字节长度
+ * @param str 字符串
+ */
+declare const byteLength: (str: string) => number;
+
+declare const index_byteLength: typeof byteLength;
+declare const index_camelCase: typeof camelCase;
+declare const index_capitalize: typeof capitalize;
+declare const index_escapeHtml: typeof escapeHtml;
+declare const index_extractEmails: typeof extractEmails;
+declare const index_extractNumbers: typeof extractNumbers;
+declare const index_extractPhones: typeof extractPhones;
+declare const index_firstLowerCase: typeof firstLowerCase;
+declare const index_firstUpperCase: typeof firstUpperCase;
+declare const index_formatMoney: typeof formatMoney;
+declare const index_getExtension: typeof getExtension;
+declare const index_getFileName: typeof getFileName;
+declare const index_hideEmail: typeof hideEmail;
+declare const index_hideIdCard: typeof hideIdCard;
+declare const index_hidePhone: typeof hidePhone;
+declare const index_highlight: typeof highlight;
+declare const index_isEmail: typeof isEmail;
+declare const index_isEmpty: typeof isEmpty;
+declare const index_isIdCard: typeof isIdCard;
+declare const index_isPhone: typeof isPhone;
+declare const index_isUrl: typeof isUrl;
+declare const index_kebabCase: typeof kebabCase;
+declare const index_lowerFirst: typeof lowerFirst;
+declare const index_pad: typeof pad;
+declare const index_random: typeof random;
+declare const index_repeat: typeof repeat;
+declare const index_reverse: typeof reverse;
+declare const index_shortId: typeof shortId;
+declare const index_snakeCase: typeof snakeCase;
+declare const index_startCase: typeof startCase;
+declare const index_stripTags: typeof stripTags;
+declare const index_toBoolean: typeof toBoolean;
+declare const index_toNumber: typeof toNumber;
+declare const index_trim: typeof trim;
+declare const index_truncateText: typeof truncateText;
+declare const index_unescapeHtml: typeof unescapeHtml;
+declare const index_upperFirst: typeof upperFirst;
+declare const index_uuid: typeof uuid;
+declare namespace index {
+  export { index_byteLength as byteLength, index_camelCase as camelCase, index_capitalize as capitalize, index_escapeHtml as escapeHtml, index_extractEmails as extractEmails, index_extractNumbers as extractNumbers, index_extractPhones as extractPhones, index_firstLowerCase as firstLowerCase, index_firstUpperCase as firstUpperCase, index_formatMoney as formatMoney, index_getExtension as getExtension, index_getFileName as getFileName, index_hideEmail as hideEmail, index_hideIdCard as hideIdCard, index_hidePhone as hidePhone, index_highlight as highlight, index_isEmail as isEmail, index_isEmpty as isEmpty, index_isIdCard as isIdCard, index_isPhone as isPhone, index_isUrl as isUrl, index_kebabCase as kebabCase, index_lowerFirst as lowerFirst, index_pad as pad, index_random as random, index_repeat as repeat, index_reverse as reverse, index_shortId as shortId, index_snakeCase as snakeCase, index_startCase as startCase, index_stripTags as stripTags, index_toBoolean as toBoolean, index_toNumber as toNumber, index_trim as trim, index_truncateText as truncateText, index_unescapeHtml as unescapeHtml, index_upperFirst as upperFirst, index_uuid as uuid };
+}
+
+export { toBoolean as A, toNumber as B, truncateText as C, unescapeHtml as D, uuid as E, extractEmails as a, byteLength as b, extractNumbers as c, extractPhones as d, escapeHtml as e, firstLowerCase as f, firstUpperCase as g, formatMoney as h, index as i, getExtension as j, getFileName as k, hideEmail as l, hideIdCard as m, hidePhone as n, highlight as o, isEmail as p, isEmpty as q, isIdCard as r, isPhone as s, isUrl as t, pad as u, random as v, repeat as w, reverse as x, shortId as y, stripTags as z };

package/dist/index-Dan5oF-5.d.ts

@@ -0,0 +1,213 @@
+import { camelCase, capitalize, kebabCase, lowerFirst, snakeCase, startCase, trim, upperFirst } from 'es-toolkit';
+
+/**
+ * 字符串工具模块
+ * 基于 es-toolkit 封装，提供常用的字符串处理功能
+ */
+
+/**
+ * 判断字符串是否为空
+ * @param str 字符串
+ */
+declare const isEmpty: (str: string | null | undefined) => boolean;
+/**
+ * 生成随机字符串
+ * @param length 长度
+ * @param charset 字符集
+ */
+declare const random: (length?: number, charset?: string) => string;
+/**
+ * 生成 UUID
+ */
+declare const uuid: () => string;
+/**
+ * 生成短 ID
+ * @param length 长度
+ */
+declare const shortId: (length?: number) => string;
+/**
+ * 字符串首字母大写
+ * @param str 字符串
+ */
+declare const firstUpperCase: (str: string) => string;
+/**
+ * 字符串首字母小写
+ * @param str 字符串
+ */
+declare const firstLowerCase: (str: string) => string;
+/**
+ * 反转字符串
+ * @param str 字符串
+ */
+declare const reverse: (str: string) => string;
+/**
+ * 字符串重复
+ * @param str 字符串
+ * @param count 重复次数
+ */
+declare const repeat: (str: string, count: number) => string;
+/**
+ * 填充字符串
+ * @param str 字符串
+ * @param length 目标长度
+ * @param char 填充字符
+ * @param isEnd 是否在末尾填充
+ */
+declare const pad: (str: string | number, length: number, char?: string, isEnd?: boolean) => string;
+/**
+ * 获取文件扩展名
+ * @param filename 文件名
+ */
+declare const getExtension: (filename: string) => string;
+/**
+ * 获取文件名（不带扩展名）
+ * @param filename 文件名
+ */
+declare const getFileName: (filename: string) => string;
+/**
+ * 隐藏手机号中间四位
+ * @param phone 手机号
+ */
+declare const hidePhone: (phone: string) => string;
+/**
+ * 隐藏邮箱
+ * @param email 邮箱
+ */
+declare const hideEmail: (email: string) => string;
+/**
+ * 隐藏身份证号中间部分
+ * @param idCard 身份证号
+ */
+declare const hideIdCard: (idCard: string) => string;
+/**
+ * 格式化金额
+ * @param amount 金额
+ * @param decimals 小数位数
+ * @param separator 千位分隔符
+ */
+declare const formatMoney: (amount: number, decimals?: number, separator?: string) => string;
+/**
+ * 字符串转数字
+ * @param str 字符串
+ * @param defaultValue 默认值
+ */
+declare const toNumber: (str: string | number | null | undefined, defaultValue?: number) => number;
+/**
+ * 字符串转布尔值
+ * @param str 字符串
+ * @param defaultValue 默认值
+ */
+declare const toBoolean: (str: string | boolean | null | undefined, defaultValue?: boolean) => boolean;
+/**
+ * 提取字符串中的数字
+ * @param str 字符串
+ */
+declare const extractNumbers: (str: string) => number[];
+/**
+ * 提取字符串中的手机号
+ * @param str 字符串
+ */
+declare const extractPhones: (str: string) => string[];
+/**
+ * 提取字符串中的邮箱
+ * @param str 字符串
+ */
+declare const extractEmails: (str: string) => string[];
+/**
+ * 验证手机号
+ * @param phone 手机号
+ */
+declare const isPhone: (phone: string) => boolean;
+/**
+ * 验证邮箱
+ * @param email 邮箱
+ */
+declare const isEmail: (email: string) => boolean;
+/**
+ * 验证身份证号
+ * @param idCard 身份证号
+ */
+declare const isIdCard: (idCard: string) => boolean;
+/**
+ * 验证 URL
+ * @param url URL
+ */
+declare const isUrl: (url: string) => boolean;
+/**
+ * 高亮关键词
+ * @param text 文本
+ * @param keyword 关键词
+ * @param highlightClass 高亮样式类名
+ */
+declare const highlight: (text: string, keyword: string, highlightClass?: string) => string;
+/**
+ * 截断文本（支持 HTML）
+ * @param text 文本
+ * @param length 最大长度
+ * @param suffix 后缀
+ */
+declare const truncateText: (text: string, length?: number, suffix?: string) => string;
+/**
+ * 转义 HTML
+ * @param str 字符串
+ */
+declare const escapeHtml: (str: string) => string;
+/**
+ * 反转义 HTML
+ * @param str 字符串
+ */
+declare const unescapeHtml: (str: string) => string;
+/**
+ * 移除 HTML 标签
+ * @param str 字符串
+ */
+declare const stripTags: (str: string) => string;
+/**
+ * 字节长度
+ * @param str 字符串
+ */
+declare const byteLength: (str: string) => number;
+
+declare const index_byteLength: typeof byteLength;
+declare const index_camelCase: typeof camelCase;
+declare const index_capitalize: typeof capitalize;
+declare const index_escapeHtml: typeof escapeHtml;
+declare const index_extractEmails: typeof extractEmails;
+declare const index_extractNumbers: typeof extractNumbers;
+declare const index_extractPhones: typeof extractPhones;
+declare const index_firstLowerCase: typeof firstLowerCase;
+declare const index_firstUpperCase: typeof firstUpperCase;
+declare const index_formatMoney: typeof formatMoney;
+declare const index_getExtension: typeof getExtension;
+declare const index_getFileName: typeof getFileName;
+declare const index_hideEmail: typeof hideEmail;
+declare const index_hideIdCard: typeof hideIdCard;
+declare const index_hidePhone: typeof hidePhone;
+declare const index_highlight: typeof highlight;
+declare const index_isEmail: typeof isEmail;
+declare const index_isEmpty: typeof isEmpty;
+declare const index_isIdCard: typeof isIdCard;
+declare const index_isPhone: typeof isPhone;
+declare const index_isUrl: typeof isUrl;
+declare const index_kebabCase: typeof kebabCase;
+declare const index_lowerFirst: typeof lowerFirst;
+declare const index_pad: typeof pad;
+declare const index_random: typeof random;
+declare const index_repeat: typeof repeat;
+declare const index_reverse: typeof reverse;
+declare const index_shortId: typeof shortId;
+declare const index_snakeCase: typeof snakeCase;
+declare const index_startCase: typeof startCase;
+declare const index_stripTags: typeof stripTags;
+declare const index_toBoolean: typeof toBoolean;
+declare const index_toNumber: typeof toNumber;
+declare const index_trim: typeof trim;
+declare const index_truncateText: typeof truncateText;
+declare const index_unescapeHtml: typeof unescapeHtml;
+declare const index_upperFirst: typeof upperFirst;
+declare const index_uuid: typeof uuid;
+declare namespace index {
+  export { index_byteLength as byteLength, index_camelCase as camelCase, index_capitalize as capitalize, index_escapeHtml as escapeHtml, index_extractEmails as extractEmails, index_extractNumbers as extractNumbers, index_extractPhones as extractPhones, index_firstLowerCase as firstLowerCase, index_firstUpperCase as firstUpperCase, index_formatMoney as formatMoney, index_getExtension as getExtension, index_getFileName as getFileName, index_hideEmail as hideEmail, index_hideIdCard as hideIdCard, index_hidePhone as hidePhone, index_highlight as highlight, index_isEmail as isEmail, index_isEmpty as isEmpty, index_isIdCard as isIdCard, index_isPhone as isPhone, index_isUrl as isUrl, index_kebabCase as kebabCase, index_lowerFirst as lowerFirst, index_pad as pad, index_random as random, index_repeat as repeat, index_reverse as reverse, index_shortId as shortId, index_snakeCase as snakeCase, index_startCase as startCase, index_stripTags as stripTags, index_toBoolean as toBoolean, index_toNumber as toNumber, index_trim as trim, index_truncateText as truncateText, index_unescapeHtml as unescapeHtml, index_upperFirst as upperFirst, index_uuid as uuid };
+}
+
+export { toBoolean as A, toNumber as B, truncateText as C, unescapeHtml as D, uuid as E, extractEmails as a, byteLength as b, extractNumbers as c, extractPhones as d, escapeHtml as e, firstLowerCase as f, firstUpperCase as g, formatMoney as h, index as i, getExtension as j, getFileName as k, hideEmail as l, hideIdCard as m, hidePhone as n, highlight as o, isEmail as p, isEmpty as q, isIdCard as r, isPhone as s, isUrl as t, pad as u, random as v, repeat as w, reverse as x, shortId as y, stripTags as z };