vue2-client 1.19.91 → 1.19.93

package/.claude/settings.local.json

@@ -1,30 +1,30 @@
-{
-  "permissions": {
-    "allow": [
-      "WebSearch",
-      "WebFetch(domain:context7.com)",
-      "Bash(npm run lint)",
-      "mcp__context7__resolve-library-id",
-      "mcp__context7__get-library-docs",
-      "WebFetch(domain:github.com)",
-      "Bash(npm run serve:*)",
-      "mcp__serena__get_current_config",
-      "mcp__serena__activate_project",
-      "mcp__serena__get_symbols_overview",
-      "mcp__serena__list_dir",
-      "mcp__serena__find_file",
-      "mcp__serena__list_memories",
-      "mcp__serena__check_onboarding_performed",
-      "mcp__serena__read_memory",
-      "mcp__serena__think_about_collected_information",
-      "mcp__sequential-thinking__sequentialthinking",
-      "Bash(npm run lint:*)",
-      "mcp__serena__find_symbol",
-      "mcp__serena__search_for_pattern",
-      "Bash(node -c:*)"
-    ],
-    "deny": [],
-    "ask": [],
-    "defaultMode": "acceptEdits"
-  }
-}
+{
+  "permissions": {
+    "allow": [
+      "WebSearch",
+      "WebFetch(domain:context7.com)",
+      "Bash(npm run lint)",
+      "mcp__context7__resolve-library-id",
+      "mcp__context7__get-library-docs",
+      "WebFetch(domain:github.com)",
+      "Bash(npm run serve:*)",
+      "mcp__serena__get_current_config",
+      "mcp__serena__activate_project",
+      "mcp__serena__get_symbols_overview",
+      "mcp__serena__list_dir",
+      "mcp__serena__find_file",
+      "mcp__serena__list_memories",
+      "mcp__serena__check_onboarding_performed",
+      "mcp__serena__read_memory",
+      "mcp__serena__think_about_collected_information",
+      "mcp__sequential-thinking__sequentialthinking",
+      "Bash(npm run lint:*)",
+      "mcp__serena__find_symbol",
+      "mcp__serena__search_for_pattern",
+      "Bash(node -c:*)"
+    ],
+    "deny": [],
+    "ask": [],
+    "defaultMode": "acceptEdits"
+  }
+}

package/.eslintrc.js

