@askrjs/askr 0.0.91 → 0.0.94

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## Unreleased
 
+- fix(runtime): reject recursive `derive()` and `selector()` reads before a
+  memoized value can bypass the self-evaluation guard.
+
 ## 0.0.85
 
 - breaking(runtime): require Node.js 24.15 or newer.

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

@@ -1,4 +1,4 @@
-import { a as clearCurrentComponentScope, y as restoreCurrentComponentScope } from "./component-scope-DzJEbYGE.js";
+import { a as clearCurrentComponentScope, y as restoreCurrentComponentScope } from "./component-scope-4I3yEMkb.js";
 //#region src/common/env.ts
 function normalizeEnv(source) {
 	if (!source) return {};
@@ -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;
 }
@@ -482,6 +485,9 @@ function runRuntimeHandlerScope(fn, flushMode = "defer") {
 function runRuntimeWithSyncProgress(fn) {
 	return getRuntimeScheduler().runWithSyncProgress(fn);
 }
+function isRuntimeSchedulerExecuting() {
+	return getRuntimeScheduler().isExecuting();
+}
 function getRuntimeFlushVersion() {
 	return getRuntimeScheduler().getFlushVersion();
 }
@@ -495,4 +501,4 @@ function markRuntimeReactivePropsDirtySource(source) {
 	getRuntimeRenderer().markReactivePropsDirtySource(source);
 }
 //#endregion
-export { incrementPerfMetric as _, getRuntimeFlushVersion as a, isDevelopmentEnvironment as b, runRuntimeHandlerScope as c, AskrRuntime as d, configureRuntimeRenderer as f, addPerfDuration as g, scheduleEventHandler as h, getDefaultRuntimeInstance as i, runRuntimeWithSyncProgress as l, getDefaultRuntime as m, enqueueRuntimeTask as n, getRuntimeRenderer as o, createRuntime as p, flushRuntimeScheduler as r, markRuntimeReactivePropsDirtySource as s, enqueueRuntimeLane as t, setRuntimeBulkCommitProbe as u, logger as v, isProductionEnvironment as x, getRuntimeEnv as y };
+export { isProductionEnvironment as S, addPerfDuration as _, getRuntimeFlushVersion as a, getRuntimeEnv as b, markRuntimeReactivePropsDirtySource as c, setRuntimeBulkCommitProbe as d, AskrRuntime as f, scheduleEventHandler as g, getDefaultRuntime as h, getDefaultRuntimeInstance as i, runRuntimeHandlerScope as l, createRuntime as m, enqueueRuntimeTask as n, getRuntimeRenderer as o, configureRuntimeRenderer as p, flushRuntimeScheduler as r, isRuntimeSchedulerExecuting as s, enqueueRuntimeLane as t, runRuntimeWithSyncProgress as u, incrementPerfMetric as v, isDevelopmentEnvironment as x, logger as y };

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

package/dist/actions/index.js

@@ -1,8 +1,8 @@
-import { d as getCurrentAppRenderRuntime } from "../component-scope-DzJEbYGE.js";
+import { d as getCurrentAppRenderRuntime } from "../component-scope-4I3yEMkb.js";
 import { r as getCurrentRenderData } from "../render-context-B7ohlh6t.js";
-import { t as state } from "../state-DCjONcHK.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-wbooGyu7.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-dKH6nlpj.js → activity-BshyLB3_.js}

@@ -1,9 +1,9 @@
-import { d as getCurrentAppRenderRuntime, f as getCurrentComponentInstance, i as claimHookIndex } from "./component-scope-DzJEbYGE.js";
-import { a as registerCommitOperation } from "./component-internal-C4uwwUaK.js";
-import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B5NtV7V0.js";
+import { d as getCurrentAppRenderRuntime, f as getCurrentComponentInstance, i as claimHookIndex } from "./component-scope-4I3yEMkb.js";
+import { a as registerCommitOperation } from "./component-internal-DOVVMjG7.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-xlgdQXg_.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";
 //#region src/common/app-render-runtime.ts
 const stagedRouteLocations = /* @__PURE__ */ new WeakMap();
 function createAppRenderRuntime(input = {}) {
@@ -11,7 +11,9 @@ function createAppRenderRuntime(input = {}) {
 		framework: Object.freeze({ ...input.framework }),
 		route: input.route,
 		hasRoute: input.hasRoute ?? false,
-		dataRuntime: input.dataRuntime
+		dataRuntime: input.dataRuntime,
+		routeRegistry: input.routeRegistry,
+		routeAuth: input.routeAuth
 	};
 }
 function stageAppRenderRouteLocation(runtime, href) {
@@ -31,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;
@@ -177,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/{activity-CF2_JvJs.d.ts → activity-CJIQyo5X.d.ts}

@@ -1,10 +1,14 @@
-import { L as RouteParams, Z as RouteSnapshot } from "./index-Izwp_ESC.js";
+import { Ct as RouteParams, Lt as RouteSnapshot } from "./index-KQ7Vl4-8.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/benchmark.d.ts

@@ -1,4 +1,4 @@
-import "./jsx-runtime-BqhMEuT4.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-Dpfoi4cA.js";
-import { t as installRendererBridge } from "./renderer-y2DL627q.js";
-import { t as state } from "./state-DCjONcHK.js";
-import { t as selector } from "./selector-BLNkRZ2i.js";
-import { i as For } from "./control-CON10J1p.js";
+import { r as flushRuntimeScheduler } from "./access-d_DCdwqn.js";
+import { t as installRendererBridge } from "./renderer-CLvq458M.js";
+import { t as state } from "./state-DmkGM_LN.js";
+import { t as selector } from "./selector-CyK-sDwB.js";
+import { i as For } from "./control-DqOzkgc7.js";
 import { jsx, jsxs } from "./jsx-runtime.js";
-import { t as createIsland } from "./boot-D3zVVWuN.js";
+import { t as createIsland } from "./boot-BsMB_ySP.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.91",
-	buildLabel: "0.0.91-local"
+	packageVersion: "0.0.94",
+	buildLabel: "0.0.94-local"
 };
 function getBenchmarkMetadata() {
 	return { ...benchmarkMetadata };

package/dist/boot/index.d.ts

@@ -1,8 +1,7 @@
-import { l as ComponentFunction } from "../control-D-FIa-n-.js";
-import { t as DataRuntime } from "../types-iAmDSV6o.js";
-import { W as RouteRegistry, w as RouteAuthOptions } from "../index-Izwp_ESC.js";
-import { a as ScrollRestorationOptions } from "../navigate-BO7M2iUG.js";
+import { At as RouteRegistry, nn as ComponentFunction, ut as RouteAuthOptions, zt as DataRuntime } from "../index-KQ7Vl4-8.js";
+import { a as ScrollRestorationOptions } from "../navigate-BL_FIIJ6.js";
 //#region src/boot/types.d.ts
+/** Configuration for {@link createIsland}: mounts one component onto existing DOM. */
 type IslandConfig = {
   root: Element | string;
   component: ComponentFunction;
@@ -10,6 +9,7 @@ type IslandConfig = {
   cleanupStrict?: boolean;
   routes?: never;
 };
+/** Configuration for {@link createIslands}: mounts several islands at once. */
 type IslandsConfig = {
   islands: IslandConfig[];
   cspNonce?: string;
@@ -17,6 +17,7 @@ type IslandsConfig = {
 type BootRouteSource = {
   registry: RouteRegistry;
 };
+/** Configuration for {@link createSPA}. */
 type SPAConfig = BootRouteSource & {
   root: Element | string;
   cspNonce?: string;
@@ -28,6 +29,7 @@ type SPAConfig = BootRouteSource & {
   cleanupStrict?: boolean;
   component?: never;
 };
+/** Configuration for {@link hydrateSPA}. */
 type HydrateSPAConfig = BootRouteSource & {
   root: Element | string;
   cspNonce?: string;
@@ -46,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-D3zVVWuN.js";
+import { a as cleanupApp, i as hydrateSPA, n as createIslands, o as hasApp, r as createSPA, t as createIsland } from "../boot-BsMB_ySP.js";
 export { cleanupApp, createIsland, createIslands, createSPA, hasApp, hydrateSPA };

package/dist/{boot-D3zVVWuN.js → boot-BsMB_ySP.js}

@@ -1,19 +1,19 @@
-import { b as isDevelopmentEnvironment, r as flushRuntimeScheduler, v as logger, x as isProductionEnvironment } from "./access-Dpfoi4cA.js";
-import { n as Fragment, t as ELEMENT_TYPE } from "./jsx-C3IECePB.js";
-import { n as createComponentInstance, r as executeComponent } from "./component-internal-C4uwwUaK.js";
-import { t as cleanupComponent } from "./component-cleanup-BUfUleGZ.js";
-import { p as isPromiseLike } from "./lifecycle-batch-Dfpid9-A.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-y2DL627q.js";
-import { _ as teardownNodeSubtree, d as removeAllListeners } from "./cleanup-c837KVij.js";
-import { r as assertExecutionModel, t as _applyManifest } from "./manifest-fBb2ynKL.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-DOVVMjG7.js";
+import { t as cleanupComponent } from "./component-cleanup-hrqSikl2.js";
+import { p as isPromiseLike } from "./lifecycle-batch-BH0fax4F.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-CLvq458M.js";
+import { _ as teardownNodeSubtree, d as removeAllListeners } from "./cleanup-DefafSjG.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-DH0TrDij.js";
-import { i as getDefaultDataRuntime } from "./data-runtime-wbooGyu7.js";
-import { a as hydrateDataRuntime } from "./query-registry-B4LpVtlT.js";
-import { I as lockRouteRegistration, P as hasRegisteredRoutes, _ as clearRouteState, m as _setActiveRouteAuthOptions } from "./route-matching-xlgdQXg_.js";
-import { a as resolveRouteRequest, i as hasRouteRenderData, m as reviveDeferredValue, n as getRouteRenderContext, r as getRouteRenderData } from "./resolution-C9A31xQi.js";
-import { o as createAppRenderRuntime, r as setServerLocation } from "./activity-dKH6nlpj.js";
-import { f as registerAppInstance, g as unregisterAppInstance, i as resolveRouteMeta, o as configureScrollRestoration, r as reconcileRouteMeta, t as initializeNavigation } from "./navigate-CnQMXze1.js";
+import { r as validateCspNonce, t as CspNonceScope } from "./csp-nonce-BBxq1zq4.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-D8PgnTzh.js";
+import { o as createAppRenderRuntime, r as setServerLocation } from "./activity-BshyLB3_.js";
+import { f as registerAppInstance, g as unregisterAppInstance, i as resolveRouteMeta, o as configureScrollRestoration, r as reconcileRouteMeta, t as initializeNavigation } from "./navigate-CECCMPAr.js";
 import { n as disposeRegisteredDefaultPortalScope, r as getDefaultPortalHost } from "./default-portal-runtime-DvMvWJVp.js";
 import "./ssr-DSHd_Q9K.js";
 //#region src/boot/hydration.ts
@@ -358,6 +358,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 +379,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;
@@ -497,11 +503,15 @@ async function createSPA(config) {
 	if (isProductionEnvironment()) lockRouteRegistration();
 	const { path, href: currentUrl, resolved } = await resolveInitialRoute(routeAuth, { registry: config.registry });
 	setServerLocation(currentUrl);
-	const appRuntime = createAppRenderRuntime(resolved?.kind === "render" && hasRouteRenderData(resolved) ? {
-		route: getRouteRenderData(resolved),
-		hasRoute: true,
-		dataRuntime: config.dataRuntime ?? getDefaultDataRuntime()
-	} : { dataRuntime: config.dataRuntime ?? getDefaultDataRuntime() });
+	const appRuntime = createAppRenderRuntime({
+		...resolved?.kind === "render" && hasRouteRenderData(resolved) ? {
+			route: getRouteRenderData(resolved),
+			hasRoute: true
+		} : {},
+		dataRuntime: config.dataRuntime ?? getDefaultDataRuntime(),
+		routeRegistry: config.registry,
+		routeAuth
+	});
 	if (!resolved) {
 		mountOrUpdate(rootElement, () => ({
 			type: "div",
@@ -573,7 +583,9 @@ async function hydrateSPA(config) {
 		runtime: createAppRenderRuntime({
 			framework: hydrationRenderData?.framework,
 			route: hydrationRenderData?.route,
-			hasRoute: hydrationRenderData !== null
+			hasRoute: hydrationRenderData !== null,
+			routeRegistry: config.registry,
+			routeAuth
 		})
 	};
 	_setActiveRouteAuthOptions(routeAuth);
@@ -598,7 +610,7 @@ async function hydrateSPA(config) {
 		cspNonce: config.cspNonce
 	}));
 	if (shouldVerifyHydrationMarkup(config)) {
-		const { verifyHydrationSyncForUrl } = await import("./verify-hydration-D8938Fw2.js");
+		const { verifyHydrationSyncForUrl } = await import("./verify-hydration-jf8X2V3x.js");
 		if (!verifyHydrationSyncForUrl({
 			root: rootElement,
 			url: currentUrl,

package/dist/{cleanup-c837KVij.js → cleanup-DefafSjG.js}

@@ -1,7 +1,8 @@
-import { c as runRuntimeHandlerScope, v as logger } from "./access-Dpfoi4cA.js";
-import "./fastlane-CrfB3QG0.js";
-import { t as cleanupComponent } from "./component-cleanup-BUfUleGZ.js";
-import { u as registerLifecycleTransaction } from "./lifecycle-batch-Dfpid9-A.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-hrqSikl2.js";
+import { u as registerLifecycleTransaction } from "./lifecycle-batch-BH0fax4F.js";
 //#region src/runtime/events.ts
 /**
 * Event delegation system for Askr
@@ -141,7 +142,7 @@ function attachDelegatedListener(container, element, eventName, handler, origina
 				if (eventName === "focus" || eventName === "blur" || eventName === "scroll") dispatchPath.reverse();
 				for (const { node, entry } of dispatchPath) {
 					try {
-						entry.handler(createDelegatedEventFacade(e, node));
+						withAppRenderRuntime(entry.appRuntime, () => entry.handler(createDelegatedEventFacade(e, node)));
 					} catch (error) {
 						logger.error("[Askr] Delegated event error:", error);
 					}
@@ -164,6 +165,7 @@ function attachDelegatedListener(container, element, eventName, handler, origina
 	setDelegatedHandlerForElement(element, {
 		handler,
 		original: originalHandler,
+		appRuntime: getCurrentAppRenderRuntime(),
 		container,
 		eventName,
 		options
@@ -212,6 +214,7 @@ function updateDelegatedListener(element, eventName, handler, originalHandler, o
 	}
 	existing.handler = handler;
 	existing.original = originalHandler;
+	existing.appRuntime = getCurrentAppRenderRuntime();
 	existing.options = options;
 	return true;
 }

package/dist/{component-cleanup-BUfUleGZ.js → component-cleanup-hrqSikl2.js}

@@ -1,6 +1,6 @@
-import { b as isDevelopmentEnvironment, v as logger, x as isProductionEnvironment } from "./access-Dpfoi4cA.js";
-import { a as clearCurrentComponentScope, y as restoreCurrentComponentScope } from "./component-scope-DzJEbYGE.js";
-import { n as cleanupReadableSubscriptions, t as cleanupReadableSubscriptionSources } from "./readable-B5NtV7V0.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-BsdGWsDE.js";
 //#region src/runtime/state-diagnostics.ts
 /**
 * Report state cells that were never read during a component's completed

package/dist/{component-internal-C4uwwUaK.js → component-internal-DOVVMjG7.js}

@@ -1,10 +1,10 @@
 import { a as markTransparentComponentResult, i as markEagerControlPrimitive } from "./control-C-ApnFs1.js";
-import { b as isDevelopmentEnvironment, n as enqueueRuntimeTask, o as getRuntimeRenderer, v as logger, x as isProductionEnvironment } from "./access-Dpfoi4cA.js";
-import { r as tryRuntimeFastLaneSync, t as isBulkCommitActive } from "./fastlane-CrfB3QG0.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-DzJEbYGE.js";
-import { r as STATIC_CHILDREN, t as ELEMENT_TYPE } from "./jsx-C3IECePB.js";
-import { i as finalizeReadableSubscriptions } from "./readable-B5NtV7V0.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-Dfpid9-A.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-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.");

package/dist/{component-scope-DzJEbYGE.js → component-scope-4I3yEMkb.js}

@@ -1,6 +1,7 @@
 //#region src/runtime/component-scope.ts
 let currentInstance = null;
 let currentPortalScope = null;
+let scopedAppRenderRuntime;
 let stateIndex = 0;
 let globalRenderCounter = 0;
 let renderScopedDepth = 0;
@@ -48,6 +49,17 @@ function getCurrentAppRenderRuntime() {
 		if (instance._appRenderRuntime) return instance._appRenderRuntime;
 		instance = instance.parentInstance;
 	}
+	return scopedAppRenderRuntime;
+}
+/** @internal Preserve root ownership without exposing component hook scope. */
+function withAppRenderRuntime(runtime, fn) {
+	const previous = scopedAppRenderRuntime;
+	scopedAppRenderRuntime = runtime;
+	try {
+		return fn();
+	} finally {
+		scopedAppRenderRuntime = previous;
+	}
 }
 function setCurrentComponentInstance(instance) {
 	currentInstance = instance;
@@ -180,4 +192,4 @@ function getCurrentStateIndex() {
 	return stateIndex;
 }
 //#endregion
-export { restoreRenderScopedComponent as C, restoreInlineRenderTracking as S, getSignalForInstance as _, clearCurrentComponentScope as a, restoreDomCommitScope as b, enterDomCommitScope as c, getCurrentAppRenderRuntime as d, getCurrentComponentInstance as f, getSignal as g, getCurrentStateIndex as h, claimHookIndex as i, enterRenderScopedComponent as l, getCurrentPortalScope as m, captureInlineComponentScope as n, clearRenderTracking as o, getCurrentInstance as p, captureInlineRenderTracking as r, enterComponentExecutionScope as s, beginRenderTracking as t, exitComponentExecutionScope as u, resetRenderState as v, setCurrentComponentInstance as w, restoreInlineComponentScope as x, restoreCurrentComponentScope as y };
+export { restoreRenderScopedComponent as C, restoreInlineRenderTracking as S, withAppRenderRuntime as T, getSignalForInstance as _, clearCurrentComponentScope as a, restoreDomCommitScope as b, enterDomCommitScope as c, getCurrentAppRenderRuntime as d, getCurrentComponentInstance as f, getSignal as g, getCurrentStateIndex as h, claimHookIndex as i, enterRenderScopedComponent as l, getCurrentPortalScope as m, captureInlineComponentScope as n, clearRenderTracking as o, getCurrentInstance as p, captureInlineRenderTracking as r, enterComponentExecutionScope as s, beginRenderTracking as t, exitComponentExecutionScope as u, resetRenderState as v, setCurrentComponentInstance as w, restoreInlineComponentScope as x, restoreCurrentComponentScope as y };

package/dist/components/index.d.ts

@@ -1,13 +1,18 @@
-import { d as VNode } from "../control-D-FIa-n-.js";
-import { r as JSXElement, s as Props } from "../jsx-BYXe_Nnk.js";
+import { in as VNode } from "../index-KQ7Vl4-8.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

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-DzJEbYGE.js";
-import { t as ELEMENT_TYPE } from "../jsx-C3IECePB.js";
+import { f as getCurrentComponentInstance } from "../component-scope-4I3yEMkb.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 = {

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 { 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-BU17hud9.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-KQ7Vl4-8.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-CON10J1p.js";
+import { i as For, n as Match, r as Show, t as Case } from "../control-DqOzkgc7.js";
 export { Case, For, Match, Show };

package/dist/{control-CsGs2bLS.d.ts → control-DdFw-Caz.d.ts}

@@ -1,4 +1,4 @@
-import { s as Props } from "./jsx-BYXe_Nnk.js";
+import { s as Props } from "./types-DkVJhVs9.js";
 //#region src/common/control.d.ts
 declare const EAGER_CONTROL_PRIMITIVE: unique symbol;
 type EagerControlPrimitive<P extends Props = Props> = ((props: P) => unknown) & {

package/dist/{control-CON10J1p.js → control-DqOzkgc7.js}

@@ -1,9 +1,9 @@
 import { i as markEagerControlPrimitive, t as __CONTROL_BOUNDARY__ } from "./control-C-ApnFs1.js";
-import { b as isDevelopmentEnvironment } from "./access-Dpfoi4cA.js";
-import { n as Fragment } from "./jsx-C3IECePB.js";
-import { m as createShowState, p as createCaseState, s as useForState } from "./for-internal-Bsm0B8GZ.js";
-import { t as createFineGrainedEffect } from "./effect-lnxQIpJG.js";
-import { t as state } from "./state-DCjONcHK.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-jrliHZmF.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 };

package/dist/{csp-nonce-DH0TrDij.js → csp-nonce-BBxq1zq4.js}

@@ -1,4 +1,4 @@
-import { _ as readScope, d as defineScope } from "./component-internal-C4uwwUaK.js";
+import { _ as readScope, d as defineScope } from "./component-internal-DOVVMjG7.js";
 //#region src/common/url.ts
 const SAFE_URL_SCHEMES = /* @__PURE__ */ new Set([
 	"http",
@@ -35,7 +35,14 @@ function isUnsafeUrlAttribute(key, value) {
 const ROUTE_ROOT_COMPONENT = Symbol.for("askr.route-root-component");
 //#endregion
 //#region src/csp-nonce.ts
+/** Lexical scope carrying the CSP nonce for the current render, if any. */
 const CspNonceScope = defineScope(void 0);
+/**
+* Read the CSP nonce for the current render from {@link CspNonceScope}.
+*
+* @returns The active nonce, or `undefined` when called outside of a
+* component render or when no nonce was configured.
+*/
 function cspNonce() {
 	try {
 		return readScope(CspNonceScope);