版本发布

版本号与对应的修改日志由推送前版本自动管理维护（规则见发布指南）：推送携带 feat / fix 改动时自动递增版本号、打 vX.Y.Z tag，并自动在本页追加该版本的修改日志。

npm 版本历史：vue3-ep-biz-lib - Versions

v1.4.0（2026-10-26）

✨ 新增

• feat: 新增 4 个基础组件与 4 项组件扩展——BizEditableText 行内编辑文本（单击/双击/受控触发、同步+异步两段校验保持编辑态、Esc 取消还原、textarea/number 形态、空占位与超长省略）、BizSettingItem 设置项行（图标五色板+标题+说明+控件/操作双插槽、分隔线末行去线、hover 操作降噪、紧凑档）、BizTemplateInput 模板变量输入（${变量}光标处插入/分组面板/未注册与未闭合校验/sample 示例值预览高亮/已用变量计数）、BizCoordinateInput 经纬度输入（±180/±90 范围与精度校验、DMS 度分秒换算展示、wgs84/gcj02/bd09 坐标系标注、复制 lng,lat、粘贴坐标自动分发）；扩展：BizStatusTag 组模式增强（直传标签对象/字符串免映射可混用、closable 逐个移除 remove 回抛项与下标、+N 弹层触发/位置可配、空态占位——原拟新增 BizTagList 因高度重合并入本组件）、BizPhoneInput 座机模式（type=landline 区号-号码-分机三段、400/800 热线、010-****8888 脱敏、info 携带 kind/area/number/ext）、BizTimeText clock 实时时钟（秒级走字/时区口径/星期后缀，顶栏与大屏时间牌）、BizIpInput 端口段（show-port 1-65535 校验、末段满 3 位自动跳入、v-model 'a.b.c.d:port'、粘贴 ip:port 整串分发）
• feat: 新增 5 个基础组件并完成同族合并收敛——BizLinkInput 链接输入（email/url 双模式合一：格式校验五态/邮箱后缀建议/企业域名白名单/协议自动补全/https-only/新窗口预览）、BizTimeText 时间文本（relative/absolute 双模式合一：六档相对分档+自动刷新+悬浮绝对时间 / 模板格式化+时区口径+昨天档）、BizWeekPicker 周选择（ISO 年周面板/本周定位/快捷周/change 回抛周起止）、BizShortcutInput 快捷键录入（组合键捕获/修饰键标准化键帽/必含修饰键约束/冲突红警）、BizKeyValueEditor 键值对编辑器（行增删上下移/重复键红警/类型列解析导出/JSON 导入复制/防回流抖动）；BizForm/BizFormDesigner 内核扩展 email/url 两类控件（复用 BizLinkInput，白名单与 https-only 经 attrs 透传，Designer 面板/画布预览/缺省模板/问卷统计同步）；比对并回：BizPercentInput 并入 AmountInput 费率模式（min 负数档同口径，组件不另设）
• feat: 三组件业务扩展——ContractLedger 回款计划（payments 分期应收/登记实收多次到账累计/部分回款-已逾期N天-待收四态推导/回款进度条与四态汇总 chips/payment-change 全集回抛）、AfterSale 退货物流轨迹（logistics 数据源内嵌 BizExpressTrack 仅退货单渲染/shipping 态自动展开记忆开合/signed 签收按 auto-receive 自动确认收货推进待退款/logistics-refresh 轨迹拉新）、ResourceBooking 周期预约（allow-recurring 每周-每两周 × N 期 maxRepeatCount 钳制/seriesConflicts 整组冲突检测任一期冲突整组拒绝并标出冲突期次/seriesId 系列记录整组取消逐期外抛 cancel/系列成员禁用单期变更）
• feat: 新增 8 个业务组件——ResourceBooking 资源预约（多资源切换/半小时粒度时段表/圈选即时冲突拦截/时长与容载校验/变更=预填替换旧约/request 三接口远程模式）、VisitorPass 访客通行证（邀访登记/待来访-到访-离场-作废状态机/通行证码与二维码/四指标统计）、SalarySlip 工资条（期间导航/明密文切换/年汇总口径/远程加载）、CouponCard 优惠券（暂停-未开始-已结束-已抢满-进行中六态优先级/折扣一位小数/限领口径）、MemberCard 会员卡（等级晋级进度/积分三态流水/储值充值远程到账）、AfterSale 售后工单（退货五步-仅退款三步双链路/运费可退 maxRefund 口径/迷你时间线）、Workbench 工作台（按时段问候/指标卡/快捷入口/卡片配置 localStorage 持久化）、GoodsReview 商品评价（好中差待审精选五滤/统计剔除已拒/精选置顶）；扩展 ShiftCalendar 考勤实况（attendance 注入六态徽标/双模切换/异常清单/出勤率 getAttendanceStats）、FormDesigner 问卷模式（题组编排/投放二维码与链接/getSurveyStats）、AppointmentPicker 占用时段（bookedSlots 拦截提示/选中过滤/父级回显重发）；修复 18 个组件缺失样式导入（BizPoster 画布溢出根因）、ResourceBooking 变更预填被日期资源 watch 清空与旧约自冲突（prefilling 挂起 + blockingRecords 自排除）、ShiftCalendar withDefaults mode:'plan' 致内部切换按钮失效、MemberCard 晋级进度负百分比钳制、VisitorPass 单边时间文案、考勤模式成员计数改按考勤记录数
• feat: 新增 6 个业务组件——WorkOrder 工单中心（全生命周期/SLA 倒计时/双通道评论/评价关单/重开）、ExpenseClaim 费用报销单（明细行/发票查重/附件/只读审查）、ContractLedger 合同台账（到期预警/登记续签/节点流转/CSV 公式注入防护）、Vote 投票评选（单选多选/匿名/截止倒计时/实时条形）、HelpCenter 帮助中心（分类懒加载/检索高亮/有用反馈/深链接定位）、Poster 分享海报（canvas 模板合成/二维码复用 BizCode/批量出图/远程模板合并）；扩展 Signature 印章盖印与文档底图、AmountInput 币种换算本位币大写、StepsForm 草稿箱、CalendarBoard ics 导出；新增共享 toRmbUppercase 工具（跨段零口径）；含批次审计修复（报销快照补号、海报简介行数自适应防压底、指针捕获降级容错、帮助中心远端深链接兜底加载、工单评论类型切换重置、ics 稳定 UID 与跨零点时段）
• feat: 新增 2 个业务组件——FeedbackPanel 意见反馈（类型级联/紧急程度/截图粘贴上传/匿名联系方式/我的反馈历史，panel·dialog·drawer 三形态零接口）、CertUpload 资质证照管理（类型清单配置驱动/到期预警/审核驳回/只读审查/完备性校验/本地 CSV 清单导出/变更记录）；扩展 Signature agreement 协议阅读门控（滚动到底+倒计时+同意勾选）、LoginPanel registerFlow 内置注册流（邀请码/协议勾选/成功回填）、TablePicker 拼音检索与头像列；含审计修复（证照同 URL 重复建卡、协议门控动态绑定被无关重渲染重置、注册协议勾选跨会话残留、反馈成功页关闭回落编辑态、非图片无监听降级新窗口打开、反馈校验规则响应式化）

