@askrjs/askr 0.0.69 → 0.0.71

package/capabilities.json

@@ -0,0 +1,66 @@
+{
+  "version": 1,
+  "package": "@askrjs/askr",
+  "capabilities": [
+    {
+      "intent": "reactive state and derived views",
+      "package": "@askrjs/askr",
+      "import": "@askrjs/askr",
+      "exports": ["state", "derive", "selector", "For"],
+      "constraints": ["component render scope", "stable call order"],
+      "stability": "stable",
+      "docs": "https://github.com/askrjs/askr/blob/main/docs/guides/state.md",
+      "docsPath": "docs/guides/state.md"
+    },
+    {
+      "intent": "routing and navigation",
+      "package": "@askrjs/askr",
+      "import": "@askrjs/askr/router",
+      "exports": ["route", "Link", "navigate", "createRouteRegistry"],
+      "constraints": ["route registry owns navigation"],
+      "stability": "stable",
+      "docs": "https://github.com/askrjs/askr/blob/main/docs/guides/router.md",
+      "docsPath": "docs/guides/router.md"
+    },
+    {
+      "intent": "server rendering",
+      "package": "@askrjs/askr",
+      "import": "@askrjs/askr/ssr",
+      "exports": ["renderToString"],
+      "constraints": ["browser globals require lazy client targets"],
+      "stability": "stable",
+      "docs": "https://github.com/askrjs/askr/blob/main/docs/guides/ssr.md",
+      "docsPath": "docs/guides/ssr.md"
+    },
+    {
+      "intent": "static generation",
+      "package": "@askrjs/askr",
+      "import": "@askrjs/askr/ssg",
+      "exports": ["createStaticGen"],
+      "constraints": ["routes must be deterministic"],
+      "stability": "stable",
+      "docs": "https://github.com/askrjs/askr/blob/main/docs/guides/ssg.md",
+      "docsPath": "docs/guides/ssg.md"
+    },
+    {
+      "intent": "error boundaries",
+      "package": "@askrjs/askr",
+      "import": "@askrjs/askr/components",
+      "exports": ["ErrorBoundary"],
+      "constraints": ["portal hosts are finalized during render"],
+      "stability": "stable",
+      "docs": "https://github.com/askrjs/askr/blob/main/docs/reference/api.md",
+      "docsPath": "docs/reference/api.md"
+    },
+    {
+      "intent": "portals",
+      "package": "@askrjs/askr",
+      "import": "@askrjs/askr/foundations/structures",
+      "exports": ["Portal", "DefaultPortal"],
+      "constraints": ["portal hosts are finalized during render"],
+      "stability": "stable",
+      "docs": "https://github.com/askrjs/askr/blob/main/docs/reference/api.md",
+      "docsPath": "docs/reference/api.md"
+    }
+  ]
+}

package/dist/actions/index.d.ts

@@ -1,2 +1,2 @@
-import { a as action, i as ActionValidationError, n as ActionForm, o as defineAction, r as ActionStatus, t as ActionDescriptor } from "../index-DSClfSoC.js";
+import { a as action, i as ActionValidationError, n as ActionForm, o as defineAction, r as ActionStatus, t as ActionDescriptor } from "../index-DxYJPVC4.js";
 export { ActionDescriptor, ActionForm, ActionStatus, ActionValidationError, action, defineAction };

package/dist/actions/index.js

@@ -2,7 +2,7 @@ import { d as getCurrentAppRenderRuntime } from "../component-scope-CC3cojX9.js"
 import { r as getCurrentRenderData } from "../render-context-Clw3rFiO.js";
 import { t as state } from "../state-CVuQVjvK.js";
 import { jsx, jsxs } from "../jsx-runtime.js";
-import { c as resolveDataRuntimeState, s as invalidateQueriesForRuntime } from "../data-runtime-SJ1BSUvk.js";
+import { c as resolveDataRuntimeState, s as invalidateQueriesForRuntime } from "../data-runtime-rpV6-3XW.js";
 //#region src/actions/runtime.ts
 const emptyFramework = Object.freeze({});
 /** @internal Read Askr-owned state from the current application root. */
@@ -59,6 +59,12 @@ function initialStatus(actionId) {
 		error: replay
 	} : { pending: false };
 }
+function normalizeActionRedirect(value) {
+	const current = new URL(location.href);
+	const target = new URL(value, current);
+	if (target.protocol !== "http:" && target.protocol !== "https:" || target.origin !== current.origin) throw new TypeError("Action redirects must stay on the current origin.");
+	return `${target.pathname}${target.search}${target.hash}`;
+}
 /** Returns a command handle, rather than a hook. */
 function action(descriptor) {
 	const token = csrfToken();
@@ -82,13 +88,14 @@ function action(descriptor) {
 				});
 				const envelope = await response.json();
 				if (!response.ok) throw envelope.error ?? validationError(envelope, descriptor.id) ?? /* @__PURE__ */ new Error(`Action failed (${response.status}).`);
