@mingto/tools 1.0.675

package/dist/math/__test__/add.test.d.ts

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

package/dist/math/__test__/divide.test.d.ts

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

package/dist/math/__test__/get-decimal-places.test.d.ts

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

package/dist/math/__test__/multiply.test.d.ts

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

package/dist/math/__test__/subtract.test.d.ts

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

package/dist/math/add.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 精确地将两个数字相加，避免 JavaScript 数字运算的精度问题。
+ *
+ * @param augend 第一个数字（被加数）
+ * @param addend 第二个数字（加数）
+ * @returns 两个数字的和
+ */
+declare function add(augend: number, addend: number): number;
+export default add;

package/dist/math/calc-aspect-ratio.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 计算宽高最简整数比例
+ * @param size 尺寸数组
+ * @param size.0 宽度值
+ * @param size.1 高度值
+ * @returns  [w, h] 最简整数比例
+ */
+declare function calcAspectRatio([width, height]: [number, number]): [number, number];
+export default calcAspectRatio;

package/dist/math/divide.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 精确地将两个数字相除，避免 JavaScript 数字运算的精度问题。
+ *
+ * @param dividend 被除数
+ * @param divisor 除数
+ * @returns 两个数字的商
+ */
+declare function divide(dividend: number, divisor: number): number;
+export default divide;

package/dist/math/get-decimal-places.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 获取数字的小数位数。
+ *
+ * @param num 输入的数字（可以是整数或浮点数）。
+ * @returns 返回数字的小数位数。如果数字是整数，则返回 0。
+ */
+declare function getDecimalPlaces(num: number): number;
+export default getDecimalPlaces;

package/dist/math/index.d.ts

@@ -0,0 +1,7 @@
+import { default as add } from './add';
+import { default as calcAspectRatio } from './calc-aspect-ratio';
+import { default as divide } from './divide';
+import { default as getDecimalPlaces } from './get-decimal-places';
+import { default as multiply } from './multiply';
+import { default as subtract } from './subtract';
+export { add, calcAspectRatio, divide, getDecimalPlaces, multiply, subtract };

package/dist/math/multiply.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 精确地将两个数字相乘，避免 JavaScript 数字运算的精度问题。
+ *
+ * @param multiplier 第一个数字（乘数）
+ * @param multiplicand 第二个数字（被乘数）
+ * @returns 两个数字的乘积
+ */
+declare function multiply(multiplier: number, multiplicand: number): number;
+export default multiply;

package/dist/math/subtract.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 精确地将两个数字相减，避免 JavaScript 数字运算的精度问题。
+ *
+ * @param minuend 第一个数字（被减数）
+ * @param subtrahend 第二个数字（减数）
+ * @returns 两个数字的差
+ */
+declare function subtract(minuend: number, subtrahend: number): number;
+export default subtract;

package/dist/object/deep-freeze.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 深度冻结一个对象，防止其属性及嵌套属性被修改。
+ * 递归地冻结对象的所有属性，包括嵌套对象，确保对象的状态不可变。
+ *
+ * @param obj 需要被冻结的对象。
+ * @returns  返回深度冻结后的对象。
+ */
+declare function deepFreeze<T extends Record<string, any>>(obj: T): Readonly<T>;
+export default deepFreeze;

package/dist/object/index.d.ts

@@ -0,0 +1,3 @@
+import { default as deepFreeze } from './deep-freeze';
+import { default as pickObject } from './pick-object';
+export { deepFreeze, pickObject };

package/dist/object/pick-object.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 从给定对象中挑选指定的属性，并返回一个包含这些属性的新对象。
+ *
+ * @param obj -源对象，从中挑选属性。
+ * @param keys -需要挑选的属性键名数组。
+ * @returns 包含指定属性的新对象。
+ */
+declare function pickObject<T extends Record<string, any>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+export default pickObject;

package/dist/string/__test__/chunk-string.test.d.ts

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

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