📦 其他

• chore(release-infra): 随 v1.4.0 版本固化，移除侧栏「新/更」徽标（37 处还原为普通字符串）、32 份组件文档 397 处 ApiMark 行标与总览页待发布提示（累计新增 23 · 扩展 11 清零；theme 端 ApiMark 组件注册与徽标样式保留供下一批复用）
• docs: 基础组件第四批配套——58 个新场景 demo（行内编辑×8：基础/双击触发/同步校验/异步判重/受控编辑/多行 Ctrl+Enter/数值形态/档案字段组合；设置项×8：基础/说明/彩色图标/控件插槽/操作列/hover 降噪/分组设置页/整页个人设置；模板变量×8：基础插入/分组面板/未注册校验/示例值预览/白名单与字数/禁用与纯校验/事件面板/短信计费实战；经纬度×8：基础/DMS 互转/校验/受控清空/坐标系/复制粘贴/设备表单/围栏顶点；状态标签组模式×8：直传字符串/直传对象/码值混用/closable 移除/弹层触发与位置/空态/尺寸档位/表格标签列集成；座机×6：基础/分机/400 热线/混合表单/异步回显/事件面板；时钟×6：基础/日期星期/多时区/间隔节流/大屏时间牌/顶栏集成；IP 端口×6：基础/校验/回显/粘贴分发/禁用/服务表单）、4 份新组件文档与 4 份扩展文档更新（ApiMark 新行/扩展行、座机 BizPhoneInfo 结构化字段/DMS 换算/端口口径/clock 与 absolute 共用模板等口径说明）；侧栏登记（基础组件 16 · 表单 56，「新」×4「更」×4）、总览 182→186 与待发布提示（累计新增 23 · 扩展 11）
• docs: 基础组件批配套——58 个新场景 demo（链接输入×12：双模式基础/后缀建议/域名白名单/协议补全/https-only/即时校验/自定义文案/表单集成/组合；时间文本×12：相对分档/跨天跨年/刷新控制/阈值/悬浮/绝对模板/时区/昨天档/表格组合；周选择×10；快捷键×10；键值对×10；另 BizForm email-url 字段×1、AmountInput 费率负数档×1）、5 份新组件文档（Props/Events/Expose 全 ApiMark + 口径说明：ISO 周规范/修饰键标准化顺序/防回流抖动/双模式特性隔离）；BizForm 文档更新 17 类控件与 email/url 区段、FormDesigner 面板 12 类说明、AmountInput 费率负数档区段（ApiMark update）、EditableTable↔KeyValueEditor 与 QuarterPicker↔WeekPicker 分工标注；侧栏「新」×5（表单 54 / 数据展示 46）、总览统计 184→182 与待发布提示（累计新增 19：第三批基础件 5 个，BizPercentInput 并入 AmountInput 费率模式、Email+Url 合并 LinkInput、Relative+Format 合并 TimeText）
• docs: 三项扩展配套 18 个新场景 demo（合同台账回款×6：基础核销/逾期红警/部分回款/全流程/远程维护/只读查阅；售后物流×6：基础轨迹/签收自动确认收货/关闭联动/轨迹刷新/方向/状态兜底；资源预约周期×6：每周/每两周/整组冲突拦截/系列整组取消/期数上限与载荷/远程周期）、3 份扩展文档（API 行 ApiMark 与口径说明：分期状态推导/签收联动/整组冲突与整组取消）、总览三行描述同步；另将 demo 中真实姓名统一替换为虚拟姓名「张三」（工资条×7/访客×2/工作台×1，源码零残留）
• docs: 8 新组件与 3 项扩展配套——99 个新场景 demo（资源预约×11/访客通行证×10/工资条×10/优惠券×10/会员卡×10/售后工单×10/工作台×10/商品评价×10/排班日历考勤实况×6/表单设计器问卷×6/预约选择器占用时段×6）、8 份新组件文档与 3 份扩展文档（含口径说明、API 行 ApiMark 标记、v-model:mode 默认值语义修正）、侧栏「新」×8「更」×3 徽标（业务复合 16→24）、总览统计 169→177 与累计待发布提示（新增 14 · 扩展 7）
• docs: 6 新组件与 4 项扩展配套——73 个新场景 demo（工单×10/报销×10/台账×10/投票×10/帮助中心×10/海报×10/印章盖印×4/币种换算×3/草稿箱×3/ics 导出×3）、6 份新组件文档与 4 份扩展文档（含审计修复口径同步：海报行数自适应/ics 跨零点与稳定 UID/帮助中心远端深链接/工单评论重置/触屏印章删除）、API 行 ApiMark 标记、侧栏「新」×6「更」×4 徽标与总览待发布提示（新增 6 · 扩展 4，组件统计 163→169）
• docs: 2 新组件与 3 项扩展配套——30 个新场景 demo（意见反馈×10/资质证照×10/协议门控×4/注册流×3/拼音与头像×3）、5 份组件文档（新增 2 · 扩展 3）API 行 ApiMark 标记、侧栏「新」×2「更」×3 徽标与总览待发布提示（新增 2 · 扩展 3，组件统计 161→163）

