twcpt 0.0.2

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+import type * as toolUtils from './utils/tool';
+import type * as arrayUtils from './utils/helper/array';
+import type * as domUtils from './utils/helper/dom';
+import type * as numberUtils from './utils/helper/number';
+import type * as objectUtils from './utils/helper/object';
+import type * as perfUtils from './utils/helper/perf';
+import type * as regexUtils from './utils/helper/regex';
+import type * as stringUtils from './utils/helper/string';
+import type * as urlUtils from './utils/helper/url';
+export interface JQToolType extends Record<string, any> {
+    array: typeof arrayUtils;
+    dom: typeof domUtils;
+    number: typeof numberUtils;
+    object: typeof objectUtils;
+    perf: typeof perfUtils;
+    regex: typeof regexUtils;
+    string: typeof stringUtils;
+    url: typeof urlUtils;
+    defaultFill: typeof toolUtils.defaultFill;
+    formatSize: typeof toolUtils.formatSize;
+    getUpperSize: typeof toolUtils.getUpperSize;
+    defaultFormat: typeof toolUtils.defaultFormat;
+    formatDate: typeof toolUtils.formatDate;
+    defaultDateFormat: typeof toolUtils.defaultDateFormat;
+    defaultDataFormat: typeof toolUtils.defaultDataFormat;
+    defaultAutoDataFormat: typeof toolUtils.defaultAutoDataFormat;
+}

package/dist/utils/chart.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 图表相关工具函数
+ */
+/**
+ * 深度合并图表配置
+ * 用于将用户自定义配置与默认配置进行深度合并
+ *
+ * @param target 默认配置（基础配置）
+ * @param source 用户配置（覆盖配置）
+ * @returns 合并后的配置
+ *
+ * @example
+ * const defaultOptions = {
+ *   plugins: { legend: { display: true, position: 'bottom' } },
+ *   scales: { y: { beginAtZero: true } }
+ * };
+ * const userOptions = {
+ *   plugins: { legend: { position: 'top' } },
+ *   scales: { y: { max: 100 } }
+ * };
+ * const merged = mergeChartOptions(defaultOptions, userOptions);
+ * // 结果:
+ * // {
+ * //   plugins: { legend: { display: true, position: 'top' } },
+ * //   scales: { y: { beginAtZero: true, max: 100 } }
+ * // }
+ */
+export declare function mergeChartOptions<T extends Record<string, any>>(target: T, source: Partial<T> | undefined | null): T;

package/dist/utils/custom-svg.d.ts

@@ -0,0 +1,3 @@
+export declare const myIcons: {
+    [key: string]: string;
+};

package/dist/utils/helper/array.d.ts

