@minson1994/ms-utils 1.0.0

package/dist/utils/AlgorithmUtils.d.ts

@@ -0,0 +1,98 @@
+/** MD5 ????? */
+export type Md5Length = 16 | 32;
+/** AES ????? */
+export interface AesOptions {
+    /** AES key??? iv ?? UTF-8 WordArray ????? iv ?? crypto-js passphrase ??? */
+    key: string;
+    /** AES iv?????? CBC + PKCS7? */
+    iv?: string;
+}
+/** HMAC ??? */
+export type HmacAlgorithm = "SHA256" | "SHA1" | "MD5";
+/** RSA ???? */
+export interface RsaKeyPair {
+    publicKey: CryptoKey;
+    privateKey: CryptoKey;
+}
+/** RSA PEM ???? */
+export interface RsaPemKeyPair {
+    publicKey: string;
+    privateKey: string;
+}
+/**
+ * ??????
+ *
+ * ???????????????????HMAC?UUID ???????
+ * Base64?MD5?AES?SHA256?HMAC?UUID?????? crypto-js/???????
+ * RSA ???? WebCrypto SubtleCrypto??? crypto-js ??? RSA?
+ */
+export default class AlgorithmUtils {
+    /** Base64 ?? UTF-8 ??? */
+    static base64Encode(text: string): string;
+    /** Base64 ??? UTF-8 ??? */
+    static base64Decode(base64: string): string;
+    /**
+     * ?? MD5?
+     *
+     * @param length 16 ??? 32 ? MD5 ??? 16 ??
+     * @param upper ??????
+     */
+    static md5(text: string, length?: Md5Length, upper?: boolean): string;
+    /** ?? 16 ? MD5? */
+    static md5_16(text: string, upper?: boolean): string;
+    /** ?? 32 ? MD5? */
+    static md5_32(text: string, upper?: boolean): string;
+    /** AES ????? iv ??? crypto-js passphrase ???? iv ??? CBC + PKCS7? */
+    static aesEncrypt(text: string, options: AesOptions | string): string;
+    /** AES ??? */
+    static aesDecrypt(ciphertext: string, options: AesOptions | string): string;
+    /** ?? SHA256? */
+    static sha256(text: string, upper?: boolean): string;
+    /** ?? HMAC? */
+    static hmac(text: string, key: string, algorithm?: HmacAlgorithm, upper?: boolean): string;
+    /** ?? HMAC-SHA256? */
+    static hmacSha256(text: string, key: string, upper?: boolean): string;
+    /** ?? UUID v4? */
+    static uuid(): string;
+    /** ??????????????? min ? max? */
+    static randomInt(min: number, max: number): number;
+    /** ?? 0 <= n < 1 ?????? */
+    static randomFloat(): number;
+    /** ???????? */
+    static randomString(length?: number, chars?: string): string;
+    /** ?? RSA-OAEP ???? */
+    static rsaGenerateKeyPair(modulusLength?: number): Promise<RsaKeyPair>;
+    /** ?? RSA-OAEP PEM ???? */
+    static rsaGeneratePemKeyPair(modulusLength?: number): Promise<RsaPemKeyPair>;
+    /** RSA-OAEP ??????? Base64 ??? */
+    static rsaEncrypt(text: string, publicKey: CryptoKey | string): Promise<string>;
+    /** RSA-OAEP ???? Base64 ??? */
+    static rsaDecrypt(ciphertext: string, privateKey: CryptoKey | string): Promise<string>;
+    /** ?? RSA ??? PEM? */
+    static rsaExportPublicKey(publicKey: CryptoKey): Promise<string>;
+    /** ?? RSA ??? PEM? */
+    static rsaExportPrivateKey(privateKey: CryptoKey): Promise<string>;
+    /** ? PEM ?? RSA ??? */
+    static rsaImportPublicKey(pem: string): Promise<CryptoKey>;
+    /** ? PEM ?? RSA ??? */
+    static rsaImportPrivateKey(pem: string): Promise<CryptoKey>;
+    /** ??? AES ??? */
+    private static normalizeAesOptions;
+    /** ??????? */
+    private static randomBytes;
+    /** ?? SubtleCrypto? */
+    private static subtle;
+    /** ArrayBuffer ? Base64? */
+    private static arrayBufferToBase64;
+    /** Base64 ? ArrayBuffer? */
+    private static base64ToArrayBuffer;
+    /** ArrayBuffer ? PEM? */
+    private static arrayBufferToPem;
+    /** PEM ? ArrayBuffer? */
+    private static pemToArrayBuffer;
+    /** ??????? Base64? */
+    private static binaryToBase64;
+    /** Base64 ???????? */
+    private static base64ToBinary;
+}
+//# sourceMappingURL=AlgorithmUtils.d.ts.map

