docs: Time to default to setup

[sofuxro]

Vue3 has defaulted to setup for a while now ( see the reasons )

I think it's time for Pinia to do the same to keep up with similar sintax and familiarity for someone learning vue3 and wanting to add stores to their project.

Related to #1265 - this was 2 years ago, much have changed since then

The "While Composition API is not for everyone" is outdated (and this phrase should be removed from the docs). Every new developer entering the Vue ecosystem will default to setup (composition API) and learning Pinia will be a pain point.

Let's change this and make <script setup> default for Pinia docs and hide option api under a toggle.

[rodrigocfd]

What used to set Vue apart from all other frameworks was the Options API. It forced your components do be organized. While this is not important in small projects, this is a huge thing in large, corporate systems. The fact it became a second-class citized, with poor TypeScript support, is very unfortunate.

Composition API becomes a mess really quickly.

[sofuxro]

It has better TS support.

Regarding component organization I suggest you read why-composition-api

I took me a while to get used to <script setup>, coming from 3 years of Options API, but once there I wouldn't switch back. Code is cleaner, less verbose and more readable.

[rodrigocfd]

Regarding component organization I suggest you read why-composition-api

I know this doc. The fallacy of this argument is that the benefit would be observable in a large component, but if you have such a large component, you better refactor it in smaller ones. So, that code organization is useless anyway. The real motivation for the Composition API, IMHO, is to make Vue closer to React... which is a bad idea.

I took me a while to get used to <script setup>, coming from 3 years of Options API, but once there I wouldn't switch back. Code is cleaner, less verbose and more readable.

I made a whole project with <script setup>, around 300 components. It was a distributed team, and the result was a mess in half of the app. Very hard to follow.

[sofuxro]

I agree that this is subjective. You don't like the new API and I like it. This doesn't really matter (in this thread).

The fact is that Vue team switched to setup (composition api) as the default. I'm suggesting Pinia do the same to keep up with the changes and make every new developer's life easier.