更新日志

基于仓库提交记录整理的面向用户变更说明（当前版本 1.0.0）。

2026-09

✨ 新特性

• ✨ PickerColor：输入区改为 Segment 切换 HEX(A) / RGB(A) / HSV(A) / HSL(A) 通道输入；开启透明度时同步文案与 A 通道；选中数据补充 hexa / hsv* / hsl* / hsv(a) / hsl(a)；新增 updated 事件
• ✨ shared：新增 hslToRgb / rgbToHsl、rgbaToHexa / hexaToRgba / hexToAlpha，isHexColor / parseColor 支持 4 / 8 位 HEXA
• ✨ useAnimation：current 支持泛型（数值 / 字符串 / 对象插值）
• ✨ List：状态区主题变量增加 status- 前缀，便于单独调整 loading / error / finished 样式
• ✨ Dialog / Popup：函数式 API 支持 data 泛型推断（showDialog / showPopup / open）；Dialog confirm 入参为当前 data
• ✨ useTouchZoom：支持鼠标滚轮缩放（wheelZoom）；Zoom / ImagePreview / ImageCropper 同步接入
• ✨ Fab：圆形展开改为 circle + circle-radius / circle-arc，direction 仅表示朝向；贴角收成 90° 象限并可收缩半径；新增 FabItem
• 💥 Fab：移除 offset / v-model:offset，初始位置仅用 right / bottom，拖拽位置由组件内部维护
• ✨ 新增 usePopup 函数式弹出层（showPopup / closePopup；open 在 beforeClose 放行后 resolve data）
• ✨ Popover：完善气泡提示（v-model、theme、closeOnClickOutside、open / close；trigger 为 click / longpress，不传时手动控制）
• ✨ Uploader：新增 afterChoose，便于选图后处理；示例对接 ImageCropper 裁切
• ✨ shared：FILE_MIME_TYPE / getFileInfo 等文件 MIME 与信息解析能力
• ✨ shared：新增 splitUnit、StringSuggest / NumberSuggest
• ✨ Notify：新增 grouping，相同文案可合并计数
• ✨ ImagePreview：新增 safe-top；完善双指缩放 / 旋转 / 拖动与边界阻力
• ✨ Resize：新增 fixed，适配固定定位场景
• ✨ Icon：支持图片路径作为图标
• ✨ 新增 postcss-px 插件，便于小程序端 px 转换
• ✨ Dialog：beforeClose(type, data)；函数式确认时 open / showDialog resolve 当前 data
• ✨ Toast / Notify / ImagePreview：open / show* 的 option 改为可选，与 Dialog / Popup 对齐
• ✨ 新增 TransitionCollapse 高度折叠过渡组件（含 collapseHeight、文档与示例）
• ✨ 新增 useQueue 任务队列 Hook（支持 replace / 返回值保留 / source 自动 flush）
• ✨ shared：新增 Arrayable 类型；Calendar / Slider 相关类型同步使用
• ✨ Toast / Dialog / Notify / ImagePreview：函数式 API 与 use* 接入队列，实例未就绪时可直接调用
• ✨ BEM：新增 deep-e / deep-m 等深度选择 mixin；CollapseItem 改用 TransitionCollapse
• ✨ Grid：支持子元素跨行列、布局起点配置；Slider：支持垂直方向
• ✨ 配置表单：TS 配置与 API 扩展；示例改用 TransitionCollapse

🐛 问题修复

• 🐛 useTouchZoom：触摸 / 滚轮开始前 await updateRect，避免页面滚动后缩放锚点偏移
• 🐛 Transition：修复折叠动画闪动
• 🐛 useSignature：修复水印在部分场景下未铺满
• 🐛 Slider：readonly / disabled 时不再误触发 change
• 🐛 Grid：列限制判断与拖拽排序相关修复
• 🐛 shared：DeepPartial 避免对函数 / 数组误递归；UnwrapPromise 对齐嵌套 Promise / PromiseLike
• 🐛 ClassValue / StyleValue：避免类型递归报错

