@moku-labs/web 1.12.0 → 1.12.1

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"
 		});
 	};
 	/**

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"
 		});
 	};
 	/**

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"
 		});
 	};
 	/**

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.1"
 }