package/dist/utils/AlgorithmUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlgorithmUtils.d.ts","sourceRoot":"","sources":["../../src/utils/AlgorithmUtils.ts"],"names":[],"mappings":"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"}

package/dist/utils/Concurrency.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 根据函数参数生成并发去重 key。
+ */
+export type ConcurrentKeyFactory<TArgs extends unknown[]> = (...args: TArgs) => string;
+/**
+ * 并发调用控制器。
+ *
+ * 用于将同名同参的并发异步调用合并为一次真实执行，后续调用复用首个 Promise。
+ */
+export default class Concurrency {
+    /**
+     * 正在执行中的请求映射。
+     */
+    static pendingRequests: Map<string, Promise<unknown>>;
+    /**
+     * 创建一个带并发去重能力的异步函数。
+     *
+     * @param fn 原始异步函数
+     * @param name 调用名称，用于隔离不同业务
+     * @param getKey 参数转 key 方法，默认会对对象 key 排序后序列化
+     */
+    static createConcurrentCall<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => Promise<TResult>, name: string, getKey?: ConcurrentKeyFactory<TArgs>): (...args: TArgs) => Promise<TResult>;
+    /**
+     * 默认 key 生成逻辑。
+     */
+    private static defaultKey;
+}
+//# sourceMappingURL=Concurrency.d.ts.map

package/dist/utils/Concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Concurrency.d.ts","sourceRoot":"","sources":["../../src/utils/Concurrency.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,KAAK,SAAS,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,MAAM,CAAC;AAEvF;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAC5B;;OAEG;IACH,MAAM,CAAC,eAAe,gCAAuC;IAE7D;;;;;;OAMG;IACH,MAAM,CAAC,oBAAoB,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EACxD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,EACxC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,oBAAoB,CAAC,KAAK,CAAgD,GACnF,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC;IAqBvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;CAW5B"}

package/dist/utils/CookieUtils.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Cookie 工具类。
+ *
+ * 依赖浏览器 document.cookie，只应从 `@minson/ms-utils/browser` 子路径使用。
+ */
+export default class CookieUtils {
+    /**
+     * 读取指定 Cookie。
+     */
+    static read(name: string): string | null;
+    /**
+     * 写入 Cookie。
+     *
+     * @param expires number 表示多少秒后过期；Date/string 表示绝对过期时间
+     */
+    static write(name: string, value: string, expires?: Date | number | string, path?: string, domain?: string, secure?: boolean): void;
+    /**
+     * 删除指定 Cookie。
+     */
+    static delete(name: string, path?: string, domain?: string, secure?: boolean): void;
+    /**
+     * 将对象序列化为 JSON 后写入 Cookie。
+     */
+    static writeJSON(name: string, value: unknown, expires?: Date | number | string, path?: string, domain?: string, secure?: boolean): void;
+    /**
+     * 读取 Cookie 并按 JSON 反序列化。
+     */
+    static readJSON<TValue = unknown>(name: string): TValue | null;
+    /**
+     * 读取所有 Cookie。
+     */
+    static readAll(): Record<string, string>;
+    /**
+     * 判断指定 Cookie 是否存在。
+     */
+    static has(name: string): boolean;
+}
+//# sourceMappingURL=CookieUtils.d.ts.map

