@minto-ai/tools 1.0.1

package/dist/array/chunk-array.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 将一个数组分割成多个指定大小的块。
+ * 这个函数接受一个数组和一个指定的块大小，然后返回一个二维数组。
+ * 每个子数组包含原数组中的一部分元素，大小由 `chunkSize` 参数决定。
+ * 如果数组的长度不是 `chunkSize` 的整数倍，最后一个块可能包含的元素少于 `chunkSize`。
+ *
+ * @param array  要分割的源数组。
+ * @param chunkSize  每个块的大小。必须为正整数。默认值为 1。
+ * @returns 返回一个二维数组，每个子数组包含原数组的一部分元素。
+ */
+declare function chunkArray<T>(array: T[], chunkSize?: number): T[][];
+export default chunkArray;

package/dist/array/index.d.ts

@@ -0,0 +1,2 @@
+import { default as chunkArray } from './chunk-array';
+export { chunkArray };

package/dist/browser/copy-text.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 复制文本到剪贴板的函数。
+ * 如果复制成功，返回一个包含被复制文本的 Promise；如果失败，返回一个包含错误信息的 Promise。
+ *
+ * @param text  需要复制的文本内容。
+ * @returns 返回一个 Promise 对象。成功时返回被复制的文本，失败时返回错误信息。
+ */
+declare function copyText(text: string): Promise<string>;
+export default copyText;

package/dist/browser/index.d.ts

@@ -0,0 +1,6 @@
+import { default as copyText } from './copy-text';
+import { default as isAndroid } from './is-android';
+import { default as isIos } from './is-ios';
+import { default as isMobile } from './is-mobile';
+import { default as isPc } from './is-pc';
+export { copyText, isIos, isMobile, isPc, isAndroid };

package/dist/browser/is-android.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 判断当前设备是否为 Android 设备
+ * 通过检测用户代理字符串中是否包含 "android" 关键字来判断。
+ *
+ * @returns 如果是 Android 设备，返回 true；否则返回 false。
+ */
+declare function isAndroid(): boolean;
+export default isAndroid;

package/dist/browser/is-ios.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 判断当前设备是否为iOS设备
+ * 主要检测的设备类型包括 iPhone、iPad 和 iPod。
+ *
+ * @returns 如果是iOS设备，返回true；否则返回false。
+ */
+declare function isIos(): boolean;
+export default isIos;

package/dist/browser/is-mobile.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 判断当前设备是否为移动设备（手机或平板）。
+ * 通过检测设备是否为 Android 或 iOS 设备来判断是否为移动设备。
+ * 如果设备是 Android 或 iOS 设备，则认为是移动设备。
+ *
+ * @returns 如果是移动设备，返回 true；否则返回 false。
+ */
+declare function isMobile(): boolean;
+export default isMobile;

package/dist/browser/is-pc.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 判断当前设备是否为桌面设备（PC）。
+ * 如果当前设备不是移动设备（手机或平板），则认为是桌面设备。
+ *
+ * @returns 如果是桌面设备，返回 true；否则返回 false。
+ */
+declare function isPc(): boolean;
+export default isPc;

package/dist/core/__test__/can-be-parsed-as-number.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/be-parsed-as-number.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 将输入值转换为数字类型。
+ *
+ * @param value 输入值。
+ * @returns 转换后的数字值，如果无法解析则返回 `NaN`。
+ */
+declare function beParsedAsNumber(value: never): number;
+export default beParsedAsNumber;

package/dist/core/can-be-parsed-as-number.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 检查一个值是否可以被解析为有效的数字。
+ *
+ * @param value 需要检查的值
+ * @returns 如果值可以被解析为数字，则返回 true；否则返回 false
+ */
+declare function canBeParsedAsNumber(value: unknown): boolean;
+export default canBeParsedAsNumber;

package/dist/core/check-array-empty.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 检查数组是否为空
+ *
+ * @param value 要检查的值。
+ * @returns 如果 value 是一个数组并且长度为0返回 true，否则返回false
+ */
+declare function checkArrayEmpty(value: unknown): value is Array<unknown>;
+export default checkArrayEmpty;

package/dist/core/check-empty-not-zero.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 检查给定的值是否为空，但不包括数字 0。空值包括：空字符串、空数组、空对象、null 或 undefined。
+ *
+ * @param value 要检查的值。
+ * @returns 如果值是空的，且不是数字 0，则返回 true，否则返回 false。
+ */
+declare function checkEmptyNotZero(value: unknown): value is null | undefined | '' | [] | Record<string, never>;
+export default checkEmptyNotZero;