🚀 优化

• 🚀 Scroller：初始化不再依赖假滚动获取偏移；视觉滚动改用 useAnimation
• 🚀 List：触底加载后按内容高度解锁滚动（避免卡在最底），并完善 pending / disabled 与滚动忽略逻辑
• 🚀 PickerColor：切换 alpha 时同步输入框与 v-model 格式（hex ↔ rgba）
• 🚀 @vital-design/styles 默认不含 effect keyframes（组件内按需引入），缓解主包体积
• 🚀 useTouchSwipe：选择器 / 事件与阻力配置；与 useTouch* 风格统一
• 🚀 ImagePreview / Zoom：缩放与边界逻辑优化
• 🚀 locale 语言包文件名统一为小写（如 zh-cn / en-us）
• 🚀 依赖：升级 Vue、uni-app；移除 env 包
• 🚀 Transition / TransitionGroup：行为与文档完善（子项配置回退父级等）
• 🚀 useTimeout：pending 状态、onStop(reason)（complete / cancel）、类型与取消语义优化
• 🚀 useInterval：useNextTick 等待挂载、回调异常后继续调度、leading / waitMounted 配置命名
• 🚀 useTouchSwipe：operate* 配置重命名为 quickMaxDuration / quickMinOffset / minOffset
• 🚀 函数式组件文档：去掉必须在生命周期后调用的说明
• 🚀 Swiper：循环补齐与非循环 prev / next 逻辑；卡片式轮播样式
• 🚀 文档与示例：组件 expose / instance 类型补全；首页与暗黑主题表现优化

2026-08

✨ 新特性

• ✨ ConfigProvider / 布局：新增 setLayoutVars 方法，便于动态设置布局相关 CSS 变量

🚀 优化

• 🚀 List：处于 error 状态时不再展示 finished 状态
• 🚀 TransitionGroup：补充组件文档

2026-07

✨ 新特性

• ✨ 新增 TransitionGroup 动画组组件
• ✨ Transition：新增 enter-left、enter-right 动画
• ✨ TransitionGroup：dataKey 支持键路径与函数，便于获取列表项唯一标识
• ✨ Dialog / Popup：支持通过 data 自定义属性配置
• ✨ Calendar：节点类名调整，便于自定义样式

🚀 优化

• 🚀 Transition：增加总周期计时器，避免动画超时未结束
• 🚀 useAnimation / useChildren：逻辑优化与边界索引处理
• 🚀 包体积压缩

2026-06

✨ 新特性

• ✨ Steps：新增 between 属性，支持水平居中分布

🐛 问题修复

• 🐛 修复 watch + nextTick 取值时序问题（需在 nextTick 后取值）
• 🐛 修复部分组件错误使用 Boolean 类型的问题

🚀 优化

• 🚀 Steps：样式调整

2026-05

✨ 新特性

• ✨ Tabs：支持自动高度，懒加载展示方式调整
• ✨ Transition：新增 flip、fall、fly 动画
• ✨ ProgressCircle：支持起始角度（start-angle）配置

🐛 问题修复

• 🐛 Tabs：修复 left 偏移计算、自动高度影响页面滚动高度等问题
• 🐛 Swiper：去掉 stop.prevent，避免轮播内部无法滚动

2026-04

✨ 新特性

• ✨ ProgressCircle：支持起始角度偏移与渐变相关能力完善
• ✨ Popover：优化弹出动画，调整 API 参数并补充文档
• ✨ DigitCounter：小数位保留支持自动匹配
• ✨ Tabbar：新增 content 相关类名与样式属性
• ✨ shared：numToChinese 支持大写及亿、兆单位

🐛 问题修复

• 🐛 修复滚动高度受外容器高度影响异常的问题

🚀 优化

• 🚀 ProgressCircle：环形进度条表现优化
• 🚀 Calendar：示例默认以星期一开始

2026-03

✨ 新特性

