@mingto/tools 1.0.675

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

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

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * 判断是否是有效的文件路径（包含doc、docx、pdf、ppt、pptx、xls、xlsx、jpg、jpeg、png、webp、gif、mp4、avi、flv、mkv、mp3、mav、txt、html）。
+ *
+ * @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、gif）。
+ *
+ * @param filePath 文件路径。
+ * @returns 是否是有效的图片文件路径。
+ */
+declare function isImageFilePath(filePath: string): boolean;
+export default isImageFilePath;

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

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

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-base64.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 下载 base64 图片或文件
+ * @param base64Data - base64 data URL (如: data:image/png;base64,...)
+ * @param fileName - 保存的文件名和扩展名
+ * @returns Promise<void>
+ */
+declare function downloadBase64File(base64Data: string, fileName: string): Promise<void>;
+export default downloadBase64File;

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

@@ -0,0 +1,12 @@
+/**
+ * 单文件下载
+ * @param source 下载源，支持 Base64 字符串或 URL
+ * @param fileName 下载文件名
+ * - 当 source 为 Base64 字符串时，必须提供文件名
+ * - 当 source 为 URL 且为文件路径时，若未提供文件名，则默认使用 URL 路径中的文件名
+ * - 当 source 为 URL 且不为文件路径时，传入的文件名参数无效，将使用服务器响应头中的文件名
+ *
+ * @returns Promise<void> 下载完成后解析的 Promise
+ */
+declare function singleDownloadFile(source: string, fileName?: string, pathQuery?: Record<string, string>): Promise<void>;
+export default singleDownloadFile;

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

@@ -0,0 +1,9 @@
+import { CompressFileSuffixEnum, DocumentFileSuffixEnum, FileSuffixEnum, ImageFileSuffixEnum, MusicFileSuffixEnum, PptFileSuffixEnum, VideoFileSuffixEnum } 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 MusicFileSuffix = (typeof MusicFileSuffixEnum)[keyof typeof MusicFileSuffixEnum];
+type CompressFileSuffix = (typeof CompressFileSuffixEnum)[keyof typeof CompressFileSuffixEnum];
+export type { CompressFileSuffix, DocumentFileSuffix, FileSuffix, ImageFileSuffix, MusicFileSuffix, PptFileSuffix, VideoFileSuffix, };

package/dist/file/update-file-path-query.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 更新文件路径的查询参数
+ * @param filePath 文件路径
+ * @param objectQuery 查询参数对象
+ * @returns 更新后的文件路径
+ */
+declare function updateFilePathQuery(filePath: string, objectQuery: Record<string, string>, isAppend?: boolean): string;
+export default updateFilePathQuery;

package/dist/function/debounce.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 防抖函数的类型定义
+ * @template T - 原始函数的类型
+ */
+interface 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 { debounce, throttle };

package/dist/function/throttle.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 节流函数的类型定义
+ * @template T - 原始函数的类型
+ */
+interface 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/i18n/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 国际化管理器
+ */
+export declare class I18n {
+    private currentLocale;
+    private messages;
+    /**
+     * 设置当前语言
+     * @param locale - 语言代码，如 'zh-cn', 'en', 'ms', 'ar', 'zh-tw', 'th', 'vi'
+     */
+    setLocale(locale: string): void;
+    /**
+     * 获取当前语言
+     * @returns 当前语言代码
+     */
+    getLocale(): string;
+    /**
+     * 注册语言包
+     * @param locale - 语言代码
+     * @param messages - 语言包内容
+     */
+    registerMessages(locale: string, messages: Record<string, string>): void;
+    /**
+     * 获取翻译文本
+     * @param key - 翻译键
+     * @param fallback - 备用文本
+     * @returns 翻译后的文本
+     */
+    t(key: string, fallback?: string): string;
+}
+export declare const i18n: I18n;
+export type Locale = 'zh-cn' | 'zh-tw' | 'en' | 'ms' | 'ar' | 'th' | 'vi';

package/dist/i18n/locales/ar.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 阿拉伯语语言包
+ */
+export declare const ar: {
+    'audio.permission.no_user_interaction': string;
+    'audio.permission.autoplay_blocked': string;
+    'audio.permission.autoplay_unknown_error': string;
+    'audio.permission.secure_context_error': string;
+    'audio.permission.permission_denied_permanently': string;
+    'audio.permission.media_devices_api_unavailable': string;
+    'audio.permission.not_allowed_error': string;
+    'audio.permission.not_readable_error': string;
+    'audio.permission.not_found_error': string;
+    'audio.permission.security_error': string;
+    'audio.permission.overconstrained_error': string;
+    'audio.permission.microphone_unknown_error': string;
+    'audio.permission.microphone_timeout_error': string;
+};

