@nickyzj2023/utils 1.0.56 → 1.0.58

package/dist/{index.d.ts → index.d.mts}

@@ -1,17 +1,18 @@
+//#region src/dom/log.d.ts
 /**
  * log 配置选项
  */
 interface LogOptions {
-    /**
-     * 是否显示时间
-     * @default true
-     */
-    time?: boolean;
-    /**
-     * 是否显示调用者文件名
-     * @default true
-     */
-    fileName?: boolean;
+  /**
+   * 是否显示时间
+   * @default true
+   */
+  time?: boolean;
+  /**
+   * 是否显示调用者文件名
+   * @default true
+   */
+  fileName?: boolean;
 }
 /**
  * 带额外信息的 console.log
@@ -26,7 +27,8 @@ interface LogOptions {
  * log(["消息1", "消息2"]); // "[14:30:00] [index.ts:15] 消息1 消息2"
  */
 declare const log: (message: any | any[], options?: LogOptions) => void;
-
+//#endregion
+//#region src/function/loop-until.d.ts
 /**
  * 循环执行函数，直到符合停止条件
  *
@@ -55,15 +57,15 @@ declare const log: (message: any | any[], options?: LogOptions) => void;
  * ),
  */
 declare const loopUntil: <T>(fn: (count: number) => T | Promise<T>, options?: {
-    /**
-     * 最大循环次数
-     * @default 5
-     */
-    maxRetries?: number;
-    /** 停止循环条件。如果未传递，则执行 maxRetries 次后退出并返回最后结果 */
-    shouldStop?: (result: T) => boolean;
+  /**
+   * 最大循环次数
+   * @default 5
+   */
+  maxRetries?: number; /** 停止循环条件。如果未传递，则执行 maxRetries 次后退出并返回最后结果 */
+  shouldStop?: (result: T) => boolean;
 }) => Promise<T>;
-
+//#endregion
+//#region src/hoc/with-cache.d.ts
 type SetTtl = (seconds: number) => void;
 /**
  * 创建一个带缓存的高阶函数
@@ -100,13 +102,14 @@ type SetTtl = (seconds: number) => void;
  * await fetchData(urlB); // 使用缓存结果
  */
 declare const withCache: <Args extends any[], Result>(fn: (this: {
-    setTtl: SetTtl;
+  setTtl: SetTtl;
 }, ...args: Args) => Result, ttlSeconds?: number) => {
-    (...args: Args): Result;
-    clear(): void;
-    updateTtl(seconds: number): void;
+  (...args: Args): Result;
+  clear(): void;
+  updateTtl(seconds: number): void;
 };
-
+//#endregion
+//#region src/is/is-falsy.d.ts
 type Falsy = false | 0 | -0 | 0n | "" | null | undefined;
 /**
  * 检测传入的值是否为**假值**（false、0、''、null、undefined、NaN等）
@@ -116,7 +119,8 @@ type Falsy = false | 0 | -0 | 0n | "" | null | undefined;
  * isFalsy(1); // false
  */
 declare const isFalsy: (value: any) => value is Falsy;
-
+//#endregion
+//#region src/is/is-nil.d.ts
 /**
  * 检测传入的值是否为**空值**（null、undefined）
  *
@@ -126,7 +130,8 @@ declare const isFalsy: (value: any) => value is Falsy;
  * isNil(1); // false
  */
 declare const isNil: (value: any) => value is null | undefined;
-
+//#endregion
+//#region src/is/is-object.d.ts
 /**
  * 检测传入的值是否为**普通对象**
  *
@@ -135,7 +140,8 @@ declare const isNil: (value: any) => value is null | undefined;
  * isObject(obj); // true
  */
 declare const isObject: (value: any) => value is Record<string, any>;
-
+//#endregion
+//#region src/is/is-primitive.d.ts
 type Primitive = number | string | boolean | symbol | bigint | undefined | null;
 /**
  * 检测传入的值是否为**原始值**（number、string、boolean、symbol、bigint、undefined、null）
@@ -145,14 +151,14 @@ type Primitive = number | string | boolean | symbol | bigint | undefined | null;
  * isPrimitive([]); // false
  */
 declare const isPrimitive: (value: any) => value is Primitive;