• ✨ Sort：组件重制，支持嵌套、动态高度；拆分 SortToolbar，便于自定义工具栏
• ✨ Search：新增快捷触发搜索配置，调整搜索触发逻辑
• ✨ Signature：补充水印配置类型；修复旋转 180° 时图片异常
• ✨ useChildren：新增 count 属性

🚀 优化

• 🚀 Grid：加载完成判断与 gap 比较逻辑优化
• 🚀 Form：datetime 日期限制逻辑优化
• 🚀 Picker / Sticky：初始化与代码结构优化（Picker 初始化时不触发动画）
• 🚀 表单校验：移除对字面量 true / false 的校验干扰；调整 numMax / numMin 逻辑

2026-02

✨ 新特性

• ✨ 新增 PickerView 基础滚动组件（触屏、滚轮、惯性与边界阻力）
• ✨ Picker：改用 PickerView 作为滚动基础，新增 option-height 等配置
• ✨ useAnimation：新增 update 方法

🐛 问题修复

• 🐛 Swiper：修复激活项与个数变化顺序、特殊场景位置错误等问题
• 🐛 PickerView：修复微信 / iframe 中触屏与点击同时触发的问题
• 🐛 Grid：解决拖拽与点击同时触发的问题

🚀 优化

• 🚀 Swiper：动画、自适应高度与事件处理完善
• 🚀 Picker：updated 等事件触发逻辑完善；label 支持按配置取值

2026-01

✨ 新特性

• ✨ Transition：新增 cacheable 配置，并同步到相关组件
• ✨ shared：新增字符串模板解析方法 strTemplate

🐛 问题修复

• 🐛 修复滚动条跑偏异常问题

2025-12

✨ 新特性

• ✨ 新增 Text 文本组件
• ✨ 新增 Popover 气泡提示组件
• ✨ Calendar：支持禁用日期 / 年；新增 cancelable、change 等能力
• ✨ ProgressCircle：支持渐变色配置
• ✨ Form / FormItem：校验事件可抛出详细校验结果

🐛 问题修复

• 🐛 修复时间选择相关日期获取问题

🚀 优化

• 🚀 节气相关资源体积优化
• 🚀 Calendar：CSS 变量命名与样式调整

2025-11

🐛 问题修复

• 🐛 Badge：修复静态 position 样式问题

2025-10

✨ 新特性

• ✨ ConfigForm：配置项支持 MaybeRef，组件值可响应式联动

2025-09

✨ 新特性

• ✨ Button：加载位置支持 prefix / suffix（原 pre 调整为 prefix）
• ✨ Signature：支持水印配置（文字、颜色、字号、字体、间距、旋转角等）
• ✨ Badge：补充层级等样式配置；单位样式优化
• ✨ Tabs：导航字体相关 CSS 配置

🐛 问题修复

• 🐛 Scrollbar：修复滚动高度大于实际高度时的修正异常

🚀 优化

• 🚀 Signature：水印生成算法优化，保证各旋转角度铺满画布
• 🚀 Radio / Checkbox：提升禁用态辨识度
• 🚀 Sort：改为子组件实现方式

2025-08

✨ 新特性

• ✨ 新增 Sort 排序列表（含工具栏、swap / 上下移动等）
• ✨ 新增 ProgressCircle 环形进度条（含动画）
• ✨ Sticky：大幅优化，新增 StickyBox，支持相对视图固定
• ✨ Table：支持 sticky 配置
• ✨ Parse：富文本解析能力落地（列表、解码、树形结构、图片预览等）
• ✨ WaterfallItem：支持动画初始位置配置

🐛 问题修复

• 🐛 Sticky：修复实机小程序监听不触发，补充手动检测
• 🐛 Transition / FormItem / Table：修复 class / style 相关异常
• 🐛 统一将 class、style 格式化为字符串，提升性能

🚀 优化

• 🚀 Scrollbar：回弹与 setScroll 优化；小程序侧支持 CSS 动画执行
• 🚀 easing 预置动画函数改为横杆命名

2025-07

✨ 新特性

• ✨ 文档：补充快速开始页

