更新日志

v1.0.2 (2025-12-22)

新特性

• 标签列渲染：新增 tags 配置，支持在表格单元格内容后追加显示标签数组

  • 支持字符串数组、对象数组、单字符串三种数据格式
  • 支持 typeMap 按标签文本映射类型样式
  • 支持 propsMap 按标签文本映射完整 Tag 属性
  • 支持 max 限制显示数量，超出显示 "+N" 省略提示
  • 继承 Element Plus Tag 所有属性作为默认值

• 多表格场景支持：新增 instanceKey 实例隔离功能

  • PageTemplate 和 Table 组件新增 instanceKey 属性
  • 解决 Tab 切换、v-show 等场景下多表格高度计算冲突问题
  • 支持 string 或 Symbol 类型的实例标识符
  • 自动优化：隔离实例在高度未变化时跳过重复计算，避免切换闪烁

• Table 组件增强：新增 otherHeight 属性，支持传入额外高度偏移用于特殊页面布局

类型导出

• 新增 TagItem、TagData、TagConfig 类型导出
• 新增 TableHeightState、UseTableHeightOptions 类型导出

---

v1.0.1 (2025-12-15)

架构优化与清理

• 移除了未使用的 tableWidth.ts、asyncComponentMap.ts 以及相关 lazy.ts 文件，精简了代码库
• 将 defaultOssApi 实现从类型定义文件中分离，移至 src/shared/utils/oss.ts，提升了类型定义的纯粹性
• 优化依赖管理，移除不必要的打包依赖，显著减小包体积
• 项目结构重构，迁移至 ESLint Flat 配置
• 集成 Vitest 单元测试框架与 GitLab CI 自动化流程

类型系统改进

• 修正了 PageTemplateExposed 接口中 importFile 方法的类型签名，使其与实际实现保持一致，解决了构建错误
• 移除了 PageTemplate/index.vue 中重复的接口定义

性能优化

• 将 src/shared/utils/validate.ts 中的正则表达式提升为模块级常量，避免了重复创建，提升了验证函数的性能

组件增强

• 导出了 DictTag 组件，提供了更灵活的字典标签使用方式

新特性

• Hook 增强：新增 useDialog 用于简化弹窗管理
• 权限控制：新增 v-hasPermi 和 v-hasRole 指令及编程式检查
• 工具库：新增 validURL、isPathMatch 等验证工具及操作辅助函数

文档更新

• 补充了 useTableHeight、formatterRes 和 checkRes 等工具的使用文档
• 完善配置工具函数文档
• 补充核心功能使用说明

---

v1.0.0 (2025-12-01)

首次发布

• PageTemplate CRUD 页面模板组件
• Table 表格组件（基于 VXE-Table）
• 完整的表单控件体系
• 字典管理系统
• 配置工具函数
• TypeScript 类型支持