starry-sky-ui 0.1.1 → 0.3.1

package/dist/index.d.ts

@@ -19,4 +19,6 @@ export type { ContentRendererProps } from './ContentRenderer';
 export { default as ChatInput } from './ChatInput';
 export type { ChatInputProps } from './ChatInput';
 export type { MessageInstance as MessageType, SelectOption as SelectOptionType, ModalProps as ModalPropsType } from './types';
+import * as adUtils from './utils';
+export { adUtils };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEzF,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE1F,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,YAAY,EAAE,eAAe,IAAI,WAAW,EAAE,YAAY,IAAI,gBAAgB,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEzF,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE1F,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,YAAY,EAAE,eAAe,IAAI,WAAW,EAAE,YAAY,IAAI,gBAAgB,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9H,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -8,4 +8,7 @@ export { default as Input } from './Input';
 export { default as Textarea } from './Input/Textarea';
 export { default as ContentRenderer } from './ContentRenderer';
 export { default as ChatInput } from './ChatInput';
+// 工具函数统一导出
+import * as adUtils from './utils';
+export { adUtils };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGxD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC;AAG3C,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC;AAG3C,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAG/D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGxD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC;AAG3C,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC;AAG3C,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAG/D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AAKnD,WAAW;AACX,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/utils/event.d.ts

@@ -0,0 +1,51 @@
+import type { ThrottleOptions } from './types';
+/**
+ * 防抖函数
+ *
+ * 在指定延迟内连续调用只执行最后一次。
+ *
+ * @param fn - 需要防抖的函数
+ * @param delay - 延迟时间（ms），默认 300
+ * @returns 防抖后的函数
+ *
+ * @example
+ * ```ts
+ * const handleSearch = debounce((value: string) => {
+ *   fetchResults(value);
+ * }, 500);
+ * ```
+ */
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, delay?: number): (...args: Parameters<T>) => void;
+/**
+ * 节流函数
+ *
+ * 在指定时间间隔内最多执行一次。
+ *
+ * @param fn - 需要节流的函数
+ * @param interval - 间隔时间（ms），默认 300
+ * @param options - 节流选项
+ * @returns 节流后的函数
+ *
+ * @example
+ * ```ts
+ * //  trailing 模式（默认）：停止触发后还会执行一次
+ * const handleScroll = throttle(() => console.log('scroll'), 200);
+ *
+ * // leading 模式：立即执行第一次
+ * const handleClick = throttle(fn, 1000, { leading: true, trailing: false });
+ * ```
+ */
+export declare function throttle<T extends (...args: any[]) => any>(fn: T, interval?: number, options?: ThrottleOptions): (...args: Parameters<T>) => void;
+/**
+ * 异步延迟
+ *
+ * @param ms - 延迟毫秒数
+ * @returns Promise
+ *
+ * @example
+ * ```ts
+ * await sleep(1000); // 等待 1 秒
+ * ```
+ */
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=event.d.ts.map

package/dist/utils/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/utils/event.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAY,eAAe,EAAE,MAAM,SAAS,CAAC;AAEzD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,GAAE,MAAY,GAClB,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAUlC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,QAAQ,GAAE,MAAY,EACtB,OAAO,GAAE,eAAoB,GAC5B,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CA2BlC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/utils/event.js

