@nickyzj2023/utils 1.0.51 → 1.0.53

package/dist/dom/index.d.ts

@@ -0,0 +1 @@
+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/{src/dom/timeLog.ts → dist/dom/timeLog.d.ts}

@@ -1,10 +1,8 @@
-/**
- * 附带时间的 console.log
- * @param args
- *
- * @example
- * timeLog("Hello", "World"); // 14:30:00 Hello World
- */
-export const timeLog = (...args: any[]) => {
-	console.log(`${new Date().toLocaleTimeString()}`, ...args);
-};
+/**
+ * 附带时间的 console.log
+ * @param args
+ *
+ * @example
+ * timeLog("Hello", "World"); // 14:30:00 Hello World
+ */
+export declare const timeLog: (...args: any[]) => void;

package/dist/function/index.d.ts

@@ -0,0 +1 @@
+export * from "./loop-until";

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

@@ -0,0 +1,22 @@
+/**
+ * 循环执行函数，直到符合停止条件
+ *
+ * @example
+ * // 循环请求大语言模型，直到其不再调用工具
+ * loopUntil(
+ *   async () => {
+ *     const completion = await chatCompletions();
+ *     completion.tool_calls?.forEach(chooseAndHandleTool)
+ *     return completion;
+ *   },
+ *   {
+ *     shouldStop: (completion) => !completion.tool_calls,
+ *   },
+ * ),
+ */
+export declare const loopUntil: <T>(fn: (count: number) => Promise<T>, options?: {
+    /** 最大循环次数，默认 5 次 */
+    maxRetries?: number;
+    /** 停止循环条件，默认立即停止 */
+    shouldStop?: (result: T) => boolean;
+}) => Promise<T>;

package/dist/function/loopUntil.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 循环执行函数，直到符合停止条件
+ *
+ * @example
+ * // 循环请求大语言模型，直到其不再调用工具
+ * loopUntil(
+ *   async () => {
+ *     const completion = await chatCompletions();
+ *     completion.tool_calls?.forEach(chooseAndHandleTool)
+ *     return completion;
+ *   },
+ *   {
+ *     shouldStop: (completion) => !completion.tool_calls,
+ *   },
+ * ),
+ */
+export declare const loopUntil: <T>(fn: (count: number) => Promise<T>, options?: {
+    /** 最大循环次数，默认 5 次 */
+    maxRetries?: number;
+    /** 停止循环条件，默认立即停止 */
+    shouldStop?: (result: T) => boolean;
+}) => Promise<T>;

package/dist/hoc/index.d.ts

@@ -0,0 +1 @@
+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/hoc/withCache.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.d.ts

@@ -0,0 +1,9 @@
+export * from "./dom";
+export * from "./function";
+export * from "./hoc";
+export * from "./is";
+export * from "./network";
+export * from "./number";
+export * from "./object";
+export * from "./string";
+export * from "./time";

package/dist/index.js