+				const redirect = typeof envelope.redirect === "string" ? normalizeActionRedirect(envelope.redirect) : void 0;
 				const invalidates = Array.isArray(envelope.invalidates) ? envelope.invalidates.filter((prefix) => typeof prefix === "string") : descriptor.invalidates;
 				for (const prefix of invalidates) invalidateQueriesForRuntime(runtime, prefix, true);
 				setValue({
 					pending: false,
 					result: envelope.result
 				});
-				if (typeof envelope.redirect === "string") location.assign(envelope.redirect);
+				if (redirect) location.assign(redirect);
 				return envelope.result;
 			} catch (error) {
 				setValue({

package/dist/activity-C2tPn9Fr.js

@@ -0,0 +1,152 @@
+import { a as registerCommitOperation } from "./component-internal-CPjM4n8M.js";
+import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-BYSoWJSv.js";
+import { d as getCurrentAppRenderRuntime, f as getCurrentComponentInstance, i as claimHookIndex } from "./component-scope-CC3cojX9.js";
+import { n as getActiveRenderContext } from "./render-context-Clw3rFiO.js";
+import { c as deepFreeze, g as getActiveRoutes, l as makeQuery, n as computeMatchesFromRoutes, u as parseLocation } from "./route-matching-M-f1VQRu.js";
+import { n as syncRouteActivitySnapshot } from "./route-activity-CNJfpwx-.js";
+//#region src/common/app-render-runtime.ts
+const stagedRouteLocations = /* @__PURE__ */ new WeakMap();
+function createAppRenderRuntime(input = {}) {
+	return {
+		framework: Object.freeze({ ...input.framework }),
+		route: input.route,
+		hasRoute: input.hasRoute ?? false
+	};
+}
+function stageAppRenderRouteLocation(runtime, href) {
+	stagedRouteLocations.set(runtime, href);
+}
+function getStagedAppRenderRouteLocation(runtime) {
+	return runtime ? stagedRouteLocations.get(runtime) : void 0;
+}
+function clearStagedAppRenderRouteLocation(runtime) {
+	if (runtime) stagedRouteLocations.delete(runtime);
+}
+//#endregion
+//#region src/router/activity.ts
+function routeSignature(route) {
+	return `${route.path}\u0000${JSON.stringify(route.query.toJSON())}\u0000${route.hash ?? ""}`;
+}
+let currentRouteSnapshot = buildRouteSnapshot("/", "", "");
+const currentRouteSource = (() => currentRouteSnapshot);
+currentRouteSource._readers = /* @__PURE__ */ new Map();
+function onRouteChange(fn, options = {}) {
+	const instance = getCurrentComponentInstance();
+	if (!instance) return;
+	const route = currentRoute();
+	const index = claimHookIndex(instance, "route-change");
+	const slots = instance.lifecycleSlots ??= [];
+	const existing = slots[index];
+	if (existing && existing.kind !== "route-change") throw new Error(`onRouteChange() lifecycle order violation: slot ${index} already belongs to ${existing.kind}(). Keep lifecycle primitives in a stable top-level order.`);
+	const slot = existing ?? {
+		kind: "route-change",
+		previous: null,
+		pending: null,
+		cleanup: null,
+		cleanupRegistered: false,
+		callback: fn,
+		immediate: options.immediate === true
+	};
+	slots[index] = slot;
+	slot.pending = route;
+	slot.callback = fn;
+	slot.immediate = options.immediate === true;
+	if (!slot.cleanupRegistered) {
+		instance.cleanupFns ??= [];
+		instance.cleanupFns.push(() => {
+			slot.cleanup?.();
+			slot.cleanup = null;
+		});
+		slot.cleanupRegistered = true;
+	}
+	if (!slot.previous) {
+		registerCommitOperation(() => {
+			const committed = slot.pending;
+			if (!committed) return;
+			if (slot.immediate) slot.cleanup = slot.callback(committed, null) ?? null;
+			slot.previous = committed;
+		});
+		return;
+	}
+	if (routeSignature(slot.previous) === routeSignature(route)) return;
+	registerCommitOperation(() => {
+		const previous = slot.previous;
+		const committed = slot.pending;
+		if (!previous || !committed || routeSignature(previous) === routeSignature(committed)) return;
+		slot.cleanup?.();
+		slot.cleanup = slot.callback(committed, previous) ?? null;
+		slot.previous = committed;
+	});
+}
+let serverLocation = null;
+function setServerLocation(url) {
+	serverLocation = url;
+	if (url) {
+		const parsed = parseLocation(url);
+		syncRouteActivitySnapshot(parsed.pathname, computeMatchesFromRoutes(parsed.pathname, getActiveRoutes()));
+		return;
+	}
+	syncRouteActivitySnapshot(currentRouteSnapshot.path, currentRouteSnapshot.matches);
+}
+function buildRouteSnapshot(pathname, search, hash) {
+	const query = makeQuery(search);
+	const matches = computeMatchesFromRoutes(pathname, getActiveRoutes());
+	return Object.freeze({
+		path: pathname,
+		params: deepFreeze({ ...matches[0]?.params }),
+		query,
+		hash: hash || null,
+		matches: Object.freeze(matches)
+	});
+}
+function setCurrentRouteSnapshot(pathname, search, hash, activityMatches) {
+	currentRouteSnapshot = buildRouteSnapshot(pathname, search, hash);
+	syncRouteActivitySnapshot(pathname, activityMatches ?? currentRouteSnapshot.matches);
+	const instance = getCurrentComponentInstance();
+	markReadableDerivedSubscribersDirty(currentRouteSource);
+	markReactivePropsDirtySource(currentRouteSource);
+	notifyReadableReaders(currentRouteSource, instance);
+}
+function readCurrentRouteLocation() {
+	const renderContext = getActiveRenderContext();
+	if (renderContext?.url) return parseLocation(renderContext.url);
+	const stagedRouteLocation = getStagedAppRenderRouteLocation(getCurrentAppRenderRuntime());
+	if (stagedRouteLocation) return parseLocation(stagedRouteLocation);
+	if (typeof window !== "undefined" && window.location) return {
+		pathname: window.location.pathname || "/",
+		search: window.location.search || "",
+		hash: window.location.hash || ""
+	};
+	if (serverLocation) return parseLocation(serverLocation);
+	return {
+		pathname: currentRouteSnapshot.path,
+		search: "",
+		hash: currentRouteSnapshot.hash ?? ""
+	};
+}
+function readCurrentRouteSnapshot() {
+	if (!getCurrentComponentInstance()) throw new Error("currentRoute() can only be called during component render execution. Call currentRoute() from inside your component function.");
+	const { pathname, search, hash } = readCurrentRouteLocation();
+	const query = makeQuery(search);
+	const matches = computeMatchesFromRoutes(pathname, getActiveRoutes());
+	const params = deepFreeze({ ...getActiveRenderContext()?.params ?? matches[0]?.params ?? {} });
+	return Object.freeze({
+		path: pathname,
+		params,
+		query,
+		hash: hash || null,
+		matches: Object.freeze(matches)
+	});
+}
+function currentRoute() {
+	const instance = getCurrentComponentInstance();
+	if (!instance) throw new Error("currentRoute() can only be called during component render execution. Call currentRoute() from inside your component function.");
+	if (typeof window === "undefined" || instance.ssr) return readCurrentRouteSnapshot();
+	recordReadableRead(currentRouteSource);
+	return readCurrentRouteSnapshot();
+}
+function syncCurrentRouteSnapshot(pathname, search, hash, activityMatches) {
+	setCurrentRouteSnapshot(pathname, search, hash, activityMatches);
+}
+//#endregion
+export { clearStagedAppRenderRouteLocation as a, syncCurrentRouteSnapshot as i, onRouteChange as n, createAppRenderRuntime as o, setServerLocation as r, stageAppRenderRouteLocation as s, currentRoute as t };

package/dist/activity-DZ-NCYr8.d.ts

@@ -0,0 +1,10 @@
+import { B as RouteSnapshot, E as RouteParams } from "./router-C3vENhUh.js";
+//#region src/router/activity.d.ts
+interface RouteChangeOptions {
+  immediate?: boolean;
+}
+type RouteChangeCleanup = void | (() => void);
+declare function onRouteChange(fn: (current: RouteSnapshot, previous: RouteSnapshot | null) => RouteChangeCleanup, options?: RouteChangeOptions): void;
+declare function currentRoute<TParams extends RouteParams = RouteParams>(): RouteSnapshot<TParams>;
+//#endregion
+export { onRouteChange as i, RouteChangeOptions as n, currentRoute as r, RouteChangeCleanup as t };

package/dist/{authoring-uaJ556aG.js → authoring-CXmUcaCe.js}

@@ -1,6 +1,6 @@
 import { f as getCurrentComponentInstance } from "./component-scope-CC3cojX9.js";
-import { T as getExecutionModel, x as createRouteHandler } from "./deferred-zHtUheIQ.js";
-import { A as insertRecordSorted, C as getCurrentPathPrefix, I as computeRank, L as normalizeRouteSegmentName, M as pushRegistrationScope, O as hasActivePageScope, R as parseSegments, S as getCurrentPageScope, _ as getCurrentInheritedAuthRequirements, b as getCurrentLayoutChain, f as addRouteToStores, p as assertRouteRegistrationUnlocked, v as getCurrentInheritedMeta, w as getCurrentScopeKind, x as getCurrentPageChain, y as getCurrentInheritedPolicies } from "./route-matching-DLBWDeXX.js";
+import { T as getExecutionModel, x as createRouteHandler } from "./deferred-Cr58yIQD.js";
+import { A as insertRecordSorted, C as getCurrentPathPrefix, I as computeRank, L as normalizeRouteSegmentName, M as pushRegistrationScope, O as hasActivePageScope, R as parseSegments, S as getCurrentPageScope, _ as getCurrentInheritedAuthRequirements, b as getCurrentLayoutChain, f as addRouteToStores, p as assertRouteRegistrationUnlocked, v as getCurrentInheritedMeta, w as getCurrentScopeKind, x as getCurrentPageChain, y as getCurrentInheritedPolicies } from "./route-matching-M-f1VQRu.js";
 import { allOf } from "@askrjs/auth";
 //#region src/router/access.ts
 function compileNodePolicies(node) {

package/dist/benchmark.d.ts

@@ -1,4 +1,4 @@
-import "./jsx-runtime-X2SX2y8V.js";
+import "./jsx-runtime-C6Fs8Mmc.js";
 //#region src/bench/components/benchmark-row.d.ts
 interface BenchmarkRowData {
   id: number;

package/dist/benchmark.js

@@ -1,10 +1,10 @@
 import { r as flushRuntimeScheduler } from "./access-ePqdQqkV.js";
-import { t as installRendererBridge } from "./renderer-CBBbYZUO.js";
+import { t as installRendererBridge } from "./renderer-BJYY2Y8s.js";
 import { t as state } from "./state-CVuQVjvK.js";
-import { t as selector } from "./selector-DueeR6Oz.js";
+import { t as selector } from "./selector-DEfqO1rA.js";
 import { jsx, jsxs } from "./jsx-runtime.js";
-import { i as For } from "./control-CA45Yvvu.js";
-import { t as createIsland } from "./boot-aTei9rjA.js";
+import { i as For } from "./control-DVRBkN2X.js";
+import { t as createIsland } from "./boot-DIKbEA4Y.js";
 //#region src/bench/components/benchmark-row.tsx
 function BenchmarkRow({ item, isSelected, onSelect, onRemove }) {
 	return /* @__PURE__ */ jsxs("tr", {
@@ -63,8 +63,8 @@ function BenchmarkTable({ rows, isSelected, onSelect, onRemove }) {
 installRendererBridge();
 const benchmarkMetadata = {
 	packageName: "@askrjs/askr",
-	packageVersion: "0.0.69",
-	buildLabel: "0.0.69-local"
+	packageVersion: "0.0.71",
+	buildLabel: "0.0.71-local"
 };
 function getBenchmarkMetadata() {
 	return { ...benchmarkMetadata };

package/dist/boot/index.d.ts

@@ -1,7 +1,7 @@
 import { s as ComponentFunction } from "../control-DO-iBEtV.js";
 import { v as DataRuntime } from "../index-Bki2rqcr.js";
-import { N as RouteRegistry, p as RouteAuthOptions } from "../router-C0XQA62W.js";
-import { a as ScrollRestorationOptions } from "../navigate-CV-RDqYP.js";
+import { N as RouteRegistry, p as RouteAuthOptions } from "../router-C3vENhUh.js";
+import { a as ScrollRestorationOptions } from "../navigate-Cbq6QHVl.js";
 //#region src/boot/types.d.ts
 type IslandConfig = {
   root: Element | string;

package/dist/boot/index.js

@@ -1,2 +1,2 @@
-import { a as cleanupApp, i as hydrateSPA, n as createIslands, o as hasApp, r as createSPA, t as createIsland } from "../boot-aTei9rjA.js";
+import { a as cleanupApp, i as hydrateSPA, n as createIslands, o as hasApp, r as createSPA, t as createIsland } from "../boot-DIKbEA4Y.js";
 export { cleanupApp, createIsland, createIslands, createSPA, hasApp, hydrateSPA };

package/dist/{boot-aTei9rjA.js → boot-DIKbEA4Y.js}

@@ -3,16 +3,17 @@ import { n as Fragment, t as ELEMENT_TYPE } from "./jsx-CUpRxrLH.js";
 import { n as createComponentInstance, r as executeComponent } from "./component-internal-CPjM4n8M.js";
 import { t as cleanupComponent } from "./component-cleanup-1ZFoLLHt.js";
 import { p as isPromiseLike } from "./lifecycle-batch-COgl8jMS.js";
-import { a as withIntrinsicHydrationAdoption, c as beginHydrationListenerTransaction, d as setStaticChildSlotsCacheEnabled, i as registerDeferredHydrationBoundary, l as commitHydrationListenerTransaction, n as activateHydrationBoundary$1, o as beginHydrationDirectListenerMode, r as clearDeferredHydrationBoundaries, s as endHydrationDirectListenerMode, t as installRendererBridge, u as discardHydrationListenerTransaction } from "./renderer-CBBbYZUO.js";
-import { _ as teardownNodeSubtree, d as removeAllListeners } from "./cleanup-UyStxIHG.js";
-import { c as _applyManifest, d as getRouteRenderContext, f as getRouteRenderData, m as resolveRouteRequest, o as reviveDeferredValue, p as hasRouteRenderData, v as pageRenderEnvelope, w as assertExecutionModel } from "./deferred-zHtUheIQ.js";
+import { a as withIntrinsicHydrationAdoption, c as beginHydrationListenerTransaction, d as setStaticChildSlotsCacheEnabled, i as registerDeferredHydrationBoundary, l as commitHydrationListenerTransaction, n as activateHydrationBoundary$1, o as beginHydrationDirectListenerMode, r as clearDeferredHydrationBoundaries, s as endHydrationDirectListenerMode, t as installRendererBridge, u as discardHydrationListenerTransaction } from "./renderer-BJYY2Y8s.js";
+import { _ as teardownNodeSubtree, d as removeAllListeners } from "./cleanup-D8Ufd9Ix.js";
+import { c as _applyManifest, d as getRouteRenderContext, f as getRouteRenderData, m as resolveRouteRequest, o as reviveDeferredValue, p as hasRouteRenderData, v as pageRenderEnvelope, w as assertExecutionModel } from "./deferred-Cr58yIQD.js";
 import { a as startHydrationRenderPhase, s as stopHydrationRenderPhase } from "./render-context-Clw3rFiO.js";
-import { a as disposeDefaultPortalScope, t as DefaultPortal } from "./portal-D7TC986A.js";
-import { r as validateCspNonce, t as CspNonceScope } from "./csp-nonce-HGZ0vbqT.js";
-import { i as getDefaultDataRuntime } from "./data-runtime-SJ1BSUvk.js";
-import { a as hydrateDataRuntime } from "./query-registry-CQIT4mXr.js";
-import { d as _setActiveRouteAuthOptions, j as lockRouteRegistration, k as hasRegisteredRoutes, m as clearRouteState } from "./route-matching-DLBWDeXX.js";
-import { f as registerAppInstance, g as unregisterAppInstance, i as resolveRouteMeta, o as configureScrollRestoration, r as reconcileRouteMeta, t as initializeNavigation, v as setServerLocation, y as createAppRenderRuntime } from "./navigate-DpR-cML9.js";
+import { d as _setActiveRouteAuthOptions, j as lockRouteRegistration, k as hasRegisteredRoutes, m as clearRouteState } from "./route-matching-M-f1VQRu.js";
+import { a as disposeDefaultPortalScope, t as DefaultPortal } from "./portal-wY3j0vvp.js";
+import { r as validateCspNonce, t as CspNonceScope } from "./csp-nonce-CwSRP3Jl.js";
+import { i as getDefaultDataRuntime } from "./data-runtime-rpV6-3XW.js";
+import { a as hydrateDataRuntime } from "./query-registry-Bu_cuMch.js";
+import { o as createAppRenderRuntime, r as setServerLocation } from "./activity-C2tPn9Fr.js";
+import { f as registerAppInstance, g as unregisterAppInstance, i as resolveRouteMeta, o as configureScrollRestoration, r as reconcileRouteMeta, t as initializeNavigation } from "./navigate-CuGQzS_Y.js";
 import "./ssr-CbQO5xd3.js";
 //#region src/boot/hydration.ts
 const DEFERRED_PAYLOAD = "__askr_deferred__";
@@ -584,7 +585,7 @@ async function hydrateSPA(config) {
 		cspNonce: config.cspNonce
 	}));
 	if (shouldVerifyHydrationMarkup(config)) {
-		const { verifyHydrationSyncForUrl } = await import("./verify-hydration-ChyEiBAn.js");
+		const { verifyHydrationSyncForUrl } = await import("./verify-hydration-CVSGv6Vs.js");
 		if (!verifyHydrationSyncForUrl({
 			root: rootElement,
 			url: currentUrl,

package/dist/{cleanup-UyStxIHG.js → cleanup-D8Ufd9Ix.js}

@@ -36,6 +36,13 @@ const DELEGATED_EVENTS = [
 	"touchmove",
 	"touchcancel"
 ];
+function createDelegatedEventFacade(event, currentTarget) {
+	return new Proxy(event, { get(target, property, receiver) {
+		if (property === "currentTarget") return currentTarget;
+		const value = Reflect.get(target, property, target);
+		return typeof value === "function" ? value.bind(target) : value;
+	} });
+}
 const DELEGATED_HANDLERS = Symbol("askr.delegated-handlers");
 const delegatedHandlerFallback = /* @__PURE__ */ new WeakMap();
 function getDelegatedHandlerStore(element) {
@@ -94,22 +101,36 @@ function attachDelegatedListener(container, element, eventName, handler, origina
 		const delegatedHandler = (e) => {
 			runRuntimeHandlerScope(() => {
 				const path = [];
-				if (typeof e.composedPath === "function") path.push(...e.composedPath());
-				else {
-					let node = e.target;
-					while (node) {
+				const seenPathNodes = /* @__PURE__ */ new Set();
+				let node = e.target;
+				while (node) {
+					if (!seenPathNodes.has(node)) {
+						seenPathNodes.add(node);
 						path.push(node);
-						if (node === container) break;
-						node = isElementNode(node) ? node.parentNode : node.parentNode;
 					}
+					if (node === container) break;
+					node = isElementNode(node) ? node.parentNode : node.parentNode;
 				}
+				if (typeof e.composedPath === "function") {
+					for (const composedNode of e.composedPath()) if (!seenPathNodes.has(composedNode)) {
+						seenPathNodes.add(composedNode);
+						path.push(composedNode);
+					}
+				}
+				const dispatchPath = [];
 				for (const node of path) {
 					if (node === container) break;
 					if (!isElementNode(node)) continue;
 					const store = getDelegatedHandlerStore(node);
 					const entry = !store ? void 0 : store instanceof Map ? store.get(eventName) : store.eventName === eventName ? store : void 0;
-					if (entry) try {
-						entry.handler(e);
+					if (entry) dispatchPath.push({
+						node,
+						entry
+					});
+				}
+				for (const { node, entry } of dispatchPath) {
+					try {
+						entry.handler(createDelegatedEventFacade(e, node));
 					} catch (error) {
 						logger.error("[Askr] Delegated event error:", error);
 					}

package/dist/components/index.d.ts

@@ -12,6 +12,7 @@ interface ErrorBoundaryProps extends Props {
 }
 //#endregion
 //#region src/components/error-boundary.d.ts
+/** Creates a render-time boundary whose fallback handles descendant render/commit errors. */
 declare function ErrorBoundary(props: ErrorBoundaryProps): JSXElement;
 //#endregion
 export { ErrorBoundary, type ErrorBoundaryFallbackRender, type ErrorBoundaryProps };

package/dist/components/index.js

@@ -30,6 +30,7 @@ function createBoundaryVNode(instance, props) {
 		__instance: instance
 	};
 }
+/** Creates a render-time boundary whose fallback handles descendant render/commit errors. */
 function ErrorBoundary(props) {
 	const instance = getCurrentComponentInstance();
 	if (!instance) throw new Error("[Askr] ErrorBoundary() can only be used during component render execution.");

package/dist/control/index.d.ts

@@ -1,2 +1,2 @@
-import { a as Show, c as ForProps, i as MatchProps, n as CaseProps, o as ShowProps, r as Match, s as For, t as Case } from "../index-Dh6ZF9yW.js";
+import { a as Show, c as ForProps, i as MatchProps, n as CaseProps, o as ShowProps, r as Match, s as For, t as Case } from "../index-UmwPZ8ZN.js";
 export { Case, type CaseProps, For, type ForProps, Match, type MatchProps, Show, type ShowProps };

package/dist/control/index.js

@@ -1,2 +1,2 @@
-import { i as For, n as Match, r as Show, t as Case } from "../control-CA45Yvvu.js";
+import { i as For, n as Match, r as Show, t as Case } from "../control-DVRBkN2X.js";
 export { Case, For, Match, Show };

package/dist/{control-CA45Yvvu.js → control-DVRBkN2X.js}

@@ -22,9 +22,14 @@ function resolveMaybeAccessor(value) {
 //#endregion
 //#region src/control/for.ts
 /**
-* For JSX primitive
+* Render a reactive list as keyed child scopes.
 *
-* Creates a keyed child-scope boundary for efficient list rendering.
+* The `children` callback receives a snapshot item during boundary
+* reconciliation. A plain closure read of parent state is therefore not a
+* dependency of an existing row. Use `selector(() => value())` for keyed
+* membership reads, or a function-valued prop when only a DOM property needs
+* to update. See the reactive control-flow guide for the supported patterns:
+* https://github.com/askrjs/askr/blob/main/docs/guides/control-flow.md
 */
 function resolveEach(each) {
 	const resolved = typeof each === "function" ? each() : each;

package/dist/{csp-nonce-HGZ0vbqT.js → csp-nonce-CwSRP3Jl.js}

@@ -1,4 +1,19 @@
 import { h as readScope, u as defineScope } from "./component-internal-CPjM4n8M.js";
+//#region src/common/url.ts
+const SAFE_URL_SCHEMES = /* @__PURE__ */ new Set([
+	"http",
+	"https",
+	"mailto",
+	"sms",
+	"tel"
+]);
+const URL_SCHEME_RE = /^([a-z][a-z0-9+.-]*):/i;
+function isSafeHref(value) {
+	const compact = value.trim().replace(/[\u0000-\u0020\u007f-\u009f]/g, "");
+	const scheme = URL_SCHEME_RE.exec(compact)?.[1]?.toLowerCase();
+	return scheme === void 0 || SAFE_URL_SCHEMES.has(scheme);
+}
+//#endregion
 //#region src/common/router-internal.ts
 const ROUTE_ROOT_COMPONENT = Symbol.for("askr.route-root-component");
 //#endregion
@@ -30,4 +45,4 @@ function validateCspNonce(value) {
 	return value;
 }
 //#endregion
-export { ROUTE_ROOT_COMPONENT as i, cspNonce as n, validateCspNonce as r, CspNonceScope as t };
+export { isSafeHref as a, ROUTE_ROOT_COMPONENT as i, cspNonce as n, validateCspNonce as r, CspNonceScope as t };

package/dist/css-BuPaTOfe.js

@@ -0,0 +1,70 @@
+//#region src/common/attr-names.ts
+const PUBLIC_ATTRIBUTE_NAME_MAP = {
+	className: "class",
+	htmlFor: "for",
+	strokeWidth: "stroke-width",
+	strokeLinecap: "stroke-linecap",
+	strokeLinejoin: "stroke-linejoin",
+	fillRule: "fill-rule",
+	clipRule: "clip-rule"
+};
+function getPublicAttributeName(propName) {
+	return PUBLIC_ATTRIBUTE_NAME_MAP[propName] ?? propName;
+}
+//#endregion
+//#region src/common/css.ts
+const CSS_UNSAFE_RE = /[{}<>\\]/g;
+const CSS_URI_SCHEME_RE = /(?:^|[\s(,])([a-z][a-z0-9+.-]*):/i;
+const CSS_FUNCTION_NAME_RE = /([a-z-][a-z0-9-]*)\s*\(/gi;
+const CSS_ALLOWED_FUNCTIONS = /* @__PURE__ */ new Set([
+	"var",
+	"calc",
+	"min",
+	"max",
+	"clamp",
+	"rgb",
+	"rgba",
+	"hsl",
+	"hsla",
+	"lab",
+	"lch",
+	"oklab",
+	"oklch",
+	"color",
+	"color-mix",
+	"translate",
+	"translatex",
+	"translatey",
+	"translatez",
+	"scale",
+	"scalex",
+	"scaley",
+	"scalez",
+	"rotate",
+	"rotatex",
+	"rotatey",
+	"rotatez",
+	"skew",
+	"skewx",
+	"skewy",
+	"matrix",
+	"matrix3d",
+	"linear-gradient",
+	"radial-gradient",
+	"conic-gradient",
+	"repeating-linear-gradient",
+	"repeating-radial-gradient",
+	"repeating-conic-gradient",
+	"cubic-bezier",
+	"steps"
+]);
+function sanitizeCssValue(value) {
+	const str = String(value);
+	if (CSS_URI_SCHEME_RE.test(str)) return "";
+	if (str.includes("(")) {
+		for (const match of str.matchAll(CSS_FUNCTION_NAME_RE)) if (!CSS_ALLOWED_FUNCTIONS.has(match[1].toLowerCase())) return "";
+	}
+	return str.replace(CSS_UNSAFE_RE, "");
+}
+//#endregion
+export { getPublicAttributeName as n, sanitizeCssValue as t };

package/dist/data/index.js

@@ -1,4 +1,4 @@
-import { i as getDefaultDataRuntime, t as createDataRuntime } from "../data-runtime-SJ1BSUvk.js";
-import { a as queryScope, i as invalidateOnInterval, n as createMutation, r as invalidate, t as createQuery } from "../data-DHt_zO1G.js";
-import { a as hydrateDataRuntime, i as dehydrateDataRuntime, n as defineQuery, o as prefetchQuery, r as defineServerQueries, s as serveQuery, t as createQueryPrefetchContext } from "../query-registry-CQIT4mXr.js";
+import { i as getDefaultDataRuntime, t as createDataRuntime } from "../data-runtime-rpV6-3XW.js";
+import { a as queryScope, i as invalidateOnInterval, n as createMutation, r as invalidate, t as createQuery } from "../data-DFcSmGvN.js";
+import { a as hydrateDataRuntime, i as dehydrateDataRuntime, n as defineQuery, o as prefetchQuery, r as defineServerQueries, s as serveQuery, t as createQueryPrefetchContext } from "../query-registry-Bu_cuMch.js";
 export { createDataRuntime, createMutation, createQuery, createQueryPrefetchContext, defineQuery, defineServerQueries, dehydrateDataRuntime, getDefaultDataRuntime, hydrateDataRuntime, invalidate, invalidateOnInterval, prefetchQuery, queryScope, serveQuery };

package/dist/{data-DHt_zO1G.js → data-DFcSmGvN.js}

@@ -2,8 +2,8 @@ import { n as enqueueRuntimeTask, v as logger } from "./access-ePqdQqkV.js";
 import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-BYSoWJSv.js";
 import { f as getCurrentComponentInstance, i as claimHookIndex } from "./component-scope-CC3cojX9.js";
 import { n as getActiveRenderContext } from "./render-context-Clw3rFiO.js";
-import { c as windowFocused, i as routeActive, n as documentVisible, s as timer } from "./lifecycle-operations-SlPEK68H.js";
-import { a as getMutationSlotStore, c as resolveDataRuntimeState, i as getDefaultDataRuntime, n as ensureMutationCleanup, o as getQuerySlotStore, r as ensureQueryCleanup, s as invalidateQueriesForRuntime } from "./data-runtime-SJ1BSUvk.js";
+import { i as routeActive, n as documentVisible, o as timer, s as windowFocused } from "./lifecycle-operations-Db-_MG-O.js";
+import { a as getMutationSlotStore, c as resolveDataRuntimeState, i as getDefaultDataRuntime, n as ensureMutationCleanup, o as getQuerySlotStore, r as ensureQueryCleanup, s as invalidateQueriesForRuntime } from "./data-runtime-rpV6-3XW.js";
 //#region src/data/query-key.ts
 function serializeQueryKeyNumber(part) {
 	if (Number.isNaN(part)) return "NaN";

package/dist/{data-runtime-SJ1BSUvk.js → data-runtime-rpV6-3XW.js}

@@ -1,5 +1,16 @@
 import { n as getActiveRenderContext } from "./render-context-Clw3rFiO.js";
-import { n as emitInvalidation } from "./invalidation-listeners-Des3AHYs.js";
+//#region src/data/invalidation-listeners.ts
+const invalidationListeners = /* @__PURE__ */ new Set();
+function addInvalidationListener(listener) {
+	invalidationListeners.add(listener);
+	return () => {
+		invalidationListeners.delete(listener);
+	};
+}
+function emitInvalidation(event) {
+	for (const listener of invalidationListeners) listener(event);
+}
+//#endregion
 //#region src/data/data-runtime.ts
 const dataRuntimeStates = /* @__PURE__ */ new WeakMap();
 const dataRuntimeByQueryCache = /* @__PURE__ */ new WeakMap();
@@ -110,4 +121,4 @@ function invalidateQueriesForRuntime(runtimeState, prefix, markPendingWrite) {
 	}
 }
 //#endregion
-export { getMutationSlotStore as a, resolveDataRuntimeState as c, getDefaultDataRuntime as i, ensureMutationCleanup as n, getQuerySlotStore as o, ensureQueryCleanup as r, invalidateQueriesForRuntime as s, createDataRuntime as t };
+export { getMutationSlotStore as a, resolveDataRuntimeState as c, getDefaultDataRuntime as i, addInvalidationListener as l, ensureMutationCleanup as n, getQuerySlotStore as o, ensureQueryCleanup as r, invalidateQueriesForRuntime as s, createDataRuntime as t };

package/dist/{deferred-zHtUheIQ.js → deferred-Cr58yIQD.js}

@@ -3,10 +3,9 @@ import { h as readScope, u as defineScope } from "./component-internal-CPjM4n8M.
 import { d as getCurrentAppRenderRuntime } from "./component-scope-CC3cojX9.js";
 import { p as isPromiseLike } from "./lifecycle-batch-COgl8jMS.js";
 import { n as getActiveRenderContext, r as getCurrentRenderData } from "./render-context-Clw3rFiO.js";
-import { t as resource } from "./resource-operation-BJiLoLYZ.js";
-import { i as ROUTE_ROOT_COMPONENT } from "./csp-nonce-HGZ0vbqT.js";
-import { c as withTelemetry, t as createQueryPrefetchContext } from "./query-registry-CQIT4mXr.js";
-import { A as insertRecordSorted, D as getRouteRecords, E as getRouteList, F as snapshotRouteState, N as restoreRouteState, P as setDefaultRouteAuthOptions, T as getDefaultRouteAuthOptions, f as addRouteToStores, h as getActiveRouteAuthOptions, i as getMatchingRouteRecord, m as clearRouteState, o as buildRouteContext, s as buildRouteContextBase } from "./route-matching-DLBWDeXX.js";
+import { A as insertRecordSorted, D as getRouteRecords, E as getRouteList, F as snapshotRouteState, N as restoreRouteState, P as setDefaultRouteAuthOptions, T as getDefaultRouteAuthOptions, f as addRouteToStores, h as getActiveRouteAuthOptions, i as getMatchingRouteRecord, m as clearRouteState, o as buildRouteContext, s as buildRouteContextBase, z as resource } from "./route-matching-M-f1VQRu.js";
+import { i as ROUTE_ROOT_COMPONENT } from "./csp-nonce-CwSRP3Jl.js";
+import { c as withTelemetry, t as createQueryPrefetchContext } from "./query-registry-Bu_cuMch.js";
 //#region src/runtime/execution-model.ts
 const EXECUTION_MODEL_KEY = Symbol.for("__ASKR_EXECUTION_MODEL__");
 function getExecutionModel() {