@nickyzj2023/utils 1.0.46 → 1.0.48

package/dist/string.d.ts

@@ -1,70 +0,0 @@
-export type SnakeToCamel<S extends string> = S extends `${infer Before}_${infer After}` ? After extends `${infer First}${infer Rest}` ? `${Before}${Uppercase<First>}${SnakeToCamel<Rest>}` : Before : S;
-/**
- * 下划线命名法转为驼峰命名法
- *
- * @example
- * snakeToCamel("user_name") // "userName"
- */
-export declare const snakeToCamel: <S extends string>(str: S) => SnakeToCamel<S>;
-export type CamelToSnake<S extends string> = S extends `${infer First}${infer Rest}` ? Rest extends Uncapitalize<Rest> ? `${Lowercase<First>}${CamelToSnake<Rest>}` : `${Lowercase<First>}_${CamelToSnake<Rest>}` : Lowercase<S>;
-/**
- * 驼峰命名法转为下划线命名法
- *
- * @example
- * camelToSnake("shouldComponentUpdate") // "should_component_update"
- */
-export declare const camelToSnake: <S extends string>(str: S) => CamelToSnake<S>;
-export type Capitalize<S extends string> = S extends `${infer P1}${infer Rest}` ? P1 extends Capitalize<P1> ? S : `${Uppercase<P1>}${Rest}` : S;
-/**
- * 字符串首字母大写
- *
- * @example
- * capitalize("hello") // "Hello"
- */
-export declare const capitalize: <S extends string>(s: S) => Capitalize<S>;
-export type Decapitalize<S extends string> = S extends `${infer P1}${infer Rest}` ? P1 extends Lowercase<P1> ? P1 : `${Lowercase<P1>}${Rest}` : S;
-/**
- * 字符串首字母小写
- *
- * @example
- * decapitalize("Hello") // "hello"
- */
-export declare const decapitalize: <S extends string>(s: S) => Decapitalize<S>;
-/**
- * 图片地址转 base64 数据
- *
- * @param imageUrl 图片地址
- * @param options 可选配置
- * @param options.quality 压缩比率，默认 0.92（仅在浏览器支持 canvas 压缩时有效）
- *
- * @example
- * imageUrlToBase64("https://example.com/image.gif"); // "data:image/gif;base64,..."
- *
- * @example
- * imageUrlToBase64("https://example.com/image.jpg", { quality: 0.8 }); // 压缩至 80% 质量
- */
-export declare const imageUrlToBase64: (imageUrl: string, { quality }?: {
-    quality?: number;
-}) => Promise<string>;
-/**
- * 将字符串压缩为单行精简格式
- *
- * @example
- * // "Hello, world."
- * compactStr(`
- *   Hello,
- *        world!
- * `, {
- *  disableNewLineReplace: false,
- * });
- */
-export declare const compactStr: (text?: string, options?: {
-    /** 最大保留长度，设为 0 或 Infinity 则不截断，默认 Infinity */
-    maxLength?: number;
-    /** 是否将换行符替换为字面量 \n，默认开启 */
-    disableNewLineReplace?: boolean;
-    /** 是否合并连续的空格/制表符为一个空格，默认开启 */
-    disableWhitespaceCollapse?: boolean;
-    /** 截断后的后缀，默认为 "..." */
-    omission?: string;
-}) => string;

package/dist/time.d.ts

@@ -1,47 +0,0 @@
-/**
- * 延迟一段时间再执行后续代码
- * @param time 延迟时间，默认 150ms
- * @example
- * await sleep(1000); // 等待 1 秒执行后续代码
- */
-export declare const sleep: (time?: number) => Promise<unknown>;
-/**
- * 防抖：在指定时间内只执行最后一次调用
- * @param fn 要防抖的函数
- * @param delay 延迟时间，默认 300ms
- *
- * @remarks
- * 连续触发时，只有最后一次会执行。适合用于搜索框输入、窗口大小调整等场景。
- * 例如：用户输入"hello"过程中，不会触发搜索，只有停下来时才执行。
- *
- * 防抖 vs 节流：
- * - 防抖：等待触发停止后才执行（最后一次）
- * - 节流：按固定节奏执行（每隔多久执行一次）
- *
- * @example
- * const search = debounce((keyword: string) => {
- *   console.log('搜索:', keyword);
- * });
- * search('hello'); // 300ms 后执行
- */
-export declare const debounce: <T extends (...args: any[]) => any>(fn: T, delay?: number) => (...args: Parameters<T>) => void;
-/**
- * 节流函数 - 在指定时间间隔内最多执行一次调用
- * @param fn 要节流的函数
- * @param delay 间隔时间，默认 300ms
- *
- * @remarks
- * 节流：连续触发时，按照固定间隔执行。适合用于滚动、拖拽等高频触发场景。
- * 例如：滚动页面时，每300ms最多执行一次回调，而不是每次滚动都执行。
- *
- * 防抖 vs 节流：
- * - 防抖：等待触发停止后才执行（最后一次）
- * - 节流：按固定节奏执行（每隔多久执行一次）
- *
- * @example
- * const handleScroll = throttle(() => {
- *   console.log('滚动位置:', window.scrollY);
- * }, 200);
- * window.addEventListener('scroll', handleScroll);
- */
-export declare const throttle: <T extends (...args: any[]) => any>(fn: T, delay?: number) => (this: any, ...args: Parameters<T>) => void;

