ECHOES-1266 Harden React 19 ref handling to prevent callback-ref update loops (useForwardedRef, compose-refs, radio-group attach refs)

[david-cho-lerat-sonarsource]

No description provided.

[sonar-review-alpha]

Summary

Hardens ref handling to prevent callback-ref update loops that cause "maximum update depth exceeded" errors in React 19. Implements three complementary fixes: (1) patches @radix-ui/react-compose-refs to skip calling function refs with null, breaking the detach/reattach feedback loop, (2) patches @radix-ui/react-radio-group's Radio component to use useRef instead of useState for button tracking, eliminating callback-ref-driven re-renders, and (3) updates useForwardedRef and useForwardedRefWithState helpers to guard against null calls and duplicate updates.

What reviewers should know

The problem: React 19's stricter ref semantics cause patterns like useState + callback-ref setters to loop—the callback triggers a state update, which re-renders and reattaches the ref, calling the callback again. Start with src/common/helpers/useForwardedRef.ts to see the internal pattern being fixed (guards on function refs, useCallback memoization, duplicate-update prevention). Then review the two patches in .yarn/patches/ to understand how they apply the same pattern to Radix dependencies. The radio-group patch is the most significant visual change (useState → useRef swap). package.json.md documents why each patch exists—review it to confirm you understand the trade-offs (these are upstream code patches, not local workarounds, so they'll need maintenance if radix updates).

---

• Generate Walkthrough
• Generate Diagram

🗣️ Give feedback

[netlify]

✅ Deploy Preview for echoes-react ready!

Name	Link
🔨 Latest commit	353c3d9
🔍 Latest deploy log	https://app.netlify.com/projects/echoes-react/deploys/69c2956eed27780008b6f340
😎 Deploy Preview	https://deploy-preview-658--echoes-react.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[hashicorp-vault-sonar-prod]

ECHOES-1266

[jeremy-davis-sonarsource]

Nice!

[sonarqube-next]

Quality Gate passed

Issues
0 New issues
0 Fixed issues
0 Accepted issues

Measures
0 Security Hotspots
0 Dependency risks
78.9% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube