v0.7.0

v0.7.0

表单

• 扩展 FormRules<T>，支持类型、长度、范围、正则、嵌套字段和异步校验，校验引擎使用 @rc-component/async-validator
• 支持表单与字段各自设置 label-position 的 left、right、top，横向标签可指定宽度或自动对齐
• 增加字段重置、初值管理、校验回调和状态事件，可在提交失败时滚动并聚焦首个错误字段
• 修复同一字段内多个控件共用 ID 导致的标签误关联，错误提示显示时保持表单高度稳定

修复

• 确认弹窗没有正文时移除空内容区，收紧说明与操作按钮之间的留白
• 模态焦点管理跳过隐藏与禁用控件，并提供 useModalFocus 供自定义模态面板复用
• 避免窗口重新激活时因鼠标焦点恢复而意外打开悬停浮层
• 表格默认尺寸的单元格左右内边距由 16px 调整为 12px，日期面板与输入框的间距调整为 10px
• 单行省略文本保留字形上下沿，避免紧凑行高造成纵向裁切

主题

• 导出 resolveThemeSeedTokens，只读取种子值时可跳过完整色阶与 CSS Token 生成

升级注意

• validate() 与 validateField() 未传回调时，校验失败会 reject 字段错误对象，调用方应使用 catch 或改用校验回调；传入回调时，失败仍 resolve false
• 自定义 validator 改为接收 (rule, value, callback, source, options)，通过回调报告校验结果；异步校验可使用返回 Promise 的 asyncValidator，跨字段校验从业务模型读取关联值

安装

pnpm add https://github.com/zyycn/codex-proxy-ui/releases/download/v0.7.0/codex-proxy-ui-0.7.0.tgz

需要 Node.js 24+、Vue 3.5+，包名为 @codex-proxy/ui

v0.6.1

v0.6.1

修复

• 增强表格排序箭头的选中状态对比，保持原有尺寸、实心样式和表头文字颜色
• 分页按钮随页码长度自适应宽度，长数字完整显示，按钮高度保持不变
• 分页按容器实际宽度调整可见页码数量，单行放不下时隐藏每页条数选择框，保留翻页按钮与当前页码

安装

pnpm add https://github.com/zyycn/codex-proxy-ui/releases/download/v0.6.1/codex-proxy-ui-0.6.1.tgz

需要 Node.js 24+、Vue 3.5+，包名为 @codex-proxy/ui

v0.6.0

v0.6.0

新增

• 新增 ZConfigProvider 与 @codex-proxy/ui/locale，提供英文、简体中文和繁体中文语言包，支持响应式切换与嵌套配置
• 新增 createNotification，可绑定应用的响应式语言；已打开通知的默认标题和关闭标签随语言更新

调整与修复

• 日期选择器、分页、表格、表单、选择框和弹窗等组件使用统一语言配置，显式文案与插槽仍可覆盖默认内容
• 调整表格间距、弹窗标题与关闭按钮、卡片操作区和日期选择面板；分段控件支持长标签及窄容器横向滚动
• 更新锁定的 DOMPurify 至 3.4.17
• 修复干净检出时 Playground 语言包导入依赖预构建类型声明的问题

升级提示

• 组件默认语言改为英文；中文应用需通过 ZConfigProvider 配置 zhHans 或 zhHant
• DatePicker.locale 从 Day.js 语言字符串改为 UiLocale 语言包，未指定时继承 Provider 配置
• 命令式通知需使用 createNotification({ locale }) 绑定语言；直接使用 ZNotification 默认显示英文
• v-loading 默认提示改为英文，应用可通过 text 选项提供本地化文本；主题预设的中文名称与说明可从语言包的 theme 字段读取

安装

pnpm add https://github.com/zyycn/codex-proxy-ui/releases/download/v0.6.0/codex-proxy-ui-0.6.0.tgz

需要 Node.js 24+、Vue 3.5+，包名为 @codex-proxy/ui

