guava-ui 0.3.4 → 0.3.6

package/README.en.md

@@ -1,95 +1,89 @@
 # Statement
 
- `guava-ui` Guava Front end Engineering (Vue3) Historical Version Record
+ `guava-ui` — guava frontend project (Vue 3) version history  
  Author: <andy.ten@tom.com> & <xukaixing@hotmail.com>  
- API Url：<http://211.149.174.199:8888/vpapi/>
-
-## Preorder
-
-1. 安装全局`nodejs` 请使用`v20.18.0`及以上版本，建议使用`nvm`管理 nodejs 多个版本
-2. 建议使用`pnpm`管理 npm 依赖
-3. 前端开发 ide 建议使用`vscode:latest`, 必要的插件列表:
-   - `Vite` : vue3 打包工具，开发环境使用vite运行
-   - `Vue - Official` : vscode的vue3支持工具
-   - `Prettier` : 代码格式化工具，无 lint 检查代码语法能力
-   - `Eslint` : 校验脚本语言语法工具
-   - `Stylelint` : 校验css语法工具
+ API Docs: <http://www.ccexpert.top:8888/guava/>
+
+## Prerequisites
+
+1. Install global **Node.js** — use **v24.14.0** or later; **nvm** is recommended for managing multiple Node.js versions
+2. **pnpm** is recommended for npm dependency management
+3. Global install: `npm install -g pnpm eslint sass`
+4. Recommended IDE: **VS Code (latest)**. Suggested extensions:
+   - **Vite** — Vue 3 bundler; use Vite for the dev environment
+   - **Vue - Official** — Vue 3 support for VS Code
+   - **Prettier** — code formatter (no lint/syntax checking)
+   - **ESLint** — JavaScript/TypeScript syntax validation
+   - **Stylelint** — CSS syntax validation
   
-## Version - last >= 3
+## Version — last >= 3
 
-> v0.0.3 : 2025.03.19
->> 按需导入element-plus组件和样式
->> 引入国际化多语言i18n
->> vite.config.js编译与打包优化
+> v0.3.5: 2026.06.10
+>> Upgrade Node.js to v24.18.0  
+>> Upgrade pnpm to v11.9.0
 
 ---
 
-> v0.0.2 : 2024.11.29
->> pnpm add vite-plugin-svg-icons -D
+> v0.3.4: 2026.06.09
+>> Improve Form / Table id and name generation rules
 
 ---
 
-> v0.0.1 : 2024.11.24  
->> 使用 pnpm create vue@latest 脚手架创建工程  
->> pnpm add sass-embedded -D 添加nodejs解析scss依赖  
->> 在vite.config.ts中配置css解析  
->> 定义目录结构，在@/assets/styles中，新增app.scss、main.scss、variables.scss样式表  
->> pnpm add postcss -D 用JavaScript编写的工具转换CSS代码  
->> pnpm add postcss-html -D 将html文件中的样式块中的CSS代码提取出来进行处理  
->> pnpm add postcss-scss -D 将scss代码转换成CSS代码  
->> pnpm add autoprefixer -D 自动添加CSS浏览器前缀的插件  
->> pnpm add vite-plugin-progress -D Vite 构建工具的插件，提供构建进度条显示功能  
->> pnpm add vite-plugin-eslint -D
->> pnpm add terser -D
+> v0.3.3: 2026.06.09
+>> Optimize styles  
+>> Optimize CSS compression after lib build
 
 ## Exec
 
-### 使用 `pnpm` 命令
+### Using `pnpm`
 
 ```bash
-# 安装依赖
+# Install dependencies
 $ pnpm install
 
-# 启动开发服务
+# Start dev server
 $ pnpm dev
 
-# 启动构建生产服务
+# Build for production
 $ pnpm build
 ```
 
 ## Modules
 
