@nickyzj2023/utils 1.0.52 → 1.0.54

package/dist/dom/index.d.ts

@@ -1 +1 @@
-export { timeLog } from "./timeLog";
+export * from "./log";

package/dist/dom/log.d.ts

@@ -0,0 +1,26 @@
+/**
+ * log 配置选项
+ */
+export interface LogOptions {
+    /**
+     * 是否显示时间
+     * @default true
+     */
+    time?: boolean;
+    /**
+     * 是否显示调用者文件名
+     * @default true
+     */
+    fileName?: boolean;
+}
+/**
+ * 带额外信息的 console.log
+ * @param message - 日志消息
+ * @param options - 配置选项
+ *
+ * @example
+ * log("调试信息"); // "调试信息"
+ * log("调试信息", { time: true }); // "[14:30:00] 调试信息"
+ * log("调试信息", { time: true, fileName: true }); // "[14:30:00] [index.ts:15] 调试信息"
+ */
+export declare const log: (message: any, options?: LogOptions) => void;

package/dist/function/index.d.ts

@@ -1 +1 @@
-export { loopUntil } from "./loopUntil";
+export * from "./loop-until";

package/dist/function/loop-until.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 循环执行函数，直到符合停止条件
+ *
+ * @example
+ * // 循环请求大语言模型，直到其不再调用工具
+ * loopUntil(
+ *   async () => {
+ *     const completion = await chatCompletions();
+ *     completion.tool_calls?.forEach(chooseAndHandleTool)
+ *     return completion;
+ *   },
+ *   {
+ *     shouldStop: (completion) => !completion.tool_calls,
+ *   },
+ * ),
+ *
+ * @example
+ * // 不传递 shouldStop，执行 3 次后正常返回最后结果
+ * loopUntil(
+ *   () => {
+ *     return doSomething();
+ *   },
+ *   {
+ *     maxRetries: 3,
+ *   },
+ * ),
+ */
+export declare const loopUntil: <T>(fn: (count: number) => T | Promise<T>, options?: {
+    /**
+     * 最大循环次数
+     * @default 5
+     */
+    maxRetries?: number;
+    /** 停止循环条件。如果未传递，则执行 maxRetries 次后退出并返回最后结果 */
+    shouldStop?: (result: T) => boolean;
+}) => Promise<T>;

package/dist/hoc/index.d.ts

@@ -1 +1 @@
-export { type SetTtl, withCache } from "./withCache";
+export * from "./with-cache";

package/dist/hoc/with-cache.d.ts

@@ -0,0 +1,42 @@
+export type SetTtl = (seconds: number) => void;
+/**
+ * 创建一个带缓存的高阶函数
+ *
+ * @template Args 被包装函数的参数类型数组
+ * @template Result 被包装函数的返回类型
+ *
+ * @param fn 需要被缓存的函数，参数里附带的 setTtl 方法用于根据具体情况改写过期时间
+ * @param ttlSeconds 以秒为单位的过期时间，-1 表示永不过期，默认 -1，会被回调函数里的 setTtl() 覆盖
+ *
+ * @returns 返回包装后的函数，以及缓存相关的额外方法
+ *
+ * @example
+ * // 异步函数示例
+ * const fetchData = withCache(async function (url: string) {
+ *   const data = await fetch(url).then((res) => res.json());
+ *   this.setTtl(data.expiresIn); // 根据实际情况调整过期时间
+ *   return data;
+ * });
+ *
+ * await fetchData(urlA);
+ * await fetchData(urlA); // 使用缓存结果
+ * await fetchData(urlB);
+ * await fetchData(urlB); // 使用缓存结果
+ *
+ * fetchData.clear(); // 清除缓存
+ * await fetchData(urlA); // 重新请求
+ * await fetchData(urlB); // 重新请求
+ *
+ * // 缓存过期前
+ * await sleep();
+ * fetchData.updateTtl(180);  // 更新 ttl 并为所有未过期的缓存续期
+ * await fetchData(urlA); // 使用缓存结果
+ * await fetchData(urlB); // 使用缓存结果
+ */
+export declare const withCache: <Args extends any[], Result>(fn: (this: {
+    setTtl: SetTtl;
+}, ...args: Args) => Result, ttlSeconds?: number) => {
+    (...args: Args): Result;
+    clear(): void;
+    updateTtl(seconds: number): void;
+};

