@base-web-kits/base-tools-web 0.9.8 → 0.9.9

package/dist/clipboard/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 复制文本到剪贴板（兼容移动端和PC）
+ * @returns Promise<void> 复制成功时 resolve，失败时 reject。
+ * @example
+ * await copyText('hello');
+ * toast('复制成功');
+ */
+export declare function copyText(text: string): Promise<void>;
+/**
+ * 复制富文本 HTML 到剪贴板（移动端与 PC）
+ * 使用场景：图文混排文章、带样式段落，保留格式粘贴。
+ * @param html HTML字符串
+ * @example
+ * await copyHtml('<p><b>加粗</b> 与 <i>斜体</i></p>');
+ */
+export declare function copyHtml(html: string): Promise<void>;
+/**
+ * 复制 DOM 节点到剪贴板（移动端与 PC）
+ * 使用场景：页面已有区域的可视化复制；元素使用 `outerHTML`，非元素使用其文本内容。
+ * @param node DOM 节点（元素或文本节点）
+ * @example
+ * const el = document.querySelector('#article')!;
+ * await copyNode(el);
+ */
+export declare function copyNode(node: Node): Promise<void>;
+/**
+ * 复制单张图片到剪贴板（移动端与 PC，需浏览器支持 `ClipboardItem`）
+ * 使用场景：把本地 `canvas` 或 `Blob` 生成的图片直接粘贴到聊天/文档。
+ * @param image 图片源（Blob/Canvas/ImageBitmap）
+ * @example
+ * const canvas = document.querySelector('canvas')!;
+ * await copyImage(canvas);
+ */
+export declare function copyImage(image: Blob | HTMLCanvasElement | ImageBitmap): Promise<void>;
+/**
+ * 复制 URL 到剪贴板（移动端与 PC）
+ * 写入 `text/uri-list` 与 `text/plain`，在支持 URI 列表的应用中可识别为链接。
+ * @param url 完整的 URL 字符串
+ * @example
+ * await copyUrl('https://example.com/page');
+ */
+export declare function copyUrl(url: string): Promise<void>;
+/**
+ * 复制任意 Blob 到剪贴板（移动端与 PC，需 `ClipboardItem`）
+ * 使用场景：原生格式粘贴（如 `image/svg+xml`、`application/pdf` 等）。
+ * @param blob 任意 Blob 数据
+ * @example
+ * const svg = new Blob(['<svg></svg>'], { type: 'image/svg+xml' });
+ * await copyBlob(svg);
+ */
+export declare function copyBlob(blob: Blob): Promise<void>;
+/**
+ * 复制 RTF 富文本到剪贴板（移动端与 PC）
+ * 同时写入 `text/plain`，增强与 Office/富文本编辑器的兼容性。
+ * @param rtf RTF 字符串（如：`{\\rtf1\\ansi ...}`）
+ * @example
+ * await copyRtf('{\\rtf1\\ansi Hello \\b World}');
+ */
+export declare function copyRtf(rtf: string): Promise<void>;
+/**
+ * 复制表格到剪贴板（移动端与 PC）
+ * 同时写入多种 MIME：`text/html`（表格）、`text/tab-separated-values`（TSV）、`text/csv`、`text/plain`（TSV）。
+ * 使用场景：优化粘贴到 Excel/Google Sheets/Docs 的体验
+ * @param rows 二维数组，每行一个数组（字符串/数字）
+ * @example
+ * await copyTable([
+ *   ['姓名', '分数'],
+ *   ['张三', 95],
+ *   ['李四', 88],
+ * ]);
+ */
+export declare function copyTable(rows: Array<Array<string | number>>): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/clipboard/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD1D;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW1D;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAWxD;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,iBAAiB,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5F;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUxD;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAOxD;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAsClF"}

package/dist/cookie/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 设置 Cookie（路径默认为 `/`）
+ * @param name Cookie 名称
+ * @param value Cookie 值（内部已使用 `encodeURIComponent` 编码）
+ * @param days 过期天数（从当前时间起算）
+ * @example
+ * setCookie('token', 'abc', 7);
+ */
+export declare function setCookie(name: string, value: string, days: number): void;
+/**
+ * 获取 Cookie
+ * @param name Cookie 名称
+ * @returns 若存在返回解码后的值，否则 `null`
+ * @example
+ * const token = getCookie('token');
+ */
+export declare function getCookie(name: string): string | null;
+/**
+ * 移除 Cookie（通过设置过期时间为过去）
+ * 路径固定为 `/`，确保与默认写入路径一致。
+ * @param name Cookie 名称
+ * @example
+ * removeCookie('token');
+ */
+export declare function removeCookie(name: string): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/cookie/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAKlE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQrD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,QAExC"}