🐛 问题修复

• 🐛 修复日期 / 时间选择器在自定义筛选且设置最大最小限制后可选数据异常
• 🐛 useLoadingHandler：修复单方法触发异常、传参问题

🚀 优化

• 🚀 Picker：updated 事件触发逻辑优化

2025-06

✨ 新特性

• ✨ 新增 Segment 分段器组件（含圆角、CSS 变量等配置）
• ✨ Table：支持初始排序配置，并检查配置更新后的排序
• ✨ Rate：新增 count 配置
• ✨ 大量展示 / 导航类组件文档完善（Swiper、List、Waterfall、Collapse、ImageGrid、ImagePreview、Sticky、Steps、Progress、DigitCounter、DigitRoller、Highlight、ReadMore、Badge、Tag、Watermark、Pagination、Navbar、Tabbar、BackTop 等）

🚀 优化

• 🚀 Uploader：仅在 deleting 状态执行删除相关逻辑
• 🚀 Dropdown：opening 状态更名为 opened
• 🚀 Radio / Checkbox：禁用态改为透明度变化
• 🚀 Slider：去掉 color 的函数配置支持
• 🚀 Input / Textarea：只读 / 禁用时点击行为调整

2025-05

✨ 新特性

• ✨ Button：去掉 shape，新增 round 配置
• ✨ Switch：新增禁用配置
• ✨ Radio：新增 icon 属性
• ✨ Cell：新增主题样式配置
• ✨ Checkbox / Radio / Dialog：原 type 调整为 theme
• ✨ Pagination：新增省略号跳转相关配置
• ✨ Search：补充语言包配置
• ✨ Calendar：月份最大 / 最小属性配置调整
• ✨ API 文档写法由驼峰统一为横杆命名
• ✨ 基础 / 表单类组件文档大规模完善（Button、Cell、ConfigProvider、Layout、Grid、Transition、Animation、Popup、Toast、Image、Resize、Offset、Scroller、Scrollbar、Picker 系列、Cascader、Calendar、Input、Textarea、Search、Signature、Stepper、Slider、Uploader、Form、Loading、Notify、Overlay、Dropdown、Dialog、Fab 等）

🐛 问题修复

• 🐛 Rate：修复激活 / 非激活图标配置问题

🚀 优化

• 🚀 Radio / Checkbox / Switch：点击反馈调整
• 🚀 Input：最小高度与行高对齐，高度设为 100%
• 🚀 Cascader：文档补充异步加载示例
• 🚀 shared：waitNextTask 更名为 waitNextTick

2025-04

✨ 新特性

• ✨ 新增 ReadMore 阅读更多组件（含「始终可展开」等配置）
• ✨ 新增 ActionSheet 动作面板（支持选项异步操作）
• ✨ 新增 useScroll，统一对接 Scroller / Scrollbar（List、BackTop、Form 同步适配）
• ✨ 新增 useLoadingManager（由 useLoadingHandler 拆分），Cascader / Collapse / ActionSheet 等接入
• ✨ Loading：新增花朵加载样式
• ✨ Signature：兼容性优化，支持贝塞尔曲线绘制
• ✨ Stepper：新增 inputStep，优化小数步进与输入体验
• ✨ ImagePreview：缩放能力完善；长按菜单默认策略调整
• ✨ Swiper：激活项前后项类名；滑动与自动高度优化
• ✨ Offset：改为 fixed 定位
• ✨ 函数式调用组件 TS：改为 OpenOption，调用时补充 ShowOption
• ✨ ConfigProvider：样式结构调整；状态栏高度改用 getWindowInfo

🐛 问题修复

• 🐛 ImagePreview：修复函数调用时激活下标错误
• 🐛 Uploader：修复覆盖上传 bug
• 🐛 ReadMore：修复滚动相关异常
• 🐛 useLoadingManager：修复同名多函数、宏任务等待时的 loading 判断异常

🚀 优化

