@ybgnb/utils 0.1.8 → 0.2.0

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

@@ -1,28 +0,0 @@
-/**
- * 数组洗牌
- */
-export declare function shuffle<T>(arr: T[]): T[];
-/**
- * 获取 [min, max] 的随机整数
- */
-export declare function randomInt(min: number, max: number): number;
-/**
- * 获取 [min, max) 的随机浮点数
- */
-export declare function randomFloat(min: number, max: number): number;
-/**
- * 从数组中随机取若干项，不可重复
- */
-export declare function sample<T>(arr: T[], count: number): T[];
-/**
- * 从数组中随机取若干项，可重复
- */
-export declare function sampleWithReplacement<T>(arr: T[], count: number): T[];
-/**
- * 从数组中获取随机项
- */
-export declare function sampleOne<T>(arr: T[]): T;
-/**
- * 获取 1~n 的随机数
- */
-export declare function random1ToN(n: number): number;

package/dist/core/utils/serialize.d.ts

@@ -1,23 +0,0 @@
-/**
- * 递归移除对象（或数组）中的所有函数属性，返回一个可安全序列化的副本。
- *
- * @typeParam T - 输入值的类型。
- * @param value - 待处理的值（基本类型、对象、数组等）。
- * @param seen - 内部使用的 WeakMap，用于记录已访问过的对象，防止循环引用。
- *               调用方通常无需传递此参数。
- * @returns 处理后的新副本，其中所有函数属性都被移除。
- *          基本类型（string, number, boolean, null, undefined）将原样返回。
- */
-export declare function stripFunctions<T>(value: T, seen?: WeakMap<object, any>): T;
-/**
- * 将错误转换为可 JSON 序列化的普通对象。
- */
-export declare function serializeError(err: unknown): {
-    name: string;
-    message: string;
-    stack: string | undefined;
-} | {
-    name: string;
-    message: string;
-    stack?: undefined;
-};

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

@@ -1,13 +0,0 @@
-/**
- * 支持取消的 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>;

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

@@ -1,19 +0,0 @@
-/**
- * 格式化日期
- */
-export declare function formatDate(date: Date, pattern: 'date' | 'time' | 'datetime'): string;
-/**
- * 格式化时间为 2020-02-02 20:20:20 的字符串
- * @param date 需要格式化的时间，为空则获取当前时间
- */
-export declare function getFormattedDateTime(date?: Date): string;
-/**
- * 格式化时间为 2020-02-02 20:20:20 的字符串
- * @param date 需要格式化的时间，为空则获取当前时间
- */
-export declare function getFormattedDate(date?: Date): string;
-/**
- * 格式化时间为 20:20:20 的字符串
- * @param date 需要格式化的时间，为空则获取当前时间
- */
-export declare function getFormattedTime(date?: Date): string;

package/dist/core/utils/type.d.ts

@@ -1,9 +0,0 @@
-import { ObjectWithKeys } from '../types/helpers.js';
-/**
- * 判断一个值是否为纯对象
- */
-export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
-/**
- * 包括类实例、普通对象，不包括 数组、null 和原始类型
- */
-export declare function isObject<K extends string | symbol>(value: unknown, key?: K): value is ObjectWithKeys<K>;

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

@@ -1,36 +0,0 @@
-/** URL query 中必须编码的保留字符 (RFC 3986) */
-export declare const invalidCharRegex: RegExp;
-/** 查询参数 */
-export type QueryParams = Record<string, string | number | boolean | null | undefined>;
-/**
- * 已解析的 url
- */
-export interface ParsedUrl {
-    baseUrl: string;
-    searchParams: URLSearchParams;
-}
-/**
- * 判断字符串是否为有效的 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          查询参数
- * @param keepEmptyValues 保留 null/undefined的值（空字符串）
- */
-export declare function encodeURLParams(params: QueryParams, keepEmptyValues?: boolean): string;
-/**
- *
- */
-/**
- * 合并查询参数
- * @param urlSearchParams url解析后查询参数
- * @param params          单独传的查询参数
- */
-export declare function mergeQueryParams(urlSearchParams: URLSearchParams, params?: QueryParams): QueryParams;

package/dist/core.umd.cjs