package/dist/device/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 获取用户代理字符串（UA）
+ * @returns navigator.userAgent.toLowerCase();
+ */
+export declare function getUA(): string;
+/**
+ * 是否为移动端设备（含平板）
+ */
+export declare function isMobile(): boolean;
+/**
+ * 是否为平板设备
+ */
+export declare function isTablet(): boolean;
+/**
+ * 是否为 PC 设备
+ */
+export declare function isPC(): boolean;
+/**
+ * 是否为 iOS 系统
+ */
+export declare function isIOS(): boolean;
+/**
+ * 是否为 Android 系统
+ */
+export declare function isAndroid(): boolean;
+/**
+ * 是否微信内置浏览器
+ */
+export declare function isWeChat(): boolean;
+/**
+ * 是否为 Chrome 浏览器
+ * 已排除 Edge、Opera 等基于 Chromium 的浏览器
+ */
+export declare function isChrome(): boolean;
+/**
+ * 检测是否支持触摸事件
+ */
+export declare function isTouchSupported(): boolean;
+/**
+ * 获取设备像素比
+ */
+export declare function getDevicePixelRatio(): number;
+/**
+ * 获取浏览器名字
+ */
+export declare function getBrowserName(): string | null;
+/**
+ * 获取浏览器版本号
+ */
+export declare function getBrowserVersion(): string | null;
+/**
+ * 获取操作系统信息
+ */
+export declare function getOS(): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/device/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,KAAK,IAAI,MAAM,CAG9B;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAGlC;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAGlC;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAE9B;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAG/B;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAGnC;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAGlC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAGlC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAW9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAoBjD;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,MAAM,CAU9B"}

package/dist/dom/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 获取窗口宽度（不含滚动条）
+ * @returns 窗口宽度
+ */
+export declare function getWindowWidth(): number;
+/**
+ * 获取窗口高度（不含滚动条）
+ * @returns 窗口高度
+ */
+export declare function getWindowHeight(): number;
+/**
+ * 获取文档垂直滚动位置
+ * @example
+ * const top = getWindowScrollTop();
+ */
+export declare function getWindowScrollTop(): number;
+/**
+ * 获取文档水平滚动位置
+ * @example
+ * const left = getWindowScrollLeft();
+ */
+export declare function getWindowScrollLeft(): number;
+/**
+ * 平滑滚动到指定位置
+ * @param top 目标纵向滚动位置
+ * @param behavior 滚动行为，默认 'smooth'
+ * @example
+ * windowScrollTo(0);
+ */
+export declare function windowScrollTo(top: number, behavior?: ScrollBehavior): void;
+/**
+ * 元素是否在视口内（可设置阈值）
+ * @param el 目标元素
+ * @param offset 额外判定偏移（像素，正数放宽，负数收紧）
+ * @returns 是否在视口内
+ */
+export declare function isInViewport(el: Element, offset?: number): boolean;
+/**
+ * 锁定页面滚动（移动端/PC）
+ * 使用 `body{ position: fixed }` 技术消除滚动条抖动，记录并恢复滚动位置。
+ * @example
+ * lockBodyScroll();
+ */
+export declare function lockBodyScroll(): void;
+/**
+ * 解除页面滚动锁定，恢复原始滚动位置
+ * @example
+ * unlockBodyScroll();
+ */
+export declare function unlockBodyScroll(): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/dom/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,WAE7B;AAED;;;GAGG;AACH,wBAAgB,eAAe,WAE9B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,WAIjC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,WAIlC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAyB,QAM9E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,SAAI,WAUnD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,SAW7B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,SAY/B"}

package/dist/index.d.ts

@@ -1,319 +1,10 @@
-import { AxiosResponse } from 'axios';
-
 /**
- * 复制文本到剪贴板（兼容移动端和PC）
- * @returns Promise<void> 复制成功时 resolve，失败时 reject。
- * @example
- * await copyText('hello');
- * toast('复制成功');
+ * 内部统一导出, 外部快捷引入: import {xx} from 'base-tools/web'
  */