@@ -0,0 +1,10 @@
+/**
+ * 将输入字符串按照指定的块大小分割成多个子字符串。
+ * 该函数会根据指定的块大小（`chunkSize`）将输入字符串（`str`）分割成多个子字符串，并将这些子字符串存储在一个数组中返回。
+ *
+ * @param str - 需要分割的原始字符串。
+ * @param chunkSize - 每个块的大小，默认为整个字符串的长度。
+ * @returns 一个包含分割后的子字符串的数组。
+ */
+declare function chunkString(str: string, chunkSize?: number): string[];
+export default chunkString;

package/dist/string/index.d.ts

@@ -0,0 +1,4 @@
+import { default as chunkString } from './chunk-string';
+import { default as objectToQueryString } from './object-to-query-string';
+import { default as queryStringToObject } from './query-string-to-object';
+export { chunkString, objectToQueryString, queryStringToObject };

package/dist/string/object-to-query-string.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 将对象转换为 URL 查询字符串。
+ * 该函数会遍历对象的键值对，将每个键和值进行 URL 编码，然后以 "key=value" 的形式拼接成字符串，并用 "&" 符号连接。
+ *
+ * @param obj - 需要转换的对象，对象的键为字符串，值为任意类型。
+ * @returns 转换后的 URL 查询字符串。
+ *
+ */
+declare function objectToQueryString(obj: Record<string, any>): string;
+export default objectToQueryString;

package/dist/string/query-string-to-object.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 将 URL 查询字符串转换为对象
+ *
+ * @param queryString - 需要解析的 URL 查询字符串（例如："a=1&b=2"）。
+ * @returns 转换后的对象。
+ */
+declare function queryStringToObject(queryString: string): Record<string, any>;
+export default queryStringToObject;

package/dist/supply/get-uuid.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 利用 Web Crypto API，生成一个随机的 32 位无符号整数，并将其转换为一个基于 36 进制的字符串。这种格式的字符串通常用于标识，并且可以保证在很大范围内的唯一性。
+ *
+ * @returns 返回一个随机生成的 UUID 字符串。
+ */
+declare function getUuid(): string;
+export default getUuid;

package/dist/supply/index.d.ts

@@ -0,0 +1,3 @@
+import { default as getUuid } from './get-uuid';
+import { default as timeDelay } from './time-delay';
+export { getUuid, timeDelay };

package/dist/supply/time-delay.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 延迟函数。
+ * @param delay 延迟的时间（单位：毫秒）。
+ * @returns 一个在指定延迟后解析的Promise。
+ */
+declare function timeDelay(delay: number): Promise<void>;
+export default timeDelay;

package/dist/supply/type-writer.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 流式打字机
+ * @param speed 打字速度
+ */
+declare class TypeWriter {
+    private speed;
+    private state;
+    private onEndCallback;
+    private onChangeCallback;
+    constructor(speed?: number);
+    private processQueue;
+    private init;
+    append(text: string): void;
+    stop(): void;
+    onEnd(callback: (text?: string) => void): void;
+    onChange(callback: (text?: string) => void): void;
+}
+export default TypeWriter;

package/dist/theme/index.d.ts

@@ -0,0 +1 @@
+export * from './use-theme';

package/dist/theme/use-theme.d.ts

@@ -0,0 +1,23 @@
+import { ComputedRef, Ref } from 'vue';
+/**
+ * 主题类型定义
+ */
+export type Theme = 'light' | 'dark';
+/**
+ * 主题切换 Hook
+ * @returns {object} 主题相关的方法和状态
+ */
+export declare function useTheme(): {
+    theme: Ref<Theme>;
+    isDark: ComputedRef<boolean>;
+    isLight: ComputedRef<boolean>;
+    setTheme: (theme?: Theme) => void;
+    getTheme: () => Theme;
+    setLight: () => void;
+    setDark: () => void;
+    toggleTheme: () => void;
+};
+/**
+ * 监听系统主题变化
+ * @returns {(() => void) | undefined} 清理函数或undefined
+ */