@@ -1,74 +1,74 @@
-module.exports = {
-  root: true,
-  env: {
-    node: true
-  },
-  // prettier 放最后，自动关闭所有与 Prettier 冲突的格式规则
-  extends: ['plugin:vue/essential', 'plugin:vue/strongly-recommended', '@vue/standard', 'prettier'],
-  rules: {
-    camelcase: 'off',
-    'comma-dangle': 'off',
-    'no-console': 'off',
-    'no-debugger': process.env.NODE_ENV === 'production' ? 'error' : 'off',
-    'generator-star-spacing': 'off',
-    'no-mixed-operators': 0,
-    'vue/max-attributes-per-line': 'off',
-    'vue/attribute-hyphenation': 0,
-    'vue/html-self-closing': 0,
-    'vue/component-name-in-template-casing': 0,
-    'vue/html-closing-bracket-spacing': 0,
-    'vue/singleline-html-element-content-newline': 0,
-    'vue/no-unused-components': 0,
-    'vue/multiline-html-element-content-newline': 0,
-    'vue/no-use-v-if-with-v-for': 0,
-    'vue/html-closing-bracket-newline': 0,
-    'vue/no-parsing-error': 0,
-    'vue/name-property-casing': 0,
-    'vue/multi-word-component-names': 0,
-    'vue/no-mutating-props': 0,
-    'no-tabs': 0,
-    'multiline-ternary': 0,
-    'object-shorthand': 0,
-    quotes: [
-      2,
-      'single',
-      {
-        avoidEscape: true,
-        allowTemplateLiterals: true
-      }
-    ],
-    semi: [
-      2,
-      'never',
-      {
-        beforeStatementContinuationChars: 'never'
-      }
-    ],
-    'no-delete-var': 2,
-    'prefer-const': [
-      2,
-      {
-        ignoreReadBeforeAssign: false
-      }
-    ],
-    'template-curly-spacing': 'off',
-    indent: 'off',
-    // 必须使用全等: false
-    eqeqeq: 0,
-    // 可以使用!! 双重否定
-    'no-extra-boolean-cast': 'off',
-    // 关闭函数名后空格检查，跟随 Prettier 默认风格 function foo()
-    'space-before-function-paren': 'off'
-  },
-  parserOptions: {
-    parser: '@babel/eslint-parser'
-  },
-  overrides: [
-    {
-      files: ['**/__tests__/*.{j,t}s?(x)', '**/tests/unit/**/*.spec.{j,t}s?(x)'],
-      env: {
-        jest: true
-      }
-    }
-  ]
-}
+module.exports = {
+  root: true,
+  env: {
+    node: true
+  },
+  // prettier 放最后，自动关闭所有与 Prettier 冲突的格式规则
+  extends: ['plugin:vue/essential', 'plugin:vue/strongly-recommended', '@vue/standard', 'prettier'],
+  rules: {
+    camelcase: 'off',
+    'comma-dangle': 'off',
+    'no-console': 'off',
+    'no-debugger': process.env.NODE_ENV === 'production' ? 'error' : 'off',
+    'generator-star-spacing': 'off',
+    'no-mixed-operators': 0,
+    'vue/max-attributes-per-line': 'off',
+    'vue/attribute-hyphenation': 0,
+    'vue/html-self-closing': 0,
+    'vue/component-name-in-template-casing': 0,
+    'vue/html-closing-bracket-spacing': 0,
+    'vue/singleline-html-element-content-newline': 0,
+    'vue/no-unused-components': 0,
+    'vue/multiline-html-element-content-newline': 0,
+    'vue/no-use-v-if-with-v-for': 0,
+    'vue/html-closing-bracket-newline': 0,
+    'vue/no-parsing-error': 0,
+    'vue/name-property-casing': 0,
+    'vue/multi-word-component-names': 0,
+    'vue/no-mutating-props': 0,
+    'no-tabs': 0,
+    'multiline-ternary': 0,
+    'object-shorthand': 0,
+    quotes: [
+      2,
+      'single',
+      {
+        avoidEscape: true,
+        allowTemplateLiterals: true
+      }
+    ],
+    semi: [
+      2,
+      'never',
+      {
+        beforeStatementContinuationChars: 'never'
+      }
+    ],
+    'no-delete-var': 2,
+    'prefer-const': [
+      2,
+      {
+        ignoreReadBeforeAssign: false
+      }
+    ],
+    'template-curly-spacing': 'off',
+    indent: 'off',
+    // 必须使用全等: false
+    eqeqeq: 0,
+    // 可以使用!! 双重否定
+    'no-extra-boolean-cast': 'off',
+    // 关闭函数名后空格检查，跟随 Prettier 默认风格 function foo()
+    'space-before-function-paren': 'off'
+  },
+  parserOptions: {
+    parser: '@babel/eslint-parser'
+  },
+  overrides: [
+    {
+      files: ['**/__tests__/*.{j,t}s?(x)', '**/tests/unit/**/*.spec.{j,t}s?(x)'],
+      env: {
+        jest: true
+      }
+    }
+  ]
+}

package/Components.md

