@askrjs/askr 0.0.91 → 0.0.94

package/dist/{ssr-DNJUPmMq.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 { v as logger } from "./access-Dpfoi4cA.js";
-import { f as getCurrentComponentInstance, w as setCurrentComponentInstance } from "./component-scope-DzJEbYGE.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-C4uwwUaK.js";
-import { t as cleanupComponent } from "./component-cleanup-BUfUleGZ.js";
-import { p as isPromiseLike } from "./lifecycle-batch-Dfpid9-A.js";
-import { _ as setControlBoundaryContextFrame, g as evaluateShowState, h as evaluateCaseState, i as evaluateForState, o as rollbackForStateTransaction, r as commitForStateTransaction } from "./for-internal-Bsm0B8GZ.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-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-DH0TrDij.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-wbooGyu7.js";
-import { c as withTelemetry, i as dehydrateDataRuntime, t as createQueryPrefetchContext } from "./query-registry-B4LpVtlT.js";
-import { a as resolveRouteFromRoutes, c as removeRouteBasePath, s as normalizeRouteBasePath, t as _resolveRouteMatchFromRoutes } from "./route-matching-xlgdQXg_.js";
-import { a as resolveRouteRequest, d as DEFERRED_BOUNDARY, l as validateRouteHydrationData, o as getRouteHydrationMetadata, p as isDeferred } from "./resolution-C9A31xQi.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-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-DCjONcHK.js → state-DmkGM_LN.js}

@@ -1,7 +1,7 @@
-import { v as logger, x as isProductionEnvironment } from "./access-Dpfoi4cA.js";
-import { t as isBulkCommitActive } from "./fastlane-CrfB3QG0.js";
-import { i as claimHookIndex, p as getCurrentInstance } from "./component-scope-DzJEbYGE.js";
-import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B5NtV7V0.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-BsdGWsDE.js";
 //#region src/runtime/state.ts
 /**
 * State primitive for Askr components
@@ -77,8 +77,8 @@ function createStateCell(initialValue, instance) {
 		else newValue = newValueOrUpdater;
 		if (Object.is(value, newValue)) return;
 		if (isBulkCommitActive()) {
-			if (!isProductionEnvironment()) logger.warn("[Askr] state.set() was called while a bulk commit (fast-lane reorder) was in progress. The value updated, but subscribers were not notified, so this change will not be reflected in the UI until an unrelated update triggers a re-render. This usually happens from a ref callback or a native focus/blur event fired synchronously during a large keyed-list reorder.");
 			value = newValue;
+			deferBulkCommitReadableNotification(read);
 			return;
 		}
 		value = newValue;

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

@@ -1,16 +1,18 @@
-import { o as getRuntimeRenderer } from "./access-Dpfoi4cA.js";
-import { f as getCurrentComponentInstance, m as getCurrentPortalScope } from "./component-scope-DzJEbYGE.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-B5NtV7V0.js";
-import { t as cleanupComponent } from "./component-cleanup-BUfUleGZ.js";
-import { c as getCurrentLifecycleCommitBatch, u as registerLifecycleTransaction } from "./lifecycle-batch-Dfpid9-A.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-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;

package/dist/testing/index.d.ts

@@ -1,7 +1,6 @@
-import { l as ComponentFunction } from "../control-D-FIa-n-.js";
-import { a as Mutation, m as QueryStaleReason, s as Query, t as DataRuntime } from "../types-iAmDSV6o.js";
-import { M as RouteMatch, W as RouteRegistry, w as RouteAuthOptions } from "../index-Izwp_ESC.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-KQ7Vl4-8.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
@@ -11,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. */
@@ -19,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;
@@ -27,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
@@ -41,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;
@@ -49,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;
@@ -57,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[];
@@ -73,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[];
@@ -96,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;
@@ -106,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>;
@@ -113,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>;
@@ -121,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-Dpfoi4cA.js";
-import { u as recordReadableRead } from "../readable-B5NtV7V0.js";
-import { l as addInvalidationListener, t as createDataRuntime } from "../data-runtime-wbooGyu7.js";
-import { a as notifySource, i as normalizeAsyncDataError, r as createReadableSource } from "../data-Bh_3OETq.js";
-import { r as computeRouteActivityMatches } from "../route-matching-xlgdQXg_.js";
-import { a as cleanupApp, r as createSPA, t as createIsland } from "../boot-D3zVVWuN.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-DYqokZzc.js";
+import { r as computeRouteActivityMatches } from "../route-matching-Bo6UqG-5.js";
+import { a as cleanupApp, r as createSPA, t as createIsland } from "../boot-BsMB_ySP.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/{jsx-BYXe_Nnk.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;
@@ -342,4 +346,20 @@ interface JSXElement {
   key?: string | number | null;
 }
 //#endregion
+//#region src/jsx/types.d.ts
+declare global {
+  namespace JSX {
+    interface Element extends JSXElement {
+      readonly __askrJsxElementBrand?: never;
+    }
+    interface IntrinsicElements extends KnownIntrinsicElementProps {}
+    interface ElementAttributesProperty {
+      props: Props;
+    }
+    interface ElementChildrenAttribute {
+      children: unknown;
+    }
+  }
+}
+//#endregion
 export { IntrinsicFallbackProps as a, JSXElementType as i, JSXComponent as n, KnownIntrinsicElementProps as o, JSXElement as r, Props as s, Fragment as t };

package/dist/{verify-hydration-D8938Fw2.js → verify-hydration-jf8X2V3x.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-DNJUPmMq.js";
+import { a as renderResolvedToStringSync } from "./ssr-8_vHDWqV.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.91",
+  "version": "0.0.94",
   "description": "Actor-backed deterministic UI framework",
   "keywords": [
     "askr",