-- `sass-embedded` pnpm add sass-embedded -D nodejs环境下使用scss
-- `postcss` pnpm add postcss -D 用JavaScript编写的工具转换CSS代码
-- `postcss-html` pnpm add postcss-html -D 将html文件中的样式块中的CSS代码提取出来进行处理
-- `postcss-scss` pnpm add postcss-scss -D 将scss代码转换成CSS代码
-- `autoprefixer` pnpm add autoprefixer -D 自动添加CSS浏览器前缀的插件
-- `vite-plugin-progress` Vite 构建工具的插件，提供构建进度条显示功能
-- `vite-plugin-eslint` 集成了 ESLint 的能力，在保存或构建时检测到代码中的潜在问题
-- `eslint-plugin-vue` 检查.vue文件中的ts
-- `eslint` pnpm add eslint @vue/eslint-config-typescript eslint-plugin-oxlint eslint-plugin-prettier eslint-plugin-vue vue-eslint-parser -D
-- `@typescript-eslint/eslint-plugin` typescript-eslint检查插件
-- `@typescript-eslint/parser` typescript-eslint插件
-- `@commitlint/{config-conventional,cli}` git commit注视规范检查插件
-- `lint-staged` 对已经通过 git add 暂存的文件运行linters进行检测
-- `terser` JavaScript 压缩工具，它是 UglifyJS 的一个现代分支，支持更新的 JavaScript 特性（如 ES6+）
-- `stylelint` pnpm add stylelint stylelint-config-standard stylelint-config-standard-scss stylelint-order stylelint-prettier stylelint-config-prettier stylelint-config-recommended-vue stylelint-config-recommended stylelint-config-recess-order stylelint-config-recess-order stylelint-scss -D
-- `dayjs` pnpm add dayjs JavaScript 日期库,支持国际化显示和各种格式的日期和时间的解析和格式化
-- `vite-plugin-style-import` 按需加载组件库的样式
-- `pinia` vuex替换组件，管理全局state状态
-- `pinia-plugin-persistedstate` pinia 状态持久化到localStorage或SessionStorage
-- `vite-plugin-ejs` 支持 EJS（Embedded JavaScript Templates） 模板语法。在 HTML 模板中使用动态数据(`<%=%>`)
-- `vite-plugin-url-copy`  Vite 开发服务器启动后，自动复制 URL 到剪贴板，方便你直接粘贴到浏览器或终端中
-- `vite-plugin-svg-icons`  Vite 插件，用于自动加载本地 SVG 图标，并将其转换为 SVG Sprite（SVG 精灵图），从而减少 HTTP 请求，提高性能
-- `vite-plugin-purge-icons`  Vite 插件，用于按需导入和自动优化 SVG 图标，可以直接使用 Material Icons、FontAwesome、Tabler Icons、Heroicons 等上千个图标库，而不需要手动安装或导入
-- `vite-plugin-full-reload` Vite 插件，用于监听指定文件，并在更改时触发整个页面的刷新（而不仅仅是 HMR 热更新）(修改 vite.config.js 等配置文件后，HMR 不能自动生效)
-- `rollup-plugin-visualizer` Vite 构建体积分析插件.Rollup 插件，用于 Vite、Rollup、Webpack 项目，生成一个 交互式的可视化报告，分析 构建体积、依赖大小、包的嵌套关系
-- `browserslist` 一个工具，用于定义项目要支持的浏览器范围
-- `@vitejs/plugin-legacy` Vite 官方插件，用于让 Vite 项目兼容 旧版浏览器（如 IE11 或较旧的 Chrome、Safari、Firefox 版本）；引入该组件，会生成兼容旧浏览器的polyfill文件，增加代码体积，去掉该依赖；
-- `@rollup/plugin-commonjs` Rollup 官方插件，用于让 Rollup 兼容 CommonJS 模块; 使用该commonjs会导致element-plus打包时提示TimePicker的dayjs引入错误，故去掉该依赖；
-- `cropper.js` 用于实现 图片裁剪 功能;在网页上对图像进行裁剪、缩放、旋转等操作
-- `vite-plugin-vue-devtools` Vite 插件，用于在开发过程中启用和配置 Vue Devtools
-- `@intlify/unplugin-vue-i18n` Vite 默认不支持 vue-i18n 运行时编译，使用 @intlify/unplugin-vue-i18n 插件优化：
+- `sass-embedded` — `pnpm add sass-embedded -D` — use SCSS in Node.js
+- `postcss` — `pnpm add postcss -D` — transform CSS with JavaScript
+- `postcss-html` — `pnpm add postcss-html -D` — extract and process CSS from `<style>` blocks in HTML
+- `postcss-scss` — `pnpm add postcss-scss -D` — compile SCSS to CSS
+- `autoprefixer` — `pnpm add autoprefixer -D` — automatically add vendor prefixes to CSS
+- `vite-plugin-progress` — Vite plugin that shows build progress
+- `vite-plugin-eslint` — integrates ESLint; reports issues on save or during build
+- `eslint-plugin-vue` — lint `.vue` files (TypeScript)
+- `eslint` — `pnpm add eslint @vue/eslint-config-typescript eslint-plugin-oxlint eslint-plugin-prettier eslint-plugin-vue vue-eslint-parser -D`
+- `@typescript-eslint/eslint-plugin` — TypeScript ESLint plugin
+- `@typescript-eslint/parser` — TypeScript ESLint parser
+- `@commitlint/{config-conventional,cli}` — Git commit message convention checks
+- `lint-staged` — run linters on files staged with `git add`
+- `terser` — JavaScript minifier (modern fork of UglifyJS, supports ES6+)
+- `stylelint` — `pnpm add stylelint stylelint-config-standard stylelint-config-standard-scss stylelint-order stylelint-prettier stylelint-config-prettier stylelint-config-recommended-vue stylelint-config-recommended stylelint-config-recess-order stylelint-config-recess-order stylelint-scss -D`
+- `dayjs` — `pnpm add dayjs` — lightweight date library with i18n and flexible parsing/formatting
+- `vite-plugin-style-import` — on-demand loading of component library styles
+- `pinia` — Vuex replacement for global state management
+- `pinia-plugin-persistedstate` — persist Pinia state to localStorage or sessionStorage
+- `vite-plugin-ejs` — EJS (Embedded JavaScript Templates) in HTML (`<%=%>`)
+- `vite-plugin-url-copy` — copy dev server URL to clipboard on startup
+- `vite-plugin-svg-icons` — load local SVG icons as SVG sprites to reduce HTTP requests
+- `vite-plugin-purge-icons` — on-demand SVG icons from Material Icons, Font Awesome, Tabler, Heroicons, etc.
+- `vite-plugin-full-reload` — full page reload when watched files change (e.g. `vite.config.js`, where HMR may not apply)
+- `rollup-plugin-visualizer` — interactive bundle size report for Vite/Rollup/Webpack
+- `browserslist` — define supported browser ranges for the project
+- `@vitejs/plugin-legacy` — Vite official plugin for legacy browsers (IE11, older Chrome/Safari/Firefox); adds polyfills and increases bundle size — removed when legacy support is not needed
+- `@rollup/plugin-commonjs` — Rollup plugin for CommonJS; caused dayjs import issues with Element Plus TimePicker during build — removed
+- `cropper.js` — image cropping, zoom, and rotation in the browser
+- `vite-plugin-vue-devtools` — enable Vue Devtools in development
+- `@intlify/unplugin-vue-i18n` — Vite does not support vue-i18n runtime compilation by default; this plugin optimizes i18n
+- `@vueuse/core` — Vue 3 Composition API utilities: `useMouse()`, `useDark()`, `useLocalStorage()`, `useFetch()`, `useClipboard()`, `useFullscreen()`, etc.
+- `unocss` — UnoCSS atomic CSS
+- `pinyin-pro` — Chinese characters to pinyin conversion
   
 ## Catalog
 