@@ -1,60 +1,60 @@
-# vue2基础组件库组件介绍
-
-## XAddForm
-
-基于XAddNativeForm二次封装的动态表单的Modal形式
-
-[使用文档](src/base-client/components/common/XAddForm/index.md)
-
-## XAddNativeForm
-
-通过JSON配置动态生成的数据保存表单
-
-[使用文档](src/base-client/components/common/XAddNativeForm/index.md)
-
-## XBadge
-
-对antdv的badge组件进行重封装
-
-[使用文档](src/base-client/components/common/XBadge/index.md)
-
-## XCard
-
-通用数据加载状态管理容器
-
-提供一个可以根据数据加载状态显示不同内容的通用容器
-当loadState为loading时，显示骨架屏（加载界面）
-当loadState为success时，显示容器内容
-当loadState为error时，显示点击重新加载数据的提示界面
-
-[使用文档](src/base-client/components/common/XCard/index.md)
-
-## XForm
-
-通过JSON配置动态生成的数据筛选查询表单
-
-[使用文档](src/base-client/components/common/XForm/index.md)
-
-## XTable
-
-通过JSON配置动态生成的数据表格
-
-[使用文档](src/base-client/components/common/XTable/index.md)
-
-## XFormCol
-
-适用于动态表单的可以自适应各种分辨率设备的栅格组件封装
-
-[使用文档](src/base-client/components/common/XFormCol/index.md)
-
-## XFormTable
-
-对XAddForm，XForm和XTable组件的二次封装，实现通过JSON配置动态生成一个完整的实体操作页面
-
-[使用文档](src/base-client/components/common/XFormTable/index.md)
-
-## XImportExcel
-
-通用的导入excel组件
-
-[使用文档](src/base-client/components/common/XImportExcel/index.md)
+# vue2基础组件库组件介绍
+
+## XAddForm
+
+基于XAddNativeForm二次封装的动态表单的Modal形式
+
+[使用文档](src/base-client/components/common/XAddForm/index.md)
+
+## XAddNativeForm
+
+通过JSON配置动态生成的数据保存表单
+
+[使用文档](src/base-client/components/common/XAddNativeForm/index.md)
+
+## XBadge
+
+对antdv的badge组件进行重封装
+
+[使用文档](src/base-client/components/common/XBadge/index.md)
+
+## XCard
+
+通用数据加载状态管理容器
+
+提供一个可以根据数据加载状态显示不同内容的通用容器
+当loadState为loading时，显示骨架屏（加载界面）
+当loadState为success时，显示容器内容
+当loadState为error时，显示点击重新加载数据的提示界面
+
+[使用文档](src/base-client/components/common/XCard/index.md)
+
+## XForm
+
+通过JSON配置动态生成的数据筛选查询表单
+
+[使用文档](src/base-client/components/common/XForm/index.md)
+
+## XTable
+
+通过JSON配置动态生成的数据表格
+
+[使用文档](src/base-client/components/common/XTable/index.md)
+
+## XFormCol
+
+适用于动态表单的可以自适应各种分辨率设备的栅格组件封装
+
+[使用文档](src/base-client/components/common/XFormCol/index.md)
+
+## XFormTable
+
+对XAddForm，XForm和XTable组件的二次封装，实现通过JSON配置动态生成一个完整的实体操作页面
+
+[使用文档](src/base-client/components/common/XFormTable/index.md)
+
+## XImportExcel
+
+通用的导入excel组件
+
+[使用文档](src/base-client/components/common/XImportExcel/index.md)

package/docs/runFrontLogic/344/275/277/347/224/250/346/214/207/345/215/227.md

