#Changelog

#Unreleased

#🗑 破坏性变更

• ProForm
  • 🗑 移除对外导出的 warpField；自定义字段请改用 createProFormField 或 useProFormFieldShell #9751

#🆕 新特性

• ProForm
  • 🆕 导出布局与表单壳层类型（ProFormGridConfig、CommonFormProps、BaseFormProps、ProFormRef、SyncToUrl、useGridHelpers、getSpanConfig、FieldContextProps、FormFieldType 等）及 createProFormField / useProFormFieldShell #9751
• QueryFilter / ProList / ProCard
  • 🆕 抽取共用响应式断点工具；QueryFilter 的 span 支持 Partial 配置（未写档位按 antd Col 规则向前填充）#9750

#🐛 问题修复

• ProForm
  • 🐞 纯展示字段（children + 无 name/value）不再向 children 根节点透传小写 readonly，避免 Invalid DOM property 告警；经 ProField 的字段只读语义不受影响 #9107 18d5a7f2c
• ProTable
  • 🐞 LightFilter 在工具栏内恢复为扁平 inline 条，不再被包成卡片（修复 #9742 后出现的 card-in-card）；cardBordered.search 仅作用于 QueryFilter/Form，对 light filter 静默忽略 c2471f92a
• ProList
  • 💄 卡片模式下头像与标题补齐 token.marginXS 间距，与列表模式一致 25e6b868c
• 文档站
  • 🐞 修复 Rspress 迁移后 Vercel/pnpm site 因 react-router 被强制锁在 v6 而无法解析 react-router/dom 的构建失败 #9753
  • 🐞 修复文档侧栏中文乱码，并纠正首页插画拉伸与信息层级 #9754

#⚡️ 性能

• ProForm
  • ⚡️ ProFormDependency 与 LightFilter 弹层路径按需加载；LightFilter 通过 context 注入 light 渲染器；scripts/checkFormTreeShaking.mjs 约束 ProFormText 初始分包 #9751
• ProField / ProForm
  • ⚡️ 收紧字段 valueType 映射与表单字段导入，提升组件 tree shaking 0267faf61

#📖 文档

• 📖 文档站从 dumi 迁移至 Rspress v2：双语路由、demo 预览、SSG、sitemap、GA，并补充链接校验与首页探索区 #9747
• 📖 重排官网首页信息层级（品牌 Hero → 搜索/核心组件 → 特性），更换插画并修复重复渲染 #9754

#🛠 其他

• 🛠 升级 pnpm 至 12.10.1，并将相关配置迁移到 pnpm-workspace.yaml #9748 @zzjiaxiang

#✅ 测试

• ProForm
  • ✅ 补充 pickProFormItemProps / omitProFormItemProps 透传与字段壳层相关用例 #9751
• ProTable
  • ✅ 锁定 LightFilter 在工具栏内保持扁平布局的回归 c2471f92a

#[3.1.15-7] - 2026-10-10

#🐛 问题修复

• ProCard
  • 🐞 修复无底边 header（默认、未开 headerBordered）时 title 与内容间距过大：antd Card head 靠 minHeight 撑高，仅去掉边框后标题下方空隙会与 body padding 叠加；现对齐 legacy 紧凑布局（minHeight: auto、底部留白 0、small 用 paddingXS），收起时补回底部留白避免标题贴底。headerBordered / inner 保持 antd 皮肤不变 6f62df36e
  • 🐞 修复 tabs + loading 时骨架屏紧贴标题：tabs 场景 body padding 由组件内置置 0，loading 骨架现自带内容区同款 padding（paddingLG）；布局壳 split / 嵌套 + loading 时保留 body padding，避免 antd 骨架贴边

#⚡️ 性能

• ⚡️ 打破 Form 类型循环以支持 tree shaking，并将字段值类型映射拆分为异步分包，减小主包体积 #9745

#🛠 其他

• 🛠 移除内部 PureProField，统一使用 ProField；provider 场景化重构（分支代码归档合并至 master）#9744

#[3.1.15-6] - 2026-10-08

#🐛 问题修复

• ProCard
  • 🐞 未传 variant 时透传给 antd Card，跟随 ConfigProvider 的 card.variant / 全局 variant（不再写死 outlined）2a5a156b2
