Potential useContextProps type compatibility issue with React 19 refs

[greg-hoarau]

Hello ! 👋

I'm experiencing a type compatibility issue between the useContextProps hook and React 19's ref handling.

The Problem:
React 19 changed how refs work - they're now passed as regular props rather than requiring forwardRef. However, useContextProps still expects the old ForwardedRef type, causing TypeScript errors.

Example:

import { createContext, type ComponentProps } from 'react'
import { type ContextValue, Button as RACButton, useContextProps } from 'react-aria-components'

interface StyleProps {
  variant?: 'filled' | 'outlined' | 'ghost'
  intent?: 'neutral' | 'accent' | 'success' | 'warning' | 'critical' | 'info'
  size?: 'xs' | 'sm' | 'md' | 'lg'
}

interface ButtonProps extends ComponentProps<typeof RACButton>, StyleProps {}

const ButtonContext = createContext<ContextValue<Partial<ButtonProps>, HTMLButtonElement>>(null)

function Button({ ref, ...props }: ButtonProps) {
  // TypeScript error: useContextProps expects ForwardedRef but React 19 provides Ref
  [props, ref] = useContextProps(props, ref, ButtonContext)

  // Some code...
  
  return <RACButton ref={ref} {...props} />
}

Question:
Do the type definitions for useContextProps need to be updated to accept both ForwardedRef<E>and Ref<E> to support React 19 ? Are there any recommended workarounds to maintain type safety in the meantime ?

Any guidance would be much appreciated!

[snowystinger]

Looks like it needs an update, I've opened a PR here chore: Update react types