@askrjs/askr 0.0.85 → 0.0.87

package/CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+## Unreleased
+
+## 0.0.85
+
+- breaking(runtime): require Node.js 24.15 or newer.
+- feat(router): validate route hydration data and add synchronous `dehydrate`
+  selectors so SSR/SSG can omit server-only fields while client navigation
+  retains complete loader results.
+- feat(router): add registry `basePath` support for mounted SPA, SSR, and SSG
+  routing, destinations, navigation, redirects, activity, and metadata context.
+- fix(jsx): expose safe element inspection and cloning from the structures
+  foundation without carrying renderer-private cache metadata into clones.
+- fix(renderer): retain intrinsic hosts and nested interactive descendants when
+  a rerender passes through a transparent context scope, keep keyed provider
+  ownership isolated, and preserve intentional focus moves during commits.
+- fix(runtime): isolate synchronous DOM handlers from active reconciliation
+  scopes and correctly detach capture-phase delegated listeners.
+
+### 0.0.52 — audit remediation
+
+- fix(release): rebuild packed artifacts from an absent `dist`, verify every
+  export-map subpath and installed CLI, and keep source maps out of npm
+  tarballs.
+- fix(data): make query invalidation generation-safe, await reconciliation,
+  normalize async failures, and retain mutation callbacks for an execution.
+- fix(router): isolate initial route sources per root and keep history/route
+  cleanup coherent when destination rendering or teardown fails.
+- fix(renderer): make control, keyed, portal, ownership, and lifecycle writes
+  transactional, with anchored multi-node ranges and structural SSR hydration.
+- perf(hydration): adopt matching intrinsic SSR trees in place and publish only
+  transactional refs and listeners instead of running full reconciliation.
+- fix(hydration): activate deferred boundaries locally with retryable marker and
+  listener rollback semantics, while preserving focus, portals, and cleanup.
+- refactor(renderer): split blueprint, boundary-range, component-host, and
+  lifecycle batch responsibilities behind internal facades with enforced
+  complexity budgets.
+- test(bench): add keyed movement-density and separate full-clear teardown
+  diagnostics without changing movement thresholds or cleanup semantics.
+- test(bench): add a Chromium component-boundary keyed reorder diagnostic and
+  document browser authority for jsdom-only hotspot investigations.
+- fix(router): preserve shared layout identity and roll back multi-root route
+  DOM, ownership, metadata, history, and URL publication as one transaction.
+- fix(ssg): publish full builds through staging/backup swap and incremental
+  routes through temp-file replacement.
+- test(quality): add replayable lifecycle traces, deterministic seed fixtures,
+  timer-policy enforcement, benchmark guardrails, and package release gates.
+
+## 0.0.51
+
+- chore(quality): make release verification test packed consumers and public types, exclude source maps from npm tarballs, and replace architecture size checks with semantic boundaries.
+- feat(router): add route-query updates for route-local filters without remounting the active route.
+- feat(runtime): isolate render-scoped query caches, keep the first shared query contract, and evict entries when the last owner unmounts.
+- feat(ssr): harden CSS style sanitization with an allowlist for safe functions and URI-scheme rejection, while resetting escape caches per request.
+- fix(router): trim the public router barrel so internal manifest and SSR helpers stay on source-only paths.
+
+## 0.0.29
+
+- feat(state): support destructuring `const [get, set] = state(initial)`; getter remains callable and setter is identical to `get.set`. Added tests and docs.

package/capabilities.json

@@ -12,6 +12,31 @@
       "docs": "https://github.com/askrjs/askr/blob/main/docs/guides/state.md",
       "docsPath": "docs/guides/state.md"
     },