package/dist/i18n/locales/en.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 英文语言包
+ */
+export declare const en: {
+    'audio.permission.no_user_interaction': string;
+    'audio.permission.autoplay_blocked': string;
+    'audio.permission.autoplay_unknown_error': string;
+    'audio.permission.secure_context_error': string;
+    'audio.permission.permission_denied_permanently': string;
+    'audio.permission.media_devices_api_unavailable': string;
+    'audio.permission.not_allowed_error': string;
+    'audio.permission.not_readable_error': string;
+    'audio.permission.not_found_error': string;
+    'audio.permission.security_error': string;
+    'audio.permission.overconstrained_error': string;
+    'audio.permission.microphone_unknown_error': string;
+    'audio.permission.microphone_timeout_error': string;
+};

package/dist/i18n/locales/ms.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 马来语语言包
+ */
+export declare const ms: {
+    'audio.permission.no_user_interaction': string;
+    'audio.permission.autoplay_blocked': string;
+    'audio.permission.autoplay_unknown_error': string;
+    'audio.permission.secure_context_error': string;
+    'audio.permission.permission_denied_permanently': string;
+    'audio.permission.media_devices_api_unavailable': string;
+    'audio.permission.not_allowed_error': string;
+    'audio.permission.not_readable_error': string;
+    'audio.permission.not_found_error': string;
+    'audio.permission.security_error': string;
+    'audio.permission.overconstrained_error': string;
+    'audio.permission.microphone_unknown_error': string;
+    'audio.permission.microphone_timeout_error': string;
+};

package/dist/i18n/locales/th.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 泰语语言包
+ */
+export declare const th: {
+    'audio.permission.no_user_interaction': string;
+    'audio.permission.autoplay_blocked': string;
+    'audio.permission.autoplay_unknown_error': string;
+    'audio.permission.secure_context_error': string;
+    'audio.permission.permission_denied_permanently': string;
+    'audio.permission.media_devices_api_unavailable': string;
+    'audio.permission.not_allowed_error': string;
+    'audio.permission.not_readable_error': string;
+    'audio.permission.not_found_error': string;
+    'audio.permission.security_error': string;
+    'audio.permission.overconstrained_error': string;
+    'audio.permission.microphone_unknown_error': string;
+    'audio.permission.microphone_timeout_error': string;
+};

package/dist/i18n/locales/vi.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 越南语语言包
+ */
+export declare const vi: {
+    'audio.permission.no_user_interaction': string;
+    'audio.permission.autoplay_blocked': string;
+    'audio.permission.autoplay_unknown_error': string;
+    'audio.permission.secure_context_error': string;
+    'audio.permission.permission_denied_permanently': string;
+    'audio.permission.media_devices_api_unavailable': string;
+    'audio.permission.not_allowed_error': string;
+    'audio.permission.not_readable_error': string;
+};

package/dist/i18n/locales/zh-cn.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 简体中文语言包
+ */
+export declare const zhCn: {
+    'audio.permission.no_user_interaction': string;
+    'audio.permission.autoplay_blocked': string;
+    'audio.permission.autoplay_unknown_error': string;
+    'audio.permission.secure_context_error': string;
+    'audio.permission.permission_denied_permanently': string;
+    'audio.permission.media_devices_api_unavailable': string;
+    'audio.permission.not_allowed_error': string;
+    'audio.permission.not_readable_error': string;
+    'audio.permission.not_found_error': string;
+    'audio.permission.security_error': string;
+    'audio.permission.overconstrained_error': string;
+    'audio.permission.microphone_unknown_error': string;
+    'audio.permission.microphone_timeout_error': string;
+};

package/dist/i18n/locales/zh-tw.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 繁体中文语言包
+ */
+export declare const zhTw: {
+    'audio.permission.no_user_interaction': string;
+    'audio.permission.autoplay_blocked': string;
+    'audio.permission.autoplay_unknown_error': string;
+    'audio.permission.secure_context_error': string;
+    'audio.permission.permission_denied_permanently': string;
+    'audio.permission.media_devices_api_unavailable': string;
+    'audio.permission.not_allowed_error': string;
+    'audio.permission.not_readable_error': string;
+    'audio.permission.not_found_error': string;
+    'audio.permission.security_error': string;
+    'audio.permission.overconstrained_error': string;
+    'audio.permission.microphone_unknown_error': string;
+    'audio.permission.microphone_timeout_error': string;
+};

package/dist/i18n/setup.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 初始化国际化配置
+ */
+export declare function setupI18n(): void;

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import { Locale } from './i18n';
+export * from './array';
+export * from './browser';
+export * from './constant';
+export * from './core';
+export * from './file';
+export * from './function';
+export * from './math';
+export * from './object';
+export * from './string';
+export * from './supply';
+export * from './theme';
+export * from './validator';
+export * from './web-socket';
+export * from './wrker';
+declare const _default: {
+    /**
+     * 设置语言
+     * @param locale - 语言代码，支持 'zh-cn', 'zh-tw', 'en', 'ms', 'ar', 'th'、'vi'
+     */
+    locale(locale: Locale): void;
+    /**
+     * 获取当前语言
+     * @returns 当前语言代码
+     */
+    getLocale(): Locale;
+};
+export default _default;