@base-web-kits/base-tools-web 0.0.2 → 0.0.8

package/README.md

@@ -1,3 +1,32 @@
-# @base-web-kits/base-tools-web
+# Base Tools
 
-薄包装分包，转发到主包的 `web` 子路径：`@base-web-kits/base-tools/web`。
+web前端团队常用工具库，包含`ts`、`web`、`react`、`vue`、`uni`模块。
+
+**安装**
+
+用哪个模块就安装哪个,模块之间不会相互依赖
+
+- `npm i @base-web-kits/base-tools-ts`
+- `npm i @base-web-kits/base-tools-web`
+- `npm i @base-web-kits/base-tools-react`
+- `npm i @base-web-kits/base-tools-vue`
+- `npm i @base-web-kits/base-tools-uni`
+
+**快速使用**
+
+```ts
+// 通用 TS 模块
+import { toDayjs, getUrlParam, toMaskPhone } from '@base-web-kits/base-tools-ts';
+
+// Web 模块
+import { copyText, isPC, download, setCookie } from '@base-web-kits/base-tools-web';
+
+// React 模块
+import { useCountDown } from '@base-web-kits/base-tools-react';
+
+// Vue 模块
+import { useResizeObserver } from '@base-web-kits/base-tools-vue';
+
+// Uni 模块
+import { chooseMedia, toPayWx } from '@base-web-kits/base-tools-uni';
+```

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

@@ -0,0 +1,10 @@
+/**
+ * 内部统一导出, 外部快捷引入: import {xx} from 'base-tools/web'
+ */
+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/index.js

