October 2026 - compose-refs Deprecated

Dice UI components no longer copy lib/compose-refs.ts into your project. They now use the ref helpers their primitives already ship:

• Base UI components use useMergedRefs from @base-ui/utils, which they now list as a dependency.
• Radix components use useComposedRefs from radix-ui/internal. They need nothing new.

The compose-refs utility is deprecated as a result. The Composition page now covers how to compose Dice UI components, and how to build your own parts, with each library's own tools.

Migrating

Existing components keep working, because your copy of lib/compose-refs.ts stays in place. To drop it, reinstall the components, or update the imports yourself:

import { useComposedRefs } from "@/lib/compose-refs"; 
import { useMergedRefs } from "@base-ui/utils/useMergedRefs"; 

import { useComposedRefs } from "@/lib/compose-refs"; 
import { useComposedRefs } from "radix-ui/internal"; 

Then delete lib/compose-refs.ts. @diceui/compose-refs still installs for now and will be removed in a future release.