-
+//#endregion
+//#region src/network/fetcher.d.ts
 type FetchOptions = {
-    /** 代理服务器配置 */
-    proxy?: string;
+  /** 代理服务器配置 */proxy?: string;
 };
 type RequestInit = globalThis.RequestInit & FetchOptions & {
-    params?: Record<string, any>;
-    parser?: (response: Response) => Promise<any>;
+  params?: Record<string, any>;
+  parser?: (response: Response) => Promise<any>;
 };
 /**
  * 基于 Fetch API 的请求客户端
@@ -197,36 +203,37 @@ type RequestInit = globalThis.RequestInit & FetchOptions & {
  * await getBlogs("/blogs");  // 不发请求，使用缓存
  */
 declare const fetcher: (baseURL?: string, baseOptions?: RequestInit) => {
-    get: <T>(url: string, options?: Omit<RequestInit, "method">) => Promise<T>;
-    post: <T>(url: string, body: any, options?: Omit<RequestInit, "method" | "body">) => Promise<T>;
-    put: <T>(url: string, body: any, options?: Omit<RequestInit, "method" | "body">) => Promise<T>;
-    delete: <T>(url: string, options?: Omit<RequestInit, "method" | "body">) => Promise<T>;
+  get: <T>(url: string, options?: Omit<RequestInit, "method">) => Promise<T>;
+  post: <T>(url: string, body: any, options?: Omit<RequestInit, "method" | "body">) => Promise<T>;
+  put: <T>(url: string, body: any, options?: Omit<RequestInit, "method" | "body">) => Promise<T>;
+  delete: <T>(url: string, options?: Omit<RequestInit, "method" | "body">) => Promise<T>;
 };
-
+//#endregion
+//#region src/network/get-real-url.d.ts
 /** 从 url 响应头获取真实链接 */
 declare const getRealURL: (originURL: string) => Promise<string>;
-
+//#endregion
+//#region src/network/image.d.ts
 /**
  * 图片压缩选项
  */
 type ImageCompressionOptions = {
-    /** 压缩比率，默认 0.92 */
-    quality?: number;
-    /**
-     * 自定义压缩函数，用于覆盖默认压缩行为
-     * @param arrayBuffer 图片的 ArrayBuffer 数据
-     * @param mime 图片的 MIME 类型
-     * @param quality 压缩质量
-     * @returns 压缩后的 base64 字符串
-     */
-    compressor?: (arrayBuffer: ArrayBuffer, mime: string, quality: number) => Promise<string> | string;
-    /**
-     * 自定义 fetch 函数，用于使用自己封装的请求库读取图片
-     * 必须返回符合 Web 标准的 Response 对象
-     * @param url 图片地址
-     * @returns Promise<Response>
-     */
-    fetcher?: (url: string) => Promise<Response>;
+  /** 压缩比率，默认 0.92 */quality?: number;
+  /**
+   * 自定义压缩函数，用于覆盖默认压缩行为
+   * @param arrayBuffer 图片的 ArrayBuffer 数据
+   * @param mime 图片的 MIME 类型
+   * @param quality 压缩质量
+   * @returns 压缩后的 base64 字符串
+   */
+  compressor?: (arrayBuffer: ArrayBuffer, mime: string, quality: number) => Promise<string> | string;
+  /**
+   * 自定义 fetch 函数，用于使用自己封装的请求库读取图片
+   * 必须返回符合 Web 标准的 Response 对象
+   * @param url 图片地址
+   * @returns Promise<Response>
+   */
+  fetcher?: (url: string) => Promise<Response>;
 };
 /**
  * 图片地址转 base64 数据
@@ -265,7 +272,8 @@ type ImageCompressionOptions = {
  * });
  */
 declare const imageUrlToBase64: (imageUrl: string, options?: ImageCompressionOptions) => Promise<string>;
-
+//#endregion
+//#region src/network/to.d.ts
 /**
  * Go 语言风格的异步处理方式
  * @param promise 一个能被 await 的异步函数
@@ -275,7 +283,8 @@ declare const imageUrlToBase64: (imageUrl: string, options?: ImageCompressionOpt
  * const [error, response] = await to(fetcher().get<Blog>("/blogs/hello-world"));
  */
 declare const to: <T, E = Error>(promise: Promise<T>) => Promise<[null, T] | [E, undefined]>;
