deps: @antv/x6 major upgrade v2 -> v3

[ericfitz]

🔄 Re-verified 2026-06-15 — NOT blocked. @antv/x6@3.1.7 has no peer dependencies (framework-agnostic, no Angular gate). Independent of the Angular 22 group (#733/#541/#734) and can be scheduled on its own.

---

Summary

@antv/x6 has a major version update available: 2.19.2 -> 3.1.6.

Currently pinned to exact version 2.19.2 in package.json with comment: "Pinned to v2.x - v3.x has breaking changes that require significant refactoring."

Impact

• No security implications — this is a feature/breaking change upgrade
• v3.x has breaking API changes affecting the DFD (Data Flow Diagram) module
• All @antv/x6-plugin-* packages may also need coordinated updates

Action Required

• Plan migration on a feature branch when DFD refactoring is scheduled
• Review v3.x migration guide and breaking changes
• Update @antv/x6 and all related plugins together
• Test DFD diagram creation, editing, and rendering thoroughly

[ericfitz]

Update information (Chinese):
https://x6.antv.antgroup.com/tutorial/update

Translated to English:
https://x6-antv-antgroup-com.translate.goog/tutorial/update?_x_tr_sl=zh-CN&_x_tr_tl=en&_x_tr_hl=en&_x_tr_pto=wapp

[ericfitz]

Blocked by bug in declaring ESM vs CJS: antvis/X6#5048

[ericfitz]

Status check (2026-05-02)

Re-investigated during dependency bump.

Upstream blocker still open

antvis/X6#5048 (ESM/CJS module type conflict in @antv/x6@3.1.7) is still open, last updated 2026-03-23. No fix has been published.

No new releases

Latest @antv/x6 is still 3.1.7 (2026-03-18) — same version that was current when this issue was last reviewed. No 3.1.8 or 3.2.x has been released to address the bundling issue.

Conclusion

Still blocked. Continue to defer the upgrade. No action needed until either:

1. @antv/x6 ships a release that fixes the "type": "module" / CJS-output mismatch (per upstream issue #5048 recommendations), or
2. We schedule the DFD refactoring effort and accept the workarounds (e.g., custom Vite resolver for the CJS files).

[ericfitz]

Status check (2026-05-12)

Latest x6 is 3.1.7 (issue body says 3.1.6).

Upstream blocker still active

antvis/X6#5048 (ESM/CJS module type conflict in @antv/x6@3.1.7) — still open, last updated 2026-03-23, labeled waiting for maintainer. Fatal for us since tmi-ux is "type": "module". No path forward until antv ships a fix.

Migration scope is smaller than the issue body implies

Reviewed the v3.0.1 release notes:

• Plugin consolidation — @antv/x6-plugin-{clipboard,export,history,selection,snapline,transform} all merged into @antv/x6. graph.use(new Plugin()) API unchanged; only import paths change. rg @antv/x6-plugin src/ shows ~5 import sites — a mechanical find/replace.
• transition → animate API — rg '\.transition\(' src/app/pages/dfd/ returns zero matches. The one hit is a CSS transition: string, unrelated.
• panning: true is now default — we already configure panning explicitly in infra-x6-graph.adapter.ts:369, so behavior is preserved.

Net: the actual code delta is roughly an imports refactor across ~10 files, not the "significant refactoring" originally feared. The upstream ESM/CJS bug is the only real gate. No action until antvis/X6#5048 resolves.

[ericfitz]

Dependency re-check — 2026-05-15

Blocker: antvis/X6#5048 — ESM/CJS module type conflict in @antv/x6@3.x

npm check (@antv/x6):

• Latest published version: 3.1.7 (released 2026-03-18)
• No 3.1.8 or 3.2.x released

Blocker state: Issue #5048 still OPEN, labeled waiting for maintainer. No new @antv/x6 release since 3.1.7 (2026-03-18).

Conclusion: Still blocked, no change. No action until antvis/X6#5048 resolves and a fixed @antv/x6 ships.

---

Generated by Claude Code