@moku-labs/web 2.1.0 → 2.1.1

package/dist/browser.mjs

@@ -4156,6 +4156,27 @@ function createSpaKernel(state, config, emit, deps) {
 		if (signal?.aborted) return;
 		await performNavigation(pathname, handlers, signal);
 	};
+	/**
+	* Programmatic navigation entry (`app.spa.navigate` / `ctx.navigate`). A link click or the
+	* Navigation API commits the address bar before the interceptor calls {@link navigate}; a
+	* programmatic call does NOT, so it must commit the URL itself first — otherwise the content
+	* swaps but the address bar (and the back button / refresh / deep link) stays on the old URL.
+	* `history.pushState` updates the URL WITHOUT firing a `navigate` event, so it can't
+	* double-trigger the interceptor. The current scroll is saved first so a later back restores it.
+	*
+	* @param path - The destination path (pathname + optional search).
+	* @param scroll - The optional per-call scroll override.
+	* @example
+	* navigateProgrammatic("/board/abc/issue/1", "preserve");
+	*/
+	const navigateProgrammatic = (path, scroll) => {
+		if (typeof document === "undefined") return;
+		if (path !== currentLocationUrl()) {
+			saveScrollPosition(currentLocationUrl());
+			history.pushState({}, "", path);
+		}
+		navigate(path, true, void 0, scroll).catch(() => {});
+	};
 	return {
 		/**
 		* Register config islands and seed currentUrl from the document.
@@ -4167,8 +4188,7 @@ function createSpaKernel(state, config, emit, deps) {
 			for (const island of resolved.islands) registerIsland(state, island);
 			state.currentUrl = currentLocationUrl();
 			state.navigate = (path, options) => {
-				if (typeof document === "undefined") return;
-				navigate(path, true, void 0, options?.scroll).catch(() => {});
+				navigateProgrammatic(path, options?.scroll);
 			};
 		},
 		/**
@@ -4209,8 +4229,7 @@ function createSpaKernel(state, config, emit, deps) {
 		* kernel.processNav("/about");
 		*/
 		processNav(path, options) {
-			if (typeof document === "undefined") return;
-			navigate(path, true, void 0, options?.scroll).catch(() => {});
+			navigateProgrammatic(path, options?.scroll);
 		},
 		/**
 		* Scan the swap region and mount islands for matching elements.

package/dist/index.cjs

@@ -10862,6 +10862,27 @@ function createSpaKernel(state, config, emit, deps) {
 		if (signal?.aborted) return;
 		await performNavigation(pathname, handlers, signal);
 	};
+	/**
+	* Programmatic navigation entry (`app.spa.navigate` / `ctx.navigate`). A link click or the
+	* Navigation API commits the address bar before the interceptor calls {@link navigate}; a
+	* programmatic call does NOT, so it must commit the URL itself first — otherwise the content
+	* swaps but the address bar (and the back button / refresh / deep link) stays on the old URL.
+	* `history.pushState` updates the URL WITHOUT firing a `navigate` event, so it can't
+	* double-trigger the interceptor. The current scroll is saved first so a later back restores it.
+	*
+	* @param path - The destination path (pathname + optional search).
+	* @param scroll - The optional per-call scroll override.
+	* @example
+	* navigateProgrammatic("/board/abc/issue/1", "preserve");
+	*/
+	const navigateProgrammatic = (path, scroll) => {
+		if (typeof document === "undefined") return;
+		if (path !== currentLocationUrl()) {
+			saveScrollPosition(currentLocationUrl());
+			history.pushState({}, "", path);
+		}
+		navigate(path, true, void 0, scroll).catch(() => {});
+	};
 	return {
 		/**
 		* Register config islands and seed currentUrl from the document.
@@ -10873,8 +10894,7 @@ function createSpaKernel(state, config, emit, deps) {
 			for (const island of resolved.islands) registerIsland(state, island);
 			state.currentUrl = currentLocationUrl();
 			state.navigate = (path, options) => {
-				if (typeof document === "undefined") return;
-				navigate(path, true, void 0, options?.scroll).catch(() => {});
+				navigateProgrammatic(path, options?.scroll);
 			};
 		},
 		/**
@@ -10915,8 +10935,7 @@ function createSpaKernel(state, config, emit, deps) {
 		* kernel.processNav("/about");
 		*/
 		processNav(path, options) {
-			if (typeof document === "undefined") return;
-			navigate(path, true, void 0, options?.scroll).catch(() => {});
+			navigateProgrammatic(path, options?.scroll);
 		},
 		/**
 		* Scan the swap region and mount islands for matching elements.

package/dist/index.mjs

@@ -10849,6 +10849,27 @@ function createSpaKernel(state, config, emit, deps) {
 		if (signal?.aborted) return;
 		await performNavigation(pathname, handlers, signal);
 	};
+	/**
+	* Programmatic navigation entry (`app.spa.navigate` / `ctx.navigate`). A link click or the
+	* Navigation API commits the address bar before the interceptor calls {@link navigate}; a
+	* programmatic call does NOT, so it must commit the URL itself first — otherwise the content
+	* swaps but the address bar (and the back button / refresh / deep link) stays on the old URL.
+	* `history.pushState` updates the URL WITHOUT firing a `navigate` event, so it can't
+	* double-trigger the interceptor. The current scroll is saved first so a later back restores it.
+	*
+	* @param path - The destination path (pathname + optional search).
+	* @param scroll - The optional per-call scroll override.
+	* @example
+	* navigateProgrammatic("/board/abc/issue/1", "preserve");
+	*/
+	const navigateProgrammatic = (path, scroll) => {
+		if (typeof document === "undefined") return;
+		if (path !== currentLocationUrl()) {
+			saveScrollPosition(currentLocationUrl());
+			history.pushState({}, "", path);
+		}
+		navigate(path, true, void 0, scroll).catch(() => {});
+	};
 	return {
 		/**
 		* Register config islands and seed currentUrl from the document.
@@ -10860,8 +10881,7 @@ function createSpaKernel(state, config, emit, deps) {
 			for (const island of resolved.islands) registerIsland(state, island);
 			state.currentUrl = currentLocationUrl();
 			state.navigate = (path, options) => {
-				if (typeof document === "undefined") return;
-				navigate(path, true, void 0, options?.scroll).catch(() => {});
+				navigateProgrammatic(path, options?.scroll);
 			};
 		},
 		/**
@@ -10902,8 +10922,7 @@ function createSpaKernel(state, config, emit, deps) {
 		* kernel.processNav("/about");
 		*/
 		processNav(path, options) {
-			if (typeof document === "undefined") return;
-			navigate(path, true, void 0, options?.scroll).catch(() => {});
+			navigateProgrammatic(path, options?.scroll);
 		},
 		/**
 		* Scan the swap region and mount islands for matching elements.

package/package.json

@@ -132,5 +132,5 @@
     "test:build-e2e": "bun test src/plugins/build/__tests__/e2e/",
     "test:coverage": "vitest run --project unit --project integration --coverage"
   },
-  "version": "2.1.0"
+  "version": "2.1.1"
 }