@ybgnb/utils 0.0.9 → 0.1.1

package/dist/types/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/types/helpers.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,uBAAuB,CAAC,CAAC,IAAI;KACtC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,MAAM,IAAI,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CACxF,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,OAAO,CAAC,MAAM,CAAC,CAAC,GACjB,CAAC,GACD,KAAK;CACV,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,EAAE,IAAI,SAAS,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,GAChG;KACG,CAAC,IAAI,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;CACvE,CAAC,IAAI,CAAC,CAAA;AAET;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,EAAE,GAAG;IACtD,MAAM,EAAE,CAAC,CAAA;CAEV,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,IAAI;KAC9B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK;CAC3C,CAAC,MAAM,CAAC,CAAC,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;AAE3C;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;KACzB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,GAAG,KAAK;CACjD,CAAC,MAAM,CAAC,CAAC,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,KAAK,CAAA;AAE7E;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAE/E;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAC3B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,GAAG,KAAK;CAC/C,CAAC,MAAM,CAAC,CAAC,CAAA"}

package/dist/types/network.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 网络信息
+ */
+export interface NetworkInfo extends EventTarget {
+    downlink: number;
+    rtt: number;
+    effectiveType: 'slow-2g' | '2g' | '3g' | '4g';
+}
+/**
+ * 网络状态
+ * - 'offline': 无网络
+ * - 'online': 在线但不支持 NetworkInformation API
+ * - NetworkInformation: 含详细网络信息
+ */
+export type NetworkState = 'offline' | Omit<NetworkInfo, keyof EventTarget> | 'online';
+//# sourceMappingURL=network.d.ts.map

package/dist/types/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/types/network.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,WAAW;IAE9C,QAAQ,EAAE,MAAM,CAAA;IAEhB,GAAG,EAAE,MAAM,CAAA;IAEX,aAAa,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;CAC9C;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,WAAW,CAAC,GAAG,QAAQ,CAAA"}

package/dist/types/physical.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 物理像素的区域数据
+ */
+export interface PhysicalRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * 物理像素的点位
+ */
+export interface PhysicalPoint {
+    x: number;
+    y: number;
+}
+//# sourceMappingURL=physical.d.ts.map

package/dist/types/physical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"physical.d.ts","sourceRoot":"","sources":["../../src/types/physical.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV"}

package/dist/types/utl.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 已解析的 url
+ */
+export interface ParsedUrl {
+    baseUrl: string;
+    searchParams: URLSearchParams;
+}
+//# sourceMappingURL=utl.d.ts.map

package/dist/types/utl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utl.d.ts","sourceRoot":"","sources":["../../src/types/utl.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,eAAe,CAAA;CAC9B"}

package/dist/utils/array.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 是否为空数组
+ * @param data
+ */
+export declare function isEmptyArr(data: unknown): boolean;
+/**
+ * 将数组分块为指定大小的多个子数组
+ * @param arr 原数组
+ * @param size 每个块的长度
+ * @example chunk([1,2,3,4,5], 2) => [[1,2],[3,4],[5]]
+ */
+export declare function chunk<T>(arr: T[], size: number): T[][];
+//# sourceMappingURL=array.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/utils/array.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,WAEvC;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAOtD"}

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