package/dist/core/check-empty.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 检查给定的值是否为空。
+ * 空值包括：空字符串、空数组、空对象、null 或 undefined。
+ *
+ * @param value 要检查的值。
+ * @returns 如果值是空的，则返回 true，否则返回 false。
+ */
+declare function checkEmpty(value: unknown): value is null | undefined | '' | [] | Record<string, never> | 0;
+export default checkEmpty;

package/dist/core/check-object-empty.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 检查对象是否为空。
+ * 一个空对象是指没有任何自身属性的对象。
+ *
+ * @param value 要检查的值。
+ * @returns 如果值是一个空对象，则返回 true，否则返回 false。
+ */
+declare function checkObjectEmpty(value: unknown): value is Record<string, never>;
+export default checkObjectEmpty;

package/dist/core/index.d.ts

@@ -0,0 +1,13 @@
+import { default as beParsedAsNumber } from './be-parsed-as-number';
+import { default as canBeParsedAsNumber } from './can-be-parsed-as-number';
+import { default as checkArrayEmpty } from './check-array-empty';
+import { default as checkEmpty } from './check-empty';
+import { default as checkEmptyNotZero } from './check-empty-not-zero';
+import { default as checkObjectEmpty } from './check-object-empty';
+import { default as isArray } from './is-array';
+import { default as isNullOrUndefined } from './is-null-or-undefined';
+import { default as isNumber } from './is-number';
+import { default as isObject } from './is-object';
+import { default as isString } from './is-string';
+import { default as isUndefined } from './is-undefined';
+export { checkArrayEmpty, checkEmpty, checkEmptyNotZero, checkObjectEmpty, isArray, isNumber, isObject, isString, canBeParsedAsNumber, isUndefined, isNullOrUndefined, beParsedAsNumber };

package/dist/core/is-array.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 判断给定的值是否是一个数组。
+ *
+ * @param value 要检查的值。
+ * @returns 如果 value 是一个数组，则返回 true，否则返回 false。
+ */
+declare function isArray(value: unknown): value is Array<unknown>;
+export default isArray;

package/dist/core/is-null-or-undefined.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 检查一个值是否为 null 或 undefined。
+ * @param value - 要检查的值。
+ * @returns 如果值为 null 或 undefined，则返回 true；否则返回 false。
+ */
+declare function isNullOrUndefined(value: unknown): value is null | undefined;
+export default isNullOrUndefined;

package/dist/core/is-number.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 判断给定的值是否是一个数字。
+ *
+ * @param value 要检查的值。
+ * @returns  如果 value 是一个数字，则返回 true，否则返回 false。
+ */
+declare function isNumber(value: unknown): value is number;
+export default isNumber;

package/dist/core/is-object.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 判断给定的值是否是一个对象。但对象的值包含 null 的情况，返回 false。
+ *
+ * @param value 要检查的值。
+ * @returns 如果 value 是一个普通对象，则返回 true，否则返回 false。
+ */
+declare function isObject(value: unknown): value is Record<PropertyKey, unknown>;
+export default isObject;

package/dist/core/is-string.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 判断给定的值是否是一个字符串。
+ *
+ * @param value 要检查的值。
+ * @returns 如果 value 是一个字符串，则返回 true，否则返回 false。
+ */
+declare function isString(value: unknown): value is string;
+export default isString;

package/dist/core/is-undefined.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 检查一个值是否为 undefined。
+ *
+ * @param value 需要检查的值。
+ * @returns 如果值为 undefined，则返回 true；否则返回 false。
+ */
+declare function isUndefined(value: unknown): value is undefined;
+export default isUndefined;

package/dist/file/batch-download-file.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 批量下载文件并打包为 ZIP
+ *
+ * @param fileList 文件列表，包含文件路径和文件名
+ * @param zipName 打包后的 ZIP 文件名
+ */
+declare function batchDownloadFile(fileList: Array<{
+    filePath: string;
+    fileName?: string;
+}>, zipName: string): Promise<void>;
+export default batchDownloadFile;