v0.5.0

v0.5.0

新增

• 新增 ZDatePicker，支持日期、周、月份、年份、季度、日期时间、多选与范围选择，提供格式化、快捷选项、禁用日期、可编辑输入和表单校验
• 日期范围共用一个输入框外观，清空按钮可通过 clearable 控制，未提供 shortcuts 时不显示快捷选项面板
• ZPopover 新增 enterable、showAfter、hideAfter 和 teleported，可控制鼠标进入浮层、显隐延迟及挂载位置

调整与修复

• 修复 Popover 在锚点移除或清空时退场位置跳动，以及浮层内部操作和焦点归还导致意外重开的情况
• Input、Select、DatePicker 统一使用轻量的叉号清空按钮
• Input、Select、Textarea 默认宽度为容器的 100%；InputNumber 默认为 150px、小号为 120px；DatePicker 按日期类型提供默认宽度，支持窄容器收缩和调用方覆盖

升级提示

• 行内使用 Select 时为控件或父容器设置宽度；现有显式 class / style 宽度继续生效
• Popover 默认允许鼠标进入，移出后延迟 200ms 关闭；hoverDelay 保留，设置 showAfter 时优先使用后者

安装

pnpm add https://github.com/zyycn/codex-proxy-ui/releases/download/v0.5.0/codex-proxy-ui-0.5.0.tgz

需要 Node.js 24+、Vue 3.5+，包名为 @codex-proxy/ui

v0.4.1

v0.4.1

修复

• 修复 ZDialog 在窄屏中按固定宽度撑开、导致内容与关闭按钮被截断的问题；弹窗宽度受视口和既定留白约束

安装

pnpm add https://github.com/zyycn/codex-proxy-ui/releases/download/v0.4.1/codex-proxy-ui-0.4.1.tgz

需要 Node.js 24+、Vue 3.5+，包名为 @codex-proxy/ui

v0.4.0

v0.4.0

组件能力

• 公开组件统一为 ZButton、ZSelect 等 Z 前缀，模板支持 ZButton 与 z-button；实现文件使用无前缀实体名，类型、组合函数与工具按组件归属组织
• 完善按钮类型与原生属性、表单规则与字段校验、输入框清除和密码切换、数字输入精度与边界、文本域自动高度及选择器单选、多选与远程查询合同
• 提供独立 ZPagination，完善表格排序、列设置和键盘操作；弹窗支持异步关闭与退出后的收尾
• ZNotification 按需挂载通知容器，调用方无需添加宿主组件；组件库提供 vLoading，支持容器加载提示与内容保留

交互与样式

• 统一控件尺寸与紧凑图标，选择器选择前后高度保持一致，标签按内容宽度展示
• 表单错误提示不占用布局高度，错误边框沿用正常控件的悬停与聚焦行为
• Popover 与 Select 使用锚点定位并提供不支持原生锚点的浏览器回退，页面滚动时浮层跟随触发元素
• 滚动容器使用原生滚动，隐藏的滚动条轨道不拦截指针；规范 Tailwind 类名并更新组件 API 文档与交互示例
• 更新图标、Markdown、安全过滤及构建检查依赖

升级事项

这是包含不兼容 API 调整的版本，不提供旧名称别名或废弃入口。升级时同步组件导入、属性、事件和子路径，完整合同见组件文档

• Base* 导出改为 Z*；BaseModal、BaseConfirmModal、BaseNumberInput、BaseRange、BaseTablePagination 分别改为 ZDialog、ZConfirmDialog、ZInputNumber、ZSlider、ZPagination
• modal、confirm-modal、number-input、range、toast 子路径分别改为 dialog、confirm-dialog、input-number、slider、notification
• 使用 ZNotification 服务替换通知宿主与旧调用入口；全局加载指令通过 app.directive('loading', vLoading) 注册
• 按钮样式由 type 与 variant 配置，原生按钮类型使用 nativeType；尺寸统一为 small、default、large

