@askrjs/askr 0.2.3 → 0.3.0

package/dist/{boot-D4GaLA0d.js → boot-BMBMWUGI.js}

@@ -1,177 +1,317 @@
-import { S as isProductionEnvironment, r as flushRuntimeScheduler, x as isDevelopmentEnvironment, y as logger } from "./access-Rr7CMa06.js";
+import { T as isProductionEnvironment, i as getRuntimeCleanup, l as installRuntimeRenderer, r as flushRuntimeScheduler, v as logger, w as isDevelopmentEnvironment } from "./access-CEA2pOry.js";
+import { D as createComponentOwnership, E as cleanupComponentGeneration, F as captureGenerationExecution, N as assertSyncComponentResult, T as cleanupComponent, k as resetComponentWork, n as createComponentInstance, r as executeComponent } from "./instance-VAFYVJOa.js";
+import { a as registerDeferredHydrationBoundary, c as beginHydrationDirectListenerMode, d as commitHydrationListenerTransaction, f as discardHydrationListenerTransaction, g as teardownNodeSubtree, h as removeAllListeners, i as clearDeferredHydrationBoundaries, l as endHydrationDirectListenerMode, n as activateHydrationBoundary$1, o as setStaticChildSlotsCacheEnabled, s as withIntrinsicHydrationAdoption, t as createRendererCapabilities, u as beginHydrationListenerTransaction } from "./renderer-CT0HeY58.js";
+import { b as attachOwnership } from "./scope-Cq_iYbTR.js";
+import { m as cleanupReadableSubscriptionSources } from "./notify-DxxuDPeY.js";
 import { n as Fragment, t as ELEMENT_TYPE } from "./jsx-DRS-qjiN.js";
-import { n as createComponentInstance, r as executeComponent } from "./component-internal-Dl02WQKS.js";
-import { t as cleanupComponent } from "./component-cleanup-DjpwO9WX.js";
-import { p as isPromiseLike } from "./lifecycle-batch-Be-CLDjV.js";
-import { _ as teardownNodeSubtree, d as removeAllListeners } from "./cleanup-DsrbV-rr.js";
-import { r as assertExecutionModel, t as _applyManifest } from "./manifest-D6rfj_jC.js";
+import { r as assertExecutionModel, t as _applyManifest } from "./manifest-D1P3UNWV.js";
 import { d as stopHydrationRenderPhase, l as startHydrationRenderPhase, y as pageRenderEnvelope } from "./render-context-B7ohlh6t.js";