@@ -0,0 +1,556 @@
+// src/web/clipboard/index.ts
+async function copyText(text) {
+  if (typeof text !== "string") text = String(text ?? "");
+  if (navigator.clipboard && typeof navigator.clipboard.writeText === "function") {
+    try {
+      await navigator.clipboard.writeText(text);
+      return;
+    } catch (e) {
+    }
+  }
+  return new Promise((resolve, reject) => {
+    try {
+      const textarea = document.createElement("textarea");
+      textarea.value = text;
+      textarea.setAttribute("readonly", "");
+      textarea.style.position = "fixed";
+      textarea.style.top = "0";
+      textarea.style.right = "-9999px";
+      textarea.style.opacity = "0";
+      textarea.style.pointerEvents = "none";
+      document.body.appendChild(textarea);
+      textarea.focus();
+      textarea.select();
+      textarea.setSelectionRange(0, textarea.value.length);
+      const ok = document.execCommand("copy");
+      document.body.removeChild(textarea);
+      if (ok) {
+        resolve();
+      } else {
+        reject(new Error("Copy failed: clipboard unavailable"));
+      }
+    } catch (e) {
+      reject(e);
+    }
+  });
+}
+async function copyHtml(html) {
+  const s = String(html ?? "");
+  if (canWriteClipboard()) {
+    const plain = htmlToText(s);
+    await writeClipboard({
+      "text/html": new Blob([s], { type: "text/html" }),
+      "text/plain": new Blob([plain], { type: "text/plain" })
+    });
+    return;
+  }
+  return execCopyFromHtml(s);
+}
+async function copyNode(node) {
+  if (canWriteClipboard()) {
+    const { html: html2, text } = nodeToHtmlText(node);
+    await writeClipboard({
+      "text/html": new Blob([html2], { type: "text/html" }),
+      "text/plain": new Blob([text], { type: "text/plain" })
+    });
+    return;
+  }
+  const { html } = nodeToHtmlText(node);
+  return execCopyFromHtml(html);
+}
+async function copyImage(image) {
+  const blob = await toImageBlob(image);
+  if (!blob) throw new Error("Unsupported image source");
+  if (canWriteClipboard()) {
+    const type = blob.type || "image/png";
+    await writeClipboard({ [type]: blob });
+    return;
+  }
+  throw new Error("Clipboard image write not supported");
+}
+async function copyUrl(url) {
+  const s = String(url ?? "");
+  if (canWriteClipboard()) {
+    await writeClipboard({
+      "text/uri-list": new Blob([s], { type: "text/uri-list" }),
+      "text/plain": new Blob([s], { type: "text/plain" })
+    });
+    return;
+  }
+  await copyText(s);
+}
+async function copyBlob(blob) {
+  if (canWriteClipboard()) {
+    const type = blob.type || "application/octet-stream";
+    await writeClipboard({ [type]: blob });
+    return;
+  }
+  throw new Error("Clipboard blob write not supported");
+}
+async function copyRtf(rtf) {
+  const s = String(rtf ?? "");
+  if (canWriteClipboard()) {
+    const plain = s.replace(/\\par[\s]?/g, "\n").replace(/\{[^}]*\}/g, "").replace(/\\[a-zA-Z]+[0-9'-]*/g, "").replace(/\r?\n/g, "\n").trim();
+    await writeClipboard({
+      "text/rtf": new Blob([s], { type: "text/rtf" }),
+      "text/plain": new Blob([plain], { type: "text/plain" })
+    });
+    return;
+  }
+  await copyText(s);
+}
+async function copyTable(rows) {
+  const data = Array.isArray(rows) ? rows : [];
+  const escapeHtml = (t) => t.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+  const html = (() => {
+    const trs = data.map((r) => `<tr>${r.map((c) => `<td>${escapeHtml(String(c))}</td>`).join("")}</tr>`).join("");
+    return `<table>${trs}</table>`;
+  })();
+  const tsv = data.map((r) => r.map((c) => String(c)).join("	")).join("\n");
+  const csv = data.map(
+    (r) => r.map((c) => {
+      const s = String(c);
+      const needQuote = /[",\n]/.test(s);
+      const escaped = s.replace(/"/g, '""');
+      return needQuote ? `"${escaped}"` : escaped;
+    }).join(",")
+  ).join("\n");
+  if (canWriteClipboard()) {
+    await writeClipboard({
+      "text/html": new Blob([html], { type: "text/html" }),
+      "text/tab-separated-values": new Blob([tsv], { type: "text/tab-separated-values" }),
+      "text/csv": new Blob([csv], { type: "text/csv" }),
+      "text/plain": new Blob([tsv], { type: "text/plain" })
+    });
+    return;
+  }
+  await copyText(tsv);
+}
+async function toImageBlob(image) {
+  if (image instanceof Blob) return image;
+  if (image instanceof HTMLCanvasElement)
+    return await new Promise((resolve, reject) => {
+      image.toBlob(
+        (b) => b ? resolve(b) : reject(new Error("Canvas toBlob failed")),
+        "image/png"
+      );
+    });
+  const isBitmap = typeof ImageBitmap !== "undefined" && image instanceof ImageBitmap;
+  if (isBitmap) {
+    const cnv = document.createElement("canvas");
+    cnv.width = image.width;
+    cnv.height = image.height;
+    const ctx = cnv.getContext("2d");
+    ctx?.drawImage(image, 0, 0);
+    return await new Promise((resolve, reject) => {
+      cnv.toBlob((b) => b ? resolve(b) : reject(new Error("Canvas toBlob failed")), "image/png");
+    });
+  }
+  return null;
+}
+function canWriteClipboard() {
+  return !!(navigator.clipboard && typeof navigator.clipboard.write === "function" && typeof ClipboardItem !== "undefined");
+}
+async function writeClipboard(items) {
+  await navigator.clipboard.write([new ClipboardItem(items)]);
+}
+function htmlToText(html) {
+  const div = document.createElement("div");
+  div.innerHTML = html;
+  return div.textContent || "";
+}
+function nodeToHtmlText(node) {
+  const container = document.createElement("div");
+  container.appendChild(node.cloneNode(true));
+  const html = node instanceof Element ? node.outerHTML ?? container.innerHTML : container.innerHTML;
+  const text = container.textContent || "";
+  return { html, text };
+}
+function execCopyFromHtml(html) {
+  return new Promise((resolve, reject) => {
+    try {
+      const div = document.createElement("div");
+      div.contentEditable = "true";
+      div.style.position = "fixed";
+      div.style.top = "0";
+      div.style.right = "-9999px";
+      div.style.opacity = "0";
+      div.style.pointerEvents = "none";
+      div.innerHTML = html;
+      document.body.appendChild(div);
+      const selection = window.getSelection();
+      const range = document.createRange();
+      range.selectNodeContents(div);
+      selection?.removeAllRanges();
+      selection?.addRange(range);
+      const ok = document.execCommand("copy");
+      document.body.removeChild(div);
+      selection?.removeAllRanges();
+      if (ok) {
+        resolve();
+      } else {
+        reject(new Error("Copy failed: clipboard unavailable"));
+      }
+    } catch (e) {
+      reject(e);
+    }
+  });
+}
+
+// src/web/cookie/index.ts
+function setCookie(name, value, days) {
+  const date = /* @__PURE__ */ new Date();
+  date.setTime(date.getTime() + days * 24 * 60 * 60 * 1e3);
+  const expires = `expires=${date.toUTCString()}; path=/`;
+  document.cookie = `${name}=${encodeURIComponent(value)}; ${expires}`;
+}
+function getCookie(name) {
+  const value = `; ${document.cookie}`;
+  const parts = value.split(`; ${name}=`);
+  if (parts.length === 2) {
+    const v = parts.pop()?.split(";").shift();
+    return v ? decodeURIComponent(v) : null;
+  }
+  return null;
+}
+function removeCookie(name) {
+  document.cookie = `${name}=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/`;
+}
+
+// src/web/load/index.ts
+async function download(url, fileName = "") {
+  if (!url) return;
+  let blobUrl = "";
+  let needRevoke = false;
+  try {
+    if (url instanceof Blob) {
+      blobUrl = URL.createObjectURL(url);
+      needRevoke = true;
+    } else if (url.includes(";base64,")) {
+      blobUrl = url;
+    } else {
+      if (fileName) {
+        const res = await fetch(url);
+        if (!res.ok) throw new Error(`fetch error ${res.status}\uFF1A${url}`);
+        const blob = await res.blob();
+        blobUrl = URL.createObjectURL(blob);
+        needRevoke = true;
+      } else {
+        blobUrl = url;
+      }
+    }
+    const a = document.createElement("a");
+    a.href = blobUrl;
+    a.download = fileName;
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+  } finally {
+    if (needRevoke) {
+      setTimeout(() => URL.revokeObjectURL(blobUrl), 100);
+    }
+  }
+}
+async function parseAxiosBlob(res) {
+  const { data, headers, status, statusText, config } = res;
+  if (status < 200 || status >= 300) throw new Error(`${status}\uFF0C${statusText}\uFF1A${config.url}`);
+  if (data.type.includes("application/json")) {
+    const txt = await data.text();
+    throw JSON.parse(txt);
+  }
+  const fileName = getDispositionFileName(headers["content-disposition"]);
+  return { blob: data, fileName };
+}
+function getDispositionFileName(disposition) {
+  if (!disposition) return "";
+  const rfc5987 = /filename\*\s*=\s*([^']*)''([^;]*)/i.exec(disposition);
+  if (rfc5987?.[2]) {
+    try {
+      return decodeURIComponent(rfc5987[2].trim()).replace(/[\r\n]+/g, "");
+    } catch {
+      return rfc5987[2].trim().replace(/[\r\n]+/g, "");
+    }
+  }
+  const old = /filename\s*=\s*(?:"([^"]*)"|([^";]*))(?=;|$)/i.exec(disposition);
+  if (old) return (old[1] ?? old[2]).trim().replace(/[\r\n]+/g, "");
+  return "";
+}
+async function loadJs(src, attrs) {
+  return new Promise((resolve, reject) => {
+    if (hasJs(src)) return resolve();
+    const script = document.createElement("script");
+    script.type = "text/javascript";
+    script.src = src;
+    if (attrs) {
+      const keys = Object.keys(attrs);
+      keys.forEach((key) => {
+        const v = attrs[key];
+        if (v === null || v === void 0 || v === false) return;
+        script.setAttribute(key, typeof v === "boolean" ? "" : v);
+      });
+    }
+    script.onload = () => resolve();
+    script.onerror = (e) => reject(e);
+    document.head.appendChild(script);
+  });
+}
+function hasJs(src) {
+  const target = new URL(src, document.baseURI).href;
+  const jsList = Array.from(document.querySelectorAll("script[src]"));
+  return jsList.some((e) => {
+    const src2 = e.getAttribute("src");
+    return src2 && new URL(src2, document.baseURI).href === target;
+  });
+}
+async function loadCss(href, attrs) {
+  return new Promise((resolve, reject) => {
+    if (hasCss(href)) return resolve();
+    const link = document.createElement("link");
+    link.rel = "stylesheet";
+    link.href = href;
+    if (attrs) {
+      const keys = Object.keys(attrs);
+      keys.forEach((key) => {
+        const v = attrs[key];
+        if (v === null || v === void 0) return;
+        link.setAttribute(key, String(v));
+      });
+    }
+    link.onload = () => resolve();
+    link.onerror = (e) => reject(e);
+    document.head.appendChild(link);
+  });
+}
+function hasCss(href) {
+  const target = new URL(href, document.baseURI).href;
+  const list = Array.from(document.querySelectorAll('link[rel="stylesheet"][href]'));
+  return list.some((e) => {
+    const h = e.getAttribute("href");
+    return h && new URL(h, document.baseURI).href === target;
+  });
+}
+function preloadImage(src) {
+  return new Promise((resolve, reject) => {
+    const img = new Image();
+    img.onload = () => resolve(img);
+    img.onerror = (e) => reject(e);
+    img.src = src;
+  });
+}
+
+// src/web/storage/index.ts
+function setLocalStorage(key, value, days) {
+  if (value === void 0 || value === null) {
+    removeLocalStorage(key);
+    return;
+  }
+  let toStore = value;
+  if (typeof days === "number" && days > 0) {
+    const ms = Math.floor(days * 24 * 60 * 60 * 1e3);
+    toStore = { __l_val: value, __l_exp: Date.now() + ms };
+  }
+  localStorage.setItem(key, JSON.stringify(toStore));
+}
+function getLocalStorage(key) {
+  const raw = localStorage.getItem(key);
+  if (raw === null) return null;
+  try {
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object") {
+      const obj = parsed;
+      if ("__l_exp" in obj && "__l_val" in obj) {
+        const exp = obj.__l_exp;
+        if (typeof exp === "number" && Date.now() >= exp) {
+          removeLocalStorage(key);
+          return null;
+        }
+        return obj.__l_val;
+      }
+    }
+    return parsed;
+  } catch {
+    return raw;
+  }
+}
+function removeLocalStorage(key) {
+  localStorage.removeItem(key);
+}
+
+// src/web/dom/index.ts
+function getWindowWidth() {
+  return window.innerWidth || document.documentElement.clientWidth || document.body.clientWidth;
+}
+function getWindowHeight() {
+  return window.innerHeight || document.documentElement.clientHeight || document.body.clientHeight;
+}
+function getWindowScrollTop() {
+  const doc = document.documentElement;
+  const body = document.body;
+  return window.pageYOffset || doc.scrollTop || body.scrollTop || 0;
+}
+function getWindowScrollLeft() {
+  const doc = document.documentElement;
+  const body = document.body;
+  return window.pageXOffset || doc.scrollLeft || body.scrollLeft || 0;
+}
+function windowScrollTo(top, behavior = "smooth") {
+  if ("scrollBehavior" in document.documentElement.style) {
+    window.scrollTo({ top, behavior });
+  } else {
+    window.scrollTo(0, top);
+  }
+}
+function isInViewport(el, offset = 0) {
+  const rect = el.getBoundingClientRect();
+  const width = getWindowWidth();
+  const height = getWindowHeight();
+  return rect.bottom >= -offset && rect.right >= -offset && rect.top <= height + offset && rect.left <= width + offset;
+}
+function lockBodyScroll() {
+  const body = document.body;
+  if (body.dataset.scrollLock === "true") return;
+  const y = Math.round(window.scrollY || window.pageYOffset || 0);
+  body.dataset.scrollLock = "true";
+  body.dataset.scrollLockY = String(y);
+  body.style.position = "fixed";
+  body.style.top = `-${y}px`;
+  body.style.left = "0";
+  body.style.right = "0";
+  body.style.width = "100%";
+}
+function unlockBodyScroll() {
+  const body = document.body;
+  if (body.dataset.scrollLock !== "true") return;
+  const y = Number(body.dataset.scrollLockY || 0);
+  body.style.position = "";
+  body.style.top = "";
+  body.style.left = "";
+  body.style.right = "";
+  body.style.width = "";
+  delete body.dataset.scrollLock;
+  delete body.dataset.scrollLockY;
+  window.scrollTo(0, y);
+}
+
+// src/web/device/index.ts
+function getUA() {
+  if (typeof navigator === "undefined") return "";
+  return (navigator.userAgent || "").toLowerCase();
+}
+function isMobile() {
+  const ua = getUA();
+  return /android|webos|iphone|ipod|blackberry|iemobile|opera mini|mobile/i.test(ua);
+}
+function isTablet() {
+  const ua = getUA();
+  return /ipad|android(?!.*mobile)|tablet/i.test(ua) && !/mobile/i.test(ua);
+}
+function isPC() {
+  return !isMobile() && !isTablet();
+}
+function isIOS() {
+  const ua = getUA();
+  return /iphone|ipad|ipod/i.test(ua);
+}
+function isAndroid() {
+  const ua = getUA();
+  return /android/i.test(ua);
+}
+function isWeChat() {
+  const ua = getUA();
+  return /micromessenger/i.test(ua);
+}
+function isChrome() {
+  const ua = getUA();
+  return /chrome\//i.test(ua) && !/edg\//i.test(ua) && !/opr\//i.test(ua) && !/whale\//i.test(ua);
+}
+function isTouchSupported() {
+  if (typeof window === "undefined") return false;
+  return "ontouchstart" in window || navigator.maxTouchPoints > 0;
+}
+function getDevicePixelRatio() {
+  if (typeof window === "undefined") return 1;
+  return window.devicePixelRatio || 1;
+}
+function getBrowserName() {
+  const ua = getUA();
+  if (/chrome\//i.test(ua)) return "chrome";
+  if (/safari\//i.test(ua)) return "safari";
+  if (/firefox\//i.test(ua)) return "firefox";
+  if (/opr\//i.test(ua)) return "opera";
+  if (/edg\//i.test(ua)) return "edge";
+  if (/msie|trident/i.test(ua)) return "ie";
+  return null;
+}
+function getBrowserVersion() {
+  const ua = getUA();
+  const versionPatterns = [
+    /(?:edg|edge)\/([0-9.]+)/i,
+    /(?:opr|opera)\/([0-9.]+)/i,
+    /chrome\/([0-9.]+)/i,
+    /firefox\/([0-9.]+)/i,
+    /version\/([0-9.]+).*safari/i,
+    /(?:msie |rv:)([0-9.]+)/i
+  ];
+  for (const pattern of versionPatterns) {
+    const matches = ua.match(pattern);
+    if (matches && matches[1]) {
+      return matches[1];
+    }
+  }
+  return null;
+}
+function getOS() {
+  const ua = getUA();
+  if (/windows/i.test(ua)) return "windows";
+  if (/mac os/i.test(ua)) return "macos";
+  if (/linux/i.test(ua)) return "linux";
+  if (/iphone|ipad|ipod/i.test(ua)) return "ios";
+  if (/android/i.test(ua)) return "android";
+  return "unknown";
+}
+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
+};

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":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,QAWzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAoBlE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,QAE7C"}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@base-web-kits/base-tools-web",
-  "version": "0.0.2",
+  "version": "0.0.8",
   "type": "module",
   "sideEffects": false,
-  "description": "Thin wrapper for @base-web-kits/base-tools/web to improve auto-imports in legacy JS projects.",
+  "description": "Independent Web utilities package built from src/web.",
   "keywords": [
     "base-tools",
     "web",
@@ -13,18 +13,15 @@
   "license": "MIT",
   "exports": {
     ".": {
-      "types": "./index.d.ts",
-      "import": "./index.js"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
   },
   "files": [
-    "index.js",
-    "index.d.ts",
+    "dist",
     "README.md"
   ],
-  "dependencies": {
-    "@base-web-kits/base-tools": "^0.0.2"
-  },
+  "dependencies": {},
   "publishConfig": {
     "registry": "https://registry.npmjs.org"
   }

package/index.d.ts

@@ -1,2 +0,0 @@
-// Types re-export for editor support
-export * from '@base-web-kits/base-tools/web';

package/index.js

@@ -1,2 +0,0 @@
-// Thin wrapper: re-export web subpath to improve auto-imports in legacy JS projects
-export * from '@base-web-kits/base-tools/web';