@askrjs/askr 0.0.92 → 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-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-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-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-DodHdC0L.js → activity-BshyLB3_.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-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-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/{activity-DxUcygE5.d.ts → activity-CJIQyo5X.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-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-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 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-D71bjP4r.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.92",
-	buildLabel: "0.0.92-local"
+	packageVersion: "0.0.94",
+	buildLabel: "0.0.94-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-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;
@@ -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-BsMB_ySP.js";
 export { cleanupApp, createIsland, createIslands, createSPA, hasApp, hydrateSPA };

package/dist/{boot-D71bjP4r.js → boot-BsMB_ySP.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-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-ByMbWv8s.js";
-import { i as getDefaultDataRuntime } from "./data-runtime-oIdQWnPW.js";
-import { a as hydrateDataRuntime } from "./query-registry-qm13pEdK.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-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-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;
@@ -604,7 +610,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-jf8X2V3x.js");
 		if (!verifyHydrationSyncForUrl({
 			root: rootElement,
 			url: currentUrl,

package/dist/{cleanup-DAAhJjx5.js → cleanup-DefafSjG.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-hrqSikl2.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-hrqSikl2.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

package/dist/{component-internal-DlAkCgBE.js → component-internal-DOVVMjG7.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.");

package/dist/components/index.d.ts

@@ -1,13 +1,18 @@
-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-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-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 = {

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-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-Dv540XtV.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-CdzY49Q2.d.ts → control-DdFw-Caz.d.ts}

@@ -1,4 +1,4 @@
-import { s as Props } from "./types-BA9FJtfR.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-Dv540XtV.js → control-DqOzkgc7.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-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-ByMbWv8s.js → csp-nonce-BBxq1zq4.js}

@@ -1,4 +1,4 @@
-import { _ as readScope, d as defineScope } from "./component-internal-DlAkCgBE.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);

package/dist/data/index.d.ts

@@ -1,2 +1,2 @@
-import { A as QueryStaleReason, C as MutationOptions, D as QueryKeyPart, E as QueryDefinition, O as QueryPrefetchContext, S as Mutation, T as QueryConsistency, a as defineServerQueries, b as InvalidateOnIntervalOptions, c as prefetchQuery, d as invalidateOnInterval, f as queryScope, g as createMutation, h as createQuery, i as defineQuery, j as ServerQueryHandler, k as QueryScope, l as serveQuery, m as getDefaultDataRuntime, n as ServerQueryRegistry, o as dehydrateDataRuntime, p as createDataRuntime, r as createQueryPrefetchContext, s as hydrateDataRuntime, t as ServerQueryEntry, u as invalidate, v as DataRuntime, w as Query, x as InvalidateOptions, y as DataRuntimeOptions } from "../index-2bk8nldG.js";
+import { Bt as DataRuntimeOptions, Gt as Query, Ht as InvalidateOptions, Jt as QueryKeyPart, Kt as QueryConsistency, Qt as ServerQueryHandler, S as createMutation, Ut as Mutation, Vt as InvalidateOnIntervalOptions, Wt as MutationOptions, Xt as QueryScope, Yt as QueryPrefetchContext, Zt as QueryStaleReason, _ as invalidateOnInterval, b as getDefaultDataRuntime, c as ServerQueryRegistry, d as defineServerQueries, f as dehydrateDataRuntime, g as invalidate, h as serveQuery, l as createQueryPrefetchContext, m as prefetchQuery, p as hydrateDataRuntime, qt as QueryDefinition, s as ServerQueryEntry, u as defineQuery, v as queryScope, x as createQuery, y as createDataRuntime, zt as DataRuntime } from "../index-KQ7Vl4-8.js";
 export { type DataRuntime, type DataRuntimeOptions, type InvalidateOnIntervalOptions, type InvalidateOptions, type Mutation, type MutationOptions, type Query, type QueryConsistency, type QueryDefinition, type QueryKeyPart, type QueryPrefetchContext, type QueryScope, type QueryStaleReason, type ServerQueryEntry, type ServerQueryHandler, type ServerQueryRegistry, createDataRuntime, createMutation, createQuery, createQueryPrefetchContext, defineQuery, defineServerQueries, dehydrateDataRuntime, getDefaultDataRuntime, hydrateDataRuntime, invalidate, invalidateOnInterval, prefetchQuery, queryScope, serveQuery };

package/dist/data/index.js

@@ -1,4 +1,4 @@
-import { i as getDefaultDataRuntime, t as createDataRuntime } from "../data-runtime-oIdQWnPW.js";
-import { c as queryScope, n as createMutation, o as invalidate, s as invalidateOnInterval, t as createQuery } from "../data-DcikEH9N.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-qm13pEdK.js";
+import { i as getDefaultDataRuntime, t as createDataRuntime } from "../data-runtime-JxoRgrrt.js";
+import { c as queryScope, n as createMutation, o as invalidate, s as invalidateOnInterval, t as createQuery } from "../data-DYqokZzc.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-CimB1YeW.js";
 export { createDataRuntime, createMutation, createQuery, createQueryPrefetchContext, defineQuery, defineServerQueries, dehydrateDataRuntime, getDefaultDataRuntime, hydrateDataRuntime, invalidate, invalidateOnInterval, prefetchQuery, queryScope, serveQuery };

package/dist/{data-DcikEH9N.js → data-DYqokZzc.js}

@@ -1,9 +1,9 @@
-import { n as enqueueRuntimeTask, y as logger } from "./access-DSkccuEI.js";
+import { n as enqueueRuntimeTask, y as logger } from "./access-d_DCdwqn.js";
 import { d as getCurrentAppRenderRuntime, f as getCurrentComponentInstance, i as claimHookIndex } from "./component-scope-4I3yEMkb.js";
-import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B99wh5Z_.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 { i as routeActive, n as documentVisible, o as timer, s as windowFocused } from "./lifecycle-operations-CQ8fsc94.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-oIdQWnPW.js";
+import { i as routeActive, n as documentVisible, o as timer, s as windowFocused } from "./lifecycle-operations-Qxq6ABrC.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-JxoRgrrt.js";
 //#region src/data/query-key.ts
 function serializeQueryKeyNumber(part) {
 	if (Number.isNaN(part)) return "NaN";
@@ -44,13 +44,19 @@ function createQueryScope(namespace, invalidate) {
 }
 //#endregion
 //#region src/data/invalidation.ts
+/** Mark all cached queries whose key starts with `prefix` as stale, triggering a refresh. */
 function invalidate(prefix, options) {
 	invalidateQueriesForRuntime(resolveDataRuntimeState(options?.runtime), prefix, options?.markPendingWrite ?? false);
 }
+/** Create a {@link QueryScope} that namespaces keys and invalidations under `namespace`. */
 function queryScope(namespace) {
 	return createQueryScope(namespace, invalidate);
 }
 const INVALIDATE_ON_INTERVAL_OPTIONS_ERROR = "[Askr] invalidateOnInterval() requires an options object with a finite numeric intervalMs.";
+/**
+* Periodically invalidate queries matching `prefix` on a fixed interval,
+* optionally gated by active route, document visibility, or window focus.
+*/
 function invalidateOnInterval(prefix, options) {
 	if (!options || typeof options !== "object" || typeof options.intervalMs !== "number" || !Number.isFinite(options.intervalMs)) throw new Error(INVALIDATE_ON_INTERVAL_OPTIONS_ERROR);
 	const runtimeState = resolveDataRuntimeState(options.runtime);
@@ -190,6 +196,11 @@ var MutationCell = class {
 		});
 	}
 };
+/**
+* Create a reactive {@link Mutation} cell bound to the current component,
+* running `options.action` on `execute()` and optionally invalidating
+* affected query prefixes on success.
+*/
 function createMutation(options) {
 	if (options.key !== void 0 && options.key.length === 0) throw new TypeError("createMutation key must be a non-empty string.");
 	const instance = getCurrentComponentInstance();

package/dist/{data-runtime-oIdQWnPW.js → data-runtime-JxoRgrrt.js}

@@ -27,6 +27,7 @@ function createDataRuntimeState(queryCache, queryData, queryTestOverrides, mutat
 		mutationTestOverrides
 	};
 }
+/** Create a new, isolated {@link DataRuntime} with its own query/mutation caches. */
 function createDataRuntime(options = {}) {
 	const runtime = Object.freeze({
 		queryCache: options.queryCache ?? /* @__PURE__ */ new Map(),
@@ -39,6 +40,7 @@ function createDataRuntime(options = {}) {
 	return runtime;
 }
 const defaultDataRuntime = createDataRuntime();
+/** Get the process-wide default {@link DataRuntime} used when none is provided explicitly. */
 function getDefaultDataRuntime() {
 	return defaultDataRuntime;
 }