@@ -1,2 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class extends Error{constructor(e,t){super(e),t!==void 0&&(this.rawError=t instanceof Error?t:Error(String(t))),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}toString(){return`${this.name}: ${this.message}${this.rawError?` (caused by ${this.rawError})`:``}`}};function t(e){return e instanceof Error?e.name===`AbortError`||e.name===`CanceledError`||`code`in e&&e.code===`ERR_CANCELED`:!1}function n(e){let t=Error(e??`操作已取消`);return t.name=`AbortError`,t}function r(t){return t instanceof e||t instanceof Error&&t.name===`CommonError`}function i(e,t){return t&&(e.message=`${t} ${e.message}`),e}function a(t,n){return r(t)?i(t,n):new e(`${n} ${o(t)}`,t)}function o(e){return typeof e==`string`?e:e instanceof Error||e&&typeof e==`object`&&`message`in e&&typeof e.message==`string`?e.message:String(e)??`未知错误`}var s=class t{constructor(e,t,n){this.success=e,this.msg=t,this.data=n}static createSuccess(e){return new t(!0,`操作成功`,e)}static createFail(e=`操作失败`,n){return new t(!1,e,n)}static createError(e){return new t(!1,o(e))}async toPromise(){if(this.success)return this.data;throw new e(this.msg)}},c=async e=>{try{return s.createSuccess(await e())}catch(e){return s.createError(e)}};function l(e){return Array.isArray(e)&&e.length===0}function u(e,t){if(!Number.isInteger(t)||t<1)throw Error(`size 必须是正整数`);let n=[];for(let r=0;r<e.length;r+=t)n.push(e.slice(r,r+t));return n}function d(e){return Error(`HTTP ${e.status}: ${e.statusText}`)}async function f(e,t,n){let r=await fetch(e,n);if(!r.ok)throw d(r);switch(t){case`json`:return await r.json();case`text`:return await r.text();case`blob`:return await r.blob();case`arrayBuffer`:return await r.arrayBuffer();case`formData`:return await r.formData();default:return await r.text()}}function p(e,t){t??=e.length;let n=Math.floor(Math.random()*t)+1,r=[...e];for(let e=r.length-1;e>0;e--){let t=Math.floor(Math.random()*(e+1));[r[e],r[t]]=[r[t],r[e]]}let i=r.slice(0,n);for(let e of i)e()}async function m(e,t,n,r){for(let i=e;i<=t;i+=n){let e=t-i+1,a=Math.min(n,e);await r(Array.from({length:a},(e,t)=>i+t))}}function h(e,t,...n){let r=t.split(`.`),i=e,a=0;for(;a<r.length-1;a++)if(i=i[r[a]],i==null)throw Error(`Path '${r.slice(0,a+1).join(`.`)}' is null/undefined`);let o=i[r[a]];if(typeof o!=`function`)throw Error(`'${t}' is not a function`);return o.apply(i,n)}function g(e){e=e.replace(/^git\+/,``);let t=/^https:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git|\/)?$/,n=/^https:\/\/github\.com\/([^/]+)\/([^/]+)\/blob\/([^/]+)$/,r=e.match(t);if(r)return{owner:r[1],repo:r[2],branch:`main`};let i=e.match(n);if(i)return{owner:i[1],repo:i[2],branch:i[3]};throw Error(`解析插件仓库URL失败`)}function _(e){let{owner:t,repo:n,branch:r,filePath:i}=e;return`https://raw.githubusercontent.com/${t}/${n}/${r}/${i}`}async function v(e){return JSON.parse(await f(_(e),`json`))}function y(e){let t=e.slice();for(let e=t.length-1;e>0;e--){let n=Math.floor(Math.random()*(e+1));[t[e],t[n]]=[t[n],t[e]]}return t}function b(e,t){return Math.floor(Math.random()*(t-e+1))+e}function x(e,t){return Math.random()*(t-e)+e}function S(e,t){return y(e).slice(0,t)}function C(e,t){let n=[];for(let r=0;r<t;r++){let t=b(0,e.length-1);n.push(e[t])}return n}function w(e){return e[b(0,e.length-1)]}function T(e){return b(1,e)}function E(e){if(typeof e!=`object`||!e)return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function D(e,t){return typeof e!=`object`||!e||Array.isArray(e)?!1:t===void 0?!0:t in e}function O(e,t=new WeakMap){if(typeof e==`function`)return;if(typeof e!=`object`||!e||e instanceof Date||e instanceof RegExp||e instanceof Map||e instanceof Set||ArrayBuffer.isView(e)||e instanceof ArrayBuffer)return e;if(t.has(e))return t.get(e);if(Array.isArray(e)){let n=[];t.set(e,n);for(let r of e)n.push(O(r,t));return n}if(!E(e))return e;let n={};t.set(e,n);for(let[r,i]of Object.entries(e)){if(typeof i==`function`)continue;let e=O(i,t);e!==void 0&&(n[r]=e)}return n}function k(e){return e instanceof Error?{name:e.name,message:e.message,stack:e.stack}:{name:`Error`,message:String(e)}}function A(e,t){return new Promise((n,r)=>{if(t?.aborted)return r(Error(`取消操作`));let i=setTimeout(()=>{o(),n()},e),a=()=>{clearTimeout(i),o(),r(Error(`取消操作`))},o=()=>{t?.removeEventListener(`abort`,a)};t?.addEventListener(`abort`,a)})}function j(e,t,n){return A(Math.random()*(t-e)+e,n)}function M(e,t){let n=isNaN(e.getTime())?new Date:e,r=n.getFullYear(),i=String(n.getMonth()+1).padStart(2,`0`),a=String(n.getDate()).padStart(2,`0`),o=String(n.getHours()).padStart(2,`0`),s=String(n.getMinutes()).padStart(2,`0`),c=String(n.getSeconds()).padStart(2,`0`);return t===`date`?`${r}-${i}-${a}`:t===`time`?`${o}:${s}:${c}`:`${r}-${i}-${a} ${o}:${s}:${c}`}function N(e){return M(e??new Date,`datetime`)}function P(e){return M(e??new Date,`date`)}function F(e){return M(e??new Date,`time`)}var I=/[!'()*]/g;function L(e){try{let t=new URL(e);return t.protocol===`http:`||t.protocol===`https:`}catch{return!1}}function R(e){try{let{origin:t,pathname:n,searchParams:r}=new URL(e);return{baseUrl:t+n,searchParams:r}}catch{throw Error(`Invalid URL`)}}function z(e,t=!1){return Object.keys(e).sort().filter(n=>t||e[n]!=null).map(t=>{let n=e[t]??``;return`${encodeURIComponent(t)}=${encodeURIComponent(String(n))}`}).join(`&`)}function B(e,t){let n={};return e.size>0&&e.forEach((e,t)=>{n[t]=e}),t&&(n={...n,...t}),n}function V(e,t,n,r=``){if(!Number.isFinite(e))return{size:0,unit:``,text:r};let i=e,a=0;for(;i>=t&&a<n.length-1;)i/=t,a++;return{size:i,unit:n[a],text:`${i.toFixed(2).replace(/\.?0+$/,``)} ${n[a]}`}}exports.BizResult=s,exports.CommonError=e,exports.chunk=u,exports.convertToCommonError=a,exports.createAbortError=n,exports.createResponseError=d,exports.dynamicCall=h,exports.encodeURLParams=z,exports.execBiz=c,exports.fetchWithFormat=f,exports.formatDate=M,exports.formatUnitSize=V,exports.getErrorMessage=o,exports.getFormattedDate=P,exports.getFormattedDateTime=N,exports.getFormattedTime=F,exports.getGithubRawJson=v,exports.invalidCharRegex=I,exports.isCanceledError=t,exports.isCommonError=r,exports.isEmptyArr=l,exports.isHttpUrl=L,exports.isObject=D,exports.isPlainObject=E,exports.mergeQueryParams=B,exports.parseGithubRawUrl=_,exports.parseGithubRepoUrl=g,exports.parseUrl=R,exports.processRangeInBatches=m,exports.random1ToN=T,exports.randomFloat=x,exports.randomInt=b,exports.runRandomFunctions=p,exports.sample=S,exports.sampleOne=w,exports.sampleWithReplacement=C,exports.serializeError=k,exports.shuffle=y,exports.sleep=A,exports.sleepRandom=j,exports.stripFunctions=O;
-//# sourceMappingURL=core.umd.cjs.map

package/dist/core.umd.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.umd.cjs","names":[],"sources":["../src/core/error/common-error.ts","../src/core/utils/error.ts","../src/core/result/biz-result.ts","../src/core/result/exec-biz.ts","../src/core/utils/array.ts","../src/core/utils/fetch.ts","../src/core/utils/function.ts","../src/core/utils/github.ts","../src/core/utils/random.ts","../src/core/utils/type.ts","../src/core/utils/serialize.ts","../src/core/utils/sleep.ts","../src/core/utils/time.ts","../src/core/utils/url.ts","../src/core/utils/number/format.ts"],"sourcesContent":["/**\n * 通用错误\n */\nexport class CommonError extends Error {\n  // 原始错误\n  rawError?: Error\n\n  constructor(message: string, rawError?: unknown) {\n    super(message)\n\n    if (rawError !== undefined) {\n      this.rawError = rawError instanceof Error ? rawError : new Error(String(rawError))\n    }\n\n    this.name = new.target.name\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n\n  toString() {\n    return `${this.name}: ${this.message}${this.rawError ? ` (caused by ${this.rawError})` : ''}`\n  }\n}\n","import { CommonError } from '../error/common-error.js'\n\n/**\n * 是否为取消操作的错误\n */\nexport function isCanceledError(err: unknown): boolean {\n  if (!(err instanceof Error)) return false\n\n  return err.name === 'AbortError' || err.name === 'CanceledError' || ('code' in err && err.code === 'ERR_CANCELED')\n}\n\n/**\n * 创建取消错误\n * @param msg\n */\nexport function createAbortError(msg?: string): Error {\n  const error = new Error(msg ?? '操作已取消')\n  error.name = 'AbortError'\n  return error\n}\n\n/**\n * 是否为通用错误对象\n */\nexport function isCommonError(error: unknown): error is CommonError {\n  return error instanceof CommonError || (error instanceof Error && error.name === 'CommonError')\n}\n\n/**\n * 给错误消息添加前缀（空格隔开）\n */\nfunction prefixError(error: Error, prefix?: string): Error {\n  if (!prefix) return error\n\n  error.message = `${prefix} ${error.message}`\n  return error\n}\n\n/**\n * 转换到通用异常\n */\nexport function convertToCommonError(error: unknown, prefix?: string) {\n  if (isCommonError(error)) {\n    return prefixError(error, prefix)\n  }\n  return new CommonError(`${prefix} ${getErrorMessage(error)}`, error)\n}\n\n/**\n * 获取异常信息\n */\nexport function getErrorMessage(error: unknown): string {\n  if (typeof error === 'string') {\n    return error\n  }\n  if (error instanceof Error) {\n    return error.message\n  }\n  if (error && typeof error === 'object' && 'message' in error && typeof error.message === 'string') {\n    return error.message\n  }\n  return String(error) ?? '未知错误'\n}\n","import { getErrorMessage } from '../utils/error.js'\nimport { CommonError } from '../error/common-error.js'\n\n/**\n * 业务执行结果\n */\nexport class BizResult<T> {\n  success: boolean\n  msg: string\n  data?: T\n\n  constructor(success: boolean, msg: string, data?: T) {\n    this.success = success\n    this.msg = msg\n    this.data = data\n  }\n\n  static createSuccess<T>(data: T) {\n    return new BizResult(true, '操作成功', data)\n  }\n\n  static createFail<T>(msg: string = '操作失败', data?: T) {\n    return new BizResult(false, msg, data)\n  }\n\n  static createError<T>(e: unknown) {\n    return new BizResult<T>(false, getErrorMessage(e))\n  }\n\n  /**\n   * 展开成Promise\n   */\n  async toPromise(): Promise<void>\n  async toPromise<T>(): Promise<T>\n  async toPromise<T = void>(): Promise<T> {\n    if (this.success) {\n      return this.data as T\n    } else {\n      throw new CommonError(this.msg)\n    }\n  }\n}\n","import { BizResult } from './biz-result.js'\n\n/**\n * 执行业务（自动包裹BuResult）\n * @param run 执行方法\n */\nexport const execBiz = async <T>(run: () => Promise<T>): Promise<BizResult<T>> => {\n  try {\n    return BizResult.createSuccess<T>(await run())\n  } catch (e) {\n    return BizResult.createError(e)\n  }\n}\n","/**\n * 是否为空数组\n * @param data\n */\nexport function isEmptyArr(data: unknown) {\n  return Array.isArray(data) && data.length === 0\n}\n\n/**\n * 将数组分块为指定大小的多个子数组\n * @param arr 原数组\n * @param size 每个块的长度\n * @example chunk([1,2,3,4,5], 2) => [[1,2],[3,4],[5]]\n */\nexport function chunk<T>(arr: T[], size: number): T[][] {\n  if (!Number.isInteger(size) || size < 1) throw new Error('size 必须是正整数')\n  const result: T[][] = []\n  for (let i = 0; i < arr.length; i += size) {\n    result.push(arr.slice(i, i + size))\n  }\n  return result\n}\n","/**\n * 用于指定 `fetch` 响应体的解析方式。\n * 对应 `Response` 对象的不同解析方法（`.json()`、`.text()` 等）。\n */\nexport type ResponseBodyFormat =\n  | 'json' // 解析为 JSON 对象\n  | 'text' // 解析为原始字符串\n  | 'blob' // 解析为 Blob 对象（适用于二进制文件，如图片、压缩包）\n  | 'arrayBuffer' // 解析为 ArrayBuffer（适用于底层二进制操作）\n  | 'formData' // 解析为 FormData 对象（适用于处理 multipart/form-data 响应）\n\n/**\n * 创建响应错误\n */\nexport function createResponseError(response: Response) {\n  return new Error(`HTTP ${response.status}: ${response.statusText}`)\n}\n\n/**\n * 使用指定的响应解析格式发起 fetch 请求\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport async function fetchWithFormat<T = any>(\n  url: string,\n  format: ResponseBodyFormat,\n  init?: RequestInit,\n): Promise<T> {\n  const response = await fetch(url, init)\n  if (!response.ok) {\n    throw createResponseError(response)\n  }\n  switch (format) {\n    case 'json':\n      return (await response.json()) as T\n    case 'text':\n      return (await response.text()) as T\n    case 'blob':\n      return (await response.blob()) as T\n    case 'arrayBuffer':\n      return (await response.arrayBuffer()) as T\n    case 'formData':\n      return (await response.formData()) as T\n    default:\n      return (await response.text()) as T\n  }\n}\n","/**\n * 随机运行参数\n * @param fns\n * @param maxCount 最多执行次数（1 ~ fns.length）\n */\nexport function runRandomFunctions(fns: Array<() => void>, maxCount?: number): void {\n  maxCount = maxCount ?? fns.length\n  const count = Math.floor(Math.random() * maxCount) + 1\n\n  const shuffled = [...fns]\n  for (let i = shuffled.length - 1; i > 0; i--) {\n    const j = Math.floor(Math.random() * (i + 1))\n    ;[shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]]\n  }\n\n  const selected = shuffled.slice(0, count)\n\n  for (const fn of selected) {\n    fn()\n  }\n}\n\n/**\n * 将数字范围按批次处理，每个批次调用一次异步函数\n *\n * @param start - 起始值（包含）\n * @param end   - 结束值（包含）\n * @param batchSize - 每批最大元素个数\n * @param processor - 处理单批数字数组的异步函数\n *\n * @example\n * // 分批处理 1..10，每批最多 3 个数字\n * await processRangeInBatches(1, 10, 3, async (batch) => {\n *   console.log(batch) // 输出: [1,2,3], [4,5,6], [7,8,9], [10]\n * })\n */\nexport async function processRangeInBatches(\n  start: number,\n  end: number,\n  batchSize: number,\n  processor: (batch: number[]) => Promise<void>,\n): Promise<void> {\n  for (let current = start; current <= end; current += batchSize) {\n    const remaining = end - current + 1\n    const actualSize = Math.min(batchSize, remaining)\n    const batch = Array.from({ length: actualSize }, (_, idx) => current + idx)\n\n    await processor(batch)\n  }\n}\n\n/**\n * 动态调用\n * @param root  对象\n * @param path  调用路径\n * @param args  参数\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\nexport function dynamicCall<T = any>(root: any, path: string, ...args: any[]): T {\n  const segments = path.split('.')\n  let context = root\n  let i = 0\n  for (; i < segments.length - 1; i++) {\n    context = context[segments[i]]\n    if (context == null) {\n      throw new Error(`Path '${segments.slice(0, i + 1).join('.')}' is null/undefined`)\n    }\n  }\n  const fn = context[segments[i]]\n  if (typeof fn !== 'function') {\n    throw new Error(`'${path}' is not a function`)\n  }\n  return fn.apply(context, args)\n}\n","import { fetchWithFormat } from './fetch.js'\n\n/** github 仓库信息 */\nexport interface GitHubRepo {\n  /** 仓库所有者（用户或组织名） */\n  owner: string\n  /** 仓库名称 */\n  repo: string\n}\n\n/** github 仓库分支信息 */\nexport type GitHubRepoBranch = GitHubRepo & {\n  /** 分支名称 */\n  branch: string\n}\n\n/** github 仓库文件信息 */\nexport type GitHubRepoFile = GitHubRepoBranch & {\n  /** 文件路径 */\n  filePath: string\n}\n\n/**\n * 从 url 解析 github 仓库信息\n * @param repositoryUrl 仓库 URL（支持带有git+前缀、具体文件路径）\n */\nexport function parseGithubRepoUrl(repositoryUrl: string): GitHubRepoBranch {\n  // 去掉 git+ 前缀\n  repositoryUrl = repositoryUrl.replace(/^git\\+/, '')\n\n  const regexBase = /^https:\\/\\/github\\.com\\/([^/]+)\\/([^/]+?)(?:\\.git|\\/)?$/\n  const regexFile = /^https:\\/\\/github\\.com\\/([^/]+)\\/([^/]+)\\/blob\\/([^/]+)$/\n\n  // 情况 1：git clone 地址 或 repo 根路径\n  const m1 = repositoryUrl.match(regexBase)\n  if (m1) {\n    return {\n      owner: m1[1],\n      repo: m1[2],\n      branch: 'main', // 默认分支 main\n    }\n  }\n\n  // 情况 2：具体文件路径\n  const m2 = repositoryUrl.match(regexFile)\n  if (m2) {\n    return {\n      owner: m2[1],\n      repo: m2[2],\n      branch: m2[3],\n    }\n  }\n\n  throw new Error('解析插件仓库URL失败')\n}\n\n/**\n * 解析 github 仓库文件的原始内容的 url\n */\nexport function parseGithubRawUrl(gitHubRepoFile: GitHubRepoFile) {\n  const { owner, repo, branch, filePath } = gitHubRepoFile\n  return `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${filePath}`\n}\n\n/**\n * 获取 github 仓库文件的 json 内容并解析为对象 T\n * @param gitHubRepoFile\n */\nexport async function getGithubRawJson<O>(gitHubRepoFile: GitHubRepoFile): Promise<O> {\n  return JSON.parse(await fetchWithFormat(parseGithubRawUrl(gitHubRepoFile), 'json')) as O\n}\n","/**\n * 数组洗牌\n */\nexport function shuffle<T>(arr: T[]): T[] {\n  const clone = arr.slice()\n  for (let i = clone.length - 1; i > 0; i--) {\n    const j = Math.floor(Math.random() * (i + 1))\n    ;[clone[i], clone[j]] = [clone[j], clone[i]]\n  }\n  return clone\n}\n\n/**\n * 获取 [min, max] 的随机整数\n */\nexport function randomInt(min: number, max: number): number {\n  return Math.floor(Math.random() * (max - min + 1)) + min\n}\n\n/**\n * 获取 [min, max) 的随机浮点数\n */\nexport function randomFloat(min: number, max: number): number {\n  return Math.random() * (max - min) + min\n}\n\n/**\n * 从数组中随机取若干项，不可重复\n */\nexport function sample<T>(arr: T[], count: number): T[] {\n  return shuffle(arr).slice(0, count)\n}\n\n/**\n * 从数组中随机取若干项，可重复\n */\nexport function sampleWithReplacement<T>(arr: T[], count: number): T[] {\n  const result: T[] = []\n  for (let i = 0; i < count; i++) {\n    const index = randomInt(0, arr.length - 1)\n    result.push(arr[index])\n  }\n  return result\n}\n\n/**\n * 从数组中获取随机项\n */\nexport function sampleOne<T>(arr: T[]): T {\n  return arr[randomInt(0, arr.length - 1)]\n}\n\n/**\n * 获取 1~n 的随机数\n */\nexport function random1ToN(n: number): number {\n  return randomInt(1, n)\n}\n","import type { ObjectWithKeys } from '../types/helpers.js'\n\n/**\n * 判断一个值是否为纯对象\n */\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (value === null || typeof value !== 'object') return false\n  const proto = Object.getPrototypeOf(value)\n  return proto === Object.prototype || proto === null\n}\n\n/**\n * 包括类实例、普通对象，不包括 数组、null 和原始类型\n */\nexport function isObject<K extends string | symbol>(value: unknown, key?: K): value is ObjectWithKeys<K> {\n  if (value === null || typeof value !== 'object') return false\n  if (Array.isArray(value)) return false\n  if (key !== undefined) {\n    return key in value\n  }\n  return true\n}\n","import { isPlainObject } from './type.js'\n\n/**\n * 递归移除对象（或数组）中的所有函数属性，返回一个可安全序列化的副本。\n *\n * @typeParam T - 输入值的类型。\n * @param value - 待处理的值（基本类型、对象、数组等）。\n * @param seen - 内部使用的 WeakMap，用于记录已访问过的对象，防止循环引用。\n *               调用方通常无需传递此参数。\n * @returns 处理后的新副本，其中所有函数属性都被移除。\n *          基本类型（string, number, boolean, null, undefined）将原样返回。\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function stripFunctions<T>(value: T, seen = new WeakMap<object, any>()): T {\n  if (typeof value === 'function') return undefined as T\n  if (value === null || typeof value !== 'object') return value\n\n  if (\n    value instanceof Date ||\n    value instanceof RegExp ||\n    value instanceof Map ||\n    value instanceof Set ||\n    ArrayBuffer.isView(value) ||\n    value instanceof ArrayBuffer\n  ) {\n    return value\n  }\n\n  if (seen.has(value as object)) {\n    return seen.get(value as object)\n  }\n\n  if (Array.isArray(value)) {\n    const out: unknown[] = []\n    seen.set(value as object, out)\n    for (const item of value) {\n      out.push(stripFunctions(item, seen))\n    }\n    return out as T\n  }\n\n  if (!isPlainObject(value)) {\n    return value\n  }\n\n  const out: Record<string, unknown> = {}\n  seen.set(value as object, out)\n\n  for (const [key, item] of Object.entries(value)) {\n    if (typeof item === 'function') continue\n    const next = stripFunctions(item, seen)\n    if (next !== undefined) out[key] = next\n  }\n\n  return out as T\n}\n\n/**\n * 将错误转换为可 JSON 序列化的普通对象。\n */\nexport function serializeError(err: unknown) {\n  if (err instanceof Error) {\n    return {\n      name: err.name,\n      message: err.message,\n      stack: err.stack,\n    }\n  }\n\n  return {\n    name: 'Error',\n    message: String(err),\n  }\n}\n","/**\n * 支持取消的 sleep\n * @param ms      延迟毫秒数\n * @param signal  取消信号\n */\nexport function sleep(ms: number, signal?: AbortSignal) {\n  return new Promise<void>((resolve, reject) => {\n    if (signal?.aborted) return reject(new Error('取消操作'))\n\n    const timer = setTimeout(() => {\n      cleanup()\n      resolve()\n    }, ms)\n\n    const onAbort = () => {\n      clearTimeout(timer)\n      cleanup()\n      reject(new Error('取消操作'))\n    }\n\n    const cleanup = () => {\n      signal?.removeEventListener('abort', onAbort)\n    }\n\n    signal?.addEventListener('abort', onAbort)\n  })\n}\n\n/**\n * 支持取消的随机 sleep\n * @param minMS   最小延迟毫秒数\n * @param maxMS   最大延迟毫秒数\n * @param signal  取消信号\n */\nexport function sleepRandom(minMS: number, maxMS: number, signal?: AbortSignal) {\n  const ms = Math.random() * (maxMS - minMS) + minMS\n  return sleep(ms, signal)\n}\n","/**\n * 格式化日期\n */\nexport function formatDate(date: Date, pattern: 'date' | 'time' | 'datetime'): string {\n  const d = !isNaN(date.getTime()) ? date : new Date()\n  const year = d.getFullYear()\n  const month = String(d.getMonth() + 1).padStart(2, '0')\n  const day = String(d.getDate()).padStart(2, '0')\n  const hours = String(d.getHours()).padStart(2, '0')\n  const minutes = String(d.getMinutes()).padStart(2, '0')\n  const seconds = String(d.getSeconds()).padStart(2, '0')\n\n  if (pattern === 'date') return `${year}-${month}-${day}`\n  if (pattern === 'time') return `${hours}:${minutes}:${seconds}`\n  return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}`\n}\n\n/**\n * 格式化时间为 2020-02-02 20:20:20 的字符串\n * @param date 需要格式化的时间，为空则获取当前时间\n */\nexport function getFormattedDateTime(date?: Date): string {\n  return formatDate(date ?? new Date(), 'datetime')\n}\n\n/**\n * 格式化时间为 2020-02-02 20:20:20 的字符串\n * @param date 需要格式化的时间，为空则获取当前时间\n */\nexport function getFormattedDate(date?: Date): string {\n  return formatDate(date ?? new Date(), 'date')\n}\n\n/**\n * 格式化时间为 20:20:20 的字符串\n * @param date 需要格式化的时间，为空则获取当前时间\n */\nexport function getFormattedTime(date?: Date): string {\n  return formatDate(date ?? new Date(), 'time')\n}\n","/** URL query 中必须编码的保留字符 (RFC 3986) */\nexport const invalidCharRegex = /[!'()*]/g\n\n/** 查询参数 */\nexport type QueryParams = Record<string, string | number | boolean | null | undefined>\n\n/**\n * 已解析的 url\n */\nexport interface ParsedUrl {\n  baseUrl: string\n  searchParams: URLSearchParams\n}\n\n/**\n * 判断字符串是否为有效的 HTTP/HTTPS URL\n * @param path - 待检测的字符串\n */\nexport function isHttpUrl(path: string) {\n  try {\n    const url = new URL(path)\n    return url.protocol === 'http:' || url.protocol === 'https:'\n  } catch {\n    return false\n  }\n}\n\n/**\n * 解析 url\n * @param url\n */\nexport function parseUrl(url: string): ParsedUrl {\n  try {\n    const { origin, pathname, searchParams } = new URL(url)\n    return {\n      baseUrl: origin + pathname,\n      searchParams,\n    }\n  } catch {\n    throw new Error('Invalid URL')\n  }\n}\n\n/**\n * 编码 URL 参数\n * @param params          查询参数\n * @param keepEmptyValues 保留 null/undefined的值（空字符串）\n */\nexport function encodeURLParams(params: QueryParams, keepEmptyValues: boolean = false) {\n  return (\n    Object.keys(params)\n      // 排序\n      .sort()\n      // 过滤\n      .filter((key) => {\n        return keepEmptyValues || params[key] != null\n      })\n      // 编码 key 和 value\n      .map((key) => {\n        const raw = params[key] ?? ''\n        return `${encodeURIComponent(key)}=${encodeURIComponent(String(raw))}`\n      })\n      // 拼接\n      .join('&')\n  )\n}\n\n/**\n *\n */\n/**\n * 合并查询参数\n * @param urlSearchParams url解析后查询参数\n * @param params          单独传的查询参数\n */\nexport function mergeQueryParams(urlSearchParams: URLSearchParams, params?: QueryParams): QueryParams {\n  let mergedParams: QueryParams = {}\n  if (urlSearchParams.size > 0) {\n    // 合并url里的查询参数\n    urlSearchParams.forEach((value, key) => {\n      mergedParams[key] = value\n    })\n  }\n  // 处理单独传的查询参数对象\n  if (params) {\n    mergedParams = { ...mergedParams, ...params }\n  }\n  return mergedParams\n}\n","/**\n * 格式化后的单位数据（如文件大小）\n */\nexport interface FormattedUnitSize {\n  /** 换算后该单位的数值（未四舍五入） */\n  size: number\n  /** 单位名称，如 'MB' */\n  unit: string\n  /** 显示文本：数值四舍五入保留两位小数 + 单位，如 '1.50 MB' */\n  text: string\n}\n\n/**\n * 按进制自动格式化单位\n * @param value 数值\n * @param base 进制（1024 / 1000）\n * @param units 单位列表\n * @param invalidText 无效值返回文本\n */\nexport function formatUnitSize(value: number, base: number, units: string[], invalidText = ''): FormattedUnitSize {\n  if (!Number.isFinite(value)) {\n    return { size: 0, unit: '', text: invalidText }\n  }\n\n  let size = value\n  let unitIndex = 0\n\n  while (size >= base && unitIndex < units.length - 1) {\n    size /= base\n    unitIndex++\n  }\n\n  return {\n    size,\n    unit: units[unitIndex],\n    text: `${size.toFixed(2).replace(/\\.?0+$/, '')} ${units[unitIndex]}`,\n  }\n}\n"],"mappings":"mEAGA,IAAa,EAAb,cAAiC,KAAM,CAIrC,YAAY,EAAiB,EAAoB,CAC/C,MAAM,EAAQ,CAEV,IAAa,IAAA,KACf,KAAK,SAAW,aAAoB,MAAQ,EAAe,MAAM,OAAO,EAAS,CAAC,EAGpF,KAAK,KAAO,IAAI,OAAO,KACvB,OAAO,eAAe,KAAM,IAAI,OAAO,UAAU,CAGnD,UAAW,CACT,MAAO,GAAG,KAAK,KAAK,IAAI,KAAK,UAAU,KAAK,SAAW,eAAe,KAAK,SAAS,GAAK,OCd7F,SAAgB,EAAgB,EAAuB,CAGrD,OAFM,aAAe,MAEd,EAAI,OAAS,cAAgB,EAAI,OAAS,iBAAoB,SAAU,GAAO,EAAI,OAAS,eAF/D,GAStC,SAAgB,EAAiB,EAAqB,CACpD,IAAM,EAAY,MAAM,GAAO,QAAQ,CAEvC,MADA,GAAM,KAAO,aACN,EAMT,SAAgB,EAAc,EAAsC,CAClE,OAAO,aAAiB,GAAgB,aAAiB,OAAS,EAAM,OAAS,cAMnF,SAAS,EAAY,EAAc,EAAwB,CAIzD,OAHK,IAEL,EAAM,QAAU,GAAG,EAAO,GAAG,EAAM,WAFf,EAStB,SAAgB,EAAqB,EAAgB,EAAiB,CAIpE,OAHI,EAAc,EAAM,CACf,EAAY,EAAO,EAAO,CAE5B,IAAI,EAAY,GAAG,EAAO,GAAG,EAAgB,EAAM,GAAI,EAAM,CAMtE,SAAgB,EAAgB,EAAwB,CAUtD,OATI,OAAO,GAAU,SACZ,EAEL,aAAiB,OAGjB,GAAS,OAAO,GAAU,UAAY,YAAa,GAAS,OAAO,EAAM,SAAY,SAChF,EAAM,QAER,OAAO,EAAM,EAAI,OCvD1B,IAAa,EAAb,MAAa,CAAa,CAKxB,YAAY,EAAkB,EAAa,EAAU,CACnD,KAAK,QAAU,EACf,KAAK,IAAM,EACX,KAAK,KAAO,EAGd,OAAO,cAAiB,EAAS,CAC/B,OAAO,IAAI,EAAU,GAAM,OAAQ,EAAK,CAG1C,OAAO,WAAc,EAAc,OAAQ,EAAU,CACnD,OAAO,IAAI,EAAU,GAAO,EAAK,EAAK,CAGxC,OAAO,YAAe,EAAY,CAChC,OAAO,IAAI,EAAa,GAAO,EAAgB,EAAE,CAAC,CAQpD,MAAM,WAAkC,CACtC,GAAI,KAAK,QACP,OAAO,KAAK,KAEZ,MAAM,IAAI,EAAY,KAAK,IAAI,GChCxB,EAAU,KAAU,IAAiD,CAChF,GAAI,CACF,OAAO,EAAU,cAAiB,MAAM,GAAK,CAAC,OACvC,EAAG,CACV,OAAO,EAAU,YAAY,EAAE,GCNnC,SAAgB,EAAW,EAAe,CACxC,OAAO,MAAM,QAAQ,EAAK,EAAI,EAAK,SAAW,EAShD,SAAgB,EAAS,EAAU,EAAqB,CACtD,GAAI,CAAC,OAAO,UAAU,EAAK,EAAI,EAAO,EAAG,MAAU,MAAM,cAAc,CACvE,IAAM,EAAgB,EAAE,CACxB,IAAK,IAAI,EAAI,EAAG,EAAI,EAAI,OAAQ,GAAK,EACnC,EAAO,KAAK,EAAI,MAAM,EAAG,EAAI,EAAK,CAAC,CAErC,OAAO,ECNT,SAAgB,EAAoB,EAAoB,CACtD,OAAW,MAAM,QAAQ,EAAS,OAAO,IAAI,EAAS,aAAa,CAOrE,eAAsB,EACpB,EACA,EACA,EACY,CACZ,IAAM,EAAW,MAAM,MAAM,EAAK,EAAK,CACvC,GAAI,CAAC,EAAS,GACZ,MAAM,EAAoB,EAAS,CAErC,OAAQ,EAAR,CACE,IAAK,OACH,OAAQ,MAAM,EAAS,MAAM,CAC/B,IAAK,OACH,OAAQ,MAAM,EAAS,MAAM,CAC/B,IAAK,OACH,OAAQ,MAAM,EAAS,MAAM,CAC/B,IAAK,cACH,OAAQ,MAAM,EAAS,aAAa,CACtC,IAAK,WACH,OAAQ,MAAM,EAAS,UAAU,CACnC,QACE,OAAQ,MAAM,EAAS,MAAM,ECtCnC,SAAgB,EAAmB,EAAwB,EAAyB,CAClF,IAAuB,EAAI,OAC3B,IAAM,EAAQ,KAAK,MAAM,KAAK,QAAQ,CAAG,EAAS,CAAG,EAE/C,EAAW,CAAC,GAAG,EAAI,CACzB,IAAK,IAAI,EAAI,EAAS,OAAS,EAAG,EAAI,EAAG,IAAK,CAC5C,IAAM,EAAI,KAAK,MAAM,KAAK,QAAQ,EAAI,EAAI,GAAG,CAC5C,CAAC,EAAS,GAAI,EAAS,IAAM,CAAC,EAAS,GAAI,EAAS,GAAG,CAG1D,IAAM,EAAW,EAAS,MAAM,EAAG,EAAM,CAEzC,IAAK,IAAM,KAAM,EACf,GAAI,CAkBR,eAAsB,EACpB,EACA,EACA,EACA,EACe,CACf,IAAK,IAAI,EAAU,EAAO,GAAW,EAAK,GAAW,EAAW,CAC9D,IAAM,EAAY,EAAM,EAAU,EAC5B,EAAa,KAAK,IAAI,EAAW,EAAU,CAGjD,MAAM,EAFQ,MAAM,KAAK,CAAE,OAAQ,EAAY,EAAG,EAAG,IAAQ,EAAU,EAAI,CAErD,EAY1B,SAAgB,EAAqB,EAAW,EAAc,GAAG,EAAgB,CAC/E,IAAM,EAAW,EAAK,MAAM,IAAI,CAC5B,EAAU,EACV,EAAI,EACR,KAAO,EAAI,EAAS,OAAS,EAAG,IAE9B,GADA,EAAU,EAAQ,EAAS,IACvB,GAAW,KACb,MAAU,MAAM,SAAS,EAAS,MAAM,EAAG,EAAI,EAAE,CAAC,KAAK,IAAI,CAAC,qBAAqB,CAGrF,IAAM,EAAK,EAAQ,EAAS,IAC5B,GAAI,OAAO,GAAO,WAChB,MAAU,MAAM,IAAI,EAAK,qBAAqB,CAEhD,OAAO,EAAG,MAAM,EAAS,EAAK,CC/ChC,SAAgB,EAAmB,EAAyC,CAE1E,EAAgB,EAAc,QAAQ,SAAU,GAAG,CAEnD,IAAM,EAAY,0DACZ,EAAY,2DAGZ,EAAK,EAAc,MAAM,EAAU,CACzC,GAAI,EACF,MAAO,CACL,MAAO,EAAG,GACV,KAAM,EAAG,GACT,OAAQ,OACT,CAIH,IAAM,EAAK,EAAc,MAAM,EAAU,CACzC,GAAI,EACF,MAAO,CACL,MAAO,EAAG,GACV,KAAM,EAAG,GACT,OAAQ,EAAG,GACZ,CAGH,MAAU,MAAM,cAAc,CAMhC,SAAgB,EAAkB,EAAgC,CAChE,GAAM,CAAE,QAAO,OAAM,SAAQ,YAAa,EAC1C,MAAO,qCAAqC,EAAM,GAAG,EAAK,GAAG,EAAO,GAAG,IAOzE,eAAsB,EAAoB,EAA4C,CACpF,OAAO,KAAK,MAAM,MAAM,EAAgB,EAAkB,EAAe,CAAE,OAAO,CAAC,CClErF,SAAgB,EAAW,EAAe,CACxC,IAAM,EAAQ,EAAI,OAAO,CACzB,IAAK,IAAI,EAAI,EAAM,OAAS,EAAG,EAAI,EAAG,IAAK,CACzC,IAAM,EAAI,KAAK,MAAM,KAAK,QAAQ,EAAI,EAAI,GAAG,CAC5C,CAAC,EAAM,GAAI,EAAM,IAAM,CAAC,EAAM,GAAI,EAAM,GAAG,CAE9C,OAAO,EAMT,SAAgB,EAAU,EAAa,EAAqB,CAC1D,OAAO,KAAK,MAAM,KAAK,QAAQ,EAAI,EAAM,EAAM,GAAG,CAAG,EAMvD,SAAgB,EAAY,EAAa,EAAqB,CAC5D,OAAO,KAAK,QAAQ,EAAI,EAAM,GAAO,EAMvC,SAAgB,EAAU,EAAU,EAAoB,CACtD,OAAO,EAAQ,EAAI,CAAC,MAAM,EAAG,EAAM,CAMrC,SAAgB,EAAyB,EAAU,EAAoB,CACrE,IAAM,EAAc,EAAE,CACtB,IAAK,IAAI,EAAI,EAAG,EAAI,EAAO,IAAK,CAC9B,IAAM,EAAQ,EAAU,EAAG,EAAI,OAAS,EAAE,CAC1C,EAAO,KAAK,EAAI,GAAO,CAEzB,OAAO,EAMT,SAAgB,EAAa,EAAa,CACxC,OAAO,EAAI,EAAU,EAAG,EAAI,OAAS,EAAE,EAMzC,SAAgB,EAAW,EAAmB,CAC5C,OAAO,EAAU,EAAG,EAAE,CCnDxB,SAAgB,EAAc,EAAkD,CAC9E,GAAsB,OAAO,GAAU,WAAnC,EAA6C,MAAO,GACxD,IAAM,EAAQ,OAAO,eAAe,EAAM,CAC1C,OAAO,IAAU,OAAO,WAAa,IAAU,KAMjD,SAAgB,EAAoC,EAAgB,EAAqC,CAMvG,OALsB,OAAO,GAAU,WAAnC,GACA,MAAM,QAAQ,EAAM,CAAS,GAC7B,IAAQ,IAAA,GAGL,GAFE,KAAO,ECLlB,SAAgB,EAAkB,EAAU,EAAO,IAAI,QAA2B,CAChF,GAAI,OAAO,GAAU,WAAY,OAGjC,GAFsB,OAAO,GAAU,WAAnC,GAGF,aAAiB,MACjB,aAAiB,QACjB,aAAiB,KACjB,aAAiB,KACjB,YAAY,OAAO,EAAM,EACzB,aAAiB,YAEjB,OAAO,EAGT,GAAI,EAAK,IAAI,EAAgB,CAC3B,OAAO,EAAK,IAAI,EAAgB,CAGlC,GAAI,MAAM,QAAQ,EAAM,CAAE,CACxB,IAAM,EAAiB,EAAE,CACzB,EAAK,IAAI,EAAiB,EAAI,CAC9B,IAAK,IAAM,KAAQ,EACjB,EAAI,KAAK,EAAe,EAAM,EAAK,CAAC,CAEtC,OAAO,EAGT,GAAI,CAAC,EAAc,EAAM,CACvB,OAAO,EAGT,IAAM,EAA+B,EAAE,CACvC,EAAK,IAAI,EAAiB,EAAI,CAE9B,IAAK,GAAM,CAAC,EAAK,KAAS,OAAO,QAAQ,EAAM,CAAE,CAC/C,GAAI,OAAO,GAAS,WAAY,SAChC,IAAM,EAAO,EAAe,EAAM,EAAK,CACnC,IAAS,IAAA,KAAW,EAAI,GAAO,GAGrC,OAAO,EAMT,SAAgB,EAAe,EAAc,CAS3C,OARI,aAAe,MACV,CACL,KAAM,EAAI,KACV,QAAS,EAAI,QACb,MAAO,EAAI,MACZ,CAGI,CACL,KAAM,QACN,QAAS,OAAO,EAAI,CACrB,CCnEH,SAAgB,EAAM,EAAY,EAAsB,CACtD,OAAO,IAAI,SAAe,EAAS,IAAW,CAC5C,GAAI,GAAQ,QAAS,OAAO,EAAW,MAAM,OAAO,CAAC,CAErD,IAAM,EAAQ,eAAiB,CAC7B,GAAS,CACT,GAAS,EACR,EAAG,CAEA,MAAgB,CACpB,aAAa,EAAM,CACnB,GAAS,CACT,EAAW,MAAM,OAAO,CAAC,EAGrB,MAAgB,CACpB,GAAQ,oBAAoB,QAAS,EAAQ,EAG/C,GAAQ,iBAAiB,QAAS,EAAQ,EAC1C,CASJ,SAAgB,EAAY,EAAe,EAAe,EAAsB,CAE9E,OAAO,EADI,KAAK,QAAQ,EAAI,EAAQ,GAAS,EAC5B,EAAO,CCjC1B,SAAgB,EAAW,EAAY,EAA+C,CACpF,IAAM,EAAK,MAAM,EAAK,SAAS,CAAC,CAAU,IAAI,KAAX,EAC7B,EAAO,EAAE,aAAa,CACtB,EAAQ,OAAO,EAAE,UAAU,CAAG,EAAE,CAAC,SAAS,EAAG,IAAI,CACjD,EAAM,OAAO,EAAE,SAAS,CAAC,CAAC,SAAS,EAAG,IAAI,CAC1C,EAAQ,OAAO,EAAE,UAAU,CAAC,CAAC,SAAS,EAAG,IAAI,CAC7C,EAAU,OAAO,EAAE,YAAY,CAAC,CAAC,SAAS,EAAG,IAAI,CACjD,EAAU,OAAO,EAAE,YAAY,CAAC,CAAC,SAAS,EAAG,IAAI,CAIvD,OAFI,IAAY,OAAe,GAAG,EAAK,GAAG,EAAM,GAAG,IAC/C,IAAY,OAAe,GAAG,EAAM,GAAG,EAAQ,GAAG,IAC/C,GAAG,EAAK,GAAG,EAAM,GAAG,EAAI,GAAG,EAAM,GAAG,EAAQ,GAAG,IAOxD,SAAgB,EAAqB,EAAqB,CACxD,OAAO,EAAW,GAAQ,IAAI,KAAQ,WAAW,CAOnD,SAAgB,EAAiB,EAAqB,CACpD,OAAO,EAAW,GAAQ,IAAI,KAAQ,OAAO,CAO/C,SAAgB,EAAiB,EAAqB,CACpD,OAAO,EAAW,GAAQ,IAAI,KAAQ,OAAO,CCrC/C,IAAa,EAAmB,WAiBhC,SAAgB,EAAU,EAAc,CACtC,GAAI,CACF,IAAM,EAAM,IAAI,IAAI,EAAK,CACzB,OAAO,EAAI,WAAa,SAAW,EAAI,WAAa,cAC9C,CACN,MAAO,IAQX,SAAgB,EAAS,EAAwB,CAC/C,GAAI,CACF,GAAM,CAAE,SAAQ,WAAU,gBAAiB,IAAI,IAAI,EAAI,CACvD,MAAO,CACL,QAAS,EAAS,EAClB,eACD,MACK,CACN,MAAU,MAAM,cAAc,EASlC,SAAgB,EAAgB,EAAqB,EAA2B,GAAO,CACrF,OACE,OAAO,KAAK,EAAO,CAEhB,MAAM,CAEN,OAAQ,GACA,GAAmB,EAAO,IAAQ,KACzC,CAED,IAAK,GAAQ,CACZ,IAAM,EAAM,EAAO,IAAQ,GAC3B,MAAO,GAAG,mBAAmB,EAAI,CAAC,GAAG,mBAAmB,OAAO,EAAI,CAAC,IACpE,CAED,KAAK,IAAI,CAYhB,SAAgB,EAAiB,EAAkC,EAAmC,CACpG,IAAI,EAA4B,EAAE,CAWlC,OAVI,EAAgB,KAAO,GAEzB,EAAgB,SAAS,EAAO,IAAQ,CACtC,EAAa,GAAO,GACpB,CAGA,IACF,EAAe,CAAE,GAAG,EAAc,GAAG,EAAQ,EAExC,ECpET,SAAgB,EAAe,EAAe,EAAc,EAAiB,EAAc,GAAuB,CAChH,GAAI,CAAC,OAAO,SAAS,EAAM,CACzB,MAAO,CAAE,KAAM,EAAG,KAAM,GAAI,KAAM,EAAa,CAGjD,IAAI,EAAO,EACP,EAAY,EAEhB,KAAO,GAAQ,GAAQ,EAAY,EAAM,OAAS,GAChD,GAAQ,EACR,IAGF,MAAO,CACL,OACA,KAAM,EAAM,GACZ,KAAM,GAAG,EAAK,QAAQ,EAAE,CAAC,QAAQ,SAAU,GAAG,CAAC,GAAG,EAAM,KACzD"}

package/dist/dom/index.d.ts

@@ -1,6 +0,0 @@
-export * from './utils/color.js';
-export * from './utils/css.js';
-export * from './utils/img.js';
-export * from './utils/network.js';
-export * from './utils/page.js';
-export * from './utils/scroll.js';

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

@@ -1,32 +0,0 @@
-/**
- * 生成 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;
-};

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

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

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

@@ -1,14 +0,0 @@
-/**
- * 等待 <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>;

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

@@ -1,25 +0,0 @@
-/**
- * 网络信息
- */
-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';
-/**
- * 获取网络信息
- */
-export declare function getNetworkInfo(): NetworkState;
-/**
- * 监听网络状态变化
- * @param listener 监听器
- * @returns 成功监听时返回解绑函数
- */
-export declare function onNetworkChange(listener: (info: NetworkState) => void): () => void;

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

@@ -1,10 +0,0 @@
-/** 可见性改变的监听器 */
-export interface VisibilityChangeListener {
-    (hidden: boolean): void;
-}
-/**
- * 监听页面可见性变化（兼容旧的IE/Chrome）
- * @param listener 监听器
- * @returns 成功监听时返回解绑函数
- */
-export declare function onVisibilityChange(listener: VisibilityChangeListener): (() => void) | null;

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

@@ -1,13 +0,0 @@
-/**
- * 滚动元素到屏幕中心
- * @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>;

package/dist/dom.umd.cjs

@@ -1,2 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=(e,t,n,r=`srgb`,i)=>`color-mix(in ${r}, ${e} ${n}%, ${t} ${i||100-n}%)`,t=e=>({r:parseInt(e.slice(1,3),16),g:parseInt(e.slice(3,5),16),b:parseInt(e.slice(5,7),16)}),n=(e,t)=>{document.documentElement.style.setProperty(e,t)};function r(e){return new Promise((t,n)=>{if(e.dataset.state===`loading`&&(e.src=e.dataset.src),e.complete&&e.naturalWidth>0){t(e);return}let r=()=>{a(),t(e)},i=()=>{a(),n(Error(`图片加载失败: ${e.src}`))},a=()=>{e.removeEventListener(`load`,r),e.removeEventListener(`error`,i)};e.addEventListener(`load`,r),e.addEventListener(`error`,i)})}async function i(e,t=`image/png`){let n=document.createElement(`canvas`);n.width=e.naturalWidth,n.height=e.naturalHeight;let r=n.getContext(`2d`);if(!r)throw Error(`无法创建 Canvas 2D 上下文`);return r.drawImage(e,0,0),await(await new Promise((e,r)=>{n.toBlob(t=>t?e(t):r(Error(`toBlob 失败`)),t)})).arrayBuffer()}async function a(e,t){return await i(await r(e),t)}function o(e){return typeof e==`object`&&!!e&&`downlink`in e&&`rtt`in e&&`effectiveType`in e}function s(){if(!navigator.onLine)return`offline`;if(`connection`in navigator&&o(navigator.connection)){let e=navigator.connection;return{downlink:e.downlink,rtt:e.rtt,effectiveType:e.effectiveType}}else return`online`}function c(e){let t=()=>{e(s())};if(`connection`in navigator&&o(navigator.connection)){let e=navigator.connection;return e.addEventListener(`change`,t),()=>e.removeEventListener(`change`,t)}else return window.addEventListener(`online`,t),window.addEventListener(`offline`,t),()=>{window.removeEventListener(`online`,t),window.removeEventListener(`offline`,t)}}function l(e){let t,n;if(document.hidden===void 0?`msHidden`in document&&document.msHidden!==void 0?(t=`msHidden`,n=`msvisibilitychange`):`webkitHidden`in document&&document.webkitHidden!==void 0&&(t=`webkitHidden`,n=`webkitvisibilitychange`):(t=`hidden`,n=`visibilitychange`),!t||!n)return null;let r=()=>{e(document[t])};return document.addEventListener(n,r),()=>{document.removeEventListener(n,r)}}async function u(e){if(!e)return;let t=e.getBoundingClientRect(),n=document.documentElement,r=document.body,i=window.scrollX||n.scrollLeft||r.scrollLeft,a=window.scrollY||n.scrollTop||r.scrollTop,o=window.innerWidth,s=window.innerHeight,c=t.left+i+t.width/2-o/2,l=t.top+a+t.height/2-s/2,u=Math.max(0,r.scrollWidth-o),d=Math.max(0,r.scrollHeight-s);if(u===0&&d===0)return;let p=u>0?Math.min(Math.max(c,0),u):i,m=d>0?Math.min(Math.max(l,0),d):a,h=Math.abs(window.scrollX-p)>1,g=Math.abs(window.scrollY-m)>1;!h&&!g||await f(p,m)}function d(e,t){return new Promise(n=>{let r=window.scrollX,i=window.scrollY;if(Math.abs(r-e)<1&&Math.abs(i-t)<1){n();return}let a,o=!1,s=()=>{o||(o=!0,window.removeEventListener(`scroll`,c),a&&clearTimeout(a),n())},c=()=>{a&&clearTimeout(a),a=window.setTimeout(s,50)},l=window.setTimeout(()=>{console.debug(`[waitScrollTo] fallback timeout reached`),s()},1e3),u=()=>{s(),clearTimeout(l)};window.addEventListener(`scroll`,()=>{a&&clearTimeout(a),a=window.setTimeout(u,50)},{passive:!0}),window.scrollTo({left:e,top:t}),requestAnimationFrame(()=>{let n=window.scrollX,r=window.scrollY;Math.abs(n-e)<1&&Math.abs(r-t)<1&&u()})})}async function f(e,t){return new Promise(n=>{let r=window.scrollX,i=window.scrollY;async function a(){let o=e-r,s=t-i;if(Math.abs(o)<1&&Math.abs(s)<1){window.scrollTo(e,t),n();return}let c=Math.sign(o)*Math.min(Math.max(2,Math.random()*Math.abs(o)*.2),Math.abs(o)),l=Math.sign(s)*Math.min(Math.max(2,Math.random()*Math.abs(s)*.2),Math.abs(s));r+=c,i+=l,await d(r,i);let u=10+Math.random()*20;setTimeout(a,u)}a()})}exports.getImageArrayBuffer=i,exports.getImgArrayBufferAfterLoad=a,exports.getNetworkInfo=s,exports.hexToRgb=t,exports.humanScrollElIntoCenter=u,exports.humanScrollTo=f,exports.mixColor=e,exports.onNetworkChange=c,exports.onVisibilityChange=l,exports.setCssVar=n,exports.waitScrollTo=d,exports.whenImageLoaded=r;
-//# sourceMappingURL=dom.umd.cjs.map

package/dist/dom.umd.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"dom.umd.cjs","names":[],"sources":["../src/dom/utils/color.ts","../src/dom/utils/css.ts","../src/dom/utils/img.ts","../src/dom/utils/network.ts","../src/dom/utils/page.ts","../src/dom/utils/scroll.ts"],"sourcesContent":["/**\n * 生成 CSS `color-mix()` 函数的字符串表示，用于动态计算两种颜色的混合结果\n *\n * @param {string} color1 - 参与混合的第一种颜色（支持 CSS 合法颜色值，如 HEX、RGB、HSL 等）\n * @param {string} color2 - 参与混合的第二种颜色\n * @param {number} percentage - 主颜色（color1）在混合中的占比（百分比数值，范围 0-100）\n * @param {'srgb' | 'hsl'} [colorSpace='srgb'] - 色彩空间选项：\n *   - `'srgb'`: 标准 RGB 色彩空间（默认）\n *   - `'hsl'`: 色相-饱和度-明度色彩空间\n * @param {number} [percentage2] - 可选参数：副颜色（color2）的独立占比。\n *   若未提供，则自动计算为 `100 - percentage`\n * @returns {string} 可直接用于 CSS 的 `color-mix()` 函数字符串（如 `color-mix(in srgb, red 30%, blue 70%)`）\n *\n * @example\n * // 基础用法（自动计算互补占比）\n * mixColor('red', 'blue', 30)\n * // 返回: \"color-mix(in srgb, red 30%, blue 70%)\"\n *\n * @example\n * // 显式指定双占比 + HSL 色彩空间\n * mixColor('#ff0000', '#0000ff', 40, 'hsl', 60)\n * // 返回: \"color-mix(in hsl, #ff0000 40%, #0000ff 60%)\"\n */\nexport const mixColor = (\n  color1: string,\n  color2: string,\n  percentage: number,\n  colorSpace: 'srgb' | 'hsl' = 'srgb',\n  percentage2?: number,\n): string => {\n  return `color-mix(in ${colorSpace}, ${color1} ${percentage}%, ${color2} ${percentage2 ? percentage2 : 100 - percentage}%)`\n}\n\n/**\n * 将十六进制颜色转换为 RGB\n */\nexport const hexToRgb = (hex: string): { r: number; g: number; b: number } => {\n  const r = parseInt(hex.slice(1, 3), 16)\n  const g = parseInt(hex.slice(3, 5), 16)\n  const b = parseInt(hex.slice(5, 7), 16)\n  return { r, g, b }\n}\n","/**\n * 设置 html 根元素的 css 变量\n */\nexport const setCssVar = (k: string, v: string) => {\n  document.documentElement.style.setProperty(k, v)\n}\n","/**\n * 等待 <img> 加载完成\n */\nexport function whenImageLoaded(img: HTMLImageElement): Promise<HTMLImageElement> {\n  return new Promise((resolve, reject) => {\n    if (img.dataset['state'] === 'loading') {\n      img.src = img.dataset['src']!\n    }\n\n    if (img.complete && img.naturalWidth > 0) {\n      resolve(img)\n      return\n    }\n\n    const onLoad = () => {\n      cleanup()\n      resolve(img)\n    }\n\n    const onError = () => {\n      cleanup()\n      reject(new Error(`图片加载失败: ${img.src}`))\n    }\n\n    const cleanup = () => {\n      img.removeEventListener('load', onLoad)\n      img.removeEventListener('error', onError)\n    }\n\n    img.addEventListener('load', onLoad)\n    img.addEventListener('error', onError)\n  })\n}\n\n/**\n * 从 <img> 元素获取图片字节数据（ArrayBuffer）\n * @param img 已加载的 <img> 元素\n * @param type 图片类型，可选（默认 png）\n */\nexport async function getImageArrayBuffer(img: HTMLImageElement, type: string = 'image/png'): Promise<ArrayBuffer> {\n  const canvas = document.createElement('canvas')\n  canvas.width = img.naturalWidth\n  canvas.height = img.naturalHeight\n  const ctx = canvas.getContext('2d')\n  if (!ctx) throw new Error('无法创建 Canvas 2D 上下文')\n  ctx.drawImage(img, 0, 0)\n\n  const blob: Blob = await new Promise((resolve, reject) => {\n    canvas.toBlob((b) => (b ? resolve(b) : reject(new Error('toBlob 失败'))), type)\n  })\n\n  return await blob.arrayBuffer()\n}\n\n/**\n * 等待加载完成并获取字节数据\n */\nexport async function getImgArrayBufferAfterLoad(img: HTMLImageElement, type?: string): Promise<ArrayBuffer> {\n  const loaded = await whenImageLoaded(img)\n  return await getImageArrayBuffer(loaded, type)\n}\n","/**\n * 网络信息\n */\nexport interface NetworkInfo extends EventTarget {\n  // 带宽（估算）\n  downlink: number\n  // 延迟（估算）\n  rtt: number\n  // 类型（估算）\n  effectiveType: 'slow-2g' | '2g' | '3g' | '4g'\n}\n\n/**\n * 网络状态\n * - 'offline': 无网络\n * - 'online': 在线但不支持 NetworkInformation API\n * - NetworkInformation: 含详细网络信息\n */\nexport type NetworkState = 'offline' | Omit<NetworkInfo, keyof EventTarget> | 'online'\n\nfunction isConnection(obj: unknown): obj is NetworkInfo {\n  return obj !== null && typeof obj === 'object' && 'downlink' in obj && 'rtt' in obj && 'effectiveType' in obj\n}\n\n/**\n * 获取网络信息\n */\nexport function getNetworkInfo(): NetworkState {\n  if (!navigator.onLine) {\n    return 'offline'\n  }\n\n  if ('connection' in navigator && isConnection(navigator.connection)) {\n    // 现代 Web API 直接获取网络连接的信息\n    const connection = navigator.connection\n    return {\n      downlink: connection.downlink,\n      rtt: connection.rtt,\n      effectiveType: connection.effectiveType,\n    }\n  } else {\n    return 'online'\n  }\n}\n\n/**\n * 监听网络状态变化\n * @param listener 监听器\n * @returns 成功监听时返回解绑函数\n */\nexport function onNetworkChange(listener: (info: NetworkState) => void) {\n  const handleChange = () => {\n    listener(getNetworkInfo())\n  }\n\n  if ('connection' in navigator && isConnection(navigator.connection)) {\n    // 现代 Web API\n    const connection = navigator.connection\n    connection.addEventListener('change', handleChange)\n    return () => connection.removeEventListener('change', handleChange)\n  } else {\n    window.addEventListener('online', handleChange)\n    window.addEventListener('offline', handleChange)\n    return () => {\n      window.removeEventListener('online', handleChange)\n      window.removeEventListener('offline', handleChange)\n    }\n  }\n}\n","/** 可见性改变的监听器 */\nexport interface VisibilityChangeListener {\n  (hidden: boolean): void\n}\n\n/**\n * 监听页面可见性变化（兼容旧的IE/Chrome）\n * @param listener 监听器\n * @returns 成功监听时返回解绑函数\n */\nexport function onVisibilityChange(listener: VisibilityChangeListener) {\n  let hiddenPropName: string | undefined = undefined,\n    hiddenEventName: string | undefined = undefined\n\n  if (typeof document.hidden !== 'undefined') {\n    // 现代 Web API\n    hiddenPropName = 'hidden'\n    hiddenEventName = 'visibilitychange'\n  } else if ('msHidden' in document && typeof document.msHidden !== 'undefined') {\n    // 旧 IE\n    hiddenPropName = 'msHidden'\n    hiddenEventName = 'msvisibilitychange'\n  } else if ('webkitHidden' in document && typeof document.webkitHidden !== 'undefined') {\n    // 旧 Chrome\n    hiddenPropName = 'webkitHidden'\n    hiddenEventName = 'webkitvisibilitychange'\n  }\n\n  if (!hiddenPropName || !hiddenEventName) {\n    return null\n  }\n\n  const handler = () => {\n    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n    // @ts-ignore\n    listener(document[hiddenPropName])\n  }\n\n  document.addEventListener(hiddenEventName, handler)\n\n  return () => {\n    document.removeEventListener(hiddenEventName, handler)\n  }\n}\n","/**\n * 滚动元素到屏幕中心\n * @param el\n */\nexport async function humanScrollElIntoCenter(el: HTMLElement) {\n  if (!el) return\n\n  const rect = el.getBoundingClientRect()\n  const doc = document.documentElement\n  const body = document.body\n\n  const scrollX = window.scrollX || doc.scrollLeft || body.scrollLeft\n  const scrollY = window.scrollY || doc.scrollTop || body.scrollTop\n\n  const viewW = window.innerWidth\n  const viewH = window.innerHeight\n\n  // 目标中心点相对页面的位置\n  const targetX = rect.left + scrollX + rect.width / 2 - viewW / 2\n  const targetY = rect.top + scrollY + rect.height / 2 - viewH / 2\n\n  const maxX = Math.max(0, body.scrollWidth - viewW)\n  const maxY = Math.max(0, body.scrollHeight - viewH)\n\n  // 页面不需要滚动\n  if (maxX === 0 && maxY === 0) return\n\n  // 水平滚动：仅在可滚动时\n  const newX = maxX > 0 ? Math.min(Math.max(targetX, 0), maxX) : scrollX\n  // 垂直滚动\n  const newY = maxY > 0 ? Math.min(Math.max(targetY, 0), maxY) : scrollY\n\n  // 判断是否真正需要滚动\n  const needScrollX = Math.abs(window.scrollX - newX) > 1\n  const needScrollY = Math.abs(window.scrollY - newY) > 1\n  if (!needScrollX && !needScrollY) return\n\n  await humanScrollTo(newX, newY)\n}\n\n/**\n * 等待滚动\n */\nexport function waitScrollTo(targetX: number, targetY: number): Promise<void> {\n  return new Promise((resolve) => {\n    const currentX = window.scrollX\n    const currentY = window.scrollY\n\n    // 若无需滚动\n    if (Math.abs(currentX - targetX) < 1 && Math.abs(currentY - targetY) < 1) {\n      resolve()\n      return\n    }\n\n    let timer: number | undefined\n    let finished = false\n\n    const cleanup = () => {\n      if (finished) return\n      finished = true\n      window.removeEventListener('scroll', handler)\n      if (timer) clearTimeout(timer)\n      resolve()\n    }\n\n    const handler = () => {\n      if (timer) clearTimeout(timer)\n      // 若 50ms 内无新滚动事件，则视为滚动结束\n      timer = window.setTimeout(cleanup, 50)\n    }\n\n    // 启动兜底超时（比如滚动事件根本不触发）\n    const failSafe = window.setTimeout(() => {\n      console.debug('[waitScrollTo] fallback timeout reached')\n      cleanup()\n    }, 1000)\n\n    const cleanupWithTimeout = () => {\n      cleanup()\n      clearTimeout(failSafe)\n    }\n\n    // 替换 cleanup，确保清理超时器\n    const finalHandler = () => {\n      if (timer) clearTimeout(timer)\n      timer = window.setTimeout(cleanupWithTimeout, 50)\n    }\n\n    // 注册事件\n    window.addEventListener('scroll', finalHandler, { passive: true })\n\n    // 立即触发滚动\n    window.scrollTo({ left: targetX, top: targetY })\n\n    // 有时浏览器同步滚动，不触发 scroll 事件\n    requestAnimationFrame(() => {\n      const nowX = window.scrollX\n      const nowY = window.scrollY\n      if (Math.abs(nowX - targetX) < 1 && Math.abs(nowY - targetY) < 1) {\n        cleanupWithTimeout()\n      }\n    })\n  })\n}\n\n/**\n * 模拟人类手感滚动到指定位置\n */\nexport async function humanScrollTo(targetX: number, targetY: number): Promise<void> {\n  return new Promise<void>((resolve) => {\n    let currentX = window.scrollX\n    let currentY = window.scrollY\n\n    async function step() {\n      const dx = targetX - currentX\n      const dy = targetY - currentY\n\n      // 如果距离足够小，直接跳到目标结束\n      if (Math.abs(dx) < 1 && Math.abs(dy) < 1) {\n        window.scrollTo(targetX, targetY)\n        resolve()\n        return\n      }\n\n      // 随机步长 (最小 2px，最大剩余距离的 20%)\n      const stepX = Math.sign(dx) * Math.min(Math.max(2, Math.random() * Math.abs(dx) * 0.2), Math.abs(dx))\n      const stepY = Math.sign(dy) * Math.min(Math.max(2, Math.random() * Math.abs(dy) * 0.2), Math.abs(dy))\n\n      currentX += stepX\n      currentY += stepY\n      await waitScrollTo(currentX, currentY)\n\n      // 随机短暂停顿 10~30ms\n      const delay = 10 + Math.random() * 20\n      setTimeout(step, delay)\n    }\n\n    step()\n  })\n}\n"],"mappings":"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"}

package/dist/node/index.d.ts

@@ -1,8 +0,0 @@
-export * from './utils/env.js';
-export * from './utils/file/base.js';
-export * from './utils/file/delete.js';
-export * from './utils/file/json.js';
-export * from './utils/file/size.js';
-export * from './utils/win/copy.js';
-export * from './utils/win/explorer.js';
-export * from './utils/win/regedit.js';

package/dist/node/utils/env.d.ts

@@ -1,6 +0,0 @@
-/**
- * 获取环境变量
- */
-export declare function getEnv(): {
-    [p: string]: string;
-};

package/dist/node/utils/file/base.d.ts

@@ -1,20 +0,0 @@
-/**
- * 判断路径是否是文件
- */
-export declare function isFile(filePath: string): Promise<boolean>;
-/**
- * 判断文件是否存在
- */
-export declare function existsFile(file: string, mode?: number): Promise<boolean>;
-/**
- * 确保目录存在
- */
-export declare function ensureDirSync(dirPath: string): Promise<void>;
-/**
- * 确保目录存在
- */
-export declare function ensureDir(dirPath: string): Promise<void>;
-/**
- * 判断错误是否为文件不存在
- */
-export declare function isFileNotFoundError(error: unknown): boolean;

package/dist/node/utils/file/delete.d.ts

@@ -1,12 +0,0 @@
-/**
- * 删除指定目录下的所有文件和子目录（保留指定目录）
- * @param dir 目标目录路径
- * @return 成功删除的文件或目录路径数组
- */
-export declare function emptyDirectory(dir: string): Promise<string[]>;
-/**
- * 删除文件（不删除目录）
- * @param paths 文件路径列表
- * @returns 成功删除的文件路径数组
- */
-export declare function deleteFiles(paths: string[]): Promise<string[]>;

package/dist/node/utils/file/download.d.ts

@@ -1,4 +0,0 @@
-/**
- * 下载文件
- */
-export declare function downloadFile(url: string, filePath: string): Promise<void>;

package/dist/node/utils/file/find.d.ts

@@ -1,14 +0,0 @@
-/**
- * 查找目录下符合条件的文件路径（不遍历子目录）
- * @param dir 目标目录路径
- * @param prefix 文件名前缀（需全字匹配）
- * @param suffix 文件名后缀（需全字匹配，如 ".txt"）
- * @return 符合条件的文件完整路径的数组
- */
-export declare function findFilesByPrefixAndSuffix(dir: string, prefix?: string, suffix?: string): Promise<string[]>;
-/**
- * 查找文件（包含子目录）
- * @param dir     目录
- * @param target  查找目标名称或者过滤函数
- */
-export declare function findFiles(dir: string, target: string | ((fileName: string, fullPath?: string) => boolean)): Promise<string[]>;

package/dist/node/utils/file/json.d.ts

@@ -1,20 +0,0 @@
-/**
- * 读取 JSON 文件
- */
-export declare function readJSONFile<T>(filePath: string): Promise<T>;
-/**
- * 将数据原子写入 JSON 文件（先写临时文件再替换）
- */
-export declare function writeJSONFile<T>(file: string, data: T): Promise<void>;
-/**
- * 读取 JSON 文件，修改后写回（原子操作）
- */
-export declare function updateJSON<T>(file: string, updater: (oldData: T) => T): Promise<T>;
-/**
- * 从文件读取 JSON，若文件不存在则调用 initData 初始化并写入
- *
- * @param file 文件绝对路径或相对路径
- * @param initData 返回要写入的数据的异步函数
- * @returns 解析后的数据
- */
-export declare function readOrInitJSON<T>(file: string, initData: () => Promise<T>): Promise<T>;

package/dist/node/utils/file/size.d.ts

@@ -1,19 +0,0 @@
-/**
- * 将 KB 文件大小格式化为字符串
- * @param sizeKB 文件大小（单位：KB）
- * @param invalidText 输入无效时返回文本
- */
-export declare function formatFileSizeFromKB(sizeKB: number, invalidText?: string): string;
-/**
- * 获取目录总大小（字节），递归统计所有子文件
- * 符号链接：只计算链接文件本身的大小，不跟随指向目录
- * 权限错误：跳过该文件/目录，大小计为 0
- * @param dir 目录路径
- * @returns 总字节数
- */
-export declare function getDirSize(dir: string): Promise<number>;
-/**
- * 获取文件/文件夹大小
- * @param filePath 文件/文件夹路径
- */
-export declare function getFileSizeKB(filePath: string): Promise<number>;

package/dist/node/utils/win/cmd.d.ts

@@ -1,21 +0,0 @@
-/**
- * 命令执行的选项
- */
-interface ExecOptions {
-    /**
-     * 判断结果码是否成功
-     * @param number 结果码
-     */
-    codeIsSuccess?: (number: number) => boolean;
-    /**
-     * 终止信号
-     */
-    signal?: AbortSignal;
-}
-/**
- * 执行 windows 的命令
- * @param cmd     命令
- * @param options 执行选项
- */
-export declare function execWinCmd(cmd: string, options?: ExecOptions): Promise<string>;
-export {};

package/dist/node/utils/win/copy.d.ts

@@ -1,4 +0,0 @@
-/**
- * 文件拷贝工具，支持文件或文件夹
- */
-export declare function copyFile(source: string, destination: string, signal?: AbortSignal): Promise<void>;

package/dist/node/utils/win/explorer.d.ts

@@ -1,5 +0,0 @@
-/**
- * 打开资源管理器并定位到目录或者文件
- * @param fileOrDir 定位的目录或文件
- */
-export declare function showInExplorer(fileOrDir: string): Promise<void>;

package/dist/node/utils/win/regedit.d.ts

@@ -1,17 +0,0 @@
-/**
- * 打开注册表
- * @param path 显示的路径
- */
-export declare function openRegedit(path: string): Promise<string>;
-/**
- * 导出注册表
- * @param regPath 注册表路径
- * @param filePath 导出的文件路径
- */
-export declare function exportRegedit(regPath: string, filePath: string): Promise<void>;
-/**
- * 导入注册表
- * @param regPath 注册表路径
- * @param filePath 导入的文件路径
- */
-export declare function importRegedit(regPath: string, filePath: string): Promise<void>;

package/dist/node.umd.cjs

@@ -1,2 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`node:fs/promises`);c=s(c,1);let l=require(`node:path`);l=s(l,1);let u=require(`node:child_process`),d=require(`iconv-lite`);d=s(d,1);function f(){let e={};for(let t in process.env)e[t]=process.env[t];return e}async function p(e){try{return(await c.default.stat(e)).isFile()}catch{return!1}}async function m(e,t){try{return c.default.access(e,t),!0}catch{return!1}}async function h(e){c.default.mkdir(e,{recursive:!0})}async function g(e){await c.default.mkdir(e,{recursive:!0})}function _(e){return typeof e==`object`&&!!e&&`code`in e&&e.code===`ENOENT`}async function v(e){let t=[],n=await c.default.readdir(e,{withFileTypes:!0});for(let r of n){let n=l.default.join(e,r.name);r.isDirectory()?(t.push(...await v(n)),await c.default.rmdir(n)):await c.default.unlink(n),t.push(n)}return t}async function y(e){return(await Promise.allSettled(e.map(async e=>(await c.default.unlink(e),e)))).filter(e=>e.status===`fulfilled`).map(e=>e.value)}async function b(e){if(!await p(e))throw Error(`文件不存在`);let t=await c.default.readFile(l.default.resolve(e),`utf-8`);return JSON.parse(t)}async function x(e,t){let n=`${e}.tmp.${Date.now()}`,r=JSON.stringify(t,null,2);await c.default.writeFile(n,r,`utf-8`),await c.default.rename(n,e)}async function S(e,t){let n=t(await b(e));return await x(e,n),n}async function C(e,t){try{let t=await c.default.readFile(e,`utf-8`);return JSON.parse(t)}catch(n){if(!_(n))throw n;let r=await t();return await g(l.default.dirname(e)),await c.default.writeFile(e,JSON.stringify(r,null,2),`utf-8`),r}}function w(e,t,n,r=``){if(!Number.isFinite(e))return{size:0,unit:``,text:r};let i=e,a=0;for(;i>=t&&a<n.length-1;)i/=t,a++;return{size:i,unit:n[a],text:`${i.toFixed(2).replace(/\.?0+$/,``)} ${n[a]}`}}function T(e,t=``){let{size:n,unit:r,text:i}=w(e,1024,[`KB`,`MB`,`GB`],t);if(i===t)return t;let a=Math.floor(n),o;return o=a>99?0:a>9?1:2,`${Math.round(n*10**o)/10**o} ${r}`}async function E(e){try{return(await c.default.stat(e)).size}catch{return 0}}async function D(e){try{return(await c.default.lstat(e)).size}catch{return 0}}async function O(e){let t;try{t=await c.default.readdir(e,{withFileTypes:!0})}catch{return 0}let n=[];for(let r of t){let t=l.default.join(e,r.name);if(r.isDirectory()){n.push(O(t));continue}if(r.isSymbolicLink()){n.push(D(t));continue}n.push(E(t))}return(await Promise.allSettled(n)).reduce((e,t)=>e+(t.status===`fulfilled`?t.value:0),0)}async function k(e){try{let t=await c.default.stat(e);return t.isDirectory()?await O(e)/1024:t.size/1024}catch{return 0}}function A(e){let t=Error(e??`操作已取消`);return t.name=`AbortError`,t}async function j(e,t){return new Promise((n,r)=>{if(t?.signal?.aborted)throw A();let i=null,a=(0,u.exec)(`${e}`,{encoding:`buffer`},(e,a,o)=>{let s=d.decode(a,`cp936`),c=d.decode(o,`cp936`);i&&t?.signal?.removeEventListener(`abort`,i);let l=e?Number(e.code??0):0;(t?.codeIsSuccess?!t.codeIsSuccess(l):l!==0)?r(Error(`命令行执行出错 (${l}): ${c||s}`)):n(s)}),o;i=()=>{a.kill(`SIGTERM`),o=setTimeout(()=>{a.kill(`SIGKILL`)},3e3),r(A())},t?.signal&&t.signal.addEventListener(`abort`,i),a.on(`close`,()=>{o!==void 0&&clearTimeout(o),t?.signal?.removeEventListener(`abort`,i)})})}async function M(e,t,n){let r=l.default.resolve(e),i=l.default.resolve(t),a;await p(e)?(a=`copy "${r}" "${i}"`,await j(a,{signal:n})):(a=`robocopy "${r}" "${i}" /E /NFL /NDL /NJH /NJS /NC /NS /NP`,await j(a,{codeIsSuccess:e=>e<8,signal:n}))}async function N(e){e=l.default.resolve(e),(await c.stat(e)).isDirectory()?await j(`start "" "${e}"`):await j(`start "" explorer /select,"${e}"`)}async function P(e){return j(`taskkill /f /im regedit.exe & REG ADD "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Applets\\Regedit" /v "LastKey" /d "${e}" /f & regedit`)}async function F(e,t){t=l.default.resolve(t),await g(e),await j(`reg export "${e}" "${t}" /y`,void 0)}async function I(e,t){await j(`reg import "${l.default.resolve(t)}"`,void 0)}exports.copyFile=M,exports.deleteFiles=y,exports.emptyDirectory=v,exports.ensureDir=g,exports.ensureDirSync=h,exports.existsFile=m,exports.exportRegedit=F,exports.formatFileSizeFromKB=T,exports.getDirSize=O,exports.getEnv=f,exports.getFileSizeKB=k,exports.importRegedit=I,exports.isFile=p,exports.isFileNotFoundError=_,exports.openRegedit=P,exports.readJSONFile=b,exports.readOrInitJSON=C,exports.showInExplorer=N,exports.updateJSON=S,exports.writeJSONFile=x;
-//# sourceMappingURL=node.umd.cjs.map