#Changelog

#Unreleased

#🗑 Breaking Changes

• ProForm
  • 🗑 Remove the public warpField helper; use createProFormField or useProFormFieldShell for custom fields #9751

#🆕 Features

• ProForm
  • 🆕 Export layout and form shell types (ProFormGridConfig, CommonFormProps, BaseFormProps, ProFormRef, SyncToUrl, useGridHelpers, getSpanConfig, FieldContextProps, FormFieldType, …) and createProFormField / useProFormFieldShell #9751
• QueryFilter / ProList / ProCard
  • 🆕 Extract shared responsive breakpoint helpers; QueryFilter span accepts Partial configs (missing breakpoints cascade forward like antd Col) #9750

#🐛 Bug Fixes

• ProForm
  • 🐞 Stop forwarding lowercase readonly onto pure-display field children (children without name/value) to avoid Invalid DOM property warnings; ProField-backed readonly behavior is unchanged #9107 18d5a7f2c
• ProTable
  • 🐞 Keep toolbar LightFilter as a flat inline bar instead of wrapping it in a card (regression from #9742); cardBordered.search only applies to QueryFilter/Form and is ignored for light filters c2471f92a
• ProList
  • 💄 Restore token.marginXS gap between avatar and title in card mode to match list mode 25e6b868c
• Docs site
  • 🐞 Fix Vercel / pnpm site failures after the Rspress migration when react-router was pinned to v6 and could not resolve react-router/dom #9753
  • 🐞 Fix garbled Chinese sidebar labels and repair the stretched homepage hero / information hierarchy #9754

#⚡️ Performance

• ProForm
  • ⚡️ Lazy-load ProFormDependency and LightFilter popover paths; LightFilter injects light renderer via context; scripts/checkFormTreeShaking.mjs guards ProFormText initial chunk #9751
• ProField / ProForm
  • ⚡️ Tighten field valueType maps and form field imports to improve tree shaking 0267faf61

#📖 Documentation

• 📖 Migrate the docs site from dumi to Rspress v2 with bilingual routes, demo preview, SSG, sitemap, GA, link checks, and a homepage discovery section #9747
• 📖 Rebuild homepage information hierarchy (brand hero → search/core components → features), replace the illustration, and fix duplicate image rendering #9754

#🛠 Other

• 🛠 Bump pnpm to 12.10.1 and move related config into pnpm-workspace.yaml #9748 @zzjiaxiang

#✅ Tests

• ProForm
  • ✅ Add coverage for pickProFormItemProps / omitProFormItemProps passthrough and field-shell paths #9751
• ProTable
  • ✅ Lock the regression that keeps LightFilter flat inside the toolbar c2471f92a

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

#🐛 Bug Fixes

• ProCard
  • 🐞 Fix oversized gap between title and body content when the header has no bottom border (default, headerBordered off): the antd Card head is sized by minHeight, so removing only the border left its vertical whitespace stacked with the body padding. Now aligned with the legacy compact layout (minHeight: auto, zero bottom spacing, paddingXS for small size), with bottom spacing restored when collapsed so the title never sticks to the card edge. headerBordered / inner keep the antd skin untouched 6f62df36e
  • 🐞 Fix the loading skeleton sticking to the title with tabs + loading: the tabs body padding is zeroed internally, so the loading skeleton now carries the content-area padding (paddingLG) itself; layout shells (split / nested cards) keep the body padding while loading so the antd skeleton is not flush against the edges

#⚡️ Performance

• ⚡️ Break Form type cycles to enable tree shaking and split field value type maps into async chunks for a smaller main bundle #9745

#🛠 Other

• 🛠 Remove the internal PureProField in favor of ProField everywhere, plus a provider scenario refactor (branch archive merged into master) #9744

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

#🐛 Bug Fixes

• ProCard
  • 🐞 Pass through omitted variant to antd Card so it follows ConfigProvider card.variant / global variant (no hard-coded outlined) 2a5a156b2
• 🐞 Fix antd accessibility (a11y) and mask API console warnings 2ba4598d1

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

#🐛 Bug Fixes

• ProCard
  • 🐞 Align the basic card skin with antd Card (ant-pro-card + ant-card) and remove ant-pro-card-antd-card #9740
  • 🐞 Expand the antd path so collapsible / tabs / nested layouts no longer force legacy; collapse hides via CSS while keeping layout-shell children mounted, and only the current card header toggles collapse #9742
• ProTable
  • 🐞 Use a real ProCard for the search form shell, aligned with cardBordered #9742
• InlineErrorFormItem
  • 🐞 Auto-open the validation popover when errors appear, and use hover-only trigger so input focus is not interrupted

#⚡️ Performance

• ⚡️ Remove swr and route-utils runtime costs; menu routing now uses a built-in lightweight implementation #9739

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

#🐛 Bug Fixes

• BetaSchemaForm
  • 🐞 Fix form callbacks such as onValuesChange and onFinish when standalone layoutType="Embed" is used, while preserving passthrough inside an existing Form #8727
  • ✅ Lock the layout switching regression from Form to LightFilter #8850
• ProFormCaptcha
  • 🐞 Localize the default captcha and countdown text across all bundled locales #8899
• ProTable
  • 🐞 Preserve the explicit Table.EXPAND_COLUMN position, and lock Tabs width/ellipsis and formatted valueEnum ellipsis regressions #8913 #8747 #8694
  • 📚 Document and demonstrate merged cells through onCell rowSpan/colSpan #8701
• ProLayout
  • ✅ Lock layout="mix", splitMenus, and siderMenuType="sub" child-menu rendering #9310
• Density selector
  • 💄 Let translated density menu labels determine the dropdown width #9619
• Parse custom date formats and URL-synchronized second/millisecond timestamps consistently in edit fields #8863 #8810
• Preserve null fields when omitNil=false, forward field-level blur validation, and keep formatted ellipsis tooltips aligned with rendered text #8044 #8380 #8542
• Refresh Select requests for controlled search values without repeating empty searches, preserve hidden QueryFilter fields, and respect responsive vertical layouts #8801 #8780 #8928 #8397 #8836
• Keep BaseForm contentRender items as an array with grid enabled, and allow controlled overlay triggers to open before the form mounts #8253 #9624
• Synchronize changed overlay initialValues, late StepsForm request form refs, and wrapped StepForm children #8834 #9165 #8624 #8108 #9021
• Fix nested child form paths when EditableProTable uses a function rowKey, with regression coverage for controlled tables inside ProFormList #8893 #6508
• Align whole-entity, nested-list, and ProTable column semantics across the convertValue / transform pipeline #8907 #8480 #9120 #9032
• Fix empty arrays, Digit affixes, and numeric valueEnum labels in read/edit display paths #8848 #8844 #8517
• Preserve TreeSelect internal open state with user callbacks and document virtual scrolling and half-checked behavior #9138 #8876 #8869
• Add regression coverage for throttled remote Select results #6766
• ProForm
  • 🐞 Export ProFormGroup directly so SSR/ESM bundlers do not read a partially initialized ProForm.Group during module evaluation #8543
• ProFormList
  • 🐞 Route actionRef.add and actionRef.remove through actionGuard, onAfterAdd, and onAfterRemove #8939
  • ✅ Add regressions for copying preserve={false} fields, conditional remounts, and first-submit transforms #8208 #8896 #8700
• BetaSchemaForm
  • 🆕 Pass the current row index to function props in formList sub-columns #8561
• ProList
  • 🐞 Restore showActions, showExtra, and card action placement, and lock grid gutter and live pagination regressions #7421 #8387 #7862
• ProTable
  • 🆕 Add options.setting.listItemTitleRender for adaptive column-setting titles #9620
• 🐞 Replace antd static message calls with App.useApp() in useEditableMap, useEditableArray, and SettingDrawer to consume dynamic theme context correctly

#📖 Documentation

• 📖 Clarify that v3 only publishes the single @ant-design/pro-components package, with installation and build diagnostics for antd 6, Umi, Next.js, rc-util, path-to-regexp, and antd 4 #9629
• 📖 Add a forceRender example and timing guidance for calling setFieldsValue before ModalForm's first open #9628

#✅ Tests

• ✅ Add LoginForm/ProFormGroup SSR coverage and a ModalForm pre-open value regression test

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

#🆕 Features

• EditableProTable
  • 🔥 editable.editableKeys supports cell-level composite keys `${rowKey}:${dataIndex}` (e.g. ['1:name'] activates only that cell); fully backwards compatible with row keys and can be mixed #9643 b6826ece5
  • 🆕 onCell td props now include data-editing / data-cell-editing editing state for custom cell interactions (proposal C of #9043) b6826ece5
• ProTable
  • ⚡️ Plain ellipsis: true now uses antd Table native CSS ellipsis for much faster rendering on large datasets; columns configured with tooltip/showTitle or copyable keep the Typography rendering path #9664 #8868 01fda391d
  • ⚡️ Refactor the per-cell render hot path: editableKeys now builds a Set/Map index once per change for O(1) lookups (~5x faster edit-state checks); tables without editable no longer wrap onCell, and tree data without children skips index registration 84a36700a
• ProForm
  • 🔥 Add loadingRender prop to customize the render while request is loading (e.g. Skeleton), aligning with antd 5.18+ loading style #9679 803017665
• ProFormSelect
  • 🆕 Add top-level fetchDataOnSearch prop; when false, request only fetches once on init and searching filters locally #9682 803017665

#🐛 Bug Fixes

• ProForm
  • 🐞 Fix explicit valueType being overridden by valueEnum/request inference #9002 399a1da0b
  • 🐞 Fix user-provided noStyle being overwritten in non-light mode a96050e33
  • 🐞 Fix fixed-width ProFormDigit being pushed apart from addonAfter #9211 aa266935f
  • 🐞 Fix ProFormCheckbox readonly not passed through to antd Checkbox disabled #9107 4c8d0f257
  • 🐞 Fix duplicate generated input ids for same-name fields #9144 4c8d0f257
  • 🐞 Fix help prop not passed through on ProForm fields #9066 4c8d0f257
  • 🐞 Fix ProFormMoney symbol position, separators and numberFormatOptions merge for ru-RU #9090 4c8d0f257
  • 🐞 Fix ProFormList transform not firing on nested name paths, and duplicated row index when list render receives [index, key] #9129 #9238 4c8d0f257
  • 🐞 Fix ProFormList onAfterAdd callback arguments not matching the docs #9102 4c8d0f257
  • 🐞 Fix rules-related props being incorrectly spread onto Fragment when editing rows #9153 4c8d0f257
  • 🐞 Fix onFinish errors being silently swallowed; now exposed via console.error #9019 399a1da0b
• ProField / ProTable
  • 🐞 Fix select read-mode enum output not working with ellipsis + copyable #8978 399a1da0b
• ProTable
  • 🐞 Fix request receiving null sorter/filter defaults on load, pagination and reset #9161 ddbbb1425
  • 🐞 Fix DragSortTable remounting the table after data reloads or row selection updates, which caused fixed-header flicker and reset both scroll axes #8342 #8404
  • 🐞 Fix multi-level grouped columns failing to expand, toggle, or reorder in column settings, and grouped CellEditorTable leaf cells failing to enter edit mode #8988 #8133 #8880
  • 🐞 Fix EditableProTable editing the wrong filtered row, deleting nested rows on cancel, losing nested row ids in callbacks, and using stale creator records or dynamic validation rules in name mode #8930 #8662 #7859 #8861 #8174 #9184
• ProDescriptions
  • 🐞 Fix dependency values not injected into request params #9170 4c8d0f257
• Provider
  • 🇺🇸🇨🇳 Fix empty-string locale messages (e.g. vi-VN pagination range) incorrectly falling back to zh-CN #9016 399a1da0b

#🛠 Other

• 🛠 Override vulnerable transitive dependencies to patched versions (development scope) 1e84af860
• 🛠 Unify esbuild to 0.28+ to clear the development-server alert 301644384

#✅ Tests

• ✅ Add regression tests for loadingRender, fetchDataOnSearch, native ellipsis and cell-level editableKeys
• ✅ Lock verified scenarios for #8973, #9033, #9104, #9118, #9119, #9121, #9133, #9142 and related cases
• ✅ Stabilize flaky editable-table and layout mix snapshot cases 943d09a83

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

#🐛 Bug Fixes

• ProForm
  • 🐞 Fix collapsed LightFilter values not being reset correctly 2dc5c9a67
  • 🐞 Fix LightFilter panel collapsing unexpectedly while typing #9649
  • 🐞 Fix duplicate labels in LightFilter #9695
  • 🐞 Fix ignoreRules not taking effect in LightFilter #9166
  • 🐞 Fix query params syncing incorrectly inside hash routes #8649
  • 🐞 Fix QueryFilter default collapsed item count not taking effect e42cc49d3
  • 🐞 Fix empty values being lost in onValuesChange cbd1dff33
  • 🐞 Fix nested date field metadata loss in SchemaForm #9663
  • 🐞 Fix type errors of custom field bindings in SchemaForm #8615 #8617
  • 🐞 Fix recursive rendering of custom fields #9676
  • 🐞 Fix formItemRender config typing being dropped #9676
  • 🐞 Fix initial values not converted before transform #8452
  • 🐞 Fix values being converted repeatedly #9285
  • 🐞 Support native drawer resizing in DrawerForm #9675
  • 🐞 Fix broken submit flow when the submit button is hidden #8648
  • 🐞 Fix external form instance not refreshing request values #8352
  • 🐞 Fix stale form instance used after remount #9703
  • 🐞 Fix field-level readonly not overriding form mode a8be297a1
  • 🐞 Fix field-level layout config not taking effect 66356980c
  • 🐞 Fix addon fields being overly restricted d1f385a2a
  • 🐞 Fix default render field props being unexpectedly overridden 4abf70ef6
  • 🐞 Export ProForm group props type 8e34e54c5
• ProTable
  • 🐞 Fix the header checkbox of a fixed selection column being covered by adjacent fixed columns 23cd4b86e
  • 🐞 Fix runaway scrolling during drag sort d14d3814a
  • 🐞 Fix inline validation errors being invisible 59c966cc8
  • 🐞 Fix offscreen virtual editable rows not being validated #9553
  • 🐞 Fix values of deleted editable rows lingering #9051
  • 🐞 Fix fixed columns lost after ColumnSetting drag #9687
  • 🐞 Fix search form not replaced when filterType changes #9613
  • 🐞 Fix cached rows not reset when data is cleared #9203
  • 🐞 Fix incomplete submitted values after form update #9236
  • 🐞 Fix cell editor changes being lost #8472
  • 🐞 Fix cancelled form-backed rows not removed #8664
  • 🐞 Fix editable row validation failing by rowKey #9280
  • 🐞 Fix option column alignment not taking effect #9701
  • 🐞 Fix density trigger ref forwarding #9699
  • ⚡️ Avoid full editable table rerenders 3ba9b4a3f
• Provider
  • 🛠 Inject iconCls token into the style system and migrate all hardcoded .anticon selectors, so ProComponents styles follow a custom ConfigProvider.iconPrefixCls correctly 308fe7a2e
• ProLayout
  • 🐞 Fix sider scrollbar colors not following the theme bd097660f
  • 🐞 Fix ConfigProvider hashed setting not inherited #8473
  • 🐞 Fix empty mobile menu trigger being shown #7312
  • 🐞 Fix collapsed menu popup not applying tokens #8095
  • 🐞 Fix sticky content lost under watermark #9698
  • 🐞 Fix asynchronously loaded menus not expanded #9697
• ProField
  • 🐞 Fix functional percent precision #9549
  • 🐞 Fix long readonly text not wrapping #8581
  • 🐞 Fix textarea passing showCount in read mode #8642
  • 🐞 Fix object-form showSearch config not taking effect #9680
  • 🐞 Fix cleared light select values not reset #9227
• ProDescriptions
  • 🐞 Fix editable fields not filling width 91970093b
  • 🐞 Fix values not formatted before ellipsis 0de4ddefb
• ProSelect
  • 🐞 Fix request options matched by value incorrectly #9222
  • 🐞 Fix retained search value not hidden on blur #9292
• Other
  • 🛠 Fix src import paths not rewritten in declaration output #9017

#✅ Tests

• ✅ Add regression test for fixed selection column z-index 23cd4b86e
• ✅ Fix flaky editable table case caused by fake timer conflict, and update sider scrollbar snapshot 38addfdb2

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

#🐛 Bug Fixes

• ProCard
  • 🐞 Fix semantic classNames/styles not applied to the actions area #9693
• ProDescriptions
  • 🐞 Fix user styles overridden instead of merged with internal defaults #9692
• Locale
  • 🇺🇸🇨🇳 Fix zh-TW typos of line item glyphs #9691
• Other
  • 💄 Apply fontWeightStrong token to ProList meta title and editable text

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

#🐛 Bug Fixes

• ProTable
  • 🐞 Fix submitted search fields not being written to the URL, now aligned with syncToUrl behavior #9665 #9674 @pingfan

#✅ Tests

• ✅ Add syncToUrl search-field regression test to verify URL parameters update correctly after form submission

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

#🐛 Bug Fixes

• ProForm
  • 🐞 Fix ProFormField components not returning instance via form.getFieldInstance. ProFormText, ProFormText.Password, ProFormTextArea, ProFormDigit and other components now correctly return instances #9673
• ProField
  • 🐞 Fix ProField forwardRef type declaration, return ForwardRefExoticComponent for React 19 + TypeScript 6 compatibility #9671 #9672 @Phecda

#✅ Tests

• ✅ Add getFieldInstance regression tests covering text, password, textarea, digit, array name paths, dependencies, and fieldRef coexistence

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

#🐛 Bug Fixes

• ProTable
  • 🐞 Fix ColumnSetting fixed column sort order and refine the sync between fixed columns and column order #9556
  • 🐞 Fix ListToolBar padding not adapting dynamically in cardBordered mode
• Provider
  • 🐞 Fix CommonJS compatibility by importing from antd/lib instead of antd/es in CJS output

#🛠 Misc

• 🛠 Bump dependencies to latest minor versions #9670

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

#🐛 Bug Fixes

• ProTable
  • 🐞 Fix TS2322 type error when passing ReactNode to options.search
  • 🐞 Fix syncToUrl not writing search fields to URL #9665
  • 🐞 Fix syncToUrl not triggering when request lacks macrotask #9096
  • 🐞 Fix ColumnSetting reset not restoring drag order
  • 🐞 Fix pagination change not triggering syncToUrl #6967
  • 🐞 Fix EditableTable cancel edit error when form is undefined #9640
• ProField
  • 🐞 Fix ColorPicker default preset label hardcoded in English, now uses i18n #9668
• Utils
  • 🐞 Fix isDeepEqualReact stack overflow on circular refs #9666 #9667 @lblblong
• Provider
  • 🐞 Add Urdu (ur-PK) locale support #9218

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

#🐛 Bug Fixes

• ProCard
  • 🐞 Align ProCard styles with antd v6 native Card: borders use colorBorderSecondary, shadows use boxShadowTertiary, border-radius unified to borderRadiusLG, header / body get matching corner radii
  • 🐞 variant="borderless" now defaults to boxShadowTertiary light shadow to match antd v6 Card (note: this is an API behavior change; code relying on "borderless = no shadow" must override explicitly)
  • 🐞 Fix ghost mode UI: the ghost card's own padding is now zeroed, -border and default shadow are overridden, and the selector is broadened from > ${componentCls} to > * so custom child nodes inherit the reset too

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

#🐛 Bug Fixes

• ProLayout
  • 🐞 Fix TS2322 build error in PageHeader fontSizeHeading4 type cast
• ProTable
  • 🐞 Fix card wrapper not rendering when search is disabled but toolbar options exist
  • 🐞 Fix EditableTable onChange firing repeatedly and useImperativeHandle deps issue
  • 🐞 Fix ColumnSetting nested column parent-child sync and stale cache on reset
  • 🐞 Fix column type definition collapse caused by & operator precedence
  • 🐞 Fix abort signal binding error causing requests to be incorrectly cancelled on rapid reload
  • 🐞 Fix visibilitychange event closure trap and pageInfo snapshot overwrite in useFetchData
• ProForm
  • 🐞 Fix FormItem label and tooltip being incorrectly overridden in light mode
  • 🐞 Fix DrawerForm redundant onOpenChange callback
  • 🐞 Fix date picker alignment with valueType picker and default format
  • 🐞 Fix FormList date type not properly converting to string on submit #9631
  • 🐞 Fix week format and submission semantics, unify date range readonly display
• ProField
  • 🐞 Fix read-mode date formatting and week/quarter range default format
  • 🐞 Fix ColorPicker to use antd ColorPickerProps type #9566
  • 🐞 Fix proFieldParsingText crashing when rendering labelInValue objects in read mode
  • 🛠 Replace Input separator with semantic span in DigitRange for better style consistency
• Provider
  • 🐞 Fix dark=false not properly resetting darkAlgorithm
  • 🐞 Align locale keys and fix i18n strings #9595
• Utils
  • 🐞 Fix serialized dayjs parsing, submission conversion, and range text formatting
  • 🐞 Fix transformKeySubmitValue breaking array shape when transforming objects under array parents
  • 🐞 Fix useEditableArray saveRefs leak and missing default values for new rows in tableName mode
  • 🐞 Fix nanoid window access crash in SSR/Workers #9596
• ProList
  • 🐞 Fix LightWrapper child props merge order causing light filter input to not take effect

#⚡️ Performance

• ProDescriptions
  • ⚡️ Stabilize fetch action and memoize schema
• ProTable
  • ⚡️ Optimize table rendering with useMemo and useRefFunction
• ProList
  • ⚡️ Extract renderItem and add memo for list rendering optimization

#🛠 Refactoring

• ProCard
  • 🛠 Refactor component, fix ref forwarding and loading state
• ProList
  • 🛠 Replace useCallback with useRefFunction and fix SSR compatibility
• ProTable
  • 🛠 Rename Container to TableProvider and optimize persistence logic
  • 🛠 Clean unused exports and rename TableStatus to FieldStatus
• ProForm
  • 🛠 Extract URL sync logic into standalone hook useUrlSync
  • 🛠 Extract common formatting methods to eliminate duplication
  • 🛠 LightFilter with explicit field helpers #9604
  • 🛠 Split ProField light edit into dedicated components #9598
• ProField
  • 🛠 Remove SelectHighlight from Select #9633
  • 🛠 Remove proxyChange from Digit #9610
• Provider
  • 🛠 Refactor i18n and Provider logic, optimize dayjs locale loading

#🐛 Packaging Fix

• 🐞 Remove "type": "module" from package.json to fix Node-native ESM loaders (e.g. Vitest) failing to load the CJS lib/ build #9656

#📦 Dependencies

• 🔒 Replace mockjs with @faker-js/faker (fixes CVE-2023-26158)
• ⬆️ Upgrade @ant-design/icons, @babel/runtime, @rc-component/form, @rc-component/table, @rc-component/util, dayjs

#📖 Documentation

• 📖 Unify demo filenames to kebab-case naming convention
• 📖 Fix multiple demo path references in site documentation

---

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

#🗑 Breaking Changes

• ProDescriptions
  • 🗑 Remove ProDescriptionsItem export; use columns instead
  • 🛠 Rename column type to ProDescriptionsColumn (ProDescriptionsItemProps remains an alias)
  • 🛠 Tighten request return type to ProDescriptionsRequestResult<T>; params is Record<string, unknown>; onDataSourceChange may receive undefined
  • 🛠 ProDescriptionsProps no longer accepts items (generated internally)

#🐛 Bug Fixes

• Site docs
  • 🐞 Fix several <code src> paths that did not match files under demos/ (e.g. single-test → _single-test, debug-demo → _debug-demo, base_test → _base-test) and correct a Group// double-slash path in group.md

#🛠 Refactor / Documentation

• ProForm
  • ✅ Added schema vs imperative alignment tests (schemaImperativeAlignment)
  • 📖 Internal docs: docs/internal/form-architecture.md, docs/rfc/2026-04-pro-form-architecture-refactor.md (aligned with current master source layout)

---

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

#🐛 Bug Fixes

• useEditableArray
  • 🐞 Fix type error in onChange callback by using type guard to ensure correct array type after filtering

---

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

#📚 Documentation

• 📚 Add Guidelines documentation, including component usage guides, design tokens, and best practices
  • 📚 Add component usage guides: ProTable, ProForm, ProLayout, ProCard, ModalForm, DrawerForm, StepsForm, EditableProTable
  • 📚 Add design token documentation: colors, layout, typography
  • 📚 Add component overview and icon usage guides

---

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

#🐛 Bug Fixes

• ProTable
  • 🐞 Fix using getFieldsFormatValue in resetAll to support value transformation [#9403]
  • 🐞 Fix table component infinite loop issue [#9406]

#🛠 Refactoring

• Core
  • 🛠 Replace useMergedState with useControlledState for improved state management
• ProTable
  • 🛠 Enhance column configuration and context management
• Dependencies
  • 🛠 Replace classnames with clsx for improved performance [#9405]
  • 🛠 Remove unused dependencies [#9402]

---

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

#🚀 New Features

• 🔥 Upgrade to Ant Design v6: Full support for Ant Design v6, updating all components to be compatible with the new version API.

#⚠️ Breaking Changes

• ProCard / CheckCard / StatisticCard
  • ⚠️ Replace bodyStyle prop with styles for unified styling configuration.
• Divider
  • ⚠️ Replace orientation prop with type to align with Ant Design v6.
• Drawer / DrawerForm
  • ⚠️ Replace size prop with width for clearer drawer dimension configuration.
• StepsForm / Group
  • ⚠️ Replace direction prop with orientation for unified direction property naming.
  • ⚠️ Replace width prop with size for unified size property naming.
• Tabs
  • ⚠️ Replace tabPosition prop with tabPlacement to align with Ant Design v6.
• ProForm
  • ⚠️ Replace Button.Group with Space.Compact for improved form layout.
• Alert
  • ⚠️ Use title prop instead of the original title configuration method.
• ProFieldParsingText
  • ⚠️ Replace split prop with separator for better semantic clarity.

#🐛 Bug Fixes

• ProTable
  • 🐞 Fix nested structure filtering and sorting reset issues, ensuring correct handling of nested columns.
• SearchSelect
  • 🐞 Fix handling logic when search value is undefined, consistently using empty string.
  • 🐞 Optimize label retrieval logic to improve data compatibility.
• Select
  • 🐞 Remove unused children prop to clean up redundant code.

#💄 Style / UI Improvements

• ColumnSetting / AppsLogoComponents
  • 💄 Replace overlayClassName with classNames for unified style class name configuration.
• ProCard / Layout
  • 💄 Optimize style class usage for cards and layouts to improve layout consistency.

#📦 Dependency Updates

• 📦 Upgrade to latest Ant Design v6 version.
• 📦 Update browser support list, remove IE 11 support.

#📚 Documentation

• 📚 Update Changelog documentation to record 3.x version update history.

---

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

#🚀 New Features

• 🔥 ProComponents 3.0 Major Upgrade: Completely restructured architecture, focusing on Antd@5 support and significantly reducing bundle size.
• ProTable
  • 🚀 Performance significantly improved to be on par with Antd.
• ProForm
  • 🚀 Optimize Tree Shaking to solve the issue of default binding all components.

#🐛 Bug Fixes

• ProLayout
  • 🐞 Fix Helmet error when pageTitleRender returns non-string values in useDocumentTitle.

#💄 Style / UI Improvements

• ProLayout
  • 💄 Update menu background property name to simplify code structure.

#📦 Dependency Updates

• 📦 Upgrade to latest Antd@5 version and remove Antd@4 related dependencies.
• 📦 Update Prettier to latest version and fix deprecated configuration.

---

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

#🛠 Breaking Changes

• ProLayout
  • 🛠 Remove deprecated rightContentRender and TabPane APIs.
• ProTable
  • 🛠 Remove deprecated columnsStateMap property, use columnsState instead.
• ProCard
  • 🛠 Remove deprecated StatisticsCardProps.

#📚 Documentation

• 📚 Add migration guide from 2.0 to 3.0.
• 📚 Polish index.md to be more user-friendly.

---

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

#🚀 New Features

• ✨ Initial Release: First Beta version of ProComponents 3.0.
• Core
  • ✨ Support ref forwarding for multiple components to optimize layout and rendering.

#🛠 Breaking Changes

• Core
  • 🛠 Remove Antd@4 compatibility support.
• ProTable
  • 🛠 Unify tooltip props and remove deprecated tip prop.

---

#Migration Guide

#Upgrading from 2.x to 3.0

#Major Changes

1. Remove Antd@4 Compatibility: Ensure project uses Antd@5.
2. Bundle Size Optimization: Remove compatibility code, reduce bundle size.
3. Tree Shaking: Optimize on-demand loading, reduce unnecessary code.

#Upgrade Steps

1. Upgrade Antd to 5.x version.
2. Check and remove Antd@4 related compatibility code.
3. Update component import methods to leverage Tree Shaking.
4. Test all functionality to ensure compatibility.

#Breaking Changes

• No longer supports Antd@4.
• Some APIs may have changed.
• Certain compatibility configurations have been removed.

---

#Version Support

---

#License

MIT License