@wishbone-media/spark 0.28.0 → 0.29.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wishbone-media/spark",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",

package/src/components/SparkNotificationOutlet.vue

@@ -30,7 +30,8 @@
 </template>
 
 <script setup>
-import { computed, ref, watch } from 'vue'
+import { computed, ref, watch, onMounted } from 'vue'
+import { useRoute } from 'vue-router'
 import { sparkNotificationService } from '@/composables/sparkNotificationService'
 import SparkAlert from '@/components/SparkAlert.vue'
 
@@ -39,8 +40,13 @@ const props = defineProps({
     type: String,
     default: 'default',
   },
+  clearOnRouteChange: {
+    type: Boolean,
+    default: true,
+  },
 })
 
+const route = useRoute()
 const outlet = computed(() => sparkNotificationService.getOutlet(props.name))
 
 // Generate unique key for each notification to trigger transition on content change
@@ -54,6 +60,43 @@ watch(
   },
 )
 
+// Track which path the notification was shown on
+watch(
+  () => outlet.value.state.isVisible,
+  (isVisible) => {
+    if (isVisible && !outlet.value.state.shownOnPath) {
+      outlet.value.state.shownOnPath = route.path
+    }
+  },
+  { immediate: true },
+)
+
+// On mount, check if notification was shown on a different route
+onMounted(() => {
+  if (!props.clearOnRouteChange) return
+  if (route.meta.preserveNotifications) return
+  if (!outlet.value.state.isVisible) return
+  if (outlet.value.state.persistent) return
+
+  // If notification was shown on a different path, hide it
+  if (outlet.value.state.shownOnPath && outlet.value.state.shownOnPath !== route.path) {
+    outlet.value.hide()
+  }
+})
+
+// Auto-clear notification on route change (while mounted)
+watch(
+  () => route.path,
+  () => {
+    if (!props.clearOnRouteChange) return
+    if (route.meta.preserveNotifications) return
+    if (!outlet.value.state.isVisible) return
+    if (outlet.value.state.persistent) return
+
+    outlet.value.hide()
+  },
+)
+
 const handleClose = () => {
   sparkNotificationService.hide(props.name)
 }

package/src/composables/sparkNotificationService.js

@@ -24,6 +24,8 @@ function createNotificationOutlet() {
     props: {},
     closeable: true,
     duration: null,
+    persistent: false,
+    shownOnPath: null,
   })
 
   // Timer state (not reactive, internal only)
@@ -90,6 +92,7 @@ function createNotificationOutlet() {
       props = {},
       closeable = true,
       duration = null,
+      persistent = false,
     } = options
 
     state.type = type
@@ -97,6 +100,7 @@ function createNotificationOutlet() {
     state.component = component ? markRaw(component) : null
     state.props = props
     state.closeable = closeable
+    state.persistent = persistent
     state.isVisible = true
 
     // Determine duration: explicit > default for type
@@ -116,6 +120,8 @@ function createNotificationOutlet() {
     state.props = {}
     state.closeable = true
     state.duration = null
+    state.persistent = false
+    state.shownOnPath = null
   }
 
   return {
@@ -187,6 +193,7 @@ class SparkNotificationService {
    * @param {Object} options.props - Props to pass to the component
    * @param {boolean} options.closeable - Whether to show close button (default: true)
    * @param {number} options.duration - Auto-dismiss duration in ms (0 = sticky, null = use default)
+   * @param {boolean} options.persistent - Whether notification survives route changes (default: false)
    * @param {string} outletName - Target outlet name (default: 'default')
    */
   show(options = {}, outletName = 'default') {
@@ -212,6 +219,18 @@ class SparkNotificationService {
     }
   }
 
+  /**
+   * Hide all non-persistent banner notifications
+   * Called by setupNotificationGuard on route change
+   */
+  hideAllNonPersistent() {
+    for (const outlet of this.outlets.values()) {
+      if (!outlet.state.persistent) {
+        outlet.hide()
+      }
+    }
+  }
+
   /**
    * Pause auto-dismiss timer for the specified banner outlet
    * @param {string} outletName - Target outlet name (default: 'default')