变更日志
@plaud/design 的发布历史,按发布版本组织(最新在前)。每个版本内部按 ✨ 新功能 与 🐛 缺陷修复 二级标题分组,并按组件逐条列出。版本号取自包的 changeset 变更日志。早于首次发版的变更归入 Pre-release 分组。
v0.5.0
✨ 新功能
- ImageViewer — 放大后支持鼠标拖拽平移;zoom > 1 时可拖拽图片定位局部区域,光标自动切换为 grab / grabbing;含边界约束,图片不会被拖出视口;切图、缩小到默认倍率或关闭时平移量自动复位(WEB-1062)
🐛 缺陷修复
- Toast — 修复 top-center 定位下 Message 形态水平偏左问题;将
left: 50%改为translateX(calc(210px - 50%)),避免w-fit宽度被压缩(WEB-1105)
v0.4.6
🐛 缺陷修复
- ui — Tailwind v4 CSS 变量任意值类语法从方括号迁移为括号写法;将
popover、hover-card、tooltip、navigation-menu、dropdown-menu、context-menu、menubar、select中所有xxx-[--radix-yyy]替换为xxx-(--radix-yyy),修复 v4 消费方下max-height、transform-origin、视口尺寸类静默失效问题(WEB-1108) - ui / Popover / DropdownMenu / ContextMenu / Select — 修复弹层内容在 Dialog 中被 react-remove-scroll 拦截导致滚轮失效;新增
useStopWheelPropagationhook,为 portal 化弹层内容节点挂载原生wheel监听并stopPropagation(WEB-1109) - Dialog — 内容区改用
flex-1填充 header 与 footer 之间的空间,内容溢出时 footer 保持固定在底部
v0.4.5
🐛 缺陷修复
v0.4.4
🐛 缺陷修复
- Breadcrumb — 折叠下拉项透传
itemRender,新增placement字段区分下拉与内联渲染,修复折叠项整页刷新(WEB-1044)。折叠项此前绕过itemRender写死<a href>,现已正确以placement: 'dropdown'调用itemRender。 - Calendar — 修复暗黑模式下选中态日期数字不可见(WEB-1041)。文字色由
--Foregrounds-White(始终白色)改为--Labels-Reverse(light 白 / dark 黑),始终与--Labels-Primary选中背景色形成对比。
v0.4.3
🐛 缺陷修复
- Dialog —
showClose为true(默认)时,DialogTitle增加右侧留白(--Spacing_40),防止长标题被关闭按钮遮挡。
v0.4.2
🐛 缺陷修复
- Tooltip / HoverCard — focus 触发打开收窄为仅
:focus-visible(DES-134)。鼠标点击触发的焦点与编程式焦点还原(如嵌套 DropdownMenu 关闭后)不再重新打开浮层,键盘可见焦点行为不变。
v0.4.1
🐛 缺陷修复
- ImageViewer —— ImageViewer: 默认导出改为先
fetch成 blob 再用同源 objectURL 下载,跨域 CDN 图片也能真正下载而非跳转新页面;fetch失败或 HTTP 非 2xx 时回退到原始地址,objectURL 延迟回收(DES-133)。
v0.4.0
✨ 新功能
- Tree —— Tree title 溢出检测改为按需测量(DES-132)。
useTitleOverflow改为在指针进入 / 聚焦该行时按需测量,不再挂载即测,消除大数据量列表的布局抖动。契约变化:超长 title 仅在首次 hover/focus 后才包成 Tooltip trigger,并移除ResizeObserver。
v0.3.1
🐛 缺陷修复
- ImageViewer —— 单图工具栏优化 + 无障碍修复(DES-130)。单图隐藏上一张/下一张导航,禁用图标光标恢复
not-allowed,新增role="status"/aria-live="polite"缩放播报,支持键盘缩放(+/=/-)。
v0.3.0
✨ 新功能
- Overlay —— Tooltip / DropdownMenu / Popover / HoverCard 可组合 trigger(DES-128)。四个 children-as-trigger overlay 改为
forwardRef,通过extractForwardableTriggerProps将事件 / aria 关系 / 条件 id 转发给内部 Trigger,支持<Tooltip><DropdownMenu>…</DropdownMenu></Tooltip>这类嵌套组合。
v0.2.2
🐛 缺陷修复
- Input —— Input 家族 PR review 修复,记录在 Input 新增 allowClear + 补充 visual case。
useClearableInput改用原生 value setter + 真实input事件派发(完整SyntheticEvent);InputSearch清空按钮补focus-visible焦点环;仅allowClear时托管聚焦态;新增可本地化的clearButtonAriaLabelprop。
v0.2.1
🐛 缺陷修复
- Input —— 清空按钮(
allowClear)补充focus-visible键盘焦点环(ring-1+Labels/Primary,WCAG 2.4.7)。详见 Input 新增 allowClear + 补充 visual case。
v0.2.0
✨ 新功能
- Input —— 新增
allowClear一键清除能力。 - Skeleton —— 重构支持
items多块渲染,以及圆角/颜色挂 token + 卡片级SkeletonGroup扫光。 - useFilePicker —— 新增原语并接入 ChatInput。(无文档站详情页。)
- 无障碍 —— a11y 自动化:vitest-axe 单测层 + Playwright 集成层 + 49 组件审计。
- Button —— icon-only 交互状态对齐。
- Dialog —— 可滚动内容 + flex 布局。
- Toast —— 新增单条
closeButtonprop。
🐛 缺陷修复
- Button / Checkbox —— 禁用态 label 颜色改用
:has()修复。 - Typography —— token 对齐 Figma 设计系统。
v0.1.0
Skeleton 重构与若干组件细化(大部分已被上方更详细的 v0.2.0 条目覆盖)。
✨ 新功能
- Skeleton —— 重构支持
items多块渲染,新增SkeletonGroup卡片级扫光。 - Button —— 对齐 icon-only 状态。
- Dialog —— 支持可滚动内容。
- Checkbox / RadioGroup / Menu / Slider —— 样式与行为细化。
- utils —— 新增
merge-refshelper,并从包入口导出。
🐛 缺陷修复
- Button —— 修复 disabled label 样式。
v0.0.1
首次发布 —— 将 design 包发布到私有源。@plaud/design-tokens 与 @plaud/design 以构建产物 dist 形态发布(0.0.1)。
Pre-release
早于 changeset 发布流程的变更 —— 未单独发版。
✨ 新功能
- 2026-06-12 —— Radio & Checkbox 热区扩至 20×20 + 补充 visual case(DES-96 / DES-97)
- 2026-06-12 —— Breadcrumb title 超长截断(DES-93)
- 2026-06-12 —— Tree 拖拽视觉与行布局对齐新版 Figma(DES-89)
- 2026-06-08 —— Tree item 间距 4px + title/action 布局重构 + 渐变遮罩
- 2026-06-03 —— RadioGroup & Checkbox 新增
labelprop 扩大点击区域(DES-68) - 2026-06-03 —— Dialog
okButtonProps/cancelButtonProps+ 纯内容模式 + 移除 AlertDialog - 2026-06-02 —— 同步 2026/06/01 组件更新(DES-40)
- 2026-06-02 —— Dialog 新增 Size=Emphasized 变体(DES-37)
🐛 缺陷修复
- 2026-06-10 —— Toast title 字重改为 Emphasized(Semibold)
- 2026-06-03 —— Switch Toggle On 颜色更新为蓝色 #1573D1(light mode)(DES-69)
- 2026-06-03 —— Typography 字号与行高 token 更新(DES-67)
- 2026-06-03 —— Typography Font-Weight-Emphasized token 更新(DES-66)
- 2026-06-03 —— PageControls Dot 颜色 token 更新(DES-65)
- 2026-05-06 —— 第二轮修复(设计师反馈)(WEB-377)
- 2026-04-28 —— 第一轮批量修复(WEB-377)
关联
- Linear 项目:Plaud Design