@benjavicente/router-core 1.168.9

package/dist/cjs/scroll-restoration-inline.cjs

@@ -0,0 +1,6 @@
+//#region src/scroll-restoration-inline.ts?script-string
+var scroll_restoration_inline_default = "function(t){let s;try{s=JSON.parse(sessionStorage.getItem(t.storageKey)||\"{}\")}catch(e){console.error(e);return}const c=t.key||window.history.state?.__TSR_key,r=c?s[c]:void 0;if(t.shouldScrollRestoration&&r&&typeof r==\"object\"&&Object.keys(r).length>0){for(const e in r){const o=r[e];if(!o||typeof o!=\"object\")continue;const l=o.scrollX,i=o.scrollY;if(!(!Number.isFinite(l)||!Number.isFinite(i))){if(e===\"window\")window.scrollTo({top:i,left:l,behavior:t.behavior});else if(e){let n;try{n=document.querySelector(e)}catch{continue}n&&(n.scrollLeft=l,n.scrollTop=i)}}}return}const a=window.location.hash.split(\"#\",2)[1];if(a){const e=window.history.state?.__hashScrollIntoViewOptions??!0;if(e){const o=document.getElementById(a);o&&o.scrollIntoView(e)}return}window.scrollTo({top:0,left:0,behavior:t.behavior})}";
+//#endregion
+exports.default = scroll_restoration_inline_default;
+
+//# sourceMappingURL=scroll-restoration-inline.cjs.map

package/dist/cjs/scroll-restoration-inline.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-restoration-inline.cjs","names":[],"sources":["../../src/scroll-restoration-inline.ts?script-string"],"sourcesContent":["export default function (options: {\n  storageKey: string\n  key?: string\n  behavior?: ScrollToOptions['behavior']\n  shouldScrollRestoration?: boolean\n}) {\n  let byKey\n\n  try {\n    byKey = JSON.parse(sessionStorage.getItem(options.storageKey) || '{}')\n  } catch (error) {\n    console.error(error)\n    return\n  }\n\n  const resolvedKey = options.key || window.history.state?.__TSR_key\n  const elementEntries = resolvedKey ? byKey[resolvedKey] : undefined\n\n  if (\n    options.shouldScrollRestoration &&\n    elementEntries &&\n    typeof elementEntries === 'object' &&\n    Object.keys(elementEntries).length > 0\n  ) {\n    for (const elementSelector in elementEntries) {\n      const entry = elementEntries[elementSelector]\n\n      if (!entry || typeof entry !== 'object') {\n        continue\n      }\n\n      const scrollX = entry.scrollX\n      const scrollY = entry.scrollY\n\n      if (!Number.isFinite(scrollX) || !Number.isFinite(scrollY)) {\n        continue\n      }\n\n      if (elementSelector === 'window') {\n        window.scrollTo({\n          top: scrollY,\n          left: scrollX,\n          behavior: options.behavior,\n        })\n      } else if (elementSelector) {\n        let element\n\n        try {\n          element = document.querySelector(elementSelector)\n        } catch {\n          continue\n        }\n\n        if (element) {\n          element.scrollLeft = scrollX\n          element.scrollTop = scrollY\n        }\n      }\n    }\n\n    return\n  }\n\n  const hash = window.location.hash.split('#', 2)[1]\n\n  if (hash) {\n    const hashScrollIntoViewOptions =\n      window.history.state?.__hashScrollIntoViewOptions ?? true\n\n    if (hashScrollIntoViewOptions) {\n      const el = document.getElementById(hash)\n      if (el) {\n        el.scrollIntoView(hashScrollIntoViewOptions)\n      }\n    }\n\n    return\n  }\n\n  window.scrollTo({ top: 0, left: 0, behavior: options.behavior })\n}\n"],"mappings":";AAAA,IAAA,oCAAe"}

package/dist/cjs/scroll-restoration-inline.d.cts

@@ -0,0 +1,6 @@
+export default function (options: {
+    storageKey: string;
+    key?: string;
+    behavior?: ScrollToOptions['behavior'];
+    shouldScrollRestoration?: boolean;
+}): void;

package/dist/cjs/scroll-restoration-script/client.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/scroll-restoration-script/client.ts
+function getScrollRestorationScriptForRouter(_router) {
+	return null;
+}
+//#endregion
+exports.getScrollRestorationScriptForRouter = getScrollRestorationScriptForRouter;
+
+//# sourceMappingURL=client.cjs.map

package/dist/cjs/scroll-restoration-script/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.cjs","names":[],"sources":["../../../src/scroll-restoration-script/client.ts"],"sourcesContent":["import type { AnyRouter } from '../router'\n\nexport function getScrollRestorationScriptForRouter(_router: AnyRouter) {\n  return null\n}\n"],"mappings":";;AAEA,SAAgB,oCAAoC,SAAoB;AACtE,QAAO"}

package/dist/cjs/scroll-restoration-script/client.d.cts

@@ -0,0 +1,2 @@
+import { AnyRouter } from '../router.cjs';
+export declare function getScrollRestorationScriptForRouter(_router: AnyRouter): null;

package/dist/cjs/scroll-restoration-script/server.cjs

@@ -0,0 +1,30 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_utils = require("../utils.cjs");
+const require_scroll_restoration = require("../scroll-restoration.cjs");
+const require_scroll_restoration_inline = require("../scroll-restoration-inline.cjs");
+//#region src/scroll-restoration-script/server.ts
+var defaultInlineScrollRestorationScript = `(${require_scroll_restoration_inline.default})(${require_utils.escapeHtml(JSON.stringify({
+	storageKey: require_scroll_restoration.storageKey,
+	shouldScrollRestoration: true
+}))})`;
+function getScrollRestorationScript(options) {
+	if (options.storageKey === "tsr-scroll-restoration-v1_3" && options.shouldScrollRestoration === true && options.key === void 0 && options.behavior === void 0) return defaultInlineScrollRestorationScript;
+	return `(${require_scroll_restoration_inline.default})(${require_utils.escapeHtml(JSON.stringify(options))})`;
+}
+function getScrollRestorationScriptForRouter(router) {
+	if (typeof router.options.scrollRestoration === "function" && !router.options.scrollRestoration({ location: router.latestLocation })) return null;
+	const getKey = router.options.getScrollRestorationKey;
+	if (!getKey) return defaultInlineScrollRestorationScript;
+	const location = router.latestLocation;
+	const userKey = getKey(location);
+	if (userKey === require_scroll_restoration.defaultGetScrollRestorationKey(location)) return defaultInlineScrollRestorationScript;
+	return getScrollRestorationScript({
+		storageKey: require_scroll_restoration.storageKey,
+		shouldScrollRestoration: true,
+		key: userKey
+	});
+}
+//#endregion
+exports.getScrollRestorationScriptForRouter = getScrollRestorationScriptForRouter;
+
+//# sourceMappingURL=server.cjs.map