@@ -99,51 +93,51 @@ $ pnpm build
 
 ### FAQ
 
-- `安装pnpm`
+- **Install pnpm**
 
   ```text
-  使用npm安装：$ npm install -g pnpm
-  查看版本：$ pnpm -v
+  Install via npm: $ npm install -g pnpm
+  Check version: $ pnpm -v
   ```
 
-- `全局安装eslint`
+- **Install ESLint globally**
 
 ```text
-  使用npm安装：$ npm install -g eslint babel-eslint
-  注意： 如果使用nvm管理不同的nodejs版本，需要在当前使用版本上执行命令
+  Install via npm: $ npm install -g eslint babel-eslint
+  Note: If you use nvm, run this under the active Node.js version
 ```
 
-- `配置镜像加速`
+- **Configure registry mirror**
 
   ```text
-  配置淘宝的镜像源： $ npm config set registry https://registry.npm.taobao.org
-  还原npm镜像：$ npm config set registry https://registry.npmjs.org/
-  清除缓存：$ npm cache clean --force
+  Taobao mirror (legacy): $ npm config set registry https://registry.npm.taobao.org
+  Restore default npm registry: $ npm config set registry https://registry.npmjs.org/
+  Clear cache: $ npm cache clean --force
   ```
 
-- `切换nodejs版本`
+- **Switch Node.js version**
 
-  使用nvm命令： nvm alias default 版本号  </br>
-  注意切换完后，重启vscode
+  With nvm: `nvm alias default <version>`  
+  Restart VS Code after switching
 