package/dist/index.js

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

package/dist/is/index.d.ts

@@ -1,5 +1,4 @@
-export { type Falsy, isFalsy } from "./isFalsy";
-export { isNil } from "./isNil";
-export { isObject } from "./isObject";
-export { isPrimitive, type Primitive } from "./isPrimitive";
-export { isTruthy } from "./isTruthy";
+export * from "./is-falsy";
+export * from "./is-nil";
+export * from "./is-object";
+export * from "./is-primitive";

package/dist/is/is-falsy.d.ts

@@ -0,0 +1,9 @@
+export type Falsy = false | 0 | -0 | 0n | "" | null | undefined;
+/**
+ * 检测传入的值是否为**假值**（false、0、''、null、undefined、NaN等）
+ *
+ * @example
+ * isFalsy(""); // true
+ * isFalsy(1); // false
+ */
+export declare const isFalsy: (value: any) => value is Falsy;

package/dist/is/is-nil.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 检测传入的值是否为**空值**（null、undefined）
+ *
+ * @example
+ * isNil(null); // true
+ * isNil(undefined); // true
+ * isNil(1); // false
+ */
+export declare const isNil: (value: any) => value is null | undefined;

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

@@ -0,0 +1,8 @@
+/**
+ * 检测传入的值是否为**普通对象**
+ *
+ * @example
+ * const obj = { a: 1 };
+ * isObject(obj); // true
+ */
+export declare const isObject: (value: any) => value is Record<string, any>;

package/dist/is/is-primitive.d.ts

@@ -0,0 +1,9 @@
+export type Primitive = number | string | boolean | symbol | bigint | undefined | null;
+/**
+ * 检测传入的值是否为**原始值**（number、string、boolean、symbol、bigint、undefined、null）
+ *
+ * @example
+ * isPrimitive(1);  // true
+ * isPrimitive([]); // false
+ */
+export declare const isPrimitive: (value: any) => value is Primitive;

package/dist/network/get-real-url.d.ts

@@ -0,0 +1,2 @@
+/** 从 url 响应头获取真实链接 */
+export declare const getRealURL: (originURL: string) => Promise<string>;

package/dist/network/index.d.ts

@@ -1,4 +1,4 @@
-export { type BunFetchOptions, fetcher, type RequestInit } from "./fetcher";
-export { getRealURL } from "./getRealURL";
-export { type ImageCompressionOptions, imageUrlToBase64 } from "./image";
-export { to } from "./to";
+export * from "./fetcher";
+export * from "./get-real-url";
+export * from "./image";
+export * from "./to";

package/dist/number/index.d.ts

@@ -1 +1 @@
-export { randomInt } from "./randomInt";
+export * from "./random-int";

package/dist/number/random-int.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 在指定闭区间内生成随机整数
+ *
+ * @example
+ * randomInt(1, 10);    // 1 <= x <= 10
+ */
+export declare const randomInt: (min: number, max: number) => number;

package/dist/object/index.d.ts

@@ -1,3 +1,3 @@
-export { type DeepMapKeys, mapKeys } from "./mapKeys";
-export { type DeepMapValues, mapValues } from "./mapValues";
-export { mergeObjects } from "./mergeObjects";
+export * from "./map-keys";
+export * from "./map-values";
+export * from "./merge-objects";

package/dist/object/map-keys.d.ts

@@ -0,0 +1,17 @@
+export type DeepMapKeys<T> = T extends Array<infer U> ? Array<DeepMapKeys<U>> : T extends object ? {
+    [key: string]: DeepMapKeys<T[keyof T]>;
+} : T;
+/**
+ * 递归处理对象里的 key
+ *
+ * @remarks
+ * 无法完整推导出类型，只能做到有递归，key 全为 string，value 为同层级的所有类型的联合
+ *
+ * @template T 要转换的对象
+ *
+ * @example
+ * const obj = { a: { b: 1 } };
+ * const result = mapKeys(obj, (key) => key.toUpperCase());
+ * console.log(result); // { A: { B: 1 } }
+ */
+export declare const mapKeys: <T>(obj: T, getNewKey: (key: string) => string) => DeepMapKeys<T>;