• 🚀 Scroller：减少滚动后闪动，优化多次触发滚动
• 🚀 Grid：横纵向边距计算；移除网格动画 props
• 🚀 动画帧率调整为 75
• 🚀 Table：表头宽度取一位小数，避免多余滚动条

2025-03

✨ 新特性

• ✨ Scrollbar：完成与 List、BackTop、Form 的联动适配
• ✨ Table：行点击事件与点击反馈配置
• ✨ Grid：拖拽排序优化（自定义拖拽位置、目标占位）；动画延迟支持
• ✨ Uploader / ImageGrid：网格动画配置；Uploader 删除按钮放大
• ✨ Fab：回调与交互优化
• ✨ Stepper：改用原生 input 作为输入
• ✨ useLifeCycle：拆分为 useLoadCycle、useNextTick
• ✨ shared：新增 callRetry

🐛 问题修复

• 🐛 Transition：不触发 transitionend 的问题调整

🚀 优化

• 🚀 Cascader：选项状态获取减少计算量
• 🚀 PickerDate / PickerTime：最大最小日期限制计算优化
• 🚀 Calendar：日期 / 时间限制计算调整
• 🚀 Scrollbar：仅在更新时展示滑块；x 轴可滚时宽度 auto
• 🚀 JS 动画帧率调整为 90

2025-02

✨ 新特性

• ✨ 新增 TagList 标签组组件
• ✨ bus：支持并行 / 串行配置

2025-01

✨ 新特性

• ✨ Table：loading 状态、排序改变前事件、筛选前事件
• ✨ useCallback：支持 unmounted 配置
• ✨ Form：改为通过 show / visible 控制显示与渲染

2024-12

✨ 新特性

• ✨ 新增 Table 表格组件（列 fixed、阴影、小程序兼容、表头 / 表体列插槽）
• ✨ Table：排序（含自定义排序方法）；列序号、默认值、格式化配置
• ✨ Scrollbar：新增 sliderAlways 配置
• ✨ ConfigForm 案例栏目启动；表单支持 Rate；图片未传完阻止提交
• ✨ 表单：父子规则同时生效（原仅以子级为准）；选项支持方法获取
• ✨ shared：新增 callable、defValue

🐛 问题修复

• 🐛 Rate：值未变化时不触发更新
• 🐛 Form：修复 datetime 时间格式化异常
• 🐛 Table：滚动触发列样式重复计算的问题

🚀 优化

• 🚀 Grid：添加防抖

2024-11

✨ 新特性

• ✨ Grid：拖动排序；ImageGrid / Uploader 接入排序逻辑
• ✨ DigitCounter：展示字符格式化方法
• ✨ TabbarItem 组件补充
• ✨ useAnimation：交替 / 反转动画配置独立；交替动画 reverse 事件

🐛 问题修复

• 🐛 Picker：级联选项循环更新；下标更新异常
• 🐛 Transition：高度为 0 时折叠动画异常；子节点误触发动画结束事件

🚀 优化

• 🚀 Waterfall / Grid：位置计算与更新算法、动画闪动处理
• 🚀 Grid：实时排序位置计算

2024-10

✨ 新特性

• ✨ 新增 Waterfall 瀑布流（动态等高排列、自定义列数、位置变更动画）
• ✨ 新增 Grid 宫格布局；ImageGrid、Uploader 改为基于 Grid
• ✨ Swiper：重制（无边界滑动、两项及以上循环、滑动与动画衔接、减少重排闪动）
• ✨ Swiper：swipeLimit；指示器随滑动实时切换
• ✨ Picker：immediateChange；PickerGroup active 按实际范围更新
• ✨ Rate：拆出 RateItem，修复小程序双插槽自定义图标异常
• ✨ Resize：支持防抖
• ✨ Scrollbar：updated 事件；触顶 / 底事件补充触发类型
• ✨ Waterfall：初始动画可自定义配置
• ✨ Dropdown：索引配置，避免菜单匹配异常

🐛 问题修复