@@ -0,0 +1,289 @@
+/**
+ * 数组处理工具函数
+ */
+/**
+ * 数组去重（基础类型）
+ * @param arr 数组
+ * @returns 去重后的数组
+ * @example
+ * uniqueArray([1, 2, 2, 3, 3, 4]) // [1, 2, 3, 4]
+ * uniqueArray(['a', 'b', 'a', 'c']) // ['a', 'b', 'c']
+ */
+export declare function uniqueArray<T>(arr: T[]): T[];
+/**
+ * 对象数组去重（根据指定字段）
+ * @param arr 对象数组
+ * @param key 用于判断重复的字段名
+ * @returns 去重后的数组
+ * @example
+ * uniqueArrayByKey([{id: 1, name: 'a'}, {id: 2, name: 'b'}, {id: 1, name: 'c'}], 'id')
+ * // [{id: 1, name: 'a'}, {id: 2, name: 'b'}]
+ */
+export declare function uniqueArrayByKey<T extends Record<string, any>>(arr: T[], key: keyof T): T[];
+/**
+ * 对象数组去重（根据多个字段）
+ * @param arr 对象数组
+ * @param keys 用于判断重复的字段名数组
+ * @returns 去重后的数组
+ * @example
+ * uniqueArrayByKeys([{a: 1, b: 2}, {a: 1, b: 3}, {a: 1, b: 2}], ['a', 'b'])
+ * // [{a: 1, b: 2}, {a: 1, b: 3}]
+ */
+export declare function uniqueArrayByKeys<T extends Record<string, any>>(arr: T[], keys: Array<keyof T>): T[];
+/**
+ * 扁平数组转树形结构
+ * @param arr 扁平数组
+ * @param options 配置选项
+ * @returns 树形结构数组
+ * @example
+ * const list = [
+ *   { id: 1, parentId: null, name: 'A' },
+ *   { id: 2, parentId: 1, name: 'A-1' },
+ *   { id: 3, parentId: 1, name: 'A-2' },
+ *   { id: 4, parentId: null, name: 'B' },
+ * ];
+ * arrayToTree(list)
+ * // [
+ * //   { id: 1, parentId: null, name: 'A', children: [
+ * //     { id: 2, parentId: 1, name: 'A-1', children: [] },
+ * //     { id: 3, parentId: 1, name: 'A-2', children: [] }
+ * //   ]},
+ * //   { id: 4, parentId: null, name: 'B', children: [] }
+ * // ]
+ */
+export declare function arrayToTree<T extends Record<string, any>>(arr: T[], options?: {
+    idKey?: string;
+    parentKey?: string;
+    childrenKey?: string;
+    rootParentValue?: any;
+}): T[];
+/**
+ * 树形结构转扁平数组
+ * @param tree 树形结构数组
+ * @param childrenKey 子节点字段名，默认 'children'
+ * @returns 扁平数组
+ * @example
+ * const tree = [
+ *   { id: 1, name: 'A', children: [
+ *     { id: 2, name: 'A-1', children: [] },
+ *     { id: 3, name: 'A-2', children: [] }
+ *   ]},
+ * ];
+ * treeToArray(tree)
+ * // [{ id: 1, name: 'A' }, { id: 2, name: 'A-1' }, { id: 3, name: 'A-2' }]
+ */
+export declare function treeToArray<T extends Record<string, any>>(tree: T[], childrenKey?: string): T[];
+/**
+ * 在树中查找节点
+ * @param tree 树形结构数组
+ * @param predicate 判断函数
+ * @param childrenKey 子节点字段名，默认 'children'
+ * @returns 找到的节点或 null
+ * @example
+ * const tree = [{ id: 1, children: [{ id: 2 }] }];
+ * findNodeInTree(tree, node => node.id === 2) // { id: 2 }
+ */
+export declare function findNodeInTree<T extends Record<string, any>>(tree: T[], predicate: (node: T) => boolean, childrenKey?: string): T | null;
+/**
+ * 遍历树的所有节点
+ * @param tree 树形结构数组
+ * @param callback 回调函数
+ * @param childrenKey 子节点字段名，默认 'children'
+ * @example
+ * forEachTree(tree, (node) => console.log(node.name))
+ */
+export declare function forEachTree<T extends Record<string, any>>(tree: T[], callback: (node: T, parent: T | null, level: number) => void, childrenKey?: string): void;
+/**
+ * 数组分组
+ * @param arr 数组
+ * @param key 分组依据的字段名
+ * @returns 分组后的对象
+ * @example
+ * const arr = [
+ *   { type: 'fruit', name: 'apple' },
+ *   { type: 'fruit', name: 'banana' },
+ *   { type: 'vegetable', name: 'carrot' }
+ * ];
+ * groupBy(arr, 'type')
+ * // {
+ * //   fruit: [{ type: 'fruit', name: 'apple' }, { type: 'fruit', name: 'banana' }],
+ * //   vegetable: [{ type: 'vegetable', name: 'carrot' }]
+ * // }
+ */
+export declare function groupBy<T extends Record<string, any>>(arr: T[], key: keyof T): Record<string, T[]>;
+/**
+ * 数组分组（根据函数）
+ * @param arr 数组
+ * @param fn 分组函数
+ * @returns 分组后的对象
+ * @example
+ * groupByFn([1, 2, 3, 4, 5], num => num % 2 === 0 ? 'even' : 'odd')
+ * // { odd: [1, 3, 5], even: [2, 4] }
+ */
+export declare function groupByFn<T>(arr: T[], fn: (item: T) => string): Record<string, T[]>;
+/**
+ * 数组排序（根据单个字段）
+ * @param arr 数组
+ * @param key 排序字段
+ * @param order 排序方式，'asc' 升序，'desc' 降序
+ * @returns 排序后的数组
+ * @example
+ * sortBy([{ age: 30 }, { age: 20 }, { age: 25 }], 'age', 'asc')
+ * // [{ age: 20 }, { age: 25 }, { age: 30 }]
+ */
+export declare function sortBy<T extends Record<string, any>>(arr: T[], key: keyof T, order?: 'asc' | 'desc'): T[];
+/**
+ * 数组排序（根据多个字段）
+ * @param arr 数组
+ * @param keys 排序字段配置数组
+ * @returns 排序后的数组
+ * @example
+ * sortByMultiple(
+ *   [{ age: 30, name: 'Bob' }, { age: 20, name: 'Alice' }, { age: 30, name: 'Alice' }],
+ *   [{ key: 'age', order: 'asc' }, { key: 'name', order: 'asc' }]
+ * )
+ * // [{ age: 20, name: 'Alice' }, { age: 30, name: 'Alice' }, { age: 30, name: 'Bob' }]
+ */
+export declare function sortByMultiple<T extends Record<string, any>>(arr: T[], keys: Array<{
+    key: keyof T;
+    order?: 'asc' | 'desc';
+}>): T[];
+/**
+ * 数组求和
+ * @param arr 数组
+ * @param key 可选，对象数组时指定求和的字段
+ * @returns 求和结果
+ * @example
+ * sum([1, 2, 3, 4, 5]) // 15
+ * sum([{ price: 10 }, { price: 20 }], 'price') // 30
+ */
+export declare function sum<T>(arr: T[], key?: keyof T): number;
+/**
+ * 数组求平均值
+ * @param arr 数组
+ * @param key 可选，对象数组时指定字段
+ * @returns 平均值
+ * @example
+ * average([1, 2, 3, 4, 5]) // 3
+ * average([{ age: 20 }, { age: 30 }], 'age') // 25
+ */
+export declare function average<T>(arr: T[], key?: keyof T): number;
+/**
+ * 数组求最大值
+ * @param arr 数组
+ * @param key 可选，对象数组时指定字段
+ * @returns 最大值
+ * @example
+ * max([1, 2, 3, 4, 5]) // 5
+ * max([{ age: 20 }, { age: 30 }], 'age') // 30
+ */
+export declare function max<T>(arr: T[], key?: keyof T): number;
+/**
+ * 数组求最小值
+ * @param arr 数组
+ * @param key 可选，对象数组时指定字段
+ * @returns 最小值
+ * @example
+ * min([1, 2, 3, 4, 5]) // 1
+ * min([{ age: 20 }, { age: 30 }], 'age') // 20
+ */
+export declare function min<T>(arr: T[], key?: keyof T): number;
+/**
+ * 数组分块
+ * @param arr 数组
+ * @param size 每块大小
+ * @returns 分块后的二维数组
+ * @example
+ * chunkArray([1, 2, 3, 4, 5], 2) // [[1, 2], [3, 4], [5]]
+ */
+export declare function chunkArray<T>(arr: T[], size: number): T[][];
+/**
+ * 数组交集
+ * @param arr1 数组1
+ * @param arr2 数组2
+ * @returns 交集数组
+ * @example
+ * intersection([1, 2, 3], [2, 3, 4]) // [2, 3]
+ */
+export declare function intersection<T>(arr1: T[], arr2: T[]): T[];
+/**
+ * 数组并集
+ * @param arr1 数组1
+ * @param arr2 数组2
+ * @returns 并集数组
+ * @example
+ * union([1, 2, 3], [2, 3, 4]) // [1, 2, 3, 4]
+ */
+export declare function union<T>(arr1: T[], arr2: T[]): T[];
+/**
+ * 数组差集
+ * @param arr1 数组1
+ * @param arr2 数组2
+ * @returns 差集数组（arr1 中有但 arr2 中没有的元素）
+ * @example
+ * difference([1, 2, 3], [2, 3, 4]) // [1]
+ */
+export declare function difference<T>(arr1: T[], arr2: T[]): T[];
+/**
+ * 数组打乱
+ * @param arr 数组
+ * @returns 打乱后的新数组
+ * @example
+ * shuffle([1, 2, 3, 4, 5]) // [3, 1, 5, 2, 4]
+ */
+export declare function shuffle<T>(arr: T[]): T[];
+/**
+ * 数组随机抽取
+ * @param arr 数组
+ * @param count 抽取数量
+ * @returns 抽取的元素数组
+ * @example
+ * sample([1, 2, 3, 4, 5], 3) // [2, 4, 1]
+ */
+export declare function sample<T>(arr: T[], count?: number): T[];
+/**
+ * 扁平化数组
+ * @param arr 多维数组
+ * @param depth 扁平化深度，默认 Infinity（完全扁平化）
+ * @returns 扁平化后的数组
+ * @example
+ * flatten([1, [2, [3, [4]]]]) // [1, 2, 3, 4]
+ * flatten([1, [2, [3, [4]]]], 2) // [1, 2, 3, [4]]
+ */
+export declare function flatten<T>(arr: any[], depth?: number): T[];
+/**
+ * 数组分页
+ * @param arr 数组
+ * @param page 页码（从 1 开始）
+ * @param pageSize 每页大小
+ * @returns 分页后的数据对象
+ * @example
+ * paginate([1, 2, 3, 4, 5], 1, 2)
+ * // { data: [1, 2], page: 1, pageSize: 2, total: 5, totalPages: 3 }
+ */
+export declare function paginate<T>(arr: T[], page: number, pageSize: number): {
+    data: T[];
+    page: number;
+    pageSize: number;
+    total: number;
+    totalPages: number;
+};
+/**
+ * 移动数组元素
+ * @param arr 数组
+ * @param fromIndex 源索引
+ * @param toIndex 目标索引
+ * @returns 移动后的新数组
+ * @example
+ * move(['a', 'b', 'c', 'd'], 0, 2) // ['b', 'c', 'a', 'd']
+ */
+export declare function move<T>(arr: T[], fromIndex: number, toIndex: number): T[];
+/**
+ * 数组计数（统计每个元素出现的次数）
+ * @param arr 数组
+ * @returns 计数对象
+ * @example
+ * countBy(['a', 'b', 'a', 'c', 'a', 'b'])
+ * // { a: 3, b: 2, c: 1 }
+ */
+export declare function countBy<T extends string | number>(arr: T[]): Record<T, number>;

