@askrjs/askr 0.0.91 → 0.0.94

package/dist/data/index.d.ts

@@ -1,3 +1,2 @@
-import { a as Mutation, c as QueryConsistency, f as QueryPrefetchContext, h as ServerQueryHandler, i as InvalidateOptions, l as QueryDefinition, m as QueryStaleReason, n as DataRuntimeOptions, o as MutationOptions, p as QueryScope, r as InvalidateOnIntervalOptions, s as Query, t as DataRuntime, u as QueryKeyPart } from "../types-iAmDSV6o.js";
-import { a as defineServerQueries, c as prefetchQuery, d as invalidateOnInterval, f as queryScope, g as createMutation, h as createQuery, i as defineQuery, 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 } from "../index-CPlPDbEY.js";
+import { Bt as DataRuntimeOptions, Gt as Query, Ht as InvalidateOptions, Jt as QueryKeyPart, Kt as QueryConsistency, Qt as ServerQueryHandler, S as createMutation, Ut as Mutation, Vt as InvalidateOnIntervalOptions, Wt as MutationOptions, Xt as QueryScope, Yt as QueryPrefetchContext, Zt as QueryStaleReason, _ as invalidateOnInterval, b as getDefaultDataRuntime, c as ServerQueryRegistry, d as defineServerQueries, f as dehydrateDataRuntime, g as invalidate, h as serveQuery, l as createQueryPrefetchContext, m as prefetchQuery, p as hydrateDataRuntime, qt as QueryDefinition, s as ServerQueryEntry, u as defineQuery, v as queryScope, x as createQuery, y as createDataRuntime, zt as DataRuntime } from "../index-KQ7Vl4-8.js";
 export { type DataRuntime, type DataRuntimeOptions, type InvalidateOnIntervalOptions, type InvalidateOptions, type Mutation, type MutationOptions, 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-wbooGyu7.js";
-import { c as queryScope, n as createMutation, o as invalidate, s as invalidateOnInterval, t as createQuery } from "../data-Bh_3OETq.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-B4LpVtlT.js";
+import { i as getDefaultDataRuntime, t as createDataRuntime } from "../data-runtime-JxoRgrrt.js";
+import { c as queryScope, n as createMutation, o as invalidate, s as invalidateOnInterval, t as createQuery } from "../data-DYqokZzc.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-CimB1YeW.js";
 export { createDataRuntime, createMutation, createQuery, createQueryPrefetchContext, defineQuery, defineServerQueries, dehydrateDataRuntime, getDefaultDataRuntime, hydrateDataRuntime, invalidate, invalidateOnInterval, prefetchQuery, queryScope, serveQuery };

package/dist/{data-Bh_3OETq.js → data-DYqokZzc.js}

@@ -1,9 +1,9 @@
-import { n as enqueueRuntimeTask, v as logger } from "./access-Dpfoi4cA.js";
-import { d as getCurrentAppRenderRuntime, 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 enqueueRuntimeTask, y as logger } from "./access-d_DCdwqn.js";
+import { d as getCurrentAppRenderRuntime, f as getCurrentComponentInstance, i as claimHookIndex } from "./component-scope-4I3yEMkb.js";
+import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-BsdGWsDE.js";
 import { n as getActiveRenderContext } from "./render-context-B7ohlh6t.js";
-import { i as routeActive, n as documentVisible, o as timer, s as windowFocused } from "./lifecycle-operations-CMK1AN2C.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-wbooGyu7.js";
+import { i as routeActive, n as documentVisible, o as timer, s as windowFocused } from "./lifecycle-operations-Qxq6ABrC.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-JxoRgrrt.js";
 //#region src/data/query-key.ts
 function serializeQueryKeyNumber(part) {
 	if (Number.isNaN(part)) return "NaN";
@@ -44,13 +44,19 @@ function createQueryScope(namespace, invalidate) {
 }
 //#endregion
 //#region src/data/invalidation.ts
+/** Mark all cached queries whose key starts with `prefix` as stale, triggering a refresh. */
 function invalidate(prefix, options) {
 	invalidateQueriesForRuntime(resolveDataRuntimeState(options?.runtime), prefix, options?.markPendingWrite ?? false);
 }
+/** Create a {@link QueryScope} that namespaces keys and invalidations under `namespace`. */
 function queryScope(namespace) {
 	return createQueryScope(namespace, invalidate);
 }
 const INVALIDATE_ON_INTERVAL_OPTIONS_ERROR = "[Askr] invalidateOnInterval() requires an options object with a finite numeric intervalMs.";
+/**
+* Periodically invalidate queries matching `prefix` on a fixed interval,
+* optionally gated by active route, document visibility, or window focus.
+*/
 function invalidateOnInterval(prefix, options) {
 	if (!options || typeof options !== "object" || typeof options.intervalMs !== "number" || !Number.isFinite(options.intervalMs)) throw new Error(INVALIDATE_ON_INTERVAL_OPTIONS_ERROR);
 	const runtimeState = resolveDataRuntimeState(options.runtime);
@@ -190,6 +196,11 @@ var MutationCell = class {
 		});
 	}
 };