package/dist/cjs/scroll-restoration-script/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.cjs","names":[],"sources":["../../../src/scroll-restoration-script/server.ts"],"sourcesContent":["import minifiedScrollRestorationScript from '../scroll-restoration-inline?script-string'\nimport {\n  defaultGetScrollRestorationKey,\n  storageKey,\n} from '../scroll-restoration'\nimport { escapeHtml } from '../utils'\nimport type { AnyRouter } from '../router'\n\ntype InlineScrollRestorationScriptOptions = {\n  storageKey: string\n  key?: string\n  behavior?: ScrollToOptions['behavior']\n  shouldScrollRestoration?: boolean\n}\n\nconst defaultInlineScrollRestorationScript = `(${minifiedScrollRestorationScript})(${escapeHtml(\n  JSON.stringify({\n    storageKey,\n    shouldScrollRestoration: true,\n  } satisfies InlineScrollRestorationScriptOptions),\n)})`\n\nfunction getScrollRestorationScript(\n  options: InlineScrollRestorationScriptOptions,\n) {\n  if (\n    options.storageKey === storageKey &&\n    options.shouldScrollRestoration === true &&\n    options.key === undefined &&\n    options.behavior === undefined\n  ) {\n    return defaultInlineScrollRestorationScript\n  }\n\n  return `(${minifiedScrollRestorationScript})(${escapeHtml(JSON.stringify(options))})`\n}\n\nexport function getScrollRestorationScriptForRouter(router: AnyRouter) {\n  if (\n    typeof router.options.scrollRestoration === 'function' &&\n    !router.options.scrollRestoration({ location: router.latestLocation })\n  ) {\n    return null\n  }\n\n  const getKey = router.options.getScrollRestorationKey\n  if (!getKey) {\n    return defaultInlineScrollRestorationScript\n  }\n\n  const location = router.latestLocation\n  const userKey = getKey(location)\n  const defaultKey = defaultGetScrollRestorationKey(location)\n\n  if (userKey === defaultKey) {\n    return defaultInlineScrollRestorationScript\n  }\n\n  return getScrollRestorationScript({\n    storageKey,\n    shouldScrollRestoration: true,\n    key: userKey,\n  })\n}\n"],"mappings":";;;;;AAeA,IAAM,uCAAuC,IAAI,kCAAA,QAAgC,IAAI,cAAA,WACnF,KAAK,UAAU;CACb,YAAA,2BAAA;CACA,yBAAyB;CAC1B,CAAgD,CAClD,CAAC;AAEF,SAAS,2BACP,SACA;AACA,KACE,QAAQ,eAAA,iCACR,QAAQ,4BAA4B,QACpC,QAAQ,QAAQ,KAAA,KAChB,QAAQ,aAAa,KAAA,EAErB,QAAO;AAGT,QAAO,IAAI,kCAAA,QAAgC,IAAI,cAAA,WAAW,KAAK,UAAU,QAAQ,CAAC,CAAC;;AAGrF,SAAgB,oCAAoC,QAAmB;AACrE,KACE,OAAO,OAAO,QAAQ,sBAAsB,cAC5C,CAAC,OAAO,QAAQ,kBAAkB,EAAE,UAAU,OAAO,gBAAgB,CAAC,CAEtE,QAAO;CAGT,MAAM,SAAS,OAAO,QAAQ;AAC9B,KAAI,CAAC,OACH,QAAO;CAGT,MAAM,WAAW,OAAO;CACxB,MAAM,UAAU,OAAO,SAAS;AAGhC,KAAI,YAFe,2BAAA,+BAA+B,SAAS,CAGzD,QAAO;AAGT,QAAO,2BAA2B;EAChC,YAAA,2BAAA;EACA,yBAAyB;EACzB,KAAK;EACN,CAAC"}

package/dist/cjs/scroll-restoration-script/server.d.cts

@@ -0,0 +1,2 @@
+import { AnyRouter } from '../router.cjs';
+export declare function getScrollRestorationScriptForRouter(router: AnyRouter): string | null;

package/dist/cjs/scroll-restoration.cjs