@@ -0,0 +1,88 @@
+// ---- 事件/异步工具函数 ----
+/**
+ * 防抖函数
+ *
+ * 在指定延迟内连续调用只执行最后一次。
+ *
+ * @param fn - 需要防抖的函数
+ * @param delay - 延迟时间（ms），默认 300
+ * @returns 防抖后的函数
+ *
+ * @example
+ * ```ts
+ * const handleSearch = debounce((value: string) => {
+ *   fetchResults(value);
+ * }, 500);
+ * ```
+ */
+export function debounce(fn, delay = 300) {
+    let timer = null;
+    return (...args) => {
+        if (timer !== null)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            fn(...args);
+            timer = null;
+        }, delay);
+    };
+}
+/**
+ * 节流函数
+ *
+ * 在指定时间间隔内最多执行一次。
+ *
+ * @param fn - 需要节流的函数
+ * @param interval - 间隔时间（ms），默认 300
+ * @param options - 节流选项
+ * @returns 节流后的函数
+ *
+ * @example
+ * ```ts
+ * //  trailing 模式（默认）：停止触发后还会执行一次
+ * const handleScroll = throttle(() => console.log('scroll'), 200);
+ *
+ * // leading 模式：立即执行第一次
+ * const handleClick = throttle(fn, 1000, { leading: true, trailing: false });
+ * ```
+ */
+export function throttle(fn, interval = 300, options = {}) {
+    const { leading = false, trailing = true } = options;
+    let lastTime = 0;
+    let timer = null;
+    return (...args) => {
+        const now = Date.now();
+        if (!lastTime && !leading)
+            lastTime = now;
+        const remaining = interval - (now - lastTime);
+        if (remaining <= 0) {
+            if (timer) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            fn(...args);
+            lastTime = now;
+        }
+        else if (trailing && !timer) {
+            timer = setTimeout(() => {
+                fn(...args);
+                lastTime = Date.now();
+                timer = null;
+            }, remaining);
+        }
+    };
+}
+/**
+ * 异步延迟
+ *
+ * @param ms - 延迟毫秒数
+ * @returns Promise
+ *
+ * @example
+ * ```ts
+ * await sleep(1000); // 等待 1 秒
+ * ```
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=event.js.map

package/dist/utils/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/utils/event.ts"],"names":[],"mappings":"AAAA,sBAAsB;AAItB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,QAAQ,CACtB,EAAK,EACL,QAAgB,GAAG;IAEnB,IAAI,KAAK,GAAyC,IAAI,CAAC;IAEvD,OAAO,CAAC,GAAG,IAAmB,EAAE,EAAE;QAChC,IAAI,KAAK,KAAK,IAAI;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACxC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;YACZ,KAAK,GAAG,IAAI,CAAC;QACf,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,QAAQ,CACtB,EAAK,EACL,WAAmB,GAAG,EACtB,UAA2B,EAAE;IAE7B,MAAM,EAAE,OAAO,GAAG,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACrD,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,KAAK,GAAyC,IAAI,CAAC;IAEvD,OAAO,CAAC,GAAG,IAAmB,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO;YAAE,QAAQ,GAAG,GAAG,CAAC;QAE1C,MAAM,SAAS,GAAG,QAAQ,GAAG,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC;QAE9C,IAAI,SAAS,IAAI,CAAC,EAAE;YAClB,IAAI,KAAK,EAAE;gBACT,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,KAAK,GAAG,IAAI,CAAC;aACd;YACD,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;YACZ,QAAQ,GAAG,GAAG,CAAC;SAChB;aAAM,IAAI,QAAQ,IAAI,CAAC,KAAK,EAAE;YAC7B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;gBACZ,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACtB,KAAK,GAAG,IAAI,CAAC;YACf,CAAC,EAAE,SAAS,CAAC,CAAC;SACf;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/utils/file.d.ts

@@ -0,0 +1,69 @@
+import type { DownloadOptions } from './types';
+/**
+ * 将 Blob 转换为 base64 data URL
+ *
+ * @param blob - 源 Blob
+ * @returns base64 data URL
+ *
+ * @example
+ * ```ts
+ * const dataUrl = await blobToDataURL(blob);
+ * ```
+ */
+export declare function blobToDataURL(blob: Blob): Promise<string>;
+/**
+ * 将 base64 data URL 转换为 Blob
+ *
+ * @param dataURL - base64 data URL
+ * @returns 转换后的 Blob
+ *
+ * @example
+ * ```ts
+ * const blob = dataURLToBlob('data:image/png;base64,...');
+ * ```
+ */
+export declare function dataURLToBlob(dataURL: string): Blob;
+/**
+ * 触发文件下载
+ *
+ * @param source - 文件 URL 或 Blob
+ * @param options - 下载选项
+ *
+ * @example
+ * ```ts
+ * // 通过 URL 下载
+ * await downloadFile('/api/export/file.xlsx');
+ *
+ * // 通过 Blob 下载
+ * const blob = new Blob([data], { type: 'text/plain' });
+ * await downloadFile(blob, { filename: 'data.txt' });
+ * ```
+ */
+export declare function downloadFile(source: string | Blob, options?: DownloadOptions): Promise<void>;
+/**
+ * 读取 File 为 DataURL
+ *
+ * @param file - 文件对象
+ * @returns base64 data URL
+ *
+ * @example
+ * ```ts
+ * const dataUrl = await readFileAsDataURL(fileInput.files[0]);
+ * ```
+ */
+export declare function readFileAsDataURL(file: File): Promise<string>;
+/**
+ * 格式化文件大小为可读字符串
+ *
+ * @param bytes - 字节数
+ * @param decimals - 小数位数，默认 2
+ * @returns 格式化后的文件大小，如 "1.5 MB"
+ *
+ * @example
+ * ```ts
+ * formatFileSize(1536);      // "1.50 KB"
+ * formatFileSize(1048576, 0); // "1 MB"
+ * ```
+ */
+export declare function formatFileSize(bytes: number, decimals?: number): string;
+//# sourceMappingURL=file.d.ts.map

