En JavaScript la desestructuración se ha vuelto un reflejo automático: escribimos const { count } = props sin pensarlo dos veces. Pero en Vue 3 Composition API este patrón se convierte en una trampa traicionera.
El objeto props en Vue es un Proxy reactivo. Cuando desestructurar un primitivo (número, cadena o booleano), copias el valor suelto rompiendo el vínculo con el proxy: el componente padre actualiza la prop, ¡pero tu variable local ya no se entera!
Como se explica en este análisis sobre la reactividad en Vue, el problema se resuelve por dos vías:
1. Utilidad toRefs:
Envuelve cada propiedad de props en un Ref reactivo:
import { toRefs } from 'vue';
const props = defineProps<{ count: number }>();
const { count } = toRefs(props);
2. Desestructuración nativa en Vue 3.5+: El compilador de Vue 3.5+ conserva automáticamente la reactividad mediante el macro:
// En Vue 3.5+ la reactividad no se pierde
const { count = 0 } = defineProps<{ count?: number }>();
Para empaquetar tus proyectos, échale un vistazo a nuestro análisis del lanzamiento de Vite+ 1.0 y VoidZero.