@@ -0,0 +1,3 @@
+// @bun
+var O=(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=()=>!0}=Y??{};for(let M=0;M<T;M++){let E=await x(M);if(G(E))return E}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 k=(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 S=async(x)=>{try{return[null,await x]}catch(Y){return[Y,void 0]}};var _x=async(x)=>{let[Y,T]=await S(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)},R=async()=>{try{let Y=await Function("modulePath","return import(modulePath)")("sharp");return Y.default||Y}catch{return null}},f=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 q=await(await z.convertToBlob({type:J,quality:T})).arrayBuffer(),K=D(q);return`data:${J};base64,${K}`}catch{X?.close();let _=D(P);return`data:${J};base64,${_}`}}let Q=await R();if(Q)try{return await f(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 Rx=(x)=>{return x.replace(/_([a-zA-Z])/g,(Y,T)=>T.toUpperCase())},fx=(x)=>{return x.replace(/([A-Z])/g,(Y,T)=>`_${T.toLowerCase()}`)},Ax=(x)=>{return x.charAt(0).toUpperCase()+x.slice(1)},Ox=(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 hx=(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{k as withCache,S as to,mx as throttle,Rx as snakeToCamel,gx as sleep,dx as randomInt,H as mergeObjects,d as mapValues,F as mapKeys,N as loopUntil,O as log,C as isPrimitive,Z as isObject,I as isNil,j as isFalsy,zx as imageUrlToBase64,_x as getRealURL,Px as fetcher,Ox as decapitalize,hx as debounce,Ux as compactStr,Ax as capitalize,fx as camelToSnake};

package/dist/is/index.d.ts

@@ -0,0 +1,4 @@
+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/is/isFalsy.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/isNil.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/isObject.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/isPrimitive.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/{src/is/isTruthy.ts → dist/is/isTruthy.d.ts}

@@ -1,10 +1,8 @@
-/**
- * 检测传入的值是否为**真值**
- *
- * @example
- * isTruthy(1); // true
- * isTruthy(""); // false
- */
-export const isTruthy = (value: any): value is any => {
-	return !!value;
-};
+/**
+ * 检测传入的值是否为**真值**
+ *
+ * @example
+ * isTruthy(1); // true
+ * isTruthy(""); // false
+ */
+export declare const isTruthy: (value: any) => value is any;

package/dist/lru-cache.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 简易 LRU 缓存
+ * @example
+ * const cache = new LRUCache<string, number>(2);
+ * cache.set("a", 1);
+ * cache.set("b", 2);
+ * cache.set("c", 3);    // 缓存已满，a 被淘汰
+ * cache.get("a");    // undefined
+ */
+declare class LRUCache<K, V> {
+    private cache;
+    private maxSize;
+    constructor(maxSize?: number);
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    has(key: K): boolean;
+}
+export default LRUCache;

package/dist/network/fetcher.d.ts

@@ -0,0 +1,56 @@
+export type BunFetchOptions = {
+    /** 代理服务器配置（仅 Bun 支持） */
+    proxy?: string;
+};
+export type RequestInit = globalThis.RequestInit & BunFetchOptions & {
+    params?: Record<string, any>;
+    parser?: (response: Response) => Promise<any>;
+};
+/**
+ * 基于 Fetch API 的请求客户端
+ * @param baseURL 接口前缀
+ * @param baseOptions 客户端级别的请求体，后续调用时传递相同参数会覆盖上去
+ *
+ * @remarks
+ * 特性：
+ * - 合并实例、调用时的相同请求体
+ * - 在 params 里传递对象，自动转换为 queryString
+ * - 在 body 里传递对象，自动 JSON.stringify
+ * - 可选择使用 to() 转换请求结果为 [Error, Response]
+ * - 可选择使用 withCache() 缓存请求结果
+ * - 支持 proxy 选项（仅在 Bun 环境有效）
+ *
+ * @example
+ *
+ * // 用法1：直接发送请求
+ * const res = await fetcher().get<Blog>("https://nickyzj.run:3030/blogs/hello-world");
+ *
+ * // 用法2：创建实例
+ * const api = fetcher("https://nickyzj.run:3030", { headers: { Authorization: "Bearer token" } });
+ * const res = await api.get<Blog>("/blogs/hello-world", { headers: {...}, params: { page: 1 } });  // 与实例相同的 headers 会覆盖上去，params 会转成 ?page=1 跟到 url 后面
+ *
+ * // 用法3：使用代理（仅 Bun 环境）
+ * const api = fetcher("https://api.example.com", {
+ *   proxy: "http://127.0.0.1:7890"
+ * });
+ *
+ * // 安全处理请求结果
+ * const [error, data] = await to(api.get<Blog>("/blogs/hello-world"));
+ * if (error) {
+ *   console.error(error);
+ *   return;
+ * }
+ * console.log(data);
+ *
+ * // 缓存请求结果
+ * const getBlogs = withCache(api.get);
+ * await getBlogs("/blogs");
+ * await sleep();
+ * await getBlogs("/blogs");  // 不发请求，使用缓存
+ */
+export 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>;
+};

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

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

package/dist/network/getRealURL.d.ts

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

package/dist/network/image.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 图片压缩选项
+ */
+export 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>;
+};
+/**
+ * 图片地址转 base64 数据
+ *
+ * @param imageUrl 图片地址
+ * @param options 可选配置
+ * @param options.quality 压缩比率，默认 0.92
+ * @param options.compressor 自定义压缩函数，用于覆盖默认压缩行为
+ *
+ * @example
+ * // 基本用法（浏览器自动使用 Canvas 压缩，Node.js/Bun 自动检测并使用 sharp）
+ * imageUrlToBase64("https://example.com/image.jpg");
+ *
+ * @example
+ * // 使用自定义 fetch 函数（如 axios 封装）
+ * imageUrlToBase64("https://example.com/image.jpg", {
+ *   fetcher: async (url) => {
+ *     // 使用 axios 或其他请求库，但必须返回 Response 对象
+ *     const response = await axios.get(url, { responseType: 'arraybuffer' });
+ *     return new Response(response.data, {
+ *       status: response.status,
+ *       statusText: response.statusText,
+ *       headers: response.headers
+ *     });
+ *   }
+ * });
+ *
+ * @example
+ * // 使用自定义压缩函数覆盖默认行为
+ * imageUrlToBase64("https://example.com/image.jpg", {
+ *   quality: 0.8,
+ *   compressor: async (buffer, mime, quality) => {
+ *     // 自定义压缩逻辑
+ *     return `data:${mime};base64,...`;
+ *   }
+ * });
+ */
+export declare const imageUrlToBase64: (imageUrl: string, options?: ImageCompressionOptions) => Promise<string>;

package/dist/network/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./fetcher";
+export * from "./get-real-url";
+export * from "./image";
+export * from "./to";

package/dist/network/to.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Go 语言风格的异步处理方式
+ * @param promise 一个能被 await 的异步函数
+ * @returns 如果成功，返回 [null, 异步函数结果]，否则返回 [Error, undefined]
+ *
+ * @example
+ * const [error, response] = await to(fetcher().get<Blog>("/blogs/hello-world"));
+ */
+export declare const to: <T, E = Error>(promise: Promise<T>) => Promise<[null, T] | [E, undefined]>;

package/dist/number/index.d.ts

@@ -0,0 +1 @@
+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/number/randomInt.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

@@ -0,0 +1,3 @@
+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/mapKeys.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/mapValues.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/object/mergeObjects.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;