[doc]: ElementRef is deprecated - use ComponentRef<T> instead

[alamenai]

This is not a bug but a deprecation of a type from React.

In the Navigation Menu component, we have :

const ListItem = React.forwardRef<
  React.ElementRef<"a">,
  React.ComponentPropsWithoutRef<"a">
>(({ className, title, children, ...props }, ref) => {
  return (
    <li>
      <NavigationMenuLink asChild>
        <a
          ref={ref}
          className={cn(
            "block select-none space-y-3 rounded-md p-3 leading-none no-underline outline-none transition-colors hover:bg-accent hover:text-accent-foreground focus:bg-accent focus:text-accent-foreground",
            className,
          )}
          {...props}
        >
          <div className="text-sm font-bold leading-none">{title}</div>
          <p className="line-clamp-2 text-sm leading-snug text-muted-foreground">
            {children}
          </p>
        </a>
      </NavigationMenuLink>
    </li>
  );
});
ListItem.displayName = "ListItem";

But the type ElementRef is deprecated and it should be replaced with ComponentRef

[Sparticuz]

Is it enough just to replace ElementRef<T> with ComponentRef<T>? This warning seems to be in nearly every component.

[KarimElsayad247]

wondering about the same issue.

After some investigation, it appears the source file for those react types[0] treats them nearly identically, going as far as forgetting to update the example usage for ComponentRef lol

    /**
     * Retrieves the type of the 'ref' prop for a given component type or tag name.
     *
     * @template C The component type.
     *
     * @example
     *
     * ```tsx
     * type MyComponentRef = React.ElementRef<typeof MyComponent>;
     * ```
     *
     * @example
     *
     * ```tsx
     * type DivRef = React.ElementRef<'div'>;
     * ```
     */
    type ComponentRef<T extends ElementType> = ComponentPropsWithRef<T> extends RefAttributes<infer Method> ? Method
        : never;

[0] https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/react/index.d.ts