@base-web-kits/base-tools-web 1.3.5 → 1.3.8

package/README.md

@@ -98,3 +98,96 @@ setBaseToolsConfig({
   </body>
 </html>
 ```
+
+## 🤖 AI 智能助手 (Skill)
+
+本项目提供了强大的 AI Skill，可让 Cursor、Trae、Claude Code 等 AI 助手深度理解 `@base-web-kits` 的能力，为您精准推荐最佳实践函数，并自动处理依赖安装。
+
+### 安装方式
+
+在项目根目录下执行以下命令：
+
+```bash
+npx skills add gancao-web/base-tools
+```
+
+### 验证生效
+
+安装完成后，可以在对话框中输入以下问题进行测试。如果 AI 推荐了 `@base-web-kits` 下的相关包或函数，说明配置已生效。
+
+| 测试场景 | 推荐提问 | 预期 AI 回答 |
+| :-- | :-- | :-- |
+| **JS工具库** | "我需要深拷贝一个对象,请编写或推荐一个函数,优先考虑已配置的skill" | 推荐使用 `base-tools-ts` 的 `cloneDeep` |
+| **JS正则验证** | "我需要校验邮箱格式,请编写或推荐一个函数,优先考虑已配置的skill" | 推荐使用 `base-tools-ts` 的 `isEmail` |
+| **通用web** | "我需要复制文本到剪贴板,请编写或推荐一个函数,优先考虑已配置的skill" | 推荐使用 `base-tools-web` 的 `copyText` |
+| **React项目** | "我需要监听dom元素的尺寸变化,请编写或推荐一个函数,优先考虑已配置的skill" | 推荐使用 `base-tools-react` 的 `useSize` |
+| **Vue项目** | "我需要监听元素外部点击事件,请编写或推荐一个函数,优先考虑已配置的skill" | 推荐使用 `base-tools-vue` 的 `onClickOutside` |
+| **UniApp项目** | "我需要保存网络图片到系统相册,请编写或推荐一个函数,优先考虑已配置的skill" | 推荐使用 `base-tools-uni` 的 `saveImageToPhotosAlbum` 函数 |
+
+## 兼容性
+
+本工具库和相关依赖可能涉及的新特性及其最低兼容版本：
+
+| 特性                                      | ES 版本 | 最低兼容版本 (Browser/OS)           |
+| :---------------------------------------- | :------ | :---------------------------------- |
+| **Array.prototype.includes**              | ES2016  | Chrome 47+, iOS 9+, Android 6.0+    |
+| **Object.values / entries**               | ES2017  | Chrome 54+, iOS 10.3+, Android 7.0+ |
+| **String.prototype.padStart / padEnd**    | ES2017  | Chrome 57+, iOS 10.3+, Android 8.0+ |
+| **Object.getOwnPropertyDescriptors**      | ES2017  | Chrome 54+, iOS 10.3+, Android 7.0+ |
+| **Promise.prototype.finally**             | ES2018  | Chrome 63+, iOS 11.3+, Android 9.0+ |
+| **Async Iterator (Symbol.asyncIterator)** | ES2018  | Chrome 63+, iOS 12.0+, Android 9.0+ |
+| **Object.fromEntries**                    | ES2019  | Chrome 73+, iOS 12.2+, Android 10+  |
+| **Array.prototype.flat / flatMap**        | ES2019  | Chrome 69+, iOS 12.0+, Android 9.0+ |
+| **String.prototype.trimStart / trimEnd**  | ES2019  | Chrome 66+, iOS 12.0+, Android 9.0+ |
+| **Promise.allSettled**                    | ES2020  | Chrome 76+, iOS 13.0+, Android 10+  |
+| **String.prototype.matchAll**             | ES2020  | Chrome 80+, iOS 13.0+, Android 10+  |
+| **BigInt**                                | ES2020  | Chrome 67+, iOS 14.0+, Android 11+  |
+| **globalThis**                            | ES2020  | Chrome 71+, iOS 12.2+, Android 9.0+ |
+| **String.prototype.replaceAll**           | ES2021  | Chrome 85+, iOS 13.4+, Android 11+  |
+| **Promise.any**                           | ES2021  | Chrome 85+, iOS 14.0+, Android 11+  |
+| **WeakRef / FinalizationRegistry**        | ES2021  | Chrome 84+, iOS 14.5+, Android 11+  |
+| **Array/String.prototype.at**             | ES2022  | Chrome 92+, iOS 15.4+, Android 12+  |
+| **Error.prototype.cause**                 | ES2022  | Chrome 93+, iOS 15.0+, Android 12+  |
+| **Object.hasOwn**                         | ES2022  | Chrome 93+, iOS 15.4+, Android 12+  |
+
+本工具库构建目标为 **ES2015+**。但不内置 Polyfill, 如需支持低版本浏览器, 请务必在项目中配置 Polyfill。
+
+### 配置 Polyfill
+
+需经过两步:
+
+1. 配置打包工具, 将ES6+代码转换为ES5。
+2. 在入口文件顶部引入 `core-js` 进行 Polyfill。
+
+以 Vite 项目为例:
+
+1. 使用 `@vitejs/plugin-legacy` 插件，将ES6+代码转换为ES5。
+
+```ts
+// vite.config.ts
+import legacy from '@vitejs/plugin-legacy'; // 安装命令: npm install -D @vitejs/plugin-legacy
+
+export default {
+  plugins: [
+    legacy({
+      // 与antd4兼容性对齐 https://4x-ant-design.antgroup.com/docs/react/introduce-cn
+      // targets: ['defaults', 'not IE 11'],
+
+      // 与vant4兼容性对齐 https://vant4.ylhtest.com/#/zh-CN/home
+      // targets: ['chrome >= 51', 'android >= 5', 'ios >= 10'],
+
+      // 与Element对齐: https://element-plus.org/zh-CN/guide/installation
+      targets: ['Chrome >= 64', 'Edge >= 79', 'Firefox >= 78', 'Safari >= 12', 'not IE 11'],
+
+      renderLegacyChunks: true, // 必须开启, 确保生成 ES5 兼容包
+      modernPolyfills: false, // 关闭按需注入polyfill, 因为legacy无法全量分析项目代码间接依赖了哪些新API, 需在入口文件 main.ts 全量引入 'core-js/stable'
+    }),
+  ],
+};
+```
+
+2. 入口文件 main.ts 顶部引入 core-js/stable 进行 Polyfill
+
+```ts
+import 'core-js/stable'; // 安装命令: npm install core-js
+```

package/dist/base-tools-web.umd.global.js

@@ -2164,7 +2164,8 @@ var baseToolsWeb = (() => {
             reject(timeoutError);
             return;
           }
-          if (!isAbortError && toastError) (_h = appConfig2.toast) == null ? void 0 : _h.call(appConfig2, { status, msg: "\u7F51\u7EDC\u8BF7\u6C42\u5931\u8D25" });
+          if (!isAbortError && toastError)
+            (_h = appConfig2.toast) == null ? void 0 : _h.call(appConfig2, { status, msg: `\u8BF7\u6C42\u5931\u8D25,${String(e)}` });
           logRequestInfo({ status, config: logConfig, startTime, e });
           reject(e);
         } finally {
@@ -2214,7 +2215,7 @@ var baseToolsWeb = (() => {
       info.res = cloneDeep(res);
       log("info", info);
     } else {
-      info.e = e;
+      info.e = e instanceof Error ? { name: e.name, message: e.message, stack: e.stack } : String(e);
       log("error", info);
     }
   }
@@ -2233,9 +2234,11 @@ var baseToolsWeb = (() => {
   }
   function handleStreamResponse(response, sseTask) {
     return __async(this, null, function* () {
-      if (!response.body) return "Stream is empty";
+      if (!response.body) throw new Error("Response body is null");
       if (sseTask.parser === void 0) {
-        return "onMessage is undefined \u2192 Stream parser skipped";
+        throw new Error(
+          "Stream parser missing: Please set config.onMessage when enableChunked is true"
+        );
       }
       const reader = response.body.getReader();
       while (true) {