@@ -0,0 +1,191 @@
+const require_utils = require("./utils.cjs");
+let _benjavicente_router_core_isServer = require("@benjavicente/router-core/isServer");
+//#region src/scroll-restoration.ts
+function getSafeSessionStorage() {
+	try {
+		return typeof window !== "undefined" && typeof window.sessionStorage === "object" ? window.sessionStorage : void 0;
+	} catch {
+		return;
+	}
+}
+var storageKey = "tsr-scroll-restoration-v1_3";
+function createScrollRestorationCache() {
+	const safeSessionStorage = getSafeSessionStorage();
+	if (!safeSessionStorage) return null;
+	let state = {};
+	try {
+		const parsed = JSON.parse(safeSessionStorage.getItem("tsr-scroll-restoration-v1_3") || "{}");
+		if (require_utils.isPlainObject(parsed)) state = parsed;
+	} catch {}
+	const persist = () => {
+		try {
+			safeSessionStorage.setItem(storageKey, JSON.stringify(state));
+		} catch {
+			if (process.env.NODE_ENV !== "production") console.warn("[ts-router] Could not persist scroll restoration state to sessionStorage.");
+		}
+	};
+	return {
+		get state() {
+			return state;
+		},
+		set: (updater) => {
+			state = require_utils.functionalUpdate(updater, state) || state;
+		},
+		persist
+	};
+}
+var scrollRestorationCache = createScrollRestorationCache();
+/**
+* The default `getKey` function for `useScrollRestoration`.
+* It returns the `key` from the location state or the `href` of the location.
+*
+* The `location.href` is used as a fallback to support the use case where the location state is not available like the initial render.
+*/
+var defaultGetScrollRestorationKey = (location) => {
+	return location.state.__TSR_key || location.href;
+};
+function getCssSelector(el) {
+	const path = [];
+	let parent;
+	while (parent = el.parentNode) {
+		path.push(`${el.tagName}:nth-child(${Array.prototype.indexOf.call(parent.children, el) + 1})`);
+		el = parent;
+	}
+	return `${path.reverse().join(" > ")}`.toLowerCase();
+}
+function getElementScrollRestorationEntry(router, options) {
+	const restoreKey = (options.getKey || defaultGetScrollRestorationKey)(router.latestLocation);
+	if (options.id) return scrollRestorationCache?.state[restoreKey]?.[`[${scrollRestorationIdAttribute}="${options.id}"]`];
+	const element = options.getElement?.();
+	if (!element) return;
+	return scrollRestorationCache?.state[restoreKey]?.[element instanceof Window ? windowScrollTarget : getCssSelector(element)];
+}
+var ignoreScroll = false;
+var windowScrollTarget = "window";
+var scrollRestorationIdAttribute = "data-scroll-restoration-id";
+function setupScrollRestoration(router, force) {
+	if (!scrollRestorationCache && !(_benjavicente_router_core_isServer.isServer ?? router.isServer)) return;
+	const cache = scrollRestorationCache;
+	if (force ?? router.options.scrollRestoration ?? false) router.isScrollRestoring = true;
+	if ((_benjavicente_router_core_isServer.isServer ?? router.isServer) || router.isScrollRestorationSetup || !cache) return;
+	router.isScrollRestorationSetup = true;
+	ignoreScroll = false;
+	const getKey = router.options.getScrollRestorationKey || defaultGetScrollRestorationKey;
+	const trackedScrollEntries = /* @__PURE__ */ new Map();
+	window.history.scrollRestoration = "manual";
+	const onScroll = (event) => {
+		if (ignoreScroll || !router.isScrollRestoring) return;
+		if (event.target === document || event.target === window) trackedScrollEntries.set(windowScrollTarget, {
+			scrollX: window.scrollX || 0,
+			scrollY: window.scrollY || 0
+		});
+		else {
+			const target = event.target;
+			trackedScrollEntries.set(target, {
+				scrollX: target.scrollLeft || 0,
+				scrollY: target.scrollTop || 0
+			});
+		}
+	};
+	const snapshotCurrentScrollTargets = (restoreKey) => {
+		if (!router.isScrollRestoring || !restoreKey || trackedScrollEntries.size === 0 || !cache) return;
+		const keyEntry = cache.state[restoreKey] ||= {};
+		for (const [target, position] of trackedScrollEntries) {
+			let selector;
+			if (target === windowScrollTarget) selector = windowScrollTarget;
+			else if (target.isConnected) {
+				const attrId = target.getAttribute(scrollRestorationIdAttribute);
+				selector = attrId ? `[${scrollRestorationIdAttribute}="${attrId}"]` : getCssSelector(target);
+			}
+			if (!selector) continue;
+			keyEntry[selector] = position;
+		}
+	};
+	document.addEventListener("scroll", onScroll, true);
+	router.subscribe("onBeforeLoad", (event) => {
+		snapshotCurrentScrollTargets(event.fromLocation ? getKey(event.fromLocation) : void 0);
+		trackedScrollEntries.clear();
+	});
+	window.addEventListener("pagehide", () => {
+		snapshotCurrentScrollTargets(getKey(router.stores.resolvedLocation.state ?? router.stores.location.state));
+		cache.persist();
+	});
+	router.subscribe("onRendered", (event) => {
+		const cacheKey = getKey(event.toLocation);
+		const behavior = router.options.scrollRestorationBehavior;
+		const scrollToTopSelectors = router.options.scrollToTopSelectors;
+		trackedScrollEntries.clear();
+		if (!router.resetNextScroll) {
+			router.resetNextScroll = true;
+			return;
+		}
+		if (typeof router.options.scrollRestoration === "function" && !router.options.scrollRestoration({ location: router.latestLocation })) return;
+		ignoreScroll = true;
+		try {
+			const elementEntries = router.isScrollRestoring ? cache.state[cacheKey] : void 0;
+			let restored = false;
+			if (elementEntries) for (const elementSelector in elementEntries) {
+				const entry = elementEntries[elementSelector];
+				if (!require_utils.isPlainObject(entry)) continue;
+				const { scrollX, scrollY } = entry;
+				if (!Number.isFinite(scrollX) || !Number.isFinite(scrollY)) continue;
+				if (elementSelector === windowScrollTarget) {
+					window.scrollTo({
+						top: scrollY,
+						left: scrollX,
+						behavior
+					});
+					restored = true;
+				} else if (elementSelector) {
+					let element;
+					try {
+						element = document.querySelector(elementSelector);
+					} catch {
+						continue;
+					}
+					if (element) {
+						element.scrollLeft = scrollX;
+						element.scrollTop = scrollY;
+						restored = true;
+					}
+				}
+			}
+			if (!restored) {
+				const hash = router.history.location.hash.slice(1);
+				if (hash) {
+					const hashScrollIntoViewOptions = window.history.state?.__hashScrollIntoViewOptions ?? true;
+					if (hashScrollIntoViewOptions) {
+						const el = document.getElementById(hash);
+						if (el) el.scrollIntoView(hashScrollIntoViewOptions);
+					}
+				} else {
+					const scrollOptions = {
+						top: 0,
+						left: 0,
+						behavior
+					};
+					window.scrollTo(scrollOptions);
+					if (scrollToTopSelectors) for (const selector of scrollToTopSelectors) {
+						if (selector === windowScrollTarget) continue;
+						const element = typeof selector === "function" ? selector() : document.querySelector(selector);
+						if (element) element.scrollTo(scrollOptions);
+					}
+				}
+			}
+		} finally {
+			ignoreScroll = false;
+		}
+		if (router.isScrollRestoring) cache.set((state) => {
+			state[cacheKey] ||= {};
+			return state;
+		});
+	});
+}
+//#endregion
+exports.defaultGetScrollRestorationKey = defaultGetScrollRestorationKey;
+exports.getElementScrollRestorationEntry = getElementScrollRestorationEntry;
+exports.scrollRestorationCache = scrollRestorationCache;
+exports.setupScrollRestoration = setupScrollRestoration;
+exports.storageKey = storageKey;
+
+//# sourceMappingURL=scroll-restoration.cjs.map