• 🐞 修复 antd 无障碍（a11y）与 mask API 控制台警告 2ba4598d1

#[3.1.15-5] - 2026-10-05

#🐛 问题修复

• ProCard
  • 🐞 基础卡片对齐 antd Card 皮肤（ant-pro-card + ant-card），移除 ant-pro-card-antd-card #9740
  • 🐞 扩大 antd 路径：collapsible / tabs / 嵌套布局不再强制 legacy；折叠用 CSS 显隐并保留布局壳子树；仅响应本卡 header #9742
• ProTable
  • 🐞 搜索表单外层改为真实 ProCard，与 cardBordered 对齐 #9742
• InlineErrorFormItem
  • 🐞 校验错误出现时自动打开 popover，并改为仅 hover 触发以免干扰输入聚焦

#⚡️ 性能

• ⚡️ 移除 swr 与 route-utils 运行时成本，菜单路由改为内置轻量实现 #9739

#[3.1.15-4] - 2026-10-04

#🐛 问题修复

• BetaSchemaForm

  • 🐞 修复 layoutType="Embed" 独立使用时 onValuesChange、onFinish 等回调不生效，并保持嵌套在已有 Form 内时仅透传字段 #8727
  • ✅ 锁定 Form 与 LightFilter 布局切换回归 #8850

• ProFormCaptcha

  • 🐞 为全部内置语言补齐验证码按钮与倒计时默认文案 #8899

• ProTable

  • 🐞 保留 Table.EXPAND_COLUMN 的显式位置，并锁定 Tabs 内列宽与省略、valueEnum 格式化省略回归 #8913 #8747 #8694
  • 📚 补充 onCell rowSpan/colSpan 合并单元格文档与示例 #8701

• ProLayout

  • ✅ 锁定 layout="mix"、splitMenus 与 siderMenuType="sub" 组合下的子菜单渲染 #9310

• 密度选择器

  • 💄 让多语言密度菜单按文案内容自适应宽度 #9619

• 统一编辑字段中的自定义日期格式解析与 URL 同步的秒/毫秒时间戳回显 #8863 #8810

• 在 omitNil=false 时保留空字段，透传字段级失焦校验，并使 ellipsis tooltip 与格式化后的显示文本一致 #8044 #8380 #8542

• 支持受控搜索值刷新 Select 请求且避免空搜索重复请求，正确处理 QueryFilter hidden 字段与响应式垂直布局 #8801 #8780 #8928 #8397 #8836

• 修复 BaseForm 开启 grid 后 contentRender 收到非数组导致的崩溃，并允许受控 Overlay 表单在挂载前响应 trigger 打开 #8253 #9624

• 同步 Overlay 变化后的 initialValues、StepsForm request 延迟初始化的 formRef，以及包装 StepForm 的显式 children #8834 #9165 #8624 #8108 #9021

• 修复 EditableProTable 函数式 rowKey 下嵌套子行表单路径错误，并补充 ProFormList 嵌套表格的受控写法回归测试 #8893 #6508

• 统一 convertValue / transform 的整表数据、嵌套列表和 ProTable 列转换语义 #8907 #8480 #9120 #9032

• 修复只读空数组、Digit 前后缀及数字 valueEnum 回显问题 #8848 #8844 #8517

• 修复 TreeSelect 自定义打开回调覆盖内部状态的问题，并补充虚拟滚动与 halfChecked 使用说明 #9138 #8876 #8869

• 补充 ProFormSelect 远程请求节流结果的回归测试 #6766

• ProForm

  • 🐞 ProFormGroup 改为直接导出，避免 SSR/ESM 打包器在模块初始化阶段读取未完成的 ProForm.Group #8543

• ProFormList

  • 🐞 让 actionRef.add 和 actionRef.remove 统一经过 actionGuard、onAfterAdd 与 onAfterRemove #8939
  • ✅ 增加 preserve={false} 字段复制、条件重挂载及首次提交 transform 的回归测试 #8208 #8896 #8700

• BetaSchemaForm

  • 🆕 在 formList 子列的函数式属性中传入当前行号 #8561

• ProList

  • 🐞 恢复 showActions、showExtra 与卡片操作区位置，并锁定栅格间距和实时分页回归 #7421 #8387 #7862