+    {
+      "intent": "data queries and mutations",
+      "package": "@askrjs/askr",
+      "import": "@askrjs/askr/data",
+      "exports": ["createQuery", "defineQuery", "queryScope", "createMutation"],
+      "constraints": [
+        "query keys identify shared cache entries",
+        "fetches are cancellable"
+      ],
+      "stability": "stable",
+      "docs": "https://github.com/askrjs/askr/blob/main/docs/core/data.md",
+      "docsPath": "docs/core/data.md"
+    },
+    {
+      "intent": "test query-state fixtures",
+      "package": "@askrjs/askr",
+      "import": "@askrjs/askr/testing",
+      "exports": ["queryState"],
+      "constraints": [
+        "fixtures are test-only and do not perform network requests"
+      ],
+      "stability": "stable",
+      "docs": "https://github.com/askrjs/askr/blob/main/docs/contributing/testing.md",
+      "docsPath": "docs/contributing/testing.md"
+    },
     {
       "intent": "routing and navigation",
       "package": "@askrjs/askr",

package/dist/actions/index.d.ts

@@ -1,2 +1,2 @@
-import { a as action, i as ActionValidationError, n as ActionForm, o as defineAction, r as ActionStatus, t as ActionDescriptor } from "../index-pIgGaXvS.js";
+import { a as action, i as ActionValidationError, n as ActionForm, o as defineAction, r as ActionStatus, t as ActionDescriptor } from "../index-BvNkcegT.js";
 export { ActionDescriptor, ActionForm, ActionStatus, ActionValidationError, action, defineAction };

package/dist/actions/index.js

@@ -1,8 +1,8 @@
 import { d as getCurrentAppRenderRuntime } from "../component-scope-DzJEbYGE.js";
-import { r as getCurrentRenderData } from "../render-context-D-DFk2WN.js";
+import { r as getCurrentRenderData } from "../render-context-D0Hoj9dW.js";
 import { t as state } from "../state-DCjONcHK.js";
 import { jsx, jsxs } from "../jsx-runtime.js";
-import { c as resolveDataRuntimeState, s as invalidateQueriesForRuntime } from "../data-runtime-D68YOo9L.js";
+import { c as resolveDataRuntimeState, s as invalidateQueriesForRuntime } from "../data-runtime-CnVeSvJz.js";
 //#region src/actions/runtime.ts
 const emptyFramework = Object.freeze({});
 /** @internal Read Askr-owned state from the current application root. */

package/dist/{activity-Jd9CgEa3.js → activity-BnkhdIXm.js}

@@ -1,9 +1,9 @@
 import { d as getCurrentAppRenderRuntime, f as getCurrentComponentInstance, i as claimHookIndex } from "./component-scope-DzJEbYGE.js";
-import { a as registerCommitOperation } from "./component-internal-DcrLymUJ.js";
+import { a as registerCommitOperation } from "./component-internal-uVCJAre6.js";
 import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B5NtV7V0.js";
-import { n as getActiveRenderContext } from "./render-context-D-DFk2WN.js";
-import { b as getActiveRoutes, c as removeRouteBasePath, d as deepFreeze, f as makeQuery, n as computeMatchesFromRoutes, p as parseLocation, y as getActiveRouteBasePath } from "./route-matching-DHduNiGk.js";
+import { n as getActiveRenderContext } from "./render-context-D0Hoj9dW.js";
 import { n as syncRouteActivitySnapshot } from "./route-activity-CNJfpwx-.js";
+import { b as getActiveRoutes, c as removeRouteBasePath, d as deepFreeze, f as makeQuery, n as computeMatchesFromRoutes, p as parseLocation, y as getActiveRouteBasePath } from "./route-matching-DqULzZtC.js";
 //#region src/common/app-render-runtime.ts
 const stagedRouteLocations = /* @__PURE__ */ new WeakMap();
 function createAppRenderRuntime(input = {}) {

package/dist/{activity-B1I5HJQI.d.ts → activity-DNYL__cW.d.ts}

@@ -1,4 +1,4 @@
-import { L as RouteParams, Z as RouteSnapshot } from "./index-pIgGaXvS.js";
+import { L as RouteParams, Z as RouteSnapshot } from "./index-BvNkcegT.js";
 //#region src/router/activity.d.ts
 interface RouteChangeOptions {
   immediate?: boolean;

package/dist/benchmark.js

@@ -1,10 +1,10 @@
 import { r as flushRuntimeScheduler } from "./access-Dpfoi4cA.js";
-import { t as installRendererBridge } from "./renderer-CZzNtoj2.js";
+import { t as installRendererBridge } from "./renderer-BGMaUrVj.js";
 import { t as state } from "./state-DCjONcHK.js";
 import { t as selector } from "./selector-Ck_Pp9av.js";
-import { i as For } from "./control-oLADku43.js";
+import { i as For } from "./control-BF3geQKh.js";
 import { jsx, jsxs } from "./jsx-runtime.js";
-import { t as createIsland } from "./boot-DWe880Et.js";
+import { t as createIsland } from "./boot-Bd-j_BL5.js";
 //#region src/bench/components/benchmark-row.tsx
 function BenchmarkRow({ item, isSelected, onSelect, onRemove }) {
 	return /* @__PURE__ */ jsxs("tr", {
@@ -63,8 +63,8 @@ function BenchmarkTable({ rows, isSelected, onSelect, onRemove }) {
 installRendererBridge();
 const benchmarkMetadata = {
 	packageName: "@askrjs/askr",
-	packageVersion: "0.0.85",
-	buildLabel: "0.0.85-local"
+	packageVersion: "0.0.87",
+	buildLabel: "0.0.87-local"
 };
 function getBenchmarkMetadata() {
 	return { ...benchmarkMetadata };

package/dist/boot/index.d.ts

@@ -1,7 +1,7 @@
 import { l as ComponentFunction } from "../control-DhUZU4_V.js";
-import { W as RouteRegistry, w as RouteAuthOptions } from "../index-pIgGaXvS.js";
-import { v as DataRuntime } from "../index-5S-fi2xy.js";
-import { a as ScrollRestorationOptions } from "../navigate-NyIjQUwI.js";
+import { W as RouteRegistry, w as RouteAuthOptions } from "../index-BvNkcegT.js";
+import { v as DataRuntime } from "../index-SGxMZLAc.js";
+import { a as ScrollRestorationOptions } from "../navigate-B_fcLDAG.js";
 //#region src/boot/types.d.ts
 type IslandConfig = {
   root: Element | string;

package/dist/boot/index.js

@@ -1,2 +1,2 @@
-import { a as cleanupApp, i as hydrateSPA, n as createIslands, o as hasApp, r as createSPA, t as createIsland } from "../boot-DWe880Et.js";
+import { a as cleanupApp, i as hydrateSPA, n as createIslands, o as hasApp, r as createSPA, t as createIsland } from "../boot-Bd-j_BL5.js";
 export { cleanupApp, createIsland, createIslands, createSPA, hasApp, hydrateSPA };

package/dist/{boot-DWe880Et.js → boot-Bd-j_BL5.js}

@@ -1,19 +1,20 @@
 import { b as isDevelopmentEnvironment, r as flushRuntimeScheduler, v as logger, x as isProductionEnvironment } from "./access-Dpfoi4cA.js";
 import { n as Fragment, t as ELEMENT_TYPE } from "./jsx-C3IECePB.js";
-import { n as createComponentInstance, r as executeComponent } from "./component-internal-DcrLymUJ.js";
+import { n as createComponentInstance, r as executeComponent } from "./component-internal-uVCJAre6.js";
 import { t as cleanupComponent } from "./component-cleanup-BUfUleGZ.js";
 import { p as isPromiseLike } from "./lifecycle-batch-Dfpid9-A.js";
-import { a as setStaticChildSlotsCacheEnabled, c as endHydrationDirectListenerMode, d as discardHydrationListenerTransaction, i as registerDeferredHydrationBoundary, l as beginHydrationListenerTransaction, n as activateHydrationBoundary$1, o as withIntrinsicHydrationAdoption, r as clearDeferredHydrationBoundaries, s as beginHydrationDirectListenerMode, t as installRendererBridge, u as commitHydrationListenerTransaction } from "./renderer-CZzNtoj2.js";
+import { a as setStaticChildSlotsCacheEnabled, c as endHydrationDirectListenerMode, d as discardHydrationListenerTransaction, i as registerDeferredHydrationBoundary, l as beginHydrationListenerTransaction, n as activateHydrationBoundary$1, o as withIntrinsicHydrationAdoption, r as clearDeferredHydrationBoundaries, s as beginHydrationDirectListenerMode, t as installRendererBridge, u as commitHydrationListenerTransaction } from "./renderer-BGMaUrVj.js";
 import { _ as teardownNodeSubtree, d as removeAllListeners } from "./cleanup-c837KVij.js";
-import { S as pageRenderEnvelope, c as _applyManifest, d as getRouteRenderContext, f as getRouteRenderData, k as assertExecutionModel, m as resolveRouteRequest, o as reviveDeferredValue, p as hasRouteRenderData } from "./deferred-vUOy-awa.js";
-import { c as stopHydrationRenderPhase, o as startHydrationRenderPhase } from "./render-context-D-DFk2WN.js";
-import { I as lockRouteRegistration, P as hasRegisteredRoutes, _ as clearRouteState, m as _setActiveRouteAuthOptions } from "./route-matching-DHduNiGk.js";
-import { a as disposeDefaultPortalScope, t as DefaultPortal } from "./portal-BVWjAhNQ.js";
-import { r as validateCspNonce, t as CspNonceScope } from "./csp-nonce-Bc52OIVc.js";
-import { i as getDefaultDataRuntime } from "./data-runtime-D68YOo9L.js";
-import { a as hydrateDataRuntime } from "./query-registry-BL6rjGsO.js";
-import { o as createAppRenderRuntime, r as setServerLocation } from "./activity-Jd9CgEa3.js";
-import { f as registerAppInstance, g as unregisterAppInstance, i as resolveRouteMeta, o as configureScrollRestoration, r as reconcileRouteMeta, t as initializeNavigation } from "./navigate-b4GGxO_l.js";
+import { r as assertExecutionModel, t as _applyManifest } from "./manifest-D1P9uTlz.js";
+import { d as stopHydrationRenderPhase, l as startHydrationRenderPhase, v as pageRenderEnvelope } from "./render-context-D0Hoj9dW.js";
+import { r as validateCspNonce, t as CspNonceScope } from "./csp-nonce-CUscoNF1.js";
+import { i as getDefaultDataRuntime } from "./data-runtime-CnVeSvJz.js";
+import { a as hydrateDataRuntime } from "./query-registry-p_0kkieE.js";
+import { I as lockRouteRegistration, P as hasRegisteredRoutes, _ as clearRouteState, m as _setActiveRouteAuthOptions } from "./route-matching-DqULzZtC.js";
+import { a as resolveRouteRequest, i as hasRouteRenderData, m as reviveDeferredValue, n as getRouteRenderContext, r as getRouteRenderData } from "./resolution-BRmiFYvw.js";
+import { o as createAppRenderRuntime, r as setServerLocation } from "./activity-BnkhdIXm.js";
+import { f as registerAppInstance, g as unregisterAppInstance, i as resolveRouteMeta, o as configureScrollRestoration, r as reconcileRouteMeta, t as initializeNavigation } from "./navigate-DSATWfHh.js";
+import { n as disposeRegisteredDefaultPortalScope, r as getDefaultPortalHost } from "./default-portal-runtime-DvMvWJVp.js";
 import "./ssr-DSHd_Q9K.js";
 //#region src/boot/hydration.ts
 const DEFERRED_PAYLOAD = "__askr_deferred__";
@@ -268,7 +269,7 @@ function mountOrUpdate(rootElement, componentFn, options) {
 		if (isPromiseLike(out)) throw new Error("Async components are not supported. Components must return synchronously.");
 		const portalVNode = {
 			$$typeof: ELEMENT_TYPE,
-			type: DefaultPortal,
+			type: getDefaultPortalHost(),
 			props: { __askrAutoDefaultPortal: true },
 			key: "__default_portal"
 		};
@@ -337,7 +338,7 @@ function mountOrUpdate(rootElement, componentFn, options) {
 	}
 	attachCleanupForRoot(rootElement, instance);
 	registerRootCleanupCallback(rootElement, () => {
-		disposeDefaultPortalScope(instance.portalScope ?? instance);
+		disposeRegisteredDefaultPortalScope(instance.portalScope ?? instance);
 	});
 	executeComponent(instance);
 	flushRuntimeScheduler();
@@ -586,7 +587,7 @@ async function hydrateSPA(config) {
 		cspNonce: config.cspNonce
 	}));
 	if (shouldVerifyHydrationMarkup(config)) {
-		const { verifyHydrationSyncForUrl } = await import("./verify-hydration-C3QBBQqR.js");
+		const { verifyHydrationSyncForUrl } = await import("./verify-hydration-DkISyZCo.js");
 		if (!verifyHydrationSyncForUrl({
 			root: rootElement,
 			url: currentUrl,

package/dist/{component-internal-DcrLymUJ.js → component-internal-uVCJAre6.js}

@@ -668,7 +668,7 @@ function executeComponentSync(instance) {
 		const result = callWithContext(getExecutionContextFrame(instance.ownerFrame), instance.fn, instance.props, context);
 		if (trackRenderTime) {
 			const renderTime = Date.now() - renderStartTime;
-			if (renderTime > 5) warnInstanceOnce(instance, "slow-render", `[askr] Slow render detected: ${renderTime}ms. Consider optimizing component performance.`);
+			if (renderTime > 5) warnInstanceOnce(instance, "slow-render", `[askr] Slow render detected in ${instance.fn?.name || "<anonymous>"}: ${renderTime}ms. Consider optimizing component performance.`);
 		}
 		if (!instance.firstRenderComplete) instance.firstRenderComplete = true;
 		didComplete = true;

package/dist/control/index.js

@@ -1,2 +1,2 @@
-import { i as For, n as Match, r as Show, t as Case } from "../control-oLADku43.js";
+import { i as For, n as Match, r as Show, t as Case } from "../control-BF3geQKh.js";
 export { Case, For, Match, Show };

package/dist/{control-oLADku43.js → control-BF3geQKh.js}

@@ -1,7 +1,7 @@
 import { i as markEagerControlPrimitive, t as __CONTROL_BOUNDARY__ } from "./control-C-ApnFs1.js";
 import { b as isDevelopmentEnvironment } from "./access-Dpfoi4cA.js";
 import { n as Fragment } from "./jsx-C3IECePB.js";
-import { m as createShowState, p as createCaseState, s as useForState } from "./for-internal-B_mnQhan.js";
+import { m as createShowState, p as createCaseState, s as useForState } from "./for-internal-Dxf3iZ9E.js";
 import { t as createFineGrainedEffect } from "./effect-lnxQIpJG.js";
 import { t as state } from "./state-DCjONcHK.js";
 //#region src/control/shared.ts

package/dist/{csp-nonce-Bc52OIVc.js → csp-nonce-CUscoNF1.js}

@@ -1,4 +1,4 @@
-import { g as readScope, u as defineScope } from "./component-internal-DcrLymUJ.js";
+import { g as readScope, u as defineScope } from "./component-internal-uVCJAre6.js";
 //#region src/common/url.ts
 const SAFE_URL_SCHEMES = /* @__PURE__ */ new Set([
 	"http",

package/dist/data/index.d.ts

@@ -1,2 +1,2 @@
-import { A as ServerQueryHandler, C as Query, D as QueryPrefetchContext, E as QueryKeyPart, O as QueryScope, S as Mutation, T as QueryDefinition, a as defineServerQueries, b as InvalidateOnIntervalOptions, c as prefetchQuery, d as invalidateOnInterval, f as queryScope, g as createMutation, h as createQuery, i as defineQuery, k as QueryStaleReason, l as serveQuery, m as getDefaultDataRuntime, n as ServerQueryRegistry, o as dehydrateDataRuntime, p as createDataRuntime, r as createQueryPrefetchContext, s as hydrateDataRuntime, t as ServerQueryEntry, u as invalidate, v as DataRuntime, w as QueryConsistency, x as InvalidateOptions, y as DataRuntimeOptions } from "../index-5S-fi2xy.js";
+import { A as ServerQueryHandler, C as Query, D as QueryPrefetchContext, E as QueryKeyPart, O as QueryScope, S as Mutation, T as QueryDefinition, a as defineServerQueries, b as InvalidateOnIntervalOptions, c as prefetchQuery, d as invalidateOnInterval, f as queryScope, g as createMutation, h as createQuery, i as defineQuery, k as QueryStaleReason, l as serveQuery, m as getDefaultDataRuntime, n as ServerQueryRegistry, o as dehydrateDataRuntime, p as createDataRuntime, r as createQueryPrefetchContext, s as hydrateDataRuntime, t as ServerQueryEntry, u as invalidate, v as DataRuntime, w as QueryConsistency, x as InvalidateOptions, y as DataRuntimeOptions } from "../index-SGxMZLAc.js";
 export { type DataRuntime, type DataRuntimeOptions, type InvalidateOnIntervalOptions, type InvalidateOptions, type Mutation, type Query, type QueryConsistency, type QueryDefinition, type QueryKeyPart, type QueryPrefetchContext, type QueryScope, type QueryStaleReason, type ServerQueryEntry, type ServerQueryHandler, type ServerQueryRegistry, createDataRuntime, createMutation, createQuery, createQueryPrefetchContext, defineQuery, defineServerQueries, dehydrateDataRuntime, getDefaultDataRuntime, hydrateDataRuntime, invalidate, invalidateOnInterval, prefetchQuery, queryScope, serveQuery };

package/dist/data/index.js

@@ -1,4 +1,4 @@
-import { i as getDefaultDataRuntime, t as createDataRuntime } from "../data-runtime-D68YOo9L.js";
-import { a as queryScope, i as invalidateOnInterval, n as createMutation, r as invalidate, t as createQuery } from "../data-Dkqb8_QP.js";
-import { a as hydrateDataRuntime, i as dehydrateDataRuntime, n as defineQuery, o as prefetchQuery, r as defineServerQueries, s as serveQuery, t as createQueryPrefetchContext } from "../query-registry-BL6rjGsO.js";
+import { i as getDefaultDataRuntime, t as createDataRuntime } from "../data-runtime-CnVeSvJz.js";
+import { a as queryScope, i as invalidateOnInterval, n as createMutation, r as invalidate, t as createQuery } from "../data-CXZ-FOa7.js";
+import { a as hydrateDataRuntime, i as dehydrateDataRuntime, n as defineQuery, o as prefetchQuery, r as defineServerQueries, s as serveQuery, t as createQueryPrefetchContext } from "../query-registry-p_0kkieE.js";
 export { createDataRuntime, createMutation, createQuery, createQueryPrefetchContext, defineQuery, defineServerQueries, dehydrateDataRuntime, getDefaultDataRuntime, hydrateDataRuntime, invalidate, invalidateOnInterval, prefetchQuery, queryScope, serveQuery };

package/dist/{data-Dkqb8_QP.js → data-CXZ-FOa7.js}

@@ -1,9 +1,9 @@
 import { n as enqueueRuntimeTask, v as logger } from "./access-Dpfoi4cA.js";
 import { f as getCurrentComponentInstance, i as claimHookIndex } from "./component-scope-DzJEbYGE.js";
 import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B5NtV7V0.js";
-import { n as getActiveRenderContext } from "./render-context-D-DFk2WN.js";
-import { i as routeActive, n as documentVisible, o as timer, s as windowFocused } from "./lifecycle-operations-BrYrBsXY.js";
-import { a as getMutationSlotStore, c as resolveDataRuntimeState, i as getDefaultDataRuntime, n as ensureMutationCleanup, o as getQuerySlotStore, r as ensureQueryCleanup, s as invalidateQueriesForRuntime } from "./data-runtime-D68YOo9L.js";
+import { n as getActiveRenderContext } from "./render-context-D0Hoj9dW.js";
+import { i as routeActive, n as documentVisible, o as timer, s as windowFocused } from "./lifecycle-operations-DTO93Hrl.js";
+import { a as getMutationSlotStore, c as resolveDataRuntimeState, i as getDefaultDataRuntime, n as ensureMutationCleanup, o as getQuerySlotStore, r as ensureQueryCleanup, s as invalidateQueriesForRuntime } from "./data-runtime-CnVeSvJz.js";
 //#region src/data/query-key.ts
 function serializeQueryKeyNumber(part) {
 	if (Number.isNaN(part)) return "NaN";
@@ -500,7 +500,9 @@ function createLegacyQuery(options) {
 	const instance = getCurrentComponentInstance();
 	const runtimeState = resolveDataRuntimeState(options.runtime);
 	const cache = runtimeState.queryCache;
+	const override = runtimeState.queryTestOverrides.get(options.key);
 	if (!instance) {
+		if (override) return override;
 		let cell = cache.get(options.key);
 		if (!cell) {
 			cell = new QueryCell(options, options.key, cache);
@@ -518,6 +520,7 @@ function createLegacyQuery(options) {
 		return existingSlot.cell;
 	}
 	if (existingSlot) existingSlot.cell.detach(instance._ownershipGeneration, hookIndex);
+	if (override) return override;
 	let cell = cache.get(options.key);
 	if (!cell) {
 		cell = new QueryCell(options, options.key, cache);

package/dist/{data-runtime-D68YOo9L.js → data-runtime-CnVeSvJz.js}

@@ -1,4 +1,4 @@
-import { n as getActiveRenderContext } from "./render-context-D-DFk2WN.js";
+import { n as getActiveRenderContext } from "./render-context-D0Hoj9dW.js";
 //#region src/data/invalidation-listeners.ts
 const invalidationListeners = /* @__PURE__ */ new Set();
 function addInvalidationListener(listener) {
@@ -14,22 +14,24 @@ function emitInvalidation(event) {
 //#region src/data/data-runtime.ts
 const dataRuntimeStates = /* @__PURE__ */ new WeakMap();
 const dataRuntimeByQueryCache = /* @__PURE__ */ new WeakMap();
-function createDataRuntimeState(queryCache, queryData) {
+function createDataRuntimeState(queryCache, queryData, queryTestOverrides) {
 	return {
 		queryCache,
 		queryData,
 		querySlotsByGeneration: /* @__PURE__ */ new WeakMap(),
 		mutationSlotsByGeneration: /* @__PURE__ */ new WeakMap(),
 		queryCleanupRegistered: /* @__PURE__ */ new WeakSet(),
-		mutationCleanupRegistered: /* @__PURE__ */ new WeakSet()
+		mutationCleanupRegistered: /* @__PURE__ */ new WeakSet(),
+		queryTestOverrides
 	};
 }
 function createDataRuntime(options = {}) {
 	const runtime = Object.freeze({
 		queryCache: options.queryCache ?? /* @__PURE__ */ new Map(),
-		queryData: options.queryData ?? /* @__PURE__ */ new Map()
+		queryData: options.queryData ?? /* @__PURE__ */ new Map(),
+		queryTestOverrides: options.queryTestOverrides ?? /* @__PURE__ */ new Map()
 	});
-	dataRuntimeStates.set(runtime, createDataRuntimeState(runtime.queryCache, runtime.queryData));
+	dataRuntimeStates.set(runtime, createDataRuntimeState(runtime.queryCache, runtime.queryData, runtime.queryTestOverrides));
 	dataRuntimeByQueryCache.set(runtime.queryCache, runtime);
 	return runtime;
 }

package/dist/default-portal-runtime-DvMvWJVp.js

@@ -0,0 +1,20 @@
+//#region src/common/default-portal-runtime.ts
+let defaultPortalRuntime = null;
+function InactiveDefaultPortalHost() {
+	return null;
+}
+/** Register the optional portal capability when its public module is loaded. */
+function registerDefaultPortalRuntime(runtime) {
+	defaultPortalRuntime = runtime;
+}
+function getDefaultPortalHost() {
+	return defaultPortalRuntime?.host ?? InactiveDefaultPortalHost;
+}
+function clearRegisteredDefaultPortalForInstance(instance) {
+	defaultPortalRuntime?.clearForInstance(instance);
+}
+function disposeRegisteredDefaultPortalScope(scope) {
+	defaultPortalRuntime?.disposeScope(scope);
+}
+//#endregion
+export { registerDefaultPortalRuntime as i, disposeRegisteredDefaultPortalScope as n, getDefaultPortalHost as r, clearRegisteredDefaultPortalForInstance as t };

package/dist/{authoring-DdQ3pHqt.js → deferred-_DaSfpsr.js}

@@ -1,6 +1,9 @@
-import { f as getCurrentComponentInstance } from "./component-scope-DzJEbYGE.js";
-import { A as getExecutionModel, T as createRouteHandler } from "./deferred-vUOy-awa.js";
-import { A as getDefaultRouteBasePath, C as getCurrentInheritedPolicies, D as getCurrentPathPrefix, E as getCurrentPageScope, F as insertRecordSorted, H as computeRank, L as pushRegistrationScope, N as hasActivePageScope, O as getCurrentScopeKind, S as getCurrentInheritedMeta, T as getCurrentPageChain, U as normalizeRouteSegmentName, W as parseSegments, g as assertRouteRegistrationUnlocked, h as addRouteToStores, w as getCurrentLayoutChain, x as getCurrentInheritedAuthRequirements } from "./route-matching-DHduNiGk.js";
+import { d as getCurrentAppRenderRuntime, f as getCurrentComponentInstance } from "./component-scope-DzJEbYGE.js";
+import { i as getExecutionModel } from "./manifest-D1P9uTlz.js";
+import { n as getActiveRenderContext, r as getCurrentRenderData } from "./render-context-D0Hoj9dW.js";
+import { t as resource } from "./resource-operation-B94oj6xT.js";
+import { A as getDefaultRouteBasePath, C as getCurrentInheritedPolicies, D as getCurrentPathPrefix, E as getCurrentPageScope, F as insertRecordSorted, H as computeRank, L as pushRegistrationScope, N as hasActivePageScope, O as getCurrentScopeKind, S as getCurrentInheritedMeta, T as getCurrentPageChain, U as normalizeRouteSegmentName, W as parseSegments, g as assertRouteRegistrationUnlocked, h as addRouteToStores, w as getCurrentLayoutChain, x as getCurrentInheritedAuthRequirements } from "./route-matching-DqULzZtC.js";
+import { _ as createRouteHandler, d as DEFERRED_BOUNDARY, p as isDeferred, s as guardHydratedRouteData } from "./resolution-BRmiFYvw.js";
 import { allOf } from "@askrjs/auth";
 //#region src/router/access.ts
 function compileNodePolicies(node) {
@@ -200,4 +203,78 @@ function route(path, Component, options) {
 	});
 }
 //#endregion
-export { route as a, page as i, group as n, index as r, fallback as t };
+//#region src/router/deferred.tsx
+function abortError() {
+	const error = /* @__PURE__ */ new Error("Deferred route data was aborted.");
+	error.name = "AbortError";
+	return error;
+}
+function awaitWithSignal(promise, signal) {
+	if (!signal) return promise;
+	if (signal.aborted) return Promise.reject(abortError());
+	return new Promise((resolve, reject) => {
+		const abort = () => reject(abortError());
+		signal.addEventListener("abort", abort, { once: true });
+		promise.then((value) => {
+			signal.removeEventListener("abort", abort);
+			resolve(value);
+		}, (error) => {
+			signal.removeEventListener("abort", abort);
+			reject(error);
+		});
+	});
+}
+async function resolveDeferredValues(input, signal) {
+	const seen = /* @__PURE__ */ new Set();
+	const visit = async (value) => {
+		if (!value || typeof value !== "object") return;
+		if (isDeferred(value)) {
+			const resolved = await awaitWithSignal(value.promise, signal);
+			await visit(resolved);
+			return;
+		}
+		if (seen.has(value)) return;
+		seen.add(value);
+		const children = Array.isArray(value) ? value : Object.values(value);
+		await Promise.all(children.map(visit));
+	};
+	await visit(input);
+	return input;
+}
+function routeData() {
+	const envelope = getCurrentRenderData();
+	if (envelope) return guardHydratedRouteData(envelope.route, envelope.framework);
+	const runtime = getCurrentAppRenderRuntime();
+	if (!runtime?.hasRoute) throw new Error("routeData() can only be read while rendering a route with loader data.");
+	return guardHydratedRouteData(runtime.route, runtime.framework);
+}
+function rejectedChild(props, error) {
+	return typeof props.rejected === "function" ? props.rejected(error) : props.rejected ?? null;
+}
+function Resolve(props) {
+	if (props.value.state === "fulfilled") return props.children(props.value.value);
+	if (props.value.state === "rejected") return rejectedChild(props, props.value.error);
+	const renderContext = getActiveRenderContext();
+	if (renderContext) {
+		const id = `d:${renderContext.deferredBoundaries.length}`;
+		renderContext.deferredBoundaries.push({
+			id,
+			promise: props.value.promise,
+			fulfilled: (value) => props.children(value),
+			rejected: (error) => rejectedChild(props, error)
+		});
+		return {
+			type: DEFERRED_BOUNDARY,
+			props: {
+				id,
+				pending: props.pending ?? null
+			}
+		};
+	}
+	const result = resource(() => props.value.promise, [props.value]);
+	if (result.error) return rejectedChild(props, result.error);
+	if (result.pending || result.value === null) return props.pending ?? null;
+	return props.children(result.value);
+}
+//#endregion
+export { group as a, route as c, fallback as i, resolveDeferredValues as n, index as o, routeData as r, page as s, Resolve as t };

package/dist/{for-internal-B_mnQhan.js → for-internal-Dxf3iZ9E.js}

@@ -1,7 +1,7 @@
 import { n as _isDOMElement } from "./vnode-D24p6IW2.js";
 import { b as isDevelopmentEnvironment, o as getRuntimeRenderer, v as logger } from "./access-Dpfoi4cA.js";
 import { h as getCurrentStateIndex, i as claimHookIndex, o as clearRenderTracking, p as getCurrentInstance } from "./component-scope-DzJEbYGE.js";
-import { _ as rebaseVNodeTreeWithContextFrame, m as haveEquivalentContextFrames, n as createComponentInstance, s as renderScopedComponent } from "./component-internal-DcrLymUJ.js";
+import { _ as rebaseVNodeTreeWithContextFrame, m as haveEquivalentContextFrames, n as createComponentInstance, s as renderScopedComponent } from "./component-internal-uVCJAre6.js";
 import { d as shouldCoalesceFineGrainedItemReads, l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B5NtV7V0.js";
 import { i as unregisterOwnedChildScope, r as registerOwnedChildScope, t as cleanupComponent } from "./component-cleanup-BUfUleGZ.js";
 import { o as finalizeInlineReadSubscriptions, u as registerLifecycleTransaction } from "./lifecycle-batch-Dfpid9-A.js";

package/dist/foundations/index.d.ts

@@ -1,3 +1,3 @@
 import { r as JSXElement } from "../jsx-Dvr2SGRG.js";
-import { _ as Portal, c as Presence, d as SlotProps, g as DefaultPortal, h as layout, l as PresenceProps, m as LayoutComponent, u as Slot, v as PortalProps, y as definePortal } from "../index-Bkh9S9-t.js";
+import { c as DefaultPortal, d as definePortal, f as Presence, h as SlotProps, l as Portal, m as Slot, p as PresenceProps, u as PortalProps, v as LayoutComponent, y as layout } from "../index-DflhL1h8.js";
 export { DefaultPortal, type JSXElement, type LayoutComponent, Portal, type PortalProps, Presence, type PresenceProps, Slot, type SlotProps, definePortal, layout };

package/dist/foundations/index.js

@@ -1,3 +1,2 @@
-import { a as layout, i as Slot, r as Presence } from "../structures-DSLF_iis.js";
-import { i as definePortal, n as Portal, t as DefaultPortal } from "../portal-BVWjAhNQ.js";
+import { a as definePortal, c as layout, i as Portal, o as Presence, r as DefaultPortal, s as Slot } from "../structures-DsOm-clq.js";
 export { DefaultPortal, Portal, Presence, Slot, definePortal, layout };

package/dist/foundations/structures/index.d.ts

@@ -1,3 +1,3 @@
 import { r as JSXElement } from "../../jsx-Dvr2SGRG.js";
-import { _ as Portal, a as Collection, c as Presence, d as SlotProps, f as cloneElement, g as DefaultPortal, h as layout, i as createLayer, l as PresenceProps, m as LayoutComponent, n as LayerManager, o as CollectionItem, p as isElement, r as LayerOptions, s as createCollection, t as Layer, u as Slot, v as PortalProps, y as definePortal } from "../../index-Bkh9S9-t.js";
+import { _ as isElement, a as Collection, c as DefaultPortal, d as definePortal, f as Presence, g as cloneElement, h as SlotProps, i as createLayer, l as Portal, m as Slot, n as LayerManager, o as CollectionItem, p as PresenceProps, r as LayerOptions, s as createCollection, t as Layer, u as PortalProps, v as LayoutComponent, y as layout } from "../../index-DflhL1h8.js";
 export { type Collection, type CollectionItem, DefaultPortal, type JSXElement, type Layer, type LayerManager, type LayerOptions, type LayoutComponent, Portal, type PortalProps, Presence, type PresenceProps, Slot, type SlotProps, cloneElement, createCollection, createLayer, definePortal, isElement, layout };

package/dist/foundations/structures/index.js

@@ -1,3 +1,2 @@
-import { a as layout, i as Slot, n as createCollection, o as cloneElement, r as Presence, s as isElement, t as createLayer } from "../../structures-DSLF_iis.js";
-import { i as definePortal, n as Portal, t as DefaultPortal } from "../../portal-BVWjAhNQ.js";
+import { a as definePortal, c as layout, i as Portal, l as cloneElement, n as createCollection, o as Presence, r as DefaultPortal, s as Slot, t as createLayer, u as isElement } from "../../structures-DsOm-clq.js";
 export { DefaultPortal, Portal, Presence, Slot, cloneElement, createCollection, createLayer, definePortal, isElement, layout };

package/dist/{index-pIgGaXvS.d.ts → index-BvNkcegT.d.ts}

@@ -1,7 +1,7 @@
 import { a as ComponentInstance, b as StateTuple, i as ReadableSource, n as ChildScope, o as Scope, r as DOMRange, u as RenderableChild } from "./control-DhUZU4_V.js";
 import { r as JSXElement } from "./jsx-Dvr2SGRG.js";
 import { t as Scheduler } from "./scheduler-CmLO4Dfm.js";
-import { D as QueryPrefetchContext, _ as CoreTelemetry } from "./index-5S-fi2xy.js";
+import { D as QueryPrefetchContext, _ as CoreTelemetry } from "./index-SGxMZLAc.js";
 import "./jsx-runtime-C-oIHX9X.js";
 import { AuthContext, AuthRequirement } from "@askrjs/auth";
 import { InferSchema, ObjectSchema } from "@askrjs/schema";

package/dist/{index-Bkh9S9-t.d.ts → index-DflhL1h8.d.ts}

@@ -1,20 +1,6 @@
 import { u as RenderableChild } from "./control-DhUZU4_V.js";
 import { r as JSXElement } from "./jsx-Dvr2SGRG.js";
 import "./types-C9YcqVpk.js";
-//#region src/runtime/portal.d.ts
-interface Portal<T extends RenderableChild = RenderableChild> {
-  (): T | JSXElement | null | undefined;
-  render(props: {
-    children?: T;
-  }): unknown;
-}
-interface PortalProps {
-  children?: RenderableChild;
-}
-declare function definePortal<T extends RenderableChild = RenderableChild>(): Portal<T>;
-declare const DefaultPortal: Portal<RenderableChild>;
-declare function Portal(props: PortalProps): JSXElement | null;
-//#endregion
 //#region src/foundations/structures/layout.d.ts
 /**
  * Layout helper.
@@ -109,6 +95,20 @@ interface PresenceProps {
  */
 declare function Presence({ present, children }: PresenceProps): JSXElement | null;
 //#endregion
+//#region src/runtime/portal.d.ts
+interface Portal<T extends RenderableChild = RenderableChild> {
+  (): T | JSXElement | null | undefined;
+  render(props: {
+    children?: T;
+  }): unknown;
+}
+interface PortalProps {
+  children?: RenderableChild;
+}
+declare function definePortal<T extends RenderableChild = RenderableChild>(): Portal<T>;
+declare const DefaultPortal: Portal<RenderableChild>;
+declare function Portal(props: PortalProps): JSXElement | null;
+//#endregion
 //#region src/foundations/structures/collection.d.ts
 /**
  * createCollection
@@ -280,4 +280,4 @@ declare function createLayer(): LayerManager;
  * }
  */
 //#endregion
-export { Portal as _, Collection as a, Presence as c, SlotProps as d, cloneElement as f, DefaultPortal as g, layout as h, createLayer as i, PresenceProps as l, LayoutComponent as m, LayerManager as n, CollectionItem as o, isElement as p, LayerOptions as r, createCollection as s, Layer as t, Slot as u, PortalProps as v, definePortal as y };
+export { isElement as _, Collection as a, DefaultPortal as c, definePortal as d, Presence as f, cloneElement as g, SlotProps as h, createLayer as i, Portal as l, Slot as m, LayerManager as n, CollectionItem as o, PresenceProps as p, LayerOptions as r, createCollection as s, Layer as t, PortalProps as u, LayoutComponent as v, layout as y };

package/dist/{index-5S-fi2xy.d.ts → index-SGxMZLAc.d.ts}

@@ -4,10 +4,13 @@ type QueryStaleReason = 'aborted' | 'error' | 'inconsistent';
 interface DataRuntime {
   readonly queryCache: Map<string, unknown>;
   readonly queryData: Map<string, unknown>;
+  /** Test-only query overrides keyed by the canonical query key. */
+  readonly queryTestOverrides: Map<string, unknown>;
 }
 interface DataRuntimeOptions {
   queryCache?: Map<string, unknown>;
   queryData?: Map<string, unknown>;
+  queryTestOverrides?: Map<string, unknown>;
 }
 interface QueryDefinition<TInput, TResult extends {}> {
   readonly key: (input: TInput) => string;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { b as StateTuple, c as readScope, o as Scope, s as defineScope, v as State, x as state, y as StateSetter } from "./control-DhUZU4_V.js";
 import { s as Props, t as Fragment } from "./jsx-Dvr2SGRG.js";
-import { $ as cspNonce, Q as CspNonceScope, at as AskrRuntimeOptions, c as createRef, ct as createRuntime, d as registerSSRStyle, et as Selector, it as AskrRuntime, lt as getDefaultRuntime, nt as Derived, ot as RuntimeKeyedReorderDecision, rt as derive, s as Ref, st as RuntimeRendererHost, tt as selector, ut as getSignal } from "./index-pIgGaXvS.js";
+import { $ as cspNonce, Q as CspNonceScope, at as AskrRuntimeOptions, c as createRef, ct as createRuntime, d as registerSSRStyle, et as Selector, it as AskrRuntime, lt as getDefaultRuntime, nt as Derived, ot as RuntimeKeyedReorderDecision, rt as derive, s as Ref, st as RuntimeRendererHost, tt as selector, ut as getSignal } from "./index-BvNkcegT.js";
 import { a as Show, c as ForProps, i as MatchProps, n as CaseProps, o as ShowProps, r as Match, s as For, t as Case } from "./index-r-nt13FE.js";
-import { A as ServerQueryHandler, D as QueryPrefetchContext, T as QueryDefinition, a as defineServerQueries, c as prefetchQuery, h as createQuery, i as defineQuery, l as serveQuery, o as dehydrateDataRuntime, s as hydrateDataRuntime, v as DataRuntime } from "./index-5S-fi2xy.js";
+import { A as ServerQueryHandler, D as QueryPrefetchContext, T as QueryDefinition, a as defineServerQueries, c as prefetchQuery, h as createQuery, i as defineQuery, l as serveQuery, o as dehydrateDataRuntime, s as hydrateDataRuntime, v as DataRuntime } from "./index-SGxMZLAc.js";
 import { i as jsxs, n as jsx } from "./jsx-runtime-Cr1jspx9.js";
 export { AskrRuntime, type AskrRuntimeOptions, Case, type CaseProps, CspNonceScope, type DataRuntime, type Derived, For, type ForProps, Fragment, Match, type MatchProps, type Props, type QueryDefinition, type QueryPrefetchContext, type Ref, type RuntimeKeyedReorderDecision, type RuntimeRendererHost, type Scope, type Selector, type ServerQueryHandler, Show, type ShowProps, type State, type StateSetter, type StateTuple, createQuery, createRef, createRuntime, cspNonce, defineQuery, defineScope, defineServerQueries, dehydrateDataRuntime, derive, getDefaultRuntime, getSignal, hydrateDataRuntime, jsx, jsxs, prefetchQuery, readScope, registerSSRStyle, selector, serveQuery, state };