-declare function copyText(text: string): Promise<void>;
-/**
- * 复制富文本 HTML 到剪贴板（移动端与 PC）
- * 使用场景：图文混排文章、带样式段落，保留格式粘贴。
- * @param html HTML字符串
- * @example
- * await copyHtml('<p><b>加粗</b> 与 <i>斜体</i></p>');
- */
-declare function copyHtml(html: string): Promise<void>;
-/**
- * 复制 DOM 节点到剪贴板（移动端与 PC）
- * 使用场景：页面已有区域的可视化复制；元素使用 `outerHTML`，非元素使用其文本内容。
- * @param node DOM 节点（元素或文本节点）
- * @example
- * const el = document.querySelector('#article')!;
- * await copyNode(el);
- */
-declare function copyNode(node: Node): Promise<void>;
-/**
- * 复制单张图片到剪贴板（移动端与 PC，需浏览器支持 `ClipboardItem`）
- * 使用场景：把本地 `canvas` 或 `Blob` 生成的图片直接粘贴到聊天/文档。
- * @param image 图片源（Blob/Canvas/ImageBitmap）
- * @example
- * const canvas = document.querySelector('canvas')!;
- * await copyImage(canvas);
- */
-declare function copyImage(image: Blob | HTMLCanvasElement | ImageBitmap): Promise<void>;
-/**
- * 复制 URL 到剪贴板（移动端与 PC）
- * 写入 `text/uri-list` 与 `text/plain`，在支持 URI 列表的应用中可识别为链接。
- * @param url 完整的 URL 字符串
- * @example
- * await copyUrl('https://example.com/page');
- */
-declare function copyUrl(url: string): Promise<void>;
-/**
- * 复制任意 Blob 到剪贴板（移动端与 PC，需 `ClipboardItem`）
- * 使用场景：原生格式粘贴（如 `image/svg+xml`、`application/pdf` 等）。
- * @param blob 任意 Blob 数据
- * @example
- * const svg = new Blob(['<svg></svg>'], { type: 'image/svg+xml' });
- * await copyBlob(svg);
- */
-declare function copyBlob(blob: Blob): Promise<void>;
-/**
- * 复制 RTF 富文本到剪贴板（移动端与 PC）
- * 同时写入 `text/plain`，增强与 Office/富文本编辑器的兼容性。
- * @param rtf RTF 字符串（如：`{\\rtf1\\ansi ...}`）
- * @example
- * await copyRtf('{\\rtf1\\ansi Hello \\b World}');
- */
-declare function copyRtf(rtf: string): Promise<void>;
-/**
- * 复制表格到剪贴板（移动端与 PC）
- * 同时写入多种 MIME：`text/html`（表格）、`text/tab-separated-values`（TSV）、`text/csv`、`text/plain`（TSV）。
- * 使用场景：优化粘贴到 Excel/Google Sheets/Docs 的体验
- * @param rows 二维数组，每行一个数组（字符串/数字）
- * @example
- * await copyTable([
- *   ['姓名', '分数'],
- *   ['张三', 95],
- *   ['李四', 88],
- * ]);
- */
-declare function copyTable(rows: Array<Array<string | number>>): Promise<void>;
-
-/**
- * 设置 Cookie（路径默认为 `/`）
- * @param name Cookie 名称
- * @param value Cookie 值（内部已使用 `encodeURIComponent` 编码）
- * @param days 过期天数（从当前时间起算）
- * @example
- * setCookie('token', 'abc', 7);
- */
-declare function setCookie(name: string, value: string, days: number): void;
-/**
- * 获取 Cookie
- * @param name Cookie 名称
- * @returns 若存在返回解码后的值，否则 `null`
- * @example
- * const token = getCookie('token');
- */
-declare function getCookie(name: string): string | null;
-/**
- * 移除 Cookie（通过设置过期时间为过去）
- * 路径固定为 `/`，确保与默认写入路径一致。
- * @param name Cookie 名称
- * @example
- * removeCookie('token');
- */
-declare function removeCookie(name: string): void;
-
-/**
- * 下载文件
- * @param url 完整的下载地址 | base64字符串 | Blob对象
- * @param fileName 自定义文件名（需含后缀）
- * @example
- * download('https://xx/xx.pdf');
- * download('https://xx/xx.pdf', 'xx.pdf');
- * download(blob, '图片.jpg');
- */
-declare function download(url: string | Blob, fileName?: string): Promise<void>;
-/**
- * 解析Axios返回的Blob数据
- * @param res Axios响应对象 (responseType='blob')
- * @returns 包含blob数据和文件名的对象 { blob, fileName }
- * @example
- * const res = await axios.get(url, { responseType: 'blob' });
- * const { blob, fileName } = await parseAxiosBlob(res);
- * download(blob, fileName);
- */
-declare function parseAxiosBlob(res: AxiosResponse<Blob>): Promise<{
-    blob: Blob;
-    fileName: string;
-}>;
-/**
- * 获取文件名
- * @param disposition content-disposition头值
- * @returns content-disposition中的filename
- * @example
- * const fileName = getDispositionFileName(headers['content-disposition']);
- */
-declare function getDispositionFileName(disposition?: string): string;
-/**
- * 动态加载 JS（重复执行不会重复加载，内部已排重）
- * @param src js 文件路径
- * @param attrs 可选的脚本属性，如 async、defer、crossOrigin
- * @example
- * await loadJs('https://xx/xx.js');
- * await loadJs('/a.js', { defer: true });
- */
-declare function loadJs(src: string, attrs?: Pick<HTMLScriptElement, 'async' | 'defer' | 'crossOrigin'>): Promise<void>;
-/**
- * 判断某个 JS 地址是否已在页面中加载过
- * @param src 相对、绝对路径的 JS 地址
- * @returns 是否已加载过
- * @example
- * hasJs('https://xx/xx.js'); // boolean
- * hasJs('/xx.js'); // boolean
- * hasJs('xx.js'); // boolean
- */
-declare function hasJs(src: string): boolean;
-/**
- * 动态加载 CSS（重复执行不会重复加载，内部已排重）
- * @param href css 文件地址
- * @param attrs 可选属性，如 crossOrigin、media
- * @example
- * await loadCss('https://xx/xx.css');
- * await loadCss('/a.css', { media: 'print' });
- */
-declare function loadCss(href: string, attrs?: Pick<HTMLLinkElement, 'crossOrigin' | 'media'>): Promise<void>;
-/**
- * 判断某个 CSS 地址是否已在页面中加载过
- * @param href 相对、绝对路径的 CSS 地址
- * @returns 是否已加载过
- * @example
- * hasCss('https://xx/xx.css'); // boolean
- */
-declare function hasCss(href: string): boolean;
-/**
- * 预加载图片
- * @param src 图片地址
- * @returns Promise<HTMLImageElement>
- * @example
- * await preloadImage('/a.png');
- */
-declare function preloadImage(src: string): Promise<HTMLImageElement>;
-
-/**
- * 写入 localStorage（自动 JSON 序列化）
- * 当 `value` 为 `null` 或 `undefined` 时，会移除该键。
- * 支持保存：对象、数组、字符串、数字、布尔值。
- * @param key 键名
- * @param value 任意可序列化的值
- * @param days 过期天数（从当前时间起算）
- * @example
- * setLocalStorage('user', { id: 1, name: 'Alice' }); // 对象
- * setLocalStorage('age', 18); // 数字
- * setLocalStorage('vip', true); // 布尔值
- * setLocalStorage('token', 'abc123', 7); // 7 天后过期
- */
-declare function setLocalStorage(key: string, value: unknown, days?: number): void;
-/**
- * 读取 localStorage（自动 JSON 反序列化）
- * 若值为合法 JSON，则返回反序列化后的数据；
- * 若值非 JSON（如外部写入的纯字符串），则原样返回字符串。
- * 不存在时返回 `null`。
- * @param key 键名
- * @returns 解析后的值或 `null`
- * @example
- * const user = getLocalStorage<{ id: number; name: string }>('user');
- * const age = getLocalStorage<number>('age');
- * const vip = getLocalStorage<boolean>('vip');
- */
-declare function getLocalStorage<T = unknown>(key: string): T | null;
-/**
- * 移除 localStorage 指定键
- * @param key 键名
- * @example
- * removeLocalStorage('token');
- */
-declare function removeLocalStorage(key: string): void;
-
-/**
- * 获取窗口宽度（不含滚动条）
- * @returns 窗口宽度
- */
-declare function getWindowWidth(): number;
-/**
- * 获取窗口高度（不含滚动条）
- * @returns 窗口高度
- */
-declare function getWindowHeight(): number;
-/**
- * 获取文档垂直滚动位置
- * @example
- * const top = getWindowScrollTop();
- */
-declare function getWindowScrollTop(): number;
-/**
- * 获取文档水平滚动位置
- * @example
- * const left = getWindowScrollLeft();
- */
-declare function getWindowScrollLeft(): number;
-/**
- * 平滑滚动到指定位置
- * @param top 目标纵向滚动位置
- * @param behavior 滚动行为，默认 'smooth'
- * @example
- * windowScrollTo(0);
- */
-declare function windowScrollTo(top: number, behavior?: ScrollBehavior): void;
-/**
- * 元素是否在视口内（可设置阈值）
- * @param el 目标元素
- * @param offset 额外判定偏移（像素，正数放宽，负数收紧）
- * @returns 是否在视口内
- */
-declare function isInViewport(el: Element, offset?: number): boolean;
-/**
- * 锁定页面滚动（移动端/PC）
- * 使用 `body{ position: fixed }` 技术消除滚动条抖动，记录并恢复滚动位置。
- * @example
- * lockBodyScroll();
- */
-declare function lockBodyScroll(): void;
-/**
- * 解除页面滚动锁定，恢复原始滚动位置
- * @example
- * unlockBodyScroll();
- */
-declare function unlockBodyScroll(): void;
-
-/**
- * 获取用户代理字符串（UA）
- * @returns navigator.userAgent.toLowerCase();
- */
-declare function getUA(): string;
-/**
- * 是否为移动端设备（含平板）
- */
-declare function isMobile(): boolean;
-/**
- * 是否为平板设备
- */
-declare function isTablet(): boolean;
-/**
- * 是否为 PC 设备
- */
-declare function isPC(): boolean;
-/**
- * 是否为 iOS 系统
- */
-declare function isIOS(): boolean;
-/**
- * 是否为 Android 系统
- */
-declare function isAndroid(): boolean;
-/**
- * 是否微信内置浏览器
- */
-declare function isWeChat(): boolean;
-/**
- * 是否为 Chrome 浏览器
- * 已排除 Edge、Opera 等基于 Chromium 的浏览器
- */
-declare function isChrome(): boolean;
-/**
- * 检测是否支持触摸事件
- */
-declare function isTouchSupported(): boolean;
-/**
- * 获取设备像素比
- */
-declare function getDevicePixelRatio(): number;
-/**
- * 获取浏览器名字
- */
-declare function getBrowserName(): string | null;
-/**
- * 获取浏览器版本号
- */
-declare function getBrowserVersion(): string | null;
-/**
- * 获取操作系统信息
- */
-declare function getOS(): string;
-
-export { copyBlob, copyHtml, copyImage, copyNode, copyRtf, copyTable, copyText, copyUrl, download, getBrowserName, getBrowserVersion, getCookie, getDevicePixelRatio, getDispositionFileName, getLocalStorage, getOS, getUA, getWindowHeight, getWindowScrollLeft, getWindowScrollTop, getWindowWidth, hasCss, hasJs, isAndroid, isChrome, isIOS, isInViewport, isMobile, isPC, isTablet, isTouchSupported, isWeChat, loadCss, loadJs, lockBodyScroll, parseAxiosBlob, preloadImage, removeCookie, removeLocalStorage, setCookie, setLocalStorage, unlockBodyScroll, windowScrollTo };
+export * from './clipboard';
+export * from './cookie';
+export * from './load';
+export * from './storage';
+export * from './dom';
+export * from './device';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/web/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC"}

