@askrjs/askr 0.0.92 → 0.0.95

package/dist/{resolution-B21kmOkp.js → resolution-BQyo7qNn.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 { p as defineScope, y as readScope } from "./component-internal-D0yE2Ch3.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-BVybpV1v.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-B62UQKHV.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 { m as getCurrentContextFrame, u as registerCommitOperationForInstance, x as withAsyncResourceContext } from "./component-internal-D0yE2Ch3.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-CTIBOqUB.js";
+import { i as onRouteChange, n as RouteChangeOptions, t as RouteChangeCleanup } from "../activity-D_5x2HXQ.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-D0yE2Ch3.js";
+import { t as resource } from "../resource-operation-B62UQKHV.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-CBzG5PyB.js";
+import { n as onRouteChange } from "../activity-d4t3CdzK.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);

package/dist/router/index.d.ts

@@ -1,14 +1,19 @@
-import { $ as RouteHandler, B as AccessRedirectStatus, F as AccessAllowDecision, G as ParsedSegment, H as LayoutScopeRecord, I as AccessDecision, J as RouteAuthResolver, K as Route, L as AccessDenyDecision, Q as RouteDestination, R as AccessDenyStatus, Tt as RenderableChild, U as PageHelperOptions, V as GroupHelperOptions, W as PageScopeRecord, X as RouteContext, Y as RouteComponent, Z as RouteDefinition, _t as RouteRequestResult, at as RouteOptions, bt as RouteSnapshot, ct as RoutePolicy, dt as RouteRef, et as RouteManifest, ft as RouteRefSearch, gt as RouteRequestOptions, ht as RouteRenderResult, it as RouteMode, lt as RouteQuery, mt as RouteRegistryOptions, nt as RouteMeta, ot as RouteParams, pt as RouteRegistry, q as RouteAuthOptions, rt as RouteMetaSource, st as RoutePathParams, tt as RouteMatch, ut as RouteRecord, vt as RouteSearch, yt as RouteSearchValue, z as AccessRedirectDecision } from "../index-DA3g8lm8.js";
-import { r as JSXElement, s as Props } from "../types-BA9FJtfR.js";
-import { a as ScrollRestorationOptions, i as NavigationScrollBehavior, n as NavigateOptions, r as HistoryScrollBehavior, t as navigate } from "../navigate-CZHPEUC4.js";
-import { i as onRouteChange, n as RouteChangeOptions, r as currentRoute, t as RouteChangeCleanup } from "../activity-DxUcygE5.js";
+import { $ as AccessDecision, At as RouteRegistry, Ct as RouteParams, Dt as RouteRecord, Et as RouteQuery, Ft as RouteSearch, It as RouteSearchValue, Lt as RouteSnapshot, Mt as RouteRenderResult, Nt as RouteRequestOptions, Ot as RouteRef, Pt as RouteRequestResult, Q as AccessAllowDecision, St as RouteOptions, Tt as RoutePolicy, _t as RouteManifest, at as LayoutScopeRecord, bt as RouteMetaSource, ct as ParsedSegment, dt as RouteAuthResolver, et as AccessDenyDecision, ft as RouteComponent, gt as RouteHandler, ht as RouteDestination, it as GroupHelperOptions, jt as RouteRegistryOptions, kt as RouteRefSearch, lt as Route, mt as RouteDefinition, nt as AccessRedirectDecision, ot as PageHelperOptions, pt as RouteContext, rn as RenderableChild, rt as AccessRedirectStatus, st as PageScopeRecord, tt as AccessDenyStatus, ut as RouteAuthOptions, vt as RouteMatch, wt as RoutePathParams, xt as RouteMode, yt as RouteMeta } from "../index-CTIBOqUB.js";
+import { r as JSXElement, s as Props } from "../types-DkVJhVs9.js";
+import { a as ScrollRestorationOptions, i as NavigationScrollBehavior, n as NavigateOptions, r as HistoryScrollBehavior, t as navigate } from "../navigate-eGm4omPj.js";
+import { i as onRouteChange, n as RouteChangeOptions, r as currentRoute, t as RouteChangeCleanup } from "../activity-D_5x2HXQ.js";
 import { AuthContext, AuthContext as AuthContext$1, AuthRequirement, AuthRequirement as AuthRequirement$1 } from "@askrjs/auth";
 import { ObjectSchema } from "@askrjs/schema";
 //#region src/router/route-query.d.ts
+/** A single query-string value accepted by {@link updateRouteQuery}. */
 type RouteQueryParamValue = string | number | boolean | null | undefined;
+/** A query-string value, or an array of them for a repeated param. */
 type RouteQueryParamInput = RouteQueryParamValue | readonly RouteQueryParamValue[];
+/** A map of query param updates for {@link updateRouteQuery}; `null`/`undefined` removes the key. */
 type RouteQueryUpdates = Record<string, RouteQueryParamInput>;
+/** A function that mutates a `URLSearchParams` directly, for {@link updateRouteQuery}. */
 type RouteQueryUpdater = (searchParams: URLSearchParams) => void;
+/** Options for {@link updateRouteQuery}. */
 type UpdateRouteQueryOptions = {
   /**
    * Defaults to replace so high-frequency controls such as search inputs do not
@@ -28,13 +33,21 @@ type CompatibleAbsoluteRouteComponent<Path extends string, TComponent extends An
 type CompatibleRelativeRouteComponent<Path extends string, TComponent extends AnyRouteComponent> = Parameters<TComponent> extends [] ? TComponent : RouteComponentParam<TComponent> extends Record<keyof RoutePathParams<Path>, string> ? TComponent : never;
 type CompatibleRouteComponent<Path extends string, TComponent extends AnyRouteComponent> = Path extends `/${string}` ? CompatibleAbsoluteRouteComponent<Path, TComponent> : CompatibleRelativeRouteComponent<Path, TComponent>;
 type RouteOptionsForComponent<Path extends string, TComponent extends AnyRouteComponent, TSearchSchema extends ObjectSchema<RouteSearch> | undefined = ObjectSchema<RouteSearch> | undefined, TLoaderData = unknown, TDehydratedData = TLoaderData> = Parameters<TComponent> extends [] ? RouteOptions<RoutePathParams<Path>, TSearchSchema, TLoaderData, TDehydratedData> : RouteComponentParam<TComponent> extends RouteParams ? RouteOptions<RouteComponentParam<TComponent>, TSearchSchema, TLoaderData, TDehydratedData> : RouteOptions<RoutePathParams<Path>, TSearchSchema, TLoaderData, TDehydratedData>;
+/** Declare a group of routes sharing `options` (auth, policies, layout, meta). */
 declare function group(options: GroupHelperOptions, fn: RouteDefinition): void;
+/**
+ * Declare a route page at `path`, nesting a sub-scope for `index`/`page`/`fallback`
+ * declarations and options like `preload`/`meta`/`auth`.
+ */
 declare function page<const TPath extends string>(path: TPath, Component: RouteComponent<RoutePathParams<TPath>>, fn: RouteDefinition): void;
 declare function page<const TPath extends string, TComponent extends AnyRouteComponent>(path: TPath, Component: CompatibleRouteComponent<TPath, TComponent>, fn: RouteDefinition): void;
 declare function page<const TPath extends string>(path: TPath, Component: RouteComponent<RoutePathParams<TPath>>, options: PageHelperOptions, fn: RouteDefinition): void;
 declare function page<const TPath extends string, TComponent extends AnyRouteComponent>(path: TPath, Component: CompatibleRouteComponent<TPath, TComponent>, options: PageHelperOptions, fn: RouteDefinition): void;
+/** Declare the index route for the enclosing `page()` scope. */
 declare function index(Component: RouteComponent, options?: RouteOptions): void;
+/** Declare the catch-all `/*` fallback route for the enclosing scope. */
 declare function fallback(Component: RouteComponent): void;
+/** Declare a route at `path` rendering `Component`, returning a typed {@link RouteRef} for building destinations. */
 declare function route<const TPath extends string, const TSearchSchema extends ObjectSchema<RouteSearch> | undefined = undefined, TLoaderData = unknown, TDehydratedData = TLoaderData>(path: TPath, Component: RouteComponent<RoutePathParams<TPath>>, options?: RouteOptions<RoutePathParams<TPath>, TSearchSchema, TLoaderData, TDehydratedData>): RouteRef<RoutePathParams<TPath>, RouteRefSearch<TSearchSchema>>;
 declare function route<const TPath extends string, TComponent extends AnyRouteComponent, const TSearchSchema extends ObjectSchema<RouteSearch> | undefined = undefined, TLoaderData = unknown, TDehydratedData = TLoaderData>(path: TPath, Component: CompatibleRouteComponent<TPath, TComponent>, options?: RouteOptionsForComponent<TPath, TComponent, TSearchSchema, TLoaderData, TDehydratedData>): RouteRef<RoutePathParams<TPath>, RouteRefSearch<TSearchSchema>>;
 //#endregion
@@ -43,20 +56,28 @@ declare function route<const TPath extends string, TComponent extends AnyRouteCo
 declare function currentAuth(): AuthContext$1;
 //#endregion
 //#region src/router/resolution.d.ts
+/** Resolve `target` against a route registry, applying auth/policies to produce a render/redirect/deny result. */
 declare function resolveRouteRequest(target: string, options: RouteRequestOptions): RouteRequestResult | Promise<RouteRequestResult>;
 //#endregion
 //#region src/router/manifest.d.ts
+/**
+ * Run `definition` to declare routes (via `route`/`page`/`group`/`fallback`)
+ * and build a {@link RouteRegistry} to pass to `createSPA`/`hydrateSPA`.
+ */
 declare function createRouteRegistry(definition: RouteDefinition, options?: RouteRegistryOptions): RouteRegistry;
 //#endregion
 //#region src/router/lazy.d.ts
+/** A route component loaded on demand via {@link lazy}, with an explicit `preload()`. */
 type LazyRouteComponent<TComponent extends AnyRouteComponent> = TComponent & {
   preload(): Promise<void>;
 };
+/** A route data loader loaded on demand via {@link lazyRouteData}, with an explicit `preload()`. */
 type LazyRouteDataLoader<TModule, TData = TModule> = ((context: RouteContext & {
   request?: Request;
 }) => Promise<TData>) & {
   preload(): Promise<void>;
 };
+/** Wrap a dynamic-import factory as a {@link LazyRouteComponent}, loaded on first use. */
 declare function lazy<TComponent extends AnyRouteComponent>(factory: () => Promise<{
   default: TComponent;
 } | TComponent>): LazyRouteComponent<TComponent>;
@@ -69,10 +90,13 @@ declare function lazyRouteData<TModule, TData = TModule>(factory: () => PromiseL
 }) => TData | PromiseLike<TData>): LazyRouteDataLoader<TModule, TData>;
 //#endregion
 //#region src/router/rendering.d.ts