安装

pnpm add https://github.com/zyycn/codex-proxy-ui/releases/download/v0.4.0/codex-proxy-ui-0.4.0.tgz

需要 Node.js 24+、Vue 3.5+，包名为 @codex-proxy/ui

v0.3.2

v0.3.2

问题修复

• 修复弹窗关闭时的重复退场，内容在退出动画结束后自动卸载，退场中重新打开会取消本次卸载
• 修复连续打开弹窗时的焦点恢复，关闭中的弹窗不会抢走新弹窗焦点；滚动锁在退场结束后释放
• BaseModal 与 BaseConfirmModal 提供 afterLeave 事件，供调用方在动画结束后清除明文凭据或执行必要收尾，普通弹窗无需额外清空业务数据

安装

pnpm add https://github.com/zyycn/codex-proxy-ui/releases/download/v0.3.2/codex-proxy-ui-0.3.2.tgz

需要 Node.js 24+、Vue 3.5+，包名为 @codex-proxy/ui

v0.3.1

v0.3.1

问题修复

• 修复含 Markdown 等 Teleport 内容的弹窗关闭时，内容提前消失、面板高度跳变的问题；内容保留到退场动画结束后再卸载

安装

pnpm add https://github.com/zyycn/codex-proxy-ui/releases/download/v0.3.1/codex-proxy-ui-0.3.1.tgz

需要 Node.js 24+、Vue 3.5+，包名为 @codex-proxy/ui

v0.3.0

v0.3.0

接入与构建

• 新增 @codex-proxy/ui/vite 入口，使用默认导出 CodexProxyUI 集中配置源码联调、共享依赖和开发服务文件访问范围
• 普通开发与生产构建统一使用编译产物，修复开发模式中源码与预构建入口混用导致 Toast 状态分离、通知不显示的问题
• 组件入口、样式和类型声明保持公开路径，整理组件文件命名，拆分 Select、Popover 的状态与定位逻辑，复用表单字段上下文

文档与预览

• Playground 按组件重新组织导航，表格的分页和列设置作为下级内容，示例区与配置区明确分层
• 补齐 27 个组件文档页面的 API 说明，提供 28 段可独立复制的 Vue 用法代码
• 预览区域沿用主程序的主题背景，调整导航间距和选中层级，加入主仓库图标与链接
• 正式发版自动构建并部署 Playground，预发行不覆盖在线站点
• 移除仓库内的独立测试脚本和测试示例，保留 lint、类型检查与构建检查

升级说明

默认开发入口不再直接解析到源码，联合修改组件时通过 CodexProxyUI({ source: new URL(...) }) 显式指定本地 UI 仓库，详见源码联调指南

安装

pnpm add https://github.com/zyycn/codex-proxy-ui/releases/download/v0.3.0/codex-proxy-ui-0.3.0.tgz

需要 Node.js 24+、Vue 3.5+，包名为 @codex-proxy/ui

v0.2.0

v0.2.0

新增功能

• BaseSelect 支持 multiple 多选，以可移除标签展示选中项，提供 collapse-tags、collapse-tags-tooltip 和 max-collapse-tags 控制折叠数量及隐藏标签浮层。
• 支持选项搜索、加载状态和自定义空状态，补齐多选、标签移除与搜索的键盘操作；单选用法保持兼容。

体验优化

• 下拉菜单使用浏览器原生锚点跟随滚动，不支持时回退到坐标定位；移除浮层的额外滚动节流，并在控件尺寸变化时更新位置。
• 空状态复用组件库统一图标与样式；修复文档预览中弹出菜单内边距被样式覆盖的问题。

安装

pnpm add https://github.com/zyycn/codex-proxy-ui/releases/download/v0.2.0/codex-proxy-ui-0.2.0.tgz

需要 Vue 3.5+。包名仍为 @codex-proxy/ui。