• ProTable

  • 🆕 增加 options.setting.listItemTitleRender，支持列设置标题自适应渲染 #9620

• 🐞 将 useEditableMap、useEditableArray 与 SettingDrawer 中的 antd 静态 message 调用替换为 App.useApp()，以正确消费动态主题上下文

#📖 文档

• 📖 明确 v3 仅发布 @ant-design/pro-components 单体包，补充 antd 6、Umi、Next.js、rc-util、path-to-regexp 和 antd 4 的安装构建排查 #9629
• 📖 增加 ModalForm 首次打开前安全调用 setFieldsValue 的 forceRender 示例与时序说明 #9628

#✅ 测试

• ✅ 增加 LoginForm/ProFormGroup SSR 和 ModalForm 首次打开前写值回归测试

#[3.1.15-2] - 2026-09-27

#🆕 新特性

• EditableProTable
  • 🔥 editable.editableKeys 支持 cell 粒度复合键 `${rowKey}:${dataIndex}`（如 ['1:name'] 仅激活该单元格编辑），与行级 key 完全向后兼容、可混用 #9643 b6826ece5
  • 🆕 onCell 返回的 td props 注入 data-editing / data-cell-editing 编辑状态，便于自定义单元格交互（#9043 方案 C） b6826ece5
• ProTable
  • ⚡️ 纯 ellipsis: true 改用 antd Table 原生 CSS 省略，大数据量渲染显著提速；配置 tooltip/showTitle 或 copyable 时仍走 Typography 渲染，行为不变 #9664 #8868 01fda391d
  • ⚡️ 单元格渲染热路径重构：editableKeys 改为变更时一次性构建索引（Set/Map），查询 O(1)，编辑态判断耗时降低约 5 倍；未开启 editable 的表格不再包装 onCell，树形数据无子行时跳过索引注册 84a36700a
• ProForm
  • 🔥 新增 loadingRender 属性，支持自定义 request 加载期间的渲染（如 Skeleton），对齐 antd 5.18+ 加载风格 #9679 803017665
• ProFormSelect
  • 🆕 顶层新增 fetchDataOnSearch 属性，设为 false 时 request 仅初始化拉取一次，搜索走本地过滤 #9682 803017665

#🐛 问题修复

• ProForm
  • 🐞 修复显式 valueType 被 valueEnum/request 推断覆盖的问题 #9002 399a1da0b
  • 🐞 修复用户传入的 noStyle 在非 light 模式下被覆盖的问题 a96050e33
  • 🐞 修复固定宽度 ProFormDigit 与 addonAfter 被顶开的问题 #9211 aa266935f
  • 🐞 修复 ProFormCheckbox 的 readonly 未透传到 antd Checkbox disabled 的问题 #9107 4c8d0f257
  • 🐞 修复同名字段生成重复 input id 的问题 #9144 4c8d0f257
  • 🐞 修复 ProForm 字段 help 属性未透传的问题 #9066 4c8d0f257
  • 🐞 修复 ProFormMoney 在 ru-RU 下货币符号位置、分隔符与 numberFormatOptions 合并错误的问题 #9090 4c8d0f257
  • 🐞 修复 ProFormList 嵌套 name 路径下 transform 未触发，以及 list render 传 [index, key] 时行索引重复的问题 #9129 #9238 4c8d0f257
  • 🐞 修复 ProFormList onAfterAdd 回调参数与文档不一致的问题 #9102 4c8d0f257
  • 🐞 修复编辑行时 rules 相关 props 被错误展开到 Fragment 的问题 #9153 4c8d0f257
  • 🐞 修复 onFinish 错误被静默吞掉的问题，现通过 console.error 暴露 #9019 399a1da0b
• ProField / ProTable
  • 🐞 修复 select 只读态枚举输出无法配合 ellipsis + copyable 省略的问题 #8978 399a1da0b
