Merge branch 'v3' into fix/devtools

Author: noootwo

.github/ISSUE_TEMPLATE/config.yml

@@ -1,14 +1,17 @@
 blank_issues_enabled: false
 contact_links:
-  - name: Question
-    url: https://github.com/vuejs/pinia/discussions/new?category=Q-A
-    about: Ask a question or discuss about Pinia
-  - name: Paid consultation
+  - name: 👨‍💻 Support
     url: https://cal.com/posva/consultancy
     about: Get direct help from the author of Pinia with your project
-  - name: Ideas
+  - name: 🔧 Vue 2 Official Support
+    url: https://cal.com/posva/consultancy
+    about: Is your project still on Vue 2? Get official support
+  - name: ❓ Questions
+    url: https://github.com/vuejs/pinia/discussions/new?category=Q-A
+    about: Ask a question or discuss about Pinia
+  - name: 💡 Ideas
     url: https://github.com/vuejs/pinia/discussions/new?category=Ideas
     about: Start a discussion to improve Pinia
-  - name: GitHub Sponsors
+  - name: 🌟 GitHub Sponsors
     url: https://github.com/sponsors/posva
     about: Like this project? Please consider supporting the author.

.github/workflows/ci.yml

@@ -6,7 +6,7 @@ on:
       - 'packages/docs/**'
       - 'packages/playground/**'
   pull_request:
-    branches: v2
+    branches: [v2, v3]
     paths-ignore:
       - 'packages/docs/**'
       - 'packages/playground/**'

.github/workflows/pkg.pr.new.yml

@@ -2,40 +2,40 @@ name: Publish Any Commit
 
 on:
   pull_request:
-    branches: v2
+    branches: [v2, v3]
     paths-ignore:
-    - 'packages/docs/**'
-    - 'packages/playground/**'
+      - 'packages/docs/**'
+      - 'packages/playground/**'
 
   push:
     branches:
-    - '**'
+      - '**'
     tags:
-    - '!**'
+      - '!**'
     paths-ignore:
-    - 'packages/docs/**'
-    - 'packages/playground/**'
+      - 'packages/docs/**'
+      - 'packages/playground/**'
 
 jobs:
   build:
     runs-on: ubuntu-latest
 
     steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-      with:
