@kasperrt/smolter 0.3.3 → 0.3.5

package/.generated/client/deployment-check.ts

@@ -36,27 +36,24 @@ export function deploymentCheck(options: DeploymentOptions) {
     return pending;
   }
 
-  async function reload(target: URL) {
-    // If storage is unavailable, do not risk reloading the same cached document forever.
-    const allowed = await Promise.resolve()
+  function reload(target: URL, current: () => boolean = () => true) {
+    // Validate and claim recovery in the same task: stale checks must not consume
+    // the marker or reload after a newer navigation or mutation has started.
+    return Promise.resolve()
       .then(() => {
-        if (sessionStorage.getItem(key)) return false;
+        if (stopped || !current() || sessionStorage.getItem(key)) return false;
 
         sessionStorage.setItem(key, "1");
 
+        if (options.reload) options.reload(target);
+        if (!options.reload) {
+          if (target.href === location.href) location.reload();
+          if (target.href !== location.href) location.assign(target.href);
+        }
+
         return true;
       })
       .catch(() => false);
-
-    if (allowed && !stopped) {
-      if (options?.reload) options.reload(target);
-      if (!options?.reload) {
-        if (target.href === location.href) location.reload();
-        if (target.href !== location.href) location.assign(target.href);
-      }
-    }
-
-    return allowed && !stopped;
   }
 
   return {

package/.generated/client/deployment.ts

@@ -20,18 +20,21 @@ export function watchDeployment(
 
   const check = deploymentCheck(options);
   const { changed, reload } = check;
+  const read = router.getSnapshot;
   const navigate = router.navigate;
   const dispose = router.dispose;
   let sequence = 0;
   let stopped = false;
   let replay = false;
-  let destination = new URL(location.href);
+  const valid = (current: number) => current === sequence && !stopped;
+  const unsubscribe = router.subscribe(() => {
+    if (read().state === "submitting") sequence++;
+  });
 
   const guarded: NavigationRouter["navigate"] = async (href, operation) => {
     const target = new URL(href, router.getSnapshot().url);
     const currentURL = new URL(router.getSnapshot().url);
     const current = ++sequence;
-    destination = target;
 
     if (
       target.origin === location.origin &&
@@ -39,7 +42,8 @@ export function watchDeployment(
         target.search !== currentURL.search) &&
       (await changed())
     ) {
-      if (current !== sequence || stopped || (await reload(target))) return;
+      if (!valid(current) || (await reload(target, () => valid(current))))
+        return;
     }
 
     if (current === sequence && !stopped) await navigate(href, operation);
@@ -49,7 +53,8 @@ export function watchDeployment(
     if (replay) return;
 
     const target = new URL(location.href);
-    const previous = new URL(router.getSnapshot().url);
+    const previous = new URL(read().url);
+    const current = ++sequence;
 
     if (
       target.pathname === previous.pathname &&
@@ -58,11 +63,10 @@ export function watchDeployment(
       return;
 
     event.stopImmediatePropagation();
-    const current = ++sequence;
-    destination = target;
     void changed().then(async (updated) => {
-      if (stopped || current !== sequence) return;
-      if (updated && (await reload(target))) return;
+      if (!valid(current)) return;
+      if (updated && (await reload(target, () => valid(current)))) return;
+      if (!valid(current)) return;
 
       replay = true;
       window.dispatchEvent(
@@ -75,12 +79,19 @@ export function watchDeployment(
   const preloadError = () => {
     // Intent prefetch is speculative: it must not reload the current page or
     // consume the recovery marker before a click records its destination.
-    if (router.getSnapshot().state !== "loading") return;
+    if (read().state !== "loading") return;
 
     const current = sequence;
-    const target = destination;
+    const target = new URL(read().url);
     void changed().then((updated) => {
-      if (updated && current === sequence && !stopped) return reload(target);
+      if (updated)
+        return reload(
+          target,
+          () =>
+            valid(current) &&
+            read().state !== "submitting" &&
+            read().url === target.href,
+        );
     });
   };
 
@@ -88,6 +99,7 @@ export function watchDeployment(
     stopped = true;
     sequence++;
     check.dispose();
+    unsubscribe();
     window.removeEventListener("popstate", pop, true);
     window.removeEventListener("vite:preloadError", preloadError);
 

package/.generated/preact/client.tsx

@@ -96,7 +96,22 @@ export async function mountApplication(
   };
 
   if (hydration) {
-    hydrate(<RouterApplication {...props} document />, document);
+    // Explicitly unmanaged head nodes must not participate in positional hydration.
+    const preserved = Array.from(
+      document.head.querySelectorAll(":scope > [data-smolter-preserve]"),
+      (node) => ({ node, next: node.nextSibling }),
+    );
+    for (const { node } of preserved) node.remove();
+
+    await Promise.resolve()
+      .then(() => hydrate(<RouterApplication {...props} document />, document))
+      .finally(() => {
+        for (const { node, next } of preserved.reverse())
+          document.head.insertBefore(
+            node,
+            next?.parentNode === document.head ? next : null,
+          );
+      });
 
     return router;
   }

package/.generated/vite/application/lazy-files.ts

@@ -35,12 +35,12 @@ export function lazyFiles(
         function visit(file: string) {
           if (files.has(file)) return;
 
-          files.add(file);
-
           const dependency = bundle[file];
 
           if (dependency?.type !== "chunk") return;
 
+          files.add(file);
+
           for (const imported of dependency.imports) visit(imported);
         }
 

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.3.5
+
+- Preserve explicitly unmanaged head elements marked data-smolter-preserve during Preact document hydration, without matching them to application-owned nodes.
+- Test injected script/meta preservation, one-time script execution, styling and subsequent navigation.
+- Add interaction-before/after-deferred-completion assertions and document that streaming does not provide progressive hydration.
+- Fix route asset manifests incorrectly including external module specifiers as preload file URLs; retain transitive emitted chunks and leave optional dynamic imports lazy. No general request-count or latency improvement is claimed.
+
+## 0.3.4
+
+- Cancel stale deployment checks when newer Back/Forward operations return to the current route, including hash changes.
+- Recover missing action-redirect chunks at the committed destination, preserving query/hash and avoiding mutation replay.
+- Invalidate pending chunk recovery when a mutation starts; validate recovery ownership before claiming the reload marker.
+- Expand production-browser coverage for scoped application paths, separate CDN asset/manifest origins, overlapping navigation, Chromium offline/online recovery and history races. Manual and file-route HMR remain covered.
+
 ## 0.3.3
 
 - Ignore idle intent-prefetch chunk failures in deployment recovery so the next click retains its destination and reload marker.

package/README.md

@@ -1,8 +1,8 @@
 # smolter _
 
 <!-- bundlejs:start -->
-[![react gzip size](https://deno.bundlejs.com/?q=%40kasperrt%2Fsmolter%400.3.3%2Freact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react%2F*%22%5D%7D%7D&badge)](https://bundlejs.com/?q=%40kasperrt%2Fsmolter%400.3.3%2Freact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react%2F*%22%5D%7D%7D&bundle)
-[![preact gzip size](https://deno.bundlejs.com/?q=%40kasperrt%2Fsmolter%400.3.3%2Fpreact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22preact%22%2C%22preact%2F*%22%5D%7D%7D&badge)](https://bundlejs.com/?q=%40kasperrt%2Fsmolter%400.3.3%2Fpreact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22preact%22%2C%22preact%2F*%22%5D%7D%7D&bundle)
+[![react gzip size](https://deno.bundlejs.com/?q=%40kasperrt%2Fsmolter%400.3.5%2Freact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react%2F*%22%5D%7D%7D&badge)](https://bundlejs.com/?q=%40kasperrt%2Fsmolter%400.3.5%2Freact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react%2F*%22%5D%7D%7D&bundle)
+[![preact gzip size](https://deno.bundlejs.com/?q=%40kasperrt%2Fsmolter%400.3.5%2Fpreact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22preact%22%2C%22preact%2F*%22%5D%7D%7D&badge)](https://bundlejs.com/?q=%40kasperrt%2Fsmolter%400.3.5%2Fpreact&treeshake=%5B*%5D&config=%7B%22compression%22%3A%22gzip%22%2C%22esbuild%22%3A%7B%22external%22%3A%5B%22preact%22%2C%22preact%2F*%22%5D%7D%7D&bundle)
 <!-- bundlejs:end -->
 
 A typed data router for React and Preact. **Zero runtime dependencies.**
@@ -605,10 +605,10 @@ a claim of identical features.
 | `Preact: routing-only named exports` | 1405 |
 | `@kasperrt/smolter/react` | 2948 |
 | `@kasperrt/smolter/preact` | 4842 |
-| `@kasperrt/smolter/react + @kasperrt/smolter/react/client` | 4044 |
-| `@kasperrt/smolter/preact + server transport` | 5883 |
-| `@kasperrt/smolter/preact + client + document (application without lazy routes)` | 8415 |
-| `@kasperrt/smolter/preact + client + document + lazy-route (file-routed application)` | 8701 |
+| `@kasperrt/smolter/react + @kasperrt/smolter/react/client` | 4104 |
+| `@kasperrt/smolter/preact + server transport` | 5950 |
+| `@kasperrt/smolter/preact + client + document (application without lazy routes)` | 8607 |
+| `@kasperrt/smolter/preact + client + document + lazy-route (file-routed application)` | 8890 |
 | `@kasperrt/smolter/react/data (optional resource API)` | 2962 |
 | `React: common routing/data exports` | 2761 |
 | `Preact: common routing/data exports` | 3046 |
@@ -751,3 +751,16 @@ await mountApplication(routes, root, { deployment });
 Preact SSR starts root and route loaders concurrently. Return nested promises and render them with `Await` inside `Suspense` to stream a shell before optional data resolves. The Node/Express adapter streams the response; hydration starts after the document stream finishes. Root-loader failures render the root error boundary. Vite development HTML transformation still buffers the document.
 
 Successful action redirects refresh registered root data without replaying the mutation. Loader arguments expose `reason` to distinguish initial loads, navigation, revalidation and fetcher reads without comparing browser URLs.
+
+
+### Document hydration and injected tags
+
+Preact hydrates the complete document after the response finishes. A streamed shell is visible before optional data settles, but event handlers are not active yet. Measure a successful interaction rather than treating TTFB or DOMContentLoaded as hydration completion.
+
+Infrastructure that injects direct children of `<head>` can mark those external nodes with `data-smolter-preserve`. Smolter excludes them from positional hydration and restores the same nodes afterward. Do not also render them in the application layout. Unmarked HTML rewriting, body injection and changes to the hydration payload are not supported.
+
+```html
+<script data-smolter-preserve src="/infrastructure-instrumentation.js"></script>
+```
+
+The generated route asset manifest follows static imports for each route and leaves optional dynamic imports lazy. Serve the matched route's preload hints with the correct asset base; do not preload every route to reduce a waterfall. Chunk counts and total emitted bytes alone do not establish initial-load latency.

package/dist/client/deployment-check.d.ts

@@ -1,6 +1,6 @@
 import type { DeploymentOptions } from "./deployment.ts";
 export declare function deploymentCheck(options: DeploymentOptions): {
     changed: () => Promise<boolean>;
-    reload: (target: URL) => Promise<boolean>;
+    reload: (target: URL, current?: () => boolean) => Promise<boolean>;
     dispose(): void;
 };

package/dist/client/deployment-check.js

@@ -23,20 +23,17 @@ function deploymentCheck(options) {
 		});
 		return pending;
 	}
-	async function reload(target) {
-		const allowed = await Promise.resolve().then(() => {
-			if (sessionStorage.getItem(key)) return false;
+	function reload(target, current = () => true) {
+		return Promise.resolve().then(() => {
+			if (stopped || !current() || sessionStorage.getItem(key)) return false;
 			sessionStorage.setItem(key, "1");
-			return true;
-		}).catch(() => false);
-		if (allowed && !stopped) {
-			if (options?.reload) options.reload(target);
-			if (!options?.reload) {
+			if (options.reload) options.reload(target);
+			if (!options.reload) {
 				if (target.href === location.href) location.reload();
 				if (target.href !== location.href) location.assign(target.href);
 			}
-		}
-		return allowed && !stopped;
+			return true;
+		}).catch(() => false);
 	}
 	return {
 		changed,

package/dist/client/deployment.js

@@ -5,50 +5,54 @@ function watchDeployment(router, options) {
 	if (!options || typeof window === "undefined") return () => {};
 	const check = deploymentCheck(options);
 	const { changed, reload } = check;
+	const read = router.getSnapshot;
 	const navigate = router.navigate;
 	const dispose = router.dispose;
 	let sequence = 0;
 	let stopped = false;
 	let replay = false;
-	let destination = new URL(location.href);
+	const valid = (current) => current === sequence && !stopped;
+	const unsubscribe = router.subscribe(() => {
+		if (read().state === "submitting") sequence++;
+	});
 	const guarded = async (href, operation) => {
 		const target = new URL(href, router.getSnapshot().url);
 		const currentURL = new URL(router.getSnapshot().url);
 		const current = ++sequence;
-		destination = target;
 		if (target.origin === location.origin && (target.pathname !== currentURL.pathname || target.search !== currentURL.search) && await changed()) {
-			if (current !== sequence || stopped || await reload(target)) return;
+			if (!valid(current) || await reload(target, () => valid(current))) return;
 		}
 		if (current === sequence && !stopped) await navigate(href, operation);
 	};
 	const pop = (event) => {
 		if (replay) return;
 		const target = new URL(location.href);
-		const previous = new URL(router.getSnapshot().url);
+		const previous = new URL(read().url);
+		const current = ++sequence;
 		if (target.pathname === previous.pathname && target.search === previous.search) return;
 		event.stopImmediatePropagation();
-		const current = ++sequence;
-		destination = target;
 		changed().then(async (updated) => {
-			if (stopped || current !== sequence) return;
-			if (updated && await reload(target)) return;
+			if (!valid(current)) return;
+			if (updated && await reload(target, () => valid(current))) return;
+			if (!valid(current)) return;
 			replay = true;
 			window.dispatchEvent(new PopStateEvent("popstate", { state: event.state }));
 			replay = false;
 		});
 	};
 	const preloadError = () => {
-		if (router.getSnapshot().state !== "loading") return;
+		if (read().state !== "loading") return;
 		const current = sequence;
-		const target = destination;
+		const target = new URL(read().url);
 		changed().then((updated) => {
-			if (updated && current === sequence && !stopped) return reload(target);
+			if (updated) return reload(target, () => valid(current) && read().state !== "submitting" && read().url === target.href);
 		});
 	};
 	function cleanup() {
 		stopped = true;
 		sequence++;
 		check.dispose();
+		unsubscribe();
 		window.removeEventListener("popstate", pop, true);
 		window.removeEventListener("vite:preloadError", preloadError);
 		if (router.navigate === guarded) router.navigate = navigate;

package/dist/preact/client.js

@@ -50,10 +50,17 @@ async function mountApplication(routes, rootModule, options = false) {
 		rootError: hydration?.rootError
 	};
 	if (hydration) {
-		hydrate(/* @__PURE__ */ jsx(RouterApplication, {
+		const preserved = Array.from(document.head.querySelectorAll(":scope > [data-smolter-preserve]"), (node) => ({
+			node,
+			next: node.nextSibling
+		}));
+		for (const { node } of preserved) node.remove();
+		await Promise.resolve().then(() => hydrate(/* @__PURE__ */ jsx(RouterApplication, {
 			...props,
 			document: true
-		}), document);
+		}), document)).finally(() => {
+			for (const { node, next } of preserved.reverse()) document.head.insertBefore(node, next?.parentNode === document.head ? next : null);
+		});
 		return router;
 	}
 	const target = document.getElementById("root");

package/dist/vite/application/lazy-files.js

@@ -22,9 +22,9 @@ function lazyFiles(directory, dataEndpoint = "/_smolter") {
 				const files = /* @__PURE__ */ new Set();
 				function visit(file) {
 					if (files.has(file)) return;
-					files.add(file);
 					const dependency = bundle[file];
 					if (dependency?.type !== "chunk") return;
+					files.add(file);
 					for (const imported of dependency.imports) visit(imported);
 				}
 				visit(chunk.fileName);

package/jsr.json

@@ -1,6 +1,6 @@
 {
   "name": "@kasperrt/smolter",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "exports": {
     "./react": "./.generated/react/index.ts",
     "./preact": "./.generated/preact/index.ts",

package/package.json

@@ -56,7 +56,7 @@
     "wouter": "3.13.0",
     "wouter-preact": "3.13.0"
   },
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "A tiny typed data router for React and Preact.",
   "sideEffects": false,
   "license": "MIT",