package/dist/tsdoc-metadata.json

@@ -1,11 +0,0 @@
-// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
-// It should be published with your NPM package.  It should not be tracked by Git.
-{
-  "tsdocVersion": "0.12",
-  "toolPackages": [
-    {
-      "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.55.0"
-    }
-  ]
-}

package/src/string.ts

@@ -1,259 +0,0 @@
-export type SnakeToCamel<S extends string> =
-	S extends `${infer Before}_${infer After}`
-		? After extends `${infer First}${infer Rest}`
-			? `${Before}${Uppercase<First>}${SnakeToCamel<Rest>}`
-			: Before
-		: S;
-
-/**
- * 下划线命名法转为驼峰命名法
- *
- * @example
- * snakeToCamel("user_name") // "userName"
- */
-export const snakeToCamel = <S extends string>(str: S): SnakeToCamel<S> => {
-	return str.replace(/_([a-zA-Z])/g, (match, pattern) =>
-		pattern.toUpperCase(),
-	) as SnakeToCamel<S>;
-};
-
-export type CamelToSnake<S extends string> =
-	S extends `${infer First}${infer Rest}`
-		? Rest extends Uncapitalize<Rest>
-			? `${Lowercase<First>}${CamelToSnake<Rest>}`
-			: `${Lowercase<First>}_${CamelToSnake<Rest>}`
-		: Lowercase<S>;
-
-/**
- * 驼峰命名法转为下划线命名法
- *
- * @example
- * camelToSnake("shouldComponentUpdate") // "should_component_update"
- */
-export const camelToSnake = <S extends string>(str: S): CamelToSnake<S> => {
-	return str.replace(
-		/([A-Z])/g,
-		(match, pattern) => `_${pattern.toLowerCase()}`,
-	) as CamelToSnake<S>;
-};
-
-export type Capitalize<S extends string> = S extends `${infer P1}${infer Rest}`
-	? P1 extends Capitalize<P1>
-		? S
-		: `${Uppercase<P1>}${Rest}`
-	: S;
-
-/**
- * 字符串首字母大写
- *
- * @example
- * capitalize("hello") // "Hello"
- */
-export const capitalize = <S extends string>(s: S): Capitalize<S> => {
-	return (s.charAt(0).toUpperCase() + s.slice(1)) as Capitalize<S>;
-};
-
-export type Decapitalize<S extends string> =
-	S extends `${infer P1}${infer Rest}`
-		? P1 extends Lowercase<P1>
-			? P1
-			: `${Lowercase<P1>}${Rest}`
-		: S;
-
-/**
- * 字符串首字母小写
- *
- * @example
- * decapitalize("Hello") // "hello"
- */
-export const decapitalize = <S extends string>(s: S): Decapitalize<S> => {
-	return (s.charAt(0).toLowerCase() + s.slice(1)) as Decapitalize<S>;
-};
-
-/**
- * 将 ArrayBuffer 转换为 base64 字符串
- * 兼容浏览器、Bun 和 Node.js
- */
-const arrayBufferToBase64 = (buffer: ArrayBuffer): string => {
-	const bytes = new Uint8Array(buffer);
-	let binary = "";
-	for (let i = 0; i < bytes.byteLength; i++) {
-		binary += String.fromCharCode(bytes[i]!);
-	}
-	return btoa(binary);
-};
-
-/**
- * 图片压缩选项
- */
-export type ImageCompressionOptions = {
-	/** 压缩比率，默认 0.92 */
-	quality?: number;
-	/**
-	 * 自定义压缩函数，用于非浏览器环境（Node.js/Bun）
-	 * 如果提供，将使用此函数替代默认的 canvas 压缩
-	 * @param arrayBuffer 图片的 ArrayBuffer 数据
-	 * @param mime 图片的 MIME 类型
-	 * @param quality 压缩质量
-	 * @returns 压缩后的 base64 字符串
-	 */
-	compressor?: (
-		arrayBuffer: ArrayBuffer,
-		mime: string,
-		quality: number,
-	) => Promise<string> | string;
-};
-
-/**
- * 图片地址转 base64 数据
- *
- * @param imageUrl 图片地址
- * @param options 可选配置
- * @param options.quality 压缩比率，默认 0.92
- * @param options.compressor 自定义压缩函数，用于 Node.js/Bun 环境
- *
- * @example
- * // 基本用法（浏览器自动使用 Canvas 压缩）
- * imageUrlToBase64("https://example.com/image.jpg");
- *
- * @example
- * // Node.js/Bun 使用 sharp 压缩
- * import sharp from "sharp";
- *
- * imageUrlToBase64("https://example.com/image.jpg", {
- *   quality: 0.8,
- *   compressor: async (buffer, mime, quality) => {
- *     const compressed = await sharp(Buffer.from(buffer))
- *       .jpeg({ quality: Math.round(quality * 100) })
- *       .toBuffer();
- *     return `data:${mime};base64,${compressed.toString("base64")}`;
- *   }
- * });
- */
-export const imageUrlToBase64 = async (
-	imageUrl: string,
-	options: ImageCompressionOptions = {},
-): Promise<string> => {
-	const { quality = 0.92, compressor } = options;
-
-	if (!imageUrl.startsWith("http")) {
-		throw new Error("图片地址必须以http或https开头");
-	}
-
-	// 使用 fetch 获取图片数据
-	const response = await fetch(imageUrl);
-	if (!response.ok) {
-		throw new Error(`获取图片失败: ${response.statusText}`);
-	}
-
-	const mime = response.headers.get("Content-Type") || "image/jpeg";
-	const arrayBuffer = await response.arrayBuffer();
-
-	// 对于非 JPEG/PNG 图片，直接返回 base64，不做压缩
-	if (mime !== "image/jpeg" && mime !== "image/png") {
-		const base64 = arrayBufferToBase64(arrayBuffer);
-		return `data:${mime};base64,${base64}`;
-	}
-
-	// 如果提供了自定义压缩函数（用于 Node.js/Bun 环境），使用它
-	if (compressor) {
-		return await compressor(arrayBuffer, mime, quality);
-	}
-
-	// 浏览器环境：使用 OffscreenCanvas 压缩（Chrome 69+, Firefox 105+, Safari 16.4+）
-	if (typeof OffscreenCanvas !== "undefined") {
-		let bitmap: ImageBitmap | null = null;
-
-		try {
-			const blob = new Blob([arrayBuffer], { type: mime });
-			bitmap = await createImageBitmap(blob);
-
-			const canvas = new OffscreenCanvas(bitmap.width, bitmap.height);
-			const ctx = canvas.getContext("2d");
-			if (!ctx) {
-				throw new Error("无法获取 canvas context");
-			}
-
-			ctx.drawImage(bitmap, 0, 0);
-			bitmap.close();
-			bitmap = null;
-
-			// OffscreenCanvas 使用 convertToBlob 获取压缩后的图片
-			const compressedBlob = await canvas.convertToBlob({
-				type: mime,
-				quality: quality,
-			});
-
-			// 将 Blob 转换为 base64
-			const compressedArrayBuffer = await compressedBlob.arrayBuffer();
-			const base64 = arrayBufferToBase64(compressedArrayBuffer);
-			return `data:${mime};base64,${base64}`;
-		} catch {
-			// Canvas 压缩失败，返回原始 base64
-			bitmap?.close();
-			const base64 = arrayBufferToBase64(arrayBuffer);
-			return `data:${mime};base64,${base64}`;
-		}
-	}
-
-	// 非浏览器环境且没有提供压缩器，直接返回原始 base64
-	const base64 = arrayBufferToBase64(arrayBuffer);
-	return `data:${mime};base64,${base64}`;
-};
-
-/**
- * 将字符串压缩为单行精简格式
- *
- * @example
- * // "Hello, world."
- * compactStr(`
- *   Hello,
- *        world!
- * `, {
- *  disableNewLineReplace: false,
- * });
- */
-export const compactStr = (
-	text: string = "",
-	options?: {
-		/** 最大保留长度，设为 0 或 Infinity 则不截断，默认 Infinity */
-		maxLength?: number;
-		/** 是否将换行符替换为字面量 \n，默认开启 */
-		disableNewLineReplace?: boolean;
-		/** 是否合并连续的空格/制表符为一个空格，默认开启 */
-		disableWhitespaceCollapse?: boolean;
-		/** 截断后的后缀，默认为 "..." */
-		omission?: string;
-	},
-): string => {
-	if (!text) return "";
-
-	const {
-		maxLength = Infinity,
-		disableNewLineReplace = false,
-		disableWhitespaceCollapse = false,
-		omission = "...",
-	} = options ?? {};
-
-	let result = text;
-
-	// 处理换行符
-	if (!disableNewLineReplace) {
-		result = result.replace(/\r?\n/g, "\\n");
-	} else {
-		result = result.replace(/\r?\n/g, " ");
-	}
-
-	// 合并连续空格
-	if (!disableWhitespaceCollapse) {
-		result = result.replace(/\s+/g, " ");
-	}
-	result = result.trim();
-
-	// 截断多出来的文字
-	if (maxLength > 0 && result.length > maxLength) {
-		return result.slice(0, maxLength) + omission;
-	}
-
-	return result;
-};