-        fetch-depth: 0
-    - uses: pnpm/action-setup@v4
-    - uses: actions/setup-node@v4
-      with:
-        node-version: lts/*
-        cache: pnpm
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          cache: pnpm
 
-    - name: Install
-      run: pnpm install --frozen-lockfile
+      - name: Install
+        run: pnpm install --frozen-lockfile
 
-    - name: Build
-      run: pnpm build
+      - name: Build
+        run: pnpm build
 
-    - name: Release
-      run: pnpm dlx pkg-pr-new publish --compact --pnpm './packages/*'
+      - name: Release
+        run: pnpm dlx pkg-pr-new publish --compact --pnpm './packages/*'

.github/workflows/release-tag.yml

@@ -1,7 +1,7 @@
 on:
   push:
     tags:
-      - 'pinia@*' # Push events to matching v*, i.e. v1.0, v20.15.10
+      - 'v*' # Push events to matching v*, i.e. v1.0, v20.15.10
 
 name: Create Release
 

README.md

@@ -23,7 +23,7 @@
 - 📦 Extremely light
 - ⛰️ Nuxt Module
 
-Pinia works with both Vue 2 and Vue 3.
+The latest version of pinia works with Vue 3. See the branch [v2](https://github.com/vuejs/pinia/tree/v2) for a version that works with Vue 2.
 
 Pinia is the most similar English pronunciation of the word _pineapple_ in Spanish: _piña_. A pineapple is in reality a group of individual flowers that join together to create a multiple fruit. Similar to stores, each one is born individually, but they are all connected at the end. It's also a delicious tropical fruit indigenous to South America.
 
@@ -111,12 +111,6 @@ A few notes about the project and possible questions:
 npm install pinia
 ```
 
-If you are using Vue <2.7, make sure to install latest `@vue/composition-api`:
-
-```bash
-npm install pinia @vue/composition-api
-```
-
 ## Usage
 
 ### Install the plugin
@@ -136,23 +130,6 @@ app.use(pinia)
 app.mount('#app')
 ```
 
-```js
-// Vue 2
-import { createPinia, PiniaVuePlugin } from 'pinia'
-
-Vue.use(PiniaVuePlugin)
-const pinia = createPinia()
-
-new Vue({
-  el: '#app',
-  // other options...
-  // ...
-  // note the same `pinia` instance can be used across multiple Vue apps on
-  // the same page
-  pinia,
-})
-```
-
 For more detailed instructions, including [Nuxt configuration](https://pinia.vuejs.org/ssr/nuxt.html#nuxt-js), check the [Documentation](https://pinia.vuejs.org).
 
 ### Create a Store

SECURITY.md

@@ -5,14 +5,14 @@
 This is the list of versions of Pinia which are
 currently being supported with security updates.
 
-| Version            | Supported          |
-| ------------------ | ------------------ |
-| 2.1.x              | :white_check_mark: |
-| <2.1         | :x:                |
+| Version   | Supported          |
+| --------- | ------------------ |
+| 2.2.x     | :white_check_mark: |
+| <2.2.0 | :x:                |
 
 ## Reporting a Vulnerability
 
-To report a vulnerability, please email the details to [email protected].
+To report a vulnerability, please email the details to <[email protected]>.
 
 When a vulnerability is reported, it immediately becomes our top concern, with a full-time contributor dropping everything to work on it.
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pinia/root",
-  "packageManager": "pnpm@9.13.2",
+  "packageManager": "pnpm@10.2.0",
   "type": "module",
   "private": true,
   "workspaces": [
@@ -31,36 +31,36 @@
   "devDependencies": {
     "@posva/prompts": "^2.4.4",
     "@rollup/plugin-alias": "^5.1.0",
-    "@rollup/plugin-commonjs": "^28.0.1",
-    "@rollup/plugin-node-resolve": "^15.2.3",
-    "@rollup/plugin-replace": "^6.0.1",
+    "@rollup/plugin-commonjs": "^28.0.2",
+    "@rollup/plugin-node-resolve": "^16.0.0",
+    "@rollup/plugin-replace": "^6.0.2",
     "@rollup/plugin-terser": "^0.4.4",
     "@types/lodash.kebabcase": "^4.1.9",
-    "@types/node": "^20.14.12",
-    "@vitest/coverage-v8": "^2.1.5",
-    "@vitest/ui": "^2.1.5",
+    "@types/node": "^22.13.1",
+    "@vitest/coverage-v8": "^3.0.5",
+    "@vitest/ui": "^3.0.5",
     "@vue/compiler-sfc": "~3.5.13",
     "@vue/server-renderer": "~3.5.13",
-    "chalk": "^5.3.0",
+    "chalk": "^5.4.1",
     "conventional-changelog-cli": "^2.2.2",
-    "execa": "^9.5.1",
+    "execa": "^9.5.2",
     "globby": "^14.0.1",
-    "happy-dom": "^15.11.6",
-    "lint-staged": "^15.2.10",
+    "happy-dom": "^16.8.1",
+    "lint-staged": "^15.4.3",
     "lodash.kebabcase": "^4.1.1",
     "minimist": "^1.2.8",
     "p-series": "^3.0.0",
     "pascalcase": "^2.0.0",
-    "prettier": "^3.3.3",
+    "prettier": "^3.4.2",
     "rimraf": "^6.0.1",
-    "rollup": "^4.22.5",
+    "rollup": "^4.34.2",
     "rollup-plugin-typescript2": "^0.36.0",
-    "semver": "^7.6.3",
+    "semver": "^7.7.1",
     "simple-git-hooks": "^2.11.1",
-    "typedoc": "^0.26.11",
-    "typedoc-plugin-markdown": "^4.2.10",
-    "typescript": "~5.6.3",
-    "vitest": "^2.1.5",
+    "typedoc": "^0.27.6",
+    "typedoc-plugin-markdown": "~4.4.1",
+    "typescript": "~5.7.3",
+    "vitest": "^3.0.5",
     "vue": "~3.5.13"
   },
   "simple-git-hooks": {

packages/docs/.vitepress/config/en.ts

@@ -1,4 +1,5 @@
 import type { DefaultTheme, LocaleSpecificConfig } from 'vitepress'
+import typedocSidebar from '../../api/typedoc-sidebar.json'
 
 export const META_URL = 'https://pinia.vuejs.org'
 export const META_TITLE = 'Pinia 🍍'
@@ -48,23 +49,17 @@ export const enConfig: LocaleSpecificConfig<DefaultTheme.Config> = {
           },
         ],
       },
+      {
+        text: 'v3.x',
+        items: [{ text: 'v2.x', link: 'https://v2.pinia.vuejs.org' }],
+      },
     ],
 
     sidebar: {
       '/api/': [
         {
-          text: 'packages',
-          items: [
-            { text: 'pinia', link: '/api/pinia/' },
-            {
-              text: '@pinia/nuxt',
-              link: '/api/@pinia/nuxt/',
-            },
-            {
-              text: '@pinia/testing',
-              link: '/api/@pinia/testing/',
-            },
-          ],
+          text: 'API',
+          items: typedocSidebar,
         },
       ],
       // catch-all fallback
@@ -141,6 +136,10 @@ export const enConfig: LocaleSpecificConfig<DefaultTheme.Config> = {
               text: 'VSCode Snippets',
               link: '/cookbook/vscode-snippets.html',
             },
+            {
+              text: 'Migration from v2 to v3',
+              link: '/cookbook/migration-v2-v3.html',
+            },
             {
               text: 'Migration from v0/v1 to v2',
               link: '/cookbook/migration-v1-v2.html',

packages/docs/.vitepress/config/shared.ts

@@ -128,7 +128,7 @@ export const sharedConfig = defineConfig({
     },
 
     editLink: {
-      pattern: 'https://github.com/vuejs/pinia/edit/v2/packages/docs/:path',
+      pattern: 'https://github.com/vuejs/pinia/edit/v3/packages/docs/:path',
       text: 'Suggest changes',
     },
 

packages/docs/.vitepress/config/zh.ts

@@ -58,6 +58,10 @@ export const zhConfig: LocaleSpecificConfig<DefaultTheme.Config> = {
           },
         ],
       },
+      {
+        text: 'v3.x',
+        items: [{ text: 'v2.x', link: 'https://v2.pinia.vuejs.org' }],
+      },
     ],
     sidebar: {
       '/zh/api/': [