package/dist/utils/CookieUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CookieUtils.d.ts","sourceRoot":"","sources":["../../src/utils/CookieUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAC5B;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IASxC;;;;OAIG;IACH,MAAM,CAAC,KAAK,CACR,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,IAAI,GAAG,MAAM,GAAG,MAAc,EACvC,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,OAAO,GACjB,IAAI;IAiBP;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAInF;;OAEG;IACH,MAAM,CAAC,SAAS,CACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,IAAI,GAAG,MAAM,GAAG,MAAc,EACvC,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,OAAO,GACjB,IAAI;IAIP;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAU9D;;OAEG;IACH,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAWxC;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAGpC"}

package/dist/utils/Hook.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Promise Hook 工具。
+ *
+ * 适合“先发起动作，后由外部回调按编号唤醒”的场景，例如 postMessage、扫码、第三方 SDK 回调。
+ */
+export default class Hook<TResult = unknown> {
+    /**
+     * Hook 编号。
+     */
+    no: string | number;
+    /**
+     * 超时时间，单位秒。
+     */
+    timeout: number;
+    /**
+     * 超时定时器。
+     */
+    timer?: ReturnType<typeof setTimeout>;
+    private resolve?;
+    private reject?;
+    /**
+     * @param no Hook 编号，默认随机生成
+     * @param timeout 超时时间，单位秒
+     */
+    constructor(no?: string | number, timeout?: number);
+    /**
+     * 回调
+     * @param data
+     */
+    call(data: TResult | Error): void;
+    /**
+     * 注册一个 Hook，并返回等待外部唤醒的 Promise。
+     */
+    static on<TResult = unknown>(hook: Hook<TResult> | string | number): Promise<TResult>;
+    /**
+     * 唤醒指定 Hook。
+     *
+     * data 为 Error 时 reject，否则 resolve。
+     */
+    static call<TResult = unknown>(hook: Hook<TResult> | string | number, data: TResult | Error): void;
+    /**
+     * 清理指定 Hook。
+     */
+    static clear(hook: Hook<any> | string | number): void;
+    /**
+     * 自动生成 Hook 编号并执行回调，随后等待外部通过编号 call。
+     */
+    static no<TResult = unknown>(fn: (no: string | number) => void | Promise<void>, timeout?: number): Promise<TResult>;
+}
+//# sourceMappingURL=Hook.d.ts.map

package/dist/utils/Hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Hook.d.ts","sourceRoot":"","sources":["../../src/utils/Hook.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,IAAI,CAAC,OAAO,GAAG,OAAO;IACvC;;OAEG;IACH,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,SAAM;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IACtC,OAAO,CAAC,OAAO,CAAC,CAA2B;IAC3C,OAAO,CAAC,MAAM,CAAC,CAA6B;IAE5C;;;OAGG;gBACS,EAAE,GAAE,MAAM,GAAG,MAA2B,EAAE,OAAO,CAAC,EAAE,MAAM;IAKtE;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI;IAIjC;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBrF;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI;IASlG;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI;IAOrD;;OAEG;WACU,EAAE,CAAC,OAAO,GAAG,OAAO,EAC7B,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACjD,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC;CAKtB"}

package/dist/utils/TaskQueue.d.ts

