Ref como Prop - Passe refs como props regulares sem forwardRef

// React 19: ref é apenas uma prop
function TextInput({ placeholder, ref }: { placeholder: string; ref?: React.Ref<HTMLInputElement> }) {
  return <input placeholder={placeholder} ref={ref} />;
}
 
// Uso -- idêntico a antes
import { useRef } from "react";
 
function App() {
  const inputRef = useRef<HTMLInputElement>(null);
 
  return (
    <div>
      <TextInput ref={inputRef} placeholder="Digite aqui..." />
      <button onClick={() => inputRef.current?.focus()}>Focar</button>
    </div>
  );
}

// Uma biblioteca de componentes de input reutilizáveis com suporte a ref
"use client";
 
import { useRef, useImperativeHandle, type Ref, type ReactNode } from "react";
 
// Encaminhamento simples de ref -- sem necessidade de wrapper forwardRef
function Input({
  label,
  error,
  ref,
  ...inputProps
}: {
  label: string;
  error?: string;
  ref?: Ref<HTMLInputElement>;
} & React.InputHTMLAttributes<HTMLInputElement>) {
  return (
    <div className="flex flex-col gap-1">
      <label className="text-sm font-medium">{label}</label>
      <input
        ref={ref}
        className={`border rounded p-2 ${error ? "border-red-500" : "border-gray-300"}`}
        {...inputProps}
      />
      {error && <span className="text-red-500 text-sm">{error}</span>}
    </div>
  );
}
 
// Handle imperativo com ref -- também sem necessidade de forwardRef
type ComboboxHandle = {
  open: () => void;
  close: () => void;
  reset: () => void;
};
 
function Combobox({
  options,
  ref,
}: {
  options: string[];
  ref?: Ref<ComboboxHandle>;
}) {
  const inputRef = useRef<HTMLInputElement>(null);
  const [isOpen, setIsOpen] = useState(false);
  const [value, setValue] = useState("");
 
  useImperativeHandle(ref, () => ({
    open: () => setIsOpen(true),
    close: () => setIsOpen(false),
    reset: () => {
      setValue("");
      setIsOpen(false);
    },
  }));
 
  return (
    <div className="relative">
      <input
        ref={inputRef}
        value={value}
        onChange={(e) => setValue(e.target.value)}
        onFocus={() => setIsOpen(true)}
      />
      {isOpen && (
        <ul className="absolute top-full left-0 border bg-white w-full">
          {options
            .filter((o) => o.toLowerCase().includes(value.toLowerCase()))
            .map((option) => (
              <li
                key={option}
                onClick={() => {
                  setValue(option);
                  setIsOpen(false);
                }}
                className="p-2 hover:bg-gray-100 cursor-pointer"
              >
                {option}
              </li>
            ))}
        </ul>
      )}
    </div>
  );
}
 
// Componente pai usando ambos os componentes
import { useState } from "react";
 
export default function RegistrationForm() {
  const nameRef = useRef<HTMLInputElement>(null);
  const comboRef = useRef<ComboboxHandle>(null);
 
  function handleReset() {
    nameRef.current?.focus();
    comboRef.current?.reset();
  }
 
  return (
    <form className="space-y-4">
      <Input ref={nameRef} label="Nome Completo" placeholder="Jane Doe" />
      <Combobox ref={comboRef} options={["Engenharia", "Design", "Produto", "Marketing"]} />
      <button type="button" onClick={handleReset}>
        Resetar e Focar Nome
      </button>
    </form>
  );
}

function MeasuredDiv({ ref }: { ref?: Ref<HTMLDivElement> }) {
  return (
    <div
      ref={(node) => {
        // Configuração
        if (node) {
          console.log("Montado:", node.getBoundingClientRect());
        }
        // Retorna a função de limpeza (novo no React 19)
        return () => {
          console.log("Desmontado");
        };
      }}
    >
      Conteúdo medido
    </div>
  );
}

type ListProps<T> = {
  items: T[];
  renderItem: (item: T) => ReactNode;
  ref?: Ref<HTMLUListElement>;
};
 
function List<T>({ items, renderItem, ref }: ListProps<T>) {
  return (
    <ul ref={ref}>
      {items.map((item, i) => (
        <li key={i}>{renderItem(item)}</li>
      ))}
    </ul>
  );
}

// Antes (React 18)
const Input = forwardRef<HTMLInputElement, InputProps>((props, ref) => {
  return <input ref={ref} {...props} />;
});
 
// Depois (React 19)
function Input({ ref, ...props }: InputProps & { ref?: Ref<HTMLInputElement> }) {
  return <input ref={ref} {...props} />;
}