v1.3.0（2026-10-23）

✨ 新增

• feat: 扩展 7 个业务组件——CrudPage 左树右表 aside、UploadFile/Chat 截图粘贴上传、ExportButton 纯前端本地导出、CalendarBoard 日程事件、LoginPanel 内置忘记密码三步流、AmountInput 费率模式；含审计修复（粘贴 hover 作用域门控与批量合并提示、CSV 公式注入防护、forgot 类名冲突、账号回填与倒计时清理等）

📦 其他

• chore(release-infra): 随 v1.3.0 版本固化，移除侧栏「更」标记、总览待发布提示与文档 ApiMark 行内标记（徽标基建保留供下批次使用）
• docs: 6 项扩展配套——20 个新场景 demo（左树右表×4/日程事件×4/截图粘贴×4/本地导出×3/忘记密码×2/费率×3）、7 组件文档 API 行 ApiMark 标记、侧栏「更」徽标与总览待发布提示（扩展 7 · 新增 0）

v1.2.0（2026-10-23）

✨ 新增

• feat: 扩展 5 个已有组件——可编辑表格 kv 模式与 Excel 粘贴填充、远程搜索选择器表格下拉、图码 Code128 与二维码 logo/圆点码点、搜索表单快捷日期范围、弹窗表单与设计器 15 类控件（渲染内核下沉 biz-form 公开复用），附文档 ApiMark 行内徽标基建
• feat: 新增 BizDateRange/BizCaptchaInput/BizAttachmentList/BizCameraCapture/BizForm 5 个业务组件，每组件 9 示例
• feat: BizTable 列设置增强完善（拖拽排序分桶/固定列三态/持久化清理/面板交互），修复远程双请求竞态、页码越界与文档站 table 样式污染导致的固定列 sticky 失效，新增订单管理/库存预警/跨页多选/合同台账四个示例
• feat: 九个组件扩展——CRUD 内联编辑与预设搜索/导出、表格选择最近记录、登录短信扫码 MFA、导入导出异步任务、打印分页模板、字段对比表格模式、审计变更详情、审批记录时长
• feat: 新增 BizAppointmentPicker 预约选择组件与 useValidator/useLockFn/useDebounceFn/useThrottleFn 四个 hooks