@@ -0,0 +1,159 @@
+/**
+ * 任务函数。
+ */
+export type Task<TResult = unknown> = () => TResult | Promise<TResult>;
+/**
+ * TaskQueue 配置。
+ */
+export interface TaskQueueOptions {
+    /**
+     * 最大并发数。0 表示不限制并发，默认 1。
+     */
+    concurrency?: number;
+    /**
+     * 单个任务默认超时时间，单位毫秒。0 表示不限制，默认 30000。
+     */
+    timeout?: number;
+    /**
+     * 每个任务结束后，启动下一轮任务前的等待时间，单位毫秒。
+     */
+    taskDelayMs?: number;
+}
+/**
+ * 任务队列。
+ *
+ * 用于控制异步任务并发数，支持超时、任务间延迟、暂停、恢复、停止和等待空闲。
+ */
+export default class TaskQueue {
+    /**
+     * 最大并发数。0 表示不限制。
+     */
+    concurrency: number;
+    /**
+     * 单个任务默认超时时间，单位毫秒。0 表示不限制。
+     */
+    timeout: number;
+    /**
+     * 每个任务结束后的间隔时间，单位毫秒。
+     */
+    taskDelayMs: number;
+    /**
+     * 当前运行中的任务数。
+     */
+    running: number;
+    /**
+     * 等待执行的任务队列。
+     */
+    private queue;
+    /**
+     * 是否暂停。
+     */
+    private paused;
+    /**
+     * 是否停止。
+     */
+    private stopped;
+    /**
+     * waitForIdle 等待回调。
+     */
+    private idleResolvers;
+    constructor(options?: TaskQueueOptions);
+    /**
+     * 延迟指定毫秒后返回 value。
+     */
+    static delay<TResult = void>(ms: number, value?: TResult): Promise<TResult>;
+    /**
+     * 设置最大并发数。
+     */
+    setConcurrency(concurrency: number): void;
+    /**
+     * 设置默认任务超时时间，单位毫秒。
+     */
+    setTimeout(timeout: number): void;
+    /**
+     * 设置任务间隔时间，单位毫秒。
+     */
+    setTaskDelay(delayMs: number): void;
+    /**
+     * 添加单个任务。
+     *
+     * @param task 要执行的任务函数
+     * @param timeout 当前任务的超时时间，单位毫秒。不传则使用默认超时时间
+     */
+    add<TResult>(task: Task<TResult>, timeout?: number): Promise<TResult>;
+    /**
+     * 批量添加任务。
+     */
+    addMany<TResult>(tasks?: Array<Task<TResult>>): Promise<TResult[]>;
+    /**
+     * 暂停队列。
+     *
+     * 已经运行的任务不会被取消，但不会启动新任务。
+     */
+    pause(): void;
+    /**
+     * 恢复队列。
+     */
+    resume(): void;
+    /**
+     * 清空等待队列。
+     *
+     * 运行中的任务不受影响。
+     */
+    clear(reason?: Error): void;
+    /**
+     * 停止队列。
+     *
+     * 会拒绝所有等待中的任务，并禁止继续添加新任务。
+     */
+    stop(reason?: Error): void;
+    /**
+     * 重置队列状态。
+     *
+     * 会清空等待队列和运行计数，不会取消已经运行的异步函数本身。
+     */
+    reset(): void;
+    /**
+     * 等待队列空闲。
+     *
+     * 当没有等待任务且没有运行中任务时 resolve。
+     */
+    waitForIdle(): Promise<void>;
+    /**
+     * 等待中的任务数。
+     */
+    get size(): number;
+    /**
+     * 当前运行中的任务数。
+     */
+    get activeCount(): number;
+    /**
+     * 尝试启动队列中的任务。
+     */
+    private next;
+    /**
+     * 判断是否还能启动更多任务。
+     */
+    private canRunMore;
+    /**
+     * 执行单个任务。
+     */
+    private runTask;
+    /**
+     * resolve 指定任务，避免重复 settle。
+     */
+    private resolveEntry;
+    /**
+     * reject 指定任务，避免重复 settle。
+     */
+    private rejectEntry;
+    /**
+     * reject 所有等待中的任务。
+     */
+    private rejectQueued;
+    /**
+     * 如果队列空闲，唤醒所有 waitForIdle。
+     */
+    private resolveIdleIfNeeded;
+}
+//# sourceMappingURL=TaskQueue.d.ts.map

package/dist/utils/TaskQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskQueue.d.ts","sourceRoot":"","sources":["../../src/utils/TaskQueue.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAUD;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,SAAS;IAC1B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,SAAK;IACZ;;OAEG;IACH,OAAO,CAAC,KAAK,CAA6B;IAC1C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAS;IACvB;;OAEG;IACH,OAAO,CAAC,OAAO,CAAS;IACxB;;OAEG;IACH,OAAO,CAAC,aAAa,CAAyB;gBAElC,OAAO,GAAE,gBAAqB;IAO1C;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAM3E;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKzC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAInC;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBrE;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,KAAK,GAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAItE;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,IAAI,IAAI;IAMd;;;;OAIG;IACH,KAAK,CAAC,MAAM,QAAiC,GAAG,IAAI;IAMpD;;;;OAIG;IACH,IAAI,CAAC,MAAM,QAAiC,GAAG,IAAI;IAMnD;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAQb;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,OAAO,CAAC,IAAI;IAWZ;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;YACW,OAAO;IA2BrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAM9B"}