package/dist/cjs/scroll-restoration.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-restoration.cjs","names":[],"sources":["../../src/scroll-restoration.ts"],"sourcesContent":["import { isServer } from '@benjavicente/router-core/isServer'\nimport { functionalUpdate, isPlainObject } from './utils'\nimport type { AnyRouter } from './router'\nimport type { ParsedLocation } from './location'\nimport type { NonNullableUpdater } from './utils'\n\nexport type ScrollRestorationEntry = { scrollX: number; scrollY: number }\n\ntype ScrollRestorationByElement = Record<string, ScrollRestorationEntry>\n\ntype ScrollRestorationByKey = Record<string, ScrollRestorationByElement>\n\ntype ScrollRestorationCache = {\n  readonly state: ScrollRestorationByKey\n  set: (updater: NonNullableUpdater<ScrollRestorationByKey>) => void\n  persist: () => void\n}\n\nexport type ScrollRestorationOptions = {\n  getKey?: (location: ParsedLocation) => string\n  scrollBehavior?: ScrollToOptions['behavior']\n}\n\nfunction getSafeSessionStorage() {\n  try {\n    return typeof window !== 'undefined' &&\n      typeof window.sessionStorage === 'object'\n      ? window.sessionStorage\n      : undefined\n  } catch {\n    // silent\n    return undefined\n  }\n}\n\n// SessionStorage key used to store scroll positions across navigations.\nexport const storageKey = 'tsr-scroll-restoration-v1_3'\n\nfunction createScrollRestorationCache(): ScrollRestorationCache | null {\n  const safeSessionStorage = getSafeSessionStorage()\n  if (!safeSessionStorage) {\n    return null\n  }\n\n  let state: ScrollRestorationByKey = {}\n\n  try {\n    const parsed = JSON.parse(safeSessionStorage.getItem(storageKey) || '{}')\n    if (isPlainObject(parsed)) {\n      state = parsed as ScrollRestorationByKey\n    }\n  } catch {\n    // ignore invalid session storage payloads\n  }\n\n  const persist = () => {\n    try {\n      safeSessionStorage.setItem(storageKey, JSON.stringify(state))\n    } catch {\n      if (process.env.NODE_ENV !== 'production') {\n        console.warn(\n          '[ts-router] Could not persist scroll restoration state to sessionStorage.',\n        )\n      }\n    }\n  }\n\n  return {\n    get state() {\n      return state\n    },\n    set: (updater) => {\n      state = functionalUpdate(updater, state) || state\n    },\n    persist,\n  }\n}\n\nexport const scrollRestorationCache = createScrollRestorationCache()\n\n/**\n * The default `getKey` function for `useScrollRestoration`.\n * It returns the `key` from the location state or the `href` of the location.\n *\n * The `location.href` is used as a fallback to support the use case where the location state is not available like the initial render.\n */\nexport const defaultGetScrollRestorationKey = (location: ParsedLocation) => {\n  return location.state.__TSR_key! || location.href\n}\n\nfunction getCssSelector(el: any): string {\n  const path = []\n  let parent: HTMLElement\n  while ((parent = el.parentNode)) {\n    path.push(\n      `${el.tagName}:nth-child(${Array.prototype.indexOf.call(parent.children, el) + 1})`,\n    )\n    el = parent\n  }\n  return `${path.reverse().join(' > ')}`.toLowerCase()\n}\n\nexport function getElementScrollRestorationEntry(\n  router: AnyRouter,\n  options: (\n    | {\n        id: string\n        getElement?: () => Window | Element | undefined | null\n      }\n    | {\n        id?: string\n        getElement: () => Window | Element | undefined | null\n      }\n  ) & {\n    getKey?: (location: ParsedLocation) => string\n  },\n): ScrollRestorationEntry | undefined {\n  const getKey = options.getKey || defaultGetScrollRestorationKey\n  const restoreKey = getKey(router.latestLocation)\n\n  if (options.id) {\n    return scrollRestorationCache?.state[restoreKey]?.[\n      `[${scrollRestorationIdAttribute}=\"${options.id}\"]`\n    ]\n  }\n\n  const element = options.getElement?.()\n  if (!element) {\n    return\n  }\n\n  return scrollRestorationCache?.state[restoreKey]?.[\n    element instanceof Window ? windowScrollTarget : getCssSelector(element)\n  ]\n}\n\nlet ignoreScroll = false\nconst windowScrollTarget = 'window'\nconst scrollRestorationIdAttribute = 'data-scroll-restoration-id'\ntype ScrollTarget = typeof windowScrollTarget | Element\n\nexport function setupScrollRestoration(router: AnyRouter, force?: boolean) {\n  if (!scrollRestorationCache && !(isServer ?? router.isServer)) {\n    return\n  }\n\n  const cache = scrollRestorationCache\n\n  const shouldScrollRestoration =\n    force ?? router.options.scrollRestoration ?? false\n\n  if (shouldScrollRestoration) {\n    router.isScrollRestoring = true\n  }\n\n  if (\n    (isServer ?? router.isServer) ||\n    router.isScrollRestorationSetup ||\n    !cache\n  ) {\n    return\n  }\n\n  router.isScrollRestorationSetup = true\n  ignoreScroll = false\n\n  const getKey =\n    router.options.getScrollRestorationKey || defaultGetScrollRestorationKey\n  const trackedScrollEntries = new Map<ScrollTarget, ScrollRestorationEntry>()\n\n  window.history.scrollRestoration = 'manual'\n\n  const onScroll = (event: Event) => {\n    if (ignoreScroll || !router.isScrollRestoring) {\n      return\n    }\n\n    if (event.target === document || event.target === window) {\n      trackedScrollEntries.set(windowScrollTarget, {\n        scrollX: window.scrollX || 0,\n        scrollY: window.scrollY || 0,\n      })\n    } else {\n      const target = event.target as Element\n      trackedScrollEntries.set(target, {\n        scrollX: target.scrollLeft || 0,\n        scrollY: target.scrollTop || 0,\n      })\n    }\n  }\n\n  // Snapshot the current page's tracked scroll targets before navigation or unload.\n  const snapshotCurrentScrollTargets = (restoreKey?: string) => {\n    if (\n      !router.isScrollRestoring ||\n      !restoreKey ||\n      trackedScrollEntries.size === 0 ||\n      !cache\n    ) {\n      return\n    }\n\n    const keyEntry = (cache.state[restoreKey] ||=\n      {} as ScrollRestorationByElement)\n\n    for (const [target, position] of trackedScrollEntries) {\n      let selector: string | undefined\n\n      if (target === windowScrollTarget) {\n        selector = windowScrollTarget\n      } else if (target.isConnected) {\n        const attrId = target.getAttribute(scrollRestorationIdAttribute)\n        selector = attrId\n          ? `[${scrollRestorationIdAttribute}=\"${attrId}\"]`\n          : getCssSelector(target)\n      }\n\n      if (!selector) {\n        continue\n      }\n\n      keyEntry[selector] = position\n    }\n  }\n\n  document.addEventListener('scroll', onScroll, true)\n  router.subscribe('onBeforeLoad', (event) => {\n    snapshotCurrentScrollTargets(\n      event.fromLocation ? getKey(event.fromLocation) : undefined,\n    )\n    trackedScrollEntries.clear()\n  })\n  window.addEventListener('pagehide', () => {\n    snapshotCurrentScrollTargets(\n      getKey(\n        router.stores.resolvedLocation.state ?? router.stores.location.state,\n      ),\n    )\n    cache.persist()\n  })\n\n  // Restore destination scroll after the new route has rendered.\n  router.subscribe('onRendered', (event) => {\n    const cacheKey = getKey(event.toLocation)\n    const behavior = router.options.scrollRestorationBehavior\n    const scrollToTopSelectors = router.options.scrollToTopSelectors\n    trackedScrollEntries.clear()\n\n    if (!router.resetNextScroll) {\n      router.resetNextScroll = true\n      return\n    }\n\n    if (\n      typeof router.options.scrollRestoration === 'function' &&\n      !router.options.scrollRestoration({ location: router.latestLocation })\n    ) {\n      return\n    }\n\n    ignoreScroll = true\n\n    try {\n      const elementEntries = router.isScrollRestoring\n        ? cache.state[cacheKey]\n        : undefined\n      let restored = false\n\n      if (elementEntries) {\n        for (const elementSelector in elementEntries) {\n          const entry = elementEntries[elementSelector]\n\n          if (!isPlainObject(entry)) {\n            continue\n          }\n\n          const { scrollX, scrollY } = entry as {\n            scrollX?: unknown\n            scrollY?: unknown\n          }\n\n          if (!Number.isFinite(scrollX) || !Number.isFinite(scrollY)) {\n            continue\n          }\n\n          if (elementSelector === windowScrollTarget) {\n            window.scrollTo({\n              top: scrollY as number,\n              left: scrollX as number,\n              behavior,\n            })\n            restored = true\n          } else if (elementSelector) {\n            let element\n\n            try {\n              element = document.querySelector(elementSelector)\n            } catch {\n              continue\n            }\n\n            if (element) {\n              element.scrollLeft = scrollX as number\n              element.scrollTop = scrollY as number\n              restored = true\n            }\n          }\n        }\n      }\n\n      if (!restored) {\n        const hash = router.history.location.hash.slice(1)\n\n        if (hash) {\n          const hashScrollIntoViewOptions =\n            window.history.state?.__hashScrollIntoViewOptions ?? true\n\n          if (hashScrollIntoViewOptions) {\n            const el = document.getElementById(hash)\n            if (el) {\n              el.scrollIntoView(hashScrollIntoViewOptions)\n            }\n          }\n        } else {\n          const scrollOptions = {\n            top: 0,\n            left: 0,\n            behavior,\n          }\n\n          window.scrollTo(scrollOptions)\n          if (scrollToTopSelectors) {\n            for (const selector of scrollToTopSelectors) {\n              if (selector === windowScrollTarget) continue\n              const element =\n                typeof selector === 'function'\n                  ? selector()\n                  : document.querySelector(selector)\n              if (element) {\n                element.scrollTo(scrollOptions)\n              }\n            }\n          }\n        }\n      }\n    } finally {\n      ignoreScroll = false\n    }\n\n    if (router.isScrollRestoring) {\n      cache.set((state) => {\n        state[cacheKey] ||= {} as ScrollRestorationByElement\n        return state\n      })\n    }\n  })\n}\n"],"mappings":"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"}

package/dist/cjs/scroll-restoration.d.cts

@@ -0,0 +1,38 @@
+import { AnyRouter } from './router.cjs';
+import { ParsedLocation } from './location.cjs';
+import { NonNullableUpdater } from './utils.cjs';
+export type ScrollRestorationEntry = {
+    scrollX: number;
+    scrollY: number;
+};
+type ScrollRestorationByElement = Record<string, ScrollRestorationEntry>;
+type ScrollRestorationByKey = Record<string, ScrollRestorationByElement>;
+type ScrollRestorationCache = {
+    readonly state: ScrollRestorationByKey;
+    set: (updater: NonNullableUpdater<ScrollRestorationByKey>) => void;
+    persist: () => void;
+};
+export type ScrollRestorationOptions = {
+    getKey?: (location: ParsedLocation) => string;
+    scrollBehavior?: ScrollToOptions['behavior'];
+};
+export declare const storageKey = "tsr-scroll-restoration-v1_3";
+export declare const scrollRestorationCache: ScrollRestorationCache | null;
+/**
+ * The default `getKey` function for `useScrollRestoration`.
+ * It returns the `key` from the location state or the `href` of the location.
+ *
+ * The `location.href` is used as a fallback to support the use case where the location state is not available like the initial render.
+ */
+export declare const defaultGetScrollRestorationKey: (location: ParsedLocation) => string;
+export declare function getElementScrollRestorationEntry(router: AnyRouter, options: ({
+    id: string;
+    getElement?: () => Window | Element | undefined | null;
+} | {
+    id?: string;
+    getElement: () => Window | Element | undefined | null;
+}) & {
+    getKey?: (location: ParsedLocation) => string;
+}): ScrollRestorationEntry | undefined;
+export declare function setupScrollRestoration(router: AnyRouter, force?: boolean): void;
+export {};

package/dist/cjs/searchMiddleware.cjs

@@ -0,0 +1,55 @@
+const require_utils = require("./utils.cjs");
+//#region src/searchMiddleware.ts
+/**
+* Retain specified search params across navigations.
+*
+* If `keys` is `true`, retain all current params. Otherwise, copy only the
+* listed keys from the current search into the next search.
+*
+* @param keys `true` to retain all, or a list of keys to retain.
+* @returns A search middleware suitable for route `search.middlewares`.
+* @link https://tanstack.com/router/latest/docs/framework/react/api/router/retainSearchParamsFunction
+*/
+function retainSearchParams(keys) {
+	return ({ search, next }) => {
+		const result = next(search);
+		if (keys === true) return {
+			...search,
+			...result
+		};
+		const copy = { ...result };
+		keys.forEach((key) => {
+			if (!(key in copy)) copy[key] = search[key];
+		});
+		return copy;
+	};
+}
+/**
+* Remove optional or default-valued search params from navigations.
+*
+* - Pass `true` (only if there are no required search params) to strip all.
+* - Pass an array to always remove those optional keys.
+* - Pass an object of default values; keys equal (deeply) to the defaults are removed.
+*
+* @returns A search middleware suitable for route `search.middlewares`.
+* @link https://tanstack.com/router/latest/docs/framework/react/api/router/stripSearchParamsFunction
+*/
+function stripSearchParams(input) {
+	return ({ search, next }) => {
+		if (input === true) return {};
+		const result = next(search);
+		const newResult = { ...result };
+		if (Array.isArray(input)) input.forEach((key) => {
+			delete newResult[key];
+		});
+		else Object.entries(input).forEach(([key, value]) => {
+			if (require_utils.deepEqual(result[key], value)) delete newResult[key];
+		});
+		return newResult;
+	};
+}
+//#endregion
+exports.retainSearchParams = retainSearchParams;
+exports.stripSearchParams = stripSearchParams;
+
+//# sourceMappingURL=searchMiddleware.cjs.map

package/dist/cjs/searchMiddleware.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchMiddleware.cjs","names":[],"sources":["../../src/searchMiddleware.ts"],"sourcesContent":["import { deepEqual } from './utils'\nimport type { NoInfer, PickOptional } from './utils'\nimport type { SearchMiddleware } from './route'\nimport type { IsRequiredParams } from './link'\n\n/**\n * Retain specified search params across navigations.\n *\n * If `keys` is `true`, retain all current params. Otherwise, copy only the\n * listed keys from the current search into the next search.\n *\n * @param keys `true` to retain all, or a list of keys to retain.\n * @returns A search middleware suitable for route `search.middlewares`.\n * @link https://tanstack.com/router/latest/docs/framework/react/api/router/retainSearchParamsFunction\n */\nexport function retainSearchParams<TSearchSchema extends object>(\n  keys: Array<keyof TSearchSchema> | true,\n): SearchMiddleware<TSearchSchema> {\n  return ({ search, next }) => {\n    const result = next(search)\n    if (keys === true) {\n      return { ...search, ...result }\n    }\n    const copy = { ...result }\n    // add missing keys from search to copy\n    keys.forEach((key) => {\n      if (!(key in copy)) {\n        copy[key] = search[key]\n      }\n    })\n    return copy\n  }\n}\n\n/**\n * Remove optional or default-valued search params from navigations.\n *\n * - Pass `true` (only if there are no required search params) to strip all.\n * - Pass an array to always remove those optional keys.\n * - Pass an object of default values; keys equal (deeply) to the defaults are removed.\n *\n * @returns A search middleware suitable for route `search.middlewares`.\n * @link https://tanstack.com/router/latest/docs/framework/react/api/router/stripSearchParamsFunction\n */\nexport function stripSearchParams<\n  TSearchSchema,\n  TOptionalProps = PickOptional<NoInfer<TSearchSchema>>,\n  const TValues =\n    | Partial<NoInfer<TOptionalProps>>\n    | Array<keyof TOptionalProps>,\n  const TInput = IsRequiredParams<TSearchSchema> extends never\n    ? TValues | true\n    : TValues,\n>(input: NoInfer<TInput>): SearchMiddleware<TSearchSchema> {\n  return ({ search, next }) => {\n    if (input === true) {\n      return {}\n    }\n    const result = next(search) as Record<string, unknown>\n    const newResult = { ...result }\n    if (Array.isArray(input)) {\n      input.forEach((key) => {\n        delete newResult[key]\n      })\n    } else {\n      Object.entries(input as Record<string, unknown>).forEach(\n        ([key, value]) => {\n          if (deepEqual(result[key], value)) {\n            delete newResult[key]\n          }\n        },\n      )\n    }\n    return newResult as any\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAeA,SAAgB,mBACd,MACiC;AACjC,SAAQ,EAAE,QAAQ,WAAW;EAC3B,MAAM,SAAS,KAAK,OAAO;AAC3B,MAAI,SAAS,KACX,QAAO;GAAE,GAAG;GAAQ,GAAG;GAAQ;EAEjC,MAAM,OAAO,EAAE,GAAG,QAAQ;AAE1B,OAAK,SAAS,QAAQ;AACpB,OAAI,EAAE,OAAO,MACX,MAAK,OAAO,OAAO;IAErB;AACF,SAAO;;;;;;;;;;;;;AAcX,SAAgB,kBASd,OAAyD;AACzD,SAAQ,EAAE,QAAQ,WAAW;AAC3B,MAAI,UAAU,KACZ,QAAO,EAAE;EAEX,MAAM,SAAS,KAAK,OAAO;EAC3B,MAAM,YAAY,EAAE,GAAG,QAAQ;AAC/B,MAAI,MAAM,QAAQ,MAAM,CACtB,OAAM,SAAS,QAAQ;AACrB,UAAO,UAAU;IACjB;MAEF,QAAO,QAAQ,MAAiC,CAAC,SAC9C,CAAC,KAAK,WAAW;AAChB,OAAI,cAAA,UAAU,OAAO,MAAM,MAAM,CAC/B,QAAO,UAAU;IAGtB;AAEH,SAAO"}

package/dist/cjs/searchMiddleware.d.cts

@@ -0,0 +1,25 @@
+import { NoInfer, PickOptional } from './utils.cjs';
+import { SearchMiddleware } from './route.cjs';
+import { IsRequiredParams } from './link.cjs';
+/**
+ * Retain specified search params across navigations.
+ *
+ * If `keys` is `true`, retain all current params. Otherwise, copy only the
+ * listed keys from the current search into the next search.
+ *
+ * @param keys `true` to retain all, or a list of keys to retain.
+ * @returns A search middleware suitable for route `search.middlewares`.
+ * @link https://tanstack.com/router/latest/docs/framework/react/api/router/retainSearchParamsFunction
+ */
+export declare function retainSearchParams<TSearchSchema extends object>(keys: Array<keyof TSearchSchema> | true): SearchMiddleware<TSearchSchema>;
+/**
+ * Remove optional or default-valued search params from navigations.
+ *
+ * - Pass `true` (only if there are no required search params) to strip all.
+ * - Pass an array to always remove those optional keys.
+ * - Pass an object of default values; keys equal (deeply) to the defaults are removed.
+ *
+ * @returns A search middleware suitable for route `search.middlewares`.
+ * @link https://tanstack.com/router/latest/docs/framework/react/api/router/stripSearchParamsFunction
+ */
+export declare function stripSearchParams<TSearchSchema, TOptionalProps = PickOptional<NoInfer<TSearchSchema>>, const TValues = Partial<NoInfer<TOptionalProps>> | Array<keyof TOptionalProps>, const TInput = IsRequiredParams<TSearchSchema> extends never ? TValues | true : TValues>(input: NoInfer<TInput>): SearchMiddleware<TSearchSchema>;

package/dist/cjs/searchParams.cjs

@@ -0,0 +1,65 @@
+const require_qss = require("./qss.cjs");
+//#region src/searchParams.ts
+/** Default `parseSearch` that strips leading '?' and JSON-parses values. */
+var defaultParseSearch = parseSearchWith(JSON.parse);
+/** Default `stringifySearch` using JSON.stringify for complex values. */
+var defaultStringifySearch = stringifySearchWith(JSON.stringify, JSON.parse);
+/**
+* Build a `parseSearch` function using a provided JSON-like parser.
+*
+* The returned function strips a leading `?`, decodes values, and attempts to
+* JSON-parse string values using the given `parser`.
+*
+* @param parser Function to parse a string value (e.g. `JSON.parse`).
+* @returns A `parseSearch` function compatible with `Router` options.
+* @link https://tanstack.com/router/latest/docs/framework/react/guide/custom-search-param-serialization
+*/
+function parseSearchWith(parser) {
+	return (searchStr) => {
+		if (searchStr[0] === "?") searchStr = searchStr.substring(1);
+		const query = require_qss.decode(searchStr);
+		for (const key in query) {
+			const value = query[key];
+			if (typeof value === "string") try {
+				query[key] = parser(value);
+			} catch (_err) {}
+		}
+		return query;
+	};
+}
+/**
+* Build a `stringifySearch` function using a provided serializer.
+*
+* Non-primitive values are serialized with `stringify`. If a `parser` is
+* supplied, string values that are parseable are re-serialized to ensure
+* symmetry with `parseSearch`.
+*
+* @param stringify Function to serialize a value (e.g. `JSON.stringify`).
+* @param parser Optional parser to detect parseable strings.
+* @returns A `stringifySearch` function compatible with `Router` options.
+* @link https://tanstack.com/router/latest/docs/framework/react/guide/custom-search-param-serialization
+*/
+function stringifySearchWith(stringify, parser) {
+	const hasParser = typeof parser === "function";
+	function stringifyValue(val) {
+		if (typeof val === "object" && val !== null) try {
+			return stringify(val);
+		} catch (_err) {}
+		else if (hasParser && typeof val === "string") try {
+			parser(val);
+			return stringify(val);
+		} catch (_err) {}
+		return val;
+	}
+	return (search) => {
+		const searchStr = require_qss.encode(search, stringifyValue);
+		return searchStr ? `?${searchStr}` : "";
+	};
+}
+//#endregion
+exports.defaultParseSearch = defaultParseSearch;
+exports.defaultStringifySearch = defaultStringifySearch;
+exports.parseSearchWith = parseSearchWith;
+exports.stringifySearchWith = stringifySearchWith;
+
+//# sourceMappingURL=searchParams.cjs.map

package/dist/cjs/searchParams.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchParams.cjs","names":[],"sources":["../../src/searchParams.ts"],"sourcesContent":["import { decode, encode } from './qss'\nimport type { AnySchema } from './validators'\n\n/** Default `parseSearch` that strips leading '?' and JSON-parses values. */\nexport const defaultParseSearch = parseSearchWith(JSON.parse)\n/** Default `stringifySearch` using JSON.stringify for complex values. */\nexport const defaultStringifySearch = stringifySearchWith(\n  JSON.stringify,\n  JSON.parse,\n)\n\n/**\n * Build a `parseSearch` function using a provided JSON-like parser.\n *\n * The returned function strips a leading `?`, decodes values, and attempts to\n * JSON-parse string values using the given `parser`.\n *\n * @param parser Function to parse a string value (e.g. `JSON.parse`).\n * @returns A `parseSearch` function compatible with `Router` options.\n * @link https://tanstack.com/router/latest/docs/framework/react/guide/custom-search-param-serialization\n */\nexport function parseSearchWith(parser: (str: string) => any) {\n  return (searchStr: string): AnySchema => {\n    if (searchStr[0] === '?') {\n      searchStr = searchStr.substring(1)\n    }\n\n    const query: Record<string, unknown> = decode(searchStr)\n\n    // Try to parse any query params that might be json\n    for (const key in query) {\n      const value = query[key]\n      if (typeof value === 'string') {\n        try {\n          query[key] = parser(value)\n        } catch (_err) {\n          // silent\n        }\n      }\n    }\n\n    return query\n  }\n}\n\n/**\n * Build a `stringifySearch` function using a provided serializer.\n *\n * Non-primitive values are serialized with `stringify`. If a `parser` is\n * supplied, string values that are parseable are re-serialized to ensure\n * symmetry with `parseSearch`.\n *\n * @param stringify Function to serialize a value (e.g. `JSON.stringify`).\n * @param parser Optional parser to detect parseable strings.\n * @returns A `stringifySearch` function compatible with `Router` options.\n * @link https://tanstack.com/router/latest/docs/framework/react/guide/custom-search-param-serialization\n */\nexport function stringifySearchWith(\n  stringify: (search: any) => string,\n  parser?: (str: string) => any,\n) {\n  const hasParser = typeof parser === 'function'\n  function stringifyValue(val: any) {\n    if (typeof val === 'object' && val !== null) {\n      try {\n        return stringify(val)\n      } catch (_err) {\n        // silent\n      }\n    } else if (hasParser && typeof val === 'string') {\n      try {\n        // Check if it's a valid parseable string.\n        // If it is, then stringify it again.\n        parser(val)\n        return stringify(val)\n      } catch (_err) {\n        // silent\n      }\n    }\n    return val\n  }\n\n  return (search: Record<string, any>) => {\n    const searchStr = encode(search, stringifyValue)\n    return searchStr ? `?${searchStr}` : ''\n  }\n}\n\nexport type SearchSerializer = (searchObj: Record<string, any>) => string\nexport type SearchParser = (searchStr: string) => Record<string, any>\n"],"mappings":";;;AAIA,IAAa,qBAAqB,gBAAgB,KAAK,MAAM;;AAE7D,IAAa,yBAAyB,oBACpC,KAAK,WACL,KAAK,MACN;;;;;;;;;;;AAYD,SAAgB,gBAAgB,QAA8B;AAC5D,SAAQ,cAAiC;AACvC,MAAI,UAAU,OAAO,IACnB,aAAY,UAAU,UAAU,EAAE;EAGpC,MAAM,QAAiC,YAAA,OAAO,UAAU;AAGxD,OAAK,MAAM,OAAO,OAAO;GACvB,MAAM,QAAQ,MAAM;AACpB,OAAI,OAAO,UAAU,SACnB,KAAI;AACF,UAAM,OAAO,OAAO,MAAM;YACnB,MAAM;;AAMnB,SAAO;;;;;;;;;;;;;;;AAgBX,SAAgB,oBACd,WACA,QACA;CACA,MAAM,YAAY,OAAO,WAAW;CACpC,SAAS,eAAe,KAAU;AAChC,MAAI,OAAO,QAAQ,YAAY,QAAQ,KACrC,KAAI;AACF,UAAO,UAAU,IAAI;WACd,MAAM;WAGN,aAAa,OAAO,QAAQ,SACrC,KAAI;AAGF,UAAO,IAAI;AACX,UAAO,UAAU,IAAI;WACd,MAAM;AAIjB,SAAO;;AAGT,SAAQ,WAAgC;EACtC,MAAM,YAAY,YAAA,OAAO,QAAQ,eAAe;AAChD,SAAO,YAAY,IAAI,cAAc"}

package/dist/cjs/searchParams.d.cts

@@ -0,0 +1,31 @@
+import { AnySchema } from './validators.cjs';
+/** Default `parseSearch` that strips leading '?' and JSON-parses values. */
+export declare const defaultParseSearch: (searchStr: string) => AnySchema;
+/** Default `stringifySearch` using JSON.stringify for complex values. */
+export declare const defaultStringifySearch: (search: Record<string, any>) => string;
+/**
+ * Build a `parseSearch` function using a provided JSON-like parser.
+ *
+ * The returned function strips a leading `?`, decodes values, and attempts to
+ * JSON-parse string values using the given `parser`.
+ *
+ * @param parser Function to parse a string value (e.g. `JSON.parse`).
+ * @returns A `parseSearch` function compatible with `Router` options.
+ * @link https://tanstack.com/router/latest/docs/framework/react/guide/custom-search-param-serialization
+ */
+export declare function parseSearchWith(parser: (str: string) => any): (searchStr: string) => AnySchema;
+/**
+ * Build a `stringifySearch` function using a provided serializer.
+ *
+ * Non-primitive values are serialized with `stringify`. If a `parser` is
+ * supplied, string values that are parseable are re-serialized to ensure
+ * symmetry with `parseSearch`.
+ *
+ * @param stringify Function to serialize a value (e.g. `JSON.stringify`).
+ * @param parser Optional parser to detect parseable strings.
+ * @returns A `stringifySearch` function compatible with `Router` options.
+ * @link https://tanstack.com/router/latest/docs/framework/react/guide/custom-search-param-serialization
+ */
+export declare function stringifySearchWith(stringify: (search: any) => string, parser?: (str: string) => any): (search: Record<string, any>) => string;
+export type SearchSerializer = (searchObj: Record<string, any>) => string;
+export type SearchParser = (searchStr: string) => Record<string, any>;

package/dist/cjs/ssr/client.cjs

@@ -0,0 +1,7 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_headers = require("./headers.cjs");
+const require_json = require("./json.cjs");
+const require_ssr_client = require("./ssr-client.cjs");
+exports.hydrate = require_ssr_client.hydrate;
+exports.json = require_json.json;
+exports.mergeHeaders = require_headers.mergeHeaders;

package/dist/cjs/ssr/client.d.cts

@@ -0,0 +1,6 @@
+export { mergeHeaders } from './headers.cjs';
+export { json } from './json.cjs';
+export type { JsonResponse } from './json.cjs';
+export { hydrate } from './ssr-client.cjs';
+export * from './ssr-client.cjs';
+export type { TsrSsrGlobal, DehydratedMatch, DehydratedRouter } from './types.cjs';

package/dist/cjs/ssr/constants.cjs

@@ -0,0 +1,8 @@
+//#region src/ssr/constants.ts
+var GLOBAL_TSR = "$_TSR";
+var TSR_SCRIPT_BARRIER_ID = "$tsr-stream-barrier";
+//#endregion
+exports.GLOBAL_TSR = GLOBAL_TSR;
+exports.TSR_SCRIPT_BARRIER_ID = TSR_SCRIPT_BARRIER_ID;
+
+//# sourceMappingURL=constants.cjs.map

package/dist/cjs/ssr/constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.cjs","names":[],"sources":["../../../src/ssr/constants.ts"],"sourcesContent":["export const GLOBAL_TSR = '$_TSR'\nexport declare const GLOBAL_SEROVAL: '$R'\nexport const TSR_SCRIPT_BARRIER_ID = '$tsr-stream-barrier'\n"],"mappings":";AAAA,IAAa,aAAa;AAE1B,IAAa,wBAAwB"}

package/dist/cjs/ssr/constants.d.cts

@@ -0,0 +1,3 @@
+export declare const GLOBAL_TSR = "$_TSR";
+export declare const GLOBAL_SEROVAL: '$R';
+export declare const TSR_SCRIPT_BARRIER_ID = "$tsr-stream-barrier";

package/dist/cjs/ssr/createRequestHandler.cjs

@@ -0,0 +1,44 @@
+const require_headers = require("./headers.cjs");
+const require_ssr_server = require("./ssr-server.cjs");
+let _benjavicente_history = require("@benjavicente/history");
+//#region src/ssr/createRequestHandler.ts
+function createRequestHandler({ createRouter, request, getRouterManifest }) {
+	return async (cb) => {
+		const router = createRouter();
+		let cbWillCleanup = false;
+		try {
+			require_ssr_server.attachRouterServerSsrUtils({
+				router,
+				manifest: await getRouterManifest?.()
+			});
+			const { url } = require_ssr_server.getNormalizedURL(request.url, "http://localhost");
+			const origin = require_ssr_server.getOrigin(request);
+			const history = (0, _benjavicente_history.createMemoryHistory)({ initialEntries: [url.href.replace(url.origin, "")] });
+			router.update({
+				history,
+				origin: router.options.origin ?? origin
+			});
+			await router.load();
+			await router.serverSsr?.dehydrate();
+			const responseHeaders = getRequestHeaders({ router });
+			cbWillCleanup = true;
+			return cb({
+				request,
+				router,
+				responseHeaders
+			});
+		} finally {
+			if (!cbWillCleanup) router.serverSsr?.cleanup();
+		}
+	};
+}
+function getRequestHeaders(opts) {
+	const matchHeaders = opts.router.stores.activeMatchesSnapshot.state.map((match) => match.headers);
+	const redirect = opts.router.stores.redirect.state;
+	if (redirect) matchHeaders.push(redirect.headers);
+	return require_headers.mergeHeaders({ "Content-Type": "text/html; charset=UTF-8" }, ...matchHeaders);
+}
+//#endregion
+exports.createRequestHandler = createRequestHandler;
+
+//# sourceMappingURL=createRequestHandler.cjs.map

package/dist/cjs/ssr/createRequestHandler.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRequestHandler.cjs","names":[],"sources":["../../../src/ssr/createRequestHandler.ts"],"sourcesContent":["import { createMemoryHistory } from '@benjavicente/history'\nimport { mergeHeaders } from './headers'\nimport {\n  attachRouterServerSsrUtils,\n  getNormalizedURL,\n  getOrigin,\n} from './ssr-server'\nimport type { HandlerCallback } from './handlerCallback'\nimport type { AnyHeaders } from './headers'\nimport type { AnyRouter } from '../router'\nimport type { Manifest } from '../manifest'\n\nexport type RequestHandler<TRouter extends AnyRouter> = (\n  cb: HandlerCallback<TRouter>,\n) => Promise<Response>\n\nexport function createRequestHandler<TRouter extends AnyRouter>({\n  createRouter,\n  request,\n  getRouterManifest,\n}: {\n  createRouter: () => TRouter\n  request: Request\n  getRouterManifest?: () => Manifest | Promise<Manifest>\n}): RequestHandler<TRouter> {\n  return async (cb) => {\n    const router = createRouter()\n    // Track whether the callback will handle cleanup\n    let cbWillCleanup = false\n\n    try {\n      attachRouterServerSsrUtils({\n        router,\n        manifest: await getRouterManifest?.(),\n      })\n\n      // normalizing and sanitizing the pathname here for server, so we always deal with the same format during SSR.\n      const { url } = getNormalizedURL(request.url, 'http://localhost')\n      const origin = getOrigin(request)\n      const href = url.href.replace(url.origin, '')\n\n      // Create a history for the router\n      const history = createMemoryHistory({\n        initialEntries: [href],\n      })\n\n      // Update the router with the history and context\n      router.update({\n        history,\n        origin: router.options.origin ?? origin,\n      })\n\n      await router.load()\n\n      await router.serverSsr?.dehydrate()\n\n      const responseHeaders = getRequestHeaders({\n        router,\n      })\n\n      // Mark that the callback will handle cleanup\n      cbWillCleanup = true\n      return cb({\n        request,\n        router,\n        responseHeaders,\n      })\n    } finally {\n      if (!cbWillCleanup) {\n        // Clean up router SSR state if the callback won't handle it\n        // (e.g., if an error occurred before the callback was invoked).\n        // When the callback runs, it handles cleanup (either via transformStreamWithRouter\n        // for streaming, or directly in renderRouterToString for non-streaming).\n        router.serverSsr?.cleanup()\n      }\n    }\n  }\n}\n\nfunction getRequestHeaders(opts: { router: AnyRouter }): Headers {\n  const matchHeaders =\n    opts.router.stores.activeMatchesSnapshot.state.map<AnyHeaders>(\n      (match) => match.headers,\n    )\n\n  // Handle Redirects\n  const redirect = opts.router.stores.redirect.state\n  if (redirect) {\n    matchHeaders.push(redirect.headers)\n  }\n\n  return mergeHeaders(\n    {\n      'Content-Type': 'text/html; charset=UTF-8',\n    },\n    ...matchHeaders,\n  )\n}\n"],"mappings":";;;;AAgBA,SAAgB,qBAAgD,EAC9D,cACA,SACA,qBAK0B;AAC1B,QAAO,OAAO,OAAO;EACnB,MAAM,SAAS,cAAc;EAE7B,IAAI,gBAAgB;AAEpB,MAAI;AACF,sBAAA,2BAA2B;IACzB;IACA,UAAU,MAAM,qBAAqB;IACtC,CAAC;GAGF,MAAM,EAAE,QAAQ,mBAAA,iBAAiB,QAAQ,KAAK,mBAAmB;GACjE,MAAM,SAAS,mBAAA,UAAU,QAAQ;GAIjC,MAAM,WAAA,GAAA,sBAAA,qBAA8B,EAClC,gBAAgB,CAJL,IAAI,KAAK,QAAQ,IAAI,QAAQ,GAAG,CAIrB,EACvB,CAAC;AAGF,UAAO,OAAO;IACZ;IACA,QAAQ,OAAO,QAAQ,UAAU;IAClC,CAAC;AAEF,SAAM,OAAO,MAAM;AAEnB,SAAM,OAAO,WAAW,WAAW;GAEnC,MAAM,kBAAkB,kBAAkB,EACxC,QACD,CAAC;AAGF,mBAAgB;AAChB,UAAO,GAAG;IACR;IACA;IACA;IACD,CAAC;YACM;AACR,OAAI,CAAC,cAKH,QAAO,WAAW,SAAS;;;;AAMnC,SAAS,kBAAkB,MAAsC;CAC/D,MAAM,eACJ,KAAK,OAAO,OAAO,sBAAsB,MAAM,KAC5C,UAAU,MAAM,QAClB;CAGH,MAAM,WAAW,KAAK,OAAO,OAAO,SAAS;AAC7C,KAAI,SACF,cAAa,KAAK,SAAS,QAAQ;AAGrC,QAAO,gBAAA,aACL,EACE,gBAAgB,4BACjB,EACD,GAAG,aACJ"}