📦 其他

• chore(release-infra): 随 v1.2.0 版本固化，移除侧栏「新/更」标记、总览待发布提示与文档 ApiMark 行内标记（徽标基建保留供下批次使用）
• docs: 侧栏登记 5 个新组件并新增本周期批次徽标体系（「新」×6 / 「更」×15），总览统计 161，回溯本周期全部扩展组件 API 行内「新/更」标记
• docs: 新增预约选择组件文档与 useValidator/useLockFn 指南，补充九组件扩展示例与列设置增强说明，侧栏徽标轮换、总览统计 155→156

v1.1.0（2026-10-23）

⚠ 破坏性变更

• refactor(biz-modal)!: 尺寸预设取值改为完整单词并优化壳层细节

✨ 新增

• feat: 扩展 6 个已有组件，新增表单模式/Office 内置预览/行内修正/状态分组/筛选预设联动/多单位金额
• feat: 新增 BizWorkdayCalendar/BizPivotTable/BizI18nInput/BizMessageCompose 4 个业务组件，每组件 8+ 示例
• feat(biz-modal): 函数式滑窗支持级联并排，副滑窗紧贴主滑窗左缘滑出

🐛 修复

• fix(biz-card-list): 卡片换行后上下紧贴，栅格补充纵向行距

📦 其他

• docs: 侧栏新增 4 个组件入口并移除上一批「新」标记，总览统计更新为 155 个组件
• docs(biz-modal): 函数式 API 场景示例扩充与级联滑窗文档

v1.0.0（2026-10-22）

⚠ 破坏性变更

