Cleaning up @deprecated props - is there a plan?

[sonsu-lee]

Hi! 👋

While contributing recently, I noticed there are quite a few @deprecated props scattered across @react-aria hooks like useMenuItem, useOption, useGridCell, etc.

A few questions:

1. Is removal planned for a specific major version?
2. Is there a tracking issue for this already?
3. If contributions are welcome: would an umbrella issue + individual PRs per package work, or is there a preferred approach?

Happy to help if this aligns with the team's roadmap.

[snowystinger]

Thanks for the discussion

1. No planned major at this time, but whenever we do, yes, we'd probably remove them
2. No tracking issue at this time
3. Contributions are welcome, though I'm not entirely sure what this has to do with the deprecated props. Are you asking if you can remove them? If so, then see 1 & 2. Are they causing you issues?

[sonsu-lee]

Thank you. To clarify, the deprecated props aren't causing immediate issues, but I'd like to help with refactoring the internal code to reduce reliance on them.
While the props themselves should stay until a major release, I'm interested in cleaning up the internal implementation where these deprecated parts are still used.
Would you prefer I start with a tracking issue, or jump into small PRs for specific cases?

[snowystinger]

I don't think there's anything that needs to be done in terms of reducing reliance, when we remove them we'd just delete anything using them.
Was there a specific part of our code that caught your attention? Maybe sharing an example of what you wanted to do would be helpful. Along with what problem it solves.

[sonsu-lee]

Thanks for the clarification. To be clear, there are no functional issues; I just happened to notice the deprecated markers (like onAction in useMenuItem.ts) in my IDE while working on other tasks , which caught my attention.

After re-evaluating, I agree that cleaning these up could have a broad impact since they are scattered across many hooks and are maintained for backward compatibility. As you mentioned, it makes much more sense to handle these when the team officially removes the deprecated props in a future major release.

Thanks for taking the time to explain—this was very helpful! I have no further questions, so feel free to mark this as answered or close the discussion at your convenience.