@@ -0,0 +1,33 @@
+/**
+ * 生成 CSS `color-mix()` 函数的字符串表示，用于动态计算两种颜色的混合结果
+ *
+ * @param {string} color1 - 参与混合的第一种颜色（支持 CSS 合法颜色值，如 HEX、RGB、HSL 等）
+ * @param {string} color2 - 参与混合的第二种颜色
+ * @param {number} percentage - 主颜色（color1）在混合中的占比（百分比数值，范围 0-100）
+ * @param {'srgb' | 'hsl'} [colorSpace='srgb'] - 色彩空间选项：
+ *   - `'srgb'`: 标准 RGB 色彩空间（默认）
+ *   - `'hsl'`: 色相-饱和度-明度色彩空间
+ * @param {number} [percentage2] - 可选参数：副颜色（color2）的独立占比。
+ *   若未提供，则自动计算为 `100 - percentage`
+ * @returns {string} 可直接用于 CSS 的 `color-mix()` 函数字符串（如 `color-mix(in srgb, red 30%, blue 70%)`）
+ *
+ * @example
+ * // 基础用法（自动计算互补占比）
+ * mixColor('red', 'blue', 30)
+ * // 返回: "color-mix(in srgb, red 30%, blue 70%)"
+ *
+ * @example
+ * // 显式指定双占比 + HSL 色彩空间
+ * mixColor('#ff0000', '#0000ff', 40, 'hsl', 60)
+ * // 返回: "color-mix(in hsl, #ff0000 40%, #0000ff 60%)"
+ */
+export declare const mixColor: (color1: string, color2: string, percentage: number, colorSpace?: "srgb" | "hsl", percentage2?: number) => string;
+/**
+ * 将十六进制颜色转换为 RGB
+ */
+export declare const hexToRgb: (hex: string) => {
+    r: number;
+    g: number;
+    b: number;
+};
+//# sourceMappingURL=color.d.ts.map

package/dist/utils/dom/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../../src/utils/dom/color.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,QAAQ,GACnB,QAAQ,MAAM,EACd,QAAQ,MAAM,EACd,YAAY,MAAM,EAClB,aAAY,MAAM,GAAG,KAAc,EACnC,cAAc,MAAM,KACnB,MAEF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,KAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAKvE,CAAA"}

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

@@ -0,0 +1,5 @@
+/**
+ * 设置 html 根元素的 css 变量
+ */
+export declare const setCssVar: (k: string, v: string) => void;
+//# sourceMappingURL=css.d.ts.map

package/dist/utils/dom/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../../src/utils/dom/css.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,SAE7C,CAAA"}

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

@@ -0,0 +1,15 @@
+/**
+ * 等待 <img> 加载完成
+ */
+export declare function whenImageLoaded(img: HTMLImageElement): Promise<HTMLImageElement>;
+/**
+ * 从 <img> 元素获取图片字节数据（ArrayBuffer）
+ * @param img 已加载的 <img> 元素
+ * @param type 图片类型，可选（默认 png）
+ */
+export declare function getImageArrayBuffer(img: HTMLImageElement, type?: string): Promise<ArrayBuffer>;
+/**
+ * 等待加载完成并获取字节数据
+ */
+export declare function getImgArrayBufferAfterLoad(img: HTMLImageElement, type?: string): Promise<ArrayBuffer>;
+//# sourceMappingURL=img.d.ts.map

package/dist/utils/dom/img.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"img.d.ts","sourceRoot":"","sources":["../../../src/utils/dom/img.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6BhF;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,GAAE,MAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CAajH;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAG3G"}

package/dist/utils/{page-utils.d.ts → dom/page.d.ts}

@@ -1,3 +1,4 @@
+/** 可见性改变的监听器 */
 export interface VisibilityChangeListener {
     (hidden: boolean): void;
 }
