ant-design-pro/docs/roadmap/v6.1.0-release-plan.md

Ant Design Pro v6.1.0 Release Plan

Date: 2026-06-01 Status: Draft Approach: Layered progression — cleanup first, then engineering, then upgrades

Overview

v6.1.0 is a quality + upgrade release focusing on test infrastructure, bug fixes, legacy cleanup, and dependency alignment. Breaking changes are allowed where justified with migration notes.

Layer 1: Cleanup & Bug Fixes

1.2 Clean up ant-legacy-form-item CSS class references

antd v6 removed these legacy class names. Three files still reference them:

• src/components/StandardFormRow/index.style.ts (8 references)
• src/pages/form/advanced-form/style.style.ts (1 reference)
• src/pages/account/settings/components/index.style.ts (1 reference)

Action: Replace .ant-legacy-form-item selectors with current antd v6 equivalents (.ant-form-item). Verify visual parity after changes.

1.3 Clean up typings.d.ts legacy module declarations

src/typings.d.ts declares modules for slash2 and omit.js — v5-era dependencies no longer in use.

Action: Grep for actual imports. If none found, remove the declarations.

1.4 Bug fixes

#	Issue	Description	Approach
1	#11772	valtio undefined error	Trace dependency chain; fix initialization or remove unused valtio import
2	#11764	OpenAPI link text visible in collapsed sidebar	CSS fix to hide text or truncate when sidebar is collapsed
3	#11747	Windows 11 "Can't resolve 'tailwindcss'"	Investigate path resolution; likely needs module resolution config fix
4	#11575	OpenAPI generated file first-letter case inconsistency	Review openapi config camel2Line/naming options; add normalization
5	#11286	Language switcher cannot be disabled in non-mix layouts	Fix disableLocal prop propagation in layout config
6	#11597	Mask layer bug with pagination and sidebar	z-index / overlay stacking fix

1.5 Clean up request interceptor demo placeholder

src/requestErrorConfig.ts appends ?token=123 to every request URL as a demo artifact.

Action: Replace with commented example or conditional (dev-only) guard. Do not remove the pattern entirely — it serves as a reference for token attachment.

Layer 2: Testing & Engineering

2.1 Migrate Jest → Vitest (#11742)

Rationale: Vitest offers native ESM, instant HMR, and Vite-native config. Jest startup is slow and ESM support is fragile.

Steps:

1. Add vitest and @vitest/coverage-v8 dependencies
2. Create vitest.config.ts using Umi plugin compatibility
3. Migrate tests/ setup files (setupTests.jsx, __mocks__/)
4. Migrate src/pages/user/login/login.test.tsx → Vitest syntax
5. Update package.json scripts: test, test:coverage, test:ui
6. Remove Jest dependencies: jest, @testing-library/jest-dom, related config
7. Verify CI pipeline

Breaking change: Test authoring API changes (minimal — Vitest is Jest-compatible).

2.2 Expand test coverage

Current: 1 test file, 2 test cases, ~1% file coverage.

Priority test targets:

Target	File	What to test
ProTable page	src/pages/list/table-list/index.tsx	Data loading, search, pagination, CRUD operations
Dashboard	src/pages/dashboard/analysis/index.tsx	Chart rendering, layout, chart data flow
Basic form	src/pages/form/basic-form/index.tsx	Form validation, submission, field interactions
Auth flow	src/access.ts, src/app.tsx	canAdmin logic, getInitialState 401 redirect
Request interceptor	src/requestErrorConfig.ts	Error handling paths, 401 redirect, token attachment

Coverage target: Core pages 50%+, overall 20%+.

2.3 CI pipeline optimization

• Enable GitHub Actions cache for node_modules and build output
• Parallelize PR checks: lint | typecheck | test (instead of sequential)
• Evaluate Codecov upload — remove if coverage data remains below actionable threshold

2.4 Code quality enforcement

• Add npx antd lint ./src to CI pipeline (currently only enforced manually)
• Tighten Biome rules: audit warnings and elevate to errors where appropriate

Layer 3: Dependency Upgrades

3.1 Core dependencies

Package	From	To	Risk
antd	^6.4.3	6.x latest	Low
@ant-design/pro-components	^3.1.12-0	3.x stable	Low
@ant-design/x	^2.7.0	2.x latest	Low
@ant-design/x-markdown	^2.7.0	2.x latest	Low
@ant-design/x-sdk	^2.7.0	2.x latest	Low
@umijs/max	^4.6.51	4.x latest	Medium — check breaking notes
React / React DOM	^19.2.5	Stay (React 20 not released)	—

3.2 Toolchain dependencies

Package	From	To
TypeScript	^6.0.3	6.x latest
Biome	^2.4.13	2.x latest
Tailwind CSS	^4.2.4	4.x latest
Express (mock)	^5.2.1	5.x latest
@tanstack/react-query	^5.100.6	5.x latest
d3	^7.9.0	7.x latest or evaluate alternatives

3.3 Evaluation items (investigate before upgrading)

• Node.js 22: Currently requires >= 20. Assess whether raising to >= 22 is warranted.
• utoopack: Check for significant updates or breaking changes in the build toolchain.
• @tanstack/react-query v6: If released, evaluate migration path.

3.4 Post-upgrade validation checklist

• npm run lint passes (Biome + tsc)
• npx antd lint ./src passes
• npm run build succeeds
• All tests pass
• npm start dev server works
• Visual spot-check of key pages (login, dashboard, table-list, forms)
• Update CLAUDE.md if version requirements change

Risk Assessment

Risk	Likelihood	Impact	Mitigation
Umi Max upgrade breaks build	Medium	High	Pin version; test in CI before merge
Vitest + Umi plugin compatibility	Medium	Medium	Research existing Umi + Vitest integrations; may need adapter
Windows compatibility regression	Low	Medium	Test on Windows or add Windows CI
antd v6 minor API changes	Low	Low	Review antd changelog; run npx antd lint
Test coverage effort exceeds estimate	Medium	Low	Prioritize core pages; defer edge cases

Execution Order

Layer 1 (cleanup + bugs) → Layer 2 (testing) → Layer 3 (upgrades)

Each layer produces a shippable state. If time constrains, lower layers deliver more value per effort.

Within each layer, items can be parallelized across contributors.