package/dist/load/index.d.ts

@@ -0,0 +1,77 @@
+import type { AxiosResponse } from 'axios';
+/**
+ * 下载文件
+ * @param url 完整的下载地址 | base64字符串 | Blob对象
+ * @param fileName 自定义文件名（需含后缀）
+ * @example
+ * download('https://xx/xx.pdf');
+ * download('https://xx/xx.pdf', 'xx.pdf');
+ * download(blob, '图片.jpg');
+ */
+export declare function download(url: string | Blob, fileName?: string): Promise<void>;
+/**
+ * 解析Axios返回的Blob数据
+ * @param res Axios响应对象 (responseType='blob')
+ * @returns 包含blob数据和文件名的对象 { blob, fileName }
+ * @example
+ * const res = await axios.get(url, { responseType: 'blob' });
+ * const { blob, fileName } = await parseAxiosBlob(res);
+ * download(blob, fileName);
+ */
+export declare function parseAxiosBlob(res: AxiosResponse<Blob>): Promise<{
+    blob: Blob;
+    fileName: string;
+}>;
+/**
+ * 获取文件名
+ * @param disposition content-disposition头值
+ * @returns content-disposition中的filename
+ * @example
+ * const fileName = getDispositionFileName(headers['content-disposition']);
+ */
+export declare function getDispositionFileName(disposition?: string): string;
+/**
+ * 动态加载 JS（重复执行不会重复加载，内部已排重）
+ * @param src js 文件路径
+ * @param attrs 可选的脚本属性，如 async、defer、crossOrigin
+ * @example
+ * await loadJs('https://xx/xx.js');
+ * await loadJs('/a.js', { defer: true });
+ */
+export declare function loadJs(src: string, attrs?: Pick<HTMLScriptElement, 'async' | 'defer' | 'crossOrigin'>): Promise<void>;
+/**
+ * 判断某个 JS 地址是否已在页面中加载过
+ * @param src 相对、绝对路径的 JS 地址
+ * @returns 是否已加载过
+ * @example
+ * hasJs('https://xx/xx.js'); // boolean
+ * hasJs('/xx.js'); // boolean
+ * hasJs('xx.js'); // boolean
+ */
+export declare function hasJs(src: string): boolean;
+/**
+ * 动态加载 CSS（重复执行不会重复加载，内部已排重）
+ * @param href css 文件地址
+ * @param attrs 可选属性，如 crossOrigin、media
+ * @example
+ * await loadCss('https://xx/xx.css');
+ * await loadCss('/a.css', { media: 'print' });
+ */
+export declare function loadCss(href: string, attrs?: Pick<HTMLLinkElement, 'crossOrigin' | 'media'>): Promise<void>;
+/**
+ * 判断某个 CSS 地址是否已在页面中加载过
+ * @param href 相对、绝对路径的 CSS 地址
+ * @returns 是否已加载过
+ * @example
+ * hasCss('https://xx/xx.css'); // boolean
+ */
+export declare function hasCss(href: string): boolean;
+/**
+ * 预加载图片
+ * @param src 图片地址
+ * @returns Promise<HTMLImageElement>
+ * @example
+ * await preloadImage('/a.png');
+ */
+export declare function preloadImage(src: string): Promise<HTMLImageElement>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/load/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,SAAK,iBAyC/D;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC;;;GAc5D;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,UAkB1D;AAED;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAC1B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,OAAO,GAAG,aAAa,CAAC,iBAuBnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,WAOhC;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,GAAG,OAAO,CAAC,iBAuBvD;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,WAOlC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,6BAOvC"}