@@ -0,0 +1,220 @@
+# $runFrontLogic 使用指南
+
+## 概述
+
+`$runFrontLogic` 是前端业务逻辑的统一调用入口，由 `FrontLogicPlugin` 注册为 Vue 全局方法。它从配置中心按名称拉取 Logic 脚本，在浏览器中执行，支持操作界面组件、发起 HTTP 请求等操作。
+
+---
+
+## 函数签名
+
+```javascript
+this.$runFrontLogic(logicName, param, mode?)
+// 等价于
+LogicRunner.run(logicName, param, mode?)
+```
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `logicName` | `string` | ✅ | Logic 配置名称 |
+| `param` | `object` | ✅ | 传入 Logic 脚本的参数，脚本中通过 `data.xxx` 访问 |
+| `mode` | `string` | ❌ | 并发控制模式，见下方说明 |
+
+**返回值**：`Promise`，resolve 值为 Logic 脚本最后一条表达式的结果。
+
+---
+
+## 运行模式（mode）
+
+### 普通模式（默认）
+
+不传 `mode` 参数，每次调用都独立执行，互不干扰。
+
+```javascript
+// 适用场景：普通按钮点击、页面初始化加载
+await this.$runFrontLogic('loadPatientInfo', { patientId: 123 })
+```
+
+---
+
+### ignore 模式
+
+若同名 Logic **已在运行中**，忽略本次调用，直接返回 `null`。
+
+```javascript
+// 适用场景：防止重复提交、防止重复初始化
+this.$runFrontLogic('submitForm', { form: formData }, 'ignore')
+```
+
+**行为**：
+- 第一次调用：正常执行
+- 第一次未结束时触发第二次：直接返回 `null`，不执行
+- 第一次结束后触发第二次：正常执行
+
+```
+用户第1次点击 → 执行中...
+用户第2次点击（第1次未结束）→ 忽略，返回 null
+用户第3次点击（第1次已结束）→ 正常执行
+```
+
+---
+
+### cancel 模式
+
+若同名 Logic **已在运行中**，中止前一次的 HTTP 请求，立即执行本次调用。
+
+```javascript
+// 适用场景：搜索框输入联想、筛选条件变化后重新查询
+this.$runFrontLogic('searchGroupLogic', { keyword: value }, 'cancel')
+```
+
+**行为**：
+- 第一次调用：正常执行
+- 第一次未结束时触发第二次：**中止第一次的 HTTP 请求**，同时启动第二次执行
+- 第二次正常完成，第一次中途抛出 `AbortError`
+
+```
+用户第1次触发 → 执行中（delay + http.post）...
+用户第2次触发 → abort 第1次的 http 请求，同时开始第2次执行
+                第1次：http.post 抛出 AbortError，Logic 中止
+                第2次：正常完成，返回结果
+```
+
+> **注意**：cancel 只能中止**未完成的 HTTP 请求**，不能撤回已执行的 JS 代码。
+> 若 Logic 脚本中 `http.post` 之前有 `log.info("结束")` 等语句，这些语句仍会执行。
+
+---
+
+## Logic 脚本内可用的插件
+
+通过 `LogicRunner.run` 执行时，脚本内自动注入以下对象：
+
+| 名称 | 说明 | 示例 |
+|------|------|------|
+| `data` | 本次调用的 `param` 参数 | `data.proxy`、`data.form` |
+| `log` | 日志工具 | `log.info("消息")`、`log.debug(value)` |
+| `ENV` | 全局环境变量（来自配置的 `$globalProp`） | `ENV.baseUrl` |
+| `logic` | LogicRunner 自身，可嵌套调用其他 Logic | `logic.run('otherLogic', data)` |
+| `dateTools` | 日期工具 | `dateTools.getNow2()`、`dateTools.delay(1000)` |
+| `vueTools` | Vue 组件工具 | `vueTools.getComponent(data.proxy, 'refName')` |
+| `http` | HTTP 请求（自动绑定 abortSignal） | `http.post(url, body)`、`http.get(url, params)` |
+| `abortSignal` | 当前执行实例的取消信号 | `abortSignal.aborted` |
+
+### http 插件说明
+
+`http.post` / `http.get` 返回 `Promise`，表达式执行器会自动等待结果，可直接赋值：
+
+```
+// Logic 脚本语法（表达式，逗号分隔）
+res = http.post("/api/his/logic/searchResult", { form: data.form }),
+log.info("result={res}")
+```
+
+- **自动携带认证 Token**（走统一的 axios 拦截器）
+- **cancel 模式下自动绑定 abortSignal**，中止时 http 请求会立即取消
+- **禁用请求去重**（Logic 中的请求是有意发起的，不应被去重拦截）
+
+### dateTools.delay 说明
+
+`dateTools.delay(ms)` 支持 cancel 模式中断：
+
+```
+// Logic 脚本：delay 期间如果被 cancel，会立即抛出 AbortError
+log.info("开始"),
+dateTools.delay(3000),   // cancel 时这里会中断
+http.post("/api/xxx", {}),
+log.info("完成")
+```
+
+---
+
+## 调用方式
+
+### 方式一：Vue 组件内（推荐）
+
+```javascript
+// 组件方法或配置脚本中
+await this.$runFrontLogic('logicName', { proxy: this })
+
+// 带模式
+this.$runFrontLogic('searchLogic', { keyword: val }, 'cancel')
+```
+
+### 方式二：XButtons 按钮配置
+
+在按钮配置 JSON 中指定 `frontLogicName` 和 `frontLogicMode`，XButtons 组件会自动调用：
+
+```json
+{
+  "key": "search",
+  "title": "搜索",
+  "frontLogicName": "searchGroupLogic",
+  "frontLogicMode": "cancel"
+}
+```
+
+XButtons 会将当前组件实例（`proxy`）作为参数传入：
+
+```javascript
+// XButtons 内部等价于：
+await this.$runFrontLogic(item.frontLogicName, { proxy: this }, item.frontLogicMode)
+```
+
+**XButtons 的错误处理**：
+- abort/cancel 导致的取消错误：**静默忽略**，不弹出提示
+- 其他业务错误：弹出 `$message.error` 提示
+
+### 方式三：直接使用 LogicRunner
+
+```javascript
+import LogicRunner from '@vue2-client/logic/LogicRunner'
+
+const result = await LogicRunner.run('logicName', { param1: value }, 'cancel')
+```
+
+---
+
+## 错误处理
+
+```javascript
+try {
+  const result = await this.$runFrontLogic('logicName', params)
+  // 处理结果
+} catch (e) {
+  // cancel 模式下被中止时，e.cause 为 AbortError / CanceledError
+  const cause = e?.cause || e
+  if (cause?.name === 'AbortError' || cause?.name === 'CanceledError' || cause?.code === 'ERR_CANCELED') {
+    // 被取消，可忽略
+    return
+  }
+  // 其他业务错误
+  this.$message.error('执行失败：' + e.message)
+}
+```
+
+> 通过 XButtons 触发时，cancel 取消错误由 XButtons 自动静默处理，业务代码无需关心。
+
+---
+
+## 各模式对比
+
+| 场景 | 推荐模式 | 原因 |
+|------|----------|------|
+| 普通按钮触发、页面初始化 | 默认（不传） | 每次独立执行 |
+| 表单提交、防止重复操作 | `'ignore'` | 执行中时忽略重复点击 |
+| 搜索框、筛选条件实时查询 | `'cancel'` | 新条件触发时取消旧请求 |
+
+---
+
+## 相关文件
+
+| 文件 | 说明 |
+|------|------|
+| `src/base-client/plugins/FrontLogicPlugin.js` | 注册 `$runFrontLogic` 全局方法 |
+| `src/logic/LogicRunner.js` | 核心运行器，实现三种模式 |
+| `src/logic/plugins/index.js` | 插件注册（dateTools、vueTools、http） |
+| `src/logic/plugins/common/HttpTools.js` | HTTP 插件（兜底单例） |
+| `src/logic/plugins/common/DateTools.js` | 日期工具，delay 支持 abort |
+| `src/logic/plugins/common/VueTools.js` | Vue 组件工具 |
+| `src/base-client/components/common/XButtons/XButtons.vue` | 按钮配置驱动调用 |
+| `docs/前端业务逻辑使用说明.md` | 表达式语法与插件详细说明 |