-
+//#endregion
+//#region src/number/random-int.d.ts
 /**
  * 在指定闭区间内生成随机整数
  *
@@ -283,9 +292,10 @@ declare const to: <T, E = Error>(promise: Promise<T>) => Promise<[null, T] | [E,
  * randomInt(1, 10);    // 1 <= x <= 10
  */
 declare const randomInt: (min: number, max: number) => number;
-
+//#endregion
+//#region src/object/map-keys.d.ts
 type DeepMapKeys<T> = T extends Array<infer U> ? Array<DeepMapKeys<U>> : T extends object ? {
-    [key: string]: DeepMapKeys<T[keyof T]>;
+  [key: string]: DeepMapKeys<T[keyof T]>;
 } : T;
 /**
  * 递归处理对象里的 key
@@ -301,10 +311,9 @@ type DeepMapKeys<T> = T extends Array<infer U> ? Array<DeepMapKeys<U>> : T exten
  * console.log(result); // { A: { B: 1 } }
  */
 declare const mapKeys: <T>(obj: T, getNewKey: (key: string) => string) => DeepMapKeys<T>;
-
-type DeepMapValues<T, R> = T extends Array<infer U> ? Array<DeepMapValues<U, R>> : T extends object ? {
-    [K in keyof T]: T[K] extends object ? DeepMapValues<T[K], R> : R;
-} : R;
+//#endregion
+//#region src/object/map-values.d.ts
+type DeepMapValues<T, R> = T extends Array<infer U> ? Array<DeepMapValues<U, R>> : T extends object ? { [K in keyof T]: T[K] extends object ? DeepMapValues<T[K], R> : R } : R;
 /**
  * 递归处理对象里的 value
  *
@@ -320,10 +329,10 @@ type DeepMapValues<T, R> = T extends Array<infer U> ? Array<DeepMapValues<U, R>>
  * console.log(result); // { a: 2, b: { c: 3 } }
  */
 declare const mapValues: <T, R = any>(obj: T, getNewValue: (value: any, key: string | number) => R, options?: {
-    /** 过滤函数，返回 true 表示保留该字段 */
-    filter?: (value: any, key: string | number) => boolean;
+  /** 过滤函数，返回 true 表示保留该字段 */filter?: (value: any, key: string | number) => boolean;
 }) => DeepMapValues<T, R>;
-
+//#endregion
+//#region src/object/merge-objects.d.ts
 /**
  * 深度合并两个对象，规则如下：
  * 1. 原始值覆盖：如果两个值都是原始类型，则用后者覆盖;
@@ -336,7 +345,8 @@ declare const mapValues: <T, R = any>(obj: T, getNewValue: (value: any, key: str
  * @param {U} obj2 要合并的第二个对象
  */
 declare const mergeObjects: <T extends Record<string, any>, U extends Record<string, any>>(obj1: T, obj2: U) => T & U;
-
+//#endregion
+//#region src/string/case.d.ts
 type SnakeToCamel<S extends string> = S extends `${infer Before}_${infer After}` ? After extends `${infer First}${infer Rest}` ? `${Before}${Uppercase<First>}${SnakeToCamel<Rest>}` : Before : S;
 /**
  * 下划线命名法转为驼峰命名法
@@ -369,7 +379,8 @@ type Decapitalize<S extends string> = S extends `${infer P1}${infer Rest}` ? P1
  * decapitalize("Hello") // "hello"
  */
 declare const decapitalize: <S extends string>(s: S) => Decapitalize<S>;
