@askrjs/askr 0.0.92 → 0.0.94

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-KQ7Vl4-8.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-BL_FIIJ6.js";
+import { i as onRouteChange, n as RouteChangeOptions, r as currentRoute, t as RouteChangeCleanup } from "../activity-CJIQyo5X.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-BBxq1zq4.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-BS0Xpstg.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-D8PgnTzh.js";
+import { n as onRouteChange, t as currentRoute } from "../activity-BshyLB3_.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-CECCMPAr.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-KQ7Vl4-8.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-BS0Xpstg.js";
+import { S as RouteDataLoadError, c as prepareRouteHydrationData, t as bindResolvedRouteData, v as getRenderHandler, y as _preloadRouteHandler } from "../resolution-D8PgnTzh.js";
 import { n as renderDocument } from "../ssr-DSHd_Q9K.js";
-import { n as renderToString } from "../ssr-CaZfvQWn.js";
+import { n as renderToString } from "../ssr-8_vHDWqV.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-KQ7Vl4-8.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-8_vHDWqV.js";
 export { SSRDataMissingError, createRenderContext, getRenderContext, renderResolvedToStringSync, renderRouteRequest, renderRouteRequestToString, renderToStream, renderToString, renderToStringSync, resolveRequest, withRenderContext, withRenderContextAsync };

package/dist/{ssr-CaZfvQWn.js → ssr-8_vHDWqV.js}

@@ -1,20 +1,20 @@
 import { t as __CONTROL_BOUNDARY__ } from "./control-C-ApnFs1.js";
 import { t as __ERROR_BOUNDARY__ } from "./vnode-D24p6IW2.js";
-import { y as logger } from "./access-DSkccuEI.js";
+import { y as logger } from "./access-d_DCdwqn.js";
 import { f as getCurrentComponentInstance, w as setCurrentComponentInstance } from "./component-scope-4I3yEMkb.js";
-import { i as isFragmentType, n as Fragment, t as ELEMENT_TYPE } from "./jsx-C3IECePB.js";
-import { g as markVNodeTreeWithContextFrame, m as getVNodeContextFrame, n as createComponentInstance, p as getExecutionContextFrame, u as callWithContext } from "./component-internal-DlAkCgBE.js";
-import { t as cleanupComponent } from "./component-cleanup-CJCfu5ed.js";
-import { p as isPromiseLike } from "./lifecycle-batch-Cyfd07rf.js";
-import { _ as setControlBoundaryContextFrame, g as evaluateShowState, h as evaluateCaseState, i as evaluateForState, o as rollbackForStateTransaction, r as commitForStateTransaction } from "./for-internal-T1C7jd7x.js";
+import { i as isFragmentType, n as Fragment, t as ELEMENT_TYPE } from "./jsx-DRS-qjiN.js";
+import { g as markVNodeTreeWithContextFrame, m as getVNodeContextFrame, n as createComponentInstance, p as getExecutionContextFrame, u as callWithContext } from "./component-internal-DOVVMjG7.js";
+import { t as cleanupComponent } from "./component-cleanup-hrqSikl2.js";
+import { p as isPromiseLike } from "./lifecycle-batch-BH0fax4F.js";
+import { _ as setControlBoundaryContextFrame, g as evaluateShowState, h as evaluateCaseState, i as evaluateForState, o as rollbackForStateTransaction, r as commitForStateTransaction } from "./for-internal-jrliHZmF.js";
 import { C as SSRDataMissingError, _ as isEmptyPageRenderEnvelope, f as stopRenderPhase$1, h as createPageRenderEnvelope, t as configureRenderContextProvider, u as startRenderPhase$1, v as isPageRenderEnvelope, x as withHydrationRenderUrl } from "./render-context-B7ohlh6t.js";
 import { n as getPublicAttributeName, t as sanitizeCssValue } from "./css-BuPaTOfe.js";
-import { o as isUnsafeUrlAttribute, r as validateCspNonce, t as CspNonceScope } from "./csp-nonce-ByMbWv8s.js";
+import { o as isUnsafeUrlAttribute, r as validateCspNonce, t as CspNonceScope } from "./csp-nonce-BBxq1zq4.js";
 import { n as SSR_PORTAL_HOST, t as SSR_PORTAL_ANCHOR } from "./portal-w3oQ6oQU.js";
