@askrjs/askr 0.0.92 → 0.0.95

package/dist/{ssr-CaZfvQWn.js → ssr-DYcK20IX.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 { f as callWithContext, g as getVNodeContextFrame, h as getExecutionContextFrame, n as createComponentInstance, v as markVNodeTreeWithContextFrame } from "./component-internal-D0yE2Ch3.js";
+import { t as cleanupComponent } from "./component-cleanup-DYG80yhG.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-DkBwTG4S.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-BVybpV1v.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-BQyo7qNn.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-CPycoyZj.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-DYG80yhG.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({
@@ -104,6 +110,16 @@ function Presence({ present, children }) {
 //#endregion
 //#region src/runtime/portal.ts
 const DEFAULT_SSR_PORTAL_KEY = {};
+function setPortalErrorParent(host, owner) {
+	if (!host) return;
+	if (owner && owner.instance._ownershipGeneration === owner.generation && owner.instance.notifyUpdate !== null) {
+		host._portalErrorParent = owner.instance;
+		host._portalErrorParentGeneration = owner.generation;
+		return;
+	}
+	host._portalErrorParent = null;
+	host._portalErrorParentGeneration = void 0;
+}
 function getSSRPortalSlot(key) {
 	const context = getActiveRenderContext();
 	if (context?.mode !== "ssr") return null;
@@ -154,6 +170,7 @@ function createSSRPortalAnchor() {
 }
 function createPortalSlot() {
 	let currentValue;
+	let currentOwner = null;
 	const source = (() => {
 		recordReadableRead(source);
 		return currentValue;
@@ -162,15 +179,21 @@ function createPortalSlot() {
 		read() {
 			return source();
 		},
-		write(value) {
-			if (Object.is(currentValue, value)) return;
+		write(value, owner) {
+			const ownerChanged = currentOwner?.instance !== owner?.instance || currentOwner?.generation !== owner?.generation;
+			currentOwner = owner;
+			if (Object.is(currentValue, value) && !ownerChanged) return;
 			currentValue = value;
 			markReadableDerivedSubscribersDirty(source);
 			markReactivePropsDirtySource(source);
 			notifyReadableReaders(source);
+		},
+		getOwner() {
+			return currentOwner;
 		}
 	};
 }
+/** Create a new named {@link Portal} channel with its own host and content. */
 function definePortal() {
 	const ssrPortalKey = {};
 	if (typeof createPortalSlot === "function") {
@@ -178,11 +201,17 @@ function definePortal() {
 		function PortalHost() {
 			const serverHost = createSSRPortalHost(ssrPortalKey, false);
 			if (serverHost) return serverHost;
+			const host = getCurrentComponentInstance();
+			if (host?.fn === PortalHost) setPortalErrorParent(host, slot.getOwner());
 			return slot.read();
 		}
 		PortalHost.render = function PortalRender(props) {
 			if (writeSSRPortal(ssrPortalKey, props.children)) return null;
-			slot.write(props.children);
+			const owner = getCurrentComponentInstance();
+			slot.write(props.children, owner ? {
+				instance: owner,
+				generation: owner._ownershipGeneration
+			} : null);
 			return null;
 		};
 		return PortalHost;
@@ -225,7 +254,7 @@ function clearTrackedBatchPortalWrite(transaction) {
 		batch = batch.parent;
 	}
 }
-function createExplicitHostSource(readCount) {
+function createPortalStateSource(readCount) {
 	let source = (() => {
 		recordReadableRead(source);
 		return readCount();
@@ -240,6 +269,14 @@ function notifyExplicitDefaultPortalHostReaders(state) {
 	markReactivePropsDirtySource(state.explicitHostSource);
 	notifyReadableReaders(state.explicitHostSource);
 }
+function setDefaultPortalOwner(state, owner) {
+	if (state.owner?.instance === owner?.instance && state.owner?.generation === owner?.generation) return;
+	state.owner = owner;
+	state.ownerVersion += 1;
+	markReadableDerivedSubscribersDirty(state.ownerSource);
+	markReactivePropsDirtySource(state.ownerSource);
+	notifyReadableReaders(state.ownerSource);
+}
 function createDefaultPortalState() {
 	const state = {
 		portal: definePortal(),
@@ -248,9 +285,12 @@ function createDefaultPortalState() {
 		cleanupOwners: /* @__PURE__ */ new WeakSet(),
 		explicitHostOwners: /* @__PURE__ */ new Map(),
 		explicitHostCleanupOwners: /* @__PURE__ */ new WeakSet(),
-		explicitHostSource: (() => 0)
+		explicitHostSource: (() => 0),
+		ownerVersion: 0,
+		ownerSource: (() => 0)
 	};
-	state.explicitHostSource = createExplicitHostSource(() => state.explicitHostOwners.size);
+	state.explicitHostSource = createPortalStateSource(() => state.explicitHostOwners.size);
+	state.ownerSource = createPortalStateSource(() => state.ownerVersion);
 	return state;
 }
 function disposeDefaultPortalScope(scope) {
@@ -288,7 +328,7 @@ function detachDefaultPortalHostOutput(state) {
 }
 function applyDefaultPortalWrite(state, children, owner) {
 	state.portal.render({ children });
-	state.owner = owner;
+	setDefaultPortalOwner(state, owner);
 	if (isEmptyPortalValue(children)) detachDefaultPortalHostOutput(state);
 }
 function isStaleDefaultPortalScope(scope) {
@@ -398,7 +438,7 @@ function applyPendingDefaultPortalValue(scope) {
 	if (!_hasPendingDefaultPortalValue) return;
 	const state = getDefaultPortalState(scope);
 	state.portal.render({ children: _pendingDefaultPortalValue });
-	state.owner = null;
+	setDefaultPortalOwner(state, null);
 	_hasPendingDefaultPortalValue = false;
 	_pendingDefaultPortalValue = void 0;
 }
@@ -453,9 +493,13 @@ function clearDefaultPortalForInstance(instance) {
 	_hasPendingDefaultPortalValue = false;
 	_pendingDefaultPortalValue = void 0;
 	state.portal.render({ children: void 0 });
-	state.owner = null;
+	setDefaultPortalOwner(state, 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);
@@ -471,6 +515,8 @@ const DefaultPortal = (() => {
 		if (!(props?.__askrAutoDefaultPortal === true)) registerExplicitDefaultPortalHost(scope, state, owner);
 		else if (readExplicitDefaultPortalHosts(state) > 0) return null;
 		applyPendingDefaultPortalValue(scope);
+		state.ownerSource();
+		setPortalErrorParent(owner, state.owner);
 		const value = state.portal();
 		return value === void 0 ? null : value;
 	}
@@ -481,6 +527,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 +544,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 +593,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;

package/dist/testing/index.d.ts

@@ -1,6 +1,6 @@
-import { pt as RouteRegistry, q as RouteAuthOptions, tt as RouteMatch, wt as ComponentFunction } from "../index-DA3g8lm8.js";
-import { A as QueryStaleReason, S as Mutation, v as DataRuntime, w as Query } from "../index-2bk8nldG.js";
+import { At as RouteRegistry, Gt as Query, Ut as Mutation, Zt as QueryStaleReason, nn as ComponentFunction, ut as RouteAuthOptions, vt as RouteMatch, zt as DataRuntime } from "../index-CTIBOqUB.js";
 //#region src/testing/render.d.ts
+/** Options for {@link render} and {@link mount}. */
 interface RenderOptions {
   /**
    * Existing element to own for the duration of the render. When omitted, the
@@ -10,6 +10,7 @@ interface RenderOptions {
   /** Surface lifecycle cleanup errors during unmount. */
   cleanupStrict?: boolean;
 }
+/** Options for {@link renderRoute}. */
 interface RouteRenderOptions extends RenderOptions {
   registry: RouteRegistry;
   /** Initial path, query, and hash for the routed render. */
@@ -18,6 +19,7 @@ interface RouteRenderOptions extends RenderOptions {
   dataRuntime?: DataRuntime;
 }
 type DispatchEventInit = EventInit | UIEventInit | FocusEventInit | MouseEventInit | WheelEventInit | KeyboardEventInit | InputEventInit | CompositionEventInit | PointerEventInit | TouchEventInit | DragEventInit;
+/** Handle to a mounted test render, returned by {@link render}/{@link mount}/{@link renderRoute}. */
 interface RenderResult {
   readonly container: HTMLElement;
   readonly root: HTMLElement;
@@ -26,11 +28,17 @@ interface RenderResult {
   unmount(): void;
   cleanup(): void;
 }
+/** Synchronously flush the runtime's scheduled work (renders, effects). */
 declare function flush(): void;
+/** Dispatch an event (constructed from a type string, or given directly) on `target`. */
 declare function dispatch(target: EventTarget, event: Event | string, init?: DispatchEventInit): boolean;
+/** Tear down a test render, given either its {@link RenderResult} or container element. */
 declare function cleanup(target: RenderResult | HTMLElement): void;
+/** Mount `component` as an island into a test container and flush pending work. */
 declare function render(component: ComponentFunction, options?: RenderOptions): RenderResult;
+/** Alias for {@link render}. */
 declare function mount(component: ComponentFunction, options?: RenderOptions): RenderResult;
+/** Mount a routed app (via {@link createSPA}) into a test container for the given route registry. */
 declare function renderRoute(options: RouteRenderOptions): Promise<RenderResult>;
 //#endregion
 //#region src/testing/index.d.ts
@@ -40,6 +48,7 @@ declare function click(element: Element): boolean;
 declare function type(element: HTMLInputElement | HTMLTextAreaElement, text: string): void;
 /** Dispatch a cancelable bubbling submit event on a form. */
 declare function submit(form: HTMLFormElement): boolean;
+/** Keyed query fixture registry returned by {@link createQueryTestRegistry}. */
 interface QueryTestRegistry {
   readonly runtime: DataRuntime;
   set<T extends {}>(key: string, query: Query<T>): void;
@@ -48,6 +57,7 @@ interface QueryTestRegistry {
 }
 /** Create a keyed query fixture registry for a test render runtime. */
 declare function createQueryTestRegistry(): QueryTestRegistry;
+/** Keyed mutation fixture registry returned by {@link createMutationTestRegistry}. */
 interface MutationTestRegistry {
   readonly runtime: DataRuntime;
   set<TInput, TResult>(key: string, mutation: Mutation<TInput, TResult>): void;
@@ -56,11 +66,13 @@ interface MutationTestRegistry {
 }
 /** Create a keyed mutation fixture registry for a test render runtime. */
 declare function createMutationTestRegistry(): MutationTestRegistry;
+/** Initial state for {@link mutationState}; exactly one of `pending`/`error`/`result` may be set. */
 type MutationFixtureInitial<TResult> = {
   pending?: boolean;
   error?: {} | null;
   result?: TResult;
 };
+/** A {@link Mutation} whose state is driven manually via `setPending`/`succeed`/`fail`. */
 type MutationFixture<TInput, TResult> = Mutation<TInput, TResult> & {
   /** Inputs received by the fixture's execute method. */
   readonly inputs: readonly TInput[];
@@ -72,20 +84,28 @@ type MutationFixture<TInput, TResult> = Mutation<TInput, TResult> & {
   fail(error: {}): void;
 };
 declare function createMutationFixture<TInput = unknown, TResult = unknown>(initial?: MutationFixtureInitial<TResult>): MutationFixture<TInput, TResult>;
+/**
+ * Build a {@link MutationFixture} for tests: call directly with initial
+ * state, or use `.idle()`/`.pending()`/`.success(result)`/`.error(error)`.
+ */
 declare const mutationState: typeof createMutationFixture & {
   idle<TInput = unknown, TResult = unknown>(): MutationFixture<TInput, TResult>;
   pending<TInput = unknown, TResult = unknown>(): MutationFixture<TInput, TResult>;
   success<TInput = unknown, TResult = unknown>(result: TResult): MutationFixture<TInput, TResult>;
   error<TInput = unknown, TResult = unknown>(error: {}): MutationFixture<TInput, TResult>;
 };
+/** Refresh callback for a {@link mockQuery} fixture, invoked by the query's `refresh()`. */
 type MockRefresh = () => void | Promise<void>;
+/** Options for {@link mockQuery} fixtures. */
 interface MockQueryOptions {
   refresh?: MockRefresh;
 }
+/** A single recorded call to {@link invalidate}, captured by {@link createInvalidationRecorder}. */
 interface InvalidationRecord {
   prefix: string;
   markPendingWrite: boolean;
 }
+/** Recorder returned by {@link createInvalidationRecorder}. */
 interface InvalidationRecorder {
   readonly calls: readonly InvalidationRecord[];
   readonly prefixes: readonly string[];
@@ -95,6 +115,7 @@ interface InvalidationRecorder {
 interface MatchRouteOptions {
   registry: RouteRegistry;
 }
+/** A splat-route/static-route path collision reported by {@link getRouteWarnings}. */
 interface RoutePatternWarning {
   kind: 'route-collision';
   path: string;
@@ -105,6 +126,10 @@ interface RoutePatternWarning {
 }
 type StaleValueReason = Exclude<QueryStaleReason, 'error'>;
 declare function createFreshQuery<T extends {}>(data: T, options?: MockQueryOptions): Query<T>;
+/**
+ * Build a fresh {@link Query} fixture for tests: call directly with data, or
+ * use `.loading()`/`.error()`/`.refreshing()`/`.stale()`/`.pendingWrite()`.
+ */
 declare const mockQuery: typeof createFreshQuery & {
   loading<T extends {} = {}>(options?: MockQueryOptions): Query<T>;
   error<T extends {} = {}>(error: {}, previousData?: T, options?: MockQueryOptions): Query<T>;
@@ -112,6 +137,7 @@ declare const mockQuery: typeof createFreshQuery & {
   stale<T extends {}>(data: T, reason?: StaleValueReason, options?: MockQueryOptions): Query<T>;
   pendingWrite<T extends {}>(data: T, options?: MockQueryOptions): Query<T>;
 };
+/** Alias table mirroring {@link mockQuery}'s state builders (`fresh`, `loading`, `error`, ...). */
 declare const queryState: {
   fresh: typeof createFreshQuery;
   loading: <T extends {} = {}>(options?: MockQueryOptions) => Query<T>;
@@ -120,8 +146,11 @@ declare const queryState: {
   stale: <T extends {}>(data: T, reason?: StaleValueReason, options?: MockQueryOptions) => Query<T>;
   pendingWrite: <T extends {}>(data: T, options?: MockQueryOptions) => Query<T>;
 };
+/** Start recording {@link invalidate} calls for assertions; call `stop()` when done. */
 declare function createInvalidationRecorder(): InvalidationRecorder;
+/** Match `path` against a route registry for tests, without mounting the app. */
 declare function matchRoute(path: string, options: MatchRouteOptions): RouteMatch | null;
+/** Find named-splat routes whose reserved segments collide with sibling static routes. */
 declare function getRouteWarnings(options: MatchRouteOptions): RoutePatternWarning[];
 //#endregion
 export { InvalidationRecord, InvalidationRecorder, MockQueryOptions, MockRefresh, MutationFixture, MutationFixtureInitial, MutationTestRegistry, QueryTestRegistry, type RenderOptions, type RenderResult, RoutePatternWarning, type RouteRenderOptions, cleanup, click, createInvalidationRecorder, createMutationTestRegistry, createQueryTestRegistry, dispatch, flush, getRouteWarnings, matchRoute, mockQuery, mount, mutationState, queryState, render, renderRoute, submit, type };

package/dist/testing/index.js

@@ -1,9 +1,9 @@
-import { r as flushRuntimeScheduler } from "../access-DSkccuEI.js";
-import { u as recordReadableRead } from "../readable-B99wh5Z_.js";
-import { l as addInvalidationListener, t as createDataRuntime } from "../data-runtime-oIdQWnPW.js";
-import { a as notifySource, i as normalizeAsyncDataError, r as createReadableSource } from "../data-DcikEH9N.js";
+import { r as flushRuntimeScheduler } from "../access-d_DCdwqn.js";
+import { u as recordReadableRead } from "../readable-BsdGWsDE.js";
+import { l as addInvalidationListener, t as createDataRuntime } from "../data-runtime-JxoRgrrt.js";
+import { a as notifySource, i as normalizeAsyncDataError, r as createReadableSource } from "../data-Bm8L6JOm.js";
 import { r as computeRouteActivityMatches } from "../route-matching-Bo6UqG-5.js";
-import { a as cleanupApp, r as createSPA, t as createIsland } from "../boot-D71bjP4r.js";
+import { a as cleanupApp, r as createSPA, t as createIsland } from "../boot-C1wT3Vfs.js";
 //#region src/testing/render.ts
 const renderStates = /* @__PURE__ */ new WeakMap();
 const eventConstructorNames = {
@@ -96,9 +96,11 @@ function isEventForTarget(target, value) {
 	if (value instanceof getBaseEventConstructor(target)) return true;
 	return typeof Event !== "undefined" && value instanceof Event;
 }
+/** Synchronously flush the runtime's scheduled work (renders, effects). */
 function flush() {
 	flushRuntimeScheduler();
 }
+/** Dispatch an event (constructed from a type string, or given directly) on `target`. */
 function dispatch(target, event, init = {}) {
 	if (!target || typeof target.dispatchEvent !== "function") throw new TypeError("@askrjs/askr/testing dispatch requires an EventTarget.");
 	if (typeof event !== "string" && !isEventForTarget(target, event)) throw new TypeError("@askrjs/askr/testing dispatch requires an Event instance or event type string.");
@@ -125,6 +127,7 @@ function cleanupContainer(container) {
 function isRenderResult(target) {
 	return "container" in target && "cleanup" in target;
 }
+/** Tear down a test render, given either its {@link RenderResult} or container element. */
 function cleanup(target) {
 	cleanupContainer(isRenderResult(target) ? target.container : target);
 }
@@ -138,6 +141,7 @@ function createRenderResult(container) {
 		cleanup: () => cleanupContainer(container)
 	};
 }
+/** Mount `component` as an island into a test container and flush pending work. */
 function render(component, options) {
 	if (typeof component !== "function") throw new TypeError("@askrjs/askr/testing render requires a component function.");
 	const { container } = prepareContainer(options);
@@ -154,9 +158,11 @@ function render(component, options) {
 		throw error;
 	}
 }
+/** Alias for {@link render}. */
 function mount(component, options) {
 	return render(component, options);
 }
+/** Mount a routed app (via {@link createSPA}) into a test container for the given route registry. */
 async function renderRoute(options) {
 	if (!options?.registry) throw new TypeError("@askrjs/askr/testing renderRoute requires a route registry.");
 	const currentWindow = requireWindow();
@@ -351,6 +357,10 @@ var MutableMutationFixture = class {
 function createMutationFixture(initial = {}) {
 	return new MutableMutationFixture(initial);
 }
+/**
+* Build a {@link MutationFixture} for tests: call directly with initial
+* state, or use `.idle()`/`.pending()`/`.success(result)`/`.error(error)`.
+*/
 const mutationState = Object.assign(createMutationFixture, {
 	idle() {
 		return createMutationFixture();
@@ -387,6 +397,10 @@ function createFreshQuery(data, options) {
 		staleReason: null
 	}, options);
 }
+/**
+* Build a fresh {@link Query} fixture for tests: call directly with data, or
+* use `.loading()`/`.error()`/`.refreshing()`/`.stale()`/`.pendingWrite()`.
+*/
 const mockQuery = Object.assign(createFreshQuery, {
 	loading(options) {
 		return makeQuery({
@@ -444,6 +458,7 @@ const mockQuery = Object.assign(createFreshQuery, {
 		}, options);
 	}
 });
+/** Alias table mirroring {@link mockQuery}'s state builders (`fresh`, `loading`, `error`, ...). */
 const queryState = {
 	fresh: createFreshQuery,
 	loading: mockQuery.loading,
@@ -452,6 +467,7 @@ const queryState = {
 	stale: mockQuery.stale,
 	pendingWrite: mockQuery.pendingWrite
 };
+/** Start recording {@link invalidate} calls for assertions; call `stop()` when done. */
 function createInvalidationRecorder() {
 	const records = [];
 	let active = true;
@@ -478,6 +494,7 @@ function createInvalidationRecorder() {
 		}
 	};
 }
+/** Match `path` against a route registry for tests, without mounting the app. */
 function matchRoute(path, options) {
 	if (!options?.registry) throw new TypeError("matchRoute requires options.registry.");
 	return computeRouteActivityMatches(path, { registry: options.registry })[0] ?? null;
@@ -499,6 +516,7 @@ function routePrefixMatches(splatPrefix, routeSegments) {
 	}
 	return true;
 }
+/** Find named-splat routes whose reserved segments collide with sibling static routes. */
 function getRouteWarnings(options) {
 	const records = getRoutePatternRecords(options);
 	const warnings = [];

package/dist/{types-BA9FJtfR.d.ts → types-DkVJhVs9.d.ts}

@@ -326,11 +326,15 @@ interface KnownIntrinsicElementProps {
 }
 //#endregion
 //#region src/common/jsx.d.ts
+/** The element type marker for JSX fragments (`<>...</>`), groups children without a wrapper element. */
 declare const Fragment: unique symbol;
+/** A component function accepting `TProps`, usable as a JSX element's `type`. */
 type JSXComponent<TProps extends object = Props> = {
   bivarianceHack(props: TProps): unknown;
 }['bivarianceHack'];
+/** Valid `type` values for a JSX element: a tag name, a component, or a symbol (e.g. `Fragment`). */
 type JSXElementType = string | JSXComponent | symbol;
+/** The vnode shape produced by JSX/`jsx()` calls. */
 interface JSXElement {
   /** Internal element marker */
   $$typeof: symbol;

package/dist/{verify-hydration-CcF-HJil.js → verify-hydration-m-wVbYOD.js}

@@ -1,6 +1,6 @@
 import { g as getHydrationRenderUrl, m as withHydrationVerificationRender } from "./render-context-B7ohlh6t.js";
 import { t as SSR_RENDER_DATA_ATTR } from "./ssr-DSHd_Q9K.js";
-import { a as renderResolvedToStringSync } from "./ssr-CaZfvQWn.js";
+import { a as renderResolvedToStringSync } from "./ssr-DYcK20IX.js";
 //#region src/ssr/verify-hydration.ts
 function normalizeHydrationHtml(html) {
 	const template = document.createElement("template");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askrjs/askr",
-  "version": "0.0.92",
+  "version": "0.0.95",
   "description": "Actor-backed deterministic UI framework",
   "keywords": [
     "askr",