@askrjs/askr 0.3.0 → 0.4.0

package/dist/boot-BMBMWUGI.js

@@ -1,1084 +0,0 @@
-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 { 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 { 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;
-	}
-}
-/** 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);
-		}
-	};
-}
-//#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 {
-		root,
-		nodes
-	};
-}
-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;
-		}
-		for (const child of Array.from(node.childNodes)) visit(child);
-	};
-	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) {
-		errors.push(error);
-	}
-	for (const entry of snapshot.nodes) {
-		const { node, attributes } = entry;
-		try {
-			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
-	});
-	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
-function resolveRootElement(root) {
-	if (typeof root !== "string") return root;
-	const id = root.startsWith("#") ? root.slice(1) : root;
-	return document.getElementById(id);
-}
-//#endregion
-//#region src/boot/root-lifecycle.ts
-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) {
-	if (!Reflect.deleteProperty(rootElement, ROOT_CLEANUP_CALLBACKS_SYMBOL)) rootElement[ROOT_CLEANUP_CALLBACKS_SYMBOL]?.clear();
-}
-function registerRootCleanupCallback(rootElement, callback) {
-	const elementWithCleanup = rootElement;
-	const callbacks = elementWithCleanup[ROOT_CLEANUP_CALLBACKS_SYMBOL] ?? /* @__PURE__ */ new Set();
-	callbacks.add(callback);
-	elementWithCleanup[ROOT_CLEANUP_CALLBACKS_SYMBOL] = callbacks;
-	return () => {
-		callbacks.delete(callback);
-		if (callbacks.size === 0 && elementWithCleanup[ROOT_CLEANUP_CALLBACKS_SYMBOL] === callbacks) clearRootCleanupCallbacks(rootElement);
-	};
-}
-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 = [];
-	for (const phase of [[() => teardownNodeSubtree(rootElement), () => cleanupComponent(instance)], callbacks ?? []]) for (const callback of phase) try {
-		callback();
-	} catch (e) {
-		errors.push(e);
-	}
-	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);
-	}
-}
-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: function() {
-				return descriptor.get?.call(this);
-			},
-			set: function(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 = wrapRootRouteHandler(componentFn, nonce);
-	const existingCleanup = rootElement[CLEANUP_SYMBOL];
-	const reusedExistingInstance = typeof existingCleanup === "function";
-	if (reusedExistingInstance) {
-		existingCleanup({ preserveInstance: true });
-		if (rootElement[CLEANUP_SYMBOL] !== existingCleanup) return;
-	}
-	let instance = instancesByRoot.get(rootElement);
-	if (instance) {
-		const shouldResetHookState = instance._rootComponentFn !== componentFn;
-		if (!reusedExistingInstance) {
-			removeAllListeners(rootElement);
-			try {
-				cleanupComponent(instance);
-			} catch (e) {
-				if (isDevelopmentEnvironment()) logger.warn("[Askr] prior cleanup threw:", e);
-			}
-		}
-		restartComponentGeneration(instance, wrappedFn, !shouldResetHookState);
-	} else {
-		const componentId = String(++componentIdCounter);
-		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;
-	attachCleanupForRoot(rootElement, instance);
-	executeComponent(instance);
-	flushRuntimeScheduler();
-}
-/** @internal Activate one deferred boundary without rerunning its root. */
-function activateHydrationBoundary(rootElement, boundary) {
-	if (!instancesByRoot.has(rootElement)) return false;
-	const activated = activateHydrationBoundary$1(boundary);
-	if (activated) flushRuntimeScheduler();
-	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);
-	registerAppInstance(instance, path, source);
-	initializeNavigation();
-}
-/**
-* Tear down the app mounted at `root`: runs its cleanup callbacks, clears
-* route state if it was the last routed root, and removes bookkeeping for
-* the root element.
-*/
-function cleanupApp(root) {
-	const rootElement = resolveRootElement(root);
-	if (!rootElement) return;
-	const cleanupFn = rootElement[CLEANUP_SYMBOL];
-	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 {
-			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;
-	}
-	return {
-		activated,
-		remaining
-	};
-}
-function queueIdleWork(work) {
-	return new Promise((resolve) => {
-		if (typeof requestIdleCallback !== "undefined") {
-			requestIdleCallback(() => {
-				work();
-				resolve();
-			}, { timeout: 2e3 });
-			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;
-	};
-	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);
-	} 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
-const HYDRATION_INTERACTION_TYPES = [
-	"click",
-	"dblclick",
-	"pointerdown",
-	"pointerup",
-	"keydown",
-	"keyup",
-	"input",
-	"change",
-	"submit"
-];
-function cloneInteractionEvent(event) {
-	const EventConstructor = event.constructor;
-	const eventWithDetails = event;
-	const init = {
-		bubbles: event.bubbles,
-		cancelable: event.cancelable,
-		composed: event.composed,
-		detail: eventWithDetails.detail,
-		view: eventWithDetails.view,
-		key: eventWithDetails.key,
-		code: eventWithDetails.code,
-		location: eventWithDetails.location,
-		repeat: eventWithDetails.repeat,
-		isComposing: eventWithDetails.isComposing,
-		ctrlKey: eventWithDetails.ctrlKey,
-		shiftKey: eventWithDetails.shiftKey,
-		altKey: eventWithDetails.altKey,
-		metaKey: eventWithDetails.metaKey,
-		button: eventWithDetails.button,
-		buttons: eventWithDetails.buttons,
-		clientX: eventWithDetails.clientX,
-		clientY: eventWithDetails.clientY,
-		screenX: eventWithDetails.screenX,
-		screenY: eventWithDetails.screenY,
-		pointerId: eventWithDetails.pointerId,
-		pointerType: eventWithDetails.pointerType,
-		isPrimary: eventWithDetails.isPrimary,
-		data: eventWithDetails.data,
-		inputType: eventWithDetails.inputType
-	};
-	try {
-		return new EventConstructor(event.type, init);
-	} catch {
-		return new Event(event.type, {
-			bubbles: event.bubbles,
-			cancelable: event.cancelable,
-			composed: event.composed
-		});
-	}
-}
-/**
-* Capture discrete interactions before hydrated handlers exist, then replay
-* them after the listener transaction commits. Deferred boundaries remain
-* interaction-activatable until they are revealed or the root is cleaned up.
-*/
-function beginHydrationInteractionReplay(root, activateBoundary, permanentSkipSelectors = []) {
-	const queued = [];
-	const deferredBoundaries = /* @__PURE__ */ new Set();
-	let active = true;
-	let hydratingRoot = true;
-	let replaying = false;
-	let hadDeferredBoundaries = false;
-	let onDeferredBoundariesDrained;
-	function isPermanentlySkipped(target) {
-		const element = target instanceof Element ? target : target instanceof Node ? target.parentElement : null;
-		if (!element) return false;
-		return permanentSkipSelectors.some((selector) => {
-			try {
-				return element.closest(selector) !== null;
-			} catch {
-				return false;
-			}
-		});
-	}
-	function findDeferredBoundary(target) {
-		if (!(target instanceof Node)) return;
-		for (const boundary of deferredBoundaries) if (boundary.hasAttribute("data-skip-hydrate") && boundary.contains(target)) return boundary;
-	}
-	function removeCaptureListeners() {
-		if (!active) return;
-		active = false;
-		for (const type of HYDRATION_INTERACTION_TYPES) root.removeEventListener(type, captureInteraction, true);
-	}
-	function releaseIfFinished() {
-		if (!hydratingRoot && deferredBoundaries.size === 0) removeCaptureListeners();
-	}
-	function notifyIfDeferredBoundariesDrained() {
-		if (hadDeferredBoundaries && deferredBoundaries.size === 0) onDeferredBoundariesDrained?.();
-	}
-	function replayInteraction(interaction) {
-		if (!(interaction.target instanceof Node) || !root.contains(interaction.target)) return;
-		const boundary = findDeferredBoundary(interaction.target);
-		if (boundary) {
-			try {
-				if (!activateBoundary(boundary)) return;
-			} catch {
-				return;
-			}
-			deferredBoundaries.delete(boundary);
-			notifyIfDeferredBoundariesDrained();
-		}
-		replaying = true;
-		try {
-			interaction.target.dispatchEvent(interaction.event);
-		} finally {
-			replaying = false;
-		}
-		releaseIfFinished();
-	}
-	function captureInteraction(event) {
-		if (!active || replaying) return;
-		const target = event.target;
-		if (!target || isPermanentlySkipped(target)) return;
-		const boundary = findDeferredBoundary(target);
-		if (!hydratingRoot && !boundary) return;
-		event.preventDefault();
-		event.stopImmediatePropagation();
-		const interaction = {
-			target,
-			event: cloneInteractionEvent(event)
-		};
-		if (hydratingRoot) {
-			queued.push(interaction);
-			return;
-		}
-		replayInteraction(interaction);
-	}
-	const installedTypes = [];
-	try {
-		for (const type of HYDRATION_INTERACTION_TYPES) {
-			root.addEventListener(type, captureInteraction, true);
-			installedTypes.push(type);
-		}
-	} catch (error) {
-		active = false;
-		for (const type of installedTypes) root.removeEventListener(type, captureInteraction, true);
-		throw error;
-	}
-	return {
-		registerDeferredBoundaries(boundaries) {
-			for (const boundary of boundaries) deferredBoundaries.add(boundary);
-			hadDeferredBoundaries ||= boundaries.length > 0;
-		},
-		setOnDeferredBoundariesDrained(callback) {
-			onDeferredBoundariesDrained = callback;
-		},
-		clearDeferredBoundaries() {
-			deferredBoundaries.clear();
-			releaseIfFinished();
-		},
-		complete() {
-			if (!active || !hydratingRoot) return;
-			hydratingRoot = false;
-			const pending = queued.splice(0);
-			for (const interaction of pending) replayInteraction(interaction);
-			releaseIfFinished();
-		},
-		abort() {
-			queued.length = 0;
-			deferredBoundaries.clear();
-			onDeferredBoundariesDrained = void 0;
-			hydratingRoot = false;
-			removeCaptureListeners();
-		}
-	};
-}
-//#endregion
-//#region src/boot/hydrate-spa.ts
-/**
-* App bootstrap and mount
-*/
-/**
-* hydrateSPA: Hydrate server-rendered HTML with an explicit route registry.
-*/
-async function hydrateSPA(config) {
-	assertExecutionModel("spa");
-	if (!config || typeof config !== "object") throw new Error("hydrateSPA requires a config object");
-	validateCspNonce(config.cspNonce);
-	if (!config.registry) throw new Error("hydrateSPA requires a route registry.");
-	const { manifest } = config.registry;
-	if (manifest.records.length === 0) throw new Error("hydrateSPA 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}`);
-	const interactionReplay = beginHydrationInteractionReplay(rootElement, (boundary) => activateHydrationBoundary(rootElement, boundary), config.hydrate?.skipSelectors);
-	try {
-		applyDeferredStreamPatches(rootElement);
-		const hydrationRenderData = takeHydrationRenderData(rootElement);
-		const hydrationQueryCache = hydrationRenderData?.resources;
-		if (hydrationQueryCache) hydrateDataRuntime(config.dataRuntime ?? getDefaultDataRuntime(), hydrationQueryCache);
-		const hydrationRenderDataForApp = hydrationRenderData;
-		configureScrollRestoration(config.scrollRestoration);
-		clearRouteState();
-		_applyManifest(manifest);
-		const routeAuth = config.auth ?? manifest.auth;
-		const appRouteSource = {
-			registry: config.registry,
-			auth: routeAuth,
-			runtime: createAppRenderRuntime({
-				framework: hydrationRenderData?.framework,
-				route: hydrationRenderData?.route,
-				hasRoute: hydrationRenderData !== null,
-				routeRegistry: config.registry,
-				routeAuth
-			})
-		};
-		_setActiveRouteAuthOptions(routeAuth);
-		const { path, href: currentUrl, resolved } = await resolveInitialRoute(routeAuth, {
-			registry: config.registry,
-			load: false
-		});
-		setServerLocation(currentUrl);
-		if (isProductionEnvironment()) lockRouteRegistration();
-		if (!resolved) throw new Error(`hydrateSPA: no route found for current path (${path}).`);
-		if (resolved.kind === "redirect") throw new Error(`hydrateSPA: unresolved redirect for current path (${path}).`);
-		await reconcileInitialRouteMetadata(resolved);
-		const hydrationResolved = resolved.kind === "deny" ? {
-			handler: bindDeniedRouteHandler(resolved.status),
-			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-ikaxotf7.js");
-			if (!verifyHydrationSyncForUrl({
-				root: rootElement,
-				url: currentUrl,
-				registry: config.registry,
-				resolved: hydrationResolved,
-				options: {
-					data: hydrationRenderDataForApp?.resources,
-					dataRuntime: config.dataRuntime ?? getDefaultDataRuntime(),
-					envelope: hydrationRenderDataForApp ?? void 0,
-					cspNonce: config.cspNonce
-				}
-			})) throw new Error("[Askr] Hydration mismatch detected. Server HTML does not match expected server-render output.");
-		}
-		const hydrateOptions = config.hydrate;
-		if (hydrateOptions) {
-			if (hydrateOptions.deferUntilIdle || hydrateOptions.deferBelowFold) {
-				if (hydrationRenderDataForApp) startHydrationRenderPhase(hydrationRenderDataForApp);
-				try {
-					await applySelectiveHydration(rootElement, hydrationResolved, path, config.cleanupStrict, hydrateOptions, appRouteSource, {
-						mountOrUpdate: mountHydratedRoot,
-						registerAppNavigation,
-						registerRootCleanupCallback,
-						activateHydrationBoundary
-					}, interactionReplay);
-				} finally {
-					if (hydrationRenderDataForApp) stopHydrationRenderPhase();
-				}
-				interactionReplay.complete();
-				return;
-			}
-			if (hydrateOptions.skipSelectors?.length) markSkippedElements(rootElement, hydrateOptions.skipSelectors);
-		}
-		if (hydrationRenderDataForApp) startHydrationRenderPhase(hydrationRenderDataForApp);
-		const listenerTransaction = beginHydrationListenerTransaction();
-		beginHydrationDirectListenerMode();
-		try {
-			mountHydratedRoot(rootElement, resolved.kind === "deny" ? bindDeniedStatus(resolved.status) : bindResolvedRouteHandler(hydrationResolved), {
-				cleanupStrict: config.cleanupStrict,
-				appRuntime: appRouteSource.runtime
-			});
-			commitHydrationListenerTransaction(listenerTransaction);
-			interactionReplay.complete();
-		} catch (error) {
-			discardHydrationListenerTransaction(listenerTransaction);
-			throw error;
-		} finally {
-			endHydrationDirectListenerMode();
-			if (hydrationRenderDataForApp) stopHydrationRenderPhase();
-		}
-		await registerAppNavigation(rootElement, path, { ...appRouteSource });
-	} catch (error) {
-		interactionReplay.abort();
-		throw error;
-	}
-}
-//#endregion
-//#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 };