• ProTable
  • 🐞 修复 request 在加载/分页/重置时收到 sorter/filter 为 null 默认值的问题 #9161 ddbbb1425
  • 🐞 修复 DragSortTable 重新取数或更新行选择时重挂表格、导致固定表头闪烁和滚动位置归零的问题 #8342 #8404
  • 🐞 修复多级分组列在列设置中无法展开、切换或排序，以及 CellEditorTable 分组叶子列无法双击编辑的问题 #8988 #8133 #8880
  • 🐞 修复 EditableProTable 过滤、树形子行与 name 模式组合时编辑错行、取消误删、回调缺少子行 id，以及动态校验规则和新增行数据滞后的问题 #8930 #8662 #7859 #8861 #8174 #9184
• ProDescriptions
  • 🐞 修复 request 的 params 未注入 dependency 值的问题 #9170 4c8d0f257
• Provider
  • 🇺🇸🇨🇳 修复空字符串 locale 文案（如 vi-VN 分页 range）被错误回退到 zh-CN 的问题 #9016 399a1da0b

#🛠 其他

• 🛠 覆盖存在漏洞的传递依赖至已修补版本（开发依赖范围） 1e84af860
• 🛠 统一 esbuild 至 0.28+，消除开发服务器告警 301644384

#✅ 测试

• ✅ 新增 loadingRender、fetchDataOnSearch、原生 ellipsis、cell 级 editableKeys 回归测试
• ✅ 为 #8973、#9033、#9104、#9118、#9119、#9121、#9133、#9142 等已验证场景补充回归锁定
• ✅ 稳定可编辑表格与 layout mix 快照相关 flaky 用例 943d09a83

#[3.1.15-1] - 2026-09-26

#🐛 问题修复

• ProForm
  • 🐞 修复 LightFilter 折叠部分表单值未正确重置的问题 2dc5c9a67
  • 🐞 修复 LightFilter 输入过程中面板意外收起的问题 #9649
  • 🐞 修复 LightFilter 标签重复显示的问题 #9695
  • 🐞 修复 LightFilter 未生效 ignoreRules 的问题 #9166
  • 🐞 修复 hash 路由下查询参数同步错误的问题 #8649
  • 🐞 修复 QueryFilter 默认收起数量未生效的问题 e42cc49d3
  • 🐞 修复 onValuesChange 中空值丢失的问题 cbd1dff33
  • 🐞 修复 SchemaForm 嵌套日期字段元数据丢失的问题 #9663
  • 🐞 修复 SchemaForm 自定义字段绑定的类型错误 #8615 #8617
  • 🐞 修复自定义字段递归渲染的问题 #9676
  • 🐞 修复 formItemRender 配置类型被丢失的问题 #9676
  • 🐞 修复初始值在 transform 前未转换的问题 #8452
  • 🐞 修复表单值被重复转换的问题 #9285
  • 🐞 修复 DrawerForm 支持原生 drawer 缩放 #9675
  • 🐞 修复隐藏提交按钮时提交流程错误的问题 #8648
  • 🐞 修复外部 form 实例请求值未刷新的问题 #8352
  • 🐞 修复组件重挂载后使用过期 form 实例的问题 #9703
  • 🐞 修复字段级 readonly 未覆盖表单 mode 的问题 a8be297a1
  • 🐞 修复字段级 layout 配置未生效的问题 66356980c
  • 🐞 修复 addon 字段灵活性受限的问题 d1f385a2a
  • 🐞 修复默认 render 字段 props 被意外覆盖的问题 4abf70ef6
  • 🐞 导出 ProForm group props 类型 8e34e54c5
• ProTable
  • 🐞 修复「固定选择列 + 固定列」场景下表头勾选框被相邻固定列遮挡的问题 23cd4b86e
  • 🐞 修复拖拽排序时滚动失控的问题 d14d3814a
  • 🐞 修复行内校验错误信息不可见的问题 59c966cc8
  • 🐞 修复离屏虚拟可编辑行未校验的问题 #9553
  • 🐞 修复已删除的可编辑行值残留的问题 #9051
  • 🐞 修复 ColumnSetting 拖拽后固定列丢失的问题 #9687
  • 🐞 修复 filterType 切换时搜索表单未替换的问题 #9613
  • 🐞 修复数据清空后缓存行未重置的问题 #9203
  • 🐞 修复表单更新后提交值不完整的问题 #9236
  • 🐞 修复单元格编辑器改动丢失的问题 #8472
  • 🐞 修复取消编辑时 form 行未移除的问题 #8664
  • 🐞 修复可编辑行按 rowKey 校验失败的问题 #9280
  • 🐞 修复操作列对齐方式未生效的问题 #9701
  • 🐞 修复密度切换触发器 ref 转发的问题 #9699
  • ⚡️ 优化可编辑表格全量重渲染的问题 3ba9b4a3f