package/dist/file/extends/enum.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 文件后缀类型枚举
+ */
+declare const FileSuffixEnum: {
+    readonly DOC: "doc";
+    readonly DOCX: "docx";
+    readonly PDF: "pdf";
+    readonly PPT: "ppt";
+    readonly PPTX: "pptx";
+    readonly XLS: "xls";
+    readonly XLSX: "xlsx";
+    readonly JPG: "jpg";
+    readonly PNG: "png";
+    readonly JPEG: "jpeg";
+    readonly WEBP: "webp";
+    readonly GIF: "gif";
+    readonly MP4: "mp4";
+    readonly AVI: "avi";
+    readonly FLV: "flv";
+    readonly MKV: "mkv";
+    readonly MP3: "mp3";
+    readonly WAV: "wav";
+    readonly TXT: "txt";
+    readonly HTML: "html";
+    readonly NULL: "";
+};
+/**
+ * 图片后缀类型枚举
+ */
+declare const ImageFileSuffixEnum: {
+    readonly JPG: "jpg";
+    readonly PNG: "png";
+    readonly GIF: "gif";
+    readonly JPEG: "jpeg";
+    readonly WEBP: "webp";
+};
+/**
+ * 视频文件后缀类型枚举
+ */
+declare const VideoFileSuffixEnum: {
+    readonly MP4: "mp4";
+    readonly AVI: "avi";
+    readonly FLV: "flv";
+    readonly MKV: "mkv";
+};
+/**
+ * PPT文件后缀类型枚举
+ */
+declare const PptFileSuffixEnum: {
+    readonly PPT: "ppt";
+    readonly PPTX: "pptx";
+};
+/**
+ * 文档文件后缀类型枚举
+ */
+declare const DocumentFileSuffixEnum: {
+    readonly DOC: "doc";
+    readonly DOCX: "docx";
+    readonly PDF: "pdf";
+    readonly TXT: "txt";
+    readonly XLS: "xls";
+    readonly XLSX: "xlsx";
+};
+/**
+ * feedType类型枚举
+ */
+declare const FileItemFeedTypeEnum: {
+    readonly ALL: "";
+    readonly DOCUMENT: 0;
+    readonly TEXT: 1;
+    readonly IMG: 2;
+    readonly VIDEO: 3;
+    readonly PPT: 4;
+    readonly QA: 5;
+    readonly AUDIO: 6;
+    readonly MUSIC: 7;
+    readonly AUTOHTML: 8;
+    readonly TWEET: 9;
+    readonly COMIC_STRIP: 10;
+};
+export { FileSuffixEnum, FileItemFeedTypeEnum, ImageFileSuffixEnum, VideoFileSuffixEnum, PptFileSuffixEnum, DocumentFileSuffixEnum };

package/dist/file/extends/regex.d.ts

@@ -0,0 +1,3 @@
+declare const fileSuffixRegex: RegExp;
+declare const fileNameRegex: RegExp;
+export { fileSuffixRegex, fileNameRegex };

package/dist/file/get-file-feed-type.d.ts

@@ -0,0 +1,9 @@
+import { FileItemFeedType } from './types';
+/**
+ * 根据文件路径获取文件类型
+ *
+ * @param filePath 文件路径
+ * @returns 文件类型（FileItemFeedTypeEnum）或 undefined（如果无法识别）
+ */
+declare function getFileFeedType(filePath: string): FileItemFeedType | undefined;
+export default getFileFeedType;

package/dist/file/get-file-icon.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 根据文件路径获取对应的图标
+ *
+ * @param filePath 文件路径
+ * @returns 图标路径
+ */
+declare function getFileIcon(filePath: string): string;
+export default getFileIcon;

package/dist/file/get-file-item-icon.d.ts

@@ -0,0 +1,9 @@
+import { IFileItem } from './types';
+/**
+ * 根据文件的后缀文件类型获取文件类型图标
+ *
+ * @param fileItem 文件实例
+ * @returns 文件图标
+ */
+declare function getFileItemIcon(fileItem: IFileItem): string;
+export default getFileItemIcon;

package/dist/file/get-file-item-suffix.d.ts

@@ -0,0 +1,9 @@
+import { FileSuffix, IFileItem } from './types';
+/**
+ * 获取文件类型后缀，内部包含各种逻辑，可直接调用和修改
+ *
+ * @param fileItem  文件实例
+ * @returns 文件类型后缀
+ */
+declare function getFileItemSuffix(fileItem: IFileItem): FileSuffix;
+export default getFileItemSuffix;