+/**
+* Create a reactive {@link Mutation} cell bound to the current component,
+* running `options.action` on `execute()` and optionally invalidating
+* affected query prefixes on success.
+*/
 function createMutation(options) {
 	if (options.key !== void 0 && options.key.length === 0) throw new TypeError("createMutation key must be a non-empty string.");
 	const instance = getCurrentComponentInstance();
@@ -339,12 +350,12 @@ var QueryCell = class {
 	}
 	ensureStarted() {
 		if (this.destroyed || this.state.data !== null || this.pendingRefresh || this.startQueued || this.options.skipInitialFetch) return;
-		this.queueStart("initial");
+		this.queueStart();
 	}
 	refresh() {
 		if (this.destroyed) return Promise.resolve();
 		if (this.pendingRefresh) return this.pendingRefresh;
-		this.queueStart("manual");
+		this.queueStart();
 		return this.pendingRefresh ?? Promise.resolve();
 	}
 	invalidate() {
@@ -353,7 +364,7 @@ var QueryCell = class {
 			this.controller?.abort();
 			this.finishPendingRefresh(this.pendingRefreshToken);
 		}
-		this.queueStart("invalidate");
+		this.queueStart();
 	}
 	markPendingWrite() {
 		if (this.destroyed) return;
@@ -367,7 +378,7 @@ var QueryCell = class {
 			staleReason: null
 		});
 	}