@@ -7,4 +8,4 @@ export interface VisibilityChangeListener {
  * @returns 成功监听时返回解绑函数
  */
 export declare function onVisibilityChange(listener: VisibilityChangeListener): (() => void) | null;
-//# sourceMappingURL=page-utils.d.ts.map
+//# sourceMappingURL=page.d.ts.map

package/dist/utils/dom/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../src/utils/dom/page.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,MAAM,WAAW,wBAAwB;IACvC,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;CACxB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,wBAAwB,uBAiCpE"}

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

@@ -0,0 +1,14 @@
+/**
+ * 滚动元素到屏幕中心
+ * @param el
+ */
+export declare function humanScrollElIntoCenter(el: HTMLElement): Promise<void>;
+/**
+ * 等待滚动
+ */
+export declare function waitScrollTo(targetX: number, targetY: number): Promise<void>;
+/**
+ * 模拟人类手感滚动到指定位置
+ */
+export declare function humanScrollTo(targetX: number, targetY: number): Promise<void>;
+//# sourceMappingURL=scroll.d.ts.map

package/dist/utils/dom/scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.d.ts","sourceRoot":"","sources":["../../../src/utils/dom/scroll.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,EAAE,EAAE,WAAW,iBAkC5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4D5E;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BnF"}

package/dist/utils/error.d.ts

@@ -0,0 +1,22 @@
+import { CommonError } from '../common/error.js';
+/**
+ * 判断是否为通用异常
+ */
+export declare function isCommonError(error: unknown): error is CommonError;
+/**
+ * 设置异常信息的前置提示
+ * @param error 异常
+ * @param preMsg  前置信息  `${preMsg}${error.message}`
+ */
+export declare function prependErrorMessage(error: CommonError, preMsg?: string): CommonError;
+/**
+ * 转换到通用异常
+ * @param error 异常
+ * @param preMsg  前置提示 `${preMsg}${error.message}`
+ */
+export declare function convertToCommonError(error: unknown, preMsg?: string): CommonError;
+/**
+ * 获取异常信息
+ */
+export declare function getErrorMessage(error: unknown): string;
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAKpF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAgBjF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD"}

package/dist/utils/function.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 随机运行参数
+ * @param fns
+ * @param maxCount 最多执行次数（1 ~ fns.length）
+ */
+export declare function runRandomFunctions(fns: Array<() => void>, maxCount?: number): void;
+/**
+ * 将数字范围按批次处理，每个批次调用一次异步函数
+ *
+ * @param start - 起始值（包含）
+ * @param end   - 结束值（包含）
+ * @param batchSize - 每批最大元素个数
+ * @param processor - 处理单批数字数组的异步函数
+ *
+ * @example
+ * // 分批处理 1..10，每批最多 3 个数字
+ * await processRangeInBatches(1, 10, 3, async (batch) => {
+ *   console.log(batch) // 输出: [1,2,3], [4,5,6], [7,8,9], [10]
+ * })
+ */
+export declare function processRangeInBatches(start: number, end: number, batchSize: number, processor: (batch: number[]) => Promise<void>): Promise<void>;
+//# sourceMappingURL=function.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../src/utils/function.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAelF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAC5C,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/utils/github.d.ts

@@ -0,0 +1,7 @@
+import { GithubRepository } from '../types/github.js';
+/**
+ * 从 url 解析 github 仓库信息
+ * @param repositoryUrl 仓库 URL（支持带有git+前缀、具体文件路径）
+ */
+export declare function parseGithubRepo(repositoryUrl: string): GithubRepository;
+//# sourceMappingURL=github.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/utils/github.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,gBAAgB,CA4BvE"}

package/dist/utils/id.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 生成唯一 id
+ */
+export declare function generateId(): string;
+//# sourceMappingURL=id.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/utils/network.d.ts

@@ -0,0 +1,12 @@
+import { NetworkState } from '../types/network.js';
+/**
+ * 获取网络信息
+ */
+export declare function getNetworkInfo(): NetworkState;
+/**
+ * 监听网络状态变化
+ * @param listener 监听器
+ * @returns 成功监听时返回解绑函数
+ */
+export declare function onNetworkChange(listener: (info: NetworkState) => void): () => void;
+//# sourceMappingURL=network.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/utils/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAMpE;;GAEG;AACH,wBAAgB,cAAc,IAAI,YAAY,CAgB7C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,cAkBrE"}

package/dist/utils/{random-utils.d.ts → random.d.ts}

@@ -26,4 +26,4 @@ export declare function sampleOne<T>(arr: T[]): T;
  * 获取 1~n 的随机数
  */
 export declare function random1ToN(n: number): number;
-//# sourceMappingURL=random-utils.d.ts.map
+//# sourceMappingURL=random.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/utils/random.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAOxC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAEtD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAOrE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,CAExC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/dist/utils/sleep.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 支持取消的 sleep
+ * @param ms      延迟毫秒数
+ * @param signal  取消信号
+ */
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+/**
+ * 支持取消的随机 sleep
+ * @param minMS   最小延迟毫秒数
+ * @param maxMS   最大延迟毫秒数
+ * @param signal  取消信号
+ */
+export declare function sleepRandom(minMS: number, maxMS: number, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,iBAqBrD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,iBAG7E"}

package/dist/utils/time.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 格式化时间为 2020-02-02 20:20:20 的字符串
+ * @param date 需要格式化的时间，为空则获取当前时间
+ */
+export declare function getFormattedDateTime(date?: Date): string;
+/**
+ * 格式化时间为 20:20:20 的字符串
+ * @param date 需要格式化的时间，为空则获取当前时间
+ */
+export declare function getFormattedTime(date?: Date): string;
+//# sourceMappingURL=time.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,CAEpD"}

package/dist/utils/url.d.ts

@@ -0,0 +1,30 @@
+import { ParsedUrl } from '../types/utl.js';
+/** URL query 中必须编码的保留字符 (RFC 3986) */
+export declare const invalidCharRegex: RegExp;
+/** 查询参数 */
+export type QueryParams = Record<string, string | number | boolean | null | undefined>;
+/**
+ * 判断字符串是否为有效的 HTTP/HTTPS URL
+ * @param path - 待检测的字符串
+ */
+export declare function isHttpUrl(path: string): boolean;
+/**
+ * 解析 url
+ * @param url
+ */
+export declare function parseUrl(url: string): ParsedUrl;
+/**
+ * 编码 URL 参数
+ * @param params 查询参数
+ */
+export declare function encodeURLParams(params: QueryParams): string;
+/**
+ *
+ */
+/**
+ * 合并查询参数
+ * @param urlSearchParams url解析后查询参数
+ * @param params          单独传的查询参数
+ */
+export declare function mergeQueryParams(urlSearchParams: URLSearchParams, params?: QueryParams): QueryParams;
+//# sourceMappingURL=url.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,QAAa,CAAA;AAE1C,WAAW;AACX,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAEtF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,WAOrC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAU/C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,UAgBlD;AAED;;GAEG;AACH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,CAapG"}

package/package.json

@@ -1,23 +1,31 @@
 {
   "name": "@ybgnb/utils",
-  "version": "0.0.9",
+  "version": "0.1.1",
   "author": "hzhilong",
   "private": false,
   "description": "自用工具库",
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/index.umd.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.umd.cjs"
+    }
+  },
   "files": [
     "dist"
   ],
   "scripts": {
-    "类型检查": "tsc --noEmit",
-    "代码检查": "eslint .",
-    "build": "tsc",
-    "npm 登录": " npm login",
-    "npm 发布": " npm publish --access public",
-    "本地发布": "yalc publish",
-    "本地构建并发布": "barrelsby -c barrelsby.json --delete --noHeader && vite build --mode library && yalc publish"
+    "check": "tsc --noEmit  && eslint .",
+    "lint": "eslint . --fix",
+    "format": "prettier --write .",
+    "barrelsby": "rimraf \"./src/index.ts\" && barrelsby -c barrelsby.json --noHeader --location top && tsx ./scripts/revise-index.ts",
+    "build": "vite build --mode library",
+    "npm login": "npm login",
+    "npm publish": "npm publish --access public"
   },
   "repository": {
     "type": "git",
@@ -33,15 +41,18 @@
   },
   "homepage": "https://github.com/hzhilong/ybgnb-js#readme",
   "devDependencies": {
+    "barrelsby": "^2.8.1",
     "eslint": "^9.39.4",
     "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.8.1",
+    "rimraf": "^6.1.3",
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.58.0",
-    "prettier": "^3.8.1",
-    "tsx": "^4.21.0"
+    "vite": "^8.0.8",
+    "vite-plugin-dts": "^4.5.4"
   },
   "peerDependencies": {
     "dayjs": "^1.11.13",
-    "nanoid": "^5.1.5"
+    "nanoid": "^5.1.9"
   }
 }