-
+//#endregion
+//#region src/string/compact.d.ts
 /**
  * 将字符串压缩为单行精简格式
  *
@@ -383,16 +394,31 @@ declare const decapitalize: <S extends string>(s: S) => Decapitalize<S>;
  * });
  */
 declare const compactStr: (text?: string, options?: {
-    /** 最大保留长度，设为 0 或 Infinity 则不截断，默认 Infinity */
-    maxLength?: number;
-    /** 是否将换行符替换为字面量 \n，默认开启 */
-    disableNewLineReplace?: boolean;
-    /** 是否合并连续的空格/制表符为一个空格，默认开启 */
-    disableWhitespaceCollapse?: boolean;
-    /** 截断后的后缀，默认为 "..." */
-    omission?: string;
+  /** 最大保留长度，设为 0 或 Infinity 则不截断，默认 Infinity */maxLength?: number; /** 是否将换行符替换为字面量 \n，默认开启 */
+  disableNewLineReplace?: boolean; /** 是否合并连续的空格/制表符为一个空格，默认开启 */
+  disableWhitespaceCollapse?: boolean; /** 截断后的后缀，默认为 "..." */
+  omission?: string;
 }) => string;
-
+//#endregion
+//#region src/string/qs.d.ts
+/**
+ * 针对 URL 查询字符串的解析和序列化
+ * @example
+ * qs.parse("?a=1&b=2") // { a: 1, b: 2 }
+ * qs.stringify({ a: 1, b: 2 }, { addQueryPrefix: true }) // "?a=1&b=2"
+ */
+declare const qs: {
+  /** queryString -> queryParams */parse: (queryString: string) => Record<string, any>;
+  stringify: (params: Record<string, any>, options?: {
+    /**
+     * 是否在结果前添加“?”
+     * @default false
+     */
+    addQueryPrefix: boolean;
+  }) => string;
+};
+//#endregion
+//#region src/time/debounce.d.ts
 /**
  * 防抖：在指定时间内只执行最后一次调用
  * @param fn 要防抖的函数
@@ -413,7 +439,8 @@ declare const compactStr: (text?: string, options?: {
  * search('hello'); // 300ms 后执行
  */
 declare const debounce: <T extends (...args: any[]) => any>(fn: T, delay?: number) => (...args: Parameters<T>) => void;
-
+//#endregion
+//#region src/time/sleep.d.ts
 /**
  * 延迟一段时间再执行后续代码
  * @param time 延迟时间，默认 150ms
@@ -421,7 +448,8 @@ declare const debounce: <T extends (...args: any[]) => any>(fn: T, delay?: numbe
  * await sleep(1000); // 等待 1 秒执行后续代码
  */
 declare const sleep: (time?: number) => Promise<unknown>;
-
+//#endregion
+//#region src/time/throttle.d.ts
 /**
  * 节流函数 - 在指定时间间隔内最多执行一次调用
  * @param fn 要节流的函数
@@ -442,5 +470,5 @@ declare const sleep: (time?: number) => Promise<unknown>;
  * window.addEventListener('scroll', handleScroll);
  */
 declare const throttle: <T extends (...args: any[]) => any>(fn: T, delay?: number) => (this: any, ...args: Parameters<T>) => void;