package/dist/object/map-values.d.ts

@@ -0,0 +1,21 @@
+export 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
+ *
+ * @remarks
+ * 无法完整推导出类型，所有 value 最终都会变为 any
+ *
+ * @template T 要转换的对象
+ * @template R 转换后的值类型，为 any，无法进一步推导
+ *
+ * @example
+ * const obj = { a: 1, b: { c: 2 } };
+ * const result = mapValues(obj, (value, key) => isPrimitive(value) ? value + 1 : value);
+ * console.log(result); // { a: 2, b: { c: 3 } }
+ */
+export declare const mapValues: <T, R = any>(obj: T, getNewValue: (value: any, key: string | number) => R, options?: {
+    /** 过滤函数，返回 true 表示保留该字段 */
+    filter?: (value: any, key: string | number) => boolean;
+}) => DeepMapValues<T, R>;

package/dist/object/merge-objects.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 深度合并两个对象，规则如下：
+ * 1. 原始值覆盖：如果两个值都是原始类型，则用后者覆盖;
+ * 2. 数组拼接：如果两个值都是数组，则拼接为大数组；
+ * 3. 对象递归合并：如果两个值都是对象，则进行递归深度合并；
+ *
+ * @template T 第一个对象
+ * @template U 第二个对象
+ * @param {T} obj1 要合并的第一个对象，相同字段会被 obj2 覆盖
+ * @param {U} obj2 要合并的第二个对象
+ */
+export declare const mergeObjects: <T extends Record<string, any>, U extends Record<string, any>>(obj1: T, obj2: U) => T & U;

package/dist/string/index.d.ts

@@ -1,2 +1,2 @@
-export { type CamelToSnake, type Capitalize, camelToSnake, capitalize, type Decapitalize, decapitalize, type SnakeToCamel, snakeToCamel, } from "./case";
-export { compactStr } from "./compact";
+export * from "./case";
+export * from "./compact";

package/dist/time/index.d.ts

@@ -1,3 +1,3 @@
-export { debounce } from "./debounce";
-export { sleep } from "./sleep";
-export { throttle } from "./throttle";
+export * from "./debounce";
+export * from "./sleep";
+export * from "./throttle";

package/docs/assets/navigation.js

@@ -1 +1 @@
-window.navigationData = "eJyFlE1v2zAMhv8Lz8G8FVmH+dgUBYJm7ZA4uww7qAoba9WHZ9Hb0qH/fahdAbFASVc/fh9IFMnv/4DwL0ENV4O9QZLtfUfKWQ8L6AS1UAOdOvRVhN+1ZDQs4EnZA9QX7z9/+vDx4mURbLASBnXjdlY8Yaw6ZyXPSnSKhFbPsaUK5LnkgGuUKUt1zkqea8Tui+hu8RRXpwoIT6XKBMs3oQdMeSZYMt0I7U+xYfxYSq6NOOLKma5H75WziTdP/Fayf+2VUaR+x8WuAihVGrb4a0BPa6sodgRkFZUsO6SGdCyYvpayY3M2bmzV2HDOSh7JzsHjYOVYykqmZqG+XM40cQPPJXwLzxXOdELSjnpWEWifUkANB3xwg5XsGQLLxvPXOKRmca55fF1DyN7iDaXCUMMRaYtC77cbLh/odpNSQA3qdSr2vW7clfB4ueRE8T85nY/mOFh89Yay4Tul+eid0tng/cNPlMRnJ5aNx0MeGRKjHkmafqA2cfWJpeJQg3au21vi7x9grgYm3uUh7ivD7fI4HK/wWZxb4XMB9kecCs07ApeU0/TCHpxZW/YlA8w9pdeIHRceQS7IrsiQ95VPrcm5htreEWm2jwLLxZXBjTuy6Qnlwo7NuVQEavijqF0J2bLnDTA+8PLlx38s7iys"
+window.navigationData = "eJyFlE1v2zAMhv8Lz8G8FWmK+dgUBYKl7ZCPXYYdVIWxtcqSZjHb0qH/fYhTATGhj6sfv48tiuT3f0D4l6CGpW2eHClrPEzACWqhBmUI+72Q6KuAjf/QUqdhAi/K7KC+up69TYIEbg/mHkm23AR0dOgrhpnp4+ebT9dXwQY1zEWHemPXRrwgV12ykmcunCKh1Su3VIG8lhxwhzJlqS5ZyXOH6B6E+4JHXp0qIDyWKhMs34Q+YMpzhiXTvdD+yA3Dw1Jy0YkG57ZzPXqvrEnceeK1kv1rrzpF6jcvdhVAqdKwwl8H9LQwirgjIKOoZFkjbUhzwflpKTs058YOrcoNl6zkkdE52B+MHEpZydQs1LPpSMMbeCyJt/BYYTsnJK2pjyoC7VMKqGGHz/ZgZPQfAsvG88fYpWZxrNmf1hBGT/GOUmGooUFaodDb1TKWD3S1TClOm/U0Fdteb+yt8DibxkT8nZzOszkOFl+9o2z4Uel49FHpbPDp+SdKimfPLBvnQ84MiVEfSbRtYmFtm2zIuq2h+KkDzJ284xs8xH3VxTY4D/PFPYrHFvdYgH2D5/LGHYFLyml6YXa2W5jo/QWYu0CvEV0sPIBcMLoYQ95XPrUcxxpqe0uko90TWC5uo0GbikANfxS1cyHb6CcD5N+cvv34D7ugK1A="