• 🐛 Dropdown：遮罩层级被覆盖
• 🐛 Waterfall：小程序动画与序号异常
• 🐛 useChildren：vnode 排序问题
• 🐛 useAnimation：持续时间为 0 时进度一直为 0

🚀 优化

• 🚀 ImagePreview：滑动 / 缩放时移动限制
• 🚀 PickerColor：改为原生输入框，补充文字样式 CSS 变量
• 🚀 shared：numClamp、numMax、numMin

2024-09

✨ 新特性

• ✨ 新增 Scrollbar（阴影、滑块、惯性、四向回弹、滚轮、update 导出方法等）
• ✨ Popup：lazyRender
• ✨ Cascader：swipeTo
• ✨ Uploader：crop 裁剪配置
• ✨ Dropdown：加载中 / 空数据展示；click-option 事件
• ✨ Input：safe-password 安全数字密码类型
• ✨ Collapse：动画执行相关事件
• ✨ ImagePreview：完善加载中 / 失败态；修复无法 y 轴移动
• ✨ Image：icon-size、icon-color CSS 变量
• ✨ Scrollbar：四向滚动阴影配置
• ✨ useTouch：动量系数；贝塞尔缓动（ease 系列等）供 useAnimation 使用
• ✨ Fab / PickerGroup：插槽与 prev / next 等方法完善
• ✨ useLoadingHandler：loadings / loadingMap 结构调整
• ✨ Tabs：滑动前回调 beforeSwipe

🐛 问题修复

• 🐛 Scroller：小程序偶发无法滚至 0；通过滑动事件补充滚动检查
• 🐛 useTouchSwipe：百分比、最小时间 / 距离、swipeable 判断等问题
• 🐛 Resize：默认 CSS 被父级影响
• 🐛 BEM：嵌套 e 层级异常
• 🐛 Navbar / Tabbar：fixed 时样式强制生效
• 🐛 List：加载图标层级；触底回滚固定 5px
• 🐛 locale：语言文件大小写导致 build 声明异常

🚀 优化

• 🚀 组件内串行取尺寸改为并行；parallel / serial 类型推断
• 🚀 Radio / Checkbox：标签位置用 row-reverse 适配插槽
• 🚀 radius / round 样式统一为 $vd-radius-max
• 🚀 useAnimation：stop 后进入 stoped，不直接视为完成

2024-08

✨ 新特性

• ✨ 新增 Dropdown（上下弹出、自定义菜单、禁用、手动控制）
• ✨ 新增 Steps（横 / 纵向；激活色变量改为 active-color）
• ✨ 新增 DigitCounter（小数、千分位、默认值、过渡方法等）
• ✨ 新增 DigitRoller（自定义字符 / 样式 / 节点、最小长度）
• ✨ 新增 Watermark（文字 / 图片、自定义节点、倾斜角）
• ✨ 新增 Tag（六种预设、关闭与动画）
• ✨ 新增 Badge（最大值、红点、五位置、零值判断、进入动画）
• ✨ 新增 animate / useAnimation 动画能力（字符与对象插值、延迟、循环 / 交替示例）
• ✨ Scroller：x / y 轴滚动阴影
• ✨ Image：加载 / 错误状态类名

🐛 问题修复

• 🐛 DigitRoller：滚动位置异常
• 🐛 Calendar：描述匹配异常
• 🐛 PickerColor：Slider active CSS 变量未同步
• 🐛 BackTop：底部 / 右侧位置 CSS 异常
• 🐛 小程序访问 window.addEventListener 导致渲染失败

🚀 优化

• 🚀 Rate：激活 / 选中比率判断；全选态 active → selected
• 🚀 Input / Textarea：只读时 disabled，避免 Tab 聚焦输入
• 🚀 Image：加载中 / 错误半透明，便于看到底层进度

2024-07

✨ 新特性

• ✨ 新增 PickerColor（预览、hex / rgba 输入、透明度开关、预设色）
• ✨ Calendar：年 / 月 / 日最小最大限制；格子类名 / 文字 / 描述格式化
• ✨ Highlight：updated 事件
• ✨ Popup：宽高占满改定位方案
• ✨ Image 事件：image-click → click-image
• ✨ 按钮、图标文档完善