-import { a as setStaticChildSlotsCacheEnabled, c as endHydrationDirectListenerMode, d as discardHydrationListenerTransaction, i as registerDeferredHydrationBoundary, l as beginHydrationListenerTransaction, n as activateHydrationBoundary$1, o as withIntrinsicHydrationAdoption, r as clearDeferredHydrationBoundaries, s as beginHydrationDirectListenerMode, t as installRendererBridge, u as commitHydrationListenerTransaction } from "./renderer-BhXofszH.js";
-import { r as validateCspNonce, t as CspNonceScope } from "./csp-nonce-C9OuML0U.js";
-import { i as getDefaultDataRuntime } from "./data-runtime-7t_Y0iv3.js";
-import { a as hydrateDataRuntime } from "./query-registry-Bua3cDyb.js";
-import { I as lockRouteRegistration, P as hasRegisteredRoutes, _ as clearRouteState, m as _setActiveRouteAuthOptions } from "./route-matching-Bo6UqG-5.js";
-import { a as resolveRouteRequest, i as hasRouteRenderData, m as reviveDeferredValue, n as getRouteRenderContext, r as getRouteRenderData } from "./resolution-t8J0yNaU.js";
-import { o as createAppRenderRuntime, r as setServerLocation } from "./activity-ZxJXI9hF.js";
-import { f as registerAppInstance, g as unregisterAppInstance, i as resolveRouteMeta, o as configureScrollRestoration, r as reconcileRouteMeta, t as initializeNavigation } from "./navigate-C46GtScG.js";
-import { n as disposeRegisteredDefaultPortalScope, r as getDefaultPortalHost } from "./default-portal-runtime-DvMvWJVp.js";
-import "./ssr-DSHd_Q9K.js";
-//#region src/boot/hydration.ts
-const DEFERRED_PAYLOAD = "__askr_deferred__";
-function applyDeferredStreamPatches(rootElement) {
-	const patches = Array.from(rootElement.querySelectorAll("template[data-askr-deferred-patch]"));
-	for (const template of patches) {
-		const id = template.getAttribute("data-askr-deferred-patch");
-		if (!id) continue;
-		const boundary = Array.from(rootElement.querySelectorAll("askr-resolve[data-askr-deferred]")).find((candidate) => candidate.getAttribute("data-askr-deferred") === id);
-		if (boundary) boundary.replaceWith(template.content.cloneNode(true));
-		template.remove();
-		for (const script of Array.from(rootElement.querySelectorAll("script[data-askr-deferred-apply]"))) if (script.getAttribute("data-askr-deferred-apply") === id) script.remove();
-	}
-}
-function hydrationReviver(_key, value) {
-	if (!value || typeof value !== "object") return value;
-	const payload = value;
-	if (payload[DEFERRED_PAYLOAD] === "fulfilled") return reviveDeferredValue("fulfilled", payload.value, void 0);
-	if (payload[DEFERRED_PAYLOAD] === "rejected") return reviveDeferredValue("rejected", void 0, payload.error);
-	return value;
-}
-function takeHydrationRenderData(rootElement) {
-	for (const child of Array.from(rootElement.children)) if (child instanceof HTMLScriptElement && child.getAttribute("data-askr-render-data") === "true") {
-		const raw = child.textContent ?? "";
-		child.remove();
-		if (!raw) return pageRenderEnvelope(void 0);
-		try {
-			return pageRenderEnvelope(JSON.parse(raw, hydrationReviver));
-		} catch (err) {
-			const error = /* @__PURE__ */ new Error("[Askr] Failed to parse embedded SSR render data during hydration.");
-			error.cause = err;
-			throw error;
-		}
+import { r as validateCspNonce, t as CspNonceScope } from "./csp-nonce-BfFWcd0w.js";
+import { i as getDefaultDataRuntime } from "./data-runtime-CxoY98lX.js";
+import { a as hydrateDataRuntime } from "./query-registry-LrYpQsDJ.js";
+import { _ as configureRootUpdateHost, f as registerAppInstance, g as unregisterAppInstance, i as resolveRouteMeta, o as configureScrollRestoration, r as reconcileRouteMeta, t as initializeNavigation } from "./navigate-prC5V8XV.js";
+import { n as disposeRegisteredDefaultPortalScope, r as getDefaultPortalHost, t as clearRegisteredDefaultPortalForInstance } from "./default-portal-runtime-DvMvWJVp.js";
+import { a as clearStagedAppRenderRouteLocation, o as createAppRenderRuntime, r as setServerLocation, s as stageAppRenderRouteLocation } from "./activity-oy2YFTFF.js";
+import { C as reviveDeferredValue, a as resolveRouteRequest, i as hasRouteRenderData, n as getRouteRenderContext, r as getRouteRenderData, y as withoutRouteHydrationMetadata } from "./resolution-3DskUkjG.js";
+import { F as hasRegisteredRoutes, L as lockRouteRegistration, _ as clearRouteState, m as _setActiveRouteAuthOptions } from "./route-matching-CUzZ31gT.js";
+import "./ssr-EPjwJH5R.js";
+//#region src/runtime/component/generation.ts
+/** Reuse an execution record after boot has retired its previous lifetime. */
+function restartComponentGeneration(instance, fn, preserveState) {
+	instance.owner = createComponentOwnership(instance);
+	instance.fn = fn;
+	instance.evaluationGeneration++;
+	instance.expectedStateIndices = [];
+	instance.firstRenderComplete = false;
+	if (!preserveState) {
+		resetComponentWork(instance);
+		instance.stateValues = [];
+		instance.stateIndexCheck = -1;
+		instance._currentRenderToken = void 0;
+		instance.lastRenderToken = 0;
+		instance.errorBoundaryState = void 0;
+		instance._portalErrorParent = void 0;
+		instance._portalErrorParentGeneration = void 0;
+		instance.devWarningsEmitted = void 0;
 	}
-	return null;
-}
-function markSkippedElements(root, skipSelectors) {
-	if (skipSelectors.length === 0) return;
-	const selectorList = Array.from(new Set(skipSelectors)).join(", ");
-	root.querySelectorAll(selectorList).forEach((el) => el.setAttribute("data-skip-hydrate", "true"));
 }
-function collectDeferredBelowFoldBoundaries(root, foldY) {
-	const boundaries = [];
-	const stack = [];
-	for (let index = root.children.length - 1; index >= 0; index -= 1) stack.push(root.children[index]);
-	while (stack.length > 0) {
-		const element = stack.pop();
-		if (element.hasAttribute("data-skip-hydrate")) continue;
-		if (element.getBoundingClientRect().top >= foldY) {
-			element.setAttribute("data-skip-hydrate", "true");
-			registerDeferredHydrationBoundary(root, element);
-			boundaries.push(element);
-			continue;
+/** Runtime-owned preparation and retirement. A host may restore its own state
+* between disposing provisional work and restoring the previous execution. */
+function captureComponentGeneration(instance) {
+	const restoreHostIndex = getRuntimeCleanup().captureComponentHost(instance);
+	const snapshot = captureGenerationExecution(instance);
+	const reads = instance.owner.reads;
+	const readerEntries = Array.from(reads ?? [], (source) => ({
+		source,
+		reader: source._readers?.get(instance)
+	}));
+	let settled = false;
+	return {
+		prepare(fn, props) {
+			if (settled || instance.owner !== snapshot.owner) throw new Error("[Askr] component generation is no longer available for preparation");
+			const owner = createComponentOwnership(instance);
+			owner.mounted = snapshot.owner.mounted;
+			instance.owner = owner;
+			attachOwnership(owner, snapshot.owner.parent);
+			instance.fn = fn;
+			instance.props = props;
+			resetComponentWork(instance);
+			instance.stateValues = [];
+			instance.expectedStateIndices = [];
+			instance.firstRenderComplete = false;
+			instance.stateIndexCheck = -1;
+			instance.evaluationGeneration++;
+			instance.lifecycleGeneration++;
+			instance.mountOperations = [];
+			instance.commitOperations = [];
+			instance.lifecycleSlots = [];
+			instance._currentRenderToken = void 0;
+			instance.lastRenderToken = 0;
+		},
+		rollback(restoreHost) {
+			if (settled) return [];
+			settled = true;
+			const errors = [];
+			const provisional = instance.owner;
+			if (provisional !== snapshot.owner) {
+				try {
+					cleanupReadableSubscriptionSources(instance, provisional.reads, provisional.identity);
+				} catch (error) {
+					errors.push(error);
+				}
+				provisional.reads = void 0;
+				try {
+					cleanupComponent(instance);
+				} catch (error) {
+					errors.push(error);
+				}
+			}
+			try {
+				errors.push(...restoreHost());
+			} catch (error) {
+				errors.push(error);
+			}
+			Object.assign(instance, snapshot);
+			try {
+				restoreHostIndex?.();
+			} catch (error) {
+				errors.push(error);
+			}
+			snapshot.owner.reads = reads;
+			for (const { source, reader } of readerEntries) {
+				if (!reader) {
+					if (source._readers?.delete(instance) && false);
+					continue;
+				}
+				const readers = source._readers ??= /* @__PURE__ */ new Map();
+				readers.has(instance);
+				readers.set(instance, reader);
+			}
+			return errors;
+		},
+		retire() {
+			if (settled) return;
+			settled = true;
+			cleanupComponentGeneration(instance, snapshot.owner);
 		}
-		for (let index = element.children.length - 1; index >= 0; index -= 1) stack.push(element.children[index]);
-	}
-	return boundaries;
+	};
 }
-function activateVisibleDeferredBoundaries(root, boundaries, foldY, activate) {
-	let activated = false;
-	let remaining = 0;
-	for (const element of boundaries) {
-		if (!element.hasAttribute("data-skip-hydrate")) continue;
-		if (element.getBoundingClientRect().top < foldY) try {
-			if (activate(root, element)) activated = true;
-		} catch {}
-		if (element.hasAttribute("data-skip-hydrate")) remaining += 1;
-	}
+//#endregion
+//#region src/renderer/ownership/root-snapshot.ts
+function captureRootTree(root) {
+	if (!root) return null;
+	const nodes = [];
+	const visit = (node) => {
+		nodes.push({
+			node,
+			children: Array.from(node.childNodes),
+			attributes: node instanceof Element ? Array.from(node.attributes).map((attribute) => [attribute.name, attribute.value]) : null,
+			nodeValue: node.nodeValue
+		});
+		for (const child of Array.from(node.childNodes)) visit(child);
+	};
+	visit(root);
 	return {
-		activated,
-		remaining
+		root,
+		nodes
 	};
 }
-function queueIdleWork(work) {
-	return new Promise((resolve) => {
-		if (typeof requestIdleCallback !== "undefined") {
-			requestIdleCallback(() => {
-				work();
-				resolve();
-			}, { timeout: 2e3 });
+function collectProvisionalRootNodes(snapshot) {
+	const originalNodes = new Set(snapshot.nodes.map((entry) => entry.node));
+	const provisional = [];
+	const visit = (node) => {
+		if (!originalNodes.has(node)) {
+			provisional.push(node);
 			return;
 		}
-		setTimeout(() => {
-			work();
-			resolve();
-		}, 0);
-	});
-}
-function shouldVerifyHydrationMarkup(config) {
-	const explicit = config.hydrate?.verifyMarkup;
-	if (typeof explicit === "boolean") return explicit;
-	return !isProductionEnvironment();
-}
-async function applySelectiveHydration(rootElement, resolved, path, cleanupStrict, hydrateOptions, source, hooks, interactionReplay) {
-	const hasBelowFoldDeferral = !!hydrateOptions.deferBelowFold;
-	let staticChildSlotsCacheSuspended = false;
-	let releaseSelectiveHydrationResources = () => {};
-	const restoreStaticChildSlotsCache = () => {
-		if (!staticChildSlotsCacheSuspended) return;
-		setStaticChildSlotsCacheEnabled(true);
-		staticChildSlotsCacheSuspended = false;
+		for (const child of Array.from(node.childNodes)) visit(child);
 	};
-	if (hydrateOptions.skipSelectors?.length) markSkippedElements(rootElement, hydrateOptions.skipSelectors);
-	let deferredBoundaries = [];
-	if (hydrateOptions.deferBelowFold) {
-		setStaticChildSlotsCacheEnabled(false);
-		staticChildSlotsCacheSuspended = true;
-		const foldY = hydrateOptions.foldThreshold ?? window.innerHeight;
-		deferredBoundaries = collectDeferredBelowFoldBoundaries(rootElement, foldY);
-		interactionReplay.registerDeferredBoundaries(deferredBoundaries);
-		let selectiveHydrationResourcesReleased = false;
-		let unregisterRootCleanupCallback = () => {};
-		function handleScroll() {
-			const { activated, remaining } = activateVisibleDeferredBoundaries(rootElement, deferredBoundaries, foldY, hooks.activateHydrationBoundary);
-			if (!activated) return;
-			if (remaining === 0) releaseSelectiveHydrationResources();
-		}
-		releaseSelectiveHydrationResources = () => {
-			if (selectiveHydrationResourcesReleased) return;
-			selectiveHydrationResourcesReleased = true;
-			unregisterRootCleanupCallback();
-			window.removeEventListener("scroll", handleScroll);
-			restoreStaticChildSlotsCache();
-			interactionReplay.clearDeferredBoundaries();
-		};
-		interactionReplay.setOnDeferredBoundariesDrained(releaseSelectiveHydrationResources);
-		unregisterRootCleanupCallback = hooks.registerRootCleanupCallback(rootElement, releaseSelectiveHydrationResources);
-		window.addEventListener("scroll", handleScroll, { passive: true });
-	}
-	if (hydrateOptions.deferUntilIdle && !hasBelowFoldDeferral) {
-		await queueIdleWork(() => {
-			hooks.mountOrUpdate(rootElement, (() => resolved.handler(resolved.params)), {
-				cleanupStrict,
-				appRuntime: source?.runtime
-			});
-		});
-		await hooks.registerAppNavigation(rootElement, path, source);
-		return;
-	}
-	try {
-		hooks.mountOrUpdate(rootElement, (() => resolved.handler(resolved.params)), {
-			cleanupStrict,
-			appRuntime: source?.runtime
-		});
-		await hooks.registerAppNavigation(rootElement, path, source);
+	for (const child of Array.from(snapshot.root.childNodes)) visit(child);
+	return provisional;
+}
+function restoreRootTree(snapshot) {
+	if (!snapshot) return [];
+	const errors = [];
+	for (const node of collectProvisionalRootNodes(snapshot)) try {
+		teardownNodeSubtree(node, { strict: true });
 	} catch (error) {
-		releaseSelectiveHydrationResources();
-		throw error;
+		errors.push(error);
 	}
-	if (hydrateOptions.deferUntilIdle && deferredBoundaries.length > 0) await queueIdleWork(() => {
+	for (const entry of snapshot.nodes) {
+		const { node, attributes } = entry;
 		try {
-			activateVisibleDeferredBoundaries(rootElement, deferredBoundaries, Number.POSITIVE_INFINITY, hooks.activateHydrationBoundary);
-		} finally {
-			releaseSelectiveHydrationResources();
+			if (attributes && node instanceof Element) {
+				const expected = new Map(attributes);
+				for (const attribute of Array.from(node.attributes)) if (!expected.has(attribute.name)) node.removeAttribute(attribute.name);
+				for (const [name, value] of attributes) if (node.getAttribute(name) !== value) node.setAttribute(name, value);
+			} else if (!(node instanceof Element)) node.nodeValue = entry.nodeValue;
+			if (node instanceof Element || node instanceof DocumentFragment) node.replaceChildren(...entry.children);
+		} catch (error) {
+			errors.push(error);
 		}
+	}
+	return errors;
+}
+function captureRootHost(root) {
+	const snapshot = captureRootTree(root);
+	return { restore: () => restoreRootTree(snapshot) };
+}
+//#endregion
+//#region src/boot/root-handler.ts
+function wrapRootRouteHandler(componentFn, cspNonce) {
+	const wrappedFn = (props, ctx) => {
+		const out = componentFn(props, ctx);
+		assertSyncComponentResult(out);
+		const portalVNode = {
+			$$typeof: ELEMENT_TYPE,
+			type: getDefaultPortalHost(),
+			props: { __askrAutoDefaultPortal: true },
+			key: "__default_portal"
+		};
+		const root = {
+			$$typeof: ELEMENT_TYPE,
+			type: Fragment,
+			props: { children: out === void 0 || out === null ? [portalVNode] : [out, portalVNode] }
+		};
+		return cspNonce === void 0 ? root : CspNonceScope({
+			value: cspNonce,
+			children: root
+		});
+	};
+	Object.defineProperty(wrappedFn, "name", { value: componentFn.name || "Component" });
+	return wrappedFn;
+}
+//#endregion
+//#region src/boot/root-update.ts
+function prepare(root, input) {
+	const instance = root;
+	const generation = captureComponentGeneration(instance);
+	const host = captureRootHost(instance.target);
+	const current = instance._appRenderRuntime;
+	const runtime = createAppRenderRuntime({
+		framework: withoutRouteHydrationMetadata(current?.framework),
+		dataRuntime: current?.dataRuntime,
+		routeRegistry: current?.routeRegistry,
+		routeAuth: current?.routeAuth,
+		route: input.routeData,
+		hasRoute: input.hasRouteData
 	});
-	if (deferredBoundaries.length === 0) releaseSelectiveHydrationResources();
+	let applied = false;
+	let settled = false;
+	return {
+		apply() {
+			if (applied) return;
+			applied = true;
+			stageAppRenderRouteLocation(runtime, input.href);
+			instance._appRenderRuntime = runtime;
+			if (input.replaceLifetime) {
+				clearRegisteredDefaultPortalForInstance(instance);
+				generation.prepare(wrapRootRouteHandler(input.handler, instance._cspNonce), {});
+				executeComponent(instance);
+			} else instance._enqueueRun?.();
+		},
+		publish() {
+			clearStagedAppRenderRouteLocation(runtime);
+		},
+		rollback() {
+			if (settled) return [];
+			settled = true;
+			clearStagedAppRenderRouteLocation(runtime);
+			return applied ? generation.rollback(() => host.restore()) : [];
+		},
+		retire() {
+			if (settled) return [];
+			settled = true;
+			const errors = [];
+			if (applied && input.replaceLifetime) try {
+				generation.retire();
+			} catch (error) {
+				errors.push(error);
+			}
+			return errors;
+		}
+	};
+}
+function installRootUpdateHost() {
+	configureRootUpdateHost({ prepare });
+}
+//#endregion
+//#region src/boot/runtime-wiring.ts
+let bridged = false;
+/**
+* Browser composition owns the connection between execution and rendering.
+*
+* Installs unconditionally: importing the boot entry means native boot owns the
+* renderer, replacing whatever a consumer had configured before that point.
+*/
+function installRendererBridge() {
+	bridged = true;
+	installRuntimeRenderer(createRendererCapabilities());
+	return true;
+}
+/**
+* Connect execution to the DOM renderer only if nothing has yet.
+*
+* Unlike the install above this leaves an already-installed host alone, so a
+* renderer a consumer configured after composing boot survives. Kept in this
+* module rather than the composition root so a caller that only needs
+* rendering — driving the runtime directly, as the jsdom test environment does
+* — does not pull root-lifetime wiring into its module graph.
+*/
+function ensureRendererBridge() {
+	if (bridged) return;
+	installRendererBridge();
+}
+//#endregion
+//#region src/boot/composition.ts
+let rootUpdateHosted = false;
+function ensureRootUpdateHost() {
+	if (rootUpdateHosted) return;
+	rootUpdateHosted = true;
+	installRootUpdateHost();
+}
+/**
+* Browser composition root, owned by the boot entry.
+*
+* Wiring a host is composition, not an import side effect of an implementation
+* module: when these calls lived at the top of root-lifecycle.ts, the import
+* order of unrelated modules decided whether a host existed. An entry barrel is
+* where composition belongs, so importing `@askrjs/askr/boot` installs the
+* native renderer — that is the contract consumers rely on.
+*/
+function composeBrowserRuntime() {
+	installRendererBridge();
+	ensureRootUpdateHost();
+}
+/**
+* Compose whatever is still missing, for a mount reached without the boot entry.
+*
+* Non-clobbering: a renderer the consumer configured after composing boot stays
+* installed across mounts.
+*/
+function ensureBrowserRuntime() {
+	ensureRendererBridge();
+	ensureRootUpdateHost();
 }
 //#endregion
 //#region src/boot/root-element.ts
@@ -182,18 +322,13 @@ function resolveRootElement(root) {
 }
 //#endregion
 //#region src/boot/root-lifecycle.ts
-installRendererBridge();
 let componentIdCounter = 0;
 const instancesByRoot = /* @__PURE__ */ new WeakMap();
 const routedRoots = /* @__PURE__ */ new Set();
 const CLEANUP_SYMBOL = Symbol.for("__askrCleanup__");
 const ROOT_CLEANUP_CALLBACKS_SYMBOL = Symbol.for("__askrRootCleanupCallbacks__");
 function clearRootCleanupCallbacks(rootElement) {
-	try {
-		delete rootElement[ROOT_CLEANUP_CALLBACKS_SYMBOL];
-	} catch {
-		rootElement[ROOT_CLEANUP_CALLBACKS_SYMBOL]?.clear();
-	}
+	if (!Reflect.deleteProperty(rootElement, ROOT_CLEANUP_CALLBACKS_SYMBOL)) rootElement[ROOT_CLEANUP_CALLBACKS_SYMBOL]?.clear();
 }
 function registerRootCleanupCallback(rootElement, callback) {
 	const elementWithCleanup = rootElement;
@@ -202,44 +337,31 @@ function registerRootCleanupCallback(rootElement, callback) {
 	elementWithCleanup[ROOT_CLEANUP_CALLBACKS_SYMBOL] = callbacks;
 	return () => {
 		callbacks.delete(callback);
-		if (callbacks.size === 0) clearRootCleanupCallbacks(rootElement);
+		if (callbacks.size === 0 && elementWithCleanup[ROOT_CLEANUP_CALLBACKS_SYMBOL] === callbacks) clearRootCleanupCallbacks(rootElement);
 	};
 }
-function runRootCleanupCallbacks(rootElement, errors) {
-	const callbacks = rootElement[ROOT_CLEANUP_CALLBACKS_SYMBOL];
-	if (!callbacks || callbacks.size === 0) {
-		clearRootCleanupCallbacks(rootElement);
-		return;
-	}
-	clearRootCleanupCallbacks(rootElement);
-	for (const callback of callbacks) try {
-		callback();
-	} catch (e) {
-		errors.push(e);
-	}
-}
 function cleanupRootInstance(rootElement, instance, options) {
+	if (instancesByRoot.get(rootElement) !== instance) return;
+	const element = rootElement;
+	const cleanup = element[CLEANUP_SYMBOL];
+	const callbacks = element[ROOT_CLEANUP_CALLBACKS_SYMBOL];
+	const wasRoutedRoot = routedRoots.delete(rootElement);
+	instancesByRoot.delete(rootElement);
+	clearRootCleanupCallbacks(rootElement);
+	Reflect.deleteProperty(element, CLEANUP_SYMBOL);
+	clearDeferredHydrationBoundaries(rootElement);
 	const errors = [];
-	try {
-		teardownNodeSubtree(rootElement);
-	} catch (e) {
-		errors.push(e);
-	}
-	try {
-		cleanupComponent(instance);
+	for (const phase of [[() => teardownNodeSubtree(rootElement), () => cleanupComponent(instance)], callbacks ?? []]) for (const callback of phase) try {
+		callback();
 	} catch (e) {
 		errors.push(e);
 	}
-	runRootCleanupCallbacks(rootElement, errors);
-	clearDeferredHydrationBoundaries(rootElement);
-	if (!options?.preserveInstance) {
-		unregisterAppInstance(instance);
-		instancesByRoot.delete(rootElement);
-		clearRootCleanupCallbacks(rootElement);
-		try {
-			delete rootElement[CLEANUP_SYMBOL];
-		} catch {}
-	}
+	if (options?.preserveInstance && !instancesByRoot.has(rootElement)) {
+		instancesByRoot.set(rootElement, instance);
+		element[CLEANUP_SYMBOL] = cleanup;
+		if (wasRoutedRoot) routedRoots.add(rootElement);
+	} else unregisterAppInstance(instance);
+	if (wasRoutedRoot && routedRoots.size === 0) clearRouteState();
 	if (errors.length > 0) {
 		if (instance.cleanupStrict) throw new AggregateError(errors, `cleanup failed for app root`);
 		else if (isDevelopmentEnvironment()) for (const err of errors) logger.warn("[Askr] cleanup error:", err);
@@ -249,45 +371,36 @@ function attachCleanupForRoot(rootElement, instance) {
 	rootElement[CLEANUP_SYMBOL] = (options) => {
 		cleanupRootInstance(rootElement, instance, options);
 	};
+	registerRootCleanupCallback(rootElement, () => {
+		disposeRegisteredDefaultPortalScope(instance.portalScope ?? instance);
+	});
 	try {
 		const descriptor = Object.getOwnPropertyDescriptor(rootElement, "innerHTML") || Object.getOwnPropertyDescriptor(Object.getPrototypeOf(rootElement), "innerHTML") || Object.getOwnPropertyDescriptor(Element.prototype, "innerHTML");
 		if (descriptor && (descriptor.get || descriptor.set)) Object.defineProperty(rootElement, "innerHTML", {
-			get: descriptor.get ? function() {
-				return descriptor.get.call(this);
-			} : void 0,
+			get: function() {
+				return descriptor.get?.call(this);
+			},
 			set: function(value) {
-				if (value === "" && instancesByRoot.get(this) === instance) cleanupRootInstance(rootElement, instance);
-				if (descriptor.set) return descriptor.set.call(this, value);
+				if (value === "" && instancesByRoot.get(this) === instance) {
+					cleanupRootInstance(rootElement, instance);
+					if (instancesByRoot.has(this)) return;
+				}
+				return descriptor.set?.call(this, value);
 			},
 			configurable: true
 		});
 	} catch {}
 }
 function mountOrUpdate(rootElement, componentFn, options) {
+	ensureBrowserRuntime();
 	const nonce = validateCspNonce(options?.cspNonce);
-	const wrappedFn = (props, ctx) => {
-		const out = componentFn(props, ctx);
-		if (isPromiseLike(out)) throw new Error("Async components are not supported. Components must return synchronously.");
-		const portalVNode = {
-			$$typeof: ELEMENT_TYPE,
-			type: getDefaultPortalHost(),
-			props: { __askrAutoDefaultPortal: true },
-			key: "__default_portal"
-		};
-		const root = {
-			$$typeof: ELEMENT_TYPE,
-			type: Fragment,
-			props: { children: out === void 0 || out === null ? [portalVNode] : [out, portalVNode] }
-		};
-		return nonce === void 0 ? root : CspNonceScope({
-			value: nonce,
-			children: root
-		});
-	};
-	Object.defineProperty(wrappedFn, "name", { value: componentFn.name || "Component" });
+	const wrappedFn = wrapRootRouteHandler(componentFn, nonce);
 	const existingCleanup = rootElement[CLEANUP_SYMBOL];
 	const reusedExistingInstance = typeof existingCleanup === "function";
-	if (reusedExistingInstance) existingCleanup({ preserveInstance: true });
+	if (reusedExistingInstance) {
+		existingCleanup({ preserveInstance: true });
+		if (rootElement[CLEANUP_SYMBOL] !== existingCleanup) return;
+	}
 	let instance = instancesByRoot.get(rootElement);
 	if (instance) {
 		const shouldResetHookState = instance._rootComponentFn !== componentFn;
@@ -299,51 +412,19 @@ function mountOrUpdate(rootElement, componentFn, options) {
 				if (isDevelopmentEnvironment()) logger.warn("[Askr] prior cleanup threw:", e);
 			}
 		}
-		instance.fn = wrappedFn;
-		instance._rootComponentFn = componentFn;
-		instance.evaluationGeneration++;
-		instance.mounted = false;
-		instance.expectedStateIndices = [];
-		instance.firstRenderComplete = false;
-		instance.isRoot = true;
-		instance.portalScope = instance;
-		instance._appRenderRuntime = options?.appRuntime;
-		instance._cspNonce = nonce;
-		if (shouldResetHookState) {
-			instance.stateValues = [];
-			instance.hasPendingUpdate = false;
-			instance.notifyUpdate = null;
-			instance.stateIndexCheck = -1;
-			instance.mountOperations = void 0;
-			instance.commitOperations = void 0;
-			instance.lifecycleSlots = void 0;
-			instance.cleanupFns = void 0;
-			instance._currentRenderToken = void 0;
-			instance.lastRenderToken = 0;
-			instance._pendingReadSources = void 0;
-			instance._lastReadSources = void 0;
-			instance._placeholder = void 0;
-			instance.errorBoundaryState = void 0;
-			instance._portalErrorParent = void 0;
-			instance._portalErrorParentGeneration = void 0;
-			instance.devWarningsEmitted = void 0;
-		}
-		if (options && typeof options.cleanupStrict === "boolean") instance.cleanupStrict = options.cleanupStrict;
+		restartComponentGeneration(instance, wrappedFn, !shouldResetHookState);
 	} else {
 		const componentId = String(++componentIdCounter);
-		instance = createComponentInstance(componentId, wrappedFn, {}, rootElement);
+		instance = createComponentInstance(componentId, wrappedFn, {}, rootElement, null);
 		instancesByRoot.set(rootElement, instance);
-		instance.isRoot = true;
-		instance._rootComponentFn = componentFn;
-		instance.portalScope = instance;
-		instance._appRenderRuntime = options?.appRuntime;
-		instance._cspNonce = nonce;
-		if (options && typeof options.cleanupStrict === "boolean") instance.cleanupStrict = options.cleanupStrict;
 	}
+	instance.isRoot = true;
+	instance._rootComponentFn = componentFn;
+	instance.portalScope = instance;
+	instance._appRenderRuntime = options?.appRuntime;
+	instance._cspNonce = nonce;
+	if (options && typeof options.cleanupStrict === "boolean") instance.cleanupStrict = options.cleanupStrict;
 	attachCleanupForRoot(rootElement, instance);
-	registerRootCleanupCallback(rootElement, () => {
-		disposeRegisteredDefaultPortalScope(instance.portalScope ?? instance);
-	});
 	executeComponent(instance);
 	flushRuntimeScheduler();
 }
@@ -355,6 +436,7 @@ function activateHydrationBoundary(rootElement, boundary) {
 	return activated;
 }
 async function registerAppNavigation(rootElement, path, source) {
+	ensureBrowserRuntime();
 	const instance = instancesByRoot.get(rootElement);
 	if (!instance) throw new Error("Internal error: app instance missing");
 	routedRoots.add(rootElement);
@@ -370,75 +452,346 @@ function cleanupApp(root) {
 	const rootElement = resolveRootElement(root);
 	if (!rootElement) return;
 	const cleanupFn = rootElement[CLEANUP_SYMBOL];
-	try {
-		if (typeof cleanupFn === "function") cleanupFn();
-	} finally {
-		const wasRoutedRoot = routedRoots.delete(rootElement);
-		instancesByRoot.delete(rootElement);
-		clearRootCleanupCallbacks(rootElement);
-		if (wasRoutedRoot && routedRoots.size === 0) clearRouteState();
+	if (typeof cleanupFn === "function") cleanupFn();
+	else clearRootCleanupCallbacks(rootElement);
+}
+/** Check whether an app instance is currently mounted at `root`. */
+function hasApp(root) {
+	const rootElement = resolveRootElement(root);
+	if (!rootElement) return false;
+	return instancesByRoot.has(rootElement);
+}
+//#endregion
+//#region src/boot/islands.ts
+/**
+* createIsland: Enhances existing DOM (no router, mounts once)
+*/
+function createIsland(config) {
+	assertExecutionModel("islands");
+	if (!config || typeof config !== "object") throw new Error("createIsland requires a config object");
+	if (typeof config.component !== "function") throw new Error("createIsland: component must be a function");
+	validateCspNonce(config.cspNonce);
+	const rootElement = resolveRootElement(config.root);
+	if (!rootElement) throw new Error(`Root element not found: ${config.root}`);
+	if ("routes" in config) throw new Error("createIsland does not accept routes; use createSPA for routed apps");
+	if (hasRegisteredRoutes()) throw new Error("Routes are not supported with islands. Use createSPA (client) or createSSR (server) instead.");
+	mountOrUpdate(rootElement, config.component, {
+		cleanupStrict: config.cleanupStrict,
+		cspNonce: config.cspNonce,
+		appRuntime: createAppRenderRuntime({ dataRuntime: config.dataRuntime ?? getDefaultDataRuntime() })
+	});
+}
+/**
+* createIslands: Enhances one or more existing DOM roots (no router).
+* The only public islands constructor.
+*/
+function createIslands(config) {
+	assertExecutionModel("islands");
+	if (!config || typeof config !== "object") throw new Error("createIslands requires a config object");
+	validateCspNonce(config.cspNonce);
+	if (!Array.isArray(config.islands) || config.islands.length === 0) throw new Error("createIslands requires a non-empty islands array");
+	for (const island of config.islands) createIsland({
+		...island,
+		cspNonce: island.cspNonce ?? config.cspNonce
+	});
+}
+//#endregion
+//#region src/boot/route-startup.ts
+const MAX_INITIAL_ROUTE_REDIRECTS = 20;
+function bindResolvedRouteHandler(resolved) {
+	return () => resolved.handler(resolved.params);
+}
+function createDeniedStatusNode(status) {
+	return {
+		type: "div",
+		props: { "data-route-denied": String(status) },
+		children: [String(status)]
+	};
+}
+function bindDeniedStatus(status) {
+	return () => createDeniedStatusNode(status);
+}
+function bindDeniedRouteHandler(status) {
+	return () => createDeniedStatusNode(status);
+}
+async function reconcileInitialRouteMetadata(resolved) {
+	if (resolved?.kind !== "render" || !resolved.record) return;
+	if (!resolved.record.options.title && !resolved.record.options.meta && !resolved.record.metaChain?.length) return;
+	const context = getRouteRenderContext(resolved);
+	if (!context) return;
+	reconcileRouteMeta(await resolveRouteMeta(resolved.record, context));
+}
+async function resolveInitialRoute(auth, source) {
+	let path = typeof window !== "undefined" ? window.location.pathname : "/";
+	let href = typeof window !== "undefined" ? `${window.location.pathname}${window.location.search}${window.location.hash}` : path;
+	const visited = /* @__PURE__ */ new Set();
+	for (let redirects = 0; redirects <= MAX_INITIAL_ROUTE_REDIRECTS; redirects++) {
+		if (visited.has(href)) throw new Error(`[Askr] Route redirect cycle detected at ${href}.`);
+		visited.add(href);
+		if (!source?.registry) throw new TypeError("resolveInitialRoute requires a route registry.");
+		const resolved = await resolveRouteRequest(href, {
+			registry: source.registry,
+			auth,
+			load: source.load
+		});
+		if (typeof window === "undefined" || !resolved || resolved.kind !== "redirect") return {
+			path,
+			href,
+			resolved
+		};
+		const redirectTarget = new URL(resolved.to, window.location.href);
+		const redirectHref = `${redirectTarget.pathname}${redirectTarget.search}${redirectTarget.hash}`;
+		window.history.replaceState({ path: redirectHref }, "", redirectHref);
+		path = redirectTarget.pathname;
+		href = redirectHref;
+	}
+	throw new Error(`[Askr] Route redirect limit exceeded (${MAX_INITIAL_ROUTE_REDIRECTS}).`);
+}
+//#endregion
+//#region src/boot/spa.ts
+/**
+* App bootstrap and mount
+*/
+/**
+* createSPA: Initializes the router and mounts the app with an explicit route registry.
+* ```ts
+* import { createRouteRegistry } from '@askrjs/askr/router';
+* const registry = createRouteRegistry(() => { ... });
+* await createSPA({ root: '#app', registry });
+* ```
+*
+*/
+async function createSPA(config) {
+	assertExecutionModel("spa");
+	if (!config || typeof config !== "object") throw new Error("createSPA requires a config object");
+	validateCspNonce(config.cspNonce);
+	if (!config.registry) throw new Error("createSPA requires a route registry.");
+	const { manifest } = config.registry;
+	if (manifest.records.length === 0) throw new Error("createSPA requires a route registry with at least one route. If you are enhancing existing HTML, use createIsland instead.");
+	const rootElement = resolveRootElement(config.root);
+	if (!rootElement) throw new Error(`Root element not found: ${config.root}`);
+	configureScrollRestoration(config.scrollRestoration);
+	clearRouteState();
+	_applyManifest(manifest);
+	const routeAuth = config.auth ?? manifest.auth;
+	const appRouteSource = {
+		registry: config.registry,
+		auth: routeAuth
+	};
+	_setActiveRouteAuthOptions(routeAuth);
+	if (isProductionEnvironment()) lockRouteRegistration();
+	const { path, href: currentUrl, resolved } = await resolveInitialRoute(routeAuth, { registry: config.registry });
+	setServerLocation(currentUrl);
+	const appRuntime = createAppRenderRuntime({
+		...resolved?.kind === "render" && hasRouteRenderData(resolved) ? {
+			route: getRouteRenderData(resolved),
+			hasRoute: true
+		} : {},
+		dataRuntime: config.dataRuntime ?? getDefaultDataRuntime(),
+		routeRegistry: config.registry,
+		routeAuth
+	});
+	if (!resolved) {
+		mountOrUpdate(rootElement, () => ({
+			type: "div",
+			children: []
+		}), {
+			cleanupStrict: config.cleanupStrict,
+			appRuntime,
+			cspNonce: config.cspNonce
+		});
+		await registerAppNavigation(rootElement, path, {
+			...appRouteSource,
+			runtime: appRuntime
+		});
+		return;
+	}
+	if (resolved.kind === "redirect") {
+		mountOrUpdate(rootElement, () => ({
+			type: "div",
+			children: []
+		}), {
+			cleanupStrict: config.cleanupStrict,
+			appRuntime,
+			cspNonce: config.cspNonce
+		});
+		await registerAppNavigation(rootElement, path, {
+			...appRouteSource,
+			runtime: appRuntime
+		});
+		return;
+	}
+	await reconcileInitialRouteMetadata(resolved);
+	mountOrUpdate(rootElement, resolved.kind === "deny" ? bindDeniedStatus(resolved.status) : bindResolvedRouteHandler({
+		handler: resolved.handler,
+		params: resolved.params
+	}), {
+		cleanupStrict: config.cleanupStrict,
+		appRuntime,
+		cspNonce: config.cspNonce
+	});
+	await registerAppNavigation(rootElement, path, {
+		...appRouteSource,
+		runtime: appRuntime
+	});
+}
+//#endregion
+//#region src/boot/hydration.ts
+const DEFERRED_PAYLOAD = "__askr_deferred__";
+function applyDeferredStreamPatches(rootElement) {
+	const patches = Array.from(rootElement.querySelectorAll("template[data-askr-deferred-patch]"));
+	for (const template of patches) {
+		const id = template.getAttribute("data-askr-deferred-patch");
+		if (!id) continue;
+		const boundary = Array.from(rootElement.querySelectorAll("askr-resolve[data-askr-deferred]")).find((candidate) => candidate.getAttribute("data-askr-deferred") === id);
+		if (boundary) boundary.replaceWith(template.content.cloneNode(true));
+		template.remove();
+		for (const script of Array.from(rootElement.querySelectorAll("script[data-askr-deferred-apply]"))) if (script.getAttribute("data-askr-deferred-apply") === id) script.remove();
+	}
+}
+function hydrationReviver(_key, value) {
+	if (!value || typeof value !== "object") return value;
+	const payload = value;
+	if (payload[DEFERRED_PAYLOAD] === "fulfilled") return reviveDeferredValue("fulfilled", payload.value, void 0);
+	if (payload[DEFERRED_PAYLOAD] === "rejected") return reviveDeferredValue("rejected", void 0, payload.error);
+	return value;
+}
+function takeHydrationRenderData(rootElement) {
+	for (const child of Array.from(rootElement.children)) if (child instanceof HTMLScriptElement && child.getAttribute("data-askr-render-data") === "true") {
+		const raw = child.textContent ?? "";
+		child.remove();
+		if (!raw) return pageRenderEnvelope(void 0);
 		try {
-			delete rootElement[CLEANUP_SYMBOL];
+			return pageRenderEnvelope(JSON.parse(raw, hydrationReviver));
+		} catch (err) {
+			const error = /* @__PURE__ */ new Error("[Askr] Failed to parse embedded SSR render data during hydration.");
+			error.cause = err;
+			throw error;
+		}
+	}
+	return null;
+}
+function markSkippedElements(root, skipSelectors) {
+	if (skipSelectors.length === 0) return;
+	const selectorList = Array.from(new Set(skipSelectors)).join(", ");
+	root.querySelectorAll(selectorList).forEach((el) => el.setAttribute("data-skip-hydrate", "true"));
+}
+function collectDeferredBelowFoldBoundaries(root, foldY) {
+	const boundaries = [];
+	const stack = [];
+	for (let index = root.children.length - 1; index >= 0; index -= 1) stack.push(root.children[index]);
+	while (stack.length > 0) {
+		const element = stack.pop();
+		if (element.hasAttribute("data-skip-hydrate")) continue;
+		if (element.getBoundingClientRect().top >= foldY) {
+			element.setAttribute("data-skip-hydrate", "true");
+			registerDeferredHydrationBoundary(root, element);
+			boundaries.push(element);
+			continue;
+		}
+		for (let index = element.children.length - 1; index >= 0; index -= 1) stack.push(element.children[index]);
+	}
+	return boundaries;
+}
+function activateVisibleDeferredBoundaries(root, boundaries, foldY, activate) {
+	let activated = false;
+	let remaining = 0;
+	for (const element of boundaries) {
+		if (!element.hasAttribute("data-skip-hydrate")) continue;
+		if (element.getBoundingClientRect().top < foldY) try {
+			if (activate(root, element)) activated = true;
 		} catch {}
+		if (element.hasAttribute("data-skip-hydrate")) remaining += 1;
 	}
-}
-/** Check whether an app instance is currently mounted at `root`. */
-function hasApp(root) {
-	const rootElement = resolveRootElement(root);
-	if (!rootElement) return false;
-	return instancesByRoot.has(rootElement);
-}
-//#endregion
-//#region src/boot/route-startup.ts
-const MAX_INITIAL_ROUTE_REDIRECTS = 20;
-function bindResolvedRouteHandler(resolved) {
-	return () => resolved.handler(resolved.params);
-}
-function createDeniedStatusNode(status) {
 	return {
-		type: "div",
-		props: { "data-route-denied": String(status) },
-		children: [String(status)]
+		activated,
+		remaining
 	};
 }
-function bindDeniedStatus(status) {
-	return () => createDeniedStatusNode(status);
-}
-function bindDeniedRouteHandler(status) {
-	return () => createDeniedStatusNode(status);
+function queueIdleWork(work) {
+	return new Promise((resolve) => {
+		if (typeof requestIdleCallback !== "undefined") {
+			requestIdleCallback(() => {
+				work();
+				resolve();
+			}, { timeout: 2e3 });
+			return;
+		}
+		setTimeout(() => {
+			work();
+			resolve();
+		}, 0);
+	});
 }
-async function reconcileInitialRouteMetadata(resolved) {
-	if (resolved?.kind !== "render" || !resolved.record) return;
-	if (!resolved.record.options.title && !resolved.record.options.meta && !resolved.record.metaChain?.length) return;
-	const context = getRouteRenderContext(resolved);
-	if (!context) return;
-	reconcileRouteMeta(await resolveRouteMeta(resolved.record, context));
+function shouldVerifyHydrationMarkup(config) {
+	const explicit = config.hydrate?.verifyMarkup;
+	if (typeof explicit === "boolean") return explicit;
+	return !isProductionEnvironment();
 }
-async function resolveInitialRoute(auth, source) {
-	let path = typeof window !== "undefined" ? window.location.pathname : "/";
-	let href = typeof window !== "undefined" ? `${window.location.pathname}${window.location.search}${window.location.hash}` : path;
-	const visited = /* @__PURE__ */ new Set();
-	for (let redirects = 0; redirects <= MAX_INITIAL_ROUTE_REDIRECTS; redirects++) {
-		if (visited.has(href)) throw new Error(`[Askr] Route redirect cycle detected at ${href}.`);
-		visited.add(href);
-		if (!source?.registry) throw new TypeError("resolveInitialRoute requires a route registry.");
-		const resolved = await resolveRouteRequest(href, {
-			registry: source.registry,
-			auth,
-			load: source.load
-		});
-		if (typeof window === "undefined" || !resolved || resolved.kind !== "redirect") return {
-			path,
-			href,
-			resolved
+async function applySelectiveHydration(rootElement, resolved, path, cleanupStrict, hydrateOptions, source, hooks, interactionReplay) {
+	const hasBelowFoldDeferral = !!hydrateOptions.deferBelowFold;
+	let staticChildSlotsCacheSuspended = false;
+	let releaseSelectiveHydrationResources = () => {};
+	const restoreStaticChildSlotsCache = () => {
+		if (!staticChildSlotsCacheSuspended) return;
+		setStaticChildSlotsCacheEnabled(true);
+		staticChildSlotsCacheSuspended = false;
+	};
+	if (hydrateOptions.skipSelectors?.length) markSkippedElements(rootElement, hydrateOptions.skipSelectors);
+	let deferredBoundaries = [];
+	if (hydrateOptions.deferBelowFold) {
+		setStaticChildSlotsCacheEnabled(false);
+		staticChildSlotsCacheSuspended = true;
+		const foldY = hydrateOptions.foldThreshold ?? window.innerHeight;
+		deferredBoundaries = collectDeferredBelowFoldBoundaries(rootElement, foldY);
+		interactionReplay.registerDeferredBoundaries(deferredBoundaries);
+		let selectiveHydrationResourcesReleased = false;
+		let unregisterRootCleanupCallback = () => {};
+		function handleScroll() {
+			const { activated, remaining } = activateVisibleDeferredBoundaries(rootElement, deferredBoundaries, foldY, hooks.activateHydrationBoundary);
+			if (!activated) return;
+			if (remaining === 0) releaseSelectiveHydrationResources();
+		}
+		releaseSelectiveHydrationResources = () => {
+			if (selectiveHydrationResourcesReleased) return;
+			selectiveHydrationResourcesReleased = true;
+			unregisterRootCleanupCallback();
+			window.removeEventListener("scroll", handleScroll);
+			restoreStaticChildSlotsCache();
+			interactionReplay.clearDeferredBoundaries();
 		};
-		const redirectTarget = new URL(resolved.to, window.location.href);
-		const redirectHref = `${redirectTarget.pathname}${redirectTarget.search}${redirectTarget.hash}`;
-		window.history.replaceState({ path: redirectHref }, "", redirectHref);
-		path = redirectTarget.pathname;
-		href = redirectHref;
+		interactionReplay.setOnDeferredBoundariesDrained(releaseSelectiveHydrationResources);
+		unregisterRootCleanupCallback = hooks.registerRootCleanupCallback(rootElement, releaseSelectiveHydrationResources);
+		window.addEventListener("scroll", handleScroll, { passive: true });
 	}
-	throw new Error(`[Askr] Route redirect limit exceeded (${MAX_INITIAL_ROUTE_REDIRECTS}).`);
+	if (hydrateOptions.deferUntilIdle && !hasBelowFoldDeferral) {
+		await queueIdleWork(() => {
+			hooks.mountOrUpdate(rootElement, (() => resolved.handler(resolved.params)), {
+				cleanupStrict,
+				appRuntime: source?.runtime
+			});
+		});
+		await hooks.registerAppNavigation(rootElement, path, source);
+		return;
+	}
+	try {
+		hooks.mountOrUpdate(rootElement, (() => resolved.handler(resolved.params)), {
+			cleanupStrict,
+			appRuntime: source?.runtime
+		});
+		await hooks.registerAppNavigation(rootElement, path, source);
+	} catch (error) {
+		releaseSelectiveHydrationResources();
+		throw error;
+	}
+	if (hydrateOptions.deferUntilIdle && deferredBoundaries.length > 0) await queueIdleWork(() => {
+		try {
+			activateVisibleDeferredBoundaries(rootElement, deferredBoundaries, Number.POSITIVE_INFINITY, hooks.activateHydrationBoundary);
+		} finally {
+			releaseSelectiveHydrationResources();
+		}
+	});
+	if (deferredBoundaries.length === 0) releaseSelectiveHydrationResources();
 }
 //#endregion
 //#region src/boot/hydration-interaction-replay.ts
@@ -610,125 +963,11 @@ function beginHydrationInteractionReplay(root, activateBoundary, permanentSkipSe
 	};
 }
 //#endregion
-//#region src/boot/index.ts
+//#region src/boot/hydrate-spa.ts
 /**
 * App bootstrap and mount
 */
 /**
-* createIsland: Enhances existing DOM (no router, mounts once)
-*/
-function createIsland(config) {
-	assertExecutionModel("islands");
-	if (!config || typeof config !== "object") throw new Error("createIsland requires a config object");
-	if (typeof config.component !== "function") throw new Error("createIsland: component must be a function");
-	validateCspNonce(config.cspNonce);
-	const rootElement = resolveRootElement(config.root);
-	if (!rootElement) throw new Error(`Root element not found: ${config.root}`);
-	if ("routes" in config) throw new Error("createIsland does not accept routes; use createSPA for routed apps");
-	if (hasRegisteredRoutes()) throw new Error("Routes are not supported with islands. Use createSPA (client) or createSSR (server) instead.");
-	mountOrUpdate(rootElement, config.component, {
-		cleanupStrict: config.cleanupStrict,
-		cspNonce: config.cspNonce
-	});
-}
-/**
-* createIslands: Enhances one or more existing DOM roots (no router).
-* The only public islands constructor.
-*/
-function createIslands(config) {
-	assertExecutionModel("islands");
-	if (!config || typeof config !== "object") throw new Error("createIslands requires a config object");
-	validateCspNonce(config.cspNonce);
-	if (!Array.isArray(config.islands) || config.islands.length === 0) throw new Error("createIslands requires a non-empty islands array");
-	for (const island of config.islands) createIsland({
-		...island,
-		cspNonce: island.cspNonce ?? config.cspNonce
-	});
-}
-/**
-* createSPA: Initializes the router and mounts the app with an explicit route registry.
-* ```ts
-* import { createRouteRegistry } from '@askrjs/askr/router';
-* const registry = createRouteRegistry(() => { ... });
-* await createSPA({ root: '#app', registry });
-* ```
-*
-*/
-async function createSPA(config) {
-	assertExecutionModel("spa");
-	if (!config || typeof config !== "object") throw new Error("createSPA requires a config object");
-	validateCspNonce(config.cspNonce);
-	if (!config.registry) throw new Error("createSPA requires a route registry.");
-	const { manifest } = config.registry;
-	if (manifest.records.length === 0) throw new Error("createSPA requires a route registry with at least one route. If you are enhancing existing HTML, use createIsland instead.");
-	const rootElement = resolveRootElement(config.root);
-	if (!rootElement) throw new Error(`Root element not found: ${config.root}`);
-	configureScrollRestoration(config.scrollRestoration);
-	clearRouteState();
-	_applyManifest(manifest);
-	const routeAuth = config.auth ?? manifest.auth;
-	const appRouteSource = {
-		registry: config.registry,
-		auth: routeAuth
-	};
-	_setActiveRouteAuthOptions(routeAuth);
-	if (isProductionEnvironment()) lockRouteRegistration();
-	const { path, href: currentUrl, resolved } = await resolveInitialRoute(routeAuth, { registry: config.registry });
-	setServerLocation(currentUrl);
-	const appRuntime = createAppRenderRuntime({
-		...resolved?.kind === "render" && hasRouteRenderData(resolved) ? {
-			route: getRouteRenderData(resolved),
-			hasRoute: true
-		} : {},
-		dataRuntime: config.dataRuntime ?? getDefaultDataRuntime(),
-		routeRegistry: config.registry,
-		routeAuth
-	});
-	if (!resolved) {
-		mountOrUpdate(rootElement, () => ({
-			type: "div",
-			children: []
-		}), {
-			cleanupStrict: config.cleanupStrict,
-			appRuntime,
-			cspNonce: config.cspNonce
-		});
-		await registerAppNavigation(rootElement, path, {
-			...appRouteSource,
-			runtime: appRuntime
-		});
-		return;
-	}
-	if (resolved.kind === "redirect") {
-		mountOrUpdate(rootElement, () => ({
-			type: "div",
-			children: []
-		}), {
-			cleanupStrict: config.cleanupStrict,
-			appRuntime,
-			cspNonce: config.cspNonce
-		});
-		await registerAppNavigation(rootElement, path, {
-			...appRouteSource,
-			runtime: appRuntime
-		});
-		return;
-	}
-	await reconcileInitialRouteMetadata(resolved);
-	mountOrUpdate(rootElement, resolved.kind === "deny" ? bindDeniedStatus(resolved.status) : bindResolvedRouteHandler({
-		handler: resolved.handler,
-		params: resolved.params
-	}), {
-		cleanupStrict: config.cleanupStrict,
-		appRuntime,
-		cspNonce: config.cspNonce
-	});
-	await registerAppNavigation(rootElement, path, {
-		...appRouteSource,
-		runtime: appRuntime
-	});
-}
-/**
 * hydrateSPA: Hydrate server-rendered HTML with an explicit route registry.
 */
 async function hydrateSPA(config) {
@@ -775,16 +1014,13 @@ async function hydrateSPA(config) {
 		const hydrationResolved = resolved.kind === "deny" ? {
 			handler: bindDeniedRouteHandler(resolved.status),
 			params: {}
-		} : {
-			handler: resolved.handler,
-			params: resolved.params
-		};
+		} : resolved;
 		const mountHydratedRoot = (...args) => withIntrinsicHydrationAdoption(() => mountOrUpdate(args[0], args[1], {
 			...args[2],
 			cspNonce: config.cspNonce
 		}));
 		if (shouldVerifyHydrationMarkup(config)) {
-			const { verifyHydrationSyncForUrl } = await import("./verify-hydration-_Q6avFp0.js");
+			const { verifyHydrationSyncForUrl } = await import("./verify-hydration-ikaxotf7.js");
 			if (!verifyHydrationSyncForUrl({
 				root: rootElement,
 				url: currentUrl,
@@ -841,4 +1077,8 @@ async function hydrateSPA(config) {
 	}
 }
 //#endregion
-export { cleanupApp as a, hydrateSPA as i, createIslands as n, hasApp as o, createSPA as r, createIsland as t };
+//#region src/boot/index.ts
+/** Stable bootstrap exports; each mounting mode owns its orchestration. */
+composeBrowserRuntime();
+//#endregion
+export { cleanupApp as a, createIslands as i, createSPA as n, hasApp as o, createIsland as r, installRendererBridge as s, hydrateSPA as t };