package/docs/assets/search.js

@@ -1 +1 @@
-window.searchData = "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";
+window.searchData = "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";

package/docs/functions/camelToSnake.html

@@ -160,7 +160,7 @@
 </div><section class="tsd-panel"><h4>Type Parameters</h4><ul class="tsd-type-parameter-list"><li><span id="cameltosnakes"><span class="tsd-kind-type-parameter">S</span> <span class="tsd-signature-keyword">extends</span> <span class="tsd-signature-type">string</span></span></li></ul></section><div class="tsd-parameters"><h4 class="tsd-parameters-title">Parameters</h4><ul class="tsd-parameter-list"><li><span><span class="tsd-kind-parameter">str</span>: <a class="tsd-signature-type tsd-kind-type-parameter" href="#cameltosnakes">S</a></span></li></ul></div><h4 class="tsd-returns-title">Returns <a href="../types/CamelToSnake.html" class="tsd-signature-type tsd-kind-type-alias">CamelToSnake</a><span class="tsd-signature-symbol">&lt;</span><a class="tsd-signature-type tsd-kind-type-parameter" href="#cameltosnakes">S</a><span class="tsd-signature-symbol">&gt;</span></h4><div class="tsd-comment tsd-typography"><div class="tsd-tag-example"><h4 class="tsd-anchor-link" id="example">Example<a href="#example" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4><pre><code class="ts"><span class="hl-1">camelToSnake</span><span class="hl-2">(</span><span class="hl-3">&quot;shouldComponentUpdate&quot;</span><span class="hl-2">) </span><span class="hl-0">// &quot;should_component_update&quot;</span>
 </code><button type="button">Copy</button></pre>
 