• Provider
  • 🛠 样式体系注入 iconCls token，并迁移全部写死的 .anticon 选择器，自定义 ConfigProvider.iconPrefixCls 时 ProComponents 样式可正确跟随 308fe7a2e
• ProLayout
  • 🐞 修复侧边栏滚动条颜色未应用主题的问题 bd097660f
  • 🐞 修复 ConfigProvider hashed 设置未继承的问题 #8473
  • 🐞 修复空移动端菜单触发器误显示的问题 #7312
  • 🐞 修复折叠菜单弹层未应用 token 的问题 #8095
  • 🐞 修复水印下 sticky 内容丢失的问题 #9698
  • 🐞 修复异步加载菜单未展开的问题 #9697
• ProField
  • 🐞 修复 percent 精度处理错误的问题 #9549
  • 🐞 修复长文本 readonly 换行的问题 #8581
  • 🐞 修复 textarea read 模式透传 showCount 的问题 #8642
  • 🐞 修复对象形式 showSearch 配置未生效的问题 #9680
  • 🐞 修复 LightFilter select 清空后值未清除的问题 #9227
• ProDescriptions
  • 🐞 修复可编辑字段未填满宽度的问题 91970093b
  • 🐞 修复 ellipsis 前值未格式化的问题 0de4ddefb
• ProSelect
  • 🐞 修复 request 选项按 value 匹配错误的问题 #9222
  • 🐞 修复失焦时残留搜索值未隐藏的问题 #9292
• 其他
  • 🛠 修复声明产物中 src 导入路径未重写的问题 #9017

#✅ 测试

• ✅ 新增固定选择列 z-index 回归测试 23cd4b86e
• ✅ 修复可编辑表格用例与 fake timers 冲突导致的偶发失败，并补齐侧边栏滚动条类名快照 38addfdb2

#[3.1.14-7] - 2026-08-28

#🐛 问题修复

• ProCard
  • 🐞 修复 actions 区域语义化 className/styles 未应用的问题 #9693
• ProDescriptions
  • 🐞 修复用户 styles 与内部默认样式合并被覆盖的问题 #9692
• 国际化
  • 🇺🇸🇨🇳 修复 zh-TW 语言包错别字 #9691
• 其他
  • 💄 应用 fontWeightStrong token 到 ProList meta 标题与可编辑文本

#[3.1.14-6] - 2026-07-29

#🐛 问题修复

• ProTable
  • 🐞 修复提交的搜索字段未同步写入 URL 的问题，现已与 syncToUrl 行为对齐 #9665 #9674 @pingfan

#✅ 测试

• ✅ 新增 syncToUrl 搜索字段同步的回归测试，校验表单提交后 URL 参数正确更新

#[3.1.14-5] - 2026-07-24

#🐛 问题修复

• ProForm
  • 🐞 修复 ProFormField 组件无法通过 form.getFieldInstance 获取实例的问题，ProFormText、ProFormText.Password、ProFormTextArea、ProFormDigit 等组件现在均可正确返回实例 #9673
• ProField
  • 🐞 修复 ProField forwardRef 类型声明，返回 ForwardRefExoticComponent 以兼容 React 19 + TypeScript 6 #9671 #9672 @Phecda

#✅ 测试

• ✅ 新增 getFieldInstance 回归测试，覆盖 text、password、textarea、digit、数组 name 路径、dependencies 及 fieldRef 共存场景

#[3.1.14-4] - 2026-07-22

#🐛 问题修复

• ProTable
  • 🐞 修复 ColumnSetting 固定列排序顺序错误的问题，并完善固定列与列顺序的同步逻辑 #9556
  • 🐞 修复卡片边框（cardBordered）模式下 ListToolBar 内边距未动态适配的问题
• Provider
  • 🐞 修复 CJS 产物引用 antd/es 导致的 CommonJS 兼容性问题，改用 antd/lib