package/dist/utils/helper/dom.d.ts

@@ -0,0 +1,281 @@
+/**
+ * DOM 操作工具函数
+ */
+/**
+ * 复制文本到剪贴板
+ * @param text 要复制的文本
+ * @returns Promise<boolean> 是否成功
+ * @example
+ * copyToClipboard('Hello World').then(success => {
+ *   console.log(success ? '复制成功' : '复制失败');
+ * });
+ */
+export declare function copyToClipboard(text: string): Promise<boolean>;
+/**
+ * 读取剪贴板内容
+ * @returns Promise<string> 剪贴板文本
+ * @example
+ * const text = await readFromClipboard();
+ */
+export declare function readFromClipboard(): Promise<string>;
+/**
+ * 下载文件
+ * @param data 文件数据（Blob、File 或 URL）
+ * @param filename 文件名
+ * @example
+ * downloadFile(blob, 'data.xlsx');
+ * downloadFile('http://example.com/file.pdf', 'document.pdf');
+ */
+export declare function downloadFile(data: Blob | File | string, filename: string): void;
+/**
+ * 下载 JSON 数据为文件
+ * @param data JSON 对象
+ * @param filename 文件名
+ * @example
+ * downloadJSON({ name: 'Tom', age: 20 }, 'user.json');
+ */
+export declare function downloadJSON(data: any, filename: string): void;
+/**
+ * 下载文本文件
+ * @param text 文本内容
+ * @param filename 文件名
+ * @example
+ * downloadText('Hello World', 'hello.txt');
+ */
+export declare function downloadText(text: string, filename: string): void;
+/**
+ * 平滑滚动到指定位置
+ * @param options 滚动配置
+ * @example
+ * scrollTo({ top: 0, behavior: 'smooth' }); // 回到顶部
+ * scrollTo({ top: 1000, left: 0 }); // 滚动到指定位置
+ */
+export declare function scrollTo(options: {
+    top?: number;
+    left?: number;
+    behavior?: 'auto' | 'smooth';
+}): void;
+/**
+ * 滚动到指定元素
+ * @param element 元素或选择器
+ * @param options 滚动配置
+ * @example
+ * scrollToElement('#target');
+ * scrollToElement(document.getElementById('target'), { behavior: 'smooth', block: 'center' });
+ */
+export declare function scrollToElement(element: HTMLElement | string, options?: ScrollIntoViewOptions): void;
+/**
+ * 回到顶部
+ * @param smooth 是否平滑滚动
+ * @example
+ * scrollToTop(); // 平滑滚动
+ * scrollToTop(false); // 立即跳转
+ */
+export declare function scrollToTop(smooth?: boolean): void;
+/**
+ * 滚动到底部
+ * @param smooth 是否平滑滚动
+ */
+export declare function scrollToBottom(smooth?: boolean): void;
+/**
+ * 获取滚动位置
+ * @returns 滚动位置 { x, y }
+ * @example
+ * const { x, y } = getScrollPosition();
+ */
+export declare function getScrollPosition(): {
+    x: number;
+    y: number;
+};
+/**
+ * 获取元素距离文档顶部的距离
+ * @param element 元素
+ * @returns 距离（像素）
+ * @example
+ * const offsetTop = getOffsetTop(document.getElementById('target'));
+ */
+export declare function getOffsetTop(element: HTMLElement): number;
+/**
+ * 判断元素是否在可视区域
+ * @param element 元素
+ * @param offset 偏移量，默认 0
+ * @returns 是否在可视区域
+ * @example
+ * if (isInViewport(element)) {
+ *   // 元素在可视区域内
+ * }
+ */
+export declare function isInViewport(element: HTMLElement, offset?: number): boolean;
+/**
+ * 判断元素是否部分可见
+ * @param element 元素
+ * @returns 是否部分可见
+ */
+export declare function isPartiallyVisible(element: HTMLElement): boolean;
+/**
+ * 切换全屏
+ * @param element 要全屏的元素，默认为 document.documentElement
+ * @example
+ * toggleFullscreen(); // 切换页面全屏
+ * toggleFullscreen(document.getElementById('video')); // 切换视频全屏
+ */
+export declare function toggleFullscreen(element?: HTMLElement): void;
+/**
+ * 进入全屏
+ * @param element 要全屏的元素
+ */
+export declare function enterFullscreen(element?: HTMLElement): void;
+/**
+ * 退出全屏
+ */
+export declare function exitFullscreen(): void;
+/**
+ * 判断是否全屏
+ * @returns 是否全屏
+ */
+export declare function isFullscreen(): boolean;
+/**
+ * 添加类名
+ * @param element 元素
+ * @param className 类名
+ * @example
+ * addClass(element, 'active');
+ */
+export declare function addClass(element: HTMLElement, className: string): void;
+/**
+ * 移除类名
+ * @param element 元素
+ * @param className 类名
+ */
+export declare function removeClass(element: HTMLElement, className: string): void;
+/**
+ * 切换类名
+ * @param element 元素
+ * @param className 类名
+ */
+export declare function toggleClass(element: HTMLElement, className: string): void;
+/**
+ * 判断是否有指定类名
+ * @param element 元素
+ * @param className 类名
+ * @returns 是否有该类名
+ */
+export declare function hasClass(element: HTMLElement, className: string): boolean;
+/**
+ * 获取元素的所有类名
+ * @param element 元素
+ * @returns 类名数组
+ */
+export declare function getClasses(element: HTMLElement): string[];
+/**
+ * 获取元素的尺寸和位置
+ * @param element 元素
+ * @returns 尺寸和位置信息
+ * @example
+ * const { width, height, top, left } = getElementRect(element);
+ */
+export declare function getElementRect(element: HTMLElement): DOMRect | null;
+/**
+ * 获取元素的宽度（包含内边距和边框）
+ * @param element 元素
+ * @returns 宽度
+ */
+export declare function getElementWidth(element: HTMLElement): number;
+/**
+ * 获取元素的高度（包含内边距和边框）
+ * @param element 元素
+ * @returns 高度
+ */
+export declare function getElementHeight(element: HTMLElement): number;
+/**
+ * 查询单个元素
+ * @param selector 选择器
+ * @param parent 父元素，默认为 document
+ * @returns 元素或 null
+ * @example
+ * const element = querySelector('#id');
+ */
+export declare function querySelector<T extends HTMLElement = HTMLElement>(selector: string, parent?: Document | HTMLElement): T | null;
+/**
+ * 查询多个元素
+ * @param selector 选择器
+ * @param parent 父元素，默认为 document
+ * @returns 元素数组
+ * @example
+ * const elements = querySelectorAll('.class');
+ */
+export declare function querySelectorAll<T extends HTMLElement = HTMLElement>(selector: string, parent?: Document | HTMLElement): T[];
+/**
+ * 获取元素属性
+ * @param element 元素
+ * @param name 属性名
+ * @returns 属性值
+ */
+export declare function getAttribute(element: HTMLElement, name: string): string | null;
+/**
+ * 设置元素属性
+ * @param element 元素
+ * @param name 属性名
+ * @param value 属性值
+ */
+export declare function setAttribute(element: HTMLElement, name: string, value: string): void;
+/**
+ * 移除元素属性
+ * @param element 元素
+ * @param name 属性名
+ */
+export declare function removeAttribute(element: HTMLElement, name: string): void;
+/**
+ * 判断是否有指定属性
+ * @param element 元素
+ * @param name 属性名
+ * @returns 是否有该属性
+ */
+export declare function hasAttribute(element: HTMLElement, name: string): boolean;
+/**
+ * 获取元素的计算样式
+ * @param element 元素
+ * @param property 样式属性名
+ * @returns 样式值
+ * @example
+ * const color = getStyle(element, 'color');
+ */
+export declare function getStyle(element: HTMLElement, property: string): string;
+/**
+ * 设置元素样式
+ * @param element 元素
+ * @param styles 样式对象
+ * @example
+ * setStyle(element, { color: 'red', fontSize: '16px' });
+ */
+export declare function setStyle(element: HTMLElement, styles: Partial<CSSStyleDeclaration>): void;
+/**
+ * 获取窗口尺寸
+ * @returns 窗口宽高
+ * @example
+ * const { width, height } = getWindowSize();
+ */
+export declare function getWindowSize(): {
+    width: number;
+    height: number;
+};
+/**
+ * 获取页面总高度
+ * @returns 页面高度
+ */
+export declare function getPageHeight(): number;
+/**
+ * 获取页面总宽度
+ * @returns 页面宽度
+ */
+export declare function getPageWidth(): number;
+/**
+ * 判断是否滚动到底部
+ * @param offset 距离底部的偏移量，默认 0
+ * @returns 是否到底部
+ * @example
+ * if (isScrolledToBottom(100)) {
+ *   // 距离底部100px时触发
+ * }
+ */
+export declare function isScrolledToBottom(offset?: number): boolean;

package/dist/utils/helper/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Helper 工具函数统一导出
+ */
+export * as array from './array';
+export * as dom from './dom';
+export * as number from './number';
+export * as object from './object';
+export * as perf from './perf';
+export * as regex from './regex';
+export * as string from './string';
+export * as url from './url';