@askrjs/askr 0.0.92 → 0.0.95

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+- fix(runtime): reject recursive `derive()` and `selector()` reads before a
+  memoized value can bypass the self-evaluation guard.
+- fix(runtime): route scheduled descendant and portal materialization failures
+  to the nearest live `ErrorBoundary` while preserving unbounded propagation.
+
 ## 0.0.85
 
 - breaking(runtime): require Node.js 24.15 or newer.

package/README.md

@@ -92,7 +92,9 @@ Query and mutation helpers live in `@askrjs/askr/data`.
 
 `ErrorBoundary` is the opt-in boundary primitive for render-time failures. It
 renders a visible fallback in development, still logs the underlying error, and
-can reset when your app state changes.
+can reset when your app state changes. The boundary protects both initial mount
+and scheduled post-mount updates. Portal content follows its logical writer
+boundary and can also recover through a boundary around its host.
 
 ```ts
 import { ErrorBoundary } from '@askrjs/askr/components';

package/dist/{access-DSkccuEI.js → access-d_DCdwqn.js}

@@ -432,6 +432,7 @@ function createMissingRendererHost() {
 		markReactivePropsDirtySource() {}
 	};
 }
+/** A scheduler + renderer host pairing; owns scheduling and renderer wiring for an app instance. */
 var AskrRuntime = class {
 	constructor(options = {}) {
 		this.scheduler = options.scheduler ?? globalScheduler;
@@ -445,9 +446,11 @@ var AskrRuntime = class {
 	}
 };
 const defaultRuntime = new AskrRuntime({ scheduler: globalScheduler });
+/** Create a new {@link AskrRuntime} instance with its own scheduler/renderer wiring. */
 function createRuntime(options = {}) {
 	return new AskrRuntime(options);
 }
+/** Get the process-wide default {@link AskrRuntime}. */
 function getDefaultRuntime() {
 	return defaultRuntime;
 }

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-DA3g8lm8.js";
+import { a as action, i as ActionValidationError, n as ActionForm, o as defineAction, r as ActionStatus, t as ActionDescriptor } from "../index-CTIBOqUB.js";
 export { ActionDescriptor, ActionForm, ActionStatus, ActionValidationError, action, defineAction };

package/dist/actions/index.js

@@ -1,8 +1,8 @@
 import { d as getCurrentAppRenderRuntime } from "../component-scope-4I3yEMkb.js";
 import { r as getCurrentRenderData } from "../render-context-B7ohlh6t.js";
-import { t as state } from "../state-XPZYUzHL.js";
+import { t as state } from "../state-DmkGM_LN.js";
 import { jsx, jsxs } from "../jsx-runtime.js";
-import { c as resolveDataRuntimeState, s as invalidateQueriesForRuntime } from "../data-runtime-oIdQWnPW.js";
+import { c as resolveDataRuntimeState, s as invalidateQueriesForRuntime } from "../data-runtime-JxoRgrrt.js";
 //#region src/actions/runtime.ts
 const emptyFramework = Object.freeze({});
 /** @internal Read Askr-owned state from the current application root. */
@@ -15,6 +15,7 @@ function csrfToken() {
 	const value = getCurrentRenderData()?.framework.csrf ?? readActionFramework().csrf;
 	return typeof value === "string" ? value : void 0;
 }
+/** Declare a server action with a stable id, input schema, and query prefixes to invalidate on success. */
 function defineAction(options) {
 	if (!options.id) throw new Error("defineAction requires a stable id.");
 	if (options.input.kind !== "object") throw new Error("defineAction input must be an object schema.");

package/dist/{activity-DxUcygE5.d.ts → activity-D_5x2HXQ.d.ts}

@@ -1,10 +1,14 @@
-import { bt as RouteSnapshot, ot as RouteParams } from "./index-DA3g8lm8.js";
+import { Ct as RouteParams, Lt as RouteSnapshot } from "./index-CTIBOqUB.js";
 //#region src/router/activity.d.ts
+/** Options for {@link onRouteChange}. */
 interface RouteChangeOptions {
   immediate?: boolean;
 }
+/** Optional cleanup returned by an {@link onRouteChange} callback, run before the next change. */
 type RouteChangeCleanup = void | (() => void);
+/** Register a callback to run whenever the active route changes, with optional cleanup. */
 declare function onRouteChange(fn: (current: RouteSnapshot, previous: RouteSnapshot | null) => RouteChangeCleanup, options?: RouteChangeOptions): void;
+/** Read the currently active route's {@link RouteSnapshot}; reactive during component render. */
 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/{activity-DodHdC0L.js → activity-d4t3CdzK.js}

@@ -1,6 +1,6 @@
 import { d as getCurrentAppRenderRuntime, f as getCurrentComponentInstance, i as claimHookIndex } from "./component-scope-4I3yEMkb.js";
-import { a as registerCommitOperation } from "./component-internal-DlAkCgBE.js";
-import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B99wh5Z_.js";
+import { a as registerCommitOperation } from "./component-internal-D0yE2Ch3.js";
+import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-BsdGWsDE.js";
 import { n as getActiveRenderContext } from "./render-context-B7ohlh6t.js";
 import { n as syncRouteActivitySnapshot } from "./route-activity-CNJfpwx-.js";
 import { b as getActiveRoutes, c as removeRouteBasePath, d as deepFreeze, f as makeQuery, n as computeMatchesFromRoutes, p as parseLocation, y as getActiveRouteBasePath } from "./route-matching-Bo6UqG-5.js";
@@ -33,6 +33,7 @@ function routeSignature(route) {
 let currentRouteSnapshot = buildRouteSnapshot("/", "", "");
 const currentRouteSource = (() => currentRouteSnapshot);
 currentRouteSource._readers = /* @__PURE__ */ new Map();
+/** Register a callback to run whenever the active route changes, with optional cleanup. */
 function onRouteChange(fn, options = {}) {
 	const instance = getCurrentComponentInstance();
 	if (!instance) return;
@@ -179,6 +180,7 @@ function readCurrentRouteSnapshot() {
 		matches: Object.freeze(matches)
 	});
 }
+/** Read the currently active route's {@link RouteSnapshot}; reactive during component render. */
 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.");

package/dist/benchmark.d.ts

@@ -1,4 +1,4 @@
-import "./jsx-runtime-C_0v1pMN.js";
+import "./jsx-runtime-BTzDdBJ_.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-DSkccuEI.js";
-import { t as installRendererBridge } from "./renderer-C6jz9nIN.js";
-import { t as state } from "./state-XPZYUzHL.js";
-import { t as selector } from "./selector-BLWwI55m.js";
-import { i as For } from "./control-Dv540XtV.js";
+import { r as flushRuntimeScheduler } from "./access-d_DCdwqn.js";
+import { t as state } from "./state-DmkGM_LN.js";
+import { t as selector } from "./selector-CyK-sDwB.js";
+import { t as installRendererBridge } from "./renderer-tXX_xj86.js";
+import { i as For } from "./control-C0klPV7Q.js";
 import { jsx, jsxs } from "./jsx-runtime.js";
-import { t as createIsland } from "./boot-D71bjP4r.js";
+import { t as createIsland } from "./boot-C1wT3Vfs.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.92",
-	buildLabel: "0.0.92-local"
+	packageVersion: "0.0.95",
+	buildLabel: "0.0.95-local"
 };
 function getBenchmarkMetadata() {
 	return { ...benchmarkMetadata };

package/dist/boot/index.d.ts

@@ -1,7 +1,7 @@
-import { pt as RouteRegistry, q as RouteAuthOptions, wt as ComponentFunction } from "../index-DA3g8lm8.js";
-import { v as DataRuntime } from "../index-2bk8nldG.js";
-import { a as ScrollRestorationOptions } from "../navigate-CZHPEUC4.js";
+import { At as RouteRegistry, nn as ComponentFunction, ut as RouteAuthOptions, zt as DataRuntime } from "../index-CTIBOqUB.js";
+import { a as ScrollRestorationOptions } from "../navigate-eGm4omPj.js";
 //#region src/boot/types.d.ts
+/** Configuration for {@link createIsland}: mounts one component onto existing DOM. */
 type IslandConfig = {
   root: Element | string;
   component: ComponentFunction;
@@ -9,6 +9,7 @@ type IslandConfig = {
   cleanupStrict?: boolean;
   routes?: never;
 };
+/** Configuration for {@link createIslands}: mounts several islands at once. */
 type IslandsConfig = {
   islands: IslandConfig[];
   cspNonce?: string;
@@ -16,6 +17,7 @@ type IslandsConfig = {
 type BootRouteSource = {
   registry: RouteRegistry;
 };
+/** Configuration for {@link createSPA}. */
 type SPAConfig = BootRouteSource & {
   root: Element | string;
   cspNonce?: string;
@@ -27,6 +29,7 @@ type SPAConfig = BootRouteSource & {
   cleanupStrict?: boolean;
   component?: never;
 };
+/** Configuration for {@link hydrateSPA}. */
 type HydrateSPAConfig = BootRouteSource & {
   root: Element | string;
   cspNonce?: string;
@@ -45,7 +48,13 @@ type HydrateSPAConfig = BootRouteSource & {
 };
 //#endregion
 //#region src/boot/root-lifecycle.d.ts
+/**
+ * Tear down the app mounted at `root`: runs its cleanup callbacks, clears
+ * route state if it was the last routed root, and removes bookkeeping for
+ * the root element.
+ */
 declare function cleanupApp(root: Element | string): void;
+/** Check whether an app instance is currently mounted at `root`. */
 declare function hasApp(root: Element | string): boolean;
 //#endregion
 //#region src/boot/index.d.ts

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-D71bjP4r.js";
+import { a as cleanupApp, i as hydrateSPA, n as createIslands, o as hasApp, r as createSPA, t as createIsland } from "../boot-C1wT3Vfs.js";
 export { cleanupApp, createIsland, createIslands, createSPA, hasApp, hydrateSPA };

package/dist/{boot-D71bjP4r.js → boot-C1wT3Vfs.js}

@@ -1,19 +1,19 @@
-import { S as isProductionEnvironment, r as flushRuntimeScheduler, x as isDevelopmentEnvironment, y as logger } from "./access-DSkccuEI.js";
-import { n as Fragment, t as ELEMENT_TYPE } from "./jsx-C3IECePB.js";
-import { n as createComponentInstance, r as executeComponent } from "./component-internal-DlAkCgBE.js";
-import { t as cleanupComponent } from "./component-cleanup-CJCfu5ed.js";
-import { p as isPromiseLike } from "./lifecycle-batch-Cyfd07rf.js";
-import { a as setStaticChildSlotsCacheEnabled, c as endHydrationDirectListenerMode, d as discardHydrationListenerTransaction, i as registerDeferredHydrationBoundary, l as beginHydrationListenerTransaction, n as activateHydrationBoundary$1, o as withIntrinsicHydrationAdoption, r as clearDeferredHydrationBoundaries, s as beginHydrationDirectListenerMode, t as installRendererBridge, u as commitHydrationListenerTransaction } from "./renderer-C6jz9nIN.js";
-import { _ as teardownNodeSubtree, d as removeAllListeners } from "./cleanup-DAAhJjx5.js";
-import { r as assertExecutionModel, t as _applyManifest } from "./manifest-Dv0bO6kg.js";
+import { S as isProductionEnvironment, r as flushRuntimeScheduler, x as isDevelopmentEnvironment, y as logger } from "./access-d_DCdwqn.js";
+import { n as Fragment, t as ELEMENT_TYPE } from "./jsx-DRS-qjiN.js";
+import { n as createComponentInstance, r as executeComponent } from "./component-internal-D0yE2Ch3.js";
+import { t as cleanupComponent } from "./component-cleanup-DYG80yhG.js";
+import { p as isPromiseLike } from "./lifecycle-batch-BH0fax4F.js";
+import { _ as teardownNodeSubtree, d as removeAllListeners } from "./cleanup-D7uN-Z1s.js";
+import { r as assertExecutionModel, t as _applyManifest } from "./manifest-D6rfj_jC.js";
 import { d as stopHydrationRenderPhase, l as startHydrationRenderPhase, y as pageRenderEnvelope } from "./render-context-B7ohlh6t.js";
-import { r as validateCspNonce, t as CspNonceScope } from "./csp-nonce-ByMbWv8s.js";
-import { i as getDefaultDataRuntime } from "./data-runtime-oIdQWnPW.js";
-import { a as hydrateDataRuntime } from "./query-registry-qm13pEdK.js";
+import { a as setStaticChildSlotsCacheEnabled, c as endHydrationDirectListenerMode, d as discardHydrationListenerTransaction, i as registerDeferredHydrationBoundary, l as beginHydrationListenerTransaction, n as activateHydrationBoundary$1, o as withIntrinsicHydrationAdoption, r as clearDeferredHydrationBoundaries, s as beginHydrationDirectListenerMode, t as installRendererBridge, u as commitHydrationListenerTransaction } from "./renderer-tXX_xj86.js";
+import { r as validateCspNonce, t as CspNonceScope } from "./csp-nonce-BVybpV1v.js";
+import { i as getDefaultDataRuntime } from "./data-runtime-JxoRgrrt.js";
+import { a as hydrateDataRuntime } from "./query-registry-CimB1YeW.js";
 import { I as lockRouteRegistration, P as hasRegisteredRoutes, _ as clearRouteState, m as _setActiveRouteAuthOptions } from "./route-matching-Bo6UqG-5.js";
-import { a as resolveRouteRequest, i as hasRouteRenderData, m as reviveDeferredValue, n as getRouteRenderContext, r as getRouteRenderData } from "./resolution-B21kmOkp.js";
-import { o as createAppRenderRuntime, r as setServerLocation } from "./activity-DodHdC0L.js";
-import { f as registerAppInstance, g as unregisterAppInstance, i as resolveRouteMeta, o as configureScrollRestoration, r as reconcileRouteMeta, t as initializeNavigation } from "./navigate-BbWj-QU-.js";
+import { a as resolveRouteRequest, i as hasRouteRenderData, m as reviveDeferredValue, n as getRouteRenderContext, r as getRouteRenderData } from "./resolution-BQyo7qNn.js";
+import { o as createAppRenderRuntime, r as setServerLocation } from "./activity-d4t3CdzK.js";
+import { f as registerAppInstance, g as unregisterAppInstance, i as resolveRouteMeta, o as configureScrollRestoration, r as reconcileRouteMeta, t as initializeNavigation } from "./navigate-DChM5m8m.js";
 import { n as disposeRegisteredDefaultPortalScope, r as getDefaultPortalHost } from "./default-portal-runtime-DvMvWJVp.js";
 import "./ssr-DSHd_Q9K.js";
 //#region src/boot/hydration.ts
@@ -323,6 +323,8 @@ function mountOrUpdate(rootElement, componentFn, options) {
 			instance._lastReadSources = void 0;
 			instance._placeholder = void 0;
 			instance.errorBoundaryState = void 0;
+			instance._portalErrorParent = void 0;
+			instance._portalErrorParentGeneration = void 0;
 			instance.devWarningsEmitted = void 0;
 		}
 		if (options && typeof options.cleanupStrict === "boolean") instance.cleanupStrict = options.cleanupStrict;
@@ -358,6 +360,11 @@ async function registerAppNavigation(rootElement, path, source) {
 	registerAppInstance(instance, path, source);
 	initializeNavigation();
 }
+/**
+* Tear down the app mounted at `root`: runs its cleanup callbacks, clears
+* route state if it was the last routed root, and removes bookkeeping for
+* the root element.
+*/
 function cleanupApp(root) {
 	const rootElement = resolveRootElement(root);
 	if (!rootElement) return;
@@ -374,6 +381,7 @@ function cleanupApp(root) {
 		} catch {}
 	}
 }
+/** Check whether an app instance is currently mounted at `root`. */
 function hasApp(root) {
 	const rootElement = resolveRootElement(root);
 	if (!rootElement) return false;
@@ -604,7 +612,7 @@ async function hydrateSPA(config) {
 		cspNonce: config.cspNonce
 	}));
 	if (shouldVerifyHydrationMarkup(config)) {
-		const { verifyHydrationSyncForUrl } = await import("./verify-hydration-CcF-HJil.js");
+		const { verifyHydrationSyncForUrl } = await import("./verify-hydration-m-wVbYOD.js");
 		if (!verifyHydrationSyncForUrl({
 			root: rootElement,
 			url: currentUrl,

package/dist/{cleanup-DAAhJjx5.js → cleanup-D7uN-Z1s.js}

@@ -1,8 +1,8 @@
-import { l as runRuntimeHandlerScope, y as logger } from "./access-DSkccuEI.js";
-import "./fastlane-B2s24fWt.js";
+import { l as runRuntimeHandlerScope, y as logger } from "./access-d_DCdwqn.js";
+import "./fastlane-DGo7SxBQ.js";
 import { T as withAppRenderRuntime, d as getCurrentAppRenderRuntime } from "./component-scope-4I3yEMkb.js";
-import { t as cleanupComponent } from "./component-cleanup-CJCfu5ed.js";
-import { u as registerLifecycleTransaction } from "./lifecycle-batch-Cyfd07rf.js";
+import { t as cleanupComponent } from "./component-cleanup-DYG80yhG.js";
+import { u as registerLifecycleTransaction } from "./lifecycle-batch-BH0fax4F.js";
 //#region src/runtime/events.ts
 /**
 * Event delegation system for Askr

package/dist/{component-cleanup-CJCfu5ed.js → component-cleanup-DYG80yhG.js}

@@ -1,6 +1,6 @@
-import { S as isProductionEnvironment, x as isDevelopmentEnvironment, y as logger } from "./access-DSkccuEI.js";
+import { S as isProductionEnvironment, x as isDevelopmentEnvironment, y as logger } from "./access-d_DCdwqn.js";
 import { a as clearCurrentComponentScope, y as restoreCurrentComponentScope } from "./component-scope-4I3yEMkb.js";
-import { n as cleanupReadableSubscriptions, t as cleanupReadableSubscriptionSources } from "./readable-B99wh5Z_.js";
+import { n as cleanupReadableSubscriptions, t as cleanupReadableSubscriptionSources } from "./readable-BsdGWsDE.js";
 //#region src/runtime/state-diagnostics.ts
 /**
 * Report state cells that were never read during a component's completed
@@ -124,6 +124,8 @@ function cleanupComponent(instance) {
 		instance.lifecycleSlots = void 0;
 		instance.hasPendingUpdate = false;
 		instance.notifyUpdate = null;
+		instance._portalErrorParent = void 0;
+		instance._portalErrorParentGeneration = void 0;
 		instance._placeholder = void 0;
 		instance.mounted = false;
 		if (cleanupErrors && cleanupErrors.length > 0) throw new AggregateError(cleanupErrors, `Cleanup failed for component ${instance.id}`);

package/dist/{component-internal-DlAkCgBE.js → component-internal-D0yE2Ch3.js}

@@ -1,10 +1,10 @@
 import { a as markTransparentComponentResult, i as markEagerControlPrimitive } from "./control-C-ApnFs1.js";
-import { S as isProductionEnvironment, n as enqueueRuntimeTask, o as getRuntimeRenderer, x as isDevelopmentEnvironment, y as logger } from "./access-DSkccuEI.js";
-import { i as tryRuntimeFastLaneSync, n as isBulkCommitActive } from "./fastlane-B2s24fWt.js";
+import { S as isProductionEnvironment, n as enqueueRuntimeTask, o as getRuntimeRenderer, x as isDevelopmentEnvironment, y as logger } from "./access-d_DCdwqn.js";
+import { i as tryRuntimeFastLaneSync, n as isBulkCommitActive } from "./fastlane-DGo7SxBQ.js";
 import { C as restoreRenderScopedComponent, S as restoreInlineRenderTracking, _ as getSignalForInstance, b as restoreDomCommitScope, c as enterDomCommitScope, f as getCurrentComponentInstance, l as enterRenderScopedComponent, m as getCurrentPortalScope, n as captureInlineComponentScope, o as clearRenderTracking, p as getCurrentInstance, r as captureInlineRenderTracking, s as enterComponentExecutionScope, t as beginRenderTracking, u as exitComponentExecutionScope, v as resetRenderState, x as restoreInlineComponentScope } from "./component-scope-4I3yEMkb.js";
-import { r as STATIC_CHILDREN, t as ELEMENT_TYPE } from "./jsx-C3IECePB.js";
-import { i as finalizeReadableSubscriptions } from "./readable-B99wh5Z_.js";
-import { a as enqueueLifecycleCommitForInstance, d as discardCommitOperations, f as executeCommittedLifecycleOperations, n as captureInlineRenderSnapshot$1, o as finalizeInlineReadSubscriptions, p as isPromiseLike, r as discardLifecycleCommitBatch, s as flushLifecycleCommitBatch, t as beginLifecycleCommitBatch } from "./lifecycle-batch-Cyfd07rf.js";
+import { r as STATIC_CHILDREN, t as ELEMENT_TYPE } from "./jsx-DRS-qjiN.js";
+import { i as finalizeReadableSubscriptions } from "./readable-BsdGWsDE.js";
+import { a as enqueueLifecycleCommitForInstance, d as discardCommitOperations, f as executeCommittedLifecycleOperations, n as captureInlineRenderSnapshot$1, o as finalizeInlineReadSubscriptions, p as isPromiseLike, r as discardLifecycleCommitBatch, s as flushLifecycleCommitBatch, t as beginLifecycleCommitBatch } from "./lifecycle-batch-BH0fax4F.js";
 //#region src/runtime/context.ts
 const TransparentContextScopeComponent = markTransparentComponentResult(ContextScopeComponent);
 let nextScopeIdentityKey = 0;
@@ -211,6 +211,7 @@ function withAsyncResourceContext(frame, fn) {
 		currentAsyncResourceFrame = oldFrame;
 	}
 }
+/** Create a new lexical {@link Scope} with `defaultValue`, readable via {@link readScope}. */
 function defineScope(defaultValue) {
 	const key = Symbol("AskrContext");
 	const identityKey = nextScopeIdentityKey++;
@@ -241,6 +242,7 @@ function preserveStaticChildrenMarker(source, target) {
 function isPresentRenderable(value) {
 	return value !== null && value !== void 0 && value !== false;
 }
+/** Read the current value of a {@link Scope} during component render or an async resource. */
 function readScope(context) {
 	const frame = currentContextFrame || currentAsyncResourceFrame;
 	if (!frame) throw new Error("readScope() can only be called during component render or async resource execution. Ensure you are calling this from inside your component or resource function.");
@@ -364,6 +366,57 @@ function commitRenderedComponent$1(instance) {
 	if (instance.mounted && (instance.commitOperations?.length ?? 0) > 0) commitLifecycleForInstance(instance, false);
 }
 //#endregion
+//#region src/runtime/error-boundary.ts
+function createBoundaryReset(instance) {
+	return () => {
+		const boundaryState = instance.errorBoundaryState;
+		if (!boundaryState) return;
+		boundaryState.error = null;
+		boundaryState.notified = false;
+		queueMicrotask(() => {
+			instance._enqueueRun?.();
+		});
+	};
+}
+function reportBoundaryError(instance, error, onError) {
+	const boundaryState = instance.errorBoundaryState;
+	if (boundaryState && Object.is(boundaryState.error, error) && boundaryState.notified) return;
+	if (boundaryState) {
+		boundaryState.error = error;
+		boundaryState.notified = true;
+	}
+	try {
+		onError?.(error);
+	} catch (hookError) {
+		logger.error("[Askr] ErrorBoundary onError handler threw:", hookError);
+	}
+	logger.error("[Askr] ErrorBoundary caught render error:", error);
+}
+function getLivePortalErrorParent(instance) {
+	const parent = instance._portalErrorParent;
+	if (!parent || parent._ownershipGeneration !== instance._portalErrorParentGeneration || parent.notifyUpdate === null) return null;
+	return parent;
+}
+function findLiveErrorBoundary(failedInstance) {
+	const visited = /* @__PURE__ */ new Set([failedInstance]);
+	const visit = (instance) => {
+		if (!instance || visited.has(instance)) return null;
+		visited.add(instance);
+		if (instance.errorBoundaryState && instance.notifyUpdate !== null) return instance;
+		return visit(getLivePortalErrorParent(instance)) ?? visit(instance.parentInstance);
+	};
+	return visit(getLivePortalErrorParent(failedInstance)) ?? visit(failedInstance.parentInstance);
+}
+/** Route a scheduled component failure to its nearest live render boundary. */
+function routeComponentErrorToBoundary(failedInstance, error) {
+	const boundary = findLiveErrorBoundary(failedInstance);
+	if (!boundary) return false;
+	const onError = boundary.props.onError;
+	reportBoundaryError(boundary, error, typeof onError === "function" ? onError : void 0);
+	boundary._enqueueRun?.();
+	return true;
+}
+//#endregion
 //#region src/runtime/component-commit.ts
 function runScheduledComponent(instance, host) {
 	const ownershipGeneration = instance._ownershipGeneration;
@@ -375,21 +428,32 @@ function runScheduledComponent(instance, host) {
 		result = host.execute(instance);
 	} catch (err) {
 		discardCommitOperations(instance);
+		if (routeComponentErrorToBoundary(instance, err)) return;
 		throw err;
 	}
-	if (isPromiseLike(result)) throw new Error("Async components are not supported. Components must be synchronous.");
+	if (isPromiseLike(result)) {
+		const error = /* @__PURE__ */ new Error("Async components are not supported. Components must be synchronous.");
+		discardCommitOperations(instance);
+		if (routeComponentErrorToBoundary(instance, error)) return;
+		throw error;
+	}
 	try {
 		if (tryRuntimeFastLaneSync(instance, result)) return;
 	} catch (err) {
+		if (routeComponentErrorToBoundary(instance, err)) return;
 		if (isDevelopmentEnvironment()) throw err;
 	}
 	enqueueRuntimeTask(() => {
-		if (instance._ownershipGeneration !== ownershipGeneration || instance.evaluationGeneration !== evaluationGeneration) return;
-		if (!instance.target && instance._placeholder) {
-			commitPlaceholderReplacement(instance, result, host);
-			return;
+		try {
+			if (instance._ownershipGeneration !== ownershipGeneration || instance.evaluationGeneration !== evaluationGeneration) return;
+			if (!instance.target && instance._placeholder) {
+				commitPlaceholderReplacement(instance, result, host);
+				return;
+			}
+			if (instance.target) commitToTarget(instance, result, host);
+		} catch (err) {
+			if (!routeComponentErrorToBoundary(instance, err)) throw err;
 		}
-		if (instance.target) commitToTarget(instance, result, host);
 	});
 }
 function commitPlaceholderReplacement(instance, result, host) {
@@ -602,7 +666,9 @@ function createComponentInstance(id, fn, props, target) {
 		_pendingReadSources: void 0,
 		_pendingReadSourceVersions: void 0,
 		_lastReadSources: void 0,
-		devWarningsEmitted: void 0
+		devWarningsEmitted: void 0,
+		_portalErrorParent: void 0,
+		_portalErrorParentGeneration: void 0
 	};
 	instance._enqueueRun = enqueueComponentRun;
 	return instance;
@@ -737,4 +803,4 @@ function warnInstanceOnce(instance, key, message) {
 	logger.warn(message);
 }
 //#endregion
-export { readScope as _, registerCommitOperation as a, withContext as b, registerCommitOperationForInstance as c, defineScope as d, getCurrentContextFrame as f, markVNodeTreeWithContextFrame as g, haveEquivalentContextFrames as h, mountInstanceInline as i, configureRenderDiagnostics as l, getVNodeContextFrame as m, createComponentInstance as n, renderComponentInline as o, getExecutionContextFrame as p, executeComponent as r, renderScopedComponent as s, captureInlineRenderSnapshot as t, callWithContext as u, rebaseVNodeTreeWithContextFrame as v, withAsyncResourceContext as y };
+export { withContext as S, haveEquivalentContextFrames as _, registerCommitOperation as a, rebaseVNodeTreeWithContextFrame as b, createBoundaryReset as c, configureRenderDiagnostics as d, callWithContext as f, getVNodeContextFrame as g, getExecutionContextFrame as h, mountInstanceInline as i, reportBoundaryError as l, getCurrentContextFrame as m, createComponentInstance as n, renderComponentInline as o, defineScope as p, executeComponent as r, renderScopedComponent as s, captureInlineRenderSnapshot as t, registerCommitOperationForInstance as u, markVNodeTreeWithContextFrame as v, withAsyncResourceContext as x, readScope as y };

package/dist/components/index.d.ts

@@ -1,18 +1,26 @@
-import { Et as VNode } from "../index-DA3g8lm8.js";
-import { r as JSXElement, s as Props } from "../types-BA9FJtfR.js";
+import { in as VNode } from "../index-CTIBOqUB.js";
+import { r as JSXElement, s as Props } from "../types-DkVJhVs9.js";
 //#region src/common/error-boundary.d.ts
 type ErrorBoundaryContent = VNode | readonly VNode[];
 type ErrorBoundaryFallbackValue = ErrorBoundaryContent | Node;
+/** Renders a fallback for the caught error; call `reset` to retry the children. */
 type ErrorBoundaryFallbackRender = (error: unknown, reset: () => void) => ErrorBoundaryFallbackValue;
+/** Props for {@link ErrorBoundary}. */
 interface ErrorBoundaryProps extends Props {
   children?: ErrorBoundaryContent;
+  /** Static fallback content, or a render function receiving the error and a reset callback. */
   fallback?: ErrorBoundaryFallbackValue | ErrorBoundaryFallbackRender;
+  /** Called with the caught error when the boundary trips. */
   onError?: (error: unknown) => void;
+  /** Changing this value resets the boundary, re-rendering the children. */
   resetKey?: unknown;
 }
 //#endregion
 //#region src/components/error-boundary.d.ts
-/** Creates a render-time boundary whose fallback handles descendant render/commit errors. */
+/**
+ * Creates a boundary for descendant mount and post-mount render/commit errors,
+ * including content materialized through a portal host.
+ */
 declare function ErrorBoundary(props: ErrorBoundaryProps): JSXElement;
 //#endregion
 export { ErrorBoundary, type ErrorBoundaryFallbackRender, type ErrorBoundaryProps };

package/dist/components/index.js

@@ -1,6 +1,6 @@
 import { t as __ERROR_BOUNDARY__ } from "../vnode-D24p6IW2.js";
 import { f as getCurrentComponentInstance } from "../component-scope-4I3yEMkb.js";
-import { t as ELEMENT_TYPE } from "../jsx-C3IECePB.js";
+import { t as ELEMENT_TYPE } from "../jsx-DRS-qjiN.js";
 //#region src/components/error-boundary.tsx
 function ensureBoundaryState(instance, resetKey) {
 	const boundaryState = instance.errorBoundaryState ?? (instance.errorBoundaryState = {
@@ -30,7 +30,10 @@ function createBoundaryVNode(instance, props) {
 		__instance: instance
 	};
 }
-/** Creates a render-time boundary whose fallback handles descendant render/commit errors. */
+/**
+* Creates a boundary for descendant mount and post-mount render/commit errors,
+* including content materialized through a portal host.
+*/
 function ErrorBoundary(props) {
 	const instance = getCurrentComponentInstance();
 	if (!instance) throw new Error("[Askr] ErrorBoundary() can only be used during component render execution.");

package/dist/{compose-ref-Cc_YkUpM.js → compose-ref-1Fhs7mbF.js}

@@ -2,6 +2,10 @@
 function isDefaultPrevented(value) {
 	return typeof value === "object" && value !== null && "defaultPrevented" in value && value.defaultPrevented === true;
 }
+/**
+* Compose two optional event handlers into one, running `first` then
+* `second` unless `first` marked the event as default-prevented.
+*/
 function composeHandlers(first, second, options) {
 	if (!first && !second) return noop;
 	if (!first) return second;
@@ -44,6 +48,10 @@ function noop() {}
 function isEventHandlerKey(key) {
 	return key.startsWith("on");
 }
+/**
+* Merge `base` props over `injected` props: non-handler keys in `base` win,
+* and matching event handlers are composed (`injected` runs first).
+*/
 function mergeProps(base, injected) {
 	const baseKeys = Object.keys(base);
 	if (baseKeys.length === 0) return injected;
@@ -64,17 +72,21 @@ function mergeProps(base, injected) {
 /**
 * Tiny aria helpers
 */
+/** Build an `aria-disabled` prop object; omitted entirely when `disabled` is falsy. */
 function ariaDisabled(disabled) {
 	return disabled ? { "aria-disabled": "true" } : {};
 }
+/** Build an `aria-expanded` prop object; omitted when `expanded` is `undefined`. */
 function ariaExpanded(expanded) {
 	return expanded === void 0 ? {} : { "aria-expanded": String(expanded) };
 }
+/** Build an `aria-selected` prop object; omitted when `selected` is `undefined`. */
 function ariaSelected(selected) {
 	return selected === void 0 ? {} : { "aria-selected": String(selected) };
 }
 //#endregion
 //#region src/foundations/utilities/compose-ref.ts
+/** Write `value` to a {@link Ref}, ignoring failures on readonly object refs. */
 function setRef(ref, value) {
 	if (!ref) return;
 	if (typeof ref === "function") {
@@ -83,6 +95,7 @@ function setRef(ref, value) {
 	}
 	if (Object.isExtensible(ref)) ref.current = value;
 }
+/** Combine multiple refs into one callback ref that writes to all of them. */
 function composeRefs(...refs) {
 	return (value) => {
 		for (const ref of refs) setRef(ref, value);

package/dist/{compose-ref-Cizq72-x.d.ts → compose-ref-DOJHoW5X.d.ts}

@@ -17,10 +17,13 @@
  *    composeRefs applies refs in array order (left to right).
  *    All refs are called even if one fails.
  */
+/** A callback ref, an object ref, or a nullish value (no-op). */
 type Ref<T> = ((value: T | null) => void) | {
   current: T | null;
 } | null | undefined;
+/** Write `value` to a {@link Ref}, ignoring failures on readonly object refs. */
 declare function setRef<T>(ref: Ref<T>, value: T | null): void;
+/** Combine multiple refs into one callback ref that writes to all of them. */
 declare function composeRefs<T>(...refs: Array<Ref<T>>): (value: T | null) => void;
 //#endregion
 export { composeRefs as n, setRef as r, Ref as t };

package/dist/control/index.d.ts

@@ -1,2 +1,2 @@
-import { _ as MatchProps, b as For, g as Match, h as CaseProps, m as Case, v as Show, x as ForProps, y as ShowProps } from "../index-DA3g8lm8.js";
+import { A as Case, F as ShowProps, I as For, L as ForProps, M as Match, N as MatchProps, P as Show, j as CaseProps } from "../index-CTIBOqUB.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-Dv540XtV.js";
+import { i as For, n as Match, r as Show, t as Case } from "../control-C0klPV7Q.js";
 export { Case, For, Match, Show };

package/dist/{control-Dv540XtV.js → control-C0klPV7Q.js}

@@ -1,9 +1,9 @@
 import { i as markEagerControlPrimitive, t as __CONTROL_BOUNDARY__ } from "./control-C-ApnFs1.js";
-import { x as isDevelopmentEnvironment } from "./access-DSkccuEI.js";
-import { n as Fragment } from "./jsx-C3IECePB.js";
-import { m as createShowState, p as createCaseState, s as useForState } from "./for-internal-T1C7jd7x.js";
-import { t as createFineGrainedEffect } from "./effect-BdZcHblj.js";
-import { t as state } from "./state-XPZYUzHL.js";
+import { x as isDevelopmentEnvironment } from "./access-d_DCdwqn.js";
+import { n as Fragment } from "./jsx-DRS-qjiN.js";
+import { m as createShowState, p as createCaseState, s as useForState } from "./for-internal-DkBwTG4S.js";
+import { t as createFineGrainedEffect } from "./effect-BdvdgMvV.js";
+import { t as state } from "./state-DmkGM_LN.js";
 //#region src/control/shared.ts
 function normalizeBoundaryChild(value) {
 	if (Array.isArray(value)) {
@@ -77,6 +77,7 @@ function createForBoundary(props) {
 function ForPrimitive(props) {
 	return createForBoundary(props);
 }
+/** Render a keyed or indexed list, reconciling items by key instead of position. */
 const For = markEagerControlPrimitive(ForPrimitive);
 //#endregion
 //#region src/control/show.ts
@@ -103,6 +104,7 @@ function ShowPrimitive(props) {
 		_controlState: showState
 	};
 }
+/** Conditionally render children based on `when`, narrowing truthy values for the render function form. */
 const Show = markEagerControlPrimitive(ShowPrimitive);
 //#endregion
 //#region src/control/case.ts
@@ -118,6 +120,7 @@ function flattenChildren(children) {
 	}
 	return result;
 }
+/** Declares one branch of a {@link Case}; only valid as its direct child. */
 function Match(_props) {
 	if (isDevelopmentEnvironment()) throw new Error("[askr] <Match> may only be used as a direct child of <Case>.");
 	return null;
@@ -164,6 +167,7 @@ function CasePrimitive(props) {
 		_controlState: caseState
 	};
 }
+/** Render the first matching {@link Match} child (by `when`), or `fallback` if none match. */
 const Case = markEagerControlPrimitive(CasePrimitive);
 //#endregion
 export { For as i, Match as n, Show as r, Case as t };