package/dist/utils/TimeUtils.d.ts

@@ -0,0 +1,82 @@
+/**
+ * 可被 TimeUtils 接收的时间输入。
+ */
+export type DateInput = Date | number | string;
+/**
+ * 时间加减与差值计算单位。
+ */
+export type DateUnit = 'millisecond' | 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year';
+/**
+ * 时间工具类。
+ *
+ * 只依赖 JavaScript 原生 Date，适合浏览器、Node、小程序等运行环境。
+ */
+export default class TimeUtils {
+    /**
+     * 获取当前时间。
+     */
+    static now(): Date;
+    /**
+     * 获取时间戳。
+     *
+     * @param date 时间输入，默认当前时间
+     * @param unit 返回毫秒或秒
+     */
+    static timestamp(date?: DateInput, unit?: 'millisecond' | 'second'): number;
+    /**
+     * 将 Date、时间戳、时间字符串转换为新的 Date 实例。
+     *
+     * 字符串中的 `-` 会替换成 `/`，兼容部分浏览器对 `yyyy-MM-dd` 的解析差异。
+     */
+    static toDate(value: DateInput): Date;
+    /**
+     * 判断输入是否可转换为有效时间。
+     */
+    static isValid(value: unknown): value is DateInput;
+    /**
+     * 格式化时间。
+     *
+     * 支持 token：yyyy、MM、dd、HH、mm、ss、SSS。
+     */
+    static format(date?: DateInput, pattern?: string): string;
+    /**
+     * 给时间增加指定单位的数量。
+     */
+    static add(date: DateInput, amount: number, unit: DateUnit): Date;
+    /**
+     * 给时间减少指定单位的数量。
+     */
+    static subtract(date: DateInput, amount: number, unit: DateUnit): Date;
+    /**
+     * 计算两个时间的差值。
+     *
+     * month/year 当前按 30/365 天近似计算，适合轻量工具场景。
+     */
+    static diff(start: DateInput, end: DateInput, unit?: DateUnit): number;
+    /**
+     * 格式化为相对当前时间的描述。
+     *
+     * 默认返回中文短语，例如：刚刚、3 分钟前、2 小时后。
+     *
+     * @param date 目标时间
+     * @param base 基准时间，默认当前时间
+     */
+    static fromNow(date: DateInput, base?: DateInput): string;
+    /**
+     * 获取当天开始时间：00:00:00.000。
+     */
+    static startOfDay(date?: DateInput): Date;
+    /**
+     * 获取当天结束时间：23:59:59.999。
+     */
+    static endOfDay(date?: DateInput): Date;
+    /**
+     * 延迟指定毫秒数。
+     */
+    static wait(time: number): Promise<void>;
+    /**
+     * 数字左侧补零。
+     */
+    private static pad;
+}
+//# sourceMappingURL=TimeUtils.d.ts.map

package/dist/utils/TimeUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeUtils.d.ts","sourceRoot":"","sources":["../../src/utils/TimeUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAExG;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,SAAS;IAC1B;;OAEG;IACH,MAAM,CAAC,GAAG,IAAI,IAAI;IAIlB;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,GAAE,SAAsB,EAAE,IAAI,GAAE,aAAa,GAAG,QAAwB,GAAG,MAAM;IAKtG;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAMrC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS;IAKlD;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,GAAE,SAAsB,EAAE,OAAO,SAAwB,GAAG,MAAM;IAepF;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI;IA+BjE;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI;IAItE;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,GAAE,QAAwB,GAAG,MAAM;IAerF;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,GAAE,SAAsB,GAAG,MAAM;IAwBrE;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,GAAE,SAAsB,GAAG,IAAI;IAMrD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAE,SAAsB,GAAG,IAAI;IAMnD;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,GAAG;CAGrB"}

package/dist/utils/ValidateUtils.d.ts