package/dist/types/error.d.ts

@@ -1,15 +0,0 @@
-/**
- * 通用异常
- */
-export declare class CommonError {
-    message: string;
-    error?: unknown;
-    constructor(message: string, error?: unknown);
-}
-/**
- * 中止异常
- */
-export declare class AbortedError extends CommonError {
-    constructor();
-}
-//# sourceMappingURL=error.d.ts.map

package/dist/types/error.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/types/error.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEJ,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;;CAI5C"}

package/dist/types/error.js

@@ -1,19 +0,0 @@
-import { BaseUtils } from "../utils/base-utils.js";
-/**
- * 通用异常
- */
-export class CommonError {
-    constructor(message, error) {
-        this.message = error ? `${message} ${BaseUtils.getErrorMessage(error)}` : message;
-        this.error = error;
-    }
-}
-/**
- * 中止异常
- */
-export class AbortedError extends CommonError {
-    constructor() {
-        super("操作已取消");
-    }
-}
-//# sourceMappingURL=error.js.map

package/dist/types/error.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/types/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,wBAAwB,CAAC;AAEjD;;GAEG;AACH,MAAM,OAAO,WAAW;IAItB,YAAY,OAAe,EAAE,KAAe;QAC1C,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAClF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C;QACE,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF"}

package/dist/types/extended-type.d.ts

