sv-router 0.12.0 → 0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sv-router",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Modern Svelte Routing",
   "keywords": [
     "svelte",
@@ -48,7 +48,7 @@
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "eslint-plugin-svelte": "^3.13.1",
     "eslint-plugin-unicorn": "^62.0.0",
-    "globals": "^16.5.0",
+    "globals": "^17.0.0",
     "happy-dom": "^20.0.11",
     "prettier": "^3.7.4",
     "prettier-plugin-jsdoc": "^1.8.0",

package/src/create-router.svelte.js

@@ -43,6 +43,9 @@ let params = $state({ value: {} });
 
 let meta = $state({ value: {} });
 
+/** @type {(() => boolean) | null} */
+let navigationBlocker = null;
+
 let navigationIndex = 0;
 let pendingNavigationIndex = 0;
 
@@ -151,6 +154,22 @@ export async function onNavigate(path, options = {}) {
 		throw new Error('Router not initialized: `createRouter` was not called.');
 	}
 
+	if (navigationBlocker) {
+		if (!navigationBlocker()) {
+			const url = new URL(globalThis.location.toString());
+			url.search = location.search;
+			url.hash = location.hash;
+			if (base.name === '#') {
+				url.hash = location.pathname;
+			} else {
+				url.pathname = location.pathname;
+			}
+			globalThis.history.replaceState($state.snapshot(location.state) || {}, '', url.toString());
+			return;
+		}
+		navigationBlocker = null;
+	}
+
 	navigationIndex++;
 	const currentNavigationIndex = navigationIndex;
 
@@ -292,3 +311,8 @@ export function onGlobalClick(event) {
 		viewTransition: viewTransition === '' || viewTransition === 'true',
 	});
 }
+
+/** @param {() => boolean} callback */
+export function blockNavigation(callback) {
+	navigationBlocker = callback;
+}

package/src/helpers/match-route.js

@@ -64,11 +64,11 @@ export function matchRoute(pathname, routes) {
 
 			const pathPart = pathParts[index];
 			if (routePart.startsWith(':')) {
-				params[routePart.slice(1)] = pathPart;
+				params[routePart.slice(1)] = decodeURIComponent(pathPart);
 			} else if (routePart.startsWith('*')) {
 				const param = routePart.slice(1);
 				if (param) {
-					params[param] = pathParts.slice(index).join('/');
+					params[param] = pathParts.slice(index).map(decodeURIComponent).join('/');
 				}
 				if (breakFromLayouts) {
 					routePart = `(${routePart})`;

package/src/index.d.ts

@@ -28,6 +28,15 @@ export function serializeSearch(search: Search): string | undefined;
  */
 export function createRouter<T extends Routes>(r: T): RouterApi<T>;
 
+/**
+ * Block navigation until the callback returns `false`.
+ *
+ * ```js
+ * blockNavigation(() => confirm('Are you sure you want to leave?'));
+ * ```
+ */
+export function blockNavigation(callback: () => boolean): void;
+
 /**
  * The component that will render the current route. You can pass a `base` prop to set the base path
  * that is prepended to every url.

package/src/index.js

@@ -1,5 +1,5 @@
 export { isActiveLink } from './actions.svelte.js';
-export { createRouter } from './create-router.svelte.js';
+export { blockNavigation, createRouter } from './create-router.svelte.js';
 export { serializeSearch } from './helpers/utils.js';
 export { Navigation } from './navigation.js';
 export { default as Router } from './Router.svelte';