• feat!: 组件收敛——9 组功能重叠组件合并删除 14 个旧组件（160→151），统一五类渲染内核

  迁移对照（旧 → 新）：BizPageTabs → BizTabsNav（refresh 事件更名 reload、expose close → closeTab）；BizAudioPlayer / BizVideoPlayer → BizMediaPlayer（type: audio|video）；BizDictTag → BizStatusTag（status-map 与 dict-type 全局字典双模式）；BizBatchProgress / BizDownloadCenter → BizTaskCenter（mode: panel|trigger）；BizQrCode / BizBarcode → BizCode（type: qr|barcode）；BizImportButton / BizImportWizard → BizImport（mode: quick|wizard）；BizPasswordMeter → BizPasswordInput 子导出（可独立使用，API 不变）；BizTrend → BizStatistic（inline 形态 + sparkline，direction→trend、data→trend-data）；BizSelectTable / BizMemberPicker → BizTablePicker（filter-mode: search|tree）。迁移别名 BizPageTabItem / BizPageTabMenuAction / BizTrendProps / BizTrendDirection / BizTrendInstance 一并删除。

✨ 新增

• feat: 新增 11 个高频业务组件，深度检查修复批次缺陷
• feat: 新增 18 个业务组件与 5 个 hooks，深度梳理修复批次及存量缺陷

📦 其他

• 统一五类渲染内核（时间线家族着色口径收敛 biz-timeline/src/status、表单设计器预览复用 form-body、TabsNav 右键菜单复用 BizContextMenu、NoticeBar 跑马灯复用 BizSeamlessScroll、验证码倒计时复用 BizCountdownButton），对外 API 零变化
• v0.5.1 批次 11 个组件补齐安装器注册（此前仅具名导出，app.use 全局注册缺失）；文档站修复总览表坏行、裸标签编译失败、花括号非法属性、SSR 构建报错与 ResizeObserver 告警

v0.5.1（2026-10-16）

🐛 修复

• fix: 全库体检修复 12 项交互与样式缺陷

v0.5.0（2026-10-10）

✨ 新增

• feat: 新增趋势指标/色板选择/悬浮按钮/下载中心/代码编辑器五组件，biz-form-dialog 支持 drawer 形态

v0.4.0（2026-10-10）

✨ 新增

• feat(biz-search-form): 网格布局重构——固定间距依次排列、行行列宽一致、操作区末行贴右

🐛 修复

• fix(biz-modal): 组件入口引入 theme/index.scss——--biz-* 主题 token 随 dist/style.css 下发，修复 s/m/l 宽度预设 var() 解析失败回落 50% 的问题

v0.3.2（2026-10-09）

🐛 修复

• fix(biz-modal): s/m/l 宽度预设失效——主题 token（--biz-modal-width-* 等 --biz-* 变量）此前未进 dist 产物，var() 解析失败回落 el-dialog 默认 50%；现组件入口引入 theme/index.scss，token 随 dist/style.css 一并下发
• fix(biz-statistic-group): 统计卡按可视数等宽时最后一张被裁切——子卡与轨道均未声明 box-sizing，落到默认 content-box 后 padding/border 叠加在基准宽之外（每张 +42px，n 卡溢出 n×42px）；现轨道子元素与 .biz-statistic 均钉死 border-box，等分公式按边框盒口径成立
• fix(biz-statistic): 同步声明 box-sizing: border-box，脱离 group 单独使用时宽度口径也与 Element Plus 组件一致

🔧 构建