-</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/Nickyzj628/utils/blob/cc85f746fa4c51a9ce99a26858677ea7ee8557a3/src/string/case.ts#L33">string/case.ts:33</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">@nickyzj2023/utils</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div><script>
+</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/Nickyzj628/utils/blob/5c8635da5062e64964cf6710e2001e90b0fcbfe4/src/string/case.ts#L33">string/case.ts:33</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">@nickyzj2023/utils</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div><script>
           try {
             const generateLinkElement = document.querySelector(".tsd-generator a");
             const link = document.createElement("a");

package/docs/functions/capitalize.html

@@ -160,7 +160,7 @@
 </div><section class="tsd-panel"><h4>Type Parameters</h4><ul class="tsd-type-parameter-list"><li><span id="capitalizes"><span class="tsd-kind-type-parameter">S</span> <span class="tsd-signature-keyword">extends</span> <span class="tsd-signature-type">string</span></span></li></ul></section><div class="tsd-parameters"><h4 class="tsd-parameters-title">Parameters</h4><ul class="tsd-parameter-list"><li><span><span class="tsd-kind-parameter">s</span>: <a class="tsd-signature-type tsd-kind-type-parameter" href="#capitalizes">S</a></span></li></ul></div><h4 class="tsd-returns-title">Returns <a href="../types/Capitalize.html" class="tsd-signature-type tsd-kind-type-alias">Capitalize</a><span class="tsd-signature-symbol">&lt;</span><a class="tsd-signature-type tsd-kind-type-parameter" href="#capitalizes">S</a><span class="tsd-signature-symbol">&gt;</span></h4><div class="tsd-comment tsd-typography"><div class="tsd-tag-example"><h4 class="tsd-anchor-link" id="example">Example<a href="#example" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4><pre><code class="ts"><span class="hl-1">capitalize</span><span class="hl-2">(</span><span class="hl-3">&quot;hello&quot;</span><span class="hl-2">) </span><span class="hl-0">// &quot;Hello&quot;</span>
 </code><button type="button">Copy</button></pre>
 
-</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/Nickyzj628/utils/blob/cc85f746fa4c51a9ce99a26858677ea7ee8557a3/src/string/case.ts#L52">string/case.ts:52</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">@nickyzj2023/utils</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div><script>
+</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/Nickyzj628/utils/blob/5c8635da5062e64964cf6710e2001e90b0fcbfe4/src/string/case.ts#L52">string/case.ts:52</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">@nickyzj2023/utils</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div><script>
           try {
             const generateLinkElement = document.querySelector(".tsd-generator a");
             const link = document.createElement("a");

package/docs/functions/compactStr.html

@@ -164,7 +164,7 @@
 </div></li></ul></li></ul></div><h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">string</span></h4><div class="tsd-comment tsd-typography"><div class="tsd-tag-example"><h4 class="tsd-anchor-link" id="example">Example<a href="#example" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4><pre><code class="ts"><span class="hl-0">// &quot;Hello, world.&quot;</span><br/><span class="hl-1">compactStr</span><span class="hl-2">(</span><span class="hl-3">`</span><br/><span class="hl-3">  Hello,</span><br/><span class="hl-3">       world!</span><br/><span class="hl-3">`</span><span class="hl-2">, {</span><br/><span class="hl-2"> </span><span class="hl-5">disableNewLineReplace:</span><span class="hl-2"> </span><span class="hl-6">false</span><span class="hl-2">,</span><br/><span class="hl-2">});</span>
 </code><button type="button">Copy</button></pre>
 
-</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/Nickyzj628/utils/blob/cc85f746fa4c51a9ce99a26858677ea7ee8557a3/src/string/compact.ts#L13">string/compact.ts:13</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">@nickyzj2023/utils</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div><script>
+</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/Nickyzj628/utils/blob/5c8635da5062e64964cf6710e2001e90b0fcbfe4/src/string/compact.ts#L13">string/compact.ts:13</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">@nickyzj2023/utils</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div><script>
           try {
             const generateLinkElement = document.querySelector(".tsd-generator a");
             const link = document.createElement("a");

package/docs/functions/debounce.html

@@ -169,7 +169,7 @@
 </div><div class="tsd-tag-example"><h4 class="tsd-anchor-link" id="example">Example<a href="#example" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4><pre><code class="ts"><span class="hl-6">const</span><span class="hl-2"> </span><span class="hl-7">search</span><span class="hl-2"> = </span><span class="hl-1">debounce</span><span class="hl-2">((</span><span class="hl-5">keyword</span><span class="hl-2">: </span><span class="hl-8">string</span><span class="hl-2">) </span><span class="hl-6">=&gt;</span><span class="hl-2"> {</span><br/><span class="hl-2">  </span><span class="hl-5">console</span><span class="hl-2">.</span><span class="hl-1">log</span><span class="hl-2">(</span><span class="hl-3">&#39;搜索:&#39;</span><span class="hl-2">, </span><span class="hl-5">keyword</span><span class="hl-2">);</span><br/><span class="hl-2">});</span><br/><span class="hl-1">search</span><span class="hl-2">(</span><span class="hl-3">&#39;hello&#39;</span><span class="hl-2">); </span><span class="hl-0">// 300ms 后执行</span>
 </code><button type="button">Copy</button></pre>
 
-</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/Nickyzj628/utils/blob/cc85f746fa4c51a9ce99a26858677ea7ee8557a3/src/time/debounce.ts#L20">time/debounce.ts:20</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">@nickyzj2023/utils</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div><script>
+</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/Nickyzj628/utils/blob/5c8635da5062e64964cf6710e2001e90b0fcbfe4/src/time/debounce.ts#L20">time/debounce.ts:20</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">@nickyzj2023/utils</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div><script>
           try {
             const generateLinkElement = document.querySelector(".tsd-generator a");
             const link = document.createElement("a");

package/docs/functions/decapitalize.html

@@ -160,7 +160,7 @@
 </div><section class="tsd-panel"><h4>Type Parameters</h4><ul class="tsd-type-parameter-list"><li><span id="decapitalizes"><span class="tsd-kind-type-parameter">S</span> <span class="tsd-signature-keyword">extends</span> <span class="tsd-signature-type">string</span></span></li></ul></section><div class="tsd-parameters"><h4 class="tsd-parameters-title">Parameters</h4><ul class="tsd-parameter-list"><li><span><span class="tsd-kind-parameter">s</span>: <a class="tsd-signature-type tsd-kind-type-parameter" href="#decapitalizes">S</a></span></li></ul></div><h4 class="tsd-returns-title">Returns <a href="../types/Decapitalize.html" class="tsd-signature-type tsd-kind-type-alias">Decapitalize</a><span class="tsd-signature-symbol">&lt;</span><a class="tsd-signature-type tsd-kind-type-parameter" href="#decapitalizes">S</a><span class="tsd-signature-symbol">&gt;</span></h4><div class="tsd-comment tsd-typography"><div class="tsd-tag-example"><h4 class="tsd-anchor-link" id="example">Example<a href="#example" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4><pre><code class="ts"><span class="hl-1">decapitalize</span><span class="hl-2">(</span><span class="hl-3">&quot;Hello&quot;</span><span class="hl-2">) </span><span class="hl-0">// &quot;hello&quot;</span>
 </code><button type="button">Copy</button></pre>
 
-</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/Nickyzj628/utils/blob/cc85f746fa4c51a9ce99a26858677ea7ee8557a3/src/string/case.ts#L69">string/case.ts:69</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">@nickyzj2023/utils</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div><script>
+</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/Nickyzj628/utils/blob/5c8635da5062e64964cf6710e2001e90b0fcbfe4/src/string/case.ts#L69">string/case.ts:69</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">@nickyzj2023/utils</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div><script>
           try {
             const generateLinkElement = document.querySelector(".tsd-generator a");
             const link = document.createElement("a");

package/docs/functions/fetcher.html

@@ -171,7 +171,7 @@
 </div><div class="tsd-tag-example"><h4 class="tsd-anchor-link" id="example">Example<a href="#example" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4><pre><code class="ts"><span class="hl-0">// 用法1：直接发送请求</span><br/><span class="hl-6">const</span><span class="hl-2"> </span><span class="hl-7">res</span><span class="hl-2"> = </span><span class="hl-4">await</span><span class="hl-2"> </span><span class="hl-1">fetcher</span><span class="hl-2">().</span><span class="hl-1">get</span><span class="hl-2">&lt;</span><span class="hl-8">Blog</span><span class="hl-2">&gt;(</span><span class="hl-3">&quot;https://nickyzj.run:3030/blogs/hello-world&quot;</span><span class="hl-2">);</span><br/><br/><span class="hl-0">// 用法2：创建实例</span><br/><span class="hl-6">const</span><span class="hl-2"> </span><span class="hl-7">api</span><span class="hl-2"> = </span><span class="hl-1">fetcher</span><span class="hl-2">(</span><span class="hl-3">&quot;https://nickyzj.run:3030&quot;</span><span class="hl-2">, { </span><span class="hl-5">headers:</span><span class="hl-2"> { </span><span class="hl-5">Authorization:</span><span class="hl-2"> </span><span class="hl-3">&quot;Bearer token&quot;</span><span class="hl-2"> } });</span><br/><span class="hl-6">const</span><span class="hl-2"> </span><span class="hl-7">res</span><span class="hl-2"> = </span><span class="hl-4">await</span><span class="hl-2"> </span><span class="hl-5">api</span><span class="hl-2">.</span><span class="hl-1">get</span><span class="hl-2">&lt;</span><span class="hl-8">Blog</span><span class="hl-2">&gt;(</span><span class="hl-3">&quot;/blogs/hello-world&quot;</span><span class="hl-2">, { </span><span class="hl-5">headers:</span><span class="hl-2"> {...}, </span><span class="hl-5">params:</span><span class="hl-2"> { </span><span class="hl-5">page:</span><span class="hl-2"> </span><span class="hl-9">1</span><span class="hl-2"> } });  </span><span class="hl-0">// 与实例相同的 headers 会覆盖上去，params 会转成 ?page=1 跟到 url 后面</span><br/><br/><span class="hl-0">// 用法3：使用代理（仅 Bun 环境）</span><br/><span class="hl-6">const</span><span class="hl-2"> </span><span class="hl-7">api</span><span class="hl-2"> = </span><span class="hl-1">fetcher</span><span class="hl-2">(</span><span class="hl-3">&quot;https://api.example.com&quot;</span><span class="hl-2">, {</span><br/><span class="hl-2">  </span><span class="hl-5">proxy:</span><span class="hl-2"> </span><span class="hl-3">&quot;http://127.0.0.1:7890&quot;</span><br/><span class="hl-2">});</span><br/><br/><span class="hl-0">// 安全处理请求结果</span><br/><span class="hl-6">const</span><span class="hl-2"> [</span><span class="hl-7">error</span><span class="hl-2">, </span><span class="hl-7">data</span><span class="hl-2">] = </span><span class="hl-4">await</span><span class="hl-2"> </span><span class="hl-1">to</span><span class="hl-2">(</span><span class="hl-5">api</span><span class="hl-2">.</span><span class="hl-1">get</span><span class="hl-2">&lt;</span><span class="hl-8">Blog</span><span class="hl-2">&gt;(</span><span class="hl-3">&quot;/blogs/hello-world&quot;</span><span class="hl-2">));</span><br/><span class="hl-4">if</span><span class="hl-2"> (</span><span class="hl-5">error</span><span class="hl-2">) {</span><br/><span class="hl-2">  </span><span class="hl-5">console</span><span class="hl-2">.</span><span class="hl-1">error</span><span class="hl-2">(</span><span class="hl-5">error</span><span class="hl-2">);</span><br/><span class="hl-2">  </span><span class="hl-4">return</span><span class="hl-2">;</span><br/><span class="hl-2">}</span><br/><span class="hl-5">console</span><span class="hl-2">.</span><span class="hl-1">log</span><span class="hl-2">(</span><span class="hl-5">data</span><span class="hl-2">);</span><br/><br/><span class="hl-0">// 缓存请求结果</span><br/><span class="hl-6">const</span><span class="hl-2"> </span><span class="hl-7">getBlogs</span><span class="hl-2"> = </span><span class="hl-1">withCache</span><span class="hl-2">(</span><span class="hl-5">api</span><span class="hl-2">.</span><span class="hl-5">get</span><span class="hl-2">);</span><br/><span class="hl-4">await</span><span class="hl-2"> </span><span class="hl-1">getBlogs</span><span class="hl-2">(</span><span class="hl-3">&quot;/blogs&quot;</span><span class="hl-2">);</span><br/><span class="hl-4">await</span><span class="hl-2"> </span><span class="hl-1">sleep</span><span class="hl-2">();</span><br/><span class="hl-4">await</span><span class="hl-2"> </span><span class="hl-1">getBlogs</span><span class="hl-2">(</span><span class="hl-3">&quot;/blogs&quot;</span><span class="hl-2">);  </span><span class="hl-0">// 不发请求，使用缓存</span>
 </code><button type="button">Copy</button></pre>
 
-</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/Nickyzj628/utils/blob/cc85f746fa4c51a9ce99a26858677ea7ee8557a3/src/network/fetcher.ts#L59">network/fetcher.ts:59</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">@nickyzj2023/utils</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div><script>
+</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/Nickyzj628/utils/blob/5c8635da5062e64964cf6710e2001e90b0fcbfe4/src/network/fetcher.ts#L60">network/fetcher.ts:60</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">@nickyzj2023/utils</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div><script>
           try {
             const generateLinkElement = document.querySelector(".tsd-generator a");
             const link = document.createElement("a");