package/dist/file/get-file-name.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 获取完整的文件名（包含后缀）
+ *
+ * @param  filePath 文件路径
+ * @returns  完整的文件名
+ */
+declare function getFileName(filePath: string): string;
+export default getFileName;

package/dist/file/get-file-suffix-icon.d.ts

@@ -0,0 +1,9 @@
+import { FileSuffix } from './types';
+/**
+ * 根据文件后缀获取对应的图标
+ *
+ * @param fileSuffix 文件后缀（需为 FileSuffixEnum 中的有效值）
+ * @returns 对应的图标路径，若未匹配则返回默认图标
+ */
+declare function getFileSuffixIcon(fileSuffix: FileSuffix): string;
+export default getFileSuffixIcon;

package/dist/file/get-file-suffix.d.ts

@@ -0,0 +1,9 @@
+import { FileSuffix } from './types';
+/**
+ * 获取文件后缀
+ *
+ * @param  filePath 文件路径或文件名
+ * @returns 文件后缀
+ */
+declare function getFileSuffix(filePath: string): FileSuffix;
+export default getFileSuffix;

package/dist/file/get-file-title.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 获取文件名（不包含后缀）
+ *
+ * @param  filePath 文件路径
+ * @returns  文件名（不包含后缀）
+ */
+declare function getFileTitle(filePath: string): string;
+export default getFileTitle;

package/dist/file/index.d.ts

@@ -0,0 +1,19 @@
+import { default as batchDownloadFile } from './batch-download-file';
+import { FileSuffixEnum, FileItemFeedTypeEnum, ImageFileSuffixEnum } from './extends/enum';
+import { default as getFileFeedType } from './get-file-feed-type';
+import { default as getFileIcon } from './get-file-icon';
+import { default as getFileSuffixIcon } from './get-file-suffix-icon';
+import { default as getFileItemIcon } from './get-file-item-icon';
+import { default as getFileItemSuffix } from './get-file-item-suffix';
+import { default as getFileName } from './get-file-name';
+import { default as getFileSuffix } from './get-file-suffix';
+import { default as getFileTitle } from './get-file-title';
+import { default as isDocumentFilePath } from './is-document-file-path';
+import { default as isFilePath } from './is-file-path';
+import { default as isImageFilePath } from './is-image-file-path';
+import { default as isPptFilePath } from './is-ppt-file-path';
+import { default as isVideoFilePath } from './is-video-file-path';
+import { default as singleDownloadFile } from './single-download-file';
+import { IFileItem, FileSuffix, FileItemFeedType, ImageFileSuffix, VideoFileSuffix, PptFileSuffix, DocumentFileSuffix } from './types';
+export type { IFileItem, FileSuffix, FileItemFeedType, ImageFileSuffix, VideoFileSuffix, PptFileSuffix, DocumentFileSuffix };
+export { getFileName, getFileTitle, getFileSuffix, isFilePath, getFileIcon, getFileItemIcon, getFileSuffixIcon, getFileItemSuffix, singleDownloadFile, batchDownloadFile, FileSuffixEnum, FileItemFeedTypeEnum, ImageFileSuffixEnum, getFileFeedType, isImageFilePath, isVideoFilePath, isDocumentFilePath, isPptFilePath };

package/dist/file/is-document-file-path.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 判断是否是有效的文档文件路径（包含doc、docx、pdf、txt、xls、xlsx）
+ *
+ * @param filePath 文件路径
+ * @returns  是否是有效的文档文件路径
+ */
+declare function isDocumentFilePath(filePath: string): boolean;
+export default isDocumentFilePath;

package/dist/file/is-file-path.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 判断是否是有效的文件路径
+ *
+ * @param filePath 文件路径
+ * @returns 是否是有效的文件路径
+ */
+declare function isFilePath(filePath: string): boolean;
+export default isFilePath;

package/dist/file/is-image-file-path.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 判断是否是有效的图片文件路径（包含jpg、jpeg、png、webp）
+ *
+ * @param filePath 文件路径
+ * @returns 是否是有效的图片文件路径
+ */
+declare function isImageFilePath(filePath: string): boolean;
+export default isImageFilePath;

package/dist/file/is-ppt-file-path.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 判断是否是有效的ppt文件路径（包含ppt、pptx）
+ *
+ * @param  filePath 文件路径
+ * @returns 是否是有效的ppt文件路径
+ */
+declare function isPptFilePath(filePath: string): boolean;
+export default isPptFilePath;

