@kontsedal/olas-core 0.0.1-rc.0 → 0.0.1

package/dist/{root-BImHnGj1.mjs → root-BCZDC5Fv.mjs}

@@ -222,6 +222,29 @@ function isAbortError(err) {
 	if (typeof DOMException !== "undefined" && err instanceof DOMException) return err.name === "AbortError";
 	return false;
 }
+/**
+* `setTimeout` wrapped in a promise that rejects with `AbortError` if the
+* passed signal fires. Internal — used by the retry loops in `Entry`,
+* `InfiniteEntry`, and `Mutation` so a slow backoff never blocks a supersede.
+*/
+function abortableSleep(ms, signal) {
+	return new Promise((resolve, reject) => {
+		if (signal.aborted) {
+			reject(new DOMException("Aborted", "AbortError"));
+			return;
+		}
+		const timer = setTimeout(() => {
+			signal.removeEventListener("abort", onAbort);
+			resolve();
+		}, ms);
+		const onAbort = () => {
+			clearTimeout(timer);
+			signal.removeEventListener("abort", onAbort);
+			reject(new DOMException("Aborted", "AbortError"));
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+	});
+}
 //#endregion
 //#region src/query/entry.ts
 /**
@@ -250,18 +273,37 @@ var Entry = class {
 	nextSnapshotId = 0;
 	disposed = false;
 	events;
+	onSuccessData;
 	fetchStartTime = 0;
+	/**
+	* Promises returned by `firstValue()` that haven't settled. Rejected on
+	* `dispose()` so awaiters (most notably `prefetch` and `subscription.firstValue`)
+	* don't hang when the controller tree is torn down mid-fetch.
+	*/
+	pendingFirstValueRejects = [];
 	constructor(options) {
 		this.fetcherProvider = options.fetcher;
 		this.staleTime = options.staleTime ?? 0;
 		this.retry = options.retry ?? 0;
 		this.retryDelay = options.retryDelay ?? 1e3;
 		this.events = options.events ?? {};
+		this.onSuccessData = options.onSuccessData;
 		this.data = signal$1(options.initialData);
 		if (options.initialData !== void 0) {
 			this.status = signal$1("success");
-			this.scheduleStaleness();
-			this.isStale.set(this.staleTime === 0);
+			if (this.staleTime === 0) this.isStale.set(true);
+			else {
+				const last = options.initialUpdatedAt;
+				const alreadyStale = last === void 0 || Date.now() - last >= this.staleTime;
+				this.isStale.set(alreadyStale);
+				if (!alreadyStale) {
+					const remaining = this.staleTime - (Date.now() - last);
+					this.staleTimer = setTimeout(() => {
+						this.staleTimer = null;
+						if (!this.disposed) this.isStale.set(true);
+					}, remaining);
+				}
+			}
 		} else this.status = signal$1("idle");
 		this.lastUpdatedAt = signal$1(options.initialUpdatedAt);
 	}
@@ -294,7 +336,7 @@ var Entry = class {
 			} catch (err) {
 				if (myId !== this.currentFetchId || this.disposed || isAbortError(err)) throw err;
 				if (!this.shouldRetry(attempt, err)) return this.applyFailure(err);
-				await abortableSleep$2(this.computeDelay(attempt), abort.signal);
+				await abortableSleep(this.computeDelay(attempt), abort.signal);
 				attempt += 1;
 			}
 		}
@@ -323,6 +365,7 @@ var Entry = class {
 		try {
 			this.events.onFetchSuccess?.(Date.now() - this.fetchStartTime);
 		} catch {}
+		this.onSuccessData?.(result);
 		return result;
 	}
 	applyFailure(err) {
@@ -401,26 +444,24 @@ var Entry = class {
 			}
 		};
 	}
-	finalizeSnapshot(snapshot) {
-		const id = snapshotIds.get(snapshot);
-		if (id === void 0) return;
-		const record = this.snapshots.find((s) => s.live && s.id === id);
-		if (!record) return;
-		record.live = false;
-		this.snapshots = this.snapshots.filter((s) => s !== record);
-		if (!this.snapshots.some((s) => s.live)) this.hasPendingMutations.set(false);
-	}
 	firstValue() {
+		if (this.disposed) return Promise.reject(new DOMException("Entry disposed", "AbortError"));
 		if (this.status.peek() === "success") return Promise.resolve(this.data.peek());
 		if (this.status.peek() === "error") return Promise.reject(this.error.peek());
 		return new Promise((resolve, reject) => {
+			const tracked = (err) => {
+				this.pendingFirstValueRejects = this.pendingFirstValueRejects.filter((f) => f !== tracked);
+				reject(err);
+			};
+			this.pendingFirstValueRejects.push(tracked);
 			const unsub = this.status.subscribe((s) => {
 				if (s === "success") {
 					unsub();
+					this.pendingFirstValueRejects = this.pendingFirstValueRejects.filter((f) => f !== tracked);
 					resolve(this.data.peek());
 				} else if (s === "error") {
 					unsub();
-					reject(this.error.peek());
+					tracked(this.error.peek());
 				}
 			});
 		});
@@ -443,27 +484,14 @@ var Entry = class {
 		}
 		this.currentAbort?.abort();
 		this.currentAbort = null;
+		if (this.pendingFirstValueRejects.length > 0) {
+			const disposed = new DOMException("Entry disposed", "AbortError");
+			const rejects = this.pendingFirstValueRejects;
+			this.pendingFirstValueRejects = [];
+			for (const fn of rejects) fn(disposed);
+		}
 	}
 };