@@ -1,7 +0,0 @@
-/**
- * 提取getter属性
- */
-export type ExtractGetterProperties<T> = {
-    [K in keyof T as K extends `get${infer Rest}` ? Uncapitalize<Rest> : never]: T[K] extends (...args: any[]) => Promise<infer R> ? R : never;
-};
-//# sourceMappingURL=extended-type.d.ts.map

package/dist/types/extended-type.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extended-type.d.ts","sourceRoot":"","sources":["../../src/types/extended-type.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,uBAAuB,CAAC,CAAC,IAAI;KACtC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,MAAM,IAAI,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAExF,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,OAAO,CAAC,MAAM,CAAC,CAAC,GACjB,CAAC,GACD,KAAK;CACV,CAAA"}

package/dist/types/extended-type.js

@@ -1,3 +0,0 @@
-// 扩展的类型
-export {};
-//# sourceMappingURL=extended-type.js.map

package/dist/types/extended-type.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"extended-type.js","sourceRoot":"","sources":["../../src/types/extended-type.ts"],"names":[],"mappings":"AAAA,QAAQ"}

package/dist/utils/base-utils.d.ts

@@ -1,44 +0,0 @@
-import { CommonError } from '../types/error.js';
-/**
- * 基础工具集
- */
-export declare class BaseUtils {
-    /**
-     * 判断是否为通用异常
-     * @param error 需要判断的异常
-     */
-    static isCommonError(error: unknown): error is CommonError;
-    /**
-     * 获取错误信息
-     * @param error
-     */
-    static getErrorMessage(error: unknown): string;
-    /**
-     * 设置异常信息的前置提示
-     * @param error 异常
-     * @param preMsg  前置信息  `${preMsg}${error.message}`
-     */
-    static prependErrorMessage(error: CommonError, preMsg?: string): CommonError;
-    /**
-     * 转换到通用异常
-     * @param error 异常
-     * @param preMsg  前置提示 `${preMsg}${error.message}`
-     */
-    static convertToCommonError(error: unknown, preMsg?: string): CommonError;
-    /**
-     * 格式化时间为 2020-02-02 20:20:20 的字符串
-     * @param date 需要格式化的时间，为空则获取当前时间
-     */
-    static getFormattedDateTime(date?: Date): string;
-    /**
-     * 格式化时间为 2020-02-02 的字符串
-     * @param date 需要格式化的时间，为空则获取当前时间
-     */
-    static getFormattedDate(date?: Date): string;
-    /**
-     * 格式化时间为 20:20:20 的字符串
-     * @param date 需要格式化的时间，为空则获取当前时间
-     */
-    static getFormattedTime(date?: Date): string;
-}
-//# sourceMappingURL=base-utils.d.ts.map

package/dist/utils/base-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"base-utils.d.ts","sourceRoot":"","sources":["../../src/utils/base-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,qBAAa,SAAS;IACpB;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW;IAI1D;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAI9C;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW;IAO5E;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW;IAkBzE;;;OAGG;IACH,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM;IAIhD;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM;IAI5C;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM;CAG7C"}

package/dist/utils/base-utils.js