@@ -0,0 +1,139 @@
+/**
+ * 密码强度等级。
+ */
+export type PasswordStrength = 'weak' | 'medium' | 'strong';
+/**
+ * 中国身份证校验结果。
+ */
+export interface IdCardValidateResult {
+    /**
+     * 是否合法。
+     */
+    valid: boolean;
+    /**
+     * 出生日期，格式 yyyy-MM-dd。
+     */
+    birthday?: string;
+    /**
+     * 性别。
+     */
+    gender?: 'male' | 'female';
+    /**
+     * 错误原因。
+     */
+    reason?: string;
+}
+/**
+ * 数据验证工具类。
+ */
+export default class ValidateUtils {
+    /**
+     * 判断是否为 null 或 undefined。
+     */
+    static isNil(value: unknown): value is null | undefined;
+    /**
+     * 判断是否为空。
+     *
+     * 空字符串、空数组、空对象、null、undefined 都视为空。
+     */
+    static isEmpty(value: unknown): boolean;
+    /**
+     * 判断是否非空。
+     */
+    static isNotEmpty(value: unknown): boolean;
+    /**
+     * 判断是否为字符串。
+     */
+    static isString(value: unknown): value is string;
+    /**
+     * 判断是否为数字且非 NaN。
+     */
+    static isNumber(value: unknown): value is number;
+    /**
+     * 判断是否为整数。
+     */
+    static isInteger(value: unknown): value is number;
+    /**
+     * 判断是否为布尔值。
+     */
+    static isBoolean(value: unknown): value is boolean;
+    /**
+     * 判断是否为数组。
+     */
+    static isArray(value: unknown): value is unknown[];
+    /**
+     * 判断是否为普通对象。
+     */
+    static isPlainObject(value: unknown): value is Record<string, unknown>;
+    /**
+     * 判断字符串长度是否在指定范围内。
+     */
+    static lengthBetween(value: string, min: number, max: number): boolean;
+    /**
+     * 判断数字是否在指定范围内。
+     */
+    static numberBetween(value: number, min: number, max: number): boolean;
+    /**
+     * 正则校验。
+     */
+    static match(value: string, pattern: RegExp): boolean;
+    /**
+     * 校验邮箱。
+     */
+    static isEmail(value: string): boolean;
+    /**
+     * 校验中国大陆手机号。
+     */
+    static isMobileCN(value: string): boolean;
+    /**
+     * 校验 URL。
+     */
+    static isUrl(value: string): boolean;
+    /**
+     * 校验 IPv4。
+     */
+    static isIPv4(value: string): boolean;
+    /**
+     * 校验 IPv6。
+     */
+    static isIPv6(value: string): boolean;
+    /**
+     * 校验是否为合法 JSON 字符串。
+     */
+    static isJSON(value: string): boolean;
+    /**
+     * 校验中国邮政编码。
+     */
+    static isPostalCodeCN(value: string): boolean;
+    /**
+     * 校验中国车牌号，覆盖普通车牌与新能源车牌。
+     */
+    static isPlateNumberCN(value: string): boolean;
+    /**
+     * 校验银行卡号。
+     *
+     * 使用 Luhn 算法。
+     */
+    static isBankCard(value: string): boolean;
+    /**
+     * 校验中国居民身份证号。
+     */
+    static isIdCardCN(value: string): boolean;
+    /**
+     * 校验中国居民身份证号，并返回生日、性别等信息。
+     */
+    static validateIdCardCN(value: string): IdCardValidateResult;
+    /**
+     * 判断密码强度。
+     *
+     * weak：长度不足或类型单一；
+     * medium：长度 >= 8 且至少两类字符；
+     * strong：长度 >= 10 且至少三类字符。
+     */
+    static passwordStrength(value: string): PasswordStrength;
+    /**
+     * 判断是否为强密码。
+     */
+    static isStrongPassword(value: string): boolean;
+}
+//# sourceMappingURL=ValidateUtils.d.ts.map

package/dist/utils/ValidateUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateUtils.d.ts","sourceRoot":"","sources":["../../src/utils/ValidateUtils.ts"],"names":[],"mappings":"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"}