-
-export { type CamelToSnake, type Capitalize, type Decapitalize, type DeepMapKeys, type DeepMapValues, type Falsy, type FetchOptions, type ImageCompressionOptions, type LogOptions, type Primitive, type RequestInit, type SetTtl, type SnakeToCamel, camelToSnake, capitalize, compactStr, debounce, decapitalize, fetcher, getRealURL, imageUrlToBase64, isFalsy, isNil, isObject, isPrimitive, log, loopUntil, mapKeys, mapValues, mergeObjects, randomInt, sleep, snakeToCamel, throttle, to, withCache };
+//#endregion
+export { CamelToSnake, Capitalize, Decapitalize, DeepMapKeys, DeepMapValues, Falsy, FetchOptions, ImageCompressionOptions, LogOptions, Primitive, RequestInit, SetTtl, SnakeToCamel, camelToSnake, capitalize, compactStr, debounce, decapitalize, fetcher, getRealURL, imageUrlToBase64, isFalsy, isNil, isObject, isPrimitive, log, loopUntil, mapKeys, mapValues, mergeObjects, qs, randomInt, sleep, snakeToCamel, throttle, to, withCache };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+const e=(e,t)=>{let{time:n=!0,fileName:r=!0}=t??{},i=[];if(n&&i.push(`[${new Date().toLocaleTimeString()}]`),r){let{stack:e}=Error(),t=(e?.split(`
+`)[2]?.trim())?.match(/at\s+(.*):(\d+)/);if(t?.[1]){let e=t[1].split(/[/\\]/).pop();i.push(`[${e}:${t[2]}]`)}}Array.isArray(e)?i.push(...e):i.push(e),console.log(...i)},t=async(e,t)=>{let{maxRetries:n=5,shouldStop:r}=t??{},i;for(let t=0;t<n;t++)if(i=await e(t),r?.(i)===!0)return i;if(!r)return i;throw Error(`超过了最大循环次数（${n}）且未满足停止执行条件`)},n=(e,t=-1)=>{let n=new Map,r=(...r)=>{let i=JSON.stringify(r),a=Date.now(),o=n.get(i);if(o&&a<o.expiresAt)return o.value;let s=t===-1?1/0:a+t*1e3,c=e.apply({setTtl:e=>{s=a+e*1e3}},r);if(c instanceof Promise){let e=c.then(e=>(n.set(i,{value:e,expiresAt:s}),e));return n.set(i,{value:e,expiresAt:s}),e}return n.set(i,{value:c,expiresAt:s}),c};return r.clear=()=>n.clear(),r.updateTtl=e=>{t=e;let r=Date.now(),i=r+e*1e3;for(let[e,t]of n.entries())t.expiresAt>r&&(t.expiresAt=i,n.set(e,t))},r},r=e=>!e,i=e=>e==null,a=e=>e?.constructor===Object,o=e=>e==null||typeof e!=`object`&&typeof e!=`function`,s=(e,t)=>Array.isArray(e)?e.map(e=>s(e,t)):a(e)?Object.keys(e).reduce((n,r)=>{let i=t(r),a=e[r];return n[i]=s(a,t),n},{}):e,c=(e,t,n)=>{let{filter:r}=n??{};if(Array.isArray(e)){let i=e.map((e,r)=>a(e)?c(e,t,n):t(e,r));return r?i.filter((e,t)=>r(e,t)):i}return a(e)?Object.keys(e).reduce((i,o)=>{let s=e[o],l;return l=a(s)||Array.isArray(s)?c(s,t,n):t(s,o),(!r||r(l,o))&&(i[o]=l),i},{}):e},l=(e,t)=>{let n={...e};for(let e of Object.keys(t)){let r=n[e],i=t[e];if(o(r)&&o(i)){n[e]=i;continue}if(Array.isArray(r)&&Array.isArray(i)){n[e]=r.concat(i);continue}if(a(r)&&a(i)){n[e]=l(r,i);continue}n[e]=i}return n},u=(e=``,t={})=>{let n=async(n,r={})=>{let o=new URL(e?`${e}${n}`:n),{params:s,parser:c,...u}=l(t,r);a(s)&&Object.entries(s).forEach(([e,t])=>{i(t)||o.searchParams.append(e,t.toString())}),(a(u.body)||Array.isArray(u.body))&&(u.body=JSON.stringify(u.body),u.headers={...u.headers,"Content-Type":`application/json`});let d=await fetch(o,u);if(!d.ok)throw d.headers.get(`Content-Type`)?.startsWith(`application/json`)?await d.json():Error(d.statusText);return await(c?.(d)??d.json())};return{get:(e,t)=>n(e,{...t,method:`GET`}),post:(e,t,r)=>n(e,{...r,method:`POST`,body:t}),put:(e,t,r)=>n(e,{...r,method:`PUT`,body:t}),delete:(e,t)=>n(e,{...t,method:`DELETE`})}},d=async e=>{try{return[null,await e]}catch(e){return[e,void 0]}},f=async e=>{let[t,n]=await d(fetch(e,{method:`HEAD`,redirect:`manual`}));return t?e:n.headers.get(`location`)||e},p=e=>{let t=new Uint8Array(e),n=``;for(let e=0;e<t.byteLength;e++)n+=String.fromCharCode(t[e]);return btoa(n)},m=async()=>{try{let e=await Function(`modulePath`,`return import(modulePath)`)(`sharp`);return e.default||e}catch{return null}},h=async(e,t,n,r)=>{let i=e(Buffer.from(t));if(n===`image/jpeg`)i=i.jpeg({quality:Math.round(r*100)});else if(n===`image/png`){let e=Math.round((1-r)*9);i=i.png({compressionLevel:e})}return`data:${n};base64,${(await i.toBuffer()).toString(`base64`)}`},g=async(e,t={})=>{let{quality:n=.92,compressor:r,fetcher:i=fetch}=t;if(!e.startsWith(`http`))throw Error(`图片地址必须以http或https开头`);let a=await i(e);if(!a.ok)throw Error(`获取图片失败: ${a.statusText}`);let o=a.headers.get(`Content-Type`)||`image/jpeg`,s=await a.arrayBuffer();if(o!==`image/jpeg`&&o!==`image/png`)return`data:${o};base64,${p(s)}`;if(r)return await r(s,o,n);if(typeof OffscreenCanvas<`u`){let e=null;try{let t=new Blob([s],{type:o});e=await createImageBitmap(t);let r=new OffscreenCanvas(e.width,e.height),i=r.getContext(`2d`);if(!i)throw Error(`无法获取 OffscreenCanvas context`);return i.drawImage(e,0,0),e.close(),e=null,`data:${o};base64,${p(await(await r.convertToBlob({type:o,quality:n})).arrayBuffer())}`}catch{return e?.close(),`data:${o};base64,${p(s)}`}}let c=await m();if(c)try{return await h(c,s,o,n)}catch{return`data:${o};base64,${p(s)}`}return`data:${o};base64,${p(s)}`},_=(e,t)=>Math.floor(Math.random()*(t-e+1))+e,v=e=>e.replace(/_([a-zA-Z])/g,(e,t)=>t.toUpperCase()),y=e=>e.replace(/([A-Z])/g,(e,t)=>`_${t.toLowerCase()}`),b=e=>e.charAt(0).toUpperCase()+e.slice(1),x=e=>e.charAt(0).toLowerCase()+e.slice(1),S=(e=``,t)=>{if(!e)return``;let{maxLength:n=1/0,disableNewLineReplace:r=!1,disableWhitespaceCollapse:i=!1,omission:a=`...`}=t??{},o=e;return o=r?o.replace(/\r?\n/g,` `):o.replace(/\r?\n/g,`\\n`),i||(o=o.replace(/\s+/g,` `)),o=o.trim(),n>0&&o.length>n?o.slice(0,n)+a:o},C={parse:e=>{let t=new URLSearchParams(e),n={};for(let[e,r]of t)Number.isNaN(Number(r))?n[e]=r:n[e]=Number(r);return n},stringify:(e,t)=>{let{addQueryPrefix:n=!1}=t??{},r=new URLSearchParams(e).toString();return r?n?`?${r}`:r:``}},w=(e,t=300)=>{let n=null;return(...r)=>{n&&clearTimeout(n),n=setTimeout(()=>{e(...r)},t)}},T=async(e=150)=>new Promise(t=>{setTimeout(t,e)}),E=(e,t=300)=>{let n=null;return function(...r){n||=setTimeout(()=>{n=null,e.apply(this,r)},t)}};export{y as camelToSnake,b as capitalize,S as compactStr,w as debounce,x as decapitalize,u as fetcher,f as getRealURL,g as imageUrlToBase64,r as isFalsy,i as isNil,a as isObject,o as isPrimitive,e as log,t as loopUntil,s as mapKeys,c as mapValues,l as mergeObjects,C as qs,_ as randomInt,T as sleep,v as snakeToCamel,E as throttle,d as to,n as withCache};