#🛠 其他

• 🛠 依赖例行升级到最新 minor 版本 #9670

#[3.1.14-3] - 2026-07-22

#🐛 问题修复

• ProTable
  • 🐞 修复 options.search 传入 ReactNode 时 TS2322 类型错误
  • 🐞 修复 syncToUrl 搜索字段不写入 URL 的问题 #9665
  • 🐞 修复 syncToUrl 在 request 不含宏任务时不触发的问题 #9096
  • 🐞 修复 ColumnSetting 重置后未恢复拖拽顺序的问题
  • 🐞 修复分页变化未触发 syncToUrl 的问题 #6967
  • 🐞 修复 EditableTable 取消编辑时 form 为 undefined 报错的问题 #9640
• ProField
  • 🐞 修复 ColorPicker 默认预设 label 硬编码英文的问题，改为国际化读取 #9668
• Utils
  • 🐞 修复 isDeepEqualReact 循环引用导致栈溢出的问题 #9666 #9667 @lblblong
• Provider
  • 🐞 新增乌尔都语（ur-PK）locale 支持 #9218

#[3.1.13-0] - 2026-07-05

#🐛 问题修复

• ProLayout
  • 🐞 修复 PageHeader 中 fontSizeHeading4 类型转换导致的 TS2322 编译错误
• ProTable
  • 🐞 修复 search 禁用但 toolbar options 存在时 card wrapper 未渲染的问题
  • 🐞 修复 EditableTable 中 onChange 重复触发及 useImperativeHandle 依赖问题
  • 🐞 修复 ColumnSetting 嵌套列父子联动失效及重置时读取 stale 缓存的问题
  • 🐞 修复列类型定义中 & 优先级导致的类型坍塌问题
  • 🐞 修复高频 reload 时 abort 信号绑定错误导致请求被误取消的问题
  • 🐞 修复 visibilitychange 事件闭包陷阱及 useFetchData 中 pageInfo 快照覆盖问题
• ProForm
  • 🐞 修复 FormItem label 和 tooltip 在轻量模式下被错误覆盖的问题
  • 🐞 修复 DrawerForm 冗余 onOpenChange 回调
  • 🐞 修复日期选择器按 valueType 对齐 picker 与默认 format
  • 🐞 修复 FormList 中时间类型提交时未正确转换成 string 格式的 bug #9631
  • 🐞 修正周格式与提交语义，并统一日期范围只读展示
• ProField
  • 🐞 读模式日期格式化与周/季范围默认格式修正
  • 🐞 修复 ColorPicker 使用 antd ColorPickerProps 类型 #9566
  • 🐞 修复 proFieldParsingText 中 labelInValue 对象在只读模式下导致 React 渲染崩溃的问题
  • 🛠 DigitRange 分隔符由 Input 组件替换为语义化 span，优化样式一致性
• Provider
  • 🐞 修复 dark=false 时未正确重置 darkAlgorithm 的问题
  • 🐞 对齐 locale keys 并修正 i18n 字符串 #9595
• Utils
  • 🐞 修复序列化 dayjs 的解析与提交转换、范围文案格式化
  • 🐞 修复 transformKeySubmitValue 中数组父节点下对象转换导致数组形状破坏的问题
  • 🐞 修复 useEditableArray 中 tableName 模式下 saveRefs 泄漏及新增行默认值丢失
  • 🐞 修复 nanoid 在 SSR/Workers 环境下 window 访问崩溃的问题 #9596
• ProList
  • 🐞 修复 LightWrapper 子节点 props 合并顺序导致轻量筛选输入不生效的问题

#⚡️ 性能提升

• ProDescriptions
  • ⚡️ 稳定化 fetch action 并 memoize schema
• ProTable
  • ⚡️ 使用 useMemo 和 useRefFunction 优化表格组件渲染性能
• ProList
  • ⚡️ 提取 renderItem 并添加 memo 优化列表渲染

#🛠 重构

• ProCard
  • 🛠 重构组件并修复 ref 透传与 loading 状态问题
• ProList
  • 🛠 使用 useRefFunction 替代 useCallback 并修复 SSR 兼容性
• ProTable
  • 🛠 重命名 Container 为 TableProvider 并优化持久化逻辑
  • 🛠 清理未使用的导出并重命名 TableStatus 为 FieldStatus