-import { t as createDataRuntime } from "./data-runtime-oIdQWnPW.js";
-import { c as withTelemetry, i as dehydrateDataRuntime, t as createQueryPrefetchContext } from "./query-registry-qm13pEdK.js";
+import { t as createDataRuntime } from "./data-runtime-JxoRgrrt.js";
+import { c as withTelemetry, i as dehydrateDataRuntime, t as createQueryPrefetchContext } from "./query-registry-CimB1YeW.js";
 import { a as resolveRouteFromRoutes, c as removeRouteBasePath, s as normalizeRouteBasePath, t as _resolveRouteMatchFromRoutes } from "./route-matching-Bo6UqG-5.js";
-import { a as resolveRouteRequest, d as DEFERRED_BOUNDARY, l as validateRouteHydrationData, o as getRouteHydrationMetadata, p as isDeferred } from "./resolution-B21kmOkp.js";
+import { a as resolveRouteRequest, d as DEFERRED_BOUNDARY, l as validateRouteHydrationData, o as getRouteHydrationMetadata, p as isDeferred } from "./resolution-D8PgnTzh.js";
 import { n as disposeRegisteredDefaultPortalScope, r as getDefaultPortalHost } from "./default-portal-runtime-DvMvWJVp.js";
 import { n as renderDocument, t as SSR_RENDER_DATA_ATTR } from "./ssr-DSHd_Q9K.js";
 //#region src/ssr/escape.ts
@@ -182,6 +182,7 @@ function ensureRenderContextAccessor() {
 		}
 	} catch {}
 }
+/** Build a fresh SSR render context (data cache, routes, seed) for a render pass. */
 function createRenderContext(seed = 12345, opts = {}) {
 	clearEscapeCache();
 	const queryCache = /* @__PURE__ */ new Map();
@@ -257,6 +258,7 @@ async function getAsyncRenderContextAccessor() {
 	})();
 	return asyncRenderContextAccessor;
 }
