🚧 [v3] Planned breaking changes for the next major release 🚧

[Lukas742]

This issue tracks possible breaking changes under consideration for v3 of UI5 Web Components for React. There is no release date for v3 yet. Items listed here are not final — they may be added, removed, or changed based on community feedback and evolving requirements.

We're sharing this early to give the community visibility and an opportunity to provide input.

Note: Breaking changes in the underlying UI5 Web Components are tracked separately in SAP/ui5-webcomponents#9943. Those changes will also affect this library.

---

@ui5/webcomponents-react-charts — Package Removal

This package will be removed in v3. It will not receive updates beyond v2 maintenance.

The package is not backed by SAP global design or accessibility specifications and does not meet the quality and governance standards of the UI5 Web Components ecosystem. For details and migration guidance, see the Deprecation Notice in the charts README.

New implementations should not depend on this package. Existing consumers should plan for migration before the v3 release.

---

Planned Removals

Deprecated API Cleanup

• Remove nativeDetail from event payloads (SelectDialog, VariantManagement, FilterBar)
• Remove openerRef from event payloads — replaced by openerId (AnalyticalTable column header modal)
• Remove ExpandableText compatibility wrapper (legacy children, showOverflowInPopover, renderWhitespace props)

Package Removals

• Remove @ui5/webcomponents-react-compat package (legacy v1 Table, Toolbar, Loader, etc.)

Component Removals

• Remove custom ResponsiveGridLayout component (Form web component now handles wrapping natively)

---

Planned Renames & Restructuring

• Rename VariantItem children prop to text (aligning with ListItemStandard)
• Rename ObjectPage accessibilityAttributes.objectPageAnchorBar to better reflect the described area
• AnalyticalTable: Add cursor pointer style when onRowClick is set

---

React Support

• Drop React 18 support — require React 19+ as minimum peer dependency

---

Infrastructure

• Remove remaining v1 → v2 compatibility shims
• Clean up internal // todo: remove in v3 items across the codebase

---

Disclaimer: This is a living document. Items may be added, reprioritized, or dropped entirely. No timeline is attached to this release.