vue2-client 1.20.55 → 1.20.56

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/.cursor/tmp/stable-virtual-table-session-summary.md

@@ -0,0 +1,57 @@
+# STable 虚拟滚动迁移与会话摘要
+
+> 供后续对话引用，路径：`vue2-client/.cursor/tmp/stable-virtual-table-session-summary.md`
+
+## 一、目标与范围
+
+- 在 **vue2-client** 中把 [a-virtual-table](https://github.com/xiaocheng555/a-virtual-table) **源码迁入项目**（不依赖 npm 包 `a-virtual-table`），由 **[STable](src/components/STable/index.js)** 底层使用虚拟表替代直接渲染 `<a-table>`。
+- **XTableWrapper / XFormTable / XTable** 等业务层原则上**零改动**（列插槽仍为 `slot-scope="text, record, index"`）。
+
+## 二、关键文件
+
+| 文件 | 说明 |
+|------|------|
+| [src/components/AVirtualTable/a-virtual-table.vue](src/components/AVirtualTable/a-virtual-table.vue) | 本地化虚拟表：render 透传 `scopedSlots`、内部 `change` 改名为 `renderChange`、`effectiveVirtualized` 阈值 |
+| [src/components/AVirtualTable/index.js](src/components/AVirtualTable/index.js) | 默认导出组件 |
+| [src/components/STable/index.js](src/components/STable/index.js) | 使用 `AVirtualTable`、`__v_key`、`invokeSetScrollYHeight`、**props/attrs 拆分**（见下） |
+| [src/components/index.js](src/components/index.js) | 导出 `AVirtualTable` |
+| [src/base-client/components/common/XTable/XTableWrapper.vue](src/base-client/components/common/XTable/XTableWrapper.vue) | 唯一渲染 `<s-table>` 处，`scroll` 绑定 `tableContext.scrollXWidth` / `scrollYHeight` |
+
+## 三、虚拟表核心改造（相对上游 a-virtual-table）
+
+1. **插槽**：不再用中间层 `getSlotValue` 包装；`render` 里 **`scopedSlots: this.$scopedSlots` 直接传给内部 ant-design-vue `Table`**，保证位置参数插槽与原来 `a-table` 一致。
+2. **事件**：虚拟列表数据切片完成时 **`$emit('renderChange', ...)`**，不再用 `change`，避免与排序/筛选的 `onChange` 冲突导致「一滚就调 loadData」。
+3. **阈值**：`effectiveVirtualized = virtualized && dataSource.length > autoVirtualizeThreshold`；**默认 `autoVirtualizeThreshold: 40`**，即 **至少 41 行**才启用虚拟滚动（若需「满 40 行就开」，改为 `>=`）。
+4. **`offsetMap` 计算属性**：使用 `this.keyProp / this.dataSource` 等（上游用 computed 参数解构的写法在 Vue2 中不成立，已修正）。
+
+## 四、STable 侧逻辑
+
+- **`ensureVirtualKeysForRows`**：`loadData` 成功及 `setLocalDataSource` 时为每行写入 **`__v_key`**（兼容 `rowKey` 为函数或 `'序号'`），虚拟表 **`keyProp="__v_key"`**。
+- **`invokeSetScrollYHeight`**：在原先调用父传入的 `setScrollYHeight` 之后，`$nextTick` 调用 **`this.$refs.vtable.update()`**，便于布局/表头高度变化后重算虚拟区域。
+- **`ref="vtable"`**：便于外部 `this.$refs.table.$refs.vtable` 调试（视 ref 链而定）。
+
+## 五、重要 Bug 修复：scroll 等属性「丢失」
+
+**现象**：`XTableWrapper` 里 `:scroll="{ x, y: scrollYHeight }"` 似乎无效，表高随行数撑开。
+
+**根因**：Vue2 中通过 JSX `{ props: { ...全部 a-table 字段 } }` 传给 `AVirtualTable` 时，**未在子组件 `props` 中声明的键（如 `scroll`、`rowKey`、`rowSelection`、`components`）会被静默丢弃**，不会进入 **`$attrs`**，内部 `a-table` 收不到 `scroll.y`，`getScroller()` 里 `this.$attrs.scroll.y` 也一直为空。
+
+**修复**：在 [STable/index.js](src/components/STable/index.js) 中维护 **`VTABLE_OWN_PROP_KEYS`**，仅将虚拟表**自有**声明字段放入 `props`，其余全部放入 **`attrs`** 传给 `AVirtualTable`，使 `scroll` 等到 **`this.$attrs`** 并透传到内部 `Table`。
+
+## 六、回归与风险备忘
+
+- 建议自测：≤40 行 vs ≥41 行、排序/筛选、`scroll.x`/`scroll.y`、固定列、行选择、`expandedRowRender`、`components` 表头列宽拖拽、`customRow`。
+- 全量构建若失败，注意仓库内其他文件 ESLint（例如历史问题中的 `XMarkdownViewer.vue`），与本次表格改动无关。
+- 用户规则：**前端避免紫色**、**不要提交 console.log**。
+
+## 七、参考架构（简述）
+
+```
+XFormTable → XTable → XTableWrapper → STable → AVirtualTable → ant-design-vue Table
+```
+
+虚拟滚动仅在数据行数 **大于** `autoVirtualizeThreshold`（默认 40）时启用。
+
+---
+
+*文档由会话整理生成，后续任务可从此处接着改代码或补测试。*

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/.idea/MarsCodeWorkspaceAppSettings.xml

@@ -1,8 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="com.codeverse.userSettings.MarscodeWorkspaceAppSettingsState">
-    <option name="chatAppRouterInfo" value="builder/691d37a10c28806eaf3d4104" />
     <option name="ckgOperationStatus" value="SUCCESS" />
-    <option name="progress" value="1.0" />
+    <option name="progress" value="0.98264986" />
   </component>
 </project>

package/.idea/google-java-format.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="GoogleJavaFormatSettings">
+    <option name="enabled" value="false" />
+  </component>
+</project>

package/.idea/inspectionProfiles/Project_Default.xml

@@ -2,5 +2,23 @@
   <profile version="1.0">
     <option name="myName" value="Project Default" />
     <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="HtmlUnknownTag" enabled="true" level="WARNING" enabled_by_default="true">
+      <option name="myValues">
+        <value>
+          <list size="9">
+            <item index="0" class="java.lang.String" itemvalue="nobr" />
+            <item index="1" class="java.lang.String" itemvalue="noembed" />
+            <item index="2" class="java.lang.String" itemvalue="comment" />
+            <item index="3" class="java.lang.String" itemvalue="noscript" />
+            <item index="4" class="java.lang.String" itemvalue="embed" />
+            <item index="5" class="java.lang.String" itemvalue="script" />
+            <item index="6" class="java.lang.String" itemvalue="a-month-picker" />
+            <item index="7" class="java.lang.String" itemvalue="a-select-option" />
+            <item index="8" class="java.lang.String" itemvalue="a-menu-item" />
+          </list>
+        </value>
+      </option>
+      <option name="myCustomValuesEnabled" value="true" />
+    </inspection_tool>
   </profile>
 </component>

package/.idea/jsLinters/eslint.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="EslintConfiguration">
+    <option name="fix-on-save" value="true" />
+  </component>
+</project>

package/.idea/modules.xml

@@ -2,7 +2,7 @@
 <project version="4">
   <component name="ProjectModuleManager">
     <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/af-vue2-client.iml" filepath="$PROJECT_DIR$/.idea/af-vue2-client.iml" />
+      <module fileurl="file://$PROJECT_DIR$/.idea/vue2-client.iml" filepath="$PROJECT_DIR$/.idea/vue2-client.iml" />
     </modules>
   </component>
 </project>

package/.vscode/settings.json

@@ -0,0 +1,28 @@
+{
+  // 保存时自动格式化
+  "editor.formatOnSave": true,
+  // 保存时自动修复 ESLint 问题
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  },
+  // 统一使用 Prettier 格式化（跨 IDE 一致性）
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "[vue]": {
+    "editor.defaultFormatter": "dbaeumer.vscode-eslint"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  // ESLint 验证的文件类型
+  "eslint.validate": [
+    "javascript",
+    "javascriptreact",
+    "vue"
+  ],
+  "i18n-ally.localesPaths": [
+    "public/his/editor/vender/date97/lang"
+  ]
+}

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/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.20.55",
+  "version": "1.20.56",
   "private": false,
   "scripts": {
     "serve": "SET NODE_OPTIONS=--openssl-legacy-provider && vue-cli-service serve --no-eslint",