@askrjs/askr 0.0.92 → 0.0.95

package/dist/{index-BnU0NPwM.d.ts → index-CzH-0LcA.d.ts}

@@ -1,17 +1,22 @@
 //#region src/foundations/utilities/event-types.d.ts
+/** Minimal shape of an event that can be prevented from its default action. */
 interface DefaultPreventable {
   defaultPrevented?: boolean;
   preventDefault?: () => void;
 }
+/** Minimal shape of an event whose propagation can be stopped. */
 interface PropagationStoppable {
   stopPropagation?: () => void;
 }
+/** Structural subset of a keyboard event, for handlers that accept native or synthetic events. */
 interface KeyboardLikeEvent extends DefaultPreventable, PropagationStoppable {
   key: string;
 }
+/** Structural subset of a pointer event, for handlers that accept native or synthetic events. */
 interface PointerLikeEvent extends DefaultPreventable, PropagationStoppable {
   target?: unknown;
 }
+/** Structural subset of a focus event, for handlers that accept native or synthetic events. */
 interface FocusLikeEvent extends DefaultPreventable, PropagationStoppable {
   relatedTarget?: unknown;
 }
@@ -42,6 +47,7 @@ interface FocusLikeEvent extends DefaultPreventable, PropagationStoppable {
  * 4. Type Safety
  *    Args are readonly to prevent mutation. Return type matches input.
  */
+/** Options for {@link composeHandlers}. */
 interface ComposeHandlersOptions {
   /**
    * When true (default), do not run the second handler if the first prevented default.
@@ -49,26 +55,38 @@ interface ComposeHandlersOptions {
    */
   checkDefaultPrevented?: boolean;
 }
+/**
+ * Compose two optional event handlers into one, running `first` then
+ * `second` unless `first` marked the event as default-prevented.
+ */
 declare function composeHandlers<A extends readonly unknown[]>(first?: (...args: A) => void, second?: (...args: A) => void, options?: ComposeHandlersOptions): (...args: A) => void;
 //#endregion
 //#region src/foundations/utilities/merge-props.d.ts
+/**
+ * Merge `base` props over `injected` props: non-handler keys in `base` win,
+ * and matching event handlers are composed (`injected` runs first).
+ */
 declare function mergeProps<TBase extends object, TInjected extends object>(base: TBase, injected: TInjected): TInjected & TBase;
 //#endregion
 //#region src/foundations/utilities/aria.d.ts
 /**
  * Tiny aria helpers
  */
+/** Build an `aria-disabled` prop object; omitted entirely when `disabled` is falsy. */
 declare function ariaDisabled(disabled?: boolean): {
   'aria-disabled'?: 'true';
 };
+/** Build an `aria-expanded` prop object; omitted when `expanded` is `undefined`. */
 declare function ariaExpanded(expanded?: boolean): {
   'aria-expanded'?: 'true' | 'false';
 };
+/** Build an `aria-selected` prop object; omitted when `selected` is `undefined`. */
 declare function ariaSelected(selected?: boolean): {
   'aria-selected'?: 'true' | 'false';
 };
 //#endregion
 //#region src/foundations/utilities/use-id.d.ts
+/** Options for {@link formatId}. */
 interface FormatIdOptions {
   /** Defaults to 'askr' */
   prefix?: string;

package/dist/{index-oswRaMn6.d.ts → index-S2IqSJib.d.ts}

@@ -1,5 +1,5 @@
-import { Tt as RenderableChild } from "./index-DA3g8lm8.js";
-import { r as JSXElement } from "./types-BA9FJtfR.js";
+import { rn as RenderableChild } from "./index-CTIBOqUB.js";
+import { r as JSXElement } from "./types-DkVJhVs9.js";
 //#region src/foundations/structures/layout.d.ts
 /**
  * Layout helper.
@@ -24,16 +24,24 @@ import { r as JSXElement } from "./types-BA9FJtfR.js";
  *    Props are spread into the layout component. This is intentional
  *    and deterministic — no merging or composition.
  */
+/** A component that receives its route children via `props.children`. */
 type LayoutComponent<P = object> = (props: P & {
   children?: RenderableChild;
 }) => unknown;
+/**
+ * Wrap a {@link LayoutComponent} so it can be invoked as `(children, props)`,
+ * matching route layout conventions.
+ */
 declare function layout<P = object>(Layout: LayoutComponent<P>): (children?: RenderableChild, props?: P) => unknown;
 //#endregion
 //#region src/jsx/utils.d.ts
+/** Check whether `value` is a JSX element vnode. */
 declare function isElement(value: unknown): value is JSXElement;
+/** Clone a JSX element, shallow-merging `props` over its existing props. */
 declare function cloneElement(element: JSXElement, props: Record<string, unknown>): JSXElement;
 //#endregion
 //#region src/foundations/structures/slot.d.ts
+/** Props for {@link Slot}: `asChild` selects prop-merging vs. fragment mode. */
 type SlotProps = {
   asChild: true;
   children: JSXElement;
@@ -65,7 +73,9 @@ type SlotProps = {
 declare function Slot(props: SlotProps): JSXElement | null;
 //#endregion
 //#region src/foundations/structures/presence.d.ts
+/** Props for {@link Presence}. */
 interface PresenceProps {
+  /** Whether the children should be mounted, or a function returning it. */
   present: boolean | (() => boolean);
   children?: RenderableChild;
 }
@@ -95,17 +105,28 @@ interface PresenceProps {
 declare function Presence({ present, children }: PresenceProps): JSXElement | null;
 //#endregion
 //#region src/runtime/portal.d.ts
+/**
+ * A named portal channel created by {@link definePortal}: call it as a
+ * component to render the host, and call `.render(props)` to write content.
+ */
 interface Portal<T extends RenderableChild = RenderableChild> {
   (): T | JSXElement | null | undefined;
   render(props: {
     children?: T;
   }): unknown;
 }
+/** Props for the {@link Portal} component. */
 interface PortalProps {
   children?: RenderableChild;
 }
+/** Create a new named {@link Portal} channel with its own host and content. */
 declare function definePortal<T extends RenderableChild = RenderableChild>(): Portal<T>;
+/**
+ * The implicit portal channel that {@link Portal} writes to and that any
+ * host rendered without an explicit portal falls back to.
+ */
 declare const DefaultPortal: Portal<RenderableChild>;
+/** Write children to the {@link DefaultPortal} host wherever it is rendered. */
 declare function Portal(props: PortalProps): JSXElement | null;
 //#endregion
 //#region src/foundations/structures/collection.d.ts
@@ -133,10 +154,12 @@ declare function Portal(props: PortalProps): JSXElement | null;
  *   const allItems = collection.items();
  *   unregister();
  */
+/** A registered node paired with its metadata inside a {@link Collection}. */
 type CollectionItem<TNode, TMetadata = unknown> = {
   node: TNode;
   metadata: TMetadata;
 };
+/** Ordered descendant registry returned by {@link createCollection}. */
 interface Collection<TNode, TMetadata = unknown> {
   /**
    * Register a node with optional metadata.
@@ -156,6 +179,7 @@ interface Collection<TNode, TMetadata = unknown> {
    */
   size(): number;
 }
+/** Create an empty, insertion-ordered {@link Collection} registry. */
 declare function createCollection<TNode, TMetadata = unknown>(): Collection<TNode, TMetadata>;
 /**
  * USAGE EXAMPLE:
@@ -207,6 +231,7 @@ declare function createCollection<TNode, TMetadata = unknown>(): Collection<TNod
  *   layer.isTop(); // true if this is the topmost layer
  *   layer.unregister();
  */
+/** Options for registering a layer with {@link LayerManager.register}. */
 interface LayerOptions {
   /**
    * Called when Escape is pressed and this is the top layer
@@ -221,6 +246,7 @@ interface LayerOptions {
    */
   node?: Node | null;
 }
+/** A registered layer entry returned by {@link LayerManager.register}. */
 interface Layer {
   /**
    * Unique layer ID
@@ -235,6 +261,7 @@ interface Layer {
    */
   unregister(): void;
 }
+/** Stacking coordinator returned by {@link createLayer}. */
 interface LayerManager {
   /**
    * Register a new layer
@@ -253,6 +280,7 @@ interface LayerManager {
    */
   handleOutsidePointer(e: PointerEvent): void;
 }
+/** Create a new, empty {@link LayerManager} for coordinating overlay stacking. */
 declare function createLayer(): LayerManager;
 /**
  * USAGE EXAMPLE:

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-CTIBOqUB.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 { d as configureRenderDiagnostics, p as defineScope, y as readScope } from "./component-internal-D0yE2Ch3.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 { 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 { t as installRendererBridge } from "./renderer-tXX_xj86.js";
+import { n as cspNonce, t as CspNonceScope } from "./csp-nonce-BVybpV1v.js";
+import { i as For, n as Match, r as Show, t as Case } from "./control-C0klPV7Q.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-Bm8L6JOm.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-CBzG5PyB.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-D0yE2Ch3.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-BbWj-QU-.js → navigate-DChM5m8m.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-D0yE2Ch3.js";
+import { t as cleanupReadableSubscriptionSources } from "./readable-BsdGWsDE.js";
+import { n as cleanupComponentGeneration, t as cleanupComponent } from "./component-cleanup-DYG80yhG.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-D7uN-Z1s.js";
+import { t as CspNonceScope } from "./csp-nonce-BVybpV1v.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-BQyo7qNn.js";
+import { a as clearStagedAppRenderRouteLocation, i as syncCurrentRouteSnapshot, o as createAppRenderRuntime, s as stageAppRenderRouteLocation } from "./activity-d4t3CdzK.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/{navigate-CZHPEUC4.d.ts → navigate-eGm4omPj.d.ts}

@@ -1,13 +1,17 @@
-import "./index-DA3g8lm8.js";
+import "./index-CTIBOqUB.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/{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-tXX_xj86.js}

@@ -1,45 +1,18 @@
 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 { S as withContext, c as createBoundaryReset, g as getVNodeContextFrame, i as mountInstanceInline, l as reportBoundaryError, m as getCurrentContextFrame, n as createComponentInstance, o as renderComponentInline, t as captureInlineRenderSnapshot, v as markVNodeTreeWithContextFrame } from "./component-internal-D0yE2Ch3.js";
+import { t as cleanupComponent } from "./component-cleanup-DYG80yhG.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-DkBwTG4S.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-D7uN-Z1s.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-BVybpV1v.js";
 import { a as isSSRPortalHydrationAnchor } from "./portal-w3oQ6oQU.js";
-//#region src/runtime/error-boundary.ts
-function createBoundaryReset(instance) {
-	return () => {
-		const boundaryState = instance.errorBoundaryState;
-		if (!boundaryState) return;
-		boundaryState.error = null;
-		boundaryState.notified = false;
-		queueMicrotask(() => {
-			instance._enqueueRun?.();
-		});
-	};
-}
-function reportBoundaryError(instance, error, onError) {
-	const boundaryState = instance.errorBoundaryState;
-	if (boundaryState && Object.is(boundaryState.error, error) && boundaryState.notified) return;
-	if (boundaryState) {
-		boundaryState.error = error;
-		boundaryState.notified = true;
-	}
-	try {
-		onError?.(error);
-	} catch (hookError) {
-		logger.error("[Askr] ErrorBoundary onError handler threw:", hookError);
-	}
-	logger.error("[Askr] ErrorBoundary caught render error:", error);
-}
-//#endregion
 //#region src/renderer/utils.ts
 /**
 * Shared utilities for the renderer module.