-const snapshotIds = /* @__PURE__ */ new WeakMap();
-function abortableSleep$2(ms, signal) {
-	return new Promise((resolve, reject) => {
-		if (signal.aborted) {
-			reject(new DOMException("Aborted", "AbortError"));
-			return;
-		}
-		const timer = setTimeout(() => {
-			signal.removeEventListener("abort", onAbort);
-			resolve();
-		}, ms);
-		const onAbort = () => {
-			clearTimeout(timer);
-			signal.removeEventListener("abort", onAbort);
-			reject(new DOMException("Aborted", "AbortError"));
-		};
-		signal.addEventListener("abort", onAbort, { once: true });
-	});
-}
 //#endregion
 //#region src/query/focus-online.ts
 const focusSubs = /* @__PURE__ */ new Set();
@@ -539,6 +567,8 @@ var InfiniteEntry = class {
 	snapshots = [];
 	nextSnapshotId = 0;
 	disposed = false;
+	/** Mirrors `Entry.pendingFirstValueRejects` — see that field for context. */
+	pendingFirstValueRejects = [];
 	fetcher;
 	initialPageParam;
 	getNextPageParam;
@@ -547,6 +577,13 @@ var InfiniteEntry = class {
 	retry;
 	retryDelay;
 	itemsOf;
+	/**
+	* Mirrors `Entry.onSuccessData`. Fires from `applyFetchSuccess`-equivalent
+	* branches AFTER `pages.set(...)` settles. Used by `InfiniteClientEntry`
+	* to emit `SetDataEvent { kind: 'infinite', source: 'fetch' }` for
+	* `QueryClientPlugin`s (e.g. entity normalization).
+	*/
+	onSuccessData;
 	constructor(opts) {
 		this.fetcher = opts.fetcher;
 		this.initialPageParam = opts.initialPageParam;
@@ -556,6 +593,7 @@ var InfiniteEntry = class {
 		this.staleTime = opts.staleTime ?? 0;
 		this.retry = opts.retry ?? 0;
 		this.retryDelay = opts.retryDelay ?? 1e3;
+		this.onSuccessData = opts.onSuccessData;
 		this.pageParams = signal$1([]);
 		this.data = computed$1(() => {
 			const ps = this.pages.value;
@@ -607,6 +645,7 @@ var InfiniteEntry = class {
 				this.isStale.set(this.staleTime === 0);
 			});
 			if (this.staleTime > 0) this.scheduleStaleness();
+			this.onSuccessData?.(this.pages.peek());
 		}, "initial");
 	}
 	fetchNextPage() {
@@ -633,6 +672,7 @@ var InfiniteEntry = class {
 				this.isFetching.set(false);
 				this.lastUpdatedAt.set(Date.now());
 			});
+			this.onSuccessData?.(this.pages.peek());
 		}, "next").then(() => {});
 	}
 	fetchPreviousPage() {
@@ -660,36 +700,46 @@ var InfiniteEntry = class {
 				this.isFetching.set(false);
 				this.lastUpdatedAt.set(Date.now());
 			});