package/dist/storage/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 写入 localStorage（自动 JSON 序列化）
+ * 当 `value` 为 `null` 或 `undefined` 时，会移除该键。
+ * 支持保存：对象、数组、字符串、数字、布尔值。
+ * @param key 键名
+ * @param value 任意可序列化的值
+ * @param days 过期天数（从当前时间起算）
+ * @example
+ * setLocalStorage('user', { id: 1, name: 'Alice' }); // 对象
+ * setLocalStorage('age', 18); // 数字
+ * setLocalStorage('vip', true); // 布尔值
+ * setLocalStorage('token', 'abc123', 7); // 7 天后过期
+ */
+export declare function setLocalStorage(key: string, value: unknown, days?: number): void;
+/**
+ * 读取 localStorage（自动 JSON 反序列化）
+ * 若值为合法 JSON，则返回反序列化后的数据；
+ * 若值非 JSON（如外部写入的纯字符串），则原样返回字符串。
+ * 不存在时返回 `null`。
+ * @param key 键名
+ * @returns 解析后的值或 `null`
+ * @example
+ * const user = getLocalStorage<{ id: number; name: string }>('user');
+ * const age = getLocalStorage<number>('age');
+ * const vip = getLocalStorage<boolean>('vip');
+ */
+export declare function getLocalStorage<T = unknown>(key: string): T | null;
+/**
+ * 移除 localStorage 指定键
+ * @param key 键名
+ * @example
+ * removeLocalStorage('token');
+ */
+export declare function removeLocalStorage(key: string): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/storage/index.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,QAiBzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAiBlE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,QAE7C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base-web-kits/base-tools-web",
-  "version": "0.9.8",
+  "version": "0.9.9",
   "sideEffects": false,
   "description": "Independent Web utilities package built from src/web.",
   "keywords": [

package/dist/index.d.cts

@@ -1,319 +0,0 @@
-import { AxiosResponse } from 'axios';
-
-/**
- * 复制文本到剪贴板（兼容移动端和PC）
- * @returns Promise<void> 复制成功时 resolve，失败时 reject。
- * @example
- * await copyText('hello');
- * toast('复制成功');
- */
-declare function copyText(text: string): Promise<void>;
-/**
- * 复制富文本 HTML 到剪贴板（移动端与 PC）
- * 使用场景：图文混排文章、带样式段落，保留格式粘贴。
- * @param html HTML字符串
- * @example
- * await copyHtml('<p><b>加粗</b> 与 <i>斜体</i></p>');
- */
-declare function copyHtml(html: string): Promise<void>;
-/**
- * 复制 DOM 节点到剪贴板（移动端与 PC）
- * 使用场景：页面已有区域的可视化复制；元素使用 `outerHTML`，非元素使用其文本内容。
- * @param node DOM 节点（元素或文本节点）
- * @example
- * const el = document.querySelector('#article')!;
- * await copyNode(el);
- */
-declare function copyNode(node: Node): Promise<void>;
-/**
- * 复制单张图片到剪贴板（移动端与 PC，需浏览器支持 `ClipboardItem`）
- * 使用场景：把本地 `canvas` 或 `Blob` 生成的图片直接粘贴到聊天/文档。
- * @param image 图片源（Blob/Canvas/ImageBitmap）
- * @example
- * const canvas = document.querySelector('canvas')!;
- * await copyImage(canvas);
- */
-declare function copyImage(image: Blob | HTMLCanvasElement | ImageBitmap): Promise<void>;
-/**
- * 复制 URL 到剪贴板（移动端与 PC）
- * 写入 `text/uri-list` 与 `text/plain`，在支持 URI 列表的应用中可识别为链接。
- * @param url 完整的 URL 字符串
- * @example
- * await copyUrl('https://example.com/page');
- */
-declare function copyUrl(url: string): Promise<void>;
-/**
- * 复制任意 Blob 到剪贴板（移动端与 PC，需 `ClipboardItem`）
- * 使用场景：原生格式粘贴（如 `image/svg+xml`、`application/pdf` 等）。
- * @param blob 任意 Blob 数据
- * @example
- * const svg = new Blob(['<svg></svg>'], { type: 'image/svg+xml' });
- * await copyBlob(svg);
- */
-declare function copyBlob(blob: Blob): Promise<void>;
-/**
- * 复制 RTF 富文本到剪贴板（移动端与 PC）
- * 同时写入 `text/plain`，增强与 Office/富文本编辑器的兼容性。
- * @param rtf RTF 字符串（如：`{\\rtf1\\ansi ...}`）
- * @example
- * await copyRtf('{\\rtf1\\ansi Hello \\b World}');
- */
-declare function copyRtf(rtf: string): Promise<void>;
-/**
- * 复制表格到剪贴板（移动端与 PC）
- * 同时写入多种 MIME：`text/html`（表格）、`text/tab-separated-values`（TSV）、`text/csv`、`text/plain`（TSV）。
- * 使用场景：优化粘贴到 Excel/Google Sheets/Docs 的体验
- * @param rows 二维数组，每行一个数组（字符串/数字）
- * @example
- * await copyTable([
- *   ['姓名', '分数'],
- *   ['张三', 95],
- *   ['李四', 88],
- * ]);
- */
-declare function copyTable(rows: Array<Array<string | number>>): Promise<void>;
-
-/**
- * 设置 Cookie（路径默认为 `/`）
- * @param name Cookie 名称
- * @param value Cookie 值（内部已使用 `encodeURIComponent` 编码）
- * @param days 过期天数（从当前时间起算）
- * @example
- * setCookie('token', 'abc', 7);
- */
-declare function setCookie(name: string, value: string, days: number): void;
-/**
- * 获取 Cookie
- * @param name Cookie 名称
- * @returns 若存在返回解码后的值，否则 `null`
- * @example
- * const token = getCookie('token');
- */
-declare function getCookie(name: string): string | null;
-/**
- * 移除 Cookie（通过设置过期时间为过去）
- * 路径固定为 `/`，确保与默认写入路径一致。
- * @param name Cookie 名称
- * @example
- * removeCookie('token');
- */
-declare function removeCookie(name: string): void;
-
-/**
- * 下载文件
- * @param url 完整的下载地址 | base64字符串 | Blob对象
- * @param fileName 自定义文件名（需含后缀）
- * @example
- * download('https://xx/xx.pdf');
- * download('https://xx/xx.pdf', 'xx.pdf');
- * download(blob, '图片.jpg');
- */
-declare function download(url: string | Blob, fileName?: string): Promise<void>;
-/**
- * 解析Axios返回的Blob数据
- * @param res Axios响应对象 (responseType='blob')
- * @returns 包含blob数据和文件名的对象 { blob, fileName }
- * @example
- * const res = await axios.get(url, { responseType: 'blob' });
- * const { blob, fileName } = await parseAxiosBlob(res);
- * download(blob, fileName);
- */
-declare function parseAxiosBlob(res: AxiosResponse<Blob>): Promise<{
-    blob: Blob;
-    fileName: string;
-}>;
-/**
- * 获取文件名
- * @param disposition content-disposition头值
- * @returns content-disposition中的filename
- * @example
- * const fileName = getDispositionFileName(headers['content-disposition']);
- */
-declare function getDispositionFileName(disposition?: string): string;
-/**
- * 动态加载 JS（重复执行不会重复加载，内部已排重）
- * @param src js 文件路径
- * @param attrs 可选的脚本属性，如 async、defer、crossOrigin
- * @example
- * await loadJs('https://xx/xx.js');
- * await loadJs('/a.js', { defer: true });
- */
-declare function loadJs(src: string, attrs?: Pick<HTMLScriptElement, 'async' | 'defer' | 'crossOrigin'>): Promise<void>;
-/**
- * 判断某个 JS 地址是否已在页面中加载过
- * @param src 相对、绝对路径的 JS 地址
- * @returns 是否已加载过
- * @example
- * hasJs('https://xx/xx.js'); // boolean
- * hasJs('/xx.js'); // boolean
- * hasJs('xx.js'); // boolean
- */
-declare function hasJs(src: string): boolean;
-/**
- * 动态加载 CSS（重复执行不会重复加载，内部已排重）
- * @param href css 文件地址
- * @param attrs 可选属性，如 crossOrigin、media
- * @example
- * await loadCss('https://xx/xx.css');
- * await loadCss('/a.css', { media: 'print' });
- */
-declare function loadCss(href: string, attrs?: Pick<HTMLLinkElement, 'crossOrigin' | 'media'>): Promise<void>;
-/**
- * 判断某个 CSS 地址是否已在页面中加载过
- * @param href 相对、绝对路径的 CSS 地址
- * @returns 是否已加载过
- * @example
- * hasCss('https://xx/xx.css'); // boolean
- */
-declare function hasCss(href: string): boolean;
-/**
- * 预加载图片
- * @param src 图片地址
- * @returns Promise<HTMLImageElement>
- * @example
- * await preloadImage('/a.png');
- */
-declare function preloadImage(src: string): Promise<HTMLImageElement>;
-
-/**
- * 写入 localStorage（自动 JSON 序列化）
- * 当 `value` 为 `null` 或 `undefined` 时，会移除该键。
- * 支持保存：对象、数组、字符串、数字、布尔值。
- * @param key 键名
- * @param value 任意可序列化的值
- * @param days 过期天数（从当前时间起算）
- * @example
- * setLocalStorage('user', { id: 1, name: 'Alice' }); // 对象
- * setLocalStorage('age', 18); // 数字
- * setLocalStorage('vip', true); // 布尔值
- * setLocalStorage('token', 'abc123', 7); // 7 天后过期
- */
-declare function setLocalStorage(key: string, value: unknown, days?: number): void;
-/**
- * 读取 localStorage（自动 JSON 反序列化）
- * 若值为合法 JSON，则返回反序列化后的数据；
- * 若值非 JSON（如外部写入的纯字符串），则原样返回字符串。
- * 不存在时返回 `null`。
- * @param key 键名
- * @returns 解析后的值或 `null`
- * @example
- * const user = getLocalStorage<{ id: number; name: string }>('user');
- * const age = getLocalStorage<number>('age');
- * const vip = getLocalStorage<boolean>('vip');
- */
-declare function getLocalStorage<T = unknown>(key: string): T | null;
-/**
- * 移除 localStorage 指定键
- * @param key 键名
- * @example
- * removeLocalStorage('token');
- */
-declare function removeLocalStorage(key: string): void;
-
-/**
- * 获取窗口宽度（不含滚动条）
- * @returns 窗口宽度
- */
-declare function getWindowWidth(): number;
-/**
- * 获取窗口高度（不含滚动条）
- * @returns 窗口高度
- */
-declare function getWindowHeight(): number;
-/**
- * 获取文档垂直滚动位置
- * @example
- * const top = getWindowScrollTop();
- */
-declare function getWindowScrollTop(): number;
-/**
- * 获取文档水平滚动位置
- * @example
- * const left = getWindowScrollLeft();
- */
-declare function getWindowScrollLeft(): number;
-/**
- * 平滑滚动到指定位置
- * @param top 目标纵向滚动位置
- * @param behavior 滚动行为，默认 'smooth'
- * @example
- * windowScrollTo(0);
- */
-declare function windowScrollTo(top: number, behavior?: ScrollBehavior): void;
-/**
- * 元素是否在视口内（可设置阈值）
- * @param el 目标元素
- * @param offset 额外判定偏移（像素，正数放宽，负数收紧）
- * @returns 是否在视口内
- */
-declare function isInViewport(el: Element, offset?: number): boolean;
-/**
- * 锁定页面滚动（移动端/PC）
- * 使用 `body{ position: fixed }` 技术消除滚动条抖动，记录并恢复滚动位置。
- * @example
- * lockBodyScroll();
- */
-declare function lockBodyScroll(): void;
-/**
- * 解除页面滚动锁定，恢复原始滚动位置
- * @example
- * unlockBodyScroll();
- */
-declare function unlockBodyScroll(): void;
-
-/**
- * 获取用户代理字符串（UA）
- * @returns navigator.userAgent.toLowerCase();
- */
-declare function getUA(): string;
-/**
- * 是否为移动端设备（含平板）
- */
-declare function isMobile(): boolean;
-/**
- * 是否为平板设备
- */
-declare function isTablet(): boolean;
-/**
- * 是否为 PC 设备
- */
-declare function isPC(): boolean;
-/**
- * 是否为 iOS 系统
- */
-declare function isIOS(): boolean;
-/**
- * 是否为 Android 系统
- */
-declare function isAndroid(): boolean;
-/**
- * 是否微信内置浏览器
- */
-declare function isWeChat(): boolean;
-/**
- * 是否为 Chrome 浏览器
- * 已排除 Edge、Opera 等基于 Chromium 的浏览器
- */
-declare function isChrome(): boolean;
-/**
- * 检测是否支持触摸事件
- */
-declare function isTouchSupported(): boolean;
-/**
- * 获取设备像素比
- */
-declare function getDevicePixelRatio(): number;
-/**
- * 获取浏览器名字
- */
-declare function getBrowserName(): string | null;
-/**
- * 获取浏览器版本号
- */
-declare function getBrowserVersion(): string | null;
-/**
- * 获取操作系统信息
- */
-declare function getOS(): string;
-
-export { copyBlob, copyHtml, copyImage, copyNode, copyRtf, copyTable, copyText, copyUrl, download, getBrowserName, getBrowserVersion, getCookie, getDevicePixelRatio, getDispositionFileName, getLocalStorage, getOS, getUA, getWindowHeight, getWindowScrollLeft, getWindowScrollTop, getWindowWidth, hasCss, hasJs, isAndroid, isChrome, isIOS, isInViewport, isMobile, isPC, isTablet, isTouchSupported, isWeChat, loadCss, loadJs, lockBodyScroll, parseAxiosBlob, preloadImage, removeCookie, removeLocalStorage, setCookie, setLocalStorage, unlockBodyScroll, windowScrollTo };