package/dist/validator/index.d.ts

@@ -0,0 +1,3 @@
+import { isValidBase64 } from './is-valid-base64';
+import { default as isValidUrl } from './is-valid-url';
+export { isValidBase64, isValidUrl, };

package/dist/validator/is-valid-base64.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 校验是否为有效的 Base64 字符串
+ * @param value 待校验的字符串
+ * @returns 是否为有效的 Base64 字符串
+ */
+export declare function isValidBase64(value: string): boolean;

package/dist/validator/is-valid-url.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 检查给定的字符串是否符合标准网页地址格式。
+ * @param value - 需要验证的字符串。
+ * @returns 如果字符串格式合格，返回true；否则返回false。
+ */
+export declare function isValidUrl(value: string): boolean;
+export default isValidUrl;

package/dist/validator/test/is-valid-url.test.d.ts

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

package/dist/web-socket/create-web-socket.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 创建一个新的 WebSocket 实例。
+ * 此函数接受一个 WebSocket 服务器的 URL 并创建一个新的 WebSocket 实例。
+ *
+ * @param  url WebSocket 服务器的 URL。
+ * @returns 返回一个新的 WebSocket 实例。
+ */
+declare function createWebSocket(url: string): WebSocket;
+export default createWebSocket;

package/dist/web-socket/index.d.ts

@@ -0,0 +1,3 @@
+import { default as createWebSocket } from './create-web-socket';
+import { default as isWebSocketSupported } from './is-web-socket-supported';
+export { createWebSocket, isWebSocketSupported };

package/dist/web-socket/is-web-socket-supported.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 检查当前浏览器是否支持 WebSocket。
+ * 此函数检查 'WebSocket' 和 'MozWebSocket' 是否存在于全局 `window` 对象中，
+ * 以确定浏览器是否支持 WebSocket。
+ *
+ * @returns 如果浏览器支持 WebSocket，则返回 `true`；否则返回 `false`。
+ */
+declare function isWebSocketSupported(): boolean;
+export default isWebSocketSupported;

package/dist/wrker/close-worker.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 关闭并终止一个 Web Worker 实例的执行。
+ * 如果传入的 worker 参数不是有效的 Worker 实例（例如，如果它是 undefined 或 null），
+ * 则不执行任何操作。
+ *
+ * @param worker - 要关闭的 Worker 实例。
+ */
+declare function closeWorker(worker: Worker | undefined | null): void;
+export default closeWorker;

package/dist/wrker/create-worker.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 创建并返回一个新的 Web Worker 实例。
+ * 这个函数接受一个函数，将其转换为字符串，并创建一个 Blob 对象。
+ * 然后，它创建一个指向该 Blob 的 URL，并用这个 URL 来创建一个新的 Worker。
+ * 最后，释放 URL 对象以供浏览器回收内存。
+ *
+ * @param fun - 要在 Worker 中执行的 JavaScript 函数。
+ * @returns 返回新创建的 Worker 实例。
+ */
+declare function createWorker(fun: (...args: any) => any): Worker;
+export default createWorker;

package/dist/wrker/index.d.ts

@@ -0,0 +1,3 @@
+import { default as closeWorker } from './close-worker';
+import { default as createWorker } from './create-worker';
+export { closeWorker, createWorker };

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@mingto/tools",
+  "type": "module",
+  "version": "1.0.675",
+  "description": "明途公共工具库",
+  "author": "hcc",
+  "license": "ISC",
+  "keywords": [
+    "ts",
+    "tools"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build"
+  },
+  "dependencies": {
+    "axios": "^1.7.9",
+    "file-saver": "^2.0.5",
+    "jszip": "^3.10.1"
+  },
+  "devDependencies": {
+    "@types/file-saver": "^2.0.7"
+  }
+}