• build: ES 产物由单文件 dist/vue3-ep-biz-lib.es.js 改为按模块拆分（dist/es/**，preserveModules），import { BizTable } 等可在模块粒度 tree-shaking；package.json 的 module/exports 与 sideEffects 同步指向新路径（深路径引用旧单文件包的用法不再提供），UMD 单文件与 dist/style.css 保持不变

v0.3.1（2026-10-09）

✨ 新增

• feat(biz-form-dialog): 字段类型新增 slot——渲染具名插槽（name=prop，作用域暴露 model 表单数据），支持完全自定义控件（emoji 选择器等场景）；required 规则对 slot 类型按 change 触发
• feat(biz-table): 新增 rememberSettings 属性——列显隐与密度按 key 持久化到 localStorage（true 按 location.pathname 自动分 key，传字符串自定义 key，默认关闭）；恢复时自动过滤已不存在的列 key，重置按钮同步清空记忆

v0.3.0（2026-09-29）

✨ 新增

• feat: 新增 18 个业务组件与 useAuth/useDict hooks，每组件 6 示例，修复批次缺陷

📦 其他

• chore(release-infra): 随 v0.3.0 版本固化，移除侧栏「新」标记与总览页待发布提示
• chore(release-infra): CHANGELOG 模板字符转义，修复文档站构建失败

v0.2.0（2026-09-28）

✨ 新增

• feat: 新增二维码/签名/打印/图表/富文本/文件预览/地图选点 7 个业务组件，组件库扩至 67 个
• feat: 新增权限/证件录入/排班/可编辑表格等 13 个业务组件，组件库扩至 60 个
• feat: 新增 BizCalendarBoard 日期排版（月/周双模式、上/下一月周切换、单元格插槽、当天之前禁用），组件库扩至 47 个
• feat: 新增筛选标签/金额输入/标签输入/用户组/评论列表 5 组件，组件库扩至 46 个
• feat: 新增 BizStatisticGroup 统计栏组（分页箭头/页码点/循环），统计卡补数字动画/尺寸档位/attrs 透传
• feat: 新增 10 个业务组件，组件库扩至 40 个
• feat: 六组件新增业务能力
• feat(biz-process): 节点三层插槽(node-<index>/node/default)与节点字段/垂直布局/审批记录配置
• feat(components): 新增 P1~P3 共 14 个业务组件，补齐批次 1-3 组件文档
• feat(release): granular token 凭据适配、智能续发与 GAT 配置指南文档化

🐛 修复

• fix: biz-chart 空数据旧图残留——空态清空画布；新增 empty/not-merge，主题热切换、失败重试、resize 守卫
• fix: biz-amount-input SSR 构建访问 document 报错——补 SSR 守卫；biz-calendar-board 月周切换 label 当值改为 value（element-plus 3.0 移除兼容）
• fix: 通知中心面板边距——移除双重补偿负边距（溢出弹层 12px）、区块边距体系化、圆角裁切、teleported=false
• fix: 规范全局搜索示例样式（append 融合按钮 + 宽度覆盖 + 清空复位提示）
• fix(biz-icon-select): 弹窗面板超高溢出与横向滚动修复，默认加宽至 760px
• fix(release): 官方源验证自动重试；新增 edgeone.json 固化文档站构建配
• fix(release): 官方源验证读副本延迟自动重试，消除发布成功后的误报
• fix(release): 发布强制 2FA 支持——--otp 显式验证码与 --resume 断点续发

📦 其他

• chore(release-infra): 版本号推送前自动管理 + 文档站版本发布页
• docs: C 档 7 组件文档与 42 个场景示例，第三方依赖说明三级落位，侧栏图表分组与最新标记
• docs: 13 个组件文档与 78 个场景示例，总览更新至 60 组件
• docs: 日期排版文档与 6 个场景示例，总览更新至 47 组件
• docs: 5 个新组件文档与 30 个示例，总览更新至 46 组件
• docs: 统计栏组文档与 9 个示例，统计卡补动画/尺寸章节，总览更新至 41 组件
• docs: 10 个新组件文档与 50 个示例，总览页统计行
• docs: 每组件再补 3 个真实业务场景示例（90 个）并同步全量文档
• docs: 每组件补首个业务场景示例（27 个）
• docs: 六组件补进阶示例，新增全组件优化方案 OPTIMIZATION-PLAN
• docs(biz-timeline,biz-import-button): 补进阶示例与文档
• chore(qa): 归档组件批次与侧栏调整的验证截图
• style(docs): 左侧导航栏宽度 192px → 320px
• docs(workflow): 开发流程规范——dev 日常开发 / master 集成发布分支模型
• docs: 接入在线文档地址（EdgeOne Pages）
• chore: trigger production deploy
• chore: trigger production deploy

v0.1.1（2026-09-01）

首个 npm 发布版本，组件库初始 6 个组件：BizButton 业务按钮、BizModal 业务弹层、BizTable 业务表格、BizSearchForm 搜索表单、BizDivideTitle 分块标题、BizImageViewer 图片预览。