@askrjs/askr 0.0.92 → 0.0.94

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-import { A as RuntimeKeyedReorderDecision, C as selector, Ct as readScope, D as derive, E as Derived, Ft as StateTuple, It as state, M as createRuntime, N as getDefaultRuntime, Nt as State, O as AskrRuntime, P as getSignal, Pt as StateSetter, S as Selector, St as defineScope, T as configureRenderDiagnostics, _ as MatchProps, b as For, c as createRef, d as registerSSRStyle, f as CspNonceScope, g as Match, h as CaseProps, j as RuntimeRendererHost, k as AskrRuntimeOptions, m as Case, p as cspNonce, s as Ref, v as Show, w as RenderDiagnosticsOptions, x as ForProps, xt as Scope, y as ShowProps } from "./index-DA3g8lm8.js";
-import { s as Props, t as Fragment } from "./types-BA9FJtfR.js";
-import { E as QueryDefinition, O as QueryPrefetchContext, a as defineServerQueries, c as prefetchQuery, h as createQuery, i as defineQuery, j as ServerQueryHandler, l as serveQuery, o as dehydrateDataRuntime, s as hydrateDataRuntime, v as DataRuntime } from "./index-2bk8nldG.js";
-import { i as jsxs, n as jsx } from "./jsx-runtime-Cfb2umb4.js";
+import { $t as Scope, A as Case, B as RenderDiagnosticsOptions, C as Ref, D as registerSSRStyle, F as ShowProps, G as AskrRuntimeOptions, H as Derived, I as For, J as createRuntime, K as RuntimeKeyedReorderDecision, L as ForProps, M as Match, N as MatchProps, O as CspNonceScope, P as Show, Qt as ServerQueryHandler, R as Selector, U as derive, V as configureRenderDiagnostics, W as AskrRuntime, Y as getDefaultRuntime, Yt as QueryPrefetchContext, Z as getSignal, d as defineServerQueries, dn as State, en as defineScope, f as dehydrateDataRuntime, fn as StateSetter, h as serveQuery, j as CaseProps, k as cspNonce, m as prefetchQuery, mn as state, p as hydrateDataRuntime, pn as StateTuple, q as RuntimeRendererHost, qt as QueryDefinition, tn as readScope, u as defineQuery, w as createRef, x as createQuery, z as selector, zt as DataRuntime } from "./index-KQ7Vl4-8.js";
+import { s as Props, t as Fragment } from "./types-DkVJhVs9.js";
+import { i as jsxs, n as jsx } from "./jsx-runtime-Cdd6Gkb0.js";
 export { AskrRuntime, type AskrRuntimeOptions, Case, type CaseProps, CspNonceScope, type DataRuntime, type Derived, For, type ForProps, Fragment, Match, type MatchProps, type Props, type QueryDefinition, type QueryPrefetchContext, type Ref, type RenderDiagnosticsOptions, type RuntimeKeyedReorderDecision, type RuntimeRendererHost, type Scope, type Selector, type ServerQueryHandler, Show, type ShowProps, type State, type StateSetter, type StateTuple, configureRenderDiagnostics, createQuery, createRef, createRuntime, cspNonce, defineQuery, defineScope, defineServerQueries, dehydrateDataRuntime, derive, getDefaultRuntime, getSignal, hydrateDataRuntime, jsx, jsxs, prefetchQuery, readScope, registerSSRStyle, selector, serveQuery, state };

package/dist/index.js

@@ -1,18 +1,18 @@
-import { a as getRuntimeFlushVersion, f as AskrRuntime, h as getDefaultRuntime, m as createRuntime, t as enqueueRuntimeLane } from "./access-DSkccuEI.js";
+import { a as getRuntimeFlushVersion, f as AskrRuntime, h as getDefaultRuntime, m as createRuntime, t as enqueueRuntimeLane } from "./access-d_DCdwqn.js";
 import { g as getSignal, i as claimHookIndex, p as getCurrentInstance } from "./component-scope-4I3yEMkb.js";