+/** Renders the nested route content for the enclosing layout or page scope. */
 declare function Outlet(): JSXElement;
 //#endregion
 //#region src/router/route-data-loader.d.ts
+/** Which environment a route's data loader ran (or failed) in. */
 type RouteDataLoadPhase = 'client' | 'server' | 'ssg';
+/** Thrown when a route's `loader` rejects; wraps the original `cause`. */
 declare class RouteDataLoadError extends Error {
   readonly route: string;
   readonly phase: RouteDataLoadPhase;
@@ -81,28 +105,39 @@ declare class RouteDataLoadError extends Error {
 }
 //#endregion
 //#region src/router/policy.d.ts
+/** Policy decision: allow the route to render. */
 declare function allow(): AccessAllowDecision;
+/** Policy decision: redirect the visitor to `to`. */
 declare function redirect(to: string, init?: {
   status?: AccessRedirectStatus;
   replace?: boolean;
 }): AccessRedirectDecision;
+/** Policy decision: deny the request with the given HTTP status. */
 declare function deny(status: AccessDenyStatus): AccessDenyDecision;
+/** Policy decision: deny with 401 Unauthorized. */
 declare function unauthorized(): AccessDenyDecision;
+/** Policy decision: deny with 403 Forbidden. */
 declare function forbidden(): AccessDenyDecision;
+/** Policy decision: deny with 404 Not Found. */
 declare function notFound(): AccessDenyDecision;
 //#endregion
 //#region src/router/destination.d.ts
+/** Build a {@link RouteDestination} (with a computed `href`) for a {@link RouteRef} and params/search. */
 declare function to$1<TParams extends RouteParams, TSearch extends RouteSearch = RouteSearch>(route: RouteRef<TParams, TSearch>, params: TParams, search?: TSearch): RouteDestination;
 //#endregion
 //#region src/router/metadata.d.ts
+/** Resolve a route's merged {@link RouteMeta} by running its metadata chain against `context`. */
 declare function resolveRouteMeta(record: RouteRecord, context: RouteContext): Promise<Readonly<RouteMeta>>;
 /** Replace only Askr-owned head nodes after a successful client navigation. */
 declare function reconcileRouteMeta(meta: Readonly<RouteMeta>, target?: Document): void;
+/** Render a {@link RouteMeta} to the `<title>`/`<meta>`/`<link>`/JSON-LD markup for the document `<head>`. */
 declare function serializeRouteMeta(meta: RouteMeta): string;
 //#endregion
 //#region src/common/deferred-value.d.ts
 declare const DEFERRED_VALUE: unique symbol;
+/** Lifecycle state of a {@link Deferred} value. */
 type DeferredState = 'pending' | 'fulfilled' | 'rejected';
+/** A promise-backed value that can be read synchronously once settled, produced by {@link defer}. */
 interface Deferred<T> {
   readonly state: DeferredState;
   readonly value: T | undefined;
@@ -110,18 +145,24 @@ interface Deferred<T> {
   readonly promise: Promise<T>;
   readonly [DEFERRED_VALUE]: true;
 }
+/** Wrap a promise as a {@link Deferred} value that tracks its settled state and result. */
 declare function defer<T>(promise: PromiseLike<T>): Deferred<T>;
+/** Check whether `value` is a {@link Deferred} produced by {@link defer}. */
 declare function isDeferred<T = unknown>(value: unknown): value is Deferred<T>;
 //#endregion
 //#region src/router/deferred.d.ts
+/** Props for {@link Resolve}. */
 interface ResolveProps<T> {
   value: Deferred<T>;
   pending?: RenderableChild;
   rejected?: RenderableChild | ((error: unknown) => RenderableChild);
   children: (value: T) => RenderableChild;
 }
+/** Recursively await any {@link Deferred} values nested within `input`, returning it once fully resolved. */
 declare function resolveDeferredValues<T>(input: T, signal?: AbortSignal): Promise<T>;
+/** Read the current route's server loader data during render or hydration. */
 declare function routeData<T>(): T;
+/** Render a {@link Deferred} value's fulfilled state, a pending placeholder, or a rejected fallback. */
 declare function Resolve<T>(props: ResolveProps<T>): JSXElement;
 //#endregion
 //#region src/components/link.d.ts
@@ -150,6 +191,7 @@ type LinkBaseProps = Omit<Props, 'children' | 'href' | 'class' | 'rel' | 'target
   onPress?: (event: Event) => void;
   onClick?: (event: MouseEvent) => void;
 };
+/** Props for {@link Link}: either a raw `href` or a typed route `to` destination. */
 type LinkProps = LinkBaseProps & ({
   href: string;
   to?: never;

package/dist/router/index.js

@@ -1,13 +1,13 @@
-import { n as createRouteRegistry } from "../manifest-Dv0bO6kg.js";
-import { a as isSafeHref } from "../csp-nonce-ByMbWv8s.js";
+import { n as createRouteRegistry } from "../manifest-D6rfj_jC.js";
+import { a as isSafeHref } from "../csp-nonce-BVybpV1v.js";
 import { jsx } from "../jsx-runtime.js";
 import { o as addRouteBasePath, y as getActiveRouteBasePath } from "../route-matching-Bo6UqG-5.js";
-import { a as group, c as route, i as fallback, n as resolveDeferredValues, o as index, r as routeData, s as page, t as Resolve } from "../deferred-B6CafO5u.js";
-import { S as RouteDataLoadError, a as resolveRouteRequest, b as lazy, f as defer, g as Outlet, h as currentAuth, p as isDeferred, x as lazyRouteData } from "../resolution-B21kmOkp.js";
-import { n as onRouteChange, t as currentRoute } from "../activity-DodHdC0L.js";
-import { a as serializeRouteMeta, c as getCurrentHref, d as parseTargetUrl, h as syncRegisteredRouteSnapshot, i as resolveRouteMeta, l as getRegisteredAppsSnapshot, m as syncAppRegistrationLocation, n as navigate, p as setCurrentRouteLocation, r as reconcileRouteMeta, s as saveScrollPosition, u as getWindowHref } from "../navigate-BbWj-QU-.js";
-import { o as mergeProps } from "../compose-ref-Cc_YkUpM.js";
-import { t as applyInteractionPolicy } from "../interactions-CWkNEq_C.js";
+import { a as group, c as route, i as fallback, n as resolveDeferredValues, o as index, r as routeData, s as page, t as Resolve } from "../deferred-p8hyanxJ.js";
+import { S as RouteDataLoadError, a as resolveRouteRequest, b as lazy, f as defer, g as Outlet, h as currentAuth, p as isDeferred, x as lazyRouteData } from "../resolution-BQyo7qNn.js";
+import { n as onRouteChange, t as currentRoute } from "../activity-d4t3CdzK.js";
+import { a as serializeRouteMeta, c as getCurrentHref, d as parseTargetUrl, h as syncRegisteredRouteSnapshot, i as resolveRouteMeta, l as getRegisteredAppsSnapshot, m as syncAppRegistrationLocation, n as navigate, p as setCurrentRouteLocation, r as reconcileRouteMeta, s as saveScrollPosition, u as getWindowHref } from "../navigate-DChM5m8m.js";
+import { o as mergeProps } from "../compose-ref-1Fhs7mbF.js";
+import { t as applyInteractionPolicy } from "../interactions-B4XaFxt1.js";
 //#region src/router/route-query.ts
 function getRouteQueryHistoryMode(options) {
 	if (options.history) return options.history;
@@ -51,9 +51,11 @@ function updateRouteQuery(updates, options = {}) {
 }
 //#endregion
 //#region src/router/policy.ts
+/** Policy decision: allow the route to render. */
 function allow() {
 	return { kind: "allow" };
 }
+/** Policy decision: redirect the visitor to `to`. */
 function redirect(to, init = {}) {
 	return {
 		kind: "redirect",
@@ -62,18 +64,22 @@ function redirect(to, init = {}) {
 		...init.replace !== void 0 ? { replace: init.replace } : {}
 	};
 }
+/** Policy decision: deny the request with the given HTTP status. */
 function deny(status) {
 	return {
 		kind: "deny",
 		status
 	};
 }
+/** Policy decision: deny with 401 Unauthorized. */
 function unauthorized() {
 	return deny(401);
 }
+/** Policy decision: deny with 403 Forbidden. */
 function forbidden() {
 	return deny(403);
 }
+/** Policy decision: deny with 404 Not Found. */
 function notFound() {
 	return deny(404);
 }
@@ -117,6 +123,7 @@ function appendSearchValue(query, key, value) {
 function formatSearchIssues(issues) {
 	return issues.map((issue) => `${issue.path.length ? issue.path.join(".") : "search"}: ${issue.message}`).join("; ");
 }
+/** Build a {@link RouteDestination} (with a computed `href`) for a {@link RouteRef} and params/search. */
 function to(route, params, search) {
 	const path = addRouteBasePath(buildPath(route, params), route.basePath ?? "");
 	const parsedSearch = route.searchSchema?.safeParse(search ?? {});

package/dist/{selector-BLWwI55m.js → selector-CyK-sDwB.js}

@@ -1,6 +1,6 @@
-import { t as enqueueRuntimeLane } from "./access-DSkccuEI.js";
+import { t as enqueueRuntimeLane } from "./access-d_DCdwqn.js";
 import { i as claimHookIndex, p as getCurrentInstance } from "./component-scope-4I3yEMkb.js";
-import { c as markReadableUsage, 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 { c as markReadableUsage, 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";
 //#region src/runtime/selector-store.ts
 const dirtySelectorRecords = /* @__PURE__ */ new Set();
 let hasPendingSelectorFlush = false;
@@ -170,8 +170,8 @@ function notifySelectorLaneValueChange(lane, prevValue, nextValue) {
 	}
 }
 function recomputeSelectorSourceRecord(record, notifyDownstream) {
-	if (!record._dirty && record._hasValue) return record._value;
 	if (record._evaluating) throw new Error("selector() cannot read itself recursively");
+	if (!record._dirty && record._hasValue) return record._value;
 	record._evaluating = true;
 	record._dirty = false;
 	record._pendingDependencySources = /* @__PURE__ */ new Set();
@@ -236,6 +236,7 @@ function createSelectorHook(instance, generation, store, hookIndex, source, equa
 		if (!lane) throw new Error("selector() binding could not be established.");
 		const sourceRef = getCandidateSource(lane, candidate);
 		recordReadableRead(sourceRef);
+		if (record._evaluating) throw new Error("selector() cannot read itself recursively");
 		const current = record._dirty || !record._hasValue ? recomputeSelectorSourceRecord(record, record._scheduled) : record._value;
 		return lane._equals(current, candidate);
 	};

package/dist/ssg/index.d.ts

@@ -1,9 +1,12 @@
-import { $ as RouteHandler, Dt as DocumentRenderArgs, Mt as SSRStyleRegistrationValidation, Ot as DocumentRenderContext, at as RouteOptions, ct as RoutePolicy, kt as DocumentRenderer, pt as RouteRegistry, st as RoutePathParams } from "../index-DA3g8lm8.js";
+import { At as RouteRegistry, St as RouteOptions, Tt as RoutePolicy, an as DocumentRenderArgs, gt as RouteHandler, on as DocumentRenderContext, sn as DocumentRenderer, un as SSRStyleRegistrationValidation, wt as RoutePathParams } from "../index-CTIBOqUB.js";
 import { AuthRequirement } from "@askrjs/auth";
 import "node:fs/promises";
 //#region src/ssg/types.d.ts
+/** Whether an SSG run rebuilds every route (`full`) or only changed ones (`incremental`). */
 type SSGMode = 'full' | 'incremental';
+/** Outcome of generating a single route's static HTML. */
 type RouteRenderStatus = 'success' | 'error' | 'skipped' | 'removed';
+/** Why a route was rendered, skipped, or removed during generation. */
 type RouteRenderReason = 'full' | 'changed-key' | 'changed-route' | 'new-route' | 'no-keys' | 'unchanged' | 'deleted' | 'runtime-only';
 type RouteConfigParams<Path extends string> = string extends Path ? Record<string, string> : RoutePathParams<Path>;
 /**
@@ -66,6 +69,7 @@ interface SSGBaseOptions {
   /** Preferred render parallelism. `'auto'` resolves from the host machine. */
   parallelism?: number | 'auto';
 }
+/** A static file or directory to copy alongside generated routes. */
 interface SSGAssetSource {
   /** Source file or directory. Relative paths resolve from the current working directory. */
   from: string;

package/dist/ssg/index.js

@@ -1,10 +1,10 @@
-import "../access-DSkccuEI.js";
-import { n as createRouteRegistry } from "../manifest-Dv0bO6kg.js";
+import "../access-d_DCdwqn.js";
+import { n as createRouteRegistry } from "../manifest-D6rfj_jC.js";
 import { o as addRouteBasePath } from "../route-matching-Bo6UqG-5.js";
-import { c as route, n as resolveDeferredValues } from "../deferred-B6CafO5u.js";
-import { S as RouteDataLoadError, c as prepareRouteHydrationData, t as bindResolvedRouteData, v as getRenderHandler, y as _preloadRouteHandler } from "../resolution-B21kmOkp.js";
+import { c as route, n as resolveDeferredValues } from "../deferred-p8hyanxJ.js";
+import { S as RouteDataLoadError, c as prepareRouteHydrationData, t as bindResolvedRouteData, v as getRenderHandler, y as _preloadRouteHandler } from "../resolution-BQyo7qNn.js";
 import { n as renderDocument } from "../ssr-DSHd_Q9K.js";
-import { n as renderToString } from "../ssr-CaZfvQWn.js";
+import { n as renderToString } from "../ssr-DYcK20IX.js";
 import * as fs from "node:fs/promises";
 import * as pathModule from "node:path";
 import * as os from "node:os";

package/dist/ssr/index.d.ts

@@ -1,6 +1,5 @@
-import { $ as RouteHandler, At as SSRData, Dt as DocumentRenderArgs, K as Route, L as AccessDenyDecision, Mt as SSRStyleRegistrationValidation, Ot as DocumentRenderContext, _t as RouteRequestResult, jt as SSRStyleRegistration, kt as DocumentRenderer, l as DeferredBoundaryRegistration, pt as RouteRegistry, q as RouteAuthOptions, u as SSRPortalState, ut as RouteRecord, z as AccessRedirectDecision } from "../index-DA3g8lm8.js";
-import { r as JSXElement, s as Props } from "../types-BA9FJtfR.js";
-import { O as QueryPrefetchContext, _ as CoreTelemetry, n as ServerQueryRegistry, v as DataRuntime } from "../index-2bk8nldG.js";
+import { At as RouteRegistry, Dt as RouteRecord, E as SSRPortalState, Pt as RouteRequestResult, Rt as CoreTelemetry, T as DeferredBoundaryRegistration, Yt as QueryPrefetchContext, an as DocumentRenderArgs, c as ServerQueryRegistry, cn as SSRData, et as AccessDenyDecision, gt as RouteHandler, ln as SSRStyleRegistration, lt as Route, nt as AccessRedirectDecision, on as DocumentRenderContext, sn as DocumentRenderer, un as SSRStyleRegistrationValidation, ut as RouteAuthOptions, zt as DataRuntime } from "../index-CTIBOqUB.js";
+import { r as JSXElement, s as Props } from "../types-DkVJhVs9.js";
 import { AuthContext } from "@askrjs/auth";
 //#region src/common/page-render-envelope.d.ts
 declare const PAGE_RENDER_ENVELOPE_VERSION: 1;
@@ -45,6 +44,7 @@ interface RenderContext {
   ssrPortals: SSRPortalState;
   cspNonce?: string;
 }
+/** Build a fresh SSR render context (data cache, routes, seed) for a render pass. */
 declare function createRenderContext(seed?: number, opts?: {
   url?: string;
   data?: SSRData;
@@ -65,6 +65,7 @@ declare function createRenderContext(seed?: number, opts?: {
  * Concurrency-safe in Node.js via AsyncLocalStorage.
  */
 declare function withRenderContext<T>(ctx: RenderContext, fn: () => T): T;
+/** Run `fn` with `ctx` as the active SSR render context, using async-local storage. */
 declare function withRenderContextAsync<T>(ctx: RenderContext, fn: () => T | PromiseLike<T>): Promise<T>;
 /**
  * Get the current render context.
@@ -73,6 +74,7 @@ declare function withRenderContextAsync<T>(ctx: RenderContext, fn: () => T | Pro
 declare function getRenderContext(): RenderContext | null;
 //#endregion
 //#region src/ssr/route-render.d.ts
+/** A single path-to-handler route binding accepted by low-level SSR route rendering. */
 type SSRRoute = {
   path: string;
   handler: RouteHandler;
@@ -100,6 +102,7 @@ type RouteStreamOptions = RouteRenderOptions & {
   onChunk(html: string): void;
   onComplete(): void;
 };
+/** Resolve a URL against a route registry for SSR, applying auth/policies before render. */
 declare function resolveRequest(opts: {
   url: string;
   registry: RouteRegistry;
@@ -127,6 +130,7 @@ type SSRComponent = (props: Props, context?: {
 }) => VNode | JSXElement | string | number | boolean | null | undefined;
 //#endregion
 //#region src/ssr/render-sync.d.ts
+/** Synchronously render a component to an HTML string, without route resolution. */
 declare function renderToStringSync(component: (props?: Record<string, unknown>) => VNode | JSXElement | string | number | boolean | null | undefined, props?: Record<string, unknown>, options?: {
   seed?: number;
   data?: SSRData;
@@ -138,6 +142,7 @@ declare function renderToStringSync(component: (props?: Record<string, unknown>)
 }): string;
 //#endregion
 //#region src/ssr/render-resolved.d.ts
+/** Synchronously render an already-resolved route handler to an HTML string. */
 declare function renderResolvedToStringSync(opts: {
   url: string;
   registry: RouteRegistry;
@@ -153,6 +158,7 @@ declare function renderResolvedToStringSync(opts: {
 }): string;
 //#endregion
 //#region src/ssr/route-request-render.d.ts
+/** Options for {@link renderRouteRequest} and {@link renderRouteRequestToString}. */
 interface RenderRouteRequestOptions {
   url: string;
   registry: RouteRegistry;
@@ -170,6 +176,7 @@ interface RenderRouteRequestOptions {
   telemetry?: CoreTelemetry;
   cspNonce?: string;
 }
+/** Outcome of rendering a route request for SSR: a render, redirect, deny, or no-match. */
 type RenderRouteRequestResult = {
   kind: 'render';
   html: string;
@@ -180,12 +187,18 @@ type RenderRouteRequestResult = {
 } | AccessRedirectDecision | AccessDenyDecision | {
   kind: 'no-match';
 };
+/** Resolve and render a route request for SSR, streaming the body when possible. */
 declare function renderRouteRequest(options: RenderRouteRequestOptions): Promise<RenderRouteRequestResult>;
+/** Resolve and render a route request for SSR, always fully buffering the HTML. */
 declare function renderRouteRequestToString(options: RenderRouteRequestOptions): Promise<RenderRouteRequestResult>;
 //#endregion
 //#region src/ssr/index-internal.d.ts
+/**
+ * Render a component or route request to a complete HTML string, synchronously.
+ */
 declare function renderToString(component: (props?: Record<string, unknown>) => VNode | JSXElement | string | number | null): string;
 declare function renderToString(opts: RouteRenderOptions): string;
+/** Stream a route request's rendered HTML to the response sink described by `opts`. */
 declare function renderToStream(opts: RouteStreamOptions): void;
 //#endregion
 export { type DocumentRenderArgs, type DocumentRenderContext, type DocumentRenderer, type RenderRouteRequestOptions, type RenderRouteRequestResult, type SSRComponent, SSRDataMissingError, type SSRRoute, type SSRStyleRegistration, type SSRStyleRegistrationValidation, type VNode, createRenderContext, getRenderContext, renderResolvedToStringSync, renderRouteRequest, renderRouteRequestToString, renderToStream, renderToString, renderToStringSync, resolveRequest, withRenderContext, withRenderContextAsync };

package/dist/ssr/index.js

@@ -1,3 +1,3 @@
 import { C as SSRDataMissingError } from "../render-context-B7ohlh6t.js";
-import { a as renderResolvedToStringSync, c as createRenderContext, d as withRenderContextAsync, i as renderRouteRequestToString, l as getRenderContext, n as renderToString, o as renderToStringSync, r as renderRouteRequest, s as resolveRequest, t as renderToStream, u as withRenderContext } from "../ssr-CaZfvQWn.js";
+import { a as renderResolvedToStringSync, c as createRenderContext, d as withRenderContextAsync, i as renderRouteRequestToString, l as getRenderContext, n as renderToString, o as renderToStringSync, r as renderRouteRequest, s as resolveRequest, t as renderToStream, u as withRenderContext } from "../ssr-DYcK20IX.js";
 export { SSRDataMissingError, createRenderContext, getRenderContext, renderResolvedToStringSync, renderRouteRequest, renderRouteRequestToString, renderToStream, renderToString, renderToStringSync, resolveRequest, withRenderContext, withRenderContextAsync };