-	queueStart(reason) {
+	queueStart() {
 		if (this.destroyed) return;
 		this.startQueued = true;
 		const token = ++this.pendingRefreshToken;
@@ -379,7 +390,7 @@ var QueryCell = class {
 					this.finishPendingRefresh(token);
 					return;
 				}
-				this.start(reason).finally(() => {
+				this.start().finally(() => {
 					this.finishPendingRefresh(token);
 				});
 			});
@@ -400,7 +411,7 @@ var QueryCell = class {
 		};
 		notifySource(this.source);
 	}
-	async start(reason) {
+	async start() {
 		if (this.destroyed) return;
 		this.generation += 1;
 		const generation = this.generation;
@@ -412,7 +423,7 @@ var QueryCell = class {
 			loading: !hasData,
 			refreshing: hasData,
 			stale: hasData,
-			consistency: reason === "pending-write" ? "pending-write" : hasData ? "refreshing" : "fresh",
+			consistency: hasData ? "refreshing" : "fresh",
 			error: null,
 			staleReason: null
 		});

package/dist/{data-runtime-wbooGyu7.js → data-runtime-JxoRgrrt.js}

@@ -1,4 +1,4 @@
-import { d as getCurrentAppRenderRuntime } from "./component-scope-DzJEbYGE.js";
+import { d as getCurrentAppRenderRuntime } from "./component-scope-4I3yEMkb.js";
 import { n as getActiveRenderContext } from "./render-context-B7ohlh6t.js";
 //#region src/data/invalidation-listeners.ts
 const invalidationListeners = /* @__PURE__ */ new Set();
@@ -27,6 +27,7 @@ function createDataRuntimeState(queryCache, queryData, queryTestOverrides, mutat
 		mutationTestOverrides
 	};
 }
+/** Create a new, isolated {@link DataRuntime} with its own query/mutation caches. */
 function createDataRuntime(options = {}) {
 	const runtime = Object.freeze({
 		queryCache: options.queryCache ?? /* @__PURE__ */ new Map(),
@@ -39,6 +40,7 @@ function createDataRuntime(options = {}) {
 	return runtime;
 }
 const defaultDataRuntime = createDataRuntime();
+/** Get the process-wide default {@link DataRuntime} used when none is provided explicitly. */
 function getDefaultDataRuntime() {
 	return defaultDataRuntime;
 }

package/dist/{deferred-D6nZaIPs.js → deferred-BS0Xpstg.js}

@@ -1,9 +1,9 @@
-import { d as getCurrentAppRenderRuntime, f as getCurrentComponentInstance } from "./component-scope-DzJEbYGE.js";
-import { i as getExecutionModel } from "./manifest-fBb2ynKL.js";
+import { d as getCurrentAppRenderRuntime, f as getCurrentComponentInstance } from "./component-scope-4I3yEMkb.js";
+import { i as getExecutionModel } from "./manifest-D6rfj_jC.js";
 import { n as getActiveRenderContext, r as getCurrentRenderData } from "./render-context-B7ohlh6t.js";
-import { t as resource } from "./resource-operation-whZDJAYv.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-xlgdQXg_.js";
-import { _ as createRouteHandler, d as DEFERRED_BOUNDARY, p as isDeferred, s as guardHydratedRouteData } from "./resolution-C9A31xQi.js";
+import { t as resource } from "./resource-operation-CLQXCn1p.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-Bo6UqG-5.js";
+import { _ as createRouteHandler, d as DEFERRED_BOUNDARY, p as isDeferred, s as guardHydratedRouteData } from "./resolution-D8PgnTzh.js";
 import { allOf } from "@askrjs/auth";
 //#region src/router/access.ts
 function compileNodePolicies(node) {
@@ -167,12 +167,14 @@ function page(path, Component, optionsOrFn, maybeFn) {
 	if (typeof fn !== "function") throw new Error("page(path, Component, fn) requires a route definition callback as the final argument.");
 	pushPageScope(path, Component, options, fn);
 }
+/** Declare the index route for the enclosing `page()` scope. */
 function index(Component, options) {
 	const pageScope = getCurrentPageScope();
 	if (pageScope?.hasIndex) throw new Error("page() cannot declare multiple index routes.");
 	if (pageScope) pageScope.hasIndex = true;
 	registerRouteAtResolvedPath(resolveIndexPath(), Component, options);
 }
+/** Declare the catch-all `/*` fallback route for the enclosing scope. */
 function fallback(Component) {
 	if (hasActivePageScope()) {
 		if (getCurrentScopeKind() !== "page") throw new Error("fallback() inside page() must be declared directly in the page scope, not inside nested group().");
@@ -225,6 +227,7 @@ function awaitWithSignal(promise, signal) {
 		});
 	});
 }
+/** Recursively await any {@link Deferred} values nested within `input`, returning it once fully resolved. */
 async function resolveDeferredValues(input, signal) {
 	const seen = /* @__PURE__ */ new Set();
 	const visit = async (value) => {
@@ -242,6 +245,7 @@ async function resolveDeferredValues(input, signal) {
 	await visit(input);
 	return input;
 }
+/** Read the current route's server loader data during render or hydration. */
 function routeData() {
 	const envelope = getCurrentRenderData();
 	if (envelope) return guardHydratedRouteData(envelope.route, envelope.framework);
@@ -252,6 +256,7 @@ function routeData() {
 function rejectedChild(props, error) {
 	return typeof props.rejected === "function" ? props.rejected(error) : props.rejected ?? null;
 }
+/** Render a {@link Deferred} value's fulfilled state, a pending placeholder, or a rejected fallback. */
 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);

package/dist/{effect-lnxQIpJG.js → effect-BdvdgMvV.js}

@@ -1,5 +1,5 @@
-import { t as enqueueRuntimeLane } from "./access-Dpfoi4cA.js";
-import { m as withFineGrainedReadTracking } from "./readable-B5NtV7V0.js";
+import { t as enqueueRuntimeLane } from "./access-d_DCdwqn.js";
+import { m as withFineGrainedReadTracking } from "./readable-BsdGWsDE.js";
 //#region src/runtime/effect.ts
 const SOURCE_EFFECTS = Symbol("askr.source-effects");
 const effectSources = /* @__PURE__ */ new WeakMap();
@@ -92,15 +92,28 @@ function evaluateAndCommitEffect(effect) {
 	effect._pendingFineGrainedReadSource = null;
 	effect._pendingFineGrainedReadSources = null;
 	try {
-		const value = withFineGrainedReadTracking(effect, effect.compute);
-		const pendingAdditionalSources = effect._pendingFineGrainedReadSources;
-		const hasPendingCollection = isEffectReadSourceCollection(pendingAdditionalSources);
-		commitEffectResult(effect, value, hasPendingCollection ? pendingAdditionalSources : effect._pendingFineGrainedReadSource, pendingAdditionalSources && !hasPendingCollection ? pendingAdditionalSources : null);
+		let value;
+		try {
+			value = withFineGrainedReadTracking(effect, effect.compute);
+		} catch (error) {
+			if (!effect.hasValue) {
+				const [nextSources, nextSource2] = getPendingEffectSources(effect);
+				commitEffectSubscriptions(effect, nextSources, nextSource2);
+			}
+			throw error;
+		}
+		const [nextSources, nextSource2] = getPendingEffectSources(effect);
+		commitEffectResult(effect, value, nextSources, nextSource2);
 	} finally {
 		effect._pendingFineGrainedReadSource = null;
 		effect._pendingFineGrainedReadSources = null;
 	}
 }
+function getPendingEffectSources(effect) {
+	const pendingAdditionalSources = effect._pendingFineGrainedReadSources;
+	const hasPendingCollection = isEffectReadSourceCollection(pendingAdditionalSources);
+	return [hasPendingCollection ? pendingAdditionalSources : effect._pendingFineGrainedReadSource, pendingAdditionalSources && !hasPendingCollection ? pendingAdditionalSources : null];
+}
 function commitEffectSubscriptions(effect, nextSources, nextSource2) {
 	const previousSources = effect.readSources;
 	const previousSource2 = effect.readSource2;
@@ -144,17 +157,26 @@ function commitEffectSubscriptions(effect, nextSources, nextSource2) {
 }
 function commitEffectResult(effect, value, nextSources, nextSource2) {
 	const previousValue = effect.lastValue;
-	if (!effect.hasValue || !effect.equals(previousValue, value)) effect.commit(value, effect.hasValue ? previousValue : void 0);
+	const shouldCommit = !effect.hasValue || !effect.equals(previousValue, value);
 	commitEffectSubscriptions(effect, nextSources, nextSource2);
+	if (shouldCommit) effect.commit(value, effect.hasValue ? previousValue : void 0);
 	effect.lastValue = value;
 	effect.hasValue = true;
 }
+function handleEffectError(effect, error) {
+	if (effect.onError) {
+		effect.onError(error);
+		return;
+	}
+	throw error;
+}
 function flushLaneEffects(lane) {
 	hasPendingLaneFlush[lane] = false;
 	const effects = dirtyEffectsByLane[lane];
 	if (effects.size === 0) return;
 	const pending = effects.values();
 	const effectRuns = /* @__PURE__ */ new Map();
+	let failures = null;
 	let next = pending.next();
 	while (!next.done) {
 		const effect = next.value;
@@ -167,18 +189,27 @@ function flushLaneEffects(lane) {
 		effectRuns.set(effect, runCount);
 		if (runCount > MAX_EFFECT_RUNS_PER_FLUSH) {
 			const error = /* @__PURE__ */ new Error(`[Askr] fine-grained effect exceeded ${MAX_EFFECT_RUNS_PER_FLUSH} runs in one flush. Likely reactive cycle.`);
-			if (effect.onError) effect.onError(error);
-			else throw error;
+			try {
+				handleEffectError(effect, error);
+			} catch (unhandledError) {
+				(failures ??= []).push(unhandledError);
+			}
 			next = pending.next();
 			continue;
 		}
 		try {
 			evaluateAndCommitEffect(effect);
 		} catch (error) {
-			effect.onError?.(error);
+			try {
+				handleEffectError(effect, error);
+			} catch (unhandledError) {
+				(failures ??= []).push(unhandledError);
+			}
 		}
 		next = pending.next();
 	}
+	if (failures?.length === 1) throw failures[0];
+	if (failures && failures.length > 1) throw new AggregateError(failures, "Fine-grained effect failures");
 }
 function scheduleLaneFlush(lane) {
 	if (hasPendingLaneFlush[lane]) return;
@@ -189,7 +220,11 @@ function unscheduleEffect(effect) {
 	dirtyEffectsByLane[effect.lane].delete(effect);
 }
 function recomputeEffectNow(effect) {
-	evaluateAndCommitEffect(effect);
+	try {
+		evaluateAndCommitEffect(effect);
+	} catch (error) {
+		handleEffectError(effect, error);
+	}
 }
 function markFineGrainedEffectsDirtySource(source) {
 	const registered = getRegisteredEffects(source);
@@ -235,9 +270,23 @@ var FineGrainedEffectImpl = class {
 	}
 	updateCompute(nextCompute) {
 		if (!this.isActive) return;
+		const previousCompute = this.compute;
+		const previousReadSources = this.readSources;
+		const previousReadSource2 = this.readSource2;
+		const previousHasValue = this.hasValue;
+		const previousLastValue = this.lastValue;
 		this.compute = nextCompute;
 		unscheduleEffect(this);
-		recomputeEffectNow(this);
+		try {
+			recomputeEffectNow(this);
+		} catch (error) {
+			this.compute = previousCompute;
+			unscheduleEffect(this);
+			commitEffectSubscriptions(this, previousReadSources, previousReadSource2);
+			this.hasValue = previousHasValue;
+			this.lastValue = previousLastValue;
+			throw error;
+		}
 	}
 	flush() {
 		if (!this.isActive) return;
@@ -247,13 +296,23 @@ var FineGrainedEffectImpl = class {
 };
 function createFineGrainedEffect(options) {
 	const effect = new FineGrainedEffectImpl(options.lane, options.compute, options.commit, options.equals ?? Object.is, options.onError, options._owner);
-	recomputeEffectNow(effect);
+	try {
+		recomputeEffectNow(effect);
+	} catch (error) {
+		effect.cleanup();
+		throw error;
+	}
 	return effect;
 }
 /** @internal Allocation-sensitive variant for shared renderer callbacks. */
 function createOwnedFineGrainedEffect(lane, compute, commit, equals, onError, owner) {
 	const effect = new FineGrainedEffectImpl(lane, compute, commit, equals, onError, owner);
-	recomputeEffectNow(effect);
+	try {
+		recomputeEffectNow(effect);
+	} catch (error) {
+		effect.cleanup();
+		throw error;
+	}
 	return effect;
 }
 //#endregion

package/dist/{fastlane-CrfB3QG0.js → fastlane-DGo7SxBQ.js}

@@ -1,6 +1,6 @@
-import { b as isDevelopmentEnvironment, l as runRuntimeWithSyncProgress, o as getRuntimeRenderer, u as setRuntimeBulkCommitProbe } from "./access-Dpfoi4cA.js";
-import { i as isFragmentType } from "./jsx-C3IECePB.js";
-import { i as finalizeReadableSubscriptions } from "./readable-B5NtV7V0.js";
+import { d as setRuntimeBulkCommitProbe, o as getRuntimeRenderer, u as runRuntimeWithSyncProgress, x as isDevelopmentEnvironment } from "./access-d_DCdwqn.js";
+import { i as isFragmentType } from "./jsx-DRS-qjiN.js";
+import { i as finalizeReadableSubscriptions, l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty } from "./readable-BsdGWsDE.js";
 //#region src/runtime/dev-namespace.ts
 /**
 * Set a value in the dev namespace (no-op in production).
@@ -14,18 +14,37 @@ const incDevCounter = () => {};
 //#endregion
 //#region src/runtime/fastlane.ts
 let _bulkCommitActive = false;
+let _bulkCommitDepth = 0;
 let _appliedParents = null;
+let _deferredReadableSources = null;
 function enterBulkCommit() {
+	_bulkCommitDepth += 1;
+	if (_bulkCommitDepth > 1) return;
 	_bulkCommitActive = true;
 	_appliedParents = /* @__PURE__ */ new WeakSet();
+	_deferredReadableSources = /* @__PURE__ */ new Set();
 }
 function exitBulkCommit() {
+	if (_bulkCommitDepth === 0) return;
+	_bulkCommitDepth -= 1;
+	if (_bulkCommitDepth > 0) return;
 	_bulkCommitActive = false;
+	const deferredReadableSources = _deferredReadableSources;
 	_appliedParents = null;
+	_deferredReadableSources = null;
+	if (!deferredReadableSources) return;
+	for (const source of deferredReadableSources) {
+		markReadableDerivedSubscribersDirty(source);
+		markReactivePropsDirtySource(source);
+		notifyReadableReaders(source);
+	}
 }
 function isBulkCommitActive() {
 	return _bulkCommitActive;
 }
+function deferBulkCommitReadableNotification(source) {
+	_deferredReadableSources?.add(source);
+}
 function markFastPathApplied(parent) {
 	if (!_appliedParents) return;
 	try {
@@ -144,4 +163,4 @@ function tryRuntimeFastLaneSync(instance, result) {
 }
 setRuntimeBulkCommitProbe(isBulkCommitActive);
 //#endregion
-export { setDevValue as a, incDevCounter as i, markFastPathApplied as n, tryRuntimeFastLaneSync as r, isBulkCommitActive as t };
+export { incDevCounter as a, tryRuntimeFastLaneSync as i, isBulkCommitActive as n, setDevValue as o, markFastPathApplied as r, deferBulkCommitReadableNotification as t };

package/dist/{for-internal-Bsm0B8GZ.js → for-internal-jrliHZmF.js}

@@ -1,10 +1,10 @@
 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 { h as haveEquivalentContextFrames, n as createComponentInstance, s as renderScopedComponent, v as rebaseVNodeTreeWithContextFrame } from "./component-internal-C4uwwUaK.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";
+import { o as getRuntimeRenderer, x as isDevelopmentEnvironment, y as logger } from "./access-d_DCdwqn.js";
+import { h as getCurrentStateIndex, i as claimHookIndex, o as clearRenderTracking, p as getCurrentInstance } from "./component-scope-4I3yEMkb.js";
+import { h as haveEquivalentContextFrames, n as createComponentInstance, s as renderScopedComponent, v as rebaseVNodeTreeWithContextFrame } from "./component-internal-DOVVMjG7.js";
+import { d as shouldCoalesceFineGrainedItemReads, l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-BsdGWsDE.js";
+import { i as unregisterOwnedChildScope, r as registerOwnedChildScope, t as cleanupComponent } from "./component-cleanup-hrqSikl2.js";
+import { o as finalizeInlineReadSubscriptions, u as registerLifecycleTransaction } from "./lifecycle-batch-BH0fax4F.js";
 //#region src/runtime/child-scope.ts
 const EMPTY_CHILD_SCOPE_PROPS = {};
 const childScopesByInstance = /* @__PURE__ */ new WeakMap();

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

@@ -1,9 +1,11 @@
-import { r as JSXElement, s as Props } from "../../jsx-BYXe_Nnk.js";
-import "../../types-CsPtBGWb.js";
-import { t as Ref } from "../../compose-ref-Cizq72-x.js";
+import { r as JSXElement, s as Props } from "../../types-DkVJhVs9.js";
+import { t as Ref } from "../../compose-ref-DOJHoW5X.js";
 //#region src/foundations/icon/icon.types.d.ts
+/** Named icon size presets, mapped to CSS variables at render time. */
 type IconSizeToken = 'sm' | 'md' | 'lg' | 'xl';
+/** Camel-cased CSS style object accepted by icon `style` props. */
 type IconStyleObject = Record<string, unknown>;
+/** Props specific to the icon contract, independent of the underlying `<svg>` props. */
 type IconOwnProps = {
   size?: number | string;
   strokeWidth?: number;
@@ -13,18 +15,26 @@ type IconOwnProps = {
   style?: string | IconStyleObject;
   iconName?: string;
 };
+/** Full prop set accepted by {@link IconBase} and generated icon components. */
 type IconProps = Omit<Props, 'children' | 'class' | 'color' | 'height' | 'ref' | 'role' | 'stroke' | 'stroke-width' | 'style' | 'title' | 'width'> & IconOwnProps & {
   children?: unknown;
   ref?: Ref<SVGSVGElement>;
 };
 //#endregion
 //#region src/foundations/icon/icon.d.ts
+/** Check whether `value` is one of the named icon size tokens ('sm'|'md'|'lg'|'xl'). */
 declare function isIconSizeToken(value: unknown): value is IconSizeToken;
+/** Normalize a numeric icon size to a `px` string; strings pass through unchanged. */
 declare function normalizeIconSizeValue(size: number | string): string;
+/** Resolve a size (token or literal) to a CSS `var(--ak-icon-size-*, ...)` expression or literal value. */
 declare function resolveIconSizeVariable(size: number | string): string;
+/** Resolve a stroke width to a CSS `var(--ak-icon-stroke-width-*, ...)` expression, scoped to `sizeToken` when given. */
 declare function resolveIconStrokeWidthVariable(strokeWidth: number, sizeToken: IconSizeToken | undefined): string;
+/** Serialize an inline style object (or pass through a string) to a CSS declaration string. */
 declare function serializeIconStyle(style: string | IconStyleObject | undefined): string;
+/** Join non-empty CSS declaration fragments with `;`, dropping any that are blank. */
 declare function joinIconStyle(...styles: Array<string | undefined>): string | undefined;
+/** Compute the shared SVG attributes and inline style implementing the icon size/stroke/color contract. */
 declare function getIconContractProps({ size, strokeWidth, color, title, style, iconName }: Pick<IconProps, 'color' | 'iconName' | 'size' | 'strokeWidth' | 'style' | 'title'>): {
   sizeToken: IconSizeToken | undefined;
   decorative: string | undefined;
@@ -46,6 +56,7 @@ declare function getIconContractProps({ size, strokeWidth, color, title, style,
     'data-color': string | undefined;
   };
 };
+/** Base `<svg>` wrapper implementing the icon contract; generated icon components render into it. */
 declare function IconBase({ size, strokeWidth, color, title, class: className, style, iconName, children, ref, ...rest }: IconProps): JSXElement;
 //#endregion
 export { IconBase, type IconOwnProps, type IconProps, type IconSizeToken, type IconStyleObject, getIconContractProps, isIconSizeToken, joinIconStyle, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle };

package/dist/foundations/icon/index.js

@@ -6,17 +6,21 @@ const ICON_SIZE_TOKENS = [
 	"lg",
 	"xl"
 ];
+/** Check whether `value` is one of the named icon size tokens ('sm'|'md'|'lg'|'xl'). */
 function isIconSizeToken(value) {
 	return typeof value === "string" && ICON_SIZE_TOKENS.includes(value);
 }
+/** Normalize a numeric icon size to a `px` string; strings pass through unchanged. */
 function normalizeIconSizeValue(size) {
 	if (typeof size === "number") return `${size}px`;
 	return size;
 }
+/** Resolve a size (token or literal) to a CSS `var(--ak-icon-size-*, ...)` expression or literal value. */
 function resolveIconSizeVariable(size) {
 	if (isIconSizeToken(size)) return `var(--ak-icon-size-${size}, var(--ak-icon-size-md, 1.25rem))`;
 	return normalizeIconSizeValue(size);
 }
+/** Resolve a stroke width to a CSS `var(--ak-icon-stroke-width-*, ...)` expression, scoped to `sizeToken` when given. */
 function resolveIconStrokeWidthVariable(strokeWidth, sizeToken) {
 	if (sizeToken) return `var(--ak-icon-stroke-width-${sizeToken}, var(--ak-icon-stroke-width-md, ${strokeWidth}))`;
 	return `var(--ak-icon-stroke-width-md, ${strokeWidth})`;
@@ -24,15 +28,18 @@ function resolveIconStrokeWidthVariable(strokeWidth, sizeToken) {
 function camelToKebab(key) {
 	return key.replace(/([A-Z])/g, (match) => `-${match.toLowerCase()}`);
 }
+/** Serialize an inline style object (or pass through a string) to a CSS declaration string. */
 function serializeIconStyle(style) {
 	if (!style) return "";
 	if (typeof style === "string") return style.trim();
 	return Object.entries(style).filter(([, value]) => value !== void 0 && value !== null).map(([key, value]) => `${camelToKebab(key)}:${String(value)}`).join(";");
 }
+/** Join non-empty CSS declaration fragments with `;`, dropping any that are blank. */
 function joinIconStyle(...styles) {
 	const merged = styles.map((style) => style?.trim()).filter(Boolean);
 	return merged.length > 0 ? merged.join(";") : void 0;
 }
+/** Compute the shared SVG attributes and inline style implementing the icon size/stroke/color contract. */
 function getIconContractProps({ size = 20, strokeWidth = 2, color = "currentColor", title, style, iconName }) {
 	const sizeToken = isIconSizeToken(size) ? size : void 0;
 	const decorative = title ? void 0 : "true";
@@ -61,6 +68,7 @@ function getIconContractProps({ size = 20, strokeWidth = 2, color = "currentColo
 		}
 	};
 }
+/** Base `<svg>` wrapper implementing the icon contract; generated icon components render into it. */
 function IconBase({ size = 20, strokeWidth = 2, color = "currentColor", title, class: className, style, iconName, children, ref, ...rest }) {
 	const { attrs } = getIconContractProps({
 		size,

package/dist/foundations/index.d.ts

@@ -1,3 +1,3 @@
-import { r as JSXElement } from "../jsx-BYXe_Nnk.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-Cf2ANwPL.js";
+import { r as JSXElement } from "../types-DkVJhVs9.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-C29SEGIv.js";
 export { DefaultPortal, type JSXElement, type LayoutComponent, Portal, type PortalProps, Presence, type PresenceProps, Slot, type SlotProps, definePortal, layout };

package/dist/foundations/index.js

@@ -1,2 +1,2 @@
-import { a as definePortal, c as layout, i as Portal, o as Presence, r as DefaultPortal, s as Slot } from "../structures-m-cphWI-.js";
+import { a as definePortal, c as layout, i as Portal, o as Presence, r as DefaultPortal, s as Slot } from "../structures-umvVUD-M.js";
 export { DefaultPortal, Portal, Presence, Slot, definePortal, layout };