+			this.onSuccessData?.(this.pages.peek());
 		}, "prev").then(() => {});
 	}
 	async runFetch(myId, signal, pageParam, onSuccess, direction) {
 		let attempt = 0;
-		while (true) {
-			if (myId !== this.currentFetchId || this.disposed) throw new DOMException("Superseded", "AbortError");
-			try {
-				const page = await this.fetcher({
-					pageParam,
-					signal
-				});
+		let succeeded = false;
+		try {
+			while (true) {
 				if (myId !== this.currentFetchId || this.disposed) throw new DOMException("Superseded", "AbortError");
-				onSuccess(page, pageParam);
-				return page;
-			} catch (err) {
-				if (myId !== this.currentFetchId || this.disposed || isAbortError(err)) throw err;
-				if (!(typeof this.retry === "number" ? attempt < this.retry : this.retry(attempt, err))) {
-					batch$1(() => {
-						this.error.set(err);
-						this.status.set("error");
-						this.isLoading.set(false);
-						this.isFetching.set(false);
-						if (direction === "next") this.isFetchingNextPage.set(false);
-						if (direction === "prev") this.isFetchingPreviousPage.set(false);
+				try {
+					const page = await this.fetcher({
+						pageParam,
+						signal
 					});
-					throw err;
+					if (myId !== this.currentFetchId || this.disposed) throw new DOMException("Superseded", "AbortError");
+					onSuccess(page, pageParam);
+					succeeded = true;
+					return page;
+				} catch (err) {
+					if (myId !== this.currentFetchId || this.disposed || isAbortError(err)) throw err;
+					if (!(typeof this.retry === "number" ? attempt < this.retry : this.retry(attempt, err))) {
+						batch$1(() => {
+							this.error.set(err);
+							this.status.set("error");
+							this.isLoading.set(false);
+							this.isFetching.set(false);
+							if (direction === "next") this.isFetchingNextPage.set(false);
+							if (direction === "prev") this.isFetchingPreviousPage.set(false);
+						});
+						throw err;
+					}
+					await abortableSleep(typeof this.retryDelay === "function" ? this.retryDelay(attempt) : this.retryDelay, signal);
+					attempt += 1;
 				}
-				await abortableSleep$1(typeof this.retryDelay === "function" ? this.retryDelay(attempt) : this.retryDelay, signal);
-				attempt += 1;
 			}
+		} finally {
+			if (!succeeded) batch$1(() => {
+				if (direction === "next") this.isFetchingNextPage.set(false);
+				if (direction === "prev") this.isFetchingPreviousPage.set(false);
+			});
 		}
 	}
 	refetch() {
@@ -749,16 +799,23 @@ var InfiniteEntry = class {
 		};
 	}
 	firstValue() {
+		if (this.disposed) return Promise.reject(new DOMException("Entry disposed", "AbortError"));
 		if (this.status.peek() === "success") return Promise.resolve(this.pages.peek());
 		if (this.status.peek() === "error") return Promise.reject(this.error.peek());
 		return new Promise((resolve, reject) => {
+			const tracked = (err) => {
+				this.pendingFirstValueRejects = this.pendingFirstValueRejects.filter((f) => f !== tracked);
+				reject(err);
+			};
+			this.pendingFirstValueRejects.push(tracked);
 			const unsub = this.status.subscribe((s) => {
 				if (s === "success") {
 					unsub();
+					this.pendingFirstValueRejects = this.pendingFirstValueRejects.filter((f) => f !== tracked);
 					resolve(this.pages.peek());
 				} else if (s === "error") {
 					unsub();
-					reject(this.error.peek());
+					tracked(this.error.peek());
 				}
 			});
 		});
@@ -784,26 +841,14 @@ var InfiniteEntry = class {
 		}
 		this.currentAbort?.abort();
 		this.currentAbort = null;
+		if (this.pendingFirstValueRejects.length > 0) {
+			const disposed = new DOMException("Entry disposed", "AbortError");
+			const rejects = this.pendingFirstValueRejects;
+			this.pendingFirstValueRejects = [];
+			for (const fn of rejects) fn(disposed);
+		}
 	}
 };
-function abortableSleep$1(ms, signal) {
-	return new Promise((resolve, reject) => {
-		if (signal.aborted) {
-			reject(new DOMException("Aborted", "AbortError"));
-			return;
-		}
-		const timer = setTimeout(() => {
-			signal.removeEventListener("abort", onAbort);
-			resolve();
-		}, ms);
-		const onAbort = () => {
-			clearTimeout(timer);
-			signal.removeEventListener("abort", onAbort);
-			reject(new DOMException("Aborted", "AbortError"));
-		};
-		signal.addEventListener("abort", onAbort, { once: true });
-	});
-}
 //#endregion
 //#region src/query/keys.ts
 /**
@@ -870,7 +915,7 @@ var ClientEntry = class {
 	refetchInterval;
 	refetchOnWindowFocus;
 	refetchOnReconnect;
-	constructor(client, query, callArgs, keyArgs, spec, hydrated) {
+	constructor(client, query, callArgs, keyArgs, spec, hydrated, onFetchSuccess) {
 		this.client = client;
 		this.query = query;
 		this.callArgs = callArgs;
@@ -893,7 +938,8 @@ var ClientEntry = class {
 			retryDelay: spec.retryDelay,
 			initialData: hydrated?.data,
 			initialUpdatedAt: hydrated?.lastUpdatedAt,
-			events: void 0
+			events: void 0,
+			onSuccessData: onFetchSuccess
 		});
 	}
 	acquire() {
@@ -993,7 +1039,7 @@ var InfiniteClientEntry = class {
 	intervalTimer = null;
 	gcTime;
 	refetchInterval;
-	constructor(client, query, callArgs, keyArgs, spec) {
+	constructor(client, query, callArgs, keyArgs, spec, onFetchSuccess) {
 		this.client = client;
 		this.query = query;
 		this.callArgs = callArgs;
@@ -1014,7 +1060,8 @@ var InfiniteClientEntry = class {
 			itemsOf: spec.itemsOf,
 			staleTime: spec.staleTime,
 			retry: spec.retry,
-			retryDelay: spec.retryDelay
+			retryDelay: spec.retryDelay,
+			onSuccessData: onFetchSuccess
 		});
 	}
 	acquire() {
@@ -1130,6 +1177,9 @@ var QueryClient = class {
 			applyRemoteInvalidate(queryId, keyArgs) {
 				self.applyRemoteInvalidate(queryId, keyArgs);
 			},
+			setEntryData(queryId, keyArgs, updater) {
+				self.setEntryData(queryId, keyArgs, updater);
+			},
 			subscribedKeys(queryId) {
 				return self.subscribedKeysFor(queryId);
 			}
@@ -1146,7 +1196,24 @@ var QueryClient = class {
 			});
 		}
 	}
-	emitSetData(query, keyArgs, data, kind) {
+	/**
+	* Emit a `SetDataEvent` to every installed plugin. The `source` field
+	* tells layered plugins where the write originated:
+	* - `'set'`: explicit `client.setData`, including mutations and plugin-
+	*   initiated `setEntryData` calls (e.g. entity backpropagation).
+	* - `'fetch'`: a query fetcher resolved successfully (`Entry.applySuccess`
+	*   reaches this through `onSuccessData`), or hydrated data was first
+	*   bound (a per-tab arrival of pre-fetched data; cross-tab skips
+	*   `'fetch'` so this stays a per-tab concern).
+	* - `'remote'`: `applyRemoteSetData` — cross-tab / server-push. Mirrors
+	*   `isRemote === true`.
+	*
+	* Private — fetcher-success emission goes through the `onFetchSuccess`
+	* closure that `bindEntry` builds and hands to each new `ClientEntry`.
+	* Hydrated emission goes through this method directly from `bindEntry`.
+	* Mutation / remote paths call it from within QueryClient methods.
+	*/
+	emitSetData(query, keyArgs, data, kind, source) {
 		if (this.plugins.length === 0) return;
 		const queryId = query.__spec.queryId;
 		if (queryId == null) return;
@@ -1155,7 +1222,8 @@ var QueryClient = class {
 			keyArgs,
 			data,
 			kind,
-			isRemote: this.applyingRemote
+			isRemote: this.applyingRemote,
+			source
 		};
 		for (const plugin of this.plugins) if (plugin.onSetData) {
 			const cb = plugin.onSetData;
@@ -1233,11 +1301,44 @@ var QueryClient = class {
 		this.applyingRemote = true;
 		try {
 			entry.entry.setData(() => data);
-			this.emitSetData(internal, entry.keyArgs, data, "data");
+			this.emitSetData(internal, entry.keyArgs, data, "data", "remote");
 		} finally {
 			this.applyingRemote = false;
 		}
 	}
+	/**
+	* Local-originated `setData` keyed by `queryId + keyArgs`. Plugin-facing
+	* (exposed via `QueryClientPluginApi.setEntryData`); used by the
+	* `@kontsedal/olas-entities` plugin to backpropagate entity patches into
+	* every query holding the entity, without forcing the plugin to recover
+	* the original `callArgs`.
+	*
+	* Drops silently in the same cases as `applyRemoteSetData` (unknown
+	* queryId / infinite query / no local entry). Emits `SetDataEvent` with
+	* `isRemote: false`, `source: 'set'` — cross-tab WILL rebroadcast.
+	*/
+	setEntryData(queryId, keyArgs, updater) {
+		const query = lookupRegisteredQuery(queryId);
+		if (!query) return;
+		const hash = stableHash(keyArgs);
+		if (query.__olas === "query") {
+			const internal = query;
+			const map = this.maps.get(internal);
+			if (!map) return;
+			const entry = map.get(hash);
+			if (!entry) return;
+			entry.entry.setData(updater);
+			this.emitSetData(internal, entry.keyArgs, entry.entry.data.peek(), "data", "set");
+			return;
+		}
+		const internal = query;
+		const map = this.infiniteMaps.get(internal);
+		if (!map) return;
+		const entry = map.get(hash);
+		if (!entry) return;
+		entry.entry.setData(updater);
+		this.emitSetData(internal, entry.keyArgs, entry.entry.pages.peek(), "infinite", "set");
+	}
 	applyRemoteInvalidate(queryId, keyArgs) {
 		const query = lookupRegisteredQuery(queryId);
 		if (!query) return;
@@ -1251,6 +1352,7 @@ var QueryClient = class {
 		this.applyingRemote = true;
 		try {
 			entry.entry.invalidate().catch((err) => {
+				if (isAbortError(err)) return;
 				dispatchError(this.onError, err, {
 					kind: "cache",
 					controllerPath: [],
@@ -1346,9 +1448,11 @@ var QueryClient = class {
 		if (!entry) {
 			const hydrated = this.hydratedData.get(hash);
 			if (hydrated) this.hydratedData.delete(hash);
-			entry = new ClientEntry(this, internal, args, keyArgs, internal.__spec, hydrated);
+			const onFetchSuccess = internal.__spec.queryId != null ? (data) => this.emitSetData(internal, keyArgs, data, "data", "fetch") : void 0;
+			entry = new ClientEntry(this, internal, args, keyArgs, internal.__spec, hydrated, onFetchSuccess);
 			map.set(hash, entry);
 			entry.scheduleGcIfOrphan();
+			if (hydrated !== void 0) this.emitSetData(internal, keyArgs, hydrated.data, "data", "fetch");
 		}
 		return entry;
 	}
@@ -1371,6 +1475,7 @@ var QueryClient = class {
 		const entry = map.get(hash);
 		if (!entry) return;
 		entry.entry.invalidate().catch((err) => {
+			if (isAbortError(err)) return;
 			dispatchError(this.onError, err, {
 				kind: "cache",
 				controllerPath: [],
@@ -1385,6 +1490,7 @@ var QueryClient = class {
 		if (!map) return;
 		for (const [hash, entry] of map) {
 			entry.entry.invalidate().catch((err) => {
+				if (isAbortError(err)) return;
 				dispatchError(this.onError, err, {
 					kind: "cache",
 					controllerPath: [],
@@ -1397,7 +1503,7 @@ var QueryClient = class {
 	setData(query, args, updater) {
 		const entry = this.bindEntry(query, args);
 		const snapshot = entry.entry.setData(updater);
-		this.emitSetData(entry.query, entry.keyArgs, entry.entry.data.peek(), "data");
+		this.emitSetData(entry.query, entry.keyArgs, entry.entry.data.peek(), "data", "set");
 		return snapshot;
 	}
 	bindInfiniteEntry(query, args) {
@@ -1413,7 +1519,8 @@ var QueryClient = class {
 		const hash = stableHash(keyArgs);
 		let entry = map.get(hash);
 		if (!entry) {
-			entry = new InfiniteClientEntry(this, internal, args, keyArgs, internal.__spec);
+			const onFetchSuccess = internal.__spec.queryId != null ? (pages) => this.emitSetData(internal, keyArgs, pages, "infinite", "fetch") : void 0;
+			entry = new InfiniteClientEntry(this, internal, args, keyArgs, internal.__spec, onFetchSuccess);
 			map.set(hash, entry);
 			entry.scheduleGcIfOrphan();
 		}
@@ -1438,6 +1545,7 @@ var QueryClient = class {
 		const entry = map.get(hash);
 		if (!entry) return;
 		entry.entry.invalidate().catch((err) => {
+			if (isAbortError(err)) return;
 			dispatchError(this.onError, err, {
 				kind: "cache",
 				controllerPath: [],
@@ -1452,6 +1560,7 @@ var QueryClient = class {
 		if (!map) return;
 		for (const entry of map.values()) {
 			entry.entry.invalidate().catch((err) => {
+				if (isAbortError(err)) return;
 				dispatchError(this.onError, err, {
 					kind: "cache",
 					controllerPath: [],
@@ -1464,7 +1573,7 @@ var QueryClient = class {
 	setInfiniteData(query, args, updater) {
 		const entry = this.bindInfiniteEntry(query, args);
 		const snapshot = entry.entry.setData(updater);
-		this.emitSetData(entry.query, entry.keyArgs, entry.entry.pages.peek(), "infinite");
+		this.emitSetData(entry.query, entry.keyArgs, entry.entry.pages.peek(), "infinite", "set");
 		return snapshot;
 	}
 	prefetchInfinite(query, args) {
@@ -1587,9 +1696,11 @@ var FieldImpl = class {
 	runId = 0;
 	disposed = false;
 	devtoolsOwner = null;
-	constructor(initial, validators = []) {
+	onValidatorError = null;
+	constructor(initial, validators = [], options) {
 		this.initial = initial;
 		this.validators = validators;
+		this.onValidatorError = options?.onValidatorError ?? null;
 		this.value$ = signal$1(initial);
 		this.errors$ = signal$1([]);
 		this.touched$ = signal$1(false);
@@ -1601,6 +1712,13 @@ var FieldImpl = class {
 			this.runValidators();
 		});
 	}
+	/**
+	* Internal hook for `ctx.field` / `createForm` to route synchronous
+	* validator throws through `root.onError`. See `ValidatorErrorReporter`.
+	*/
+	bindValidatorErrorReporter(reporter) {
+		this.onValidatorError = reporter;
+	}
 	get value() {
 		return this.value$.value;
 	}
@@ -1707,10 +1825,15 @@ var FieldImpl = class {
 		const myId = ++this.runId;
 		const syncErrors = [];
 		const asyncPromises = [];
-		for (const validator of this.validators) {
+		for (const validator of this.validators) try {
 			const result = validator(value, abort.signal);
 			if (result instanceof Promise) asyncPromises.push(result);
 			else if (result != null) syncErrors.push(result);
+		} catch (err) {
+			try {
+				this.onValidatorError?.(err);
+			} catch {}
+			syncErrors.push(err instanceof Error ? err.message : String(err));
 		}
 		if (syncErrors.length > 0) {
 			batch$1(() => {
@@ -1758,8 +1881,18 @@ function bindFieldDevtoolsOwner(field, owner) {
 	const impl = field;
 	if (typeof impl.bindDevtoolsOwner === "function") impl.bindDevtoolsOwner(owner);
 }
-function createField(initial, validators) {
-	return new FieldImpl(initial, validators);
+/**
+* Internal — install a synchronous-validator-throw reporter on a `Field`
+* (matched structurally to keep the public `Field<T>` surface stable).
+* Called by `ctx.field` and `bindTreeToDevtools` so leaves inside a form/
+* field-array tree get the same reporting as a standalone field.
+*/
+function bindFieldValidatorErrorReporter(field, reporter) {
+	const impl = field;
+	if (typeof impl.bindValidatorErrorReporter === "function") impl.bindValidatorErrorReporter(reporter);
+}
+function createField(initial, validators, options) {
+	return new FieldImpl(initial, validators, options);
 }
 /**
 * Wrap an async validator with a debounce. The debounce timer resets on every
@@ -1806,17 +1939,40 @@ var FormImpl = class {
 	validators;
 	options;
 	validatorDispose = null;
+	initialDispose = null;
 	currentValidatorRun = 0;
 	currentValidatorAbort = null;
 	disposed = false;
-	constructor(schema, options) {
+	onValidatorError = null;
+	/** Internal — wire a sync-throw reporter for the top-level validators. */
+	bindValidatorErrorReporter(reporter) {
+		this.onValidatorError = reporter;
+	}
+	constructor(schema, options, internalOptions) {
 		this.fields = schema;
 		this.options = options;
 		this.validators = options?.validators ?? [];
-		if (options?.initial !== void 0) {
-			const ini = typeof options.initial === "function" ? options.initial() : options.initial;
-			if (ini !== void 0) this.applyPartial(ini, true);
-		}
+		this.onValidatorError = internalOptions?.onValidatorError ?? null;
+		if (options?.initial !== void 0) if (typeof options.initial === "function") {
+			const initialFn = options.initial;
+			const mode = options.resetOnInitialChange ?? "when-clean";
+			let firstRun = true;
+			this.initialDispose = effect$1(() => {
+				const ini = initialFn();
+				if (ini === void 0) return;
+				untracked$1(() => {
+					if (this.disposed) return;
+					if (firstRun) {
+						firstRun = false;
+						this.applyPartial(ini, true);
+						return;
+					}
+					if (mode === "never") return;
+					if (mode === "when-clean" && this.isDirty.peek()) return;
+					this.applyPartial(ini, true);
+				});
+			});
+		} else this.applyPartial(options.initial, true);
 		this.value = computed$1(() => this.computeValue());
 		this.errors = computed$1(() => this.computeErrors());
 		this.isDirty = computed$1(() => this.computeBool("isDirty"));
@@ -1873,6 +2029,7 @@ var FormImpl = class {
 		for (const [k, val] of Object.entries(partial)) {
 			const child = this.fields[k];
 			if (!child) continue;
+			if (val === void 0) continue;
 			if (isForm(child)) if (asInitial) child.resetWithInitial(val);
 			else child.set(val);
 			else if (isFieldArray(child)) {
@@ -1915,6 +2072,7 @@ var FormImpl = class {
 		for (const child of Object.values(this.fields)) if (isForm(child) || isFieldArray(child)) tasks.push(child.validate());
 		else tasks.push(child.revalidate());
 		await Promise.all(tasks);
+		if (this.validators.length > 0) this.runTopLevelValidators();
 		if (this.topLevelValidating$.peek()) await new Promise((resolve) => {
 			const unsub = this.topLevelValidating$.subscribe((v) => {
 				if (!v) {
@@ -1929,6 +2087,7 @@ var FormImpl = class {
 		if (this.disposed) return;
 		this.disposed = true;
 		this.validatorDispose?.();
+		this.initialDispose?.();
 		this.currentValidatorAbort?.abort();
 		for (const child of Object.values(this.fields)) child.dispose?.();
 	}
@@ -1941,10 +2100,15 @@ var FormImpl = class {
 		const myId = ++this.currentValidatorRun;
 		const syncErrors = [];
 		const asyncPromises = [];
-		for (const v of this.validators) {
+		for (const v of this.validators) try {
 			const r = v(value, abort.signal);
 			if (r instanceof Promise) asyncPromises.push(r);
 			else if (r != null) syncErrors.push(r);
+		} catch (err) {
+			try {
+				this.onValidatorError?.(err);
+			} catch {}
+			syncErrors.push(err instanceof Error ? err.message : String(err));
 		}
 		if (syncErrors.length > 0) {
 			batch$1(() => {
@@ -2038,9 +2202,15 @@ var FieldArrayImpl = class {
 	currentValidatorAbort = null;
 	validatorDispose = null;
 	disposed = false;
-	constructor(itemFactory, options) {
+	onValidatorError = null;
+	/** Internal — see `FormImpl.bindValidatorErrorReporter`. */
+	bindValidatorErrorReporter(reporter) {
+		this.onValidatorError = reporter;
+	}
+	constructor(itemFactory, options, internalOptions) {
 		this.itemFactory = itemFactory;
 		this.validators = options?.validators ?? [];
+		this.onValidatorError = internalOptions?.onValidatorError ?? null;
 		this.items$ = signal$1([]);
 		if (options?.initial) {
 			this.initialItems = options.initial;
@@ -2131,6 +2301,7 @@ var FieldArrayImpl = class {
 		for (const item of this.items$.peek()) if (isForm(item)) tasks.push(item.validate());
 		else tasks.push(item.revalidate());
 		await Promise.all(tasks);
+		if (this.validators.length > 0) this.runTopLevelValidators();
 		if (this.topLevelValidating$.peek()) await new Promise((resolve) => {
 			const unsub = this.topLevelValidating$.subscribe((v) => {
 				if (!v) {
@@ -2157,10 +2328,15 @@ var FieldArrayImpl = class {
 		const myId = ++this.currentValidatorRun;
 		const syncErrors = [];
 		const asyncPromises = [];
-		for (const v of this.validators) {
+		for (const v of this.validators) try {
 			const r = v(value, abort.signal);
 			if (r instanceof Promise) asyncPromises.push(r);
 			else if (r != null) syncErrors.push(r);
+		} catch (err) {
+			try {
+				this.onValidatorError?.(err);
+			} catch {}
+			syncErrors.push(err instanceof Error ? err.message : String(err));
 		}
 		if (syncErrors.length > 0) {
 			batch$1(() => {
@@ -2191,11 +2367,11 @@ var FieldArrayImpl = class {
 		});
 	}
 };
-function createForm(schema, options) {
-	return new FormImpl(schema, options);
+function createForm(schema, options, internalOptions) {
+	return new FormImpl(schema, options, internalOptions);
 }
-function createFieldArray(itemFactory, options) {
-	return new FieldArrayImpl(itemFactory, options);
+function createFieldArray(itemFactory, options, internalOptions) {
+	return new FieldArrayImpl(itemFactory, options, internalOptions);
 }
 /**
 * Recursively wire every leaf `Field` in a form / field-array tree to a
@@ -2222,12 +2398,24 @@ function bindTreeToDevtoolsInto(node, prefix, controllerPath, emitter, disposers
 	}
 	if (isFieldArray(node)) {
 		const arr = node;
+		let perPass = [];
 		const stop = effect$1(() => {
-			arr.items.value.forEach((item, idx) => {
-				bindTreeToDevtoolsInto(item, `${prefix}[${idx}]`, controllerPath, emitter, disposers);
+			const items = arr.items.value;
+			for (const d of perPass) try {
+				d();
+			} catch {}
+			perPass = [];
+			items.forEach((item, idx) => {
+				bindTreeToDevtoolsInto(item, `${prefix}[${idx}]`, controllerPath, emitter, perPass);
 			});
 		});
 		disposers.push(stop);
+		disposers.push(() => {
+			for (const d of perPass) try {
+				d();
+			} catch {}
+			perPass = [];
+		});
 		return;
 	}
 	bindFieldDevtoolsOwner(node, {
@@ -2236,6 +2424,26 @@ function bindTreeToDevtoolsInto(node, prefix, controllerPath, emitter, disposers
 		emitter
 	});
 }
+/**
+* Walk a Form/FieldArray subtree and install `reporter` on every level —
+* leaf fields, nested forms' top-level validators, and field-arrays' top-level
+* validators. Called by `ctx.form` / `ctx.fieldArray` so synchronous validator
+* throws anywhere in the tree route through `root.onError`. See
+* `ValidatorErrorReporter` in `./field.ts`.
+*/
+function bindTreeValidatorErrorReporter(node, reporter) {
+	if (isForm(node)) {
+		node.bindValidatorErrorReporter?.(reporter);
+		for (const child of Object.values(node.fields)) bindTreeValidatorErrorReporter(child, reporter);
+		return;
+	}
+	if (isFieldArray(node)) {
+		node.bindValidatorErrorReporter?.(reporter);
+		for (const item of node.items.value) bindTreeValidatorErrorReporter(item, reporter);
+		return;
+	}
+	bindFieldValidatorErrorReporter(node, reporter);
+}
 //#endregion
 //#region src/query/local.ts
 var LocalCacheImpl = class {
@@ -2469,7 +2677,13 @@ var MutationImpl = class {
 	reset() {
 		if (this.disposed) return;
 		for (const handle of this.inflight) handle.abort.abort();
-		this.serialQueue.length = 0;
+		if (this.serialQueue.length > 0) {
+			const aborted = new DOMException("Aborted", "AbortError");
+			const queue = this.serialQueue;
+			this.serialQueue = [];
+			for (const queued of queue) queued.reject(aborted);
+		}
+		this.serialActive = false;
 		batch$1(() => {
 			this.data.set(void 0);
 			this.error.set(void 0);
@@ -2517,24 +2731,6 @@ function raceAbort(promise, signal) {
 		});
 	});
 }
-function abortableSleep(ms, signal) {
-	return new Promise((resolve, reject) => {
-		if (signal.aborted) {
-			reject(new DOMException("Aborted", "AbortError"));
-			return;
-		}
-		const timer = setTimeout(() => {
-			signal.removeEventListener("abort", onAbort);
-			resolve();
-		}, ms);
-		const onAbort = () => {
-			clearTimeout(timer);
-			signal.removeEventListener("abort", onAbort);
-			reject(new DOMException("Aborted", "AbortError"));
-		};
-		signal.addEventListener("abort", onAbort, { once: true });
-	});
-}
 //#endregion
 //#region src/query/use.ts
 var SubscriptionImpl = class {
@@ -2605,7 +2801,9 @@ function createUse(client, query, keyOrOptions) {
 	const enabledFn = typeof keyOrOptions === "object" && keyOrOptions !== null ? keyOrOptions.enabled : void 0;
 	const sub = new SubscriptionImpl(keepPreviousData);
 	let currentEntry = null;
+	let suspended = false;
 	const effectDispose = effect$1(() => {
+		if (suspended) return;
 		if (!(enabledFn ? enabledFn() : true)) {
 			untracked$1(() => {
 				if (currentEntry) {
@@ -2636,9 +2834,31 @@ function createUse(client, query, keyOrOptions) {
 		}
 		sub.detach();
 	};
+	const suspend = () => {
+		if (suspended) return;
+		suspended = true;
+		if (currentEntry) {
+			currentEntry.release();
+			currentEntry = null;
+		}
+	};
+	const resume = () => {
+		if (!suspended) return;
+		suspended = false;
+		if (!(enabledFn ? enabledFn() : true)) return;
+		const args = keyFn ? keyFn() : [];
+		const entry = client.bindEntry(query, args);
+		entry.acquire();
+		currentEntry = entry;
+		sub.attach(entry);
+		const status = entry.entry.status.peek();
+		if (status === "idle" || entry.entry.isStaleNow() || status === "error") entry.entry.startFetch().catch(() => {});
+	};
 	return {
 		subscription: sub,
-		dispose
+		dispose,
+		suspend,
+		resume
 	};
 }
 var InfiniteSubscriptionImpl = class {
@@ -2738,7 +2958,9 @@ function createInfiniteUse(client, query, keyOrOptions) {
 	const enabledFn = typeof keyOrOptions === "object" && keyOrOptions !== null ? keyOrOptions.enabled : void 0;
 	const sub = new InfiniteSubscriptionImpl(keepPreviousData);
 	let currentEntry = null;
+	let suspended = false;
 	const effectDispose = effect$1(() => {
+		if (suspended) return;
 		if (!(enabledFn ? enabledFn() : true)) {
 			untracked$1(() => {
 				if (currentEntry) {
@@ -2769,9 +2991,31 @@ function createInfiniteUse(client, query, keyOrOptions) {
 		}
 		sub.detach();
 	};
+	const suspend = () => {
+		if (suspended) return;
+		suspended = true;
+		if (currentEntry) {
+			currentEntry.release();
+			currentEntry = null;
+		}
+	};
+	const resume = () => {
+		if (!suspended) return;
+		suspended = false;
+		if (!(enabledFn ? enabledFn() : true)) return;
+		const args = keyFn ? keyFn() : [];
+		const entry = client.bindInfiniteEntry(query, args);
+		entry.acquire();
+		currentEntry = entry;
+		sub.attach(entry);
+		const status = entry.entry.status.peek();
+		if (status === "idle" || entry.entry.isStaleNow() || status === "error") entry.entry.startFetch().catch(() => {});
+	};
 	return {
 		subscription: sub,
-		dispose
+		dispose,
+		suspend,
+		resume
 	};
 }
 //#endregion
@@ -2821,7 +3065,6 @@ var ControllerInstance = class ControllerInstance {
 	}
 	dispose() {
 		if (this.state === "disposed") return;
-		this.state;
 		this.state = "disposed";
 		for (let i = this.entries.length - 1; i >= 0; i--) {
 			const entry = this.entries[i];
@@ -2847,6 +3090,9 @@ var ControllerInstance = class ControllerInstance {
 			case "cleanup":
 				entry.dispose();
 				break;
+			case "subscription-cache":
+				entry.dispose();
+				break;
 			case "child":
 				entry.instance.dispose();
 				break;
@@ -2872,6 +3118,9 @@ var ControllerInstance = class ControllerInstance {
 						entry.dispose?.();
 						entry.dispose = null;
 						break;
+					case "subscription-cache":
+						entry.suspend();
+						break;
 					case "child":
 						entry.instance.suspend();
 						break;
@@ -2896,6 +3145,9 @@ var ControllerInstance = class ControllerInstance {
 				case "effect":
 					entry.dispose = effect$1(entry.factory);
 					break;
+				case "subscription-cache":
+					entry.resume();
+					break;
 				case "child":
 					entry.instance.resume();
 					break;
@@ -2936,7 +3188,7 @@ var ControllerInstance = class ControllerInstance {
 					}
 				};
 				entry.factory = wrapped;
-				entry.dispose = effect$1(wrapped);
+				if (self.state !== "suspended") entry.dispose = effect$1(wrapped);
 				self.entries.push(entry);
 			},
 			cache(fetcher, options) {
@@ -2949,19 +3201,23 @@ var ControllerInstance = class ControllerInstance {
 			},
 			use(query, keyOrOptions) {
 				if (query.__olas === "infiniteQuery") {
-					const { subscription, dispose: d } = createInfiniteUse(self.rootShared.queryClient, query, keyOrOptions);
+					const handle = createInfiniteUse(self.rootShared.queryClient, query, keyOrOptions);
 					self.entries.push({
-						kind: "cleanup",
-						dispose: d
+						kind: "subscription-cache",
+						dispose: handle.dispose,
+						suspend: handle.suspend,
+						resume: handle.resume
 					});
-					return subscription;
+					return handle.subscription;
 				}
-				const { subscription, dispose: d } = createUse(self.rootShared.queryClient, query, keyOrOptions);
+				const handle = createUse(self.rootShared.queryClient, query, keyOrOptions);
 				self.entries.push({
-					kind: "cleanup",
-					dispose: d
+					kind: "subscription-cache",
+					dispose: handle.dispose,
+					suspend: handle.suspend,
+					resume: handle.resume
 				});
-				return subscription;
+				return handle.subscription;
 			},
 			mutation(spec) {
 				const m = createMutation(spec, self.rootShared.onError, self.path, self.rootShared.queryClient.mutationsInflight$, self.rootShared.devtools);
@@ -2980,7 +3236,12 @@ var ControllerInstance = class ControllerInstance {
 				return e;
 			},
 			field(initial, validators) {
-				const f = createField(initial, validators);
+				const f = createField(initial, validators, { onValidatorError: (err) => {
+					dispatchError(self.rootShared.onError, err, {
+						kind: "effect",
+						controllerPath: self.path
+					});
+				} });
 				self.entries.push({
 					kind: "cleanup",
 					dispose: () => f.dispose()
@@ -2993,7 +3254,13 @@ var ControllerInstance = class ControllerInstance {
 				return f;
 			},
 			form(schema, options) {
-				const f = createForm(schema, options);
+				const reporter = (err) => {
+					dispatchError(self.rootShared.onError, err, {
+						kind: "effect",
+						controllerPath: self.path
+					});
+				};
+				const f = createForm(schema, options, { onValidatorError: reporter });
 				self.entries.push({
 					kind: "cleanup",
 					dispose: () => f.dispose()
@@ -3003,10 +3270,17 @@ var ControllerInstance = class ControllerInstance {
 					kind: "cleanup",
 					dispose: stop
 				});
+				bindTreeValidatorErrorReporter(f, reporter);
 				return f;
 			},
 			fieldArray(itemFactory, options) {
-				const fa = createFieldArray(itemFactory, options);
+				const reporter = (err) => {
+					dispatchError(self.rootShared.onError, err, {
+						kind: "effect",
+						controllerPath: self.path
+					});
+				};
+				const fa = createFieldArray(itemFactory, options, { onValidatorError: reporter });
 				self.entries.push({
 					kind: "cleanup",
 					dispose: () => fa.dispose()
@@ -3016,6 +3290,7 @@ var ControllerInstance = class ControllerInstance {
 					kind: "cleanup",
 					dispose: stop
 				});
+				bindTreeValidatorErrorReporter(fa, reporter);
 				return fa;
 			},
 			provide(scope, value) {
@@ -3095,6 +3370,28 @@ var ControllerInstance = class ControllerInstance {
 								controllerPath: self.path
 							});
 						}
+					},
+					suspend: () => {
+						if (disposed) return;
+						try {
+							childInstance.suspend();
+						} catch (err) {
+							dispatchError(self.rootShared.onError, err, {
+								kind: "effect",
+								controllerPath: self.path
+							});
+						}
+					},
+					resume: () => {
+						if (disposed) return;
+						try {
+							childInstance.resume();
+						} catch (err) {
+							dispatchError(self.rootShared.onError, err, {
+								kind: "effect",
+								controllerPath: self.path
+							});
+						}
 					}
 				};
 			},
@@ -3186,7 +3483,13 @@ function createRootWithProps(def, props, options) {
 		onError: options.onError,
 		queryClient
 	}, "root", options.deps);
-	const api = instance.construct(getFactory(def), props);
+	let api;
+	try {
+		api = instance.construct(getFactory(def), props);
+	} catch (err) {
+		queryClient.dispose();
+		throw err;
+	}
 	if (typeof api !== "object" || api === null) return attachRootControls({ value: api }, instance, devtools, queryClient);
 	return attachRootControls(api, instance, devtools, queryClient);
 }
@@ -3265,6 +3568,6 @@ function createRoot(def, options) {
 	return createRootWithProps(def, void 0, options);
 }
 //#endregion
-export { lookupRegisteredQuery as a, batch$1 as c, signal$1 as d, untracked$1 as f, createEmitter as i, computed$1 as l, createRootWithProps as n, registerQueryById as o, defineController as p, debouncedValidator as r, isAbortError as s, createRoot as t, effect$1 as u };
+export { lookupRegisteredQuery as a, isAbortError as c, effect$1 as d, signal$1 as f, createEmitter as i, batch$1 as l, defineController as m, createRootWithProps as n, registerQueryById as o, untracked$1 as p, debouncedValidator as r, stableHash as s, createRoot as t, computed$1 as u };
 
-//# sourceMappingURL=root-BImHnGj1.mjs.map
+//# sourceMappingURL=root-BCZDC5Fv.mjs.map