package/dist/utils/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/utils/file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAOzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAYnD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAO7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAQ1E"}

package/dist/utils/file.js

@@ -0,0 +1,137 @@
+// ---- 文件/Blob 工具函数 ----
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * 将 Blob 转换为 base64 data URL
+ *
+ * @param blob - 源 Blob
+ * @returns base64 data URL
+ *
+ * @example
+ * ```ts
+ * const dataUrl = await blobToDataURL(blob);
+ * ```
+ */
+export function blobToDataURL(blob) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => resolve(reader.result);
+        reader.onerror = () => reject(new Error('Blob 读取失败'));
+        reader.readAsDataURL(blob);
+    });
+}
+/**
+ * 将 base64 data URL 转换为 Blob
+ *
+ * @param dataURL - base64 data URL
+ * @returns 转换后的 Blob
+ *
+ * @example
+ * ```ts
+ * const blob = dataURLToBlob('data:image/png;base64,...');
+ * ```
+ */
+export function dataURLToBlob(dataURL) {
+    var _a;
+    const [header, base64] = dataURL.split(',');
+    const mime = ((_a = header.match(/:(.*?);/)) === null || _a === void 0 ? void 0 : _a[1]) || '';
+    const byteStr = atob(base64);
+    const len = byteStr.length;
+    const bytes = new Uint8Array(len);
+    for (let i = 0; i < len; i++) {
+        bytes[i] = byteStr.charCodeAt(i);
+    }
+    return new Blob([bytes], { type: mime });
+}
+/**
+ * 触发文件下载
+ *
+ * @param source - 文件 URL 或 Blob
+ * @param options - 下载选项
+ *
+ * @example
+ * ```ts
+ * // 通过 URL 下载
+ * await downloadFile('/api/export/file.xlsx');
+ *
+ * // 通过 Blob 下载
+ * const blob = new Blob([data], { type: 'text/plain' });
+ * await downloadFile(blob, { filename: 'data.txt' });
+ * ```
+ */
+export function downloadFile(source, options = {}) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { filename = 'download', openInNewWindow = false } = options;
+        let url;
+        if (source instanceof Blob) {
+            url = URL.createObjectURL(source);
+        }
+        else {
+            url = source;
+        }
+        const anchor = document.createElement('a');
+        anchor.href = url;
+        anchor.download = filename;
+        anchor.style.display = 'none';
+        if (openInNewWindow && typeof source === 'string') {
+            window.open(source, '_blank');
+            return;
+        }
+        document.body.appendChild(anchor);
+        anchor.click();
+        document.body.removeChild(anchor);
+        // 如果是临时 Blob URL，释放内存
+        if (source instanceof Blob) {
+            // 给浏览器一点时间处理下载，再释放
+            setTimeout(() => URL.revokeObjectURL(url), 10000);
+        }
+    });
+}
+/**
+ * 读取 File 为 DataURL
+ *
+ * @param file - 文件对象
+ * @returns base64 data URL
+ *
+ * @example
+ * ```ts
+ * const dataUrl = await readFileAsDataURL(fileInput.files[0]);
+ * ```
+ */
+export function readFileAsDataURL(file) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => resolve(reader.result);
+        reader.onerror = () => reject(new Error('文件读取失败'));
+        reader.readAsDataURL(file);
+    });
+}
+/**
+ * 格式化文件大小为可读字符串
+ *
+ * @param bytes - 字节数
+ * @param decimals - 小数位数，默认 2
+ * @returns 格式化后的文件大小，如 "1.5 MB"
+ *
+ * @example
+ * ```ts
+ * formatFileSize(1536);      // "1.50 KB"
+ * formatFileSize(1048576, 0); // "1 MB"
+ * ```
+ */
+export function formatFileSize(bytes, decimals = 2) {
+    if (bytes === 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const k = 1024;
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(decimals))} ${units[i]}`;
+}
+//# sourceMappingURL=file.js.map

package/dist/utils/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/utils/file.ts"],"names":[],"mappings":"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"}

package/dist/utils/image.d.ts

@@ -0,0 +1,60 @@
+import type { ImageCompressOptions } from './types';
+/**
+ * 获取图片原始尺寸与类型信息
+ *
+ * 仅读取图片元数据，不进行缩放或编码，适用于上传前预览。
+ *
+ * @param file - 图片文件
+ * @returns 图片信息（宽、高、类型）
+ *
+ * @example
+ * ```ts
+ * const info = await getImageInfo(file);
+ * // { width: 1920, height: 1080, type: 'image/jpeg' }
+ * ```
+ */
+export declare function getImageInfo(file: File | Blob): Promise<{
+    width: number;
+    height: number;
+    type: string;
+}>;
+/**
+ * 压缩/转换图片
+ *
+ * 支持缩放、格式转换、质量调节，自动检测 WebP 支持并降级。
+ *
+ * @param file - 源图片文件或 Blob
+ * @param options - 压缩选项
+ * @returns 压缩后的 Blob
+ *
+ * @example
+ * ```ts
+ * // 默认压缩（质量 0.75，最大边 1024px，自动选择 webp/jpeg）
+ * const blob = await compressImage(file);
+ *
+ * // 指定质量与尺寸
+ * const blob = await compressImage(file, { quality: 0.5, maxDimension: 800 });
+ *
+ * // 指定输出格式
+ * const blob = await compressImage(file, { format: 'image/png', forceFormat: true });
+ * ```
+ */
+export declare function compressImage(file: File | Blob, options?: ImageCompressOptions): Promise<Blob>;
+/**
+ * 纯格式转换（不缩放）
+ *
+ * 仅改变图片编码格式，保持原始尺寸不变。
+ *
+ * @param file - 源图片文件或 Blob
+ * @param targetFormat - 目标格式
+ * @param quality - 质量 (0-1)，默认 0.92
+ * @returns 转换后的 Blob
+ *
+ * @example
+ * ```ts
+ * const webpBlob = await convertImageFormat(file, 'image/webp');
+ * const jpegBlob = await convertImageFormat(file, 'image/jpeg', 0.8);
+ * ```
+ */
+export declare function convertImageFormat(file: File | Blob, targetFormat: 'image/webp' | 'image/jpeg' | 'image/png', quality?: number): Promise<Blob>;
+//# sourceMappingURL=image.d.ts.map

package/dist/utils/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/utils/image.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAuIpD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,GAAG,IAAI,GAChB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAS1D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,YAAY,EAAE,YAAY,GAAG,YAAY,GAAG,WAAW,EACvD,OAAO,GAAE,MAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/utils/image.js

@@ -0,0 +1,203 @@
+// ---- 图片处理工具函数 ----
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+// ==================== WebP 检测（缓存结果） ====================
+/** WebP 支持状态缓存 */
+let _webpSupported = null;
+/**
+ * 检测浏览器是否支持 WebP 格式
+ *
+ * 结果会在首次调用后缓存，避免重复创建 Canvas。
+ */
+function isWebPSupported() {
+    if (_webpSupported !== null)
+        return _webpSupported;
+    const canvas = document.createElement('canvas');
+    canvas.width = 1;
+    canvas.height = 1;
+    const ctx = canvas.getContext('2d');
+    if (!ctx) {
+        _webpSupported = false;
+        return false;
+    }
+    ctx.fillStyle = '#fff';
+    ctx.fillRect(0, 0, 1, 1);
+    _webpSupported = canvas.toDataURL('image/webp').startsWith('data:image/webp');
+    return _webpSupported;
+}
+// ==================== 内部辅助 ====================
+/**
+ * 将图片 URL 加载为 HTMLImageElement
+ *
+ * @param url - 图片 URL（支持 blob: data: 等）
+ * @returns 加载完成的 Image 对象
+ */
+function loadImage(url) {
+    return new Promise((resolve, reject) => {
+        const img = new Image();
+        img.onload = () => resolve(img);
+        img.onerror = () => reject(new Error('图片加载失败，请检查文件是否损坏'));
+        img.src = url;
+    });
+}
+/**
+ * 确定最终的输出图片格式
+ *
+ * - 未指定格式时，优先 webp（若浏览器支持），否则 jpeg
+ * - 指定了 webp 但浏览器不支持且未强制格式时，自动降级为 jpeg
+ */
+function resolveOutputFormat(format, forceFormat) {
+    if (format) {
+        if (!forceFormat && format === 'image/webp' && !isWebPSupported()) {
+            console.warn('[compressImage] 浏览器不支持 WebP，降级为 JPEG');
+            return 'image/jpeg';
+        }
+        return format;
+    }
+    return isWebPSupported() ? 'image/webp' : 'image/jpeg';
+}
+/**
+ * 计算缩放后的目标尺寸
+ *
+ * @returns 缩放后的宽高（整数）
+ */
+function calcDimensions(width, height, maxDimension) {
+    if (maxDimension === false || maxDimension <= 0) {
+        return { width, height };
+    }
+    if (width > maxDimension || height > maxDimension) {
+        const ratio = Math.min(maxDimension / width, maxDimension / height);
+        return {
+            width: Math.round(width * ratio),
+            height: Math.round(height * ratio),
+        };
+    }
+    return { width, height };
+}
+/**
+ * 将图像绘制到 Canvas 并编码为 Blob
+ */
+function drawToBlob(img, width, height, outputFormat, quality) {
+    return new Promise((resolve, reject) => {
+        const canvas = document.createElement('canvas');
+        canvas.width = width;
+        canvas.height = height;
+        const ctx = canvas.getContext('2d');
+        if (!ctx) {
+            reject(new Error('无法获取 Canvas 2D 上下文'));
+            return;
+        }
+        ctx.imageSmoothingEnabled = true;
+        // TS 类型严格模式下需要断言
+        ctx.imageSmoothingQuality = 'high';
+        ctx.drawImage(img, 0, 0, width, height);
+        canvas.toBlob((blob) => {
+            if (blob) {
+                resolve(blob);
+            }
+            else {
+                reject(new Error('Canvas 编码失败'));
+            }
+        }, outputFormat, quality);
+    });
+}
+// ==================== 公开 API ====================
+/**
+ * 获取图片原始尺寸与类型信息
+ *
+ * 仅读取图片元数据，不进行缩放或编码，适用于上传前预览。
+ *
+ * @param file - 图片文件
+ * @returns 图片信息（宽、高、类型）
+ *
+ * @example
+ * ```ts
+ * const info = await getImageInfo(file);
+ * // { width: 1920, height: 1080, type: 'image/jpeg' }
+ * ```
+ */
+export function getImageInfo(file) {
+    const objectURL = URL.createObjectURL(file);
+    return loadImage(objectURL)
+        .then((img) => ({
+        width: img.naturalWidth,
+        height: img.naturalHeight,
+        type: file.type || 'image/png',
+    }))
+        .finally(() => URL.revokeObjectURL(objectURL));
+}
+/**
+ * 压缩/转换图片
+ *
+ * 支持缩放、格式转换、质量调节，自动检测 WebP 支持并降级。
+ *
+ * @param file - 源图片文件或 Blob
+ * @param options - 压缩选项
+ * @returns 压缩后的 Blob
+ *
+ * @example
+ * ```ts
+ * // 默认压缩（质量 0.75，最大边 1024px，自动选择 webp/jpeg）
+ * const blob = await compressImage(file);
+ *
+ * // 指定质量与尺寸
+ * const blob = await compressImage(file, { quality: 0.5, maxDimension: 800 });
+ *
+ * // 指定输出格式
+ * const blob = await compressImage(file, { format: 'image/png', forceFormat: true });
+ * ```
+ */
+export function compressImage(file, options = {}) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { quality = 0.75, maxDimension = 1024, format, forceFormat = false, } = options;
+        // 确定输出格式
+        const outputFormat = resolveOutputFormat(format, forceFormat);
+        const objectURL = URL.createObjectURL(file);
+        try {
+            const img = yield loadImage(objectURL);
+            const { width, height } = calcDimensions(img.naturalWidth, img.naturalHeight, maxDimension);
+            return yield drawToBlob(img, width, height, outputFormat, quality);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`图片处理失败: ${msg}`);
+        }
+        finally {
+            URL.revokeObjectURL(objectURL);
+        }
+    });
+}
+/**
+ * 纯格式转换（不缩放）
+ *
+ * 仅改变图片编码格式，保持原始尺寸不变。
+ *
+ * @param file - 源图片文件或 Blob
+ * @param targetFormat - 目标格式
+ * @param quality - 质量 (0-1)，默认 0.92
+ * @returns 转换后的 Blob
+ *
+ * @example
+ * ```ts
+ * const webpBlob = await convertImageFormat(file, 'image/webp');
+ * const jpegBlob = await convertImageFormat(file, 'image/jpeg', 0.8);
+ * ```
+ */
+export function convertImageFormat(file, targetFormat, quality = 0.92) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return compressImage(file, {
+            format: targetFormat,
+            maxDimension: false,
+            quality,
+            forceFormat: true,
+        });
+    });
+}
+//# sourceMappingURL=image.js.map

package/dist/utils/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../src/utils/image.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+export { blobToDataURL, dataURLToBlob, downloadFile, readFileAsDataURL, formatFileSize, } from './file';
+export type { DownloadOptions } from './types';
+export { getImageInfo, compressImage, convertImageFormat, } from './image';
+export type { ImageCompressOptions } from './types';
+export { debounce, throttle, sleep, } from './event';
+export type { ThrottleOptions } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,cAAc,GACf,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,EACL,YAAY,EACZ,aAAa,EACb,kBAAkB,GACnB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAGpD,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,KAAK,GACN,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,8 @@
+// ---- AdUI 通用工具函数统一导出 ----
+// 文件工具
+export { blobToDataURL, dataURLToBlob, downloadFile, readFileAsDataURL, formatFileSize, } from './file';
+// 图片工具
+export { getImageInfo, compressImage, convertImageFormat, } from './image';
+// 事件工具
+export { debounce, throttle, sleep, } from './event';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B,OAAO;AACP,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,cAAc,GACf,MAAM,QAAQ,CAAC;AAGhB,OAAO;AACP,OAAO,EACL,YAAY,EACZ,aAAa,EACb,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO;AACP,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,KAAK,GACN,MAAM,SAAS,CAAC"}

package/dist/utils/types.d.ts

@@ -0,0 +1,28 @@
+/** 可选的回调函数 */
+export type Callback = () => void;
+/** 防抖/节流选项 */
+export interface ThrottleOptions {
+    /** 是否在首次调用时立即执行，默认 false */
+    leading?: boolean;
+    /** 是否在最后一次调用后延迟执行，默认 false */
+    trailing?: boolean;
+}
+/** 文件下载选项 */
+export interface DownloadOptions {
+    /** 保存的文件名（含扩展名） */
+    filename?: string;
+    /** 是否在新窗口打开，默认 false（仅 URL 下载时有效） */
+    openInNewWindow?: boolean;
+}
+/** 图片压缩/转换选项 */
+export interface ImageCompressOptions {
+    /** 压缩质量 (0-1)，默认 0.75 */
+    quality?: number;
+    /** 最大宽/高尺寸（px），设为 false 不缩放，默认 1024 */
+    maxDimension?: number | false;
+    /** 输出格式，默认根据浏览器支持自动选择 webp/jpeg */
+    format?: 'image/webp' | 'image/jpeg' | 'image/png';
+    /** 是否强制使用指定格式（不降级），默认 false */
+    forceFormat?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAEA,cAAc;AACd,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;AAElC,cAAc;AACd,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,aAAa;AACb,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,gBAAgB;AAChB,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,mCAAmC;IACnC,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,WAAW,CAAC;IACnD,+BAA+B;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/utils/types.js

@@ -0,0 +1,3 @@
+// ---- AdUI 通用工具类型定义 ----
+export {};
+//# sourceMappingURL=types.js.map

package/dist/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAAA,0BAA0B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "starry-sky-ui",
-  "version": "0.1.1",
+  "version": "0.3.1",
   "description": "starry-sky-ui — 轻量级 React UI 组件库",
   "private": false,
   "license": "MIT",
@@ -8,10 +8,22 @@
     "type": "git",
     "url": "https://gitee.com/qqqsdx/starry-sky-ui.git"
   },
-  "keywords": ["react", "ui", "components", "typescript"],
+  "keywords": [
+    "react",
+    "ui",
+    "components",
+    "typescript"
+  ],
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
   "files": [
     "dist",
     "README.md"