🐛 问题修复

• 🐛 Calendar：切换未触发 update:active
• 🐛 Signature：清空后已撤销线条还原；撤销重做颜色未还原
• 🐛 ImageGrid / Uploader：指定预览组件异常
• 🐛 Toast：loading 类型无法去掉 overlay
• 🐛 shared：numAdd 浮点计算异常

🚀 优化

• 🚀 Signature：去掉预置底栏，完善导出方法与事件；支持导出旋转角
• 🚀 Dialog / Toast / ImagePreview：可配置插槽补充 config
• 🚀 Tree：方法命名简化（Cascader / Picker）
• 🚀 Scroller：滚动优化

2024-06

✨ 新特性

• ✨ 新增 Signature（书写、撤销 / 重做、清空、加载线条）
• ✨ Loading：由 SVG 改为 HTML 节点实现；List / Picker / Switch / ImageGrid 支持 loadingType；Button 的 loadingType → loadingStyle
• ✨ Tabs：指示器自动宽度
• ✨ Textarea：清除按钮
• ✨ Rate：item 插槽
• ✨ 文档站基础样式与组件 md 骨架搭建

🐛 问题修复

• 🐛 Picker：单列无数据仍有选中下标；PickerDate 选中日异常
• 🐛 Dialog / ImagePreview：ref 调用关闭未触发 update:model-value
• 🐛 Sticky：改为通过 Resize 监听尺寸变化

🚀 优化

• 🚀 Uploader：尺寸类型、图片源类型默认值
• 🚀 Input control 外层改为 body；placeholder 样式继承调整

2024-05

✨ 新特性

• ✨ 新增 Scroller，与 List 联动；新增 BackTop
• ✨ 新增 Pagination
• ✨ 新增 Stepper
• ✨ 新增 Offset；Sticky / Fab 用 Offset 获取偏移
• ✨ Calendar 改造：track 滑动切换、switch / setActive；支持单独使用日 / 月 / 年视图；周起始日、节日 / 节气 / 农历
• ✨ 国际化落地，各组件接入语言包
• ✨ useToast / showToast / closeToast；useNotify、useDialog；ImagePreview 函数式调用（useImagePreview）
• ✨ useComponent：名称匹配、忽略组件等能力
• ✨ Navbar：fixed + placeholder 防抖高度
• ✨ Notify：偏移量、导航栏避让；Fab / Notify / Sticky：Tabbar 避让
• ✨ ConfigProvider：暗黑模式与导航 / 标签 / 状态栏变量完善
• ✨ ImageGrid / Uploader：previewName 复用页面已有预览实例
• ✨ Image：圆角、单图预览；Checkbox：三种选中态类型
• ✨ resolver 更名为 vitalDesignResolver
• ✨ 示例改为 easycom 引入

🐛 问题修复

• 🐛 多端：小程序下 Navbar 状态栏高度、Scroller 滚到底、ImagePreview 缩放手势、Swiper 无法滚动等
• 🐛 FormItem：rules 未监听导致规则不响应
• 🐛 Slider：step 失效；Toast props 与函数调用冲突
• 🐛 Transition / Collapse：折叠动画 transitionend 异常；页面 onHide 后动画结束不触发
• 🐛 Fab：位置修正；Uploader：覆盖上传被个数限制
• 🐛 List：初始不可滚导致加载异常；滚动检查 loading 误触发

🚀 优化

• 🚀 Resize：无需内盒即可监听（含 0 尺寸）；Navbar / Tabbar / Textarea / Scroller 接入
• 🚀 Scroller：scrollTo / scrollToView、滚动动画、微信兼容
• 🚀 Form：滚动到错误项；校验逻辑优化
• 🚀 Input / Textarea：num → count，max → maxlength

2024-04

✨ 新特性