package/package.json

@@ -1,20 +1,27 @@
 {
   "name": "@nickyzj2023/utils",
-  "version": "1.0.56",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Nickyzj628/utils.git"
-  },
+  "version": "1.0.58",
   "type": "module",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
   "files": [
     "dist"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Nickyzj628/utils.git"
+  },
   "devDependencies": {
     "@biomejs/biome": "^2.4.4",
-    "@types/node": "^25.3.2",
-    "tsup": "^8.5.1",
+    "@types/node": "^25.5.0",
+    "tsdown": "^0.21.2",
     "typedoc": "^0.28.17",
     "typedoc-material-theme": "^1.4.1"
   },
@@ -22,7 +29,7 @@
     "typescript": "^5.9.3"
   },
   "scripts": {
-    "docs": "typedoc src/index.ts --plugin typedoc-material-theme",
-    "build": "tsup src/index.ts --format esm --dts --minify --out-dir dist && pnpm docs"
+    "build": "tsdown",
+    "docs": "typedoc src/index.ts --plugin typedoc-material-theme"
   }
-}
+}

package/dist/index.js

@@ -1,2 +0,0 @@
-var P=(e,s)=>{let{time:t=!0,fileName:n=!0}=s??{},a=[];if(t&&a.push(`[${new Date().toLocaleTimeString()}]`),n){let{stack:r}=new Error,i=r?.split(`
-`)[2]?.trim()?.match(/at\s+(.*):(\d+)/);if(i?.[1]){let p=i[1].split(/[/\\]/).pop();a.push(`[${p}:${i[2]}]`)}}Array.isArray(e)?a.push(...e):a.push(e),console.log(...a)};var v=async(e,s)=>{let{maxRetries:t=5,shouldStop:n}=s??{},a;for(let r=0;r<t;r++)if(a=await e(r),n?.(a)===!0)return a;if(!n)return a;throw new Error(`\u8D85\u8FC7\u4E86\u6700\u5927\u5FAA\u73AF\u6B21\u6570\uFF08${t}\uFF09\u4E14\u672A\u6EE1\u8DB3\u505C\u6B62\u6267\u884C\u6761\u4EF6`)};var L=(e,s=-1)=>{let t=new Map,n=(...a)=>{let r=JSON.stringify(a),o=Date.now(),i=t.get(r);if(i&&o<i.expiresAt)return i.value;let p=s===-1?1/0:o+s*1e3,f={setTtl:u=>{p=o+u*1e3}},c=e.apply(f,a);if(c instanceof Promise){let u=c.then(m=>(t.set(r,{value:m,expiresAt:p}),m));return t.set(r,{value:u,expiresAt:p}),u}return t.set(r,{value:c,expiresAt:p}),c};return n.clear=()=>t.clear(),n.updateTtl=a=>{s=a;let r=Date.now(),o=r+a*1e3;for(let[i,p]of t.entries())p.expiresAt>r&&(p.expiresAt=o,t.set(i,p))},n};var q=e=>!e;var g=e=>e==null;var l=e=>e?.constructor===Object;var d=e=>e==null||typeof e!="object"&&typeof e!="function";var h=(e,s)=>Array.isArray(e)?e.map(t=>h(t,s)):l(e)?Object.keys(e).reduce((n,a)=>{let r=s(a),o=e[a];return n[r]=h(o,s),n},{}):e;var b=(e,s,t)=>{let{filter:n}=t??{};if(Array.isArray(e)){let a=e.map((r,o)=>l(r)?b(r,s,t):s(r,o));return n?a.filter((r,o)=>n(r,o)):a}return l(e)?Object.keys(e).reduce((r,o)=>{let i=e[o],p;return l(i)||Array.isArray(i)?p=b(i,s,t):p=s(i,o),(!n||n(p,o))&&(r[o]=p),r},{}):e};var x=(e,s)=>{let t={...e};for(let n of Object.keys(s)){let a=t[n],r=s[n];if(d(a)&&d(r)){t[n]=r;continue}if(Array.isArray(a)&&Array.isArray(r)){t[n]=a.concat(r);continue}if(l(a)&&l(r)){t[n]=x(a,r);continue}t[n]=r}return t};var ce=(e="",s={})=>{let t=async(n,a={})=>{let r=new URL(e?`${e}${n}`:n),{params:o,parser:i,...p}=x(s,a);l(o)&&Object.entries(o).forEach(([u,m])=>{g(m)||r.searchParams.append(u,m.toString())}),(l(p.body)||Array.isArray(p.body))&&(p.body=JSON.stringify(p.body),p.headers={...p.headers,"Content-Type":"application/json"});let f=await fetch(r,p);if(!f.ok)throw f.headers.get("Content-Type")?.startsWith("application/json")?await f.json():new Error(f.statusText);return await(i?.(f)??f.json())};return{get:(n,a)=>t(n,{...a,method:"GET"}),post:(n,a,r)=>t(n,{...r,method:"POST",body:a}),put:(n,a,r)=>t(n,{...r,method:"PUT",body:a}),delete:(n,a)=>t(n,{...a,method:"DELETE"})}};var w=async e=>{try{return[null,await e]}catch(s){return[s,void 0]}};var me=async e=>{let[s,t]=await w(fetch(e,{method:"HEAD",redirect:"manual"}));return s?e:t.headers.get("location")||e};var y=e=>{let s=new Uint8Array(e),t="";for(let n=0;n<s.byteLength;n++)t+=String.fromCharCode(s[n]);return btoa(t)},A=async()=>{try{let s=await new Function("modulePath","return import(modulePath)")("sharp");return s.default||s}catch{return null}},$=async(e,s,t,n)=>{let a=Buffer.from(s),r=e(a);if(t==="image/jpeg")r=r.jpeg({quality:Math.round(n*100)});else if(t==="image/png"){let i=Math.round((1-n)*9);r=r.png({compressionLevel:i})}let o=await r.toBuffer();return`data:${t};base64,${o.toString("base64")}`},de=async(e,s={})=>{let{quality:t=.92,compressor:n,fetcher:a=fetch}=s;if(!e.startsWith("http"))throw new Error("\u56FE\u7247\u5730\u5740\u5FC5\u987B\u4EE5http\u6216https\u5F00\u5934");let r=await a(e);if(!r.ok)throw new Error(`\u83B7\u53D6\u56FE\u7247\u5931\u8D25: ${r.statusText}`);let o=r.headers.get("Content-Type")||"image/jpeg",i=await r.arrayBuffer();if(o!=="image/jpeg"&&o!=="image/png"){let c=y(i);return`data:${o};base64,${c}`}if(n)return await n(i,o,t);if(typeof OffscreenCanvas<"u"){let c=null;try{let u=new Blob([i],{type:o});c=await createImageBitmap(u);let m=new OffscreenCanvas(c.width,c.height),T=m.getContext("2d");if(!T)throw new Error("\u65E0\u6CD5\u83B7\u53D6 OffscreenCanvas context");T.drawImage(c,0,0),c.close(),c=null;let S=await(await m.convertToBlob({type:o,quality:t})).arrayBuffer(),R=y(S);return`data:${o};base64,${R}`}catch{c?.close();let u=y(i);return`data:${o};base64,${u}`}}let p=await A();if(p)try{return await $(p,i,o,t)}catch{let c=y(i);return`data:${o};base64,${c}`}let f=y(i);return`data:${o};base64,${f}`};var Se=(e,s)=>Math.floor(Math.random()*(s-e+1))+e;var Ce=e=>e.replace(/_([a-zA-Z])/g,(s,t)=>t.toUpperCase()),Pe=e=>e.replace(/([A-Z])/g,(s,t)=>`_${t.toLowerCase()}`),Oe=e=>e.charAt(0).toUpperCase()+e.slice(1),ke=e=>e.charAt(0).toLowerCase()+e.slice(1);var ve=(e="",s)=>{if(!e)return"";let{maxLength:t=1/0,disableNewLineReplace:n=!1,disableWhitespaceCollapse:a=!1,omission:r="..."}=s??{},o=e;return n?o=o.replace(/\r?\n/g," "):o=o.replace(/\r?\n/g,"\\n"),a||(o=o.replace(/\s+/g," ")),o=o.trim(),t>0&&o.length>t?o.slice(0,t)+r:o};var Me=(e,s=300)=>{let t=null;return(...n)=>{t&&clearTimeout(t),t=setTimeout(()=>{e(...n)},s)}};var je=async(e=150)=>new Promise(s=>{setTimeout(s,e)});var Fe=(e,s=300)=>{let t=null;return function(...n){t||(t=setTimeout(()=>{t=null,e.apply(this,n)},s))}};export{Pe as camelToSnake,Oe as capitalize,ve as compactStr,Me as debounce,ke as decapitalize,ce as fetcher,me as getRealURL,de as imageUrlToBase64,q as isFalsy,g as isNil,l as isObject,d as isPrimitive,P as log,v as loopUntil,h as mapKeys,b as mapValues,x as mergeObjects,Se as randomInt,je as sleep,Ce as snakeToCamel,Fe as throttle,w as to,L as withCache};