From 6b749279557bbf921d43d1afa9a93a4297325297 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20LeBlanc?= <mrsebastienleblanc@icloud.com>
Date: Mon, 24 Feb 2025 18:57:33 -0500
Subject: [PATCH 1/4] docs: add devtools v3 compatibility note

---
 packages/pinia/CHANGELOG.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/pinia/CHANGELOG.md b/packages/pinia/CHANGELOG.md
index 2338d3014f..5623d644d6 100644
--- a/packages/pinia/CHANGELOG.md
+++ b/packages/pinia/CHANGELOG.md
@@ -17,6 +17,9 @@ See the [migration guide](https://pinia.vuejs.org/cookbook/migration-v2-v3.html)
 - `defineStore({ id: 'id' })` is now removed. Use `defineStore('id')` instead
 - Pinia is now published as a `type: module` package but it still provides CJS versions dist files
 
+> [!NOTE]  
+> Pinia >= 3.0.0 is only compatible with Vue Devtools v7. To use Pinia with Devtools v6, use Pinia 2
+
 ### Code Refactoring
 
 - remove deprecated aliases ([87c6182](https://github.com/vuejs/pinia/commit/87c6182c4bf61e1f96a4877eb884fd59cf824e1f))

From 90e15b3e528fdcd5c1ea90944d3755102661a41a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20LeBlanc?= <mrsebastienleblanc@icloud.com>
Date: Mon, 24 Feb 2025 19:16:49 -0500
Subject: [PATCH 2/4] docs: add devtools v3 compatibility note in migration
 guide

---
 packages/docs/cookbook/migration-v2-v3.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/docs/cookbook/migration-v2-v3.md b/packages/docs/cookbook/migration-v2-v3.md
index 3f244874b6..d9177a1ace 100644
--- a/packages/docs/cookbook/migration-v2-v3.md
+++ b/packages/docs/cookbook/migration-v2-v3.md
@@ -28,6 +28,9 @@ This deprecated type alias has been removed in favor of `PiniaPlugin`.
 - TypeScript 5 or newer is required.
 - The devtools API has been upgraded to [v7](https://devtools.vuejs.org).
 
+> [!NOTE]  
+> To use Pinia with Devtools v6, use Pinia 2
+
 ## Nuxt
 
 The Nuxt module has been updated to support Nuxt 3. If you are using Nuxt 2 or Nuxt bridge, you can keep using the old version of Pinia.

From 17e8a5810044438e0944b532eea7cd987d0b58b9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20LeBlanc?= <mrsebastienleblanc@icloud.com>
Date: Mon, 24 Feb 2025 19:42:03 -0500
Subject: [PATCH 3/4] feat: add warning for devtools v6 user upgrading to pinia
 v3

---
 packages/pinia/src/devtools/plugin.ts | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/packages/pinia/src/devtools/plugin.ts b/packages/pinia/src/devtools/plugin.ts
index a46d284396..236444dc04 100644
--- a/packages/pinia/src/devtools/plugin.ts
+++ b/packages/pinia/src/devtools/plugin.ts
@@ -52,6 +52,15 @@ interface TimelineEvent<TData = any, TMeta = any> {
  */
 const getStoreType = (id: string) => '🍍 ' + id
 
+/**
+ * Check if Vue DevTools is legacy
+ */
+function isLegacyVueDevTools() {
+  return (
+    +(globalThis.__VUE_DEVTOOLS_GLOBAL_HOOK__.devtoolsVersion?.[0] ?? 0) < 7
+  )
+}
+
 /**
  * Add the pinia plugin without any store. Allows displaying a Pinia plugin tab
  * as soon as it is added to the application.
@@ -60,6 +69,11 @@ const getStoreType = (id: string) => '🍍 ' + id
  * @param pinia - pinia instance
  */
 export function registerPiniaDevtools(app: App, pinia: Pinia) {
+  if (isLegacyVueDevTools()) {
+    toastMessage(
+      'Pinia >= 3.0.0 is only compatible with Vue Devtools v7. To use Pinia with Devtools v6, use Pinia 2'
+    )
+  }
   setupDevtoolsPlugin(
     {
       id: 'dev.esm.pinia',

From 3af0dd05ad4854a57e2d19ebd6b6a1b990f360be Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20LeBlanc?= <mrsebastienleblanc@icloud.com>
Date: Mon, 24 Feb 2025 19:50:49 -0500
Subject: [PATCH 4/4] fix: switch toastMessage to warn

---
 packages/pinia/src/devtools/plugin.ts | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/pinia/src/devtools/plugin.ts b/packages/pinia/src/devtools/plugin.ts
index 236444dc04..d9ebf652f0 100644
--- a/packages/pinia/src/devtools/plugin.ts
+++ b/packages/pinia/src/devtools/plugin.ts
@@ -71,7 +71,8 @@ function isLegacyVueDevTools() {
 export function registerPiniaDevtools(app: App, pinia: Pinia) {
   if (isLegacyVueDevTools()) {
     toastMessage(
-      'Pinia >= 3.0.0 is only compatible with Vue Devtools v7. To use Pinia with Devtools v6, use Pinia 2'
+      'Pinia >= 3.0.0 is only compatible with Vue Devtools v7. To use Pinia with Devtools v6, use Pinia 2',
+      'warn'
     )
   }
   setupDevtoolsPlugin(