• ✨ 新增 Sticky（吸顶 / 吸底、指定容器、小程序适配）
• ✨ 新增 Fab（边缘吸附、轴向限制、四向菜单、视窗间距）
• ✨ 新增 Navbar
• ✨ 新增 Switch（自定义色 / 图标、异步切换）
• ✨ 新增 Notify / NotifyItem
• ✨ 新增 Rate（分段选择、手势滑动）
• ✨ 新增 Highlight（单 / 多关键字、正则高亮）
• ✨ Transition：collapse / collapse-fade、自定义进出动画名、无内盒折叠
• ✨ 全局弹层 zIndex 维护；组件统一 customId
• ✨ Search 组件文件创建；Slider：标签常显 / 触屏触发、动画时长、thumb 插槽
• ✨ useIntersectionObserver、useTimeout、useInterval、useLifeCycle 等 Hooks
• ✨ 包名：vital-design-uni → vital-design

🐛 问题修复

• 🐛 Sticky：悬浮宽度、相对容器边界闪动
• 🐛 Toast 层级；Tabs 切换动画未渲染项占位
• 🐛 Calendar：选周日误选下周
• 🐛 strMatcher：非全局正则死循环、匹配下标异常
• 🐛 小程序 nextTick / 兼容性问题一批

🚀 优化

• 🚀 Collapse 折叠动画改用 Transition；Tabs 滑动切换逻辑
• 🚀 useTouch / useTouchSwipe：方向与操作判定，修复双轴误触
• 🚀 布局类 props 单位支持响应式

2024-03

✨ 新特性

• ✨ 新增 Calendar（日 / 月 / 年、单选多选区间 / 周选、滑动切换、重置等）
• ✨ 新增 Uploader
• ✨ 新增 ImagePreview（滑动、双指缩放）
• ✨ 新增 ImageGrid
• ✨ 新增 Slider（单 / 双滑块）
• ✨ 新增 Resize 尺寸监听
• ✨ 新增 Collapse（异步折叠）
• ✨ 新增 Input / Textarea（字数限制、自动高度等）
• ✨ Cascader：异步加载、滑动切换、受控绑定值
• ✨ Swiper：loop 等；Progress：标签位置改为类型，新增 inner
• ✨ shared：编解码、数字运算、千分位、金额、toChineseNum、校验方法、useTouchSwipe、useLazyRender 等

🐛 问题修复

• 🐛 Cascader：懒加载 hasChild、立即监听导致不跳转下级
• 🐛 Swiper：与页面滚动冲突、少图切换异常、滑动距离过小仍切换
• 🐛 Form：提交不触发验证；Input / Textarea border 误删还原

🚀 优化

• 🚀 PickerDate / PickerTime：选项过滤；Tabs 去掉滚动条
• 🚀 Radio / Checkbox / Collapse：change 事件

2024-02

✨ 新特性

• ✨ 新增 Toast（含 ref 调用）
• ✨ 新增 Progress
• ✨ 新增 Form / 表单校验（Input change / blur 触发校验）
• ✨ 新增 Swiper、Tabs（懒渲染）
• ✨ 国际化、主题定制与 ConfigProvider
• ✨ Radio / Checkbox：卡片样式；Cell / Toast 等联动完善

🚀 优化

• 🚀 PickerDate / PickerTime：支持数字入参
• 🚀 主题配置与子父组件通信逻辑

2024-01

✨ 新特性

• ✨ 仓库初始化，搭建 monorepo 与文档示例
• ✨ 新增 Button、Icon、Loading
• ✨ 新增 Radio、Checkbox、Layout（Row / Col）、Cell / CellGroup
• ✨ 新增 Picker、PickerDate、PickerTime、PickerGroup
• ✨ 新增 Tabbar、Transition、Overlay、Popup、Dialog、Cascader
• ✨ SCSS 变量与可配置组件 CSS 变量；shared / styles BEM 基础能力

🐛 问题修复

• 🐛 PickerDate / PickerTime：日期限制相关问题

如需按具体版本号拆分发布说明，可在打 tag 后基于该文件继续增量更新。