@askrjs/askr 0.0.28 → 0.0.29

package/dist/boot/index.js

@@ -1,2 +1,416 @@
-const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["router/route.js","router/match.js","runtime/component.js","runtime/scheduler.js","dev/invariant.js","dev/logger.js","runtime/perf-metrics.js","runtime/context.js","common/jsx.js","runtime/readable.js","runtime/dev-namespace.js","runtime/fastlane.js","renderer/keyed.js","renderer/utils.js","renderer/index.js","renderer/types.js","common/vnode.js","renderer/cleanup.js","runtime/events.js","renderer/dom.js","jsx-runtime.js","jsx/types.js","runtime/for.js","renderer/reconcile.js","renderer/fastpath.js","renderer/evaluate.js","runtime/execution-model.js","ssr/context.js","ssr/errors.js","common/ssr-errors.js","router/navigate.js","ssr/index.js","jsx/index.js","jsx/utils.js","foundations/structures/portal.js","runtime/ssr-bridge.js","ssr/render-keys.js","ssr/escape.js","ssr/attrs.js","ssr/sink.js","ssr/stream-render.js"])))=>i.map(i=>d[i]);
-import{__vitePreload as w}from"../_virtual/preload-helper.js";import{cleanupComponent as m,createComponentInstance as N,mountComponent as B}from"../runtime/component.js";import{globalScheduler as k}from"../runtime/scheduler.js";import{assertExecutionModel as S}from"../runtime/execution-model.js";import"../jsx/index.js";import{DefaultPortal as C}from"../foundations/structures/portal.js";import"../renderer/index.js";import{removeAllListeners as A}from"../renderer/cleanup.js";import{ELEMENT_TYPE as E,Fragment as H}from"../common/jsx.js";const O=Symbol.for("__ASKR_HAS_ROUTES__");let j=0;const d=new WeakMap,v=Symbol.for("__tempoCleanup__");function D(e,t){e[v]=()=>{const r=[];try{A(e)}catch(o){r.push(o)}try{const o=e.querySelectorAll("*");for(const n of Array.from(o))try{const a=n.__ASKR_INSTANCE;if(a){try{m(a)}catch(i){r.push(i)}try{delete n.__ASKR_INSTANCE}catch(i){r.push(i)}}}catch(a){r.push(a)}}catch(o){r.push(o)}try{m(t)}catch(o){r.push(o)}if(r.length>0&&t.cleanupStrict)throw new AggregateError(r,"cleanup failed for app root")};try{const r=Object.getOwnPropertyDescriptor(e,"innerHTML")||Object.getOwnPropertyDescriptor(Object.getPrototypeOf(e),"innerHTML")||Object.getOwnPropertyDescriptor(Element.prototype,"innerHTML");r&&(r.get||r.set)&&Object.defineProperty(e,"innerHTML",{get:r.get?function(){return r.get.call(this)}:void 0,set:function(o){if(o===""&&d.get(this)===t){try{A(e)}catch(n){if(t.cleanupStrict)throw n}try{m(t)}catch(n){if(t.cleanupStrict)throw n}}if(r.set)return r.set.call(this,o)},configurable:!0})}catch{}}function J(e){throw new Error("The `teardownApp` alias has been removed. Use `cleanupApp(root)` instead.")}function y(e,t,r){const o=(i,u)=>{const p=t(i,u),l={$$typeof:E,type:C,props:{},key:"__default_portal"};return{$$typeof:E,type:H,props:{children:p==null?[l]:[p,l]}}};Object.defineProperty(o,"name",{value:t.name||"Component"});const n=e[v];n&&n();let a=d.get(e);if(a){A(e);try{m(a)}catch{}a.fn=o,a.evaluationGeneration++,a.mounted=!1,a.expectedStateIndices=[],a.firstRenderComplete=!1,a.isRoot=!0,r&&typeof r.cleanupStrict=="boolean"&&(a.cleanupStrict=r.cleanupStrict)}else{const i=String(++j);a=N(i,o,{},e),d.set(e,a),a.isRoot=!0,r&&typeof r.cleanupStrict=="boolean"&&(a.cleanupStrict=r.cleanupStrict)}D(e,a),B(a),k.flush()}function q(e){if(S("islands"),!e||typeof e!="object")throw new Error("createIsland requires a config object");if(typeof e.component!="function")throw new Error("createIsland: component must be a function");const t=typeof e.root=="string"?document.getElementById(e.root):e.root;if(!t)throw new Error(`Root element not found: ${e.root}`);if("routes"in e)throw new Error("createIsland does not accept routes; use createSPA for routed apps");try{if(globalThis[O])throw new Error("Routes are not supported with islands. Use createSPA (client) or createSSR (server) instead.")}catch{}y(t,e.component,{cleanupStrict:e.cleanupStrict})}function Q(e){if(S("islands"),!e||typeof e!="object")throw new Error("createIslands requires a config object");if(!Array.isArray(e.islands)||e.islands.length===0)throw new Error("createIslands requires a non-empty islands array");for(const t of e.islands)q(t)}async function X(e){if(S("spa"),!e||typeof e!="object")throw new Error("createSPA requires a config object");if(!Array.isArray(e.routes)||e.routes.length===0)throw new Error("createSPA requires a route table. If you are enhancing existing HTML, use createIsland instead.");const t=typeof e.root=="string"?document.getElementById(e.root):e.root;if(!t)throw new Error(`Root element not found: ${e.root}`);const{clearRoutes:r,route:o,lockRouteRegistration:n,resolveRoute:a}=await w(async()=>{const{clearRoutes:s,route:c,lockRouteRegistration:h,resolveRoute:g}=await import("../router/route.js");return{clearRoutes:s,route:c,lockRouteRegistration:h,resolveRoute:g}},__vite__mapDeps([0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29]));r();for(const s of e.routes)o(s.path,s.handler,s.namespace);n();const i=typeof window<"u"?window.location.pathname:"/",u=a(i);if(!u){y(t,()=>({type:"div",children:[]}),{cleanupStrict:e.cleanupStrict});const{registerAppInstance:s,initializeNavigation:c}=await w(async()=>{const{registerAppInstance:g,initializeNavigation:_}=await import("../router/navigate.js");return{registerAppInstance:g,initializeNavigation:_}},__vite__mapDeps([30,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29])),h=d.get(t);if(!h)throw new Error("Internal error: app instance missing");s(h,i),c();return}y(t,u.handler,{cleanupStrict:e.cleanupStrict});const{registerAppInstance:p,initializeNavigation:l}=await w(async()=>{const{registerAppInstance:s,initializeNavigation:c}=await import("../router/navigate.js");return{registerAppInstance:s,initializeNavigation:c}},__vite__mapDeps([30,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29])),f=d.get(t);if(!f)throw new Error("Internal error: app instance missing");p(f,i),l()}function L(e,t){for(const r of t)e.querySelectorAll(r).forEach(n=>n.setAttribute("data-skip-hydrate","true"))}function U(e,t){const r=[],o=[];for(let n=e.children.length-1;n>=0;n-=1)o.push(e.children[n]);for(;o.length>0;){const n=o.pop();if(n.hasAttribute("data-skip-hydrate"))continue;if(n.getBoundingClientRect().top>=t){n.setAttribute("data-skip-hydrate","true"),r.push(n);continue}for(let i=n.children.length-1;i>=0;i-=1)o.push(n.children[i])}return r}function R(e,t){let r=!1,o=0;for(const n of e){if(!n.hasAttribute("data-skip-hydrate"))continue;n.getBoundingClientRect().top<t?(n.removeAttribute("data-skip-hydrate"),r=!0):o+=1}return{activated:r,remaining:o}}function b(e){return new Promise(t=>{if(typeof requestIdleCallback<"u"){requestIdleCallback(()=>{e(),t()},{timeout:2e3});return}setTimeout(()=>{e(),t()},0)})}function P(e){const t=d.get(e);t&&(t._enqueueRun?.(),k.flush())}async function I(e,t){const{registerAppInstance:r,initializeNavigation:o}=await w(async()=>{const{registerAppInstance:a,initializeNavigation:i}=await import("../router/navigate.js");return{registerAppInstance:a,initializeNavigation:i}},__vite__mapDeps([30,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29])),n=d.get(e);if(!n)throw new Error("Internal error: app instance missing");r(n,t),o()}async function F(e,t,r,o,n){const a=(n.skipSelectors?.length??0)>0,i=!!n.deferBelowFold,u=a||i;n.skipSelectors?.length&&L(e,n.skipSelectors);let p=[];if(n.deferBelowFold){const l=n.foldThreshold??window.innerHeight;p=U(e,l);const f=()=>{const{activated:s,remaining:c}=R(p,l);s&&(P(e),c===0&&window.removeEventListener("scroll",f))};window.addEventListener("scroll",f,{passive:!0})}if(n.deferUntilIdle&&!u){await b(()=>{y(e,t.handler,{cleanupStrict:o})}),await I(e,r);return}y(e,t.handler,{cleanupStrict:o}),await I(e,r),n.deferUntilIdle&&p.length>0&&await b(()=>{const{activated:l}=R(p,Number.POSITIVE_INFINITY);l&&P(e)})}async function Z(e){if(S("spa"),!e||typeof e!="object")throw new Error("hydrateSPA requires a config object");if(!Array.isArray(e.routes)||e.routes.length===0)throw new Error("hydrateSPA requires a route table. If you are enhancing existing HTML, use createIsland instead.");const t=typeof e.root=="string"?document.getElementById(e.root):e.root;if(!t)throw new Error(`Root element not found: ${e.root}`);const{clearRoutes:r,route:o,setServerLocation:n,lockRouteRegistration:a,resolveRoute:i}=await w(async()=>{const{clearRoutes:c,route:h,setServerLocation:g,lockRouteRegistration:_,resolveRoute:T}=await import("../router/route.js");return{clearRoutes:c,route:h,setServerLocation:g,lockRouteRegistration:_,resolveRoute:T}},__vite__mapDeps([0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29]));r();for(const c of e.routes)o(c.path,c.handler,c.namespace);const u=typeof window<"u"?window.location.pathname:"/",p=typeof window<"u"?`${window.location.pathname}${window.location.search}${window.location.hash}`:u;n(p),a();const l=i(u);if(!l)throw new Error(`hydrateSPA: no route found for current path (${u}).`);const{verifyHydrationSyncForUrl:f}=await w(async()=>{const{verifyHydrationSyncForUrl:c}=await import("../ssr/index.js");return{verifyHydrationSyncForUrl:c}},__vite__mapDeps([31,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,32,33,34,35,36,37,38,39,40]));if(!f({root:t,url:p,routes:e.routes}))throw new Error("[Askr] Hydration mismatch detected. Server HTML does not match expected server-render output.");const s=e.hydrate;if(s){if(s.deferUntilIdle||s.deferBelowFold){await F(t,{handler:l.handler,params:l.params},u,e.cleanupStrict,s);return}s.skipSelectors?.length&&L(t,s.skipSelectors)}y(t,l.handler,{cleanupStrict:e.cleanupStrict}),await I(t,u)}async function ee(e){throw new Error("The legacy `hydrate` API is removed. Use `hydrateSPA({ root, routes })` for SSR hydration with an explicit route table.")}function te(e){const t=typeof e=="string"?document.getElementById(e):e;if(!t)return;const r=t[v];typeof r=="function"&&r(),d.delete(t)}function re(e){const t=typeof e=="string"?document.getElementById(e):e;return t?d.has(t):!1}export{te as cleanupApp,q as createIsland,Q as createIslands,X as createSPA,re as hasApp,ee as hydrate,Z as hydrateSPA,J as teardownApp};
+import { isDevelopmentEnvironment, isProductionEnvironment } from "../common/env.js";
+import { logger } from "../dev/logger.js";
+import { globalScheduler } from "../runtime/scheduler.js";
+import { ELEMENT_TYPE, Fragment } from "../common/jsx.js";
+import { cleanupComponent, createComponentInstance, mountComponent } from "../runtime/component.js";
+import { removeAllListeners } from "../renderer/cleanup.js";
+import { installRendererBridge } from "../renderer/index.js";
+import { assertExecutionModel } from "../runtime/execution-model.js";
+import { _applyManifest, _drainLazy, _setActiveRouteAuthOptions, _snapshotLazy, clearRoutes, lockRouteRegistration, resolveRoute, resolveRouteRequest, route, setServerLocation } from "../router/route.js";
+import "../jsx/index.js";
+import { DefaultPortal } from "../foundations/structures/portal.js";
+import { configureScrollRestoration, initializeNavigation, registerAppInstance } from "../router/navigate.js";
+//#region src/boot/index.ts
+/**
+* App bootstrap and mount
+*/
+const HAS_ROUTES_KEY = Symbol.for("__ASKR_HAS_ROUTES__");
+let componentIdCounter = 0;
+const instancesByRoot = /* @__PURE__ */ new WeakMap();
+const CLEANUP_SYMBOL = Symbol.for("__tempoCleanup__");
+function attachCleanupForRoot(rootElement, instance) {
+	rootElement[CLEANUP_SYMBOL] = () => {
+		const errors = [];
+		try {
+			removeAllListeners(rootElement);
+		} catch (e) {
+			errors.push(e);
+		}
+		try {
+			const descendants = rootElement.querySelectorAll("*");
+			for (const d of Array.from(descendants)) try {
+				const inst = d.__ASKR_INSTANCE;
+				if (inst) {
+					try {
+						cleanupComponent(inst);
+					} catch (err) {
+						errors.push(err);
+					}
+					try {
+						delete d.__ASKR_INSTANCE;
+					} catch (err) {
+						errors.push(err);
+					}
+				}
+			} catch (err) {
+				errors.push(err);
+			}
+		} catch (e) {
+			errors.push(e);
+		}
+		try {
+			cleanupComponent(instance);
+		} catch (e) {
+			errors.push(e);
+		}
+		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);
+		}
+	};
+	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,
+			set: function(value) {
+				if (value === "" && instancesByRoot.get(this) === instance) {
+					try {
+						removeAllListeners(rootElement);
+					} catch (e) {
+						if (instance.cleanupStrict) throw e;
+						if (isDevelopmentEnvironment()) logger.warn("[Askr] cleanup error:", e);
+					}
+					try {
+						cleanupComponent(instance);
+					} catch (e) {
+						if (instance.cleanupStrict) throw e;
+						if (isDevelopmentEnvironment()) logger.warn("[Askr] cleanup error:", e);
+					}
+				}
+				if (descriptor.set) return descriptor.set.call(this, value);
+			},
+			configurable: true
+		});
+	} catch {}
+}
+/**
+* Explicitly teardown an app mounted on `root` if present. This is the
+* recommended API for deterministic cleanup rather than relying on overriding
+* `innerHTML` setter behavior.
+*/
+function teardownApp(_root) {
+	throw new Error("The `teardownApp` alias has been removed. Use `cleanupApp(root)` instead.");
+}
+function mountOrUpdate(rootElement, componentFn, options) {
+	const wrappedFn = (props, ctx) => {
+		const out = componentFn(props, ctx);
+		const portalVNode = {
+			$$typeof: ELEMENT_TYPE,
+			type: DefaultPortal,
+			props: {},
+			key: "__default_portal"
+		};
+		return {
+			$$typeof: ELEMENT_TYPE,
+			type: Fragment,
+			props: { children: out === void 0 || out === null ? [portalVNode] : [out, portalVNode] }
+		};
+	};
+	Object.defineProperty(wrappedFn, "name", { value: componentFn.name || "Component" });
+	const existingCleanup = rootElement[CLEANUP_SYMBOL];
+	if (existingCleanup) existingCleanup();
+	let instance = instancesByRoot.get(rootElement);
+	if (instance) {
+		removeAllListeners(rootElement);
+		try {
+			cleanupComponent(instance);
+		} catch (e) {
+			if (isDevelopmentEnvironment()) logger.warn("[Askr] prior cleanup threw:", e);
+		}
+		instance.fn = wrappedFn;
+		instance.evaluationGeneration++;
+		instance.mounted = false;
+		instance.expectedStateIndices = [];
+		instance.firstRenderComplete = false;
+		instance.isRoot = true;
+		if (options && typeof options.cleanupStrict === "boolean") instance.cleanupStrict = options.cleanupStrict;
+	} else {
+		instance = createComponentInstance(String(++componentIdCounter), wrappedFn, {}, rootElement);
+		instancesByRoot.set(rootElement, instance);
+		instance.isRoot = true;
+		if (options && typeof options.cleanupStrict === "boolean") instance.cleanupStrict = options.cleanupStrict;
+	}
+	attachCleanupForRoot(rootElement, instance);
+	mountComponent(instance);
+	globalScheduler.flush();
+}
+function bindResolvedRouteHandler(resolved) {
+	return () => resolved.handler(resolved.params);
+}
+function bindDeniedStatus(status) {
+	return () => ({
+		type: "div",
+		props: { "data-route-denied": String(status) },
+		children: [String(status)]
+	});
+}
+installRendererBridge();
+/**
+* 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");
+	const rootElement = typeof config.root === "string" ? document.getElementById(config.root) : 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");
+	try {
+		if (globalThis[HAS_ROUTES_KEY]) throw new Error("Routes are not supported with islands. Use createSPA (client) or createSSR (server) instead.");
+	} catch {}
+	mountOrUpdate(rootElement, config.component, { cleanupStrict: config.cleanupStrict });
+}
+/**
+* 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");
+	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);
+}
+/**
+* createSPA: Initializes router and mounts the app with the provided route manifest or route table.
+*
+* Preferred usage with manifest:
+* ```ts
+* import { getManifest } from '@askrjs/askr/router';
+* await createSPA({ root: '#app', manifest: getManifest() });
+* ```
+*
+* Legacy usage with plain routes array (still supported):
+* ```ts
+* await createSPA({ root: '#app', routes: getRoutes() });
+* ```
+*/
+async function createSPA(config) {
+	assertExecutionModel("spa");
+	if (!config || typeof config !== "object") throw new Error("createSPA requires a config object");
+	const hasManifest = config.manifest != null && config.manifest.records.length > 0;
+	const hasRoutes = Array.isArray(config.routes) && config.routes.length > 0;
+	if (!hasManifest && !hasRoutes) throw new Error("createSPA requires a route manifest or route table. Pass `manifest: getManifest()` or `routes: getRoutes()`. If you are enhancing existing HTML, use createIsland instead.");
+	const rootElement = typeof config.root === "string" ? document.getElementById(config.root) : config.root;
+	if (!rootElement) throw new Error(`Root element not found: ${config.root}`);
+	const pendingLazyAtBoot = _snapshotLazy();
+	configureScrollRestoration(config.scrollRestoration);
+	clearRoutes();
+	if (hasManifest) _applyManifest(config.manifest);
+	else for (const r of config.routes) route(r.path, r.handler);
+	const routeAuth = config.auth ?? config.manifest?.auth;
+	_setActiveRouteAuthOptions(routeAuth);
+	await _drainLazy(pendingLazyAtBoot);
+	if (isProductionEnvironment()) lockRouteRegistration();
+	let path = typeof window !== "undefined" ? window.location.pathname : "/";
+	let href = typeof window !== "undefined" ? `${window.location.pathname}${window.location.search}${window.location.hash}` : path;
+	let resolved = await resolveRouteRequest(href, { auth: routeAuth });
+	while (typeof window !== "undefined" && resolved && resolved.kind === "redirect") {
+		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;
+		resolved = await resolveRouteRequest(href, { auth: routeAuth });
+	}
+	if (!resolved) {
+		mountOrUpdate(rootElement, () => ({
+			type: "div",
+			children: []
+		}), { cleanupStrict: config.cleanupStrict });
+		await registerAppNavigation(rootElement, path);
+		return;
+	}
+	if (resolved.kind === "redirect") {
+		mountOrUpdate(rootElement, () => ({
+			type: "div",
+			children: []
+		}), { cleanupStrict: config.cleanupStrict });
+		await registerAppNavigation(rootElement, path);
+		return;
+	}
+	mountOrUpdate(rootElement, resolved.kind === "deny" ? bindDeniedStatus(resolved.status) : bindResolvedRouteHandler({
+		handler: resolved.handler,
+		params: resolved.params
+	}), { cleanupStrict: config.cleanupStrict });
+	await registerAppNavigation(rootElement, path);
+}
+/**
+* Mark elements that should be skipped during hydration
+*/
+function markSkippedElements(root, skipSelectors) {
+	for (const selector of skipSelectors) root.querySelectorAll(selector).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");
+			boundaries.push(element);
+			continue;
+		}
+		for (let index = element.children.length - 1; index >= 0; index -= 1) stack.push(element.children[index]);
+	}
+	return boundaries;
+}
+function activateVisibleDeferredBoundaries(boundaries, foldY) {
+	let activated = false;
+	let remaining = 0;
+	for (const element of boundaries) {
+		if (!element.hasAttribute("data-skip-hydrate")) continue;
+		if (element.getBoundingClientRect().top < foldY) {
+			element.removeAttribute("data-skip-hydrate");
+			activated = true;
+		} else 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 flushHydrationActivation(rootElement) {
+	const instance = instancesByRoot.get(rootElement);
+	if (!instance) return;
+	instance._enqueueRun?.();
+	globalScheduler.flush();
+}
+function shouldVerifyHydrationMarkup(config) {
+	const explicit = config.hydrate?.verifyMarkup;
+	if (typeof explicit === "boolean") return explicit;
+	return !isProductionEnvironment();
+}
+async function registerAppNavigation(rootElement, path) {
+	const instance = instancesByRoot.get(rootElement);
+	if (!instance) throw new Error("Internal error: app instance missing");
+	registerAppInstance(instance, path);
+	initializeNavigation();
+}
+/**
+* Apply selective hydration with deferral options
+*/
+async function applySelectiveHydration(rootElement, resolved, path, cleanupStrict, hydrateOptions) {
+	const hasPermanentSkips = (hydrateOptions.skipSelectors?.length ?? 0) > 0;
+	const hasBelowFoldDeferral = !!hydrateOptions.deferBelowFold;
+	const hasSelectiveBoundaries = hasPermanentSkips || hasBelowFoldDeferral;
+	if (hydrateOptions.skipSelectors?.length) markSkippedElements(rootElement, hydrateOptions.skipSelectors);
+	let deferredBoundaries = [];
+	if (hydrateOptions.deferBelowFold) {
+		const foldY = hydrateOptions.foldThreshold ?? window.innerHeight;
+		deferredBoundaries = collectDeferredBelowFoldBoundaries(rootElement, foldY);
+		const handleScroll = () => {
+			const { activated, remaining } = activateVisibleDeferredBoundaries(deferredBoundaries, foldY);
+			if (!activated) return;
+			flushHydrationActivation(rootElement);
+			if (remaining === 0) window.removeEventListener("scroll", handleScroll);
+		};
+		window.addEventListener("scroll", handleScroll, { passive: true });
+	}
+	if (hydrateOptions.deferUntilIdle && !hasSelectiveBoundaries) {
+		await queueIdleWork(() => {
+			mountOrUpdate(rootElement, (() => resolved.handler(resolved.params)), { cleanupStrict });
+		});
+		await registerAppNavigation(rootElement, path);
+		return;
+	}
+	mountOrUpdate(rootElement, (() => resolved.handler(resolved.params)), { cleanupStrict });
+	await registerAppNavigation(rootElement, path);
+	if (hydrateOptions.deferUntilIdle && deferredBoundaries.length > 0) await queueIdleWork(() => {
+		const { activated } = activateVisibleDeferredBoundaries(deferredBoundaries, Number.POSITIVE_INFINITY);
+		if (activated) flushHydrationActivation(rootElement);
+	});
+}
+/**
+* hydrateSPA: Hydrate server-rendered HTML.
+* Accepts either a `manifest` (preferred) or a legacy `routes` array.
+*/
+async function hydrateSPA(config) {
+	assertExecutionModel("spa");
+	if (!config || typeof config !== "object") throw new Error("hydrateSPA requires a config object");
+	const hasManifest = config.manifest != null && config.manifest.records.length > 0;
+	const hasRoutes = Array.isArray(config.routes) && config.routes.length > 0;
+	if (!hasManifest && !hasRoutes) throw new Error("hydrateSPA requires a route manifest or route table. Pass `manifest: getManifest()` or `routes: getRoutes()`. If you are enhancing existing HTML, use createIsland instead.");
+	const rootElement = typeof config.root === "string" ? document.getElementById(config.root) : config.root;
+	if (!rootElement) throw new Error(`Root element not found: ${config.root}`);
+	const pendingLazyAtHydrationBoot = _snapshotLazy();
+	configureScrollRestoration(config.scrollRestoration);
+	clearRoutes();
+	if (hasManifest) _applyManifest(config.manifest);
+	else for (const r of config.routes) route(r.path, r.handler);
+	_setActiveRouteAuthOptions(config.auth ?? config.manifest?.auth);
+	await _drainLazy(pendingLazyAtHydrationBoot);
+	const path = typeof window !== "undefined" ? window.location.pathname : "/";
+	const currentUrl = typeof window !== "undefined" ? `${window.location.pathname}${window.location.search}${window.location.hash}` : path;
+	setServerLocation(currentUrl);
+	if (isProductionEnvironment()) lockRouteRegistration();
+	const resolved = resolveRoute(path);
+	if (!resolved) throw new Error(`hydrateSPA: no route found for current path (${path}).`);
+	const legacyRouteTable = hasManifest ? config.manifest.records.map((r) => ({
+		path: r.path,
+		handler: r.handler,
+		namespace: r.options.namespace
+	})) : config.routes;
+	if (shouldVerifyHydrationMarkup(config)) {
+		const { verifyHydrationSyncForUrl } = await import("../ssr/index.js");
+		if (!verifyHydrationSyncForUrl({
+			root: rootElement,
+			url: currentUrl,
+			routes: legacyRouteTable
+		})) 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) {
+			await applySelectiveHydration(rootElement, {
+				handler: resolved.handler,
+				params: resolved.params
+			}, path, config.cleanupStrict, hydrateOptions);
+			return;
+		}
+		if (hydrateOptions.skipSelectors?.length) markSkippedElements(rootElement, hydrateOptions.skipSelectors);
+	}
+	mountOrUpdate(rootElement, bindResolvedRouteHandler(resolved), { cleanupStrict: config.cleanupStrict });
+	await registerAppNavigation(rootElement, path);
+}
+/**
+* Cleanup an app mounted on a root element (element or id).
+* Safe to call multiple times — no-op when nothing is mounted.
+*/
+function cleanupApp(root) {
+	const rootElement = typeof root === "string" ? document.getElementById(root) : root;
+	if (!rootElement) return;
+	const cleanupFn = rootElement[CLEANUP_SYMBOL];
+	if (typeof cleanupFn === "function") cleanupFn();
+	instancesByRoot.delete(rootElement);
+}
+/**
+* Check whether an app is mounted on the given root
+*/
+function hasApp(root) {
+	const rootElement = typeof root === "string" ? document.getElementById(root) : root;
+	if (!rootElement) return false;
+	return instancesByRoot.has(rootElement);
+}
+//#endregion
+export { cleanupApp, createIsland, createIslands, createSPA, hasApp, hydrateSPA, teardownApp };
+
+//# sourceMappingURL=index.js.map

package/dist/boot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/boot/index.ts"],"sourcesContent":["/**\n * App bootstrap and mount\n */\n\nimport {\n  createComponentInstance,\n  mountComponent,\n  cleanupComponent,\n  type ComponentFunction,\n  type ComponentInstance,\n} from '../runtime/component';\nimport {\n  isDevelopmentEnvironment,\n  isProductionEnvironment,\n} from '../common/env';\nimport { logger } from '../dev/logger';\nimport { initializeNavigation, registerAppInstance } from '../router/navigate';\nimport {\n  configureScrollRestoration,\n  type ScrollRestorationOptions,\n} from '../router/navigate';\nimport {\n  _applyManifest,\n  _drainLazy,\n  _setActiveRouteAuthOptions,\n  _snapshotLazy,\n  clearRoutes,\n  lockRouteRegistration,\n  resolveRoute,\n  resolveRouteRequest,\n  route as registerRoute,\n  setServerLocation,\n} from '../router/route';\nimport { globalScheduler } from '../runtime/scheduler';\nimport { assertExecutionModel } from '../runtime/execution-model';\n\nconst HAS_ROUTES_KEY = Symbol.for('__ASKR_HAS_ROUTES__');\n\nlet componentIdCounter = 0;\n\n// Track instances by root element to support multiple createIsland calls on same root\nconst instancesByRoot = new WeakMap<Element, ComponentInstance>();\n\n// Symbol for storing cleanup on elements\nconst CLEANUP_SYMBOL = Symbol.for('__tempoCleanup__');\n\n// Type for elements that have cleanup functions attached\ninterface ElementWithCleanup extends Element {\n  [CLEANUP_SYMBOL]?: () => void;\n}\n\nfunction attachCleanupForRoot(\n  rootElement: Element,\n  instance: ComponentInstance\n) {\n  (rootElement as ElementWithCleanup)[CLEANUP_SYMBOL] = () => {\n    // Attempt to remove listeners and cleanup instances under the root.\n    // In non-strict mode we preserve previous behavior by swallowing errors\n    // (but logging in dev); in strict mode we aggregate and re-throw.\n    const errors: unknown[] = [];\n    try {\n      removeAllListeners(rootElement);\n    } catch (e) {\n      errors.push(e);\n    }\n\n    // Manually traverse descendants and attempt to cleanup their instances.\n    // Avoids import cycles by using local traversal and existing cleanupComponent.\n    try {\n      const descendants = rootElement.querySelectorAll('*');\n      for (const d of Array.from(descendants)) {\n        try {\n          const inst = (d as Element & { __ASKR_INSTANCE?: ComponentInstance })\n            .__ASKR_INSTANCE;\n          if (inst) {\n            try {\n              cleanupComponent(inst);\n            } catch (err) {\n              errors.push(err);\n            }\n            try {\n              delete (d as Element & { __ASKR_INSTANCE?: ComponentInstance })\n                .__ASKR_INSTANCE;\n            } catch (err) {\n              errors.push(err);\n            }\n          }\n        } catch (err) {\n          errors.push(err);\n        }\n      }\n    } catch (e) {\n      errors.push(e);\n    }\n\n    try {\n      cleanupComponent(instance as ComponentInstance);\n    } catch (e) {\n      errors.push(e);\n    }\n\n    if (errors.length > 0) {\n      if (instance.cleanupStrict) {\n        throw new AggregateError(errors, `cleanup failed for app root`);\n      } else if (isDevelopmentEnvironment()) {\n        for (const err of errors) logger.warn('[Askr] cleanup error:', err);\n      }\n    }\n  };\n\n  try {\n    const descriptor =\n      Object.getOwnPropertyDescriptor(rootElement, 'innerHTML') ||\n      Object.getOwnPropertyDescriptor(\n        Object.getPrototypeOf(rootElement),\n        'innerHTML'\n      ) ||\n      Object.getOwnPropertyDescriptor(Element.prototype, 'innerHTML');\n\n    if (descriptor && (descriptor.get || descriptor.set)) {\n      Object.defineProperty(rootElement, 'innerHTML', {\n        get: descriptor.get\n          ? function (this: Element) {\n              return descriptor.get!.call(this);\n            }\n          : undefined,\n        set: function (this: Element, value: string) {\n          if (value === '' && instancesByRoot.get(this) === instance) {\n            try {\n              removeAllListeners(rootElement);\n            } catch (e) {\n              if (instance.cleanupStrict) throw e;\n              if (isDevelopmentEnvironment()) {\n                logger.warn('[Askr] cleanup error:', e);\n              }\n            }\n\n            try {\n              cleanupComponent(instance as ComponentInstance);\n            } catch (e) {\n              if (instance.cleanupStrict) throw e;\n              if (isDevelopmentEnvironment()) {\n                logger.warn('[Askr] cleanup error:', e);\n              }\n            }\n          }\n          if (descriptor.set) {\n            return descriptor.set.call(this, value);\n          }\n        },\n        configurable: true,\n      });\n    }\n  } catch {\n    // If Object.defineProperty fails, ignore\n  }\n}\n\n/**\n * Explicitly teardown an app mounted on `root` if present. This is the\n * recommended API for deterministic cleanup rather than relying on overriding\n * `innerHTML` setter behavior.\n */\nexport function teardownApp(_root: Element | string) {\n  throw new Error(\n    'The `teardownApp` alias has been removed. Use `cleanupApp(root)` instead.'\n  );\n}\n\nimport { Fragment, ELEMENT_TYPE } from '../jsx';\n\nimport { DefaultPortal } from '../foundations/structures/portal';\n\nfunction mountOrUpdate(\n  rootElement: Element,\n  componentFn: ComponentFunction,\n  options?: { cleanupStrict?: boolean }\n) {\n  // Ensure root component always includes a DefaultPortal host by wrapping it.\n  const wrappedFn: ComponentFunction = (props, ctx) => {\n    const out = componentFn(props, ctx);\n    const portalVNode = {\n      $$typeof: ELEMENT_TYPE,\n      type: DefaultPortal,\n      props: {},\n      key: '__default_portal',\n    } as unknown;\n    return {\n      $$typeof: ELEMENT_TYPE,\n      type: Fragment,\n      props: {\n        children:\n          out === undefined || out === null\n            ? [portalVNode]\n            : [out, portalVNode],\n      },\n    } as unknown as ReturnType<ComponentFunction>;\n  };\n  // Preserve the original component name for debugging/dev warnings\n  Object.defineProperty(wrappedFn, 'name', {\n    value: componentFn.name || 'Component',\n  });\n\n  // Clean up existing cleanup function before mounting new one\n  const existingCleanup = (rootElement as ElementWithCleanup)[CLEANUP_SYMBOL];\n  if (existingCleanup) existingCleanup();\n\n  let instance = instancesByRoot.get(rootElement);\n\n  if (instance) {\n    removeAllListeners(rootElement);\n    try {\n      cleanupComponent(instance);\n    } catch (e) {\n      // If previous cleanup threw in strict mode, log but continue mounting new instance\n      if (isDevelopmentEnvironment()) {\n        logger.warn('[Askr] prior cleanup threw:', e);\n      }\n    }\n\n    instance.fn = wrappedFn;\n    instance.evaluationGeneration++;\n    instance.mounted = false;\n    instance.expectedStateIndices = [];\n    instance.firstRenderComplete = false;\n    instance.isRoot = true;\n    // Update strict flag if provided\n    if (options && typeof options.cleanupStrict === 'boolean') {\n      instance.cleanupStrict = options.cleanupStrict;\n    }\n  } else {\n    const componentId = String(++componentIdCounter);\n    instance = createComponentInstance(componentId, wrappedFn, {}, rootElement);\n    instancesByRoot.set(rootElement, instance);\n    instance.isRoot = true;\n    // Initialize strict flag from options\n    if (options && typeof options.cleanupStrict === 'boolean') {\n      instance.cleanupStrict = options.cleanupStrict;\n    }\n  }\n\n  attachCleanupForRoot(rootElement, instance);\n  mountComponent(instance);\n  globalScheduler.flush();\n}\n\nfunction bindResolvedRouteHandler(resolved: ResolvedRoute): ComponentFunction {\n  return () =>\n    resolved.handler(resolved.params) as ReturnType<ComponentFunction>;\n}\n\nfunction bindDeniedStatus(status: number): ComponentFunction {\n  return () => ({\n    type: 'div',\n    props: {\n      'data-route-denied': String(status),\n    },\n    children: [String(status)],\n  });\n}\n\n// New strongly-typed init functions\nimport type {\n  Route,\n  RouteManifest,\n  ResolvedRoute,\n  RouteAuthOptions,\n} from '../common/router';\nimport { installRendererBridge, removeAllListeners } from '../renderer';\ninstallRendererBridge();\n\nexport type IslandConfig = {\n  root: Element | string;\n  component: ComponentFunction;\n  // Optional: surface cleanup errors during teardown for this island\n  cleanupStrict?: boolean;\n  // Explicitly disallow routes on islands at type level\n  routes?: never;\n};\n\nexport type IslandsConfig = {\n  islands: IslandConfig[];\n};\n\nexport type SPAConfig = {\n  root: Element | string;\n  /**\n   * Preferred: pass the route manifest built via `registerRoutes(() => { ... })`.\n   * ```ts\n   * import { getManifest } from '@askrjs/askr/router';\n   * await createSPA({ root: '#app', manifest: getManifest() });\n   * ```\n   */\n  manifest?: RouteManifest;\n  /** Legacy: flat route array — kept for backward compatibility and test fixtures. */\n  routes?: Route[];\n  auth?: RouteAuthOptions;\n  scrollRestoration?: boolean | ScrollRestorationOptions;\n  cleanupStrict?: boolean;\n  component?: never;\n};\n\nexport type HydrateSPAConfig = {\n  root: Element | string;\n  /** Preferred manifest input — see `SPAConfig.manifest`. */\n  manifest?: RouteManifest;\n  /** Legacy flat route array. */\n  routes?: Route[];\n  auth?: RouteAuthOptions;\n  scrollRestoration?: boolean | ScrollRestorationOptions;\n  cleanupStrict?: boolean;\n  hydrate?: {\n    verifyMarkup?: boolean;\n    deferUntilIdle?: boolean;\n    deferBelowFold?: boolean;\n    foldThreshold?: number;\n    skipSelectors?: string[];\n  };\n};\n\n/**\n * createIsland: Enhances existing DOM (no router, mounts once)\n */\nexport function createIsland(config: IslandConfig): void {\n  assertExecutionModel('islands');\n  if (!config || typeof config !== 'object') {\n    throw new Error('createIsland requires a config object');\n  }\n  if (typeof config.component !== 'function') {\n    throw new Error('createIsland: component must be a function');\n  }\n\n  const rootElement =\n    typeof config.root === 'string'\n      ? document.getElementById(config.root)\n      : config.root;\n  if (!rootElement) throw new Error(`Root element not found: ${config.root}`);\n\n  // Islands must not initialize router or routes\n  if ('routes' in config) {\n    throw new Error(\n      'createIsland does not accept routes; use createSPA for routed apps'\n    );\n  }\n\n  // Routes are never supported with islands.\n  // If routes were registered (even at module load time), fail fast to avoid\n  // surprising partial router behavior.\n  try {\n    const g = globalThis as unknown as Record<string | symbol, unknown>;\n    if (g[HAS_ROUTES_KEY]) {\n      throw new Error(\n        'Routes are not supported with islands. Use createSPA (client) or createSSR (server) instead.'\n      );\n    }\n  } catch {\n    // ignore\n  }\n\n  mountOrUpdate(rootElement, config.component, {\n    cleanupStrict: config.cleanupStrict,\n  });\n}\n\n/**\n * createIslands: Enhances one or more existing DOM roots (no router).\n * The only public islands constructor.\n */\nexport function createIslands(config: IslandsConfig): void {\n  assertExecutionModel('islands');\n  if (!config || typeof config !== 'object') {\n    throw new Error('createIslands requires a config object');\n  }\n  if (!Array.isArray(config.islands) || config.islands.length === 0) {\n    throw new Error('createIslands requires a non-empty islands array');\n  }\n  for (const island of config.islands) {\n    createIsland(island);\n  }\n}\n\n/**\n * createSPA: Initializes router and mounts the app with the provided route manifest or route table.\n *\n * Preferred usage with manifest:\n * ```ts\n * import { getManifest } from '@askrjs/askr/router';\n * await createSPA({ root: '#app', manifest: getManifest() });\n * ```\n *\n * Legacy usage with plain routes array (still supported):\n * ```ts\n * await createSPA({ root: '#app', routes: getRoutes() });\n * ```\n */\nexport async function createSPA(config: SPAConfig): Promise<void> {\n  assertExecutionModel('spa');\n  if (!config || typeof config !== 'object') {\n    throw new Error('createSPA requires a config object');\n  }\n\n  const hasManifest =\n    config.manifest != null && config.manifest.records.length > 0;\n  const hasRoutes = Array.isArray(config.routes) && config.routes.length > 0;\n\n  if (!hasManifest && !hasRoutes) {\n    throw new Error(\n      'createSPA requires a route manifest or route table. ' +\n        'Pass `manifest: getManifest()` or `routes: getRoutes()`. ' +\n        'If you are enhancing existing HTML, use createIsland instead.'\n    );\n  }\n\n  const rootElement =\n    typeof config.root === 'string'\n      ? document.getElementById(config.root)\n      : config.root;\n  if (!rootElement) throw new Error(`Root element not found: ${config.root}`);\n\n  const pendingLazyAtBoot = _snapshotLazy();\n\n  configureScrollRestoration(config.scrollRestoration);\n\n  clearRoutes();\n\n  if (hasManifest) {\n    // Preferred path: apply pre-built manifest records directly\n    _applyManifest(config.manifest!);\n  } else {\n    // Legacy path: register plain Route objects (no layout metadata)\n    for (const r of config.routes!) {\n      registerRoute(r.path, r.handler as Parameters<typeof registerRoute>[1]);\n    }\n  }\n\n  const routeAuth = config.auth ?? config.manifest?.auth;\n  _setActiveRouteAuthOptions(routeAuth);\n\n  // Drain any lazy() imports so all split chunks are ready before mounting\n  await _drainLazy(pendingLazyAtBoot);\n\n  // Lock registration in production to prevent late registration surprises\n  if (isProductionEnvironment()) lockRouteRegistration();\n\n  // Mount the currently-resolved route handler (if any)\n  let path = typeof window !== 'undefined' ? window.location.pathname : '/';\n  let href =\n    typeof window !== 'undefined'\n      ? `${window.location.pathname}${window.location.search}${window.location.hash}`\n      : path;\n  let resolved = await resolveRouteRequest(href, { auth: routeAuth });\n\n  while (\n    typeof window !== 'undefined' &&\n    resolved &&\n    resolved.kind === 'redirect'\n  ) {\n    const redirectTarget = new URL(resolved.to, window.location.href);\n    const redirectHref = `${redirectTarget.pathname}${redirectTarget.search}${redirectTarget.hash}`;\n    window.history.replaceState({ path: redirectHref }, '', redirectHref);\n    path = redirectTarget.pathname;\n    href = redirectHref;\n    resolved = await resolveRouteRequest(href, { auth: routeAuth });\n  }\n\n  if (!resolved) {\n    mountOrUpdate(rootElement, () => ({ type: 'div', children: [] }), {\n      cleanupStrict: config.cleanupStrict,\n    });\n\n    await registerAppNavigation(rootElement, path);\n    return;\n  }\n\n  if (resolved.kind === 'redirect') {\n    mountOrUpdate(rootElement, () => ({ type: 'div', children: [] }), {\n      cleanupStrict: config.cleanupStrict,\n    });\n\n    await registerAppNavigation(rootElement, path);\n    return;\n  }\n\n  mountOrUpdate(\n    rootElement,\n    resolved.kind === 'deny'\n      ? bindDeniedStatus(resolved.status)\n      : bindResolvedRouteHandler({\n          handler: resolved.handler,\n          params: resolved.params,\n        }),\n    {\n      cleanupStrict: config.cleanupStrict,\n    }\n  );\n\n  await registerAppNavigation(rootElement, path);\n}\n\n/**\n * Mark elements that should be skipped during hydration\n */\nfunction markSkippedElements(root: Element, skipSelectors: string[]): void {\n  for (const selector of skipSelectors) {\n    const elements = root.querySelectorAll(selector);\n    elements.forEach((el) => el.setAttribute('data-skip-hydrate', 'true'));\n  }\n}\n\nfunction collectDeferredBelowFoldBoundaries(\n  root: Element,\n  foldY: number\n): Element[] {\n  const boundaries: Element[] = [];\n  const stack: Element[] = [];\n\n  for (let index = root.children.length - 1; index >= 0; index -= 1) {\n    stack.push(root.children[index]);\n  }\n\n  while (stack.length > 0) {\n    const element = stack.pop()!;\n\n    if (element.hasAttribute('data-skip-hydrate')) {\n      continue;\n    }\n\n    const rect = element.getBoundingClientRect();\n    if (rect.top >= foldY) {\n      element.setAttribute('data-skip-hydrate', 'true');\n      boundaries.push(element);\n      continue;\n    }\n\n    for (let index = element.children.length - 1; index >= 0; index -= 1) {\n      stack.push(element.children[index]);\n    }\n  }\n\n  return boundaries;\n}\n\nfunction activateVisibleDeferredBoundaries(\n  boundaries: Element[],\n  foldY: number\n): { activated: boolean; remaining: number } {\n  let activated = false;\n  let remaining = 0;\n\n  for (const element of boundaries) {\n    if (!element.hasAttribute('data-skip-hydrate')) {\n      continue;\n    }\n\n    const rect = element.getBoundingClientRect();\n    if (rect.top < foldY) {\n      element.removeAttribute('data-skip-hydrate');\n      activated = true;\n    } else {\n      remaining += 1;\n    }\n  }\n\n  return { activated, remaining };\n}\n\nfunction queueIdleWork(work: () => void): Promise<void> {\n  return new Promise((resolve) => {\n    if (typeof requestIdleCallback !== 'undefined') {\n      requestIdleCallback(\n        () => {\n          work();\n          resolve();\n        },\n        { timeout: 2000 }\n      );\n      return;\n    }\n\n    setTimeout(() => {\n      work();\n      resolve();\n    }, 0);\n  });\n}\n\nfunction flushHydrationActivation(rootElement: Element): void {\n  const instance = instancesByRoot.get(rootElement);\n  if (!instance) return;\n  instance._enqueueRun?.();\n  globalScheduler.flush();\n}\n\nfunction shouldVerifyHydrationMarkup(config: HydrateSPAConfig): boolean {\n  const explicit = config.hydrate?.verifyMarkup;\n  if (typeof explicit === 'boolean') {\n    return explicit;\n  }\n\n  return !isProductionEnvironment();\n}\n\nasync function registerAppNavigation(rootElement: Element, path: string) {\n  const instance = instancesByRoot.get(rootElement);\n  if (!instance) throw new Error('Internal error: app instance missing');\n  registerAppInstance(instance as ComponentInstance, path);\n  initializeNavigation();\n}\n\n/**\n * Apply selective hydration with deferral options\n */\nasync function applySelectiveHydration(\n  rootElement: Element,\n  resolved: { handler: ComponentFunction; params: Record<string, unknown> },\n  path: string,\n  cleanupStrict: boolean | undefined,\n  hydrateOptions: NonNullable<HydrateSPAConfig['hydrate']>\n): Promise<void> {\n  const hasPermanentSkips = (hydrateOptions.skipSelectors?.length ?? 0) > 0;\n  const hasBelowFoldDeferral = !!hydrateOptions.deferBelowFold;\n  const hasSelectiveBoundaries = hasPermanentSkips || hasBelowFoldDeferral;\n\n  if (hydrateOptions.skipSelectors?.length) {\n    markSkippedElements(rootElement, hydrateOptions.skipSelectors);\n  }\n\n  let deferredBoundaries: Element[] = [];\n  if (hydrateOptions.deferBelowFold) {\n    const foldY = hydrateOptions.foldThreshold ?? window.innerHeight;\n    deferredBoundaries = collectDeferredBelowFoldBoundaries(rootElement, foldY);\n\n    const handleScroll = () => {\n      const { activated, remaining } = activateVisibleDeferredBoundaries(\n        deferredBoundaries,\n        foldY\n      );\n\n      if (!activated) {\n        return;\n      }\n\n      flushHydrationActivation(rootElement);\n\n      if (remaining === 0) {\n        window.removeEventListener('scroll', handleScroll);\n      }\n    };\n\n    window.addEventListener('scroll', handleScroll, { passive: true });\n  }\n\n  if (hydrateOptions.deferUntilIdle && !hasSelectiveBoundaries) {\n    await queueIdleWork(() => {\n      mountOrUpdate(\n        rootElement,\n        (() => resolved.handler(resolved.params)) as ComponentFunction,\n        {\n          cleanupStrict,\n        }\n      );\n    });\n    await registerAppNavigation(rootElement, path);\n    return;\n  }\n\n  mountOrUpdate(\n    rootElement,\n    (() => resolved.handler(resolved.params)) as ComponentFunction,\n    {\n      cleanupStrict,\n    }\n  );\n  await registerAppNavigation(rootElement, path);\n\n  if (hydrateOptions.deferUntilIdle && deferredBoundaries.length > 0) {\n    await queueIdleWork(() => {\n      const { activated } = activateVisibleDeferredBoundaries(\n        deferredBoundaries,\n        Number.POSITIVE_INFINITY\n      );\n      if (activated) {\n        flushHydrationActivation(rootElement);\n      }\n    });\n  }\n}\n\n/**\n * hydrateSPA: Hydrate server-rendered HTML.\n * Accepts either a `manifest` (preferred) or a legacy `routes` array.\n */\nexport async function hydrateSPA(config: HydrateSPAConfig): Promise<void> {\n  assertExecutionModel('spa');\n  if (!config || typeof config !== 'object') {\n    throw new Error('hydrateSPA requires a config object');\n  }\n\n  const hasManifest =\n    config.manifest != null && config.manifest.records.length > 0;\n  const hasRoutes = Array.isArray(config.routes) && config.routes.length > 0;\n\n  if (!hasManifest && !hasRoutes) {\n    throw new Error(\n      'hydrateSPA requires a route manifest or route table. ' +\n        'Pass `manifest: getManifest()` or `routes: getRoutes()`. ' +\n        'If you are enhancing existing HTML, use createIsland instead.'\n    );\n  }\n\n  const rootElement =\n    typeof config.root === 'string'\n      ? document.getElementById(config.root)\n      : config.root;\n  if (!rootElement) throw new Error(`Root element not found: ${config.root}`);\n\n  const pendingLazyAtHydrationBoot = _snapshotLazy();\n\n  configureScrollRestoration(config.scrollRestoration);\n\n  clearRoutes();\n\n  if (hasManifest) {\n    _applyManifest(config.manifest!);\n  } else {\n    for (const r of config.routes!) {\n      registerRoute(r.path, r.handler as Parameters<typeof registerRoute>[1]);\n    }\n  }\n\n  _setActiveRouteAuthOptions(config.auth ?? config.manifest?.auth);\n\n  // Drain any lazy() imports so all split chunks are ready before mounting\n  await _drainLazy(pendingLazyAtHydrationBoot);\n\n  const path = typeof window !== 'undefined' ? window.location.pathname : '/';\n  const currentUrl =\n    typeof window !== 'undefined'\n      ? `${window.location.pathname}${window.location.search}${window.location.hash}`\n      : path;\n  setServerLocation(currentUrl);\n  if (isProductionEnvironment()) lockRouteRegistration();\n\n  const resolved = resolveRoute(path);\n  if (!resolved) {\n    throw new Error(`hydrateSPA: no route found for current path (${path}).`);\n  }\n\n  // Build a legacy-compatible routes array for the hydration verify call\n  const legacyRouteTable = hasManifest\n    ? config.manifest!.records.map((r) => ({\n        path: r.path,\n        handler: r.handler,\n        namespace: r.options.namespace,\n      }))\n    : config.routes!;\n\n  if (shouldVerifyHydrationMarkup(config)) {\n    const { verifyHydrationSyncForUrl } = await import('../ssr');\n    if (\n      !verifyHydrationSyncForUrl({\n        root: rootElement,\n        url: currentUrl,\n        routes: legacyRouteTable,\n      })\n    ) {\n      throw new Error(\n        '[Askr] Hydration mismatch detected. Server HTML does not match expected server-render output.'\n      );\n    }\n  }\n\n  const hydrateOptions = config.hydrate;\n  if (hydrateOptions) {\n    if (hydrateOptions.deferUntilIdle || hydrateOptions.deferBelowFold) {\n      await applySelectiveHydration(\n        rootElement,\n        {\n          handler: resolved.handler as ComponentFunction,\n          params: resolved.params as Record<string, unknown>,\n        },\n        path,\n        config.cleanupStrict,\n        hydrateOptions\n      );\n      return;\n    }\n\n    if (hydrateOptions.skipSelectors?.length) {\n      markSkippedElements(rootElement, hydrateOptions.skipSelectors);\n    }\n  }\n\n  mountOrUpdate(rootElement, bindResolvedRouteHandler(resolved), {\n    cleanupStrict: config.cleanupStrict,\n  });\n  await registerAppNavigation(rootElement, path);\n}\n\n/**\n * Cleanup an app mounted on a root element (element or id).\n * Safe to call multiple times — no-op when nothing is mounted.\n */\nexport function cleanupApp(root: Element | string): void {\n  const rootElement =\n    typeof root === 'string' ? document.getElementById(root) : root;\n\n  if (!rootElement) return;\n\n  const cleanupFn = (rootElement as ElementWithCleanup)[CLEANUP_SYMBOL];\n  if (typeof cleanupFn === 'function') {\n    cleanupFn();\n  }\n\n  instancesByRoot.delete(rootElement);\n}\n\n/**\n * Check whether an app is mounted on the given root\n */\nexport function hasApp(root: Element | string): boolean {\n  const rootElement =\n    typeof root === 'string' ? document.getElementById(root) : root;\n\n  if (!rootElement) return false;\n  return instancesByRoot.has(rootElement);\n}\n"],"mappings":"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"}

package/dist/common/component.d.ts

@@ -1,16 +1,17 @@
-/**
- * Common call contracts: Component signatures
- */
-import type { Props } from './props';
-import type { JSXElement } from './jsx';
-export type ComponentContext = {
-    signal: AbortSignal;
+import { Props } from "./props.js";
+import { JSXElement } from "./jsx.js";
+import { VNode } from "./vnode.js";
+
+//#region src/common/component.d.ts
+type ComponentContext = {
+  signal: AbortSignal;
 };
-import { type VNode } from './vnode';
-export type ComponentVNode = {
-    type: string;
-    props?: Props;
-    children?: (string | ComponentVNode | null | undefined | false)[];
+type ComponentVNode = {
+  type: string;
+  props?: Props;
+  children?: (string | ComponentVNode | null | undefined | false)[];
 };
-export type ComponentFunction = (props: Props, context?: ComponentContext) => JSXElement | VNode;
+type ComponentFunction = (props: Props, context?: ComponentContext) => JSXElement | VNode;
+//#endregion
+export { ComponentFunction };
 //# sourceMappingURL=component.d.ts.map

package/dist/common/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/common/component.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAKrC,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,CAAC,MAAM,GAAG,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,CAAC,EAAE,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAC9B,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,gBAAgB,KACvB,UAAU,GAAG,KAAK,CAAC"}
+{"version":3,"file":"component.d.ts","names":[],"sources":["../../src/common/component.ts"],"mappings":";;;;;KAOY,gBAAA;EACV,MAAA,EAAQ,WAAA;AAAA;AAAA,KAQE,cAAA;EACV,IAAA;EACA,KAAA,GAAQ,KAAA;EACR,QAAA,aAAqB,cAAA;AAAA;AAAA,KAGX,iBAAA,IACV,KAAA,EAAO,KAAA,EACP,OAAA,GAAU,gBAAA,KACP,UAAA,GAAa,KAAA"}

package/dist/common/control.d.ts

@@ -0,0 +1,13 @@
+import { Props } from "./props.js";
+
+//#region src/common/control.d.ts
+declare const __CONTROL_BOUNDARY__: unique symbol;
+declare const EAGER_CONTROL_PRIMITIVE: unique symbol;
+type EagerControlPrimitive<P extends Props = Props> = ((props: P) => unknown) & {
+  [EAGER_CONTROL_PRIMITIVE]?: true;
+};
+declare function markEagerControlPrimitive<T extends (...args: never[]) => unknown>(primitive: T): T;
+declare function isEagerControlPrimitive(value: unknown): value is EagerControlPrimitive;
+//#endregion
+export { EagerControlPrimitive };
+//# sourceMappingURL=control.d.ts.map

package/dist/common/control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","names":[],"sources":["../../src/common/control.ts"],"mappings":";;;cAEa,oBAAA;AAAA,cAEP,uBAAA;AAAA,KAEM,qBAAA,WAAgC,KAAA,GAAQ,KAAA,MAClD,KAAA,EAAO,CAAA;EAAA,CAEN,uBAAA;AAAA;AAAA,iBAGa,yBAAA,eACA,IAAA,sBAAA,CACd,SAAA,EAAW,CAAA,GAAI,CAAA;AAAA,iBASD,uBAAA,CACd,KAAA,YACC,KAAA,IAAS,qBAAA"}

package/dist/common/control.js

@@ -0,0 +1,14 @@
+//#region src/common/control.ts
+const __CONTROL_BOUNDARY__ = Symbol("__CONTROL_BOUNDARY__");
+const EAGER_CONTROL_PRIMITIVE = Symbol("__ASKR_EAGER_CONTROL_PRIMITIVE__");
+function markEagerControlPrimitive(primitive) {
+	primitive[EAGER_CONTROL_PRIMITIVE] = true;
+	return primitive;
+}
+function isEagerControlPrimitive(value) {
+	return typeof value === "function" && Boolean(value[EAGER_CONTROL_PRIMITIVE]);
+}
+//#endregion
+export { __CONTROL_BOUNDARY__, isEagerControlPrimitive, markEagerControlPrimitive };
+
+//# sourceMappingURL=control.js.map

package/dist/common/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","names":[],"sources":["../../src/common/control.ts"],"sourcesContent":["import type { Props } from './props';\n\nexport const __CONTROL_BOUNDARY__ = Symbol('__CONTROL_BOUNDARY__');\n\nconst EAGER_CONTROL_PRIMITIVE = Symbol('__ASKR_EAGER_CONTROL_PRIMITIVE__');\n\nexport type EagerControlPrimitive<P extends Props = Props> = ((\n  props: P\n) => unknown) & {\n  [EAGER_CONTROL_PRIMITIVE]?: true;\n};\n\nexport function markEagerControlPrimitive<\n  T extends (...args: never[]) => unknown,\n>(primitive: T): T {\n  (\n    primitive as T & {\n      [EAGER_CONTROL_PRIMITIVE]?: true;\n    }\n  )[EAGER_CONTROL_PRIMITIVE] = true;\n  return primitive;\n}\n\nexport function isEagerControlPrimitive(\n  value: unknown\n): value is EagerControlPrimitive {\n  return (\n    typeof value === 'function' &&\n    Boolean(\n      (\n        value as {\n          [EAGER_CONTROL_PRIMITIVE]?: true;\n        }\n      )[EAGER_CONTROL_PRIMITIVE]\n    )\n  );\n}\n"],"mappings":";AAEA,MAAa,uBAAuB,OAAO,uBAAuB;AAElE,MAAM,0BAA0B,OAAO,mCAAmC;AAQ1E,SAAgB,0BAEd,WAAiB;AAEf,WAGA,2BAA2B;AAC7B,QAAO;;AAGT,SAAgB,wBACd,OACgC;AAChC,QACE,OAAO,UAAU,cACjB,QAEI,MAGA,yBACH"}

package/dist/common/env.js

@@ -0,0 +1,47 @@
+//#region src/common/env.ts
+function normalizeEnv(source) {
+	if (!source) return {};
+	const normalized = {};
+	for (const [key, value] of Object.entries(source)) if (typeof value === "string") normalized[key] = value;
+	else if (typeof value === "boolean" || typeof value === "number") normalized[key] = String(value);
+	return normalized;
+}
+function getBuildTimeEnv() {
+	const metaEnv = import.meta.env;
+	const normalized = normalizeEnv(metaEnv);
+	if (normalized.NODE_ENV == null && metaEnv) {
+		if (typeof metaEnv.MODE === "string" && metaEnv.MODE.length > 0) normalized.NODE_ENV = metaEnv.MODE;
+		else if (metaEnv.PROD === true || metaEnv.PROD === "true") normalized.NODE_ENV = "production";
+		else if (metaEnv.DEV === true || metaEnv.DEV === "true") normalized.NODE_ENV = "development";
+	}
+	return normalized;
+}
+function resolveNodeEnv(processNodeEnv, buildNodeEnv) {
+	if (buildNodeEnv === "production") return "production";
+	if (processNodeEnv != null) return processNodeEnv;
+	if (buildNodeEnv === "development") return "development";
+	return buildNodeEnv === "test" ? void 0 : buildNodeEnv;
+}
+function getRuntimeEnv() {
+	const processEnv = globalThis.process?.env ?? {};
+	const buildTimeEnv = getBuildTimeEnv();
+	return {
+		...processEnv,
+		...buildTimeEnv,
+		NODE_ENV: resolveNodeEnv(processEnv.NODE_ENV, buildTimeEnv.NODE_ENV)
+	};
+}
+function isProductionEnvironment() {
+	return getRuntimeEnv().NODE_ENV === "production";
+}
+function isDevelopmentEnvironment() {
+	return !isProductionEnvironment();
+}
+function isRuntimeEnvFlagEnabled(name) {
+	const value = getRuntimeEnv()[name];
+	return value === "1" || value === "true";
+}
+//#endregion
+export { getRuntimeEnv, isDevelopmentEnvironment, isProductionEnvironment, isRuntimeEnvFlagEnabled };
+
+//# sourceMappingURL=env.js.map