@moku-labs/web 1.12.0 → 1.12.2

package/dist/browser.mjs

@@ -3738,6 +3738,17 @@ async function performNavigation(pathname, handlers, signal) {
 	}
 }
 /**
+* Whether the user has asked the platform to minimise motion.
+*
+* @returns `true` when `(prefers-reduced-motion: reduce)` currently matches; `false` when
+*   it does not, or when `matchMedia` is absent (guards SSR/test environments).
+* @example
+* const behavior: ScrollBehavior = prefersReducedMotion() ? "instant" : "smooth";
+*/
+function prefersReducedMotion() {
+	return typeof globalThis.matchMedia === "function" && globalThis.matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+/**
 * Run a DOM-mutating swap, optionally wrapped in the View Transitions API when
 * enabled and supported (instant swap otherwise — never throws).
 *
@@ -3758,7 +3769,7 @@ async function performNavigation(pathname, handlers, signal) {
 * runSwap(() => current.replaceWith(next), true, () => scrollTo({ top: 0, behavior: "instant" }));
 */
 function runSwap(doSwap, viewTransitions, beforeCapture) {
-	const reduced = typeof globalThis.matchMedia === "function" && globalThis.matchMedia("(prefers-reduced-motion: reduce)").matches;
+	const reduced = prefersReducedMotion();
 	const docWithVt = document;
 	const canUseViewTransitions = viewTransitions && !reduced && typeof docWithVt.startViewTransition === "function";
 	beforeCapture?.();
@@ -3856,7 +3867,7 @@ function attachHistoryFallback(handlers, navigate = (pathname, _scrollToTop, sig
 		if (pathWithSearch(url) === pathWithSearch(location)) {
 			window.scrollTo({
 				top: 0,
-				behavior: "smooth"
+				behavior: prefersReducedMotion() ? "instant" : "smooth"
 			});
 			return;
 		}
@@ -3910,7 +3921,7 @@ function attachNavigationApi(navigation, handlers, navigate = (pathname, _scroll
 			navEvent.intercept({ handler: () => {
 				window.scrollTo({
 					top: 0,
-					behavior: "smooth"
+					behavior: prefersReducedMotion() ? "instant" : "smooth"
 				});
 				return Promise.resolve();
 			} });
@@ -4087,26 +4098,30 @@ function createSpaKernel(state, config, emit, deps) {
 	let pendingScrollToTop = true;
 	/**
 	* Apply the in-flight navigation's scroll intent — the swap's `beforeCapture` hook.
-	* For a forward nav it scrolls to top BEFORE the snapshot is captured, so the old and
-	* new states share scrollY=0 (no delta → the sticky header never un-pins) and there is
-	* no pre-fetch scroll pause. Traverse (back/forward) sets `pendingScrollToTop = false`
-	* and restores its saved position after the swap instead.
+	* For a forward nav it scrolls to top BEFORE the swap (and, with view transitions on,
+	* before the "old" snapshot is captured), so the old and new states share scrollY=0:
+	* no delta for a transition to animate → a `position: sticky` header never un-pins.
+	* Traverse (back/forward) sets `pendingScrollToTop = false` and restores its saved
+	* position after the swap instead.
 	*
-	* Scroll behaviour: `"instant"` ONLY when view transitions are enabled — that is what
-	* keeps scrollY=0 in the captured snapshot (a `scroll-behavior: smooth` would otherwise
-	* animate the reset and re-create the delta → sticky-header flicker). With view
-	* transitions OFF there is no snapshot to protect, so it honours the page's
-	* `scroll-behavior` (`"auto"` = use the CSS value, e.g. a smooth scroll-to-top on nav).
+	* The reset is ALWAYS `"instant"`, never the CSS-driven `"auto"`. It runs synchronously
+	* immediately before the swap, and the swap mutates document height (the outgoing page is
+	* usually taller than the incoming one). A smooth scroll — from `behavior: "smooth"` or a
+	* page `scroll-behavior: smooth` that `"auto"` would inherit — is still animating when that
+	* height change lands; the browser clamps scrollY to the new, smaller maximum and cancels
+	* the in-flight animation there (worst on WebKit), stranding the page near the OLD position
+	* instead of the top. Instant lands scrollY=0 before the swap, every time. (A smooth
+	* scroll-to-top on the SAME page is unaffected — the router's same-page handler animates
+	* it, where there is no swap to race.)
 	*
 	* @example
 	* runSwap(renderAndMount, viewTransitions, applyPendingScroll);
 	*/
 	const applyPendingScroll = () => {
 		if (!pendingScrollToTop) return;
-		const behavior = resolved.viewTransitions ? "instant" : "auto";
 		window.scrollTo({
 			top: 0,
-			behavior
+			behavior: "instant"
 		});
 	};
 	/**
@@ -4163,7 +4178,7 @@ function createSpaKernel(state, config, emit, deps) {
 		progress?.done();
 	};
 	const handlers = {
-		onStart: handleStart,
+		onStart: () => {},
 		onEnd: handleEnd,
 		onError: handleError
 	};
@@ -4220,7 +4235,6 @@ function createSpaKernel(state, config, emit, deps) {
 	const commitDataRender = async (pathname, resolvedRender, signal) => {
 		if (signal?.aborted) return;
 		const { route, vnode, routeContext, region } = resolvedRender;
-		handleStart(pathname);
 		const { renderVNode } = await import("./render-BNe0s7fr.mjs");
 		if (signal?.aborted) return;
 		syncDataHead(deps.head, route, routeContext);
@@ -4266,7 +4280,6 @@ function createSpaKernel(state, config, emit, deps) {
 			await commitDataRender(pathname, resolvedRender, signal);
 			return true;
 		} catch {
-			progress?.done();
 			return false;
 		}
 	};
@@ -4287,6 +4300,7 @@ function createSpaKernel(state, config, emit, deps) {
 	*/
 	const navigate = async (pathname, scrollToTop = true, signal) => {
 		pendingScrollToTop = scrollToTop;
+		handleStart(pathname);
 		if (deps.router.mode() !== "ssg" && await tryDataRender(pathname, signal)) return;
 		if (signal?.aborted) return;
 		await performNavigation(pathname, handlers, signal);

package/dist/index.cjs

@@ -10639,6 +10639,17 @@ async function performNavigation(pathname, handlers, signal) {
 	}
 }
 /**
+* Whether the user has asked the platform to minimise motion.
+*
+* @returns `true` when `(prefers-reduced-motion: reduce)` currently matches; `false` when
+*   it does not, or when `matchMedia` is absent (guards SSR/test environments).
+* @example
+* const behavior: ScrollBehavior = prefersReducedMotion() ? "instant" : "smooth";
+*/
+function prefersReducedMotion() {
+	return typeof globalThis.matchMedia === "function" && globalThis.matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+/**
 * Run a DOM-mutating swap, optionally wrapped in the View Transitions API when
 * enabled and supported (instant swap otherwise — never throws).
 *
@@ -10659,7 +10670,7 @@ async function performNavigation(pathname, handlers, signal) {
 * runSwap(() => current.replaceWith(next), true, () => scrollTo({ top: 0, behavior: "instant" }));
 */
 function runSwap(doSwap, viewTransitions, beforeCapture) {
-	const reduced = typeof globalThis.matchMedia === "function" && globalThis.matchMedia("(prefers-reduced-motion: reduce)").matches;
+	const reduced = prefersReducedMotion();
 	const docWithVt = document;
 	const canUseViewTransitions = viewTransitions && !reduced && typeof docWithVt.startViewTransition === "function";
 	beforeCapture?.();
@@ -10757,7 +10768,7 @@ function attachHistoryFallback(handlers, navigate = (pathname, _scrollToTop, sig
 		if (pathWithSearch(url) === pathWithSearch(location)) {
 			window.scrollTo({
 				top: 0,
-				behavior: "smooth"
+				behavior: prefersReducedMotion() ? "instant" : "smooth"
 			});
 			return;
 		}
@@ -10811,7 +10822,7 @@ function attachNavigationApi(navigation, handlers, navigate = (pathname, _scroll
 			navEvent.intercept({ handler: () => {
 				window.scrollTo({
 					top: 0,
-					behavior: "smooth"
+					behavior: prefersReducedMotion() ? "instant" : "smooth"
 				});
 				return Promise.resolve();
 			} });
@@ -10988,26 +10999,30 @@ function createSpaKernel(state, config, emit, deps) {
 	let pendingScrollToTop = true;
 	/**
 	* Apply the in-flight navigation's scroll intent — the swap's `beforeCapture` hook.
-	* For a forward nav it scrolls to top BEFORE the snapshot is captured, so the old and
-	* new states share scrollY=0 (no delta → the sticky header never un-pins) and there is
-	* no pre-fetch scroll pause. Traverse (back/forward) sets `pendingScrollToTop = false`
-	* and restores its saved position after the swap instead.
+	* For a forward nav it scrolls to top BEFORE the swap (and, with view transitions on,
+	* before the "old" snapshot is captured), so the old and new states share scrollY=0:
+	* no delta for a transition to animate → a `position: sticky` header never un-pins.
+	* Traverse (back/forward) sets `pendingScrollToTop = false` and restores its saved
+	* position after the swap instead.
 	*
-	* Scroll behaviour: `"instant"` ONLY when view transitions are enabled — that is what
-	* keeps scrollY=0 in the captured snapshot (a `scroll-behavior: smooth` would otherwise
-	* animate the reset and re-create the delta → sticky-header flicker). With view
-	* transitions OFF there is no snapshot to protect, so it honours the page's
-	* `scroll-behavior` (`"auto"` = use the CSS value, e.g. a smooth scroll-to-top on nav).
+	* The reset is ALWAYS `"instant"`, never the CSS-driven `"auto"`. It runs synchronously
+	* immediately before the swap, and the swap mutates document height (the outgoing page is
+	* usually taller than the incoming one). A smooth scroll — from `behavior: "smooth"` or a
+	* page `scroll-behavior: smooth` that `"auto"` would inherit — is still animating when that
+	* height change lands; the browser clamps scrollY to the new, smaller maximum and cancels
+	* the in-flight animation there (worst on WebKit), stranding the page near the OLD position
+	* instead of the top. Instant lands scrollY=0 before the swap, every time. (A smooth
+	* scroll-to-top on the SAME page is unaffected — the router's same-page handler animates
+	* it, where there is no swap to race.)
 	*
 	* @example
 	* runSwap(renderAndMount, viewTransitions, applyPendingScroll);
 	*/
 	const applyPendingScroll = () => {
 		if (!pendingScrollToTop) return;
-		const behavior = resolved.viewTransitions ? "instant" : "auto";
 		window.scrollTo({
 			top: 0,
-			behavior
+			behavior: "instant"
 		});
 	};
 	/**
@@ -11064,7 +11079,7 @@ function createSpaKernel(state, config, emit, deps) {
 		progress?.done();
 	};
 	const handlers = {
-		onStart: handleStart,
+		onStart: () => {},
 		onEnd: handleEnd,
 		onError: handleError
 	};
@@ -11121,7 +11136,6 @@ function createSpaKernel(state, config, emit, deps) {
 	const commitDataRender = async (pathname, resolvedRender, signal) => {
 		if (signal?.aborted) return;
 		const { route, vnode, routeContext, region } = resolvedRender;
-		handleStart(pathname);
 		const { renderVNode } = await Promise.resolve().then(() => require("./render-DLZEOe4M.cjs"));
 		if (signal?.aborted) return;
 		syncDataHead(deps.head, route, routeContext);
@@ -11167,7 +11181,6 @@ function createSpaKernel(state, config, emit, deps) {
 			await commitDataRender(pathname, resolvedRender, signal);
 			return true;
 		} catch {
-			progress?.done();
 			return false;
 		}
 	};
@@ -11188,6 +11201,7 @@ function createSpaKernel(state, config, emit, deps) {
 	*/
 	const navigate = async (pathname, scrollToTop = true, signal) => {
 		pendingScrollToTop = scrollToTop;
+		handleStart(pathname);
 		if (deps.router.mode() !== "ssg" && await tryDataRender(pathname, signal)) return;
 		if (signal?.aborted) return;
 		await performNavigation(pathname, handlers, signal);

package/dist/index.mjs

@@ -10626,6 +10626,17 @@ async function performNavigation(pathname, handlers, signal) {
 	}
 }
 /**
+* Whether the user has asked the platform to minimise motion.
+*
+* @returns `true` when `(prefers-reduced-motion: reduce)` currently matches; `false` when
+*   it does not, or when `matchMedia` is absent (guards SSR/test environments).
+* @example
+* const behavior: ScrollBehavior = prefersReducedMotion() ? "instant" : "smooth";
+*/
+function prefersReducedMotion() {
+	return typeof globalThis.matchMedia === "function" && globalThis.matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+/**
 * Run a DOM-mutating swap, optionally wrapped in the View Transitions API when
 * enabled and supported (instant swap otherwise — never throws).
 *
@@ -10646,7 +10657,7 @@ async function performNavigation(pathname, handlers, signal) {
 * runSwap(() => current.replaceWith(next), true, () => scrollTo({ top: 0, behavior: "instant" }));
 */
 function runSwap(doSwap, viewTransitions, beforeCapture) {
-	const reduced = typeof globalThis.matchMedia === "function" && globalThis.matchMedia("(prefers-reduced-motion: reduce)").matches;
+	const reduced = prefersReducedMotion();
 	const docWithVt = document;
 	const canUseViewTransitions = viewTransitions && !reduced && typeof docWithVt.startViewTransition === "function";
 	beforeCapture?.();
@@ -10744,7 +10755,7 @@ function attachHistoryFallback(handlers, navigate = (pathname, _scrollToTop, sig
 		if (pathWithSearch(url) === pathWithSearch(location)) {
 			window.scrollTo({
 				top: 0,
-				behavior: "smooth"
+				behavior: prefersReducedMotion() ? "instant" : "smooth"
 			});
 			return;
 		}
@@ -10798,7 +10809,7 @@ function attachNavigationApi(navigation, handlers, navigate = (pathname, _scroll
 			navEvent.intercept({ handler: () => {
 				window.scrollTo({
 					top: 0,
-					behavior: "smooth"
+					behavior: prefersReducedMotion() ? "instant" : "smooth"
 				});
 				return Promise.resolve();
 			} });
@@ -10975,26 +10986,30 @@ function createSpaKernel(state, config, emit, deps) {
 	let pendingScrollToTop = true;
 	/**
 	* Apply the in-flight navigation's scroll intent — the swap's `beforeCapture` hook.
-	* For a forward nav it scrolls to top BEFORE the snapshot is captured, so the old and
-	* new states share scrollY=0 (no delta → the sticky header never un-pins) and there is
-	* no pre-fetch scroll pause. Traverse (back/forward) sets `pendingScrollToTop = false`
-	* and restores its saved position after the swap instead.
+	* For a forward nav it scrolls to top BEFORE the swap (and, with view transitions on,
+	* before the "old" snapshot is captured), so the old and new states share scrollY=0:
+	* no delta for a transition to animate → a `position: sticky` header never un-pins.
+	* Traverse (back/forward) sets `pendingScrollToTop = false` and restores its saved
+	* position after the swap instead.
 	*
-	* Scroll behaviour: `"instant"` ONLY when view transitions are enabled — that is what
-	* keeps scrollY=0 in the captured snapshot (a `scroll-behavior: smooth` would otherwise
-	* animate the reset and re-create the delta → sticky-header flicker). With view
-	* transitions OFF there is no snapshot to protect, so it honours the page's
-	* `scroll-behavior` (`"auto"` = use the CSS value, e.g. a smooth scroll-to-top on nav).
+	* The reset is ALWAYS `"instant"`, never the CSS-driven `"auto"`. It runs synchronously
+	* immediately before the swap, and the swap mutates document height (the outgoing page is
+	* usually taller than the incoming one). A smooth scroll — from `behavior: "smooth"` or a
+	* page `scroll-behavior: smooth` that `"auto"` would inherit — is still animating when that
+	* height change lands; the browser clamps scrollY to the new, smaller maximum and cancels
+	* the in-flight animation there (worst on WebKit), stranding the page near the OLD position
+	* instead of the top. Instant lands scrollY=0 before the swap, every time. (A smooth
+	* scroll-to-top on the SAME page is unaffected — the router's same-page handler animates
+	* it, where there is no swap to race.)
 	*
 	* @example
 	* runSwap(renderAndMount, viewTransitions, applyPendingScroll);
 	*/
 	const applyPendingScroll = () => {
 		if (!pendingScrollToTop) return;
-		const behavior = resolved.viewTransitions ? "instant" : "auto";
 		window.scrollTo({
 			top: 0,
-			behavior
+			behavior: "instant"
 		});
 	};
 	/**
@@ -11051,7 +11066,7 @@ function createSpaKernel(state, config, emit, deps) {
 		progress?.done();
 	};
 	const handlers = {
-		onStart: handleStart,
+		onStart: () => {},
 		onEnd: handleEnd,
 		onError: handleError
 	};
@@ -11108,7 +11123,6 @@ function createSpaKernel(state, config, emit, deps) {
 	const commitDataRender = async (pathname, resolvedRender, signal) => {
 		if (signal?.aborted) return;
 		const { route, vnode, routeContext, region } = resolvedRender;
-		handleStart(pathname);
 		const { renderVNode } = await import("./render-BNe0s7fr.mjs");
 		if (signal?.aborted) return;
 		syncDataHead(deps.head, route, routeContext);
@@ -11154,7 +11168,6 @@ function createSpaKernel(state, config, emit, deps) {
 			await commitDataRender(pathname, resolvedRender, signal);
 			return true;
 		} catch {
-			progress?.done();
 			return false;
 		}
 	};
@@ -11175,6 +11188,7 @@ function createSpaKernel(state, config, emit, deps) {
 	*/
 	const navigate = async (pathname, scrollToTop = true, signal) => {
 		pendingScrollToTop = scrollToTop;
+		handleStart(pathname);
 		if (deps.router.mode() !== "ssg" && await tryDataRender(pathname, signal)) return;
 		if (signal?.aborted) return;
 		await performNavigation(pathname, handlers, signal);

package/package.json

@@ -125,5 +125,5 @@
     "test:build-e2e": "bun test src/plugins/build/__tests__/e2e/",
     "test:coverage": "vitest run --project unit --project integration --coverage"
   },
-  "version": "1.12.0"
+  "version": "1.12.2"
 }