• ProForm
  • 🛠 提取 URL 同步逻辑到独立 hook useUrlSync
  • 🛠 抽取公共格式化方法消除重复实现
  • 🛠 LightFilter 使用显式 field helpers #9604
  • 🛠 拆分 ProField 轻量编辑为独立组件 #9598
• ProField
  • 🛠 移除 Select 中的 SelectHighlight #9633
  • 🛠 移除 Digit 中的 proxyChange #9610
• Provider
  • 🛠 重构国际化与 Provider 逻辑，优化 dayjs 语言包加载

#🐛 打包修复

• 🐞 移除 package.json 中的 "type": "module" 声明，修复 Node 原生 ESM loader（如 Vitest）下 lib/ CJS 构建产物无法加载的问题 #9656

#📦 依赖升级

• 🔒 替换 mockjs 为 @faker-js/faker（修复 CVE-2023-26158）
• ⬆️ 升级 @ant-design/icons、@babel/runtime、@rc-component/form、@rc-component/table、@rc-component/util、dayjs

#📖 文档

• 📖 统一 demo 文件名为 kebab-case 命名
• 📖 修正多处站点文档中 demo 路径引用

---

#[3.1.3-0] - 2026-04-06

#🗑 破坏性变更

• ProDescriptions
  • 🗑 移除 ProDescriptionsItem 导出；请使用 columns 配置列
  • 🛠 列类型更名为 ProDescriptionsColumn（ProDescriptionsItemProps 保留为别名）
  • 🛠 request 返回类型收紧为 ProDescriptionsRequestResult<T>；params 为 Record<string, unknown>；onDataSourceChange 可收到 undefined
  • 🛠 ProDescriptionsProps 不再接受 items（由组件内部生成）

#🐛 问题修复

• 站点文档
  • 🐞 修正多处 <code src> 与 demos/ 实际文件名不一致（如 single-test → _single-test、debug-demo → _debug-demo、base_test → _base-test 等），并修复 group.md 中 Group// 双斜杠路径

#🛠 重构 / 文档

• ProForm
  • ✅ 新增 Schema 与命令式路径对齐单测（schemaImperativeAlignment）
  • 📖 内部文档：docs/internal/form-architecture.md、docs/rfc/2026-04-pro-form-architecture-refactor.md（与当前 master 源码路径对齐）

---

#[3.1.2-0] - 2026-01-27

#🐛 问题修复

• useEditableArray
  • 🐞 修复 onChange 回调中类型错误，使用类型守卫确保过滤后的数组类型正确

---

#[3.1.1-1] - 2026-01-27

#📚 文档

• 📚 新增 Guidelines 设计指南文档，包含组件使用指南、设计令牌和最佳实践
  • 📚 新增组件使用指南：ProTable、ProForm、ProLayout、ProCard、ModalForm、DrawerForm、StepsForm、EditableProTable
  • 📚 新增设计令牌文档：颜色、布局、字体排版
  • 📚 新增组件概览和图标使用指南

---

#[3.1.1-0] - 2026-01-27

#🐛 问题修复