package/index.js

@@ -1,31 +1,31 @@
-import Vue from 'vue'
-import { initRouter } from '@vue2-client/router/index.js'
-import { initI18n } from '@vue2-client/utils/i18n'
-import bootstrap from '@vue2-client/bootstrap'
-import { modules } from '@vue2-client/store'
-import '@vue2-client/theme/index.less'
-import '@vue2-client/utils/filter'
-import 'animate.css/source/animate.css'
-import 'moment/locale/zh-cn'
-import Antd from 'ant-design-vue'
-import Viser from 'viser-vue'
-// 插件
-import Plugins from '@vue2-client/base-client/plugins'
-
-const routerOptions = initRouter()
-const i18n = initI18n('CN', 'US')
-
-Vue.use(Antd)
-Vue.use(Viser)
-Vue.use(Plugins)
-
-Vue.config.productionTip = false
-const message = Vue.prototype.$message
-
-export {
-  routerOptions,
-  modules,
-  i18n,
-  message,
-  bootstrap
-}
+import Vue from 'vue'
+import { initRouter } from '@vue2-client/router/index.js'
+import { initI18n } from '@vue2-client/utils/i18n'
+import bootstrap from '@vue2-client/bootstrap'
+import { modules } from '@vue2-client/store'
+import '@vue2-client/theme/index.less'
+import '@vue2-client/utils/filter'
+import 'animate.css/source/animate.css'
+import 'moment/locale/zh-cn'
+import Antd from 'ant-design-vue'
+import Viser from 'viser-vue'
+// 插件
+import Plugins from '@vue2-client/base-client/plugins'
+
+const routerOptions = initRouter()
+const i18n = initI18n('CN', 'US')
+
+Vue.use(Antd)
+Vue.use(Viser)
+Vue.use(Plugins)
+
+Vue.config.productionTip = false
+const message = Vue.prototype.$message
+
+export {
+  routerOptions,
+  modules,
+  i18n,
+  message,
+  bootstrap
+}

package/jest-transform-stub.js

@@ -1,8 +1,8 @@
-module.exports = {
-    process () {
-      return 'module.exports = {};'
-    },
-    getCacheKey () {
-      return 'lessTransform'
-    },
-  }
+module.exports = {
+    process () {
+      return 'module.exports = {};'
+    },
+    getCacheKey () {
+      return 'lessTransform'
+    },
+  }

package/jest.setup.js

@@ -1,7 +1,7 @@
-global.matchMedia = global.matchMedia || function () {
-  return {
-    matches: false,
-    addListener: function () {},
-    removeListener: function () {}
-  }
-}
+global.matchMedia = global.matchMedia || function () {
+  return {
+    matches: false,
+    addListener: function () {},
+    removeListener: function () {}
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vue2-client",
-  "version": "1.19.91",
+  "version": "1.19.93",
   "private": false,
   "scripts": {
     "serve": "SET NODE_OPTIONS=--openssl-legacy-provider && vue-cli-service serve --no-eslint",