tanstack-router-cache 0.1.4 → 0.1.6

package/dist/index.cjs

@@ -1036,17 +1036,7 @@ function restoreCachedHref(router, href) {
 		resetScroll: false
 	}).catch(() => void 0);
 }
-function isAncestorPathname(ancestorPathname, pathname) {
-	if (ancestorPathname === pathname) return false;
-	if (ancestorPathname === "/") return pathname.startsWith("/");
-	return pathname.startsWith(`${ancestorPathname}/`);
-}
-function getShouldRenderLiveOutlet({ cachedRoutes, bypassCachedPathname, visiblePathname }) {
-	if (visiblePathname === bypassCachedPathname) return true;
-	const visibleRoute = cachedRoutes[visiblePathname];
-	return !isReadyCachedRoute(visibleRoute);
-}
-function renderCachedRoute({ bypassCachedPathname, pathname, route, visiblePathname }) {
+function renderCachedRoute({ bypassCachedPathname, pathname, route, routerPathname }) {
 	if (pathname === bypassCachedPathname) return null;
 	const content = route.matchId && route.routerSnapshot ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CachedOutlet, {
 		matchId: route.matchId,
@@ -1054,18 +1044,18 @@ function renderCachedRoute({ bypassCachedPathname, pathname, route, visiblePathn
 	}) : null;
 	if (!content) return null;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(OffScreen, {
-		mode: visiblePathname === pathname ? "visible" : "hidden",
+		mode: routerPathname === pathname ? "visible" : "hidden",
 		pathname,
 		children: content
 	}, pathname);
 }
-function buildRouteCacheModes(cachedRoutes, visiblePathname) {
+function buildRouteCacheModes(cachedRoutes, routerPathname) {
 	const nextModes = /* @__PURE__ */ new Map();
-	for (const pathname of Object.keys(cachedRoutes)) nextModes.set(pathname, visiblePathname === pathname ? "visible" : "hidden");
+	for (const pathname of Object.keys(cachedRoutes)) nextModes.set(pathname, routerPathname === pathname ? "visible" : "hidden");
 	return nextModes;
 }
 function syncCachedRouteActivityEvents(params) {
-	const nextModes = buildRouteCacheModes(params.cachedRoutes, params.visiblePathname);
+	const nextModes = buildRouteCacheModes(params.cachedRoutes, params.routerPathname);
 	for (const [pathname, mode] of nextModes) {
 		const previousMode = params.previousRouteCacheModes.get(pathname);
 		if (previousMode === void 0 && mode === "hidden") continue;
@@ -1099,7 +1089,6 @@ function RouteCacheManager() {
 	const routerResolvedLocation = (0, _tanstack_react_router.useRouterState)({ select: (state) => state.resolvedLocation ? toRouterLocation(state.resolvedLocation) : void 0 });
 	const resolvedPathname = normalizeCachedRoutePathname(routerResolvedLocation?.pathname ?? routerPathname);
 	const destinationRoute = cachedRoutes[routerPathname];
-	const visiblePathname = routerPathname !== resolvedPathname && (isReadyCachedRoute(destinationRoute) || isAncestorPathname(routerPathname, resolvedPathname)) ? routerPathname : resolvedPathname;
 	const matches = (0, _tanstack_react_router.useMatches)();
 	const childMatches = (0, _tanstack_react_router.useChildMatches)();
 	const router = (0, _tanstack_react_router.useRouter)();
@@ -1167,7 +1156,7 @@ function RouteCacheManager() {
 	(0, react.useLayoutEffect)(() => {
 		const lastVisitedPathname = previousPathnameRef.current;
 		const pendingNavigation = pendingCachedNavigationRef.current;
-		if (pendingNavigation && pendingNavigation.pathname !== routerPathname && visiblePathname !== pendingNavigation.pathname) {
+		if (pendingNavigation && pendingNavigation.pathname !== routerPathname) {
 			eventListener.emit("cachedNavigationCancel", pendingNavigation);
 			pendingCachedNavigationRef.current = null;
 		}
@@ -1183,8 +1172,7 @@ function RouteCacheManager() {
 	}, [
 		destinationRoute,
 		eventListener,
-		routerPathname,
-		visiblePathname
+		routerPathname
 	]);
 	(0, react.useLayoutEffect)(() => {
 		previousRouteCacheModesRef.current ??= /* @__PURE__ */ new Map();
@@ -1192,28 +1180,28 @@ function RouteCacheManager() {
 			cachedRoutes,
 			eventListener,
 			previousRouteCacheModes: previousRouteCacheModesRef.current,
-			visiblePathname
+			routerPathname
 		});
 	}, [
 		cachedRoutes,
 		eventListener,
-		visiblePathname
+		routerPathname
 	]);
 	(0, react.useLayoutEffect)(() => {
-		if (previousVisiblePathnameRef.current === visiblePathname || !cachedRoutes[visiblePathname]) {
-			previousVisiblePathnameRef.current = visiblePathname;
+		if (previousVisiblePathnameRef.current === routerPathname || !cachedRoutes[routerPathname]) {
+			previousVisiblePathnameRef.current = routerPathname;
 			return;
 		}
-		previousVisiblePathnameRef.current = visiblePathname;
-		touchCachedRoutes([visiblePathname]);
+		previousVisiblePathnameRef.current = routerPathname;
+		touchCachedRoutes([routerPathname]);
 	}, [
 		cachedRoutes,
 		touchCachedRoutes,
-		visiblePathname
+		routerPathname
 	]);
 	(0, react.useEffect)(() => {
 		const pendingNavigation = pendingCachedNavigationRef.current;
-		if (visiblePathname !== pendingNavigation?.pathname) return;
+		if (routerPathname !== pendingNavigation?.pathname) return;
 		let firstFrameId = 0;
 		let secondFrameId = 0;
 		firstFrameId = globalThis.requestAnimationFrame(() => {
@@ -1234,7 +1222,7 @@ function RouteCacheManager() {
 			globalThis.cancelAnimationFrame(firstFrameId);
 			globalThis.cancelAnimationFrame(secondFrameId);
 		};
-	}, [eventListener, visiblePathname]);
+	}, [eventListener, routerPathname]);
 	(0, react.useLayoutEffect)(() => {
 		if (!(shouldRestoreDestinationHref && destinationRoute?.href)) return;
 		restoreCachedHref(router, destinationRoute.href);
@@ -1247,17 +1235,13 @@ function RouteCacheManager() {
 		previousPathnameRef.current = routerPathname;
 		previousHrefRef.current = routerHref;
 	}, [routerHref, routerPathname]);
-	const shouldRenderLiveOutlet = getShouldRenderLiveOutlet({
-		cachedRoutes,
-		bypassCachedPathname,
-		visiblePathname
-	});
-	useRouterCacheDebug(cachedRoutes, visiblePathname);
+	const shouldRenderLiveOutlet = routerPathname === bypassCachedPathname || !isReadyCachedRoute(destinationRoute);
+	useRouterCacheDebug(cachedRoutes, routerPathname);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [Object.entries(cachedRoutes).map(([pathname, route]) => renderCachedRoute({
 		bypassCachedPathname,
 		pathname,
 		route,
-		visiblePathname
+		routerPathname
 	})), shouldRenderLiveOutlet ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_tanstack_react_router.Outlet, {}, `live-${routerPathname}`) : null] });
 }
 //#endregion

package/dist/index.js

@@ -1035,17 +1035,7 @@ function restoreCachedHref(router, href) {
 		resetScroll: false
 	}).catch(() => void 0);
 }
-function isAncestorPathname(ancestorPathname, pathname) {
-	if (ancestorPathname === pathname) return false;
-	if (ancestorPathname === "/") return pathname.startsWith("/");
-	return pathname.startsWith(`${ancestorPathname}/`);
-}
-function getShouldRenderLiveOutlet({ cachedRoutes, bypassCachedPathname, visiblePathname }) {
-	if (visiblePathname === bypassCachedPathname) return true;
-	const visibleRoute = cachedRoutes[visiblePathname];
-	return !isReadyCachedRoute(visibleRoute);
-}
-function renderCachedRoute({ bypassCachedPathname, pathname, route, visiblePathname }) {
+function renderCachedRoute({ bypassCachedPathname, pathname, route, routerPathname }) {
 	if (pathname === bypassCachedPathname) return null;
 	const content = route.matchId && route.routerSnapshot ? /* @__PURE__ */ jsx(CachedOutlet, {
 		matchId: route.matchId,
@@ -1053,18 +1043,18 @@ function renderCachedRoute({ bypassCachedPathname, pathname, route, visiblePathn
 	}) : null;
 	if (!content) return null;
 	return /* @__PURE__ */ jsx(OffScreen, {
-		mode: visiblePathname === pathname ? "visible" : "hidden",
+		mode: routerPathname === pathname ? "visible" : "hidden",
 		pathname,
 		children: content
 	}, pathname);
 }
-function buildRouteCacheModes(cachedRoutes, visiblePathname) {
+function buildRouteCacheModes(cachedRoutes, routerPathname) {
 	const nextModes = /* @__PURE__ */ new Map();
-	for (const pathname of Object.keys(cachedRoutes)) nextModes.set(pathname, visiblePathname === pathname ? "visible" : "hidden");
+	for (const pathname of Object.keys(cachedRoutes)) nextModes.set(pathname, routerPathname === pathname ? "visible" : "hidden");
 	return nextModes;
 }
 function syncCachedRouteActivityEvents(params) {
-	const nextModes = buildRouteCacheModes(params.cachedRoutes, params.visiblePathname);
+	const nextModes = buildRouteCacheModes(params.cachedRoutes, params.routerPathname);
 	for (const [pathname, mode] of nextModes) {
 		const previousMode = params.previousRouteCacheModes.get(pathname);
 		if (previousMode === void 0 && mode === "hidden") continue;
@@ -1098,7 +1088,6 @@ function RouteCacheManager() {
 	const routerResolvedLocation = useRouterState({ select: (state) => state.resolvedLocation ? toRouterLocation(state.resolvedLocation) : void 0 });
 	const resolvedPathname = normalizeCachedRoutePathname(routerResolvedLocation?.pathname ?? routerPathname);
 	const destinationRoute = cachedRoutes[routerPathname];
-	const visiblePathname = routerPathname !== resolvedPathname && (isReadyCachedRoute(destinationRoute) || isAncestorPathname(routerPathname, resolvedPathname)) ? routerPathname : resolvedPathname;
 	const matches = useMatches();
 	const childMatches = useChildMatches();
 	const router = useRouter();
@@ -1166,7 +1155,7 @@ function RouteCacheManager() {
 	useLayoutEffect(() => {
 		const lastVisitedPathname = previousPathnameRef.current;
 		const pendingNavigation = pendingCachedNavigationRef.current;
-		if (pendingNavigation && pendingNavigation.pathname !== routerPathname && visiblePathname !== pendingNavigation.pathname) {
+		if (pendingNavigation && pendingNavigation.pathname !== routerPathname) {
 			eventListener.emit("cachedNavigationCancel", pendingNavigation);
 			pendingCachedNavigationRef.current = null;
 		}
@@ -1182,8 +1171,7 @@ function RouteCacheManager() {
 	}, [
 		destinationRoute,
 		eventListener,
-		routerPathname,
-		visiblePathname
+		routerPathname
 	]);
 	useLayoutEffect(() => {
 		previousRouteCacheModesRef.current ??= /* @__PURE__ */ new Map();
@@ -1191,28 +1179,28 @@ function RouteCacheManager() {
 			cachedRoutes,
 			eventListener,
 			previousRouteCacheModes: previousRouteCacheModesRef.current,
-			visiblePathname
+			routerPathname
 		});
 	}, [
 		cachedRoutes,
 		eventListener,
-		visiblePathname
+		routerPathname
 	]);
 	useLayoutEffect(() => {
-		if (previousVisiblePathnameRef.current === visiblePathname || !cachedRoutes[visiblePathname]) {
-			previousVisiblePathnameRef.current = visiblePathname;
+		if (previousVisiblePathnameRef.current === routerPathname || !cachedRoutes[routerPathname]) {
+			previousVisiblePathnameRef.current = routerPathname;
 			return;
 		}
-		previousVisiblePathnameRef.current = visiblePathname;
-		touchCachedRoutes([visiblePathname]);
+		previousVisiblePathnameRef.current = routerPathname;
+		touchCachedRoutes([routerPathname]);
 	}, [
 		cachedRoutes,
 		touchCachedRoutes,
-		visiblePathname
+		routerPathname
 	]);
 	useEffect(() => {
 		const pendingNavigation = pendingCachedNavigationRef.current;
-		if (visiblePathname !== pendingNavigation?.pathname) return;
+		if (routerPathname !== pendingNavigation?.pathname) return;
 		let firstFrameId = 0;
 		let secondFrameId = 0;
 		firstFrameId = globalThis.requestAnimationFrame(() => {
@@ -1233,7 +1221,7 @@ function RouteCacheManager() {
 			globalThis.cancelAnimationFrame(firstFrameId);
 			globalThis.cancelAnimationFrame(secondFrameId);
 		};
-	}, [eventListener, visiblePathname]);
+	}, [eventListener, routerPathname]);
 	useLayoutEffect(() => {
 		if (!(shouldRestoreDestinationHref && destinationRoute?.href)) return;
 		restoreCachedHref(router, destinationRoute.href);
@@ -1246,17 +1234,13 @@ function RouteCacheManager() {
 		previousPathnameRef.current = routerPathname;
 		previousHrefRef.current = routerHref;
 	}, [routerHref, routerPathname]);
-	const shouldRenderLiveOutlet = getShouldRenderLiveOutlet({
-		cachedRoutes,
-		bypassCachedPathname,
-		visiblePathname
-	});
-	useRouterCacheDebug(cachedRoutes, visiblePathname);
+	const shouldRenderLiveOutlet = routerPathname === bypassCachedPathname || !isReadyCachedRoute(destinationRoute);
+	useRouterCacheDebug(cachedRoutes, routerPathname);
 	return /* @__PURE__ */ jsxs(Fragment, { children: [Object.entries(cachedRoutes).map(([pathname, route]) => renderCachedRoute({
 		bypassCachedPathname,
 		pathname,
 		route,
-		visiblePathname
+		routerPathname
 	})), shouldRenderLiveOutlet ? /* @__PURE__ */ jsx(Outlet, {}, `live-${routerPathname}`) : null] });
 }
 //#endregion

package/docs/releases.md

@@ -34,15 +34,23 @@ That updates GitHub and runs CI, but it does not publish to npm.
 For a release, start from a clean `main` branch after your changes are already committed:
 
 ```sh
-bun run release:prepare patch
-bun run release:push
+bun run release patch
 ```
 
 Use `minor`, `major`, or an exact version when needed:
 
 ```sh
-bun run release:prepare minor
-bun run release:prepare 0.2.0
+bun run release minor
+bun run release 0.2.0
+```
+
+`release` updates `package.json`, runs the package checks, commits the version bump, creates the matching tag, pushes `main` and the tag, creates the GitHub Release, waits for the publish workflow, and verifies that npm has the new package version.
+
+The lower-level commands are still available when you need to split the release into two steps:
+
+```sh
+bun run release:prepare patch
+bun run release:push
 ```
 
 `release:prepare` updates `package.json`, runs the package checks, commits the version bump, and creates the matching tag locally. `release:push` pushes `main` and that exact tag. The tag starts the npm publish workflow.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tanstack-router-cache",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Route view caching for TanStack Router.",
   "type": "module",
   "license": "MIT",
@@ -50,6 +50,7 @@
     "lint:fix": "biome lint src scripts .github/scripts rolldown.config.ts --write --skip=lint/performance/noBarrelFile --skip=lint/style/useConsistentTypeDefinitions --skip=lint/suspicious/noConsole",
     "check": "bun run lint && bun run typecheck && bun run build && bun run pack:dry-run",
     "pack:dry-run": "npm pack --dry-run",
+    "release": "node scripts/release.mjs release",
     "release:prepare": "node scripts/release.mjs prepare",
     "release:push": "node scripts/release.mjs push",
     "prepack": "bun run build",
@@ -63,9 +64,9 @@
   "dependencies": {},
   "devDependencies": {
     "@biomejs/biome": "2.4.15",
-    "@tanstack/react-router": "1.170.11",
-    "@types/node": "25.9.1",
-    "@types/react": "19.2.16",
+    "@tanstack/react-router": "1.170.15",
+    "@types/node": "25.9.3",
+    "@types/react": "19.2.17",
     "@types/react-dom": "19.2.3",
     "react": "19.2.7",
     "react-dom": "19.2.7",