• ProTable
  • 🐞 修复 resetAll 中使用 getFieldsFormatValue 以支持值转换 [#9403]
  • 🐞 修复表格组件无限循环问题 [#9406]

#🛠 重构

• Core
  • 🛠 使用 useControlledState 替换 useMergedState 以改进状态管理
• ProTable
  • 🛠 增强列配置和上下文管理
• Dependencies
  • 🛠 使用 clsx 替换 classnames 以提升性能 [#9405]
  • 🛠 移除未使用的依赖项 [#9402]

---

#[3.1.0-0] - 2025-12-25

#🚀 新特性

• 🔥 升级到 Ant Design v6: 全面支持 Ant Design v6，更新所有组件以兼容新版本 API。

#⚠️ 破坏性变更

• ProCard / CheckCard / StatisticCard
  • ⚠️ 将 bodyStyle 属性替换为 styles，统一样式配置方式。
• Divider
  • ⚠️ 将 orientation 属性替换为 type，与 Ant Design v6 保持一致。
• Drawer / DrawerForm
  • ⚠️ 将 size 属性替换为 width，明确抽屉尺寸配置。
• StepsForm / Group
  • ⚠️ 将 direction 属性替换为 orientation，统一方向属性命名。
  • ⚠️ 将 width 属性替换为 size，统一尺寸属性命名。
• Tabs
  • ⚠️ 将 tabPosition 属性替换为 tabPlacement，与 Ant Design v6 保持一致。
• ProForm
  • ⚠️ 将 Button.Group 替换为 Space.Compact，优化表单布局。
• Alert
  • ⚠️ 使用 title 属性替代原有标题配置方式。
• ProFieldParsingText
  • ⚠️ 将 split 属性替换为 separator，提高语义清晰度。

#🐛 问题修复

• ProTable
  • 🐞 修复嵌套结构筛选与排序重置问题，确保嵌套列的正确处理。
• SearchSelect
  • 🐞 修复搜索值为 undefined 时的处理逻辑，统一使用空字符串。
  • 🐞 优化标签获取逻辑，提升数据兼容性。
• Select
  • 🐞 移除未使用的 children 属性，清理冗余代码。

#💄 样式 / UI 改进

• ColumnSetting / AppsLogoComponents
  • 💄 将 overlayClassName 替换为 classNames，统一样式类名配置。
• ProCard / Layout
  • 💄 优化卡片和布局的样式类使用，提升布局一致性。

#📦 依赖更新

• 📦 升级到 Ant Design v6 最新版本。
• 📦 更新浏览器支持列表，移除 IE 11 支持。

#📚 文档

• 📚 更新 Changelog 文档，记录 3.x 版本更新历史。

---

#[3.0.0-beta.3] - 2025-07-24

#🚀 新特性

• 🔥 ProComponents 3.0 重大升级: 完全重构的组件库架构，专注于 Antd@5 支持，大幅减少包大小。
• ProTable
  • 🚀 性能大幅提升，与 Antd 看齐。
• ProForm
  • 🚀 优化 Tree Shaking，解决 ProForm 默认绑定所有组件的问题。

#🐛 问题修复

• ProLayout
  • 🐞 修复 useDocumentTitle 中 pageTitleRender 返回非字符串值时的 Helmet 错误。

#💄 样式 / UI 改进

• ProLayout
  • 💄 更新菜单背景属性名称，简化代码结构。

#📦 依赖更新

• 📦 升级到 Antd@5 最新版本，移除所有 Antd@4 相关依赖。
• 📦 更新 Prettier 到最新版本，修复过时的配置选项。

---

#[3.0.0-beta.2] - 2025-07-24

#🛠 破坏性变更

• ProLayout
  • 🛠 移除已废弃的 rightContentRender 和 TabPane API。
• ProTable
  • 🛠 移除已废弃的 columnsStateMap 属性，请使用 columnsState 代替。
• ProCard
  • 🛠 移除已废弃的 StatisticsCardProps。

#📚 文档

• 📚 添加 2.0 到 3.0 的迁移指南文档。
• 📚 润色 index.md，让文档更加人性化和友好。

---

#[3.0.0-beta.1] - 2025-07-24

#🚀 新特性

• ✨ 初始版本: ProComponents 3.0 首个 Beta 版本。
• Core
  • ✨ 更新多个组件以支持 ref 转发，优化布局和渲染逻辑。

#🛠 破坏性变更

• Core
  • 🛠 移除 Antd@4 兼容性支持。
• ProTable
  • 🛠 统一 tooltip 属性，移除不必要的 tip 属性。

---

#迁移指南

#从 2.x 升级到 3.0

#主要变更

1. 移除 Antd@4 兼容性: 确保项目使用 Antd@5。
2. 包大小优化: 移除兼容性代码，减少包大小。
3. Tree Shaking: 优化按需加载，减少不必要的代码。

#升级步骤

1. 升级 Antd 到 5.x 版本。
2. 检查并移除 Antd@4 相关的兼容性代码。
3. 更新组件导入方式，利用 Tree Shaking。
4. 测试所有功能，确保兼容性。

#破坏性变更

• 不再支持 Antd@4。
• 部分 API 可能发生变化。
• 某些兼容性配置被移除。

---

#版本支持

---

#许可证

MIT License