@@ -1,75 +0,0 @@
-import dayjs from 'dayjs';
-import { CommonError } from '../types/error.js';
-/**
- * 基础工具集
- */
-export class BaseUtils {
-    /**
-     * 判断是否为通用异常
-     * @param error 需要判断的异常
-     */
-    static isCommonError(error) {
-        return error instanceof CommonError;
-    }
-    /**
-     * 获取错误信息
-     * @param error
-     */
-    static getErrorMessage(error) {
-        return this.convertToCommonError(error).message;
-    }
-    /**
-     * 设置异常信息的前置提示
-     * @param error 异常
-     * @param preMsg  前置信息  `${preMsg}${error.message}`
-     */
-    static prependErrorMessage(error, preMsg) {
-        if (preMsg) {
-            error.message = `${preMsg} ${error.message}`;
-        }
-        return error;
-    }
-    /**
-     * 转换到通用异常
-     * @param error 异常
-     * @param preMsg  前置提示 `${preMsg}${error.message}`
-     */
-    static convertToCommonError(error, preMsg) {
-        if (this.isCommonError(error)) {
-            return this.prependErrorMessage(error, preMsg);
-        }
-        if (typeof error === 'object' &&
-            error !== null &&
-            'message' in error &&
-            typeof error.message === 'string') {
-            const newError = error;
-            return this.prependErrorMessage(new CommonError(newError.message), preMsg);
-        }
-        else {
-            // 如果抛出的异常不是object
-            return this.prependErrorMessage(new CommonError(String(error)), preMsg);
-        }
-    }
-    /**
-     * 格式化时间为 2020-02-02 20:20:20 的字符串
-     * @param date 需要格式化的时间，为空则获取当前时间
-     */
-    static getFormattedDateTime(date) {
-        return dayjs(date).format('YYYY-MM-DD HH:mm:ss');
-    }
-    /**
-     * 格式化时间为 2020-02-02 的字符串
-     * @param date 需要格式化的时间，为空则获取当前时间
-     */
-    static getFormattedDate(date) {
-        return dayjs(date).format('YYYY-MM-DD');
-    }
-    /**
-     * 格式化时间为 20:20:20 的字符串
-     * @param date 需要格式化的时间，为空则获取当前时间
-     */
-    static getFormattedTime(date) {
-        return dayjs(date).format('HH:mm:ss');
-    }
-}
-//# sourceMappingURL=base-utils.js.map

package/dist/utils/base-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"base-utils.js","sourceRoot":"","sources":["../../src/utils/base-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,MAAM,OAAO,SAAS;IACpB;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,KAAc;QACjC,OAAO,KAAK,YAAY,WAAW,CAAA;IACrC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,KAAc;QACnC,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,OAAO,CAAA;IACjD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CAAC,KAAkB,EAAE,MAAe;QAC5D,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,OAAO,GAAG,GAAG,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAA;QAC9C,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,CAAC,KAAc,EAAE,MAAe;QACzD,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAChD,CAAC;QACD,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,SAAS,IAAI,KAAK;YAClB,OAAQ,KAAiC,CAAC,OAAO,KAAK,QAAQ,EAC9D,CAAC;YACD,MAAM,QAAQ,GAAG,KAA4B,CAAA;YAC7C,OAAO,IAAI,CAAC,mBAAmB,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAA;QAC5E,CAAC;aAAM,CAAC;YACN,kBAAkB;YAClB,OAAO,IAAI,CAAC,mBAAmB,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;QACzE,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,oBAAoB,CAAC,IAAW;QACrC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAA;IAClD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAW;QACjC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;IACzC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAW;QACjC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACvC,CAAC;CACF"}

package/dist/utils/biz-result.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"biz-result.d.ts","sourceRoot":"","sources":["../../src/utils/biz-result.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,SAAS,CAAC,CAAC;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,CAAC,CAAA;gBAEI,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;IAMnD,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IAI/B,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,GAAE,MAAe,EAAE,IAAI,CAAC,EAAE,CAAC;IAInD,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO;IAIhC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAC1B,SAAS,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;CAQjC;AAED;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAU,CAAC,EAAE,KAAK,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAM5E,CAAA"}