TypeScript shows incorrect ref type for setup store properties instead of auto-unwrapped type

[tianzhich]

Reproduction

https://pinia.vuejs.org/core-concepts/#Using-the-store

Steps to reproduce the bug

1. Create a Pinia store using setup syntax with defineStore('name', ()
   => {})
2. Define a ref inside the store: const count = ref(0)
3. Return the ref from the store: return { count }
4. Use the store in a Vue component: const store = useChatStore()
5. Access the property: store.count
6. Check TypeScript IntelliSense/hover information

Expected behavior

• TypeScript should show count: number (auto-unwrapped type)
• IntelliSense should provide correct type hints for the unwrapped value
• No TypeScript errors when using the property as a number
• Type should match runtime behavior

Actual behavior

• TypeScript shows count: { value: number; [RefSymbol]: true }
• IntelliSense displays ref internal structure instead of unwrapped type
• May cause TypeScript errors when trying to use the value directly
• Runtime behavior is correct (auto-unwrapping works), but types don't
  reflect this
• Developers need to use type assertions or storeToRefs() as workarounds

Additional information

Environment:

• Pinia: ^2.1.4
• Vue: 3.x (via Nuxt ~3.6.5)
• TypeScript: latest
• Node.js: v18.16.0
• npm: 9.5.1
• Package Manager: [email protected]
• IDE: VS Code/WebStorm

Minimal reproduction:

  // stores/chat.ts
  import { defineStore } from 'pinia'
  import { ref, computed } from 'vue'

  export const useChatStore = defineStore('chat', () => {
    const count = ref(0)
    const name = ref('Eduardo')
    const doubleCount = computed(() => count.value * 2)

    function increment() {
      count.value++
    }

    return {
      count,
      name,
      doubleCount,
      increment,
    }
  })

  <!-- pages/c/[[id]].vue -->
  <script setup>
  import { useChatStore } from '~/stores/chat'

  const chatStore = useChatStore()

  // TypeScript shows: { value: number; [RefSymbol]: true }
  // Runtime shows: 0 (number)
  console.log("chatStore.count ===>", chatStore.count)
  </script>

Additional context

• This issue is specific to setup stores, not options stores
• The runtime behavior is correct - refs are properly auto-unwrapped
• Only the TypeScript type inference is incorrect
• Using Nuxt 3 with @pinia/nuxt: ^0.4.11
• Workarounds include:
  • Using storeToRefs() for destructuring: const { count } =
    storeToRefs(store)
  • Type assertions: store.count as number
  • Accessing via store.$state.count (though this is not recommended)

[posva]

This was fixed in newer version, upgrade your versions.

Don't open issues that do not follow the guidelines, thank you.