-import { n as Fragment } from "./jsx-C3IECePB.js";
-import { _ as readScope, d as defineScope, l as configureRenderDiagnostics } from "./component-internal-DlAkCgBE.js";
-import { f as syncDerivedDependencySubscriptions, l as notifyReadableReaders, o as markReactivePropsDirtySource, p as withDerivedReadTracking, r as clearDerivedDependencySubscriptions, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B99wh5Z_.js";
+import { n as Fragment } from "./jsx-DRS-qjiN.js";
+import { _ as readScope, d as defineScope, l as configureRenderDiagnostics } from "./component-internal-DOVVMjG7.js";
+import { f as syncDerivedDependencySubscriptions, l as notifyReadableReaders, o as markReactivePropsDirtySource, p as withDerivedReadTracking, r as clearDerivedDependencySubscriptions, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-BsdGWsDE.js";
 import { n as isSnapshotSource } from "./snapshot-source-BB42xgwb.js";
-import { t as installRendererBridge } from "./renderer-C6jz9nIN.js";
+import { t as installRendererBridge } from "./renderer-CLvq458M.js";
 import { c as registerSSRStyle } from "./render-context-B7ohlh6t.js";
-import { t as state } from "./state-XPZYUzHL.js";
-import { t as selector } from "./selector-BLWwI55m.js";
-import { n as cspNonce, t as CspNonceScope } from "./csp-nonce-ByMbWv8s.js";
-import { i as For, n as Match, r as Show, t as Case } from "./control-Dv540XtV.js";
+import { t as state } from "./state-DmkGM_LN.js";
+import { t as selector } from "./selector-CyK-sDwB.js";
+import { n as cspNonce, t as CspNonceScope } from "./csp-nonce-BBxq1zq4.js";
+import { i as For, n as Match, r as Show, t as Case } from "./control-DqOzkgc7.js";
 import { jsx, jsxs } from "./jsx-runtime.js";
-import { 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 } from "./query-registry-qm13pEdK.js";
+import { 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 } from "./query-registry-CimB1YeW.js";
 //#region src/runtime/derive.ts
 const deriveCells = /* @__PURE__ */ new WeakMap();
 const dirtyDerivedCells = /* @__PURE__ */ new Set();
@@ -61,8 +61,8 @@ function flushDirtyDerivedCells() {
 	if (failures && failures.length > 1) throw new AggregateError(failures, "derive() recompute failures");
 }
 function recomputeDerivedCell(cell, notifyDownstream) {
-	if (!cell._dirty && cell._hasValue) return cell._value;
 	if (cell._evaluating) throw new Error("derive() cannot read itself recursively");
+	if (!cell._dirty && cell._hasValue) return cell._value;
 	cell._evaluating = true;
 	cell._dirty = false;
 	cell._pendingDependencySources = /* @__PURE__ */ new Set();
@@ -169,6 +169,7 @@ function derive(source, map) {
 }
 //#endregion
 //#region src/ref.ts
+/** Create a new, empty {@link Ref} holder. */
 function createRef() {
 	return { current: null };
 }

package/dist/{interactions-CWkNEq_C.js → interactions-B4XaFxt1.js}

@@ -1,5 +1,6 @@
-import { o as mergeProps, r as ariaDisabled, s as composeHandlers, t as composeRefs } from "./compose-ref-Cc_YkUpM.js";
+import { o as mergeProps, r as ariaDisabled, s as composeHandlers, t as composeRefs } from "./compose-ref-1Fhs7mbF.js";
 //#region src/foundations/interactions/pressable.ts
+/** Produce click/keyboard props implementing 'press' semantics for an element. */
 function pressable({ disabled, onPress, isNativeButton = false }) {
 	const props = { onClick: (e) => {
 		if (disabled) {
@@ -47,6 +48,7 @@ function pressable({ disabled, onPress, isNativeButton = false }) {
 }
 //#endregion
 //#region src/foundations/interactions/dismissable.ts
+/** Produce keydown/outside-click props that invoke `onDismiss` on Escape or an outside click. */
 function dismissable({ node, disabled, onDismiss }) {
 	function handleKeyDown(e) {
 		if (disabled) return;
@@ -76,6 +78,7 @@ function dismissable({ node, disabled, onDismiss }) {
 * Normalize focus-related props for hosts.
 * - No DOM manipulation here; returns props that the runtime may attach.
 */
+/** Normalize `tabIndex`/`aria-disabled` props for a focusable host. */
 function focusable({ disabled, tabIndex }) {
 	return {
 		tabIndex: disabled ? -1 : tabIndex === void 0 ? 0 : tabIndex,
@@ -84,6 +87,7 @@ function focusable({ disabled, tabIndex }) {
 }
 //#endregion
 //#region src/foundations/interactions/hoverable.ts
+/** Produce pointer enter/leave props that call `onEnter`/`onLeave` unless disabled. */
 function hoverable({ disabled, onEnter, onLeave }) {
 	return {
 		onPointerEnter: disabled ? void 0 : (e) => {
@@ -96,6 +100,7 @@ function hoverable({ disabled, onEnter, onLeave }) {
 }
 //#endregion
 //#region src/foundations/interactions/roving-focus.ts
+/** Implement arrow-key roving tabindex navigation over a set of items. */
 function rovingFocus(options) {
 	const { currentIndex, itemCount, orientation = "horizontal", loop = false, onNavigate, isDisabled } = options;
 	const effectiveCurrentIndex = currentIndex >= 0 && currentIndex < itemCount && !isDisabled?.(currentIndex) ? currentIndex : Array.from({ length: itemCount }, (_, index) => index).find((index) => !isDisabled?.(index));

package/dist/{jsx-C3IECePB.js → jsx-DRS-qjiN.js}

@@ -1,5 +1,7 @@
 //#region src/common/jsx.ts
+/** Internal marker identifying an object as a JSX element vnode. */
 const ELEMENT_TYPE = Symbol.for("askr.element");
+/** The element type marker for JSX fragments (`<>...</>`), groups children without a wrapper element. */
 const Fragment = Symbol.for("askr.fragment");
 const STATIC_CHILDREN = Symbol.for("askr.static-children");
 function isFragmentType(type) {

package/dist/jsx-dev-runtime.d.ts

@@ -1,5 +1,5 @@
-import { a as IntrinsicFallbackProps, i as JSXElementType, n as JSXComponent, o as KnownIntrinsicElementProps, r as JSXElement, s as Props, t as Fragment } from "./types-BA9FJtfR.js";
-import { t as EagerControlPrimitive } from "./control-CdzY49Q2.js";
+import { a as IntrinsicFallbackProps, i as JSXElementType, n as JSXComponent, o as KnownIntrinsicElementProps, r as JSXElement, s as Props, t as Fragment } from "./types-DkVJhVs9.js";
+import { t as EagerControlPrimitive } from "./control-DdFw-Caz.js";
 //#region src/jsx/jsx-dev-runtime.d.ts
 declare namespace JSX {
   type ElementType = string | symbol | ((props: never) => unknown);

package/dist/jsx-dev-runtime.js

@@ -1,5 +1,5 @@
 import { r as isEagerControlPrimitive } from "./control-C-ApnFs1.js";
-import { n as Fragment, r as STATIC_CHILDREN, t as ELEMENT_TYPE } from "./jsx-C3IECePB.js";
+import { n as Fragment, r as STATIC_CHILDREN, t as ELEMENT_TYPE } from "./jsx-DRS-qjiN.js";
 //#region src/jsx/jsx-dev-runtime.ts
 function annotatePropsUsage(props) {
 	return props ?? {};

package/dist/jsx-runtime-BTzDdBJ_.d.ts

@@ -0,0 +1,2 @@
+import "./types-DkVJhVs9.js";
+import "./jsx-runtime-Cdd6Gkb0.js";

package/dist/{jsx-runtime-Cfb2umb4.d.ts → jsx-runtime-Cdd6Gkb0.d.ts}

@@ -1,5 +1,5 @@
-import { a as IntrinsicFallbackProps, o as KnownIntrinsicElementProps, r as JSXElement, s as Props } from "./types-BA9FJtfR.js";
-import { t as EagerControlPrimitive } from "./control-CdzY49Q2.js";
+import { a as IntrinsicFallbackProps, o as KnownIntrinsicElementProps, r as JSXElement, s as Props } from "./types-DkVJhVs9.js";
+import { t as EagerControlPrimitive } from "./control-DdFw-Caz.js";
 //#region src/jsx/jsx-runtime.d.ts
 declare namespace JSX {
   type ElementType = string | symbol | ((props: never) => unknown);
@@ -22,11 +22,13 @@ declare function jsxDEV<TTag extends keyof KnownIntrinsicElementProps>(type: TTa
 declare function jsxDEV<TTag extends string>(type: Exclude<TTag, keyof KnownIntrinsicElementProps>, props: IntrinsicFallbackProps | null, key?: string | number, isStaticChildren?: boolean): JSXElement;
 declare function jsxDEV<TProps extends object>(type: (props: TProps) => unknown, props: TProps | null, key?: string | number, isStaticChildren?: boolean): JSXElement;
 declare function jsxDEV(type: symbol, props: Props | null, key?: string | number, isStaticChildren?: boolean): JSXElement;
+/** JSX factory for elements with a single or no child, used by the `jsxImportSource` transform. */
 declare function jsx(type: EagerControlPrimitive, props: Props | null, key?: string | number): unknown;
 declare function jsx<TTag extends keyof KnownIntrinsicElementProps>(type: TTag, props: KnownIntrinsicElementProps[TTag] | null, key?: string | number): JSXElement;
 declare function jsx<TTag extends string>(type: Exclude<TTag, keyof KnownIntrinsicElementProps>, props: IntrinsicFallbackProps | null, key?: string | number): JSXElement;
 declare function jsx<TProps extends object>(type: (props: TProps) => unknown, props: TProps | null, key?: string | number): JSXElement;
 declare function jsx(type: symbol, props: Props | null, key?: string | number): JSXElement;
+/** JSX factory for elements with multiple static children, used by the `jsxImportSource` transform. */
 declare function jsxs(type: EagerControlPrimitive, props: Props | null, key?: string | number): unknown;
 declare function jsxs<TTag extends keyof KnownIntrinsicElementProps>(type: TTag, props: KnownIntrinsicElementProps[TTag] | null, key?: string | number): JSXElement;
 declare function jsxs<TTag extends string>(type: Exclude<TTag, keyof KnownIntrinsicElementProps>, props: IntrinsicFallbackProps | null, key?: string | number): JSXElement;

package/dist/jsx-runtime.d.ts

@@ -1,3 +1,3 @@
-import { i as JSXElementType, n as JSXComponent, r as JSXElement, t as Fragment } from "./types-BA9FJtfR.js";
-import { i as jsxs, n as jsx, r as jsxDEV, t as JSX } from "./jsx-runtime-Cfb2umb4.js";
+import { i as JSXElementType, n as JSXComponent, r as JSXElement, t as Fragment } from "./types-DkVJhVs9.js";
+import { i as jsxs, n as jsx, r as jsxDEV, t as JSX } from "./jsx-runtime-Cdd6Gkb0.js";
 export { Fragment, JSX, type JSXComponent, type JSXElement, type JSXElementType, jsx, jsxDEV, jsxs };

package/dist/jsx-runtime.js

@@ -1,5 +1,5 @@
 import { r as isEagerControlPrimitive } from "./control-C-ApnFs1.js";
-import { n as Fragment, r as STATIC_CHILDREN, t as ELEMENT_TYPE } from "./jsx-C3IECePB.js";
+import { n as Fragment, r as STATIC_CHILDREN, t as ELEMENT_TYPE } from "./jsx-DRS-qjiN.js";
 //#region src/jsx/jsx-runtime.ts
 function markStaticChildren(props) {
 	if (Array.isArray(props.children)) Object.defineProperty(props.children, STATIC_CHILDREN, {

package/dist/{lifecycle-batch-Cyfd07rf.js → lifecycle-batch-BH0fax4F.js}

@@ -1,5 +1,5 @@
-import { y as logger } from "./access-DSkccuEI.js";
-import { a as finalizeReadableSubscriptionsFromSnapshot } from "./readable-B99wh5Z_.js";
+import { y as logger } from "./access-d_DCdwqn.js";
+import { a as finalizeReadableSubscriptionsFromSnapshot } from "./readable-BsdGWsDE.js";
 //#region src/common/promise.ts
 function isPromiseLike(value) {
 	return value !== null && (typeof value === "object" || typeof value === "function") && typeof value.then === "function";

package/dist/{lifecycle-operations-CQ8fsc94.js → lifecycle-operations-Qxq6ABrC.js}

@@ -1,5 +1,5 @@
 import { f as getCurrentComponentInstance, i as claimHookIndex } from "./component-scope-4I3yEMkb.js";
-import { a as registerCommitOperation } from "./component-internal-DlAkCgBE.js";
+import { a as registerCommitOperation } from "./component-internal-DOVVMjG7.js";
 import { t as isRouteActivityActive } from "./route-activity-CNJfpwx-.js";
 //#region src/runtime/lifecycle-operations.ts
 function normalizePredicates(predicates) {
@@ -22,12 +22,15 @@ function getLifecycleSlot(instance, index, kind, create) {
 	lifecycleSlots[index] = slot;
 	return slot;
 }
+/** {@link ActivityPredicate} that is true while the current route matches `pathOrPaths`. */
 function routeActive(pathOrPaths) {
 	return () => isRouteActivityActive(pathOrPaths);
 }
+/** {@link ActivityPredicate} that is true while the document is visible. */
 function documentVisible() {
 	return () => typeof document === "undefined" || document.visibilityState !== "hidden";
 }
+/** {@link ActivityPredicate} that is true while the window has focus. */
 function windowFocused() {
 	return () => typeof document === "undefined" || typeof document.hasFocus !== "function" || document.hasFocus();
 }
@@ -72,6 +75,7 @@ function commitListenerSlot(instance, slot) {
 		});
 	}
 }
+/** Attach an owned event listener to `target` for the current component's lifetime. */
 function on(target, event, handler, options) {
 	const instance = getCurrentComponentInstance();
 	if (!instance) return;
@@ -131,6 +135,7 @@ function commitTimerSlot(instance, slot) {
 		});
 	}
 }
+/** Run `fn` on an owned interval for the current component's lifetime, optionally gated by `options.when`. */
 function timer(intervalMs, fn, options) {
 	const instance = getCurrentComponentInstance();
 	if (!instance) return;

package/dist/{manifest-Dv0bO6kg.js → manifest-D6rfj_jC.js}

@@ -33,6 +33,10 @@ function _applyManifest(manifest) {
 		});
 	}
 }
+/**
+* Run `definition` to declare routes (via `route`/`page`/`group`/`fallback`)
+* and build a {@link RouteRegistry} to pass to `createSPA`/`hydrateSPA`.
+*/
 function createRouteRegistry(definition, options = {}) {
 	const previous = snapshotRouteState();
 	clearRouteState();

package/dist/{navigate-CZHPEUC4.d.ts → navigate-BL_FIIJ6.d.ts}

@@ -1,13 +1,17 @@
-import "./index-DA3g8lm8.js";
+import "./index-KQ7Vl4-8.js";
 //#region src/router/navigation-scroll.d.ts
+/** Scroll behavior for programmatic navigations (`navigate()`). */
 type NavigationScrollBehavior = 'top' | 'preserve';
+/** Scroll behavior for browser back/forward (popstate) navigations. */
 type HistoryScrollBehavior = 'restore' | 'top' | 'preserve';
+/** Options for {@link configureScrollRestoration}. */
 type ScrollRestorationOptions = {
   navigation?: NavigationScrollBehavior;
   history?: HistoryScrollBehavior;
 };
 //#endregion
 //#region src/router/navigation-targets.d.ts
+/** Options for {@link navigate}. */
 type NavigateOptions = {
   history?: 'push' | 'replace';
   replace?: boolean;
@@ -15,6 +19,7 @@ type NavigateOptions = {
 };
 //#endregion
 //#region src/router/navigate.d.ts
+/** Navigate the client-side router to `path` using the History API. */
 declare function navigate(path: string, options?: NavigateOptions): void;
 //#endregion
 export { ScrollRestorationOptions as a, NavigationScrollBehavior as i, NavigateOptions as n, HistoryScrollBehavior as r, navigate as t };

package/dist/{navigate-BbWj-QU-.js → navigate-CECCMPAr.js}

@@ -1,14 +1,14 @@
-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 { r as executeComponent } from "./component-internal-DlAkCgBE.js";
-import { t as cleanupReadableSubscriptionSources } from "./readable-B99wh5Z_.js";
-import { n as cleanupComponentGeneration, t as cleanupComponent } from "./component-cleanup-CJCfu5ed.js";
-import { i as drainLifecycleCommitErrors, p as isPromiseLike, r as discardLifecycleCommitBatch, s as flushLifecycleCommitBatch, t as beginLifecycleCommitBatch } from "./lifecycle-batch-Cyfd07rf.js";
-import { _ as teardownNodeSubtree } from "./cleanup-DAAhJjx5.js";
-import { t as CspNonceScope } from "./csp-nonce-ByMbWv8s.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 { r as executeComponent } from "./component-internal-DOVVMjG7.js";
+import { t as cleanupReadableSubscriptionSources } from "./readable-BsdGWsDE.js";
+import { n as cleanupComponentGeneration, t as cleanupComponent } from "./component-cleanup-hrqSikl2.js";
+import { i as drainLifecycleCommitErrors, p as isPromiseLike, r as discardLifecycleCommitBatch, s as flushLifecycleCommitBatch, t as beginLifecycleCommitBatch } from "./lifecycle-batch-BH0fax4F.js";
+import { _ as teardownNodeSubtree } from "./cleanup-DefafSjG.js";
+import { t as CspNonceScope } from "./csp-nonce-BBxq1zq4.js";
 import { I as lockRouteRegistration, o as addRouteBasePath, r as computeRouteActivityMatches, y as getActiveRouteBasePath } from "./route-matching-Bo6UqG-5.js";
-import { a as resolveRouteRequest, i as hasRouteRenderData, n as getRouteRenderContext, r as getRouteRenderData, u as withoutRouteHydrationMetadata } from "./resolution-B21kmOkp.js";
-import { a as clearStagedAppRenderRouteLocation, i as syncCurrentRouteSnapshot, o as createAppRenderRuntime, s as stageAppRenderRouteLocation } from "./activity-DodHdC0L.js";
+import { a as resolveRouteRequest, i as hasRouteRenderData, n as getRouteRenderContext, r as getRouteRenderData, u as withoutRouteHydrationMetadata } from "./resolution-D8PgnTzh.js";
+import { a as clearStagedAppRenderRouteLocation, i as syncCurrentRouteSnapshot, o as createAppRenderRuntime, s as stageAppRenderRouteLocation } from "./activity-BshyLB3_.js";
 import { r as getDefaultPortalHost, t as clearRegisteredDefaultPortalForInstance } from "./default-portal-runtime-DvMvWJVp.js";
 //#region src/router/navigation-registry.ts
 let currentInstance = null;
@@ -240,6 +240,7 @@ function metadataSources(record) {
 	if (record.metaChain) return record.metaChain;
 	return record.options.meta ? [record.options.meta] : [];
 }
+/** Resolve a route's merged {@link RouteMeta} by running its metadata chain against `context`. */
 async function resolveRouteMeta(record, context) {
 	let resolved = record.options.title ? { title: record.options.title } : {};
 	for (const source of metadataSources(record)) {
@@ -326,6 +327,7 @@ function serializeJsonLd(value) {
 	const json = JSON.stringify(value).replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
 	return `<script${ownedAttribute()} type="application/ld+json">${json}<\/script>`;
 }
+/** Render a {@link RouteMeta} to the `<title>`/`<meta>`/`<link>`/JSON-LD markup for the document `<head>`. */
 function serializeRouteMeta(meta) {
 	const output = [];
 	if (meta.title !== void 0) output.push(`<title${ownedAttribute()}>${escapeText(meta.title)}</title>`);
@@ -993,6 +995,7 @@ function applyPopStateNavigationTargets(requestId, previousHref, previousState,
 */
 let navigationInitialized = false;
 configureNavigationRegistryHost({ cancelRouteRequests });
+/** Navigate the client-side router to `path` using the History API. */
 function navigate(path, options = {}) {
 	if (typeof window === "undefined") return;
 	const targetPath = addRouteBasePath(path, getActiveRouteBasePath());

package/dist/{query-registry-qm13pEdK.js → query-registry-CimB1YeW.js}

@@ -1,16 +1,18 @@
-import { i as getDefaultDataRuntime, t as createDataRuntime } from "./data-runtime-oIdQWnPW.js";
+import { i as getDefaultDataRuntime, t as createDataRuntime } from "./data-runtime-JxoRgrrt.js";
 //#region src/common/telemetry.ts
 function withTelemetry(span, fields, work) {
 	return span ? span(fields, work) : work();
 }
 //#endregion
 //#region src/data/query-registry.ts
+/** Pair a {@link QueryDefinition} with the server-side handler that resolves it. */
 function serveQuery(query, handler) {
 	return Object.freeze({
 		query,
 		handler
 	});
 }
+/** Build a {@link ServerQueryRegistry} from one or more {@link serveQuery} entries. */
 function defineServerQueries(...entries) {
 	const frozenEntries = Object.freeze([...entries]);
 	const handlers = new Map(entries.map((entry) => [entry.query, entry.handler]));
@@ -21,9 +23,14 @@ function defineServerQueries(...entries) {
 		}
 	});
 }
+/** Freeze and return a reusable {@link QueryDefinition}. */
 function defineQuery(definition) {
 	return Object.freeze({ ...definition });
 }
+/**
+* Create a {@link QueryPrefetchContext} for prefetching query data ahead of
+* render, e.g. during SSR route resolution.
+*/
 function createQueryPrefetchContext(options = {}) {
 	const runtime = options.runtime ?? (options.mode === "spa" ? getDefaultDataRuntime() : createDataRuntime());
 	const signal = options.signal ?? new AbortController().signal;
@@ -54,9 +61,11 @@ function createQueryPrefetchContext(options = {}) {
 		}
 	};
 }
+/** Prefetch `query` with `input` into a {@link QueryPrefetchContext}'s runtime. */
 async function prefetchQuery(context, query, input) {
 	return context.prefetch(query, input);
 }
+/** Extract a runtime's cached query data into a JSON-serializable snapshot, dropping non-serializable values. */
 function dehydrateDataRuntime(runtime) {
 	const result = {};
 	for (const [key, value] of runtime.queryData) try {
@@ -65,6 +74,7 @@ function dehydrateDataRuntime(runtime) {
 	} catch {}
 	return result;
 }
+/** Load a {@link dehydrateDataRuntime} snapshot back into a runtime's query cache. */
 function hydrateDataRuntime(runtime, data) {
 	if (!data || typeof data !== "object" || Array.isArray(data)) return;
 	for (const [key, value] of Object.entries(data)) runtime.queryData.set(key, value);

package/dist/{readable-B99wh5Z_.js → readable-BsdGWsDE.js}

@@ -1,4 +1,4 @@
-import { c as markRuntimeReactivePropsDirtySource, n as enqueueRuntimeTask, s as isRuntimeSchedulerExecuting } from "./access-DSkccuEI.js";
+import { c as markRuntimeReactivePropsDirtySource, n as enqueueRuntimeTask, s as isRuntimeSchedulerExecuting } from "./access-d_DCdwqn.js";
 import { p as getCurrentInstance } from "./component-scope-4I3yEMkb.js";
 //#region src/runtime/readable.ts
 const DEVELOPMENT_BUILD_ENABLED = false;

package/dist/{renderer-C6jz9nIN.js → renderer-CLvq458M.js}

@@ -1,17 +1,17 @@
 import { n as hasTransparentComponentResult, t as __CONTROL_BOUNDARY__ } from "./control-C-ApnFs1.js";
 import { n as _isDOMElement, t as __ERROR_BOUNDARY__ } from "./vnode-D24p6IW2.js";
-import { b as getRuntimeEnv, i as getDefaultRuntimeInstance, l as runRuntimeHandlerScope, n as enqueueRuntimeTask, p as configureRuntimeRenderer, x as isDevelopmentEnvironment, y as logger } from "./access-DSkccuEI.js";
-import { n as isBulkCommitActive, r as markFastPathApplied } from "./fastlane-B2s24fWt.js";
+import { b as getRuntimeEnv, i as getDefaultRuntimeInstance, l as runRuntimeHandlerScope, n as enqueueRuntimeTask, p as configureRuntimeRenderer, x as isDevelopmentEnvironment, y as logger } from "./access-d_DCdwqn.js";
+import { n as isBulkCommitActive, r as markFastPathApplied } from "./fastlane-DGo7SxBQ.js";
 import { T as withAppRenderRuntime, b as restoreDomCommitScope, c as enterDomCommitScope, d as getCurrentAppRenderRuntime, p as getCurrentInstance } from "./component-scope-4I3yEMkb.js";
-import { i as isFragmentType, r as STATIC_CHILDREN } from "./jsx-C3IECePB.js";
-import { b as withContext, f as getCurrentContextFrame, g as markVNodeTreeWithContextFrame, i as mountInstanceInline, m as getVNodeContextFrame, n as createComponentInstance, o as renderComponentInline, t as captureInlineRenderSnapshot } from "./component-internal-DlAkCgBE.js";
-import { t as cleanupComponent } from "./component-cleanup-CJCfu5ed.js";
-import { c as getCurrentLifecycleCommitBatch, l as registerLifecycleRollback, p as isPromiseLike, r as discardLifecycleCommitBatch, s as flushLifecycleCommitBatch, t as beginLifecycleCommitBatch, u as registerLifecycleTransaction } from "./lifecycle-batch-Cyfd07rf.js";
-import { _ as setControlBoundaryContextFrame, a as registerForStateTransaction, b as rerenderChildScope, c as captureForFallbackTransactionSnapshot, d as clearCaseDomUpdateState, f as clearShowDomUpdateState, g as evaluateShowState, h as evaluateCaseState, i as evaluateForState, l as captureForItemTransactionSnapshot, n as clearForDomUpdateState, o as rollbackForStateTransaction, t as beginForStateTransaction, v as createChildScope, y as disposeChildScope } from "./for-internal-T1C7jd7x.js";
-import { n as createOwnedFineGrainedEffect, r as markFineGrainedEffectsDirtySource, t as createFineGrainedEffect } from "./effect-BdZcHblj.js";
-import { C as getDelegatedHandlersForElement, D as updateDelegatedListener, E as removeDelegatedListener, S as getDelegatedHandlerForElement, T as isEventDelegationEnabled, _ as teardownNodeSubtree, a as elementReactivePropsCleanup, b as addFreshDelegatedListener, c as forEachElementReactivePropCleanup, d as removeAllListeners, f as removeElementReactiveProps, g as setFreshElementReactivePropCleanup, h as setDirectElementReactivePropCleanup, i as elementListeners, l as getElementReactivePropCleanupSize, m as replaceElementRefBookkeeping, n as cleanupInstanceIfPresent, o as elementRefs, p as removeElementRef, r as cleanupInstancesUnder, s as forEachDescendantNode, t as REACTIVE_CHILDREN_KEY, u as getElementReactivePropsCleanupMap, v as updateElementRef, w as isDelegatedEvent, x as clearDelegatedHandlersForElement, y as addDelegatedListener } from "./cleanup-DAAhJjx5.js";
+import { i as isFragmentType, r as STATIC_CHILDREN } from "./jsx-DRS-qjiN.js";
+import { b as withContext, f as getCurrentContextFrame, g as markVNodeTreeWithContextFrame, i as mountInstanceInline, m as getVNodeContextFrame, n as createComponentInstance, o as renderComponentInline, t as captureInlineRenderSnapshot } from "./component-internal-DOVVMjG7.js";
+import { t as cleanupComponent } from "./component-cleanup-hrqSikl2.js";
+import { c as getCurrentLifecycleCommitBatch, l as registerLifecycleRollback, p as isPromiseLike, r as discardLifecycleCommitBatch, s as flushLifecycleCommitBatch, t as beginLifecycleCommitBatch, u as registerLifecycleTransaction } from "./lifecycle-batch-BH0fax4F.js";
+import { _ as setControlBoundaryContextFrame, a as registerForStateTransaction, b as rerenderChildScope, c as captureForFallbackTransactionSnapshot, d as clearCaseDomUpdateState, f as clearShowDomUpdateState, g as evaluateShowState, h as evaluateCaseState, i as evaluateForState, l as captureForItemTransactionSnapshot, n as clearForDomUpdateState, o as rollbackForStateTransaction, t as beginForStateTransaction, v as createChildScope, y as disposeChildScope } from "./for-internal-jrliHZmF.js";
+import { n as createOwnedFineGrainedEffect, r as markFineGrainedEffectsDirtySource, t as createFineGrainedEffect } from "./effect-BdvdgMvV.js";
+import { C as getDelegatedHandlersForElement, D as updateDelegatedListener, E as removeDelegatedListener, S as getDelegatedHandlerForElement, T as isEventDelegationEnabled, _ as teardownNodeSubtree, a as elementReactivePropsCleanup, b as addFreshDelegatedListener, c as forEachElementReactivePropCleanup, d as removeAllListeners, f as removeElementReactiveProps, g as setFreshElementReactivePropCleanup, h as setDirectElementReactivePropCleanup, i as elementListeners, l as getElementReactivePropCleanupSize, m as replaceElementRefBookkeeping, n as cleanupInstanceIfPresent, o as elementRefs, p as removeElementRef, r as cleanupInstancesUnder, s as forEachDescendantNode, t as REACTIVE_CHILDREN_KEY, u as getElementReactivePropsCleanupMap, v as updateElementRef, w as isDelegatedEvent, x as clearDelegatedHandlersForElement, y as addDelegatedListener } from "./cleanup-DefafSjG.js";
 import { n as getPublicAttributeName, t as sanitizeCssValue } from "./css-BuPaTOfe.js";
-import { i as ROUTE_ROOT_COMPONENT, o as isUnsafeUrlAttribute } from "./csp-nonce-ByMbWv8s.js";
+import { i as ROUTE_ROOT_COMPONENT, o as isUnsafeUrlAttribute } from "./csp-nonce-BBxq1zq4.js";
 import { a as isSSRPortalHydrationAnchor } from "./portal-w3oQ6oQU.js";
 //#region src/runtime/error-boundary.ts
 function createBoundaryReset(instance) {

package/dist/{resolution-B21kmOkp.js → resolution-D8PgnTzh.js}

@@ -1,11 +1,12 @@
-import { n as Fragment, t as ELEMENT_TYPE } from "./jsx-C3IECePB.js";
-import { _ as readScope, d as defineScope } from "./component-internal-DlAkCgBE.js";
-import { p as isPromiseLike } from "./lifecycle-batch-Cyfd07rf.js";
+import { n as Fragment, t as ELEMENT_TYPE } from "./jsx-DRS-qjiN.js";
+import { _ as readScope, d as defineScope } from "./component-internal-DOVVMjG7.js";
+import { p as isPromiseLike } from "./lifecycle-batch-BH0fax4F.js";
 import { S as withPageFramework, b as replacePageRoute, n as getActiveRenderContext } from "./render-context-B7ohlh6t.js";
-import { i as ROUTE_ROOT_COMPONENT } from "./csp-nonce-ByMbWv8s.js";
-import { c as withTelemetry, t as createQueryPrefetchContext } from "./query-registry-qm13pEdK.js";
+import { i as ROUTE_ROOT_COMPONENT } from "./csp-nonce-BBxq1zq4.js";
+import { c as withTelemetry, t as createQueryPrefetchContext } from "./query-registry-CimB1YeW.js";
 import { c as removeRouteBasePath, i as getMatchingRouteRecord, l as buildRouteContext, o as addRouteBasePath, s as normalizeRouteBasePath, u as buildRouteContextBase, v as getActiveRouteAuthOptions } from "./route-matching-Bo6UqG-5.js";
 //#region src/router/route-data-loader.ts
+/** Thrown when a route's `loader` rejects; wraps the original `cause`. */
 var RouteDataLoadError = class extends Error {
 	constructor(route, phase, cause) {
 		const detail = cause instanceof Error ? cause.message : String(cause);
@@ -48,6 +49,7 @@ function startLazyLoad(state) {
 	pendingLazy.add(promise);
 	return promise;
 }
+/** Wrap a dynamic-import factory as a {@link LazyRouteComponent}, loaded on first use. */
 function lazy(factory) {
 	const state = {
 		factory,
@@ -99,6 +101,7 @@ function _preloadRouteHandler(handler) {
 //#endregion
 //#region src/router/rendering.ts
 const outletScope = defineScope(null);
+/** Renders the nested route content for the enclosing layout or page scope. */
 function Outlet() {
 	return {
 		$$typeof: ELEMENT_TYPE,
@@ -166,6 +169,7 @@ function setCurrentAuth(context) {
 //#region src/common/deferred-value.ts
 const DEFERRED_VALUE = Symbol.for("@askrjs/askr/deferred-value");
 const DEFERRED_BOUNDARY = Symbol.for("@askrjs/askr/deferred-boundary");
+/** Wrap a promise as a {@link Deferred} value that tracks its settled state and result. */
 function defer(promise) {
 	let state = "pending";
 	let value;
@@ -195,6 +199,7 @@ function defer(promise) {
 		[DEFERRED_VALUE]: { value: true }
 	}));
 }
+/** Check whether `value` is a {@link Deferred} produced by {@link defer}. */
 function isDeferred(value) {
 	if (!value || typeof value !== "object") return false;
 	const marker = Object.getOwnPropertyDescriptor(value, DEFERRED_VALUE);
@@ -510,6 +515,7 @@ function resolveMatchedRoute(record, params, context, authOptions, request, tele
 	const decision = record.options.auth(context.auth);
 	return isPromiseLike(decision) ? Promise.resolve(decision).then(continueResolution) : continueResolution(decision);
 }
+/** Resolve `target` against a route registry, applying auth/policies to produce a render/redirect/deny result. */
 function resolveRouteRequest(target, options) {
 	if (!options?.registry) throw new TypeError("resolveRouteRequest requires options.registry.");
 	const basePath = normalizeRouteBasePath(options.registry.manifest.basePath);

package/dist/{resource-operation-CaAttQqz.js → resource-operation-CLQXCn1p.js}

@@ -1,10 +1,10 @@
-import { t as enqueueRuntimeLane, y as logger } from "./access-DSkccuEI.js";
+import { t as enqueueRuntimeLane, y as logger } from "./access-d_DCdwqn.js";
 import { f as getCurrentComponentInstance } from "./component-scope-4I3yEMkb.js";
-import { c as registerCommitOperationForInstance, f as getCurrentContextFrame, y as withAsyncResourceContext } from "./component-internal-DlAkCgBE.js";
-import { p as isPromiseLike } from "./lifecycle-batch-Cyfd07rf.js";
+import { c as registerCommitOperationForInstance, f as getCurrentContextFrame, y as withAsyncResourceContext } from "./component-internal-DOVVMjG7.js";
+import { p as isPromiseLike } from "./lifecycle-batch-BH0fax4F.js";
 import { t as brandSnapshotSource } from "./snapshot-source-BB42xgwb.js";
 import { C as SSRDataMissingError, a as getResourceVerificationSnapshot, i as getNextRenderKey, n as getActiveRenderContext, o as isHydrationVerificationRender, p as throwSSRDataMissing, r as getCurrentRenderData, s as recordResourceVerificationSnapshot } from "./render-context-B7ohlh6t.js";
-import { t as state } from "./state-XPZYUzHL.js";
+import { t as state } from "./state-DmkGM_LN.js";
 //#region src/runtime/resource-cell.ts
 /**
 * Pure, component-agnostic ResourceCell state machine.

package/dist/resources/index.d.ts

@@ -1,6 +1,7 @@
-import { P as getSignal } from "../index-DA3g8lm8.js";
-import { i as onRouteChange, n as RouteChangeOptions, t as RouteChangeCleanup } from "../activity-DxUcygE5.js";
+import { Z as getSignal } from "../index-KQ7Vl4-8.js";
+import { i as onRouteChange, n as RouteChangeOptions, t as RouteChangeCleanup } from "../activity-CJIQyo5X.js";
 //#region src/runtime/resource-operation.d.ts
+/** Reactive result of a {@link resource}: current value, loading state, and controls. */
 interface ResourceResult<T> {
   value: T | null;
   pending: boolean;
@@ -13,7 +14,9 @@ declare function resource<T, const TDeps extends readonly unknown[]>(fn: (opts:
 }) => PromiseLike<T> | T, deps: TDeps): ResourceResult<T>;
 //#endregion
 //#region src/runtime/stream-operation.d.ts
+/** Connection status of a {@link stream}. */
 type StreamStatus = 'connecting' | 'connected' | 'reconnecting' | 'closed' | 'error';
+/** Reactive result of a {@link stream}: current value, connection status, and controls. */
 interface StreamResult<T> {
   value: T | null;
   status: StreamStatus;
@@ -23,6 +26,7 @@ interface StreamResult<T> {
   restart(): void;
   close(): void;
 }
+/** Options for {@link stream}. */
 interface StreamOptions<T> {
   deps?: readonly unknown[];
   initialValue?: T;
@@ -30,19 +34,28 @@ interface StreamOptions<T> {
 type StreamSource<T> = (context: {
   signal: AbortSignal;
 }) => AsyncIterable<T> | PromiseLike<AsyncIterable<T>>;
+/** Subscribe to a streaming data source for the current component's lifetime, with auto reconnect/cleanup. */
 declare function stream<T>(source: StreamSource<T>, options?: StreamOptions<T>): StreamResult<T>;
 //#endregion
 //#region src/runtime/lifecycle-operations.d.ts
+/** A gating condition for lifecycle primitives like {@link timer}; `true` means active. */
 type ActivityPredicate = () => boolean;
+/** Options for {@link timer}. */
 interface TimerOptions {
   when?: ActivityPredicate | readonly ActivityPredicate[];
 }
+/** {@link ActivityPredicate} that is true while the current route matches `pathOrPaths`. */
 declare function routeActive(pathOrPaths: string | readonly string[]): ActivityPredicate;
+/** {@link ActivityPredicate} that is true while the document is visible. */
 declare function documentVisible(): ActivityPredicate;
+/** {@link ActivityPredicate} that is true while the window has focus. */
 declare function windowFocused(): ActivityPredicate;
+/** An event target, or a function resolving one, accepted by {@link on}. */
 type ListenerTarget = EventTarget | (() => EventTarget | null | undefined);
 type ListenerOptions = boolean | AddEventListenerOptions | undefined;
+/** Attach an owned event listener to `target` for the current component's lifetime. */
 declare function on(target: ListenerTarget, event: string, handler: EventListener, options?: ListenerOptions): void;
+/** Run `fn` on an owned interval for the current component's lifetime, optionally gated by `options.when`. */
 declare function timer(intervalMs: number, fn: () => void, options?: TimerOptions): void;
 /** Runs an owned task after commit. */
 declare function task(fn: () => void | (() => void) | PromiseLike<void | (() => void)>): void;

package/dist/resources/index.js

@@ -1,9 +1,9 @@
-import { t as enqueueRuntimeLane } from "../access-DSkccuEI.js";
+import { t as enqueueRuntimeLane } from "../access-d_DCdwqn.js";
 import { f as getCurrentComponentInstance, g as getSignal, i as claimHookIndex } from "../component-scope-4I3yEMkb.js";
-import { a as registerCommitOperation } from "../component-internal-DlAkCgBE.js";
-import { t as resource } from "../resource-operation-CaAttQqz.js";
-import { a as task, i as routeActive, n as documentVisible, o as timer, r as on, s as windowFocused, t as capture } from "../lifecycle-operations-CQ8fsc94.js";
-import { n as onRouteChange } from "../activity-DodHdC0L.js";
+import { a as registerCommitOperation } from "../component-internal-DOVVMjG7.js";
+import { t as resource } from "../resource-operation-CLQXCn1p.js";
+import { a as task, i as routeActive, n as documentVisible, o as timer, r as on, s as windowFocused, t as capture } from "../lifecycle-operations-Qxq6ABrC.js";
+import { n as onRouteChange } from "../activity-BshyLB3_.js";
 //#region src/runtime/stream-operation.ts
 function toError(value) {
 	return value instanceof Error ? value : new Error(String(value));
@@ -205,6 +205,7 @@ function getStreamSlot(instance, index, source, options) {
 	slots[index] = slot;
 	return slot;
 }
+/** Subscribe to a streaming data source for the current component's lifetime, with auto reconnect/cleanup. */
 function stream(source, options = {}) {
 	const instance = getCurrentComponentInstance();
 	if (!instance) return createSnapshot(options);