package/dist/file/is-video-file-path.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 判断是否是有效的视频文件路径（包含mp4、avi、flv、mkv）
+ *
+ * @param filePath 文件路径
+ * @returns 是否是有效的视频文件路径
+ */
+declare function isVideoFilePath(filePath: string): boolean;
+export default isVideoFilePath;

package/dist/file/single-download-file.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 下载单个文件
+ *
+ * @param filePath 文件路径（必须）
+ * @param fileName 下载时保存的文件名（可选）
+ */
+declare function singleDownloadFile(filePath: string, fileName?: string): Promise<void>;
+export default singleDownloadFile;

package/dist/file/types/index.d.ts

@@ -0,0 +1,18 @@
+import { FileSuffixEnum, FileItemFeedTypeEnum, ImageFileSuffixEnum, VideoFileSuffixEnum, PptFileSuffixEnum, DocumentFileSuffixEnum } from '../extends/enum';
+type FileSuffix = (typeof FileSuffixEnum)[keyof typeof FileSuffixEnum];
+type ImageFileSuffix = (typeof ImageFileSuffixEnum)[keyof typeof ImageFileSuffixEnum];
+type VideoFileSuffix = (typeof VideoFileSuffixEnum)[keyof typeof VideoFileSuffixEnum];
+type PptFileSuffix = (typeof PptFileSuffixEnum)[keyof typeof PptFileSuffixEnum];
+type DocumentFileSuffix = (typeof DocumentFileSuffixEnum)[keyof typeof DocumentFileSuffixEnum];
+type FileItemFeedType = (typeof FileItemFeedTypeEnum)[keyof typeof FileItemFeedTypeEnum];
+/**
+ * 明塗内部文件对象
+ */
+interface IFileItem {
+    title: string;
+    viewUrl?: string;
+    previewUrl?: string;
+    createTime?: string;
+    feedType?: FileItemFeedType;
+}
+export type { IFileItem, FileSuffix, FileItemFeedType, ImageFileSuffix, VideoFileSuffix, PptFileSuffix, DocumentFileSuffix };

package/dist/function/debounce.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 防抖函数的类型定义
+ * @template T - 原始函数的类型
+ */
+type DebouncedFunction<T extends (...args: any[]) => any> = {
+    /**
+     * 防抖后的函数，参数类型与原函数一致
+     */
+    (...args: Parameters<T>): void;
+    /**
+     * 取消防抖函数的未执行部分
+     */
+    cancel: () => void;
+};
+/**
+ * 创建一个防抖函数。
+ * 防抖函数的作用是限制一个函数在短时间内频繁触发的次数，直到指定的延迟时间结束后才执行。
+ * @param {T} callback - 需要防抖的函数
+ * @param {number} delay - 防抖的延迟时间（毫秒）
+ * @returns {DebouncedFunction<T>} 防抖后的函数，包含原函数的参数类型和取消方法
+ */
+declare function debounce<T extends (...args: any[]) => any>(callback: T, delay: number): DebouncedFunction<T>;
+export default debounce;

package/dist/function/index.d.ts

@@ -0,0 +1,3 @@
+import { default as debounce } from './debounce';
+import { default as throttle } from './throttle';
+export { throttle, debounce };

package/dist/function/throttle.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 节流函数的类型定义
+ * @template T - 原始函数的类型
+ */
+type ThrottledFunction<T extends (...args: any[]) => any> = {
+    /**
+     * 节流后的函数，参数类型与原函数一致
+     */
+    (...args: Parameters<T>): void;
+    /**
+     * 取消节流函数的未执行部分
+     */
+    cancel: () => void;
+};
+/**
+ * 创建一个节流函数。
+ * 节流函数的作用是限制一个函数在一定时间内最多执行一次，避免高频触发导致的性能问题。
+ * @param {T} callback - 需要节流的函数
+ * @param {number} delay - 节流的时间间隔（毫秒）
+ * @returns {ThrottledFunction<T>} 节流后的函数，包含原函数的参数类型和取消方法
+ */
+declare function throttle<T extends (...args: any[]) => any>(callback: T, delay: number): ThrottledFunction<T>;
+export default throttle;

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './array';
+export * from './browser';
+export * from './core';
+export * from './object';
+export * from './supply';
+export * from './web-socket';
+export * from './wrker';
+export * from './file';
+export * from './function';
+export * from './math';
+export * from './string';