-## Git comments rule
+## Git commit rules
 
-- feat 新功能
-- fix 修补 bug
-- docs 文档
-- style 格式、样式(不影响代码运行的变动)
-- refactor 重构(即不是新增功能，也不是修改 BUG 的代码)
-- perf 优化相关，比如提升性能、体验
-- test 添加测试
-- ci 持续集成修改
-- chore 构建过程或辅助工具的变动
-- revert 回滚到上一个版本
-- workflow 工作流改进
-- mod 不确定分类的修改
-- wip 开发中
-- types 类型
+- feat — new feature
+- fix — bug fix
+- docs — documentation
+- style — formatting/style (no logic change)
+- refactor — refactor (neither feature nor bug fix)
+- perf — performance or UX improvement
+- test — add or update tests
+- ci — CI configuration changes
+- chore — build or tooling changes
+- revert — revert to a previous version
+- workflow — workflow improvements
+- mod — miscellaneous changes
+- wip — work in progress
+- types — type definitions
 
 ## HomePage
 
-- 欢迎访问个人 [github-xukaixing](https://github.com/xukaixing) 主页.
-- 欢迎访问个人 [gitee-xukaixing](https://gitee.com/xukaixing) 主页.
+- [github-xukaixing](https://github.com/xukaixing)
+- [gitee-xukaixing](https://gitee.com/xukaixing)

package/README.md

@@ -6,9 +6,10 @@
 
 ## Preorder
 
-1. 安装全局`nodejs` 请使用`v20.18.0`及以上版本，建议使用`nvm`管理 nodejs 多个版本
+1. 安装全局`nodejs` 请使用`v24.14.0`及以上版本，建议使用`nvm`管理 nodejs 多个版本
 2. 建议使用`pnpm`管理 npm 依赖
-3. 前端开发 ide 建议使用`vscode:latest`, 必要的插件列表:
+3. 全局安装：npm install -g pnpm eslint sass 
+4. 前端开发 ide 建议使用`vscode:latest`, 必要的插件列表:
    - `Vite` : vue3 打包工具，开发环境使用vite运行
    - `Vue - Official` : vscode的vue3支持工具
    - `Prettier` : 代码格式化工具，无 lint 检查代码语法能力
@@ -17,155 +18,26 @@
   
 ## Version - last >= 3
 
-> v0.3.3: 2026.06.09
->> 优化style
->> 优化lib后css压缩
-
-> v0.3.2: 2026.06.07
->> 解决InputNumber组件多语言翻译问题
->> 优化GvTabs组件maxHeight计算
->> 解决chrome 浏览器 warning
-
-> v0.3.1: 2026.06.05
->> 解决Table组件表头是字典的筛选问题
->> Table组件增加行单击事件回调方法
->> 优化表头是字典的下拉框的css
->> 解决crud.tableFetch参数丢失问题
->> 优化tooltip css
->> 解决更新form的model字典无法清空问题
-
-> v0.3.0: 2026.06.04
->> 优化列表表头筛选/重置功能
->> 解决GvInputNumber无法显示问题
->> 解决form表单字典radio切换报错问题
->> 优化GvTabs组件显示
->> 解决DatePicker组件选择周报错问题
->> 日期组件增加显示自然周功能
->> 解决查询Form查询条件有hidden时，展开/折叠显示问题
-
-> v0.2.9: 2026.06.03
->> 优化Button loading显示
->> GvDrawer优化，去掉v-if，采用v-model，不需要每次都重新创建组件；
->> drawer组件高度计算优化
->> gv.crud组件优化
-
-> v0.2.8: 2026.06.02
->> table组件优化双击行事件
->> 优化浏览器warn信息
->> notify message 样式调整
->> 解决刷新网页的router警告
->> 统一将字体升级为14px
-
-> v0.2.7: 2026.06.01
->> 优化Form表单赋值
->> 优化Dic字典赋值
->> 优化crud.save/update方法
-
-> v0.2.6: 2026.05.31
->> 解决多语言form校验显示问题
->> 解决GvTable组件筛选框样式问题
-
-> v0.2.5 : 2026.05.28
->> GvTable优化，action列按钮style优化  
->> 解决edit form表选字典赋值问题
-
-> v0.2.4 : 2026.05.23
->> 解决多语言显示问题
-
-> v0.2.3 : 2026.05.23
->> GvForm优化，实现form隐藏动画
->> GvDrawer优化，解决footer button按钮快捷键显示兼容问题
-
-> v0.2.1 : 2026.05.20  
->> gv.crud 优化 
-
-> v0.2.0 : 2026.05.18  
->> 优化列表分页组件  
-
-> v0.1.9 : 2026.05.14  
->> 优化GvTable组件，优化table bar布局  
->> 实现GvDrawer组件的footer btn布局  
-
-> v0.1.8 : 2026.05.11  
->> 优化GvForm组件，实现Expand/Shrink功能
-
-> v0.1.6 : 2026.04.30  
->> 优化GvInputNumber组件，增加自定义class扩展功能.  
-
-> v0.1.5 : 2026.04.29.   
->> 优化GvForm组件 
-
-> v0.1.4 : 2026.04.28.   
->> 修改package index.ts,export导出的组件以component方式导出
-
-> v0.1.3 : 2026.03.18.   
->> 优化GvExpandMenu组件，解决i18n在web工程中无法翻译问题.   
->> 优化package.json，lib库组件适配web工程. 
-
-> v0.1.0 : 2026.03.12  
->> 解决打包lib库生成index.d.ts问题.   
->> 优化打包上传npm内容。 
-
-> v0.0.7 : 2026.01.28  
->> 优化GvTagsView组件，增加tabs的右键功能以及style样式修改  
->> GvSvgIcon组件更改为GvIcon组件，支持iconfont、svg的icon处理，支持自定义class扩展  
->> 实现GvExpandMenu组件的点击菜单功能  
-
-> v0.0.6 : 2025.08.08.  
->> 新增left menus 组件，layout布局组件  
->> 调整left menus 左侧栏布局样式  
->> 调整header right item 样式
->> 新增GvTheme 主题切换组件.  
->> 新增header right item - GvUserInfo组件
->> 新增GvExpandMenu & GvExpandList组件
->> 新增pinyin-pro组件
->> 新增GvGlobalSearch全局检索组件
-
----
-
-> v0.0.5 : 2025.06.09.  
->> pnpm add unocss -S 使用unocss样式.  
->> pnpm add @unocss/transformer-variant-group -D UnoCSS语法扩展插件.  
->> 新增 GvHamburger组件.  
+> v0.3.6: 2026.06.12
+>> 新增GvAnchor锚点组件
+>> 新增GvBodyDialog组件
 
 ---
 
-> v0.0.4 : 2025.04.02
->> 新增GvLangSelect组件.  
->> 新增SvgIcon组件.  
->> vite.config.js编译与打包优化.  
->> pnpm add @vueuse/core -S 基于 Vue 3 的 组合式 API 工具库.  
->> 新增style样式. 
->> 新增GvConfigProvider组件，设置全局配置信息.  
->> 新增axios封装组件.  
->> 新增hooks/useCrud和hooks/useNotify.  
+> v0.3.5: 2026.06.10
+>> 升级node版本为v24.18.0
+>> 升级pnpm版本为v11.9.0
 
 ---
 
-> v0.0.3 : 2025.03.19.  
->> 按需导入element-plus组件和样式.  
->> 引入国际化多语言i18n.  
->> vite.config.js编译与打包优化.  
+> v0.3.4: 2026.06.09
+>> 优化Form / Table id与name生成规则
 
 ---
 
-> v0.0.2 : 2024.11.29. 
->> pnpm add vite-plugin-svg-icons -D. 
-
----
-
-> v0.0.1 : 2024.11.24  
->> 使用 pnpm create vue@latest 脚手架创建工程  
->> pnpm add sass-embedded -D 添加nodejs解析scss依赖  
->> 在vite.config.ts中配置css解析  
->> 定义目录结构，在@/assets/styles中，新增app.scss、main.scss、variables.scss样式表  
->> pnpm add postcss -D 用JavaScript编写的工具转换CSS代码  
->> pnpm add postcss-html -D 将html文件中的样式块中的CSS代码提取出来进行处理  
->> pnpm add postcss-scss -D 将scss代码转换成CSS代码  
->> pnpm add autoprefixer -D 自动添加CSS浏览器前缀的插件  
->> pnpm add vite-plugin-progress -D Vite 构建工具的插件，提供构建进度条显示功能  
->> pnpm add vite-plugin-eslint -D
->> pnpm add terser -D
+> v0.3.3: 2026.06.09
+>> 优化style
+>> 优化lib后css压缩
 
 ## Exec