+/** Run `fn` with `ctx` as the active SSR render context, using async-local storage. */
 async function withRenderContextAsync(ctx, fn) {
 	const accessor = await getAsyncRenderContextAccessor();
 	if (accessor) return accessor.run(ctx, () => Promise.resolve(fn()));
@@ -428,6 +430,7 @@ var StreamSink = class {
 };
 //#endregion
 //#region src/ssr/route-render.ts
+/** Resolve a URL against a route registry for SSR, applying auth/policies before render. */
 async function resolveRequest(opts) {
 	if (!opts?.registry) throw new TypeError("resolveRequest requires opts.registry.");
 	const { url, auth, authContext, request, signal } = opts;
@@ -1184,6 +1187,7 @@ function renderNodeSyncToSink(node, sink, ctx) {
 	renderChildrenSyncToSink(children, sink, ctx);
 	sinkWrite3(sink, "</", typeStr, ">");
 }
+/** Synchronously render a component to an HTML string, without route resolution. */
 function renderToStringSync(component, props, options) {
 	const seed = options?.seed ?? 12345;
 	const nonce = validateCspNonce(options?.cspNonce);
@@ -1250,6 +1254,7 @@ function sameRouteParams(left, right) {
 	for (const key of leftKeys) if (left[key] !== right[key]) return false;
 	return true;
 }
+/** Synchronously render an already-resolved route handler to an HTML string. */
 function renderResolvedToStringSync(opts) {
 	const { url, registry, handler, params, options } = opts;
 	const routes = registry.routes;
@@ -1402,9 +1407,11 @@ function createDeferredRenderStream(initialHtml, boundaries, signal, seed, data,
 		}
 	});
 }
+/** Resolve and render a route request for SSR, streaming the body when possible. */
 async function renderRouteRequest(options) {
 	return renderRouteRequestInternal(options);
 }
+/** Resolve and render a route request for SSR, always fully buffering the HTML. */
 async function renderRouteRequestToString(options) {
 	const result = await renderRouteRequestInternal(options);
 	if (result.kind !== "render" || !result.stream) return result;
@@ -1490,6 +1497,7 @@ function renderToString(arg) {
 	if (typeof arg === "function") return renderToStringSync(arg);
 	return renderRouteToString(arg, routeRenderHost);
 }
+/** Stream a route request's rendered HTML to the response sink described by `opts`. */
 function renderToStream(opts) {
 	renderRouteToStream(opts, routeRenderHost);
 }

package/dist/{state-XPZYUzHL.js → state-DmkGM_LN.js}

@@ -1,7 +1,7 @@
-import { S as isProductionEnvironment } from "./access-DSkccuEI.js";
-import { n as isBulkCommitActive, t as deferBulkCommitReadableNotification } from "./fastlane-B2s24fWt.js";
+import { S as isProductionEnvironment } from "./access-d_DCdwqn.js";
+import { n as isBulkCommitActive, t as deferBulkCommitReadableNotification } from "./fastlane-DGo7SxBQ.js";
 import { i as claimHookIndex, p as getCurrentInstance } from "./component-scope-4I3yEMkb.js";
-import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B99wh5Z_.js";
+import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-BsdGWsDE.js";
 //#region src/runtime/state.ts
 /**
 * State primitive for Askr components

package/dist/{structures-DKjkAmM5.js → structures-umvVUD-M.js}

@@ -1,16 +1,18 @@
-import { o as getRuntimeRenderer } from "./access-DSkccuEI.js";
+import { o as getRuntimeRenderer } from "./access-d_DCdwqn.js";
 import { f as getCurrentComponentInstance, m as getCurrentPortalScope } from "./component-scope-4I3yEMkb.js";
-import { n as Fragment, t as ELEMENT_TYPE } from "./jsx-C3IECePB.js";
-import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B99wh5Z_.js";
-import { t as cleanupComponent } from "./component-cleanup-CJCfu5ed.js";
-import { c as getCurrentLifecycleCommitBatch, u as registerLifecycleTransaction } from "./lifecycle-batch-Cyfd07rf.js";
+import { n as Fragment, t as ELEMENT_TYPE } from "./jsx-DRS-qjiN.js";
+import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-BsdGWsDE.js";
+import { t as cleanupComponent } from "./component-cleanup-hrqSikl2.js";
+import { c as getCurrentLifecycleCommitBatch, u as registerLifecycleTransaction } from "./lifecycle-batch-BH0fax4F.js";
 import { n as getActiveRenderContext } from "./render-context-B7ohlh6t.js";
 import { i as createSSRPortalHostToken, n as SSR_PORTAL_HOST, r as createSSRPortalAnchorToken, t as SSR_PORTAL_ANCHOR } from "./portal-w3oQ6oQU.js";
 import { i as registerDefaultPortalRuntime } from "./default-portal-runtime-DvMvWJVp.js";
 //#region src/jsx/utils.ts
+/** Check whether `value` is a JSX element vnode. */
 function isElement(value) {
 	return typeof value === "object" && value !== null && value.$$typeof === ELEMENT_TYPE;
 }
+/** Clone a JSX element, shallow-merging `props` over its existing props. */
 function cloneElement(element, props) {
 	return {
 		$$typeof: element.$$typeof,
@@ -24,6 +26,10 @@ function cloneElement(element, props) {
 }
 //#endregion
 //#region src/foundations/structures/layout.tsx
+/**
+* Wrap a {@link LayoutComponent} so it can be invoked as `(children, props)`,
+* matching route layout conventions.
+*/
 function layout(Layout) {
 	return (children, props) => {
 		return Layout({
@@ -171,6 +177,7 @@ function createPortalSlot() {
 		}
 	};
 }
+/** Create a new named {@link Portal} channel with its own host and content. */
 function definePortal() {
 	const ssrPortalKey = {};
 	if (typeof createPortalSlot === "function") {
@@ -456,6 +463,10 @@ function clearDefaultPortalForInstance(instance) {
 	state.owner = null;
 	detachDefaultPortalHostOutput(state);
 }
+/**
+* The implicit portal channel that {@link Portal} writes to and that any
+* host rendered without an explicit portal falls back to.
+*/
 const DefaultPortal = (() => {
 	function Host(props) {
 		const serverHost = createSSRPortalHost(DEFAULT_SSR_PORTAL_KEY, props?.__askrAutoDefaultPortal === true);
@@ -481,6 +492,7 @@ const DefaultPortal = (() => {
 	};
 	return Host;
 })();
+/** Write children to the {@link DefaultPortal} host wherever it is rendered. */
 function Portal(props) {
 	if (writeSSRPortal(DEFAULT_SSR_PORTAL_KEY, props.children)) return createSSRPortalAnchor();
 	const owner = getCurrentComponentInstance();
@@ -497,6 +509,7 @@ registerDefaultPortalRuntime({
 });
 //#endregion
 //#region src/foundations/structures/collection.ts
+/** Create an empty, insertion-ordered {@link Collection} registry. */
 function createCollection() {
 	const registry = /* @__PURE__ */ new Map();
 	function register(node, metadata) {
@@ -545,6 +558,7 @@ function createCollection() {
 */
 //#endregion
 //#region src/foundations/structures/layer.ts
+/** Create a new, empty {@link LayerManager} for coordinating overlay stacking. */
 function createLayer() {
 	const stack = [];
 	let nextId = 1;