@vielzeug/forge 1.3.1 → 1.4.0

package/dist/core/fields.js

@@ -0,0 +1,310 @@
+import { warn as e } from "../_dev.js";
+import { ForgeSubmitError as t, ForgeValidationError as n } from "../errors.js";
+import { anySignal as r, assertSafeKey as i, flattenValues as a, isSafeKey as o, sanitizeForLog as s, unflattenValues as c } from "../_utils.js";
+import { createArrayField as l } from "./array.js";
+import { isAbortError as u } from "@vielzeug/arsenal";
+//#region src/core/fields.ts
+function d(d) {
+	function f(e) {
+		let t = e;
+		return i(t), d.store.get(t);
+	}
+	function p() {
+		return d.cachedValues ??= c(Object.fromEntries(d.store));
+	}
+	function m(e, t) {
+		d.baseline.get(e) === t ? d.dirty.delete(e) : d.dirty.add(e);
+	}
+	function h(e, t, n = {}) {
+		d.ensureNotDisposed("set");
+		let r = e;
+		i(r), d.store.set(r, t), m(r, t), n.touched && d.touched.add(r), d.requestNotify(r);
+	}
+	function g(e) {
+		let t = e;
+		return i(t), d.getFieldSnapshot(t);
+	}
+	function _(e, t) {
+		d.ensureNotDisposed("setError");
+		let n = e;
+		i(n), d.fieldErrors.set(n, t), d.invalidateErrors(), d.requestNotify(n);
+	}
+	function v(e) {
+		d.ensureNotDisposed("clearError");
+		let t = e;
+		i(t), d.fieldErrors.delete(t) && (d.invalidateErrors(), d.requestNotify(t));
+	}
+	function y(e, t, n) {
+		for (let t of [...d.fieldErrors.keys()]) e(t) && d.fieldErrors.delete(t);
+		for (let [e, r] of Object.entries(t)) {
+			let t = n(e);
+			i(t), typeof r == "string" && d.fieldErrors.set(t, r);
+		}
+		d.invalidateErrors();
+	}
+	function b(e = {}) {
+		d.ensureNotDisposed("resetErrors"), y(() => !0, e, (e) => e), d.requestNotify();
+	}
+	function x(t, n) {
+		/\.\d+(\.|$)/.test(t) && !d.store.has(t) && e(`${n}('${s(t, 80)}'): path looks like an array item key. Array items are stored as whole arrays — register on the parent key instead.`);
+	}
+	function S(e, t) {
+		d.ensureNotDisposed("setValidator");
+		let n = e;
+		i(n), x(n, "setValidator"), d.fieldCtrls.get(n)?.abort(), d.fieldCtrls.delete(n), t ? d.validators.set(n, t) : (d.validators.delete(n), d.fieldErrors.delete(n) && (d.invalidateErrors(), d.requestNotify(n)));
+	}
+	function C(e, t = {}) {
+		d.ensureNotDisposed("fields.register");
+		let n = e;
+		return i(n), x(n, "fields.register"), t.validator !== void 0 && S(e, t.validator), t.defaultValue !== void 0 && !d.store.has(n) && (d.store.set(n, t.defaultValue), d.baseline.set(n, t.defaultValue), d.requestNotify(n)), () => {
+			d.disposed || M(e);
+		};
+	}
+	function w() {
+		let e = /* @__PURE__ */ new Set();
+		for (let t of d.store.keys()) e.add(t);
+		for (let t of d.validators.keys()) e.add(t);
+		return Object.freeze([...e]);
+	}
+	function T(e) {
+		d.ensureNotDisposed("touch");
+		let t = e;
+		i(t), d.touched.add(t), d.requestNotify(t);
+	}
+	function E(e) {
+		d.ensureNotDisposed("untouch");
+		let t = e;
+		i(t), d.touched.delete(t) && d.requestNotify(t);
+	}
+	function D(e) {
+		for (let t of d.store.keys()) e(t) && d.touched.add(t);
+		for (let t of d.validators.keys()) e(t) && d.touched.add(t);
+	}
+	function O() {
+		d.ensureNotDisposed("touchAll"), D(() => !0), d.requestNotify();
+	}
+	function k(e) {
+		for (let t of [...d.touched]) e(t) && d.touched.delete(t);
+	}
+	function A() {
+		d.ensureNotDisposed("untouchAll"), k(() => !0), d.requestNotify();
+	}
+	function j(e) {
+		d.ensureNotDisposed("resetField");
+		let t = e;
+		i(t), d.fieldCtrls.get(t)?.abort(), d.fieldCtrls.delete(t), d.store.set(t, d.baseline.get(t)), d.dirty.delete(t), d.touched.delete(t), d.fieldErrors.delete(t) && d.invalidateErrors(), d.requestNotify(t);
+	}
+	function M(e) {
+		d.ensureNotDisposed("fields.remove");
+		let t = e;
+		i(t), d.store.delete(t), d.baseline.delete(t), d.dirty.delete(t), d.touched.delete(t), d.validators.delete(t), d.arrayCache.delete(t), d.fieldCtrls.get(t)?.abort(), d.fieldCtrls.delete(t), d.fieldErrors.delete(t) && d.invalidateErrors(), d.requestNotify(t);
+	}
+	function N() {
+		return /* @__PURE__ */ new Set([
+			...d.store.keys(),
+			...d.touched,
+			...d.fieldErrors.keys(),
+			...d.validators.keys()
+		]);
+	}
+	function P(e) {
+		for (let t of N()) e(t) && (d.fieldCtrls.get(t)?.abort(), d.fieldCtrls.delete(t), d.baseline.has(t) ? d.store.set(t, d.baseline.get(t)) : d.store.delete(t), d.dirty.delete(t), d.touched.delete(t), d.fieldErrors.delete(t) && d.invalidateErrors());
+	}
+	function F() {
+		d.ensureNotDisposed("reset");
+		for (let e of d.runCtrls) e.abort();
+		d.runCtrls.clear(), d.validatingRuns.clear(), P(() => !0), d.submitCount = 0, d.requestNotify();
+	}
+	function I(e, t, n) {
+		for (let t of N()) e(t) && (d.fieldCtrls.get(t)?.abort(), d.fieldCtrls.delete(t), d.store.delete(t), d.baseline.delete(t), d.dirty.delete(t), d.touched.delete(t), d.fieldErrors.delete(t) && d.invalidateErrors());
+		for (let [e, r] of Object.entries(t)) {
+			let t = n(e);
+			d.store.set(t, r), d.baseline.set(t, r);
+		}
+	}
+	function L(e) {
+		d.ensureNotDisposed("replace");
+		for (let e of d.runCtrls) e.abort();
+		d.runCtrls.clear(), d.validatingRuns.clear(), I(() => !0, a(e), (e) => e), d.submitCount = 0, d.requestNotify();
+	}
+	function R(e, t) {
+		let n = a(e), r = [];
+		for (let [e, i] of Object.entries(n)) {
+			let n = t(e);
+			d.baseline.set(n, i), d.store.set(n, i), d.dirty.delete(n), r.push(n);
+		}
+		return r;
+	}
+	function z(e) {
+		d.ensureNotDisposed("patch"), d.requestNotify(R(e, (e) => e));
+	}
+	function B(e) {
+		d.ensureNotDisposed("array");
+		let t = e;
+		i(t);
+		let n = d.arrayCache.get(t);
+		if (n) return n;
+		let r = l(e, d.store, h);
+		return d.arrayCache.set(t, r), r;
+	}
+	async function V(e, t) {
+		let n = d.validators.get(e);
+		if (!n) return;
+		if (t.aborted) throw t.reason;
+		let r = await n(d.store.get(e), t);
+		return typeof r == "string" ? r : void 0;
+	}
+	async function H(e) {
+		if (!d.formValidator) return {};
+		if (e.aborted) throw e.reason;
+		let t = await d.formValidator(p(), e), n = {};
+		if (t) for (let [e, r] of Object.entries(t)) o(e) && typeof r == "string" && (n[e] = r);
+		return n;
+	}
+	function U(e, t, n, r) {
+		if (r === "full") {
+			d.fieldErrors.clear();
+			for (let [e, r] of Object.entries(n)) t[e] === void 0 && (t[e] = r);
+			for (let [e, n] of Object.entries(t)) d.fieldErrors.set(e, n);
+			d.invalidateErrors(), d.requestNotify();
+		} else {
+			let n = /* @__PURE__ */ new Set();
+			for (let r of e) {
+				let e = t[r], i = d.fieldErrors.get(r);
+				e === void 0 ? d.fieldErrors.delete(r) && n.add(r) : (d.fieldErrors.set(r, e), i !== e && n.add(r));
+			}
+			n.size > 0 && d.invalidateErrors(), d.requestNotify(n);
+		}
+	}
+	async function W(e, t, n) {
+		let i = new Set(e), a = /* @__PURE__ */ new Map();
+		for (let e of i) {
+			d.fieldCtrls.get(e)?.abort();
+			let t = new AbortController();
+			d.fieldCtrls.set(e, t), a.set(e, t);
+		}
+		let o = new AbortController(), s = r(o.signal, n, d.disposeController.signal);
+		d.runCtrls.add(o);
+		let c = Symbol();
+		for (let e of i) {
+			let t = d.validatingRuns.get(e);
+			t || (t = /* @__PURE__ */ new Set(), d.validatingRuns.set(e, t)), t.add(c);
+		}
+		d.requestNotify();
+		try {
+			let e = await Promise.all([...i].map(async (e) => [e, await V(e, t === "partial" ? r(a.get(e).signal, s) : s)]));
+			if (s.aborted) return {
+				aborted: !0,
+				errors: Object.fromEntries(d.fieldErrors),
+				valid: d.fieldErrors.size === 0
+			};
+			let n = {};
+			for (let [t, r] of e) r !== void 0 && (n[t] = r);
+			return U(i, n, t === "full" ? await H(s) : {}, t), {
+				aborted: !1,
+				errors: Object.fromEntries(d.fieldErrors),
+				valid: d.fieldErrors.size === 0
+			};
+		} catch (e) {
+			if (u(e)) return {
+				aborted: !0,
+				errors: Object.fromEntries(d.fieldErrors),
+				valid: d.fieldErrors.size === 0
+			};
+			throw e;
+		} finally {
+			d.runCtrls.delete(o);
+			for (let e of i) {
+				let t = d.validatingRuns.get(e);
+				t && (t.delete(c), t.size === 0 && d.validatingRuns.delete(e));
+			}
+			d.requestNotify();
+			for (let [e, t] of a) d.fieldCtrls.get(e) === t && d.fieldCtrls.delete(e);
+		}
+	}
+	async function G(e, t) {
+		d.ensureNotDisposed("validate");
+		let n = await W(e, "partial", t);
+		return {
+			errors: n.errors,
+			valid: n.valid
+		};
+	}
+	async function K(e, t) {
+		if (d.ensureNotDisposed("validate"), e === void 0 || e instanceof AbortSignal) {
+			let t = await W([...d.validators.keys()], "full", e);
+			return {
+				errors: t.errors,
+				valid: t.valid
+			};
+		}
+		if (Array.isArray(e)) return G(e, t);
+		await G([e], t);
+		let n = e, r = d.fieldErrors.get(n);
+		return {
+			errors: r === void 0 ? {} : { [n]: r },
+			valid: r === void 0
+		};
+	}
+	async function q(e) {
+		let t = await J(e);
+		if (!t.ok) throw new n(t.errors);
+		return t.value;
+	}
+	async function J(e) {
+		if (d.ensureNotDisposed("submit"), d.isSubmittingState) throw new t("submit() called while a submission is already in progress");
+		d.batch(() => {
+			d.submitCount++, d.isSubmittingState = !0, O();
+		});
+		try {
+			let t = await W([...d.validators.keys()], "full");
+			return d.ensureNotDisposed("submit"), t.valid ? {
+				ok: !0,
+				value: await e(p())
+			} : {
+				errors: t.errors,
+				ok: !1,
+				type: "validation"
+			};
+		} finally {
+			d.isSubmittingState = !1, d.disposed || d.requestNotify();
+		}
+	}
+	return {
+		array: B,
+		clearError: v,
+		field: g,
+		get: f,
+		listFields: w,
+		patch: z,
+		patchKeys: R,
+		registerField: C,
+		removeField: M,
+		replace: L,
+		replaceKeys: I,
+		reset: F,
+		resetErrors: b,
+		resetErrorsKeys: y,
+		resetField: j,
+		resetKeys: P,
+		runValidationCore: W,
+		set: h,
+		setError: _,
+		setValidator: S,
+		submit: J,
+		submitOrThrow: q,
+		touch: T,
+		touchAll: O,
+		touchAllKeys: D,
+		untouch: E,
+		untouchAll: A,
+		untouchAllKeys: k,
+		validate: K,
+		validateFields: G,
+		values: p
+	};
+}
+//#endregion
+export { d as createFieldOps };
+
+//# sourceMappingURL=fields.js.map

package/dist/core/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","names":[],"sources":["../../src/core/fields.ts"],"sourcesContent":["import { isAbortError } from '@vielzeug/arsenal';\n\nimport type { FormContext } from './context';\n\nimport { warn } from '../_dev';\nimport { anySignal, assertSafeKey, flattenValues, isSafeKey, sanitizeForLog, unflattenValues } from '../_utils';\nimport { ForgeSubmitError, ForgeValidationError } from '../errors';\nimport {\n  type ArrayField,\n  type ErrorKeyOf,\n  type FieldState,\n  type FieldValidator,\n  type FlatKeyOf,\n  type MaybePromise,\n  type RegisterFieldOptions,\n  type SetOptions,\n  type SubmitResult,\n  type TypeAtPath,\n  type Unsubscribe,\n  type ValidateResult,\n} from '../types';\nimport { createArrayField } from './array';\n\n/**\n * Field values, dirty/touch tracking, field-level errors, dynamic field registration, and\n * validation/submit — one module, not the two (`values.ts`/`validation.ts`) it used to be\n * split across. That split was drawn along \"which section of the original monolithic\n * `createForm()` this code used to live in,\" not along a real boundary: validating a field\n * needs the same store/fieldErrors/fieldCtrls state that setting one does, so the old split\n * required threading `deps: Pick<ValueOps, '...'>` between files just to call each other. One\n * closure removes that threading entirely.\n *\n * The six `*Keys(predicate)` functions below are the shared bulk-mutation primitives behind\n * `reset`/`replace`/`patch`/`touchAll`/`untouchAll`/`resetErrors`. `scope.ts` calls them with\n * an `isScopedKey` predicate instead of maintaining its own second copy of each loop.\n */\nexport function createFieldOps<TValues extends Record<string, unknown>>(ctx: FormContext<TValues>) {\n  /* ======== Values ======== */\n\n  function get<K extends FlatKeyOf<TValues>>(name: K): TypeAtPath<TValues, K> {\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    return ctx.store.get(key) as TypeAtPath<TValues, K>;\n  }\n\n  function values(): TValues {\n    return (ctx.cachedValues ??= unflattenValues(Object.fromEntries(ctx.store)) as TValues);\n  }\n\n  function trackDirty(name: string, value: unknown): void {\n    if (ctx.baseline.get(name) === value) ctx.dirty.delete(name);\n    else ctx.dirty.add(name);\n  }\n\n  function set<K extends FlatKeyOf<TValues>>(name: K, value: TypeAtPath<TValues, K>, options: SetOptions = {}): void {\n    ctx.ensureNotDisposed('set');\n\n    const key = name as string;\n\n    assertSafeKey(key);\n    ctx.store.set(key, value);\n    trackDirty(key, value);\n\n    if (options.touched) ctx.touched.add(key);\n\n    ctx.requestNotify(key);\n  }\n\n  function field<K extends FlatKeyOf<TValues>>(name: K): FieldState<TypeAtPath<TValues, K>> {\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    return ctx.getFieldSnapshot(key) as FieldState<TypeAtPath<TValues, K>>;\n  }\n\n  /* ======== Errors ======== */\n\n  function setError(name: ErrorKeyOf<TValues>, message: string): void {\n    ctx.ensureNotDisposed('setError');\n\n    const key = name as string;\n\n    assertSafeKey(key);\n    ctx.fieldErrors.set(key, message);\n    ctx.invalidateErrors();\n    ctx.requestNotify(key);\n  }\n\n  function clearError(name: ErrorKeyOf<TValues>): void {\n    ctx.ensureNotDisposed('clearError');\n\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    if (ctx.fieldErrors.delete(key)) {\n      ctx.invalidateErrors();\n      ctx.requestNotify(key);\n    }\n  }\n\n  /**\n   * Shared primitive behind `resetErrors()` (predicate `() => true`) and `scope.ts`'s scoped\n   * `resetErrors()` (predicate `isScopedKey`, mapper `pre`). Clears every error matching\n   * `predicate`, then applies `nextErrors` through `toFullKey`.\n   */\n  function resetErrorsKeys(\n    predicate: (key: string) => boolean,\n    nextErrors: Partial<Record<string, string | undefined>>,\n    toFullKey: (key: string) => string,\n  ): void {\n    for (const key of [...ctx.fieldErrors.keys()]) {\n      if (predicate(key)) ctx.fieldErrors.delete(key);\n    }\n\n    for (const [key, message] of Object.entries(nextErrors)) {\n      const fullKey = toFullKey(key);\n\n      assertSafeKey(fullKey);\n\n      if (typeof message === 'string') ctx.fieldErrors.set(fullKey, message);\n    }\n\n    ctx.invalidateErrors();\n  }\n\n  function resetErrors(nextErrors: Partial<Record<ErrorKeyOf<TValues>, string | undefined>> = {}): void {\n    ctx.ensureNotDisposed('resetErrors');\n    resetErrorsKeys(\n      () => true,\n      nextErrors,\n      (k) => k,\n    );\n    ctx.requestNotify();\n  }\n\n  /**\n   * Warns when `key` looks like a dot-notation array item path (e.g. \"tags.0\") that isn't\n   * already a real store entry — array items are stored as whole arrays, not individual keys.\n   * Shared by `setValidator()` and `registerField()`.\n   */\n  function warnIfArrayItemKey(key: string, apiLabel: string): void {\n    if (/\\.\\d+(\\.|$)/.test(key) && !ctx.store.has(key)) {\n      const displayKey = sanitizeForLog(key, 80);\n\n      warn(\n        `${apiLabel}('${displayKey}'): path looks like an array item key. ` +\n          `Array items are stored as whole arrays — register on the parent key instead.`,\n      );\n    }\n  }\n\n  function setValidator(name: FlatKeyOf<TValues>, validator?: FieldValidator<unknown>): void {\n    ctx.ensureNotDisposed('setValidator');\n\n    const key = name as string;\n\n    assertSafeKey(key);\n    warnIfArrayItemKey(key, 'setValidator');\n\n    ctx.fieldCtrls.get(key)?.abort();\n    ctx.fieldCtrls.delete(key);\n\n    if (validator) {\n      ctx.validators.set(key, validator);\n    } else {\n      ctx.validators.delete(key);\n\n      if (ctx.fieldErrors.delete(key)) {\n        ctx.invalidateErrors();\n        ctx.requestNotify(key);\n      }\n    }\n  }\n\n  /* ======== Dynamic field registration ======== */\n\n  function registerField<K extends FlatKeyOf<TValues>>(\n    name: K,\n    options: RegisterFieldOptions<TypeAtPath<TValues, K>> = {},\n  ): Unsubscribe {\n    ctx.ensureNotDisposed('fields.register');\n\n    const key = name as string;\n\n    assertSafeKey(key);\n    warnIfArrayItemKey(key, 'fields.register');\n\n    if (options.validator !== undefined) setValidator(name, options.validator as FieldValidator<unknown>);\n\n    if (options.defaultValue !== undefined && !ctx.store.has(key)) {\n      ctx.store.set(key, options.defaultValue);\n      ctx.baseline.set(key, options.defaultValue);\n      ctx.requestNotify(key);\n    }\n\n    return () => {\n      if (!ctx.disposed) removeField(name);\n    };\n  }\n\n  function listFields(): readonly string[] {\n    const known = new Set<string>();\n\n    for (const name of ctx.store.keys()) known.add(name);\n    for (const name of ctx.validators.keys()) known.add(name);\n\n    return Object.freeze([...known]);\n  }\n\n  /* ======== Touch ======== */\n\n  function touch(name: FlatKeyOf<TValues>): void {\n    ctx.ensureNotDisposed('touch');\n\n    const key = name as string;\n\n    assertSafeKey(key);\n    ctx.touched.add(key);\n    ctx.requestNotify(key);\n  }\n\n  function untouch(name: FlatKeyOf<TValues>): void {\n    ctx.ensureNotDisposed('untouch');\n\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    if (ctx.touched.delete(key)) ctx.requestNotify(key);\n  }\n\n  /** Shared by `touchAll()` and scope.ts's scoped `touchAll()`. */\n  function touchAllKeys(predicate: (key: string) => boolean): void {\n    for (const name of ctx.store.keys()) if (predicate(name)) ctx.touched.add(name);\n    for (const name of ctx.validators.keys()) if (predicate(name)) ctx.touched.add(name);\n  }\n\n  function touchAll(): void {\n    ctx.ensureNotDisposed('touchAll');\n    touchAllKeys(() => true);\n    ctx.requestNotify();\n  }\n\n  /** Shared by `untouchAll()` and scope.ts's scoped `untouchAll()`. */\n  function untouchAllKeys(predicate: (key: string) => boolean): void {\n    for (const name of [...ctx.touched]) if (predicate(name)) ctx.touched.delete(name);\n  }\n\n  function untouchAll(): void {\n    ctx.ensureNotDisposed('untouchAll');\n    untouchAllKeys(() => true);\n    ctx.requestNotify();\n  }\n\n  /* ======== Lifecycle: field operations ======== */\n\n  function resetField(name: FlatKeyOf<TValues>): void {\n    ctx.ensureNotDisposed('resetField');\n\n    const key = name as string;\n\n    assertSafeKey(key);\n    ctx.fieldCtrls.get(key)?.abort();\n    ctx.fieldCtrls.delete(key);\n    ctx.store.set(key, ctx.baseline.get(key));\n    ctx.dirty.delete(key);\n    ctx.touched.delete(key);\n\n    if (ctx.fieldErrors.delete(key)) ctx.invalidateErrors();\n\n    ctx.requestNotify(key);\n  }\n\n  function removeField(name: FlatKeyOf<TValues>): void {\n    ctx.ensureNotDisposed('fields.remove');\n\n    const key = name as string;\n\n    assertSafeKey(key);\n    ctx.store.delete(key);\n    ctx.baseline.delete(key);\n    ctx.dirty.delete(key);\n    ctx.touched.delete(key);\n    ctx.validators.delete(key);\n    ctx.arrayCache.delete(key);\n    ctx.fieldCtrls.get(key)?.abort();\n    ctx.fieldCtrls.delete(key);\n\n    if (ctx.fieldErrors.delete(key)) ctx.invalidateErrors();\n\n    ctx.requestNotify(key);\n  }\n\n  /**\n   * Every key a bulk operation might need to touch — not just `store.keys()`. A validator-only\n   * field (a validator with no matching store entry, e.g. a cross-field or virtual-name\n   * validator) can still be `touched` or hold a `fieldErrors` entry, so `resetKeys`/\n   * `replaceKeys` below must consider `touched`/`fieldErrors`/`validators` too, not just\n   * `store` — deriving \"everything reset must clear\" from `store.keys()` alone silently leaves\n   * such a field's touched/error state behind.\n   */\n  function allKnownKeys(): Set<string> {\n    return new Set([...ctx.store.keys(), ...ctx.touched, ...ctx.fieldErrors.keys(), ...ctx.validators.keys()]);\n  }\n\n  /**\n   * Shared primitive behind `reset()` (predicate `() => true`) and scope.ts's scoped\n   * `reset()` (predicate `isScopedKey`). For each known key matching `predicate`: aborts its\n   * in-flight field validation, restores its baseline value (or removes it entirely if it has\n   * no baseline entry — e.g. a key written via `set()` alone, never through `patch()`), and\n   * clears its dirty/touched/error state.\n   */\n  function resetKeys(predicate: (key: string) => boolean): void {\n    for (const key of allKnownKeys()) {\n      if (!predicate(key)) continue;\n\n      ctx.fieldCtrls.get(key)?.abort();\n      ctx.fieldCtrls.delete(key);\n\n      // Both branches are no-ops for a validator-only key that was never in `store` to begin\n      // with — `Map.delete()` on an absent key is a safe no-op, and `baseline.has(key)` is\n      // false for it, so it falls through to `delete` rather than writing an `undefined` entry.\n      if (ctx.baseline.has(key)) ctx.store.set(key, ctx.baseline.get(key));\n      else ctx.store.delete(key);\n\n      ctx.dirty.delete(key);\n      ctx.touched.delete(key);\n\n      if (ctx.fieldErrors.delete(key)) ctx.invalidateErrors();\n    }\n  }\n\n  function reset(): void {\n    ctx.ensureNotDisposed('reset');\n\n    for (const ctrl of ctx.runCtrls) ctrl.abort();\n\n    ctx.runCtrls.clear();\n    ctx.validatingRuns.clear();\n    resetKeys(() => true);\n    ctx.submitCount = 0;\n    ctx.requestNotify();\n  }\n\n  /**\n   * Shared primitive behind `replace()` (predicate `() => true`, mapper `(k) => k`) and\n   * scope.ts's scoped `replace()` (predicate `isScopedKey`, mapper `pre`). Removes every\n   * store/baseline/touched/error entry matching `predicate` (see `allKnownKeys()` above for\n   * why this isn't just `store.keys()`), then writes `flat` back in as both store and baseline\n   * (a replace always establishes a new, clean baseline).\n   */\n  function replaceKeys(\n    predicate: (key: string) => boolean,\n    flat: Record<string, unknown>,\n    toFullKey: (key: string) => string,\n  ): void {\n    for (const key of allKnownKeys()) {\n      if (!predicate(key)) continue;\n\n      ctx.fieldCtrls.get(key)?.abort();\n      ctx.fieldCtrls.delete(key);\n      ctx.store.delete(key);\n      ctx.baseline.delete(key);\n      ctx.dirty.delete(key);\n      ctx.touched.delete(key);\n\n      if (ctx.fieldErrors.delete(key)) ctx.invalidateErrors();\n    }\n\n    for (const [key, value] of Object.entries(flat)) {\n      const fullKey = toFullKey(key);\n\n      ctx.store.set(fullKey, value);\n      ctx.baseline.set(fullKey, value);\n    }\n  }\n\n  function replace(newValues: TValues): void {\n    ctx.ensureNotDisposed('replace');\n\n    for (const ctrl of ctx.runCtrls) ctrl.abort();\n\n    ctx.runCtrls.clear();\n    ctx.validatingRuns.clear();\n    replaceKeys(\n      () => true,\n      flattenValues(newValues as Record<string, unknown>),\n      (k) => k,\n    );\n    ctx.submitCount = 0;\n    ctx.requestNotify();\n  }\n\n  /**\n   * Shared primitive behind `patch()` and scope.ts's scoped `patch()` (mapper `pre`). Unlike\n   * `resetKeys`/`replaceKeys`, `patch()` never needs a predicate — the partial object itself\n   * already names exactly the keys to touch. Returns the full (prefixed) keys written, for\n   * the caller to pass to `requestNotify()`.\n   */\n  function patchKeys(partial: Record<string, unknown>, toFullKey: (key: string) => string): string[] {\n    const flat = flattenValues(partial);\n    const changedKeys: string[] = [];\n\n    for (const [key, value] of Object.entries(flat)) {\n      const fullKey = toFullKey(key);\n\n      ctx.baseline.set(fullKey, value);\n      ctx.store.set(fullKey, value);\n      ctx.dirty.delete(fullKey);\n      changedKeys.push(fullKey);\n    }\n\n    return changedKeys;\n  }\n\n  function patch(partial: Record<string, unknown>): void {\n    ctx.ensureNotDisposed('patch');\n    ctx.requestNotify(patchKeys(partial, (k) => k));\n  }\n\n  /* ======== Array helpers ======== */\n\n  function array(name: FlatKeyOf<TValues>): ArrayField {\n    ctx.ensureNotDisposed('array');\n\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    const cached = ctx.arrayCache.get(key);\n\n    if (cached) return cached;\n\n    const helpers = createArrayField(name, ctx.store, set as (name: string, value: unknown) => void);\n\n    ctx.arrayCache.set(key, helpers);\n\n    return helpers;\n  }\n\n  /* ======== Validation ======== */\n\n  async function runFieldValidator(name: string, signal: AbortSignal): Promise<string | undefined> {\n    const validator = ctx.validators.get(name);\n\n    if (!validator) return undefined;\n\n    if (signal.aborted) throw signal.reason;\n\n    const result = await validator(ctx.store.get(name), signal);\n\n    return typeof result === 'string' ? result : undefined;\n  }\n\n  async function runFormValidator(signal: AbortSignal): Promise<Record<string, string>> {\n    if (!ctx.formValidator) return {};\n\n    if (signal.aborted) throw signal.reason;\n\n    const result = await ctx.formValidator(values(), signal);\n    const errors: Record<string, string> = {};\n\n    if (result) {\n      for (const [key, message] of Object.entries(result)) {\n        // Security: a custom FormValidator function is caller-authored code — its returned\n        // keys are just as untrusted as a schema's `issue.path`. Reject reserved segments.\n        if (isSafeKey(key) && typeof message === 'string') errors[key] = message;\n      }\n    }\n\n    return errors;\n  }\n\n  function applyFieldErrors(\n    fieldSet: Set<string>,\n    nextErrors: Record<string, string>,\n    formErrors: Record<string, string>,\n    scope: 'full' | 'partial',\n  ): void {\n    if (scope === 'full') {\n      ctx.fieldErrors.clear();\n\n      for (const [key, message] of Object.entries(formErrors)) {\n        if (nextErrors[key] === undefined) nextErrors[key] = message;\n      }\n\n      for (const [key, message] of Object.entries(nextErrors)) ctx.fieldErrors.set(key, message);\n\n      ctx.invalidateErrors();\n      ctx.requestNotify();\n    } else {\n      const changedFields = new Set<string>();\n\n      for (const name of fieldSet) {\n        const next = nextErrors[name];\n        const previous = ctx.fieldErrors.get(name);\n\n        if (next !== undefined) {\n          ctx.fieldErrors.set(name, next);\n\n          if (previous !== next) changedFields.add(name);\n        } else if (ctx.fieldErrors.delete(name)) {\n          changedFields.add(name);\n        }\n      }\n\n      if (changedFields.size > 0) ctx.invalidateErrors();\n\n      ctx.requestNotify(changedFields);\n    }\n  }\n\n  async function runValidationCore(\n    fields: string[],\n    scope: 'full' | 'partial',\n    signal?: AbortSignal,\n  ): Promise<ValidateResult & { aborted: boolean }> {\n    const fieldSet = new Set(fields);\n    const fieldRunCtrls = new Map<string, AbortController>();\n\n    for (const name of fieldSet) {\n      ctx.fieldCtrls.get(name)?.abort();\n\n      const ctrl = new AbortController();\n\n      ctx.fieldCtrls.set(name, ctrl);\n      fieldRunCtrls.set(name, ctrl);\n    }\n\n    const runCtrl = new AbortController();\n    const runSignal = anySignal(runCtrl.signal, signal, ctx.disposeController.signal)!;\n\n    ctx.runCtrls.add(runCtrl);\n\n    // Symbol-based ref-counting: each run gets a unique token per field.\n    // The field leaves validatingFields only when its Set empties — impossible to miscount.\n    const runId = Symbol();\n\n    for (const name of fieldSet) {\n      let runs = ctx.validatingRuns.get(name);\n\n      if (!runs) {\n        runs = new Set<symbol>();\n        ctx.validatingRuns.set(name, runs);\n      }\n\n      runs.add(runId);\n    }\n\n    ctx.requestNotify();\n\n    try {\n      const results = await Promise.all(\n        [...fieldSet].map(async (name) => {\n          const fieldSignal = scope === 'partial' ? anySignal(fieldRunCtrls.get(name)!.signal, runSignal)! : runSignal;\n\n          return [name, await runFieldValidator(name, fieldSignal)] as const;\n        }),\n      );\n\n      if (runSignal.aborted) {\n        return { aborted: true, errors: Object.fromEntries(ctx.fieldErrors), valid: ctx.fieldErrors.size === 0 };\n      }\n\n      const nextErrors: Record<string, string> = {};\n\n      for (const [name, message] of results) {\n        if (message !== undefined) nextErrors[name] = message;\n      }\n\n      const formErrors = scope === 'full' ? await runFormValidator(runSignal) : {};\n\n      applyFieldErrors(fieldSet, nextErrors, formErrors, scope);\n\n      return { aborted: false, errors: Object.fromEntries(ctx.fieldErrors), valid: ctx.fieldErrors.size === 0 };\n    } catch (error) {\n      if (isAbortError(error)) {\n        return { aborted: true, errors: Object.fromEntries(ctx.fieldErrors), valid: ctx.fieldErrors.size === 0 };\n      }\n\n      throw error;\n    } finally {\n      ctx.runCtrls.delete(runCtrl);\n\n      for (const name of fieldSet) {\n        const runs = ctx.validatingRuns.get(name);\n\n        if (runs) {\n          runs.delete(runId);\n\n          if (runs.size === 0) ctx.validatingRuns.delete(name);\n        }\n      }\n\n      ctx.requestNotify();\n\n      for (const [name, ctrl] of fieldRunCtrls) {\n        if (ctx.fieldCtrls.get(name) === ctrl) ctx.fieldCtrls.delete(name);\n      }\n    }\n  }\n\n  async function validateFields(\n    fields: FlatKeyOf<TValues>[] | string[],\n    signal?: AbortSignal,\n  ): Promise<ValidateResult> {\n    ctx.ensureNotDisposed('validate');\n\n    const result = await runValidationCore(fields as string[], 'partial', signal);\n\n    return { errors: result.errors, valid: result.valid };\n  }\n\n  async function validate(\n    nameOrFieldsOrSignal?: FlatKeyOf<TValues> | FlatKeyOf<TValues>[] | AbortSignal,\n    signal?: AbortSignal,\n  ): Promise<ValidateResult> {\n    ctx.ensureNotDisposed('validate');\n\n    if (nameOrFieldsOrSignal === undefined || nameOrFieldsOrSignal instanceof AbortSignal) {\n      const result = await runValidationCore(\n        [...ctx.validators.keys()],\n        'full',\n        nameOrFieldsOrSignal as AbortSignal | undefined,\n      );\n\n      return { errors: result.errors, valid: result.valid };\n    }\n\n    if (Array.isArray(nameOrFieldsOrSignal)) {\n      return validateFields(nameOrFieldsOrSignal, signal);\n    }\n\n    await validateFields([nameOrFieldsOrSignal], signal);\n\n    const name = nameOrFieldsOrSignal as string;\n    const error = ctx.fieldErrors.get(name);\n\n    return { errors: error !== undefined ? { [name]: error } : {}, valid: error === undefined };\n  }\n\n  /* ======== Submit ======== */\n\n  async function submitOrThrow<TResult = void>(handler: (values: TValues) => MaybePromise<TResult>): Promise<TResult> {\n    const result = await submit(handler);\n\n    if (!result.ok) throw new ForgeValidationError(result.errors as Record<string, string>);\n\n    return result.value;\n  }\n\n  async function submit<TResult = void>(\n    handler: (values: TValues) => MaybePromise<TResult>,\n  ): Promise<SubmitResult<TResult>> {\n    ctx.ensureNotDisposed('submit');\n\n    if (ctx.isSubmittingState) throw new ForgeSubmitError('submit() called while a submission is already in progress');\n\n    ctx.batch(() => {\n      ctx.submitCount++;\n      ctx.isSubmittingState = true;\n      touchAll();\n    });\n\n    try {\n      const validation = await runValidationCore([...ctx.validators.keys()], 'full');\n\n      ctx.ensureNotDisposed('submit');\n\n      if (!validation.valid) {\n        return { errors: validation.errors, ok: false, type: 'validation' };\n      }\n\n      return { ok: true, value: await handler(values()) };\n    } finally {\n      ctx.isSubmittingState = false;\n\n      if (!ctx.disposed) ctx.requestNotify();\n    }\n  }\n\n  return {\n    array,\n    clearError,\n    field,\n    get,\n    listFields,\n    patch,\n    patchKeys,\n    registerField,\n    removeField,\n    replace,\n    replaceKeys,\n    reset,\n    resetErrors,\n    resetErrorsKeys,\n    resetField,\n    resetKeys,\n    runValidationCore,\n    set,\n    setError,\n    setValidator,\n    submit,\n    submitOrThrow,\n    touch,\n    touchAll,\n    touchAllKeys,\n    untouch,\n    untouchAll,\n    untouchAllKeys,\n    validate,\n    validateFields,\n    values,\n  };\n}\n\nexport type FieldOps<TValues extends Record<string, unknown>> = ReturnType<typeof createFieldOps<TValues>>;\n"],"mappings":";;;;;;AAoCA,SAAgB,EAAwD,GAA2B;CAGjG,SAAS,EAAkC,GAAiC;EAC1E,IAAM,IAAM;EAIZ,OAFA,EAAc,CAAG,GAEV,EAAI,MAAM,IAAI,CAAG;CAC1B;CAEA,SAAS,IAAkB;EACzB,OAAQ,EAAI,iBAAiB,EAAgB,OAAO,YAAY,EAAI,KAAK,CAAC;CAC5E;CAEA,SAAS,EAAW,GAAc,GAAsB;EACtD,AAAI,EAAI,SAAS,IAAI,CAAI,MAAM,IAAO,EAAI,MAAM,OAAO,CAAI,IACtD,EAAI,MAAM,IAAI,CAAI;CACzB;CAEA,SAAS,EAAkC,GAAS,GAA+B,IAAsB,CAAC,GAAS;EACjH,EAAI,kBAAkB,KAAK;EAE3B,IAAM,IAAM;EAQZ,AANA,EAAc,CAAG,GACjB,EAAI,MAAM,IAAI,GAAK,CAAK,GACxB,EAAW,GAAK,CAAK,GAEjB,EAAQ,WAAS,EAAI,QAAQ,IAAI,CAAG,GAExC,EAAI,cAAc,CAAG;CACvB;CAEA,SAAS,EAAoC,GAA6C;EACxF,IAAM,IAAM;EAIZ,OAFA,EAAc,CAAG,GAEV,EAAI,iBAAiB,CAAG;CACjC;CAIA,SAAS,EAAS,GAA2B,GAAuB;EAClE,EAAI,kBAAkB,UAAU;EAEhC,IAAM,IAAM;EAKZ,AAHA,EAAc,CAAG,GACjB,EAAI,YAAY,IAAI,GAAK,CAAO,GAChC,EAAI,iBAAiB,GACrB,EAAI,cAAc,CAAG;CACvB;CAEA,SAAS,EAAW,GAAiC;EACnD,EAAI,kBAAkB,YAAY;EAElC,IAAM,IAAM;EAIZ,AAFA,EAAc,CAAG,GAEb,EAAI,YAAY,OAAO,CAAG,MAC5B,EAAI,iBAAiB,GACrB,EAAI,cAAc,CAAG;CAEzB;CAOA,SAAS,EACP,GACA,GACA,GACM;EACN,KAAK,IAAM,KAAO,CAAC,GAAG,EAAI,YAAY,KAAK,CAAC,GAC1C,AAAI,EAAU,CAAG,KAAG,EAAI,YAAY,OAAO,CAAG;EAGhD,KAAK,IAAM,CAAC,GAAK,MAAY,OAAO,QAAQ,CAAU,GAAG;GACvD,IAAM,IAAU,EAAU,CAAG;GAI7B,AAFA,EAAc,CAAO,GAEjB,OAAO,KAAY,YAAU,EAAI,YAAY,IAAI,GAAS,CAAO;EACvE;EAEA,EAAI,iBAAiB;CACvB;CAEA,SAAS,EAAY,IAAuE,CAAC,GAAS;EAOpG,AANA,EAAI,kBAAkB,aAAa,GACnC,QACQ,IACN,IACC,MAAM,CACT,GACA,EAAI,cAAc;CACpB;CAOA,SAAS,EAAmB,GAAa,GAAwB;EAC/D,AAAI,cAAc,KAAK,CAAG,KAAK,CAAC,EAAI,MAAM,IAAI,CAAG,KAG/C,EACE,GAAG,EAAS,IAHK,EAAe,GAAK,EAGrB,EAAW,oHAE7B;CAEJ;CAEA,SAAS,EAAa,GAA0B,GAA2C;EACzF,EAAI,kBAAkB,cAAc;EAEpC,IAAM,IAAM;EAQZ,AANA,EAAc,CAAG,GACjB,EAAmB,GAAK,cAAc,GAEtC,EAAI,WAAW,IAAI,CAAG,CAAC,EAAE,MAAM,GAC/B,EAAI,WAAW,OAAO,CAAG,GAErB,IACF,EAAI,WAAW,IAAI,GAAK,CAAS,KAEjC,EAAI,WAAW,OAAO,CAAG,GAErB,EAAI,YAAY,OAAO,CAAG,MAC5B,EAAI,iBAAiB,GACrB,EAAI,cAAc,CAAG;CAG3B;CAIA,SAAS,EACP,GACA,IAAwD,CAAC,GAC5C;EACb,EAAI,kBAAkB,iBAAiB;EAEvC,IAAM,IAAM;EAaZ,OAXA,EAAc,CAAG,GACjB,EAAmB,GAAK,iBAAiB,GAErC,EAAQ,cAAc,KAAA,KAAW,EAAa,GAAM,EAAQ,SAAoC,GAEhG,EAAQ,iBAAiB,KAAA,KAAa,CAAC,EAAI,MAAM,IAAI,CAAG,MAC1D,EAAI,MAAM,IAAI,GAAK,EAAQ,YAAY,GACvC,EAAI,SAAS,IAAI,GAAK,EAAQ,YAAY,GAC1C,EAAI,cAAc,CAAG,UAGV;GACX,AAAK,EAAI,YAAU,EAAY,CAAI;EACrC;CACF;CAEA,SAAS,IAAgC;EACvC,IAAM,oBAAQ,IAAI,IAAY;EAE9B,KAAK,IAAM,KAAQ,EAAI,MAAM,KAAK,GAAG,EAAM,IAAI,CAAI;EACnD,KAAK,IAAM,KAAQ,EAAI,WAAW,KAAK,GAAG,EAAM,IAAI,CAAI;EAExD,OAAO,OAAO,OAAO,CAAC,GAAG,CAAK,CAAC;CACjC;CAIA,SAAS,EAAM,GAAgC;EAC7C,EAAI,kBAAkB,OAAO;EAE7B,IAAM,IAAM;EAIZ,AAFA,EAAc,CAAG,GACjB,EAAI,QAAQ,IAAI,CAAG,GACnB,EAAI,cAAc,CAAG;CACvB;CAEA,SAAS,EAAQ,GAAgC;EAC/C,EAAI,kBAAkB,SAAS;EAE/B,IAAM,IAAM;EAIZ,AAFA,EAAc,CAAG,GAEb,EAAI,QAAQ,OAAO,CAAG,KAAG,EAAI,cAAc,CAAG;CACpD;CAGA,SAAS,EAAa,GAA2C;EAC/D,KAAK,IAAM,KAAQ,EAAI,MAAM,KAAK,GAAG,AAAI,EAAU,CAAI,KAAG,EAAI,QAAQ,IAAI,CAAI;EAC9E,KAAK,IAAM,KAAQ,EAAI,WAAW,KAAK,GAAG,AAAI,EAAU,CAAI,KAAG,EAAI,QAAQ,IAAI,CAAI;CACrF;CAEA,SAAS,IAAiB;EAGxB,AAFA,EAAI,kBAAkB,UAAU,GAChC,QAAmB,EAAI,GACvB,EAAI,cAAc;CACpB;CAGA,SAAS,EAAe,GAA2C;EACjE,KAAK,IAAM,KAAQ,CAAC,GAAG,EAAI,OAAO,GAAG,AAAI,EAAU,CAAI,KAAG,EAAI,QAAQ,OAAO,CAAI;CACnF;CAEA,SAAS,IAAmB;EAG1B,AAFA,EAAI,kBAAkB,YAAY,GAClC,QAAqB,EAAI,GACzB,EAAI,cAAc;CACpB;CAIA,SAAS,EAAW,GAAgC;EAClD,EAAI,kBAAkB,YAAY;EAElC,IAAM,IAAM;EAWZ,AATA,EAAc,CAAG,GACjB,EAAI,WAAW,IAAI,CAAG,CAAC,EAAE,MAAM,GAC/B,EAAI,WAAW,OAAO,CAAG,GACzB,EAAI,MAAM,IAAI,GAAK,EAAI,SAAS,IAAI,CAAG,CAAC,GACxC,EAAI,MAAM,OAAO,CAAG,GACpB,EAAI,QAAQ,OAAO,CAAG,GAElB,EAAI,YAAY,OAAO,CAAG,KAAG,EAAI,iBAAiB,GAEtD,EAAI,cAAc,CAAG;CACvB;CAEA,SAAS,EAAY,GAAgC;EACnD,EAAI,kBAAkB,eAAe;EAErC,IAAM,IAAM;EAcZ,AAZA,EAAc,CAAG,GACjB,EAAI,MAAM,OAAO,CAAG,GACpB,EAAI,SAAS,OAAO,CAAG,GACvB,EAAI,MAAM,OAAO,CAAG,GACpB,EAAI,QAAQ,OAAO,CAAG,GACtB,EAAI,WAAW,OAAO,CAAG,GACzB,EAAI,WAAW,OAAO,CAAG,GACzB,EAAI,WAAW,IAAI,CAAG,CAAC,EAAE,MAAM,GAC/B,EAAI,WAAW,OAAO,CAAG,GAErB,EAAI,YAAY,OAAO,CAAG,KAAG,EAAI,iBAAiB,GAEtD,EAAI,cAAc,CAAG;CACvB;CAUA,SAAS,IAA4B;EACnC,uBAAO,IAAI,IAAI;GAAC,GAAG,EAAI,MAAM,KAAK;GAAG,GAAG,EAAI;GAAS,GAAG,EAAI,YAAY,KAAK;GAAG,GAAG,EAAI,WAAW,KAAK;EAAC,CAAC;CAC3G;CASA,SAAS,EAAU,GAA2C;EAC5D,KAAK,IAAM,KAAO,EAAa,GACxB,EAAU,CAAG,MAElB,EAAI,WAAW,IAAI,CAAG,CAAC,EAAE,MAAM,GAC/B,EAAI,WAAW,OAAO,CAAG,GAKrB,EAAI,SAAS,IAAI,CAAG,IAAG,EAAI,MAAM,IAAI,GAAK,EAAI,SAAS,IAAI,CAAG,CAAC,IAC9D,EAAI,MAAM,OAAO,CAAG,GAEzB,EAAI,MAAM,OAAO,CAAG,GACpB,EAAI,QAAQ,OAAO,CAAG,GAElB,EAAI,YAAY,OAAO,CAAG,KAAG,EAAI,iBAAiB;CAE1D;CAEA,SAAS,IAAc;EACrB,EAAI,kBAAkB,OAAO;EAE7B,KAAK,IAAM,KAAQ,EAAI,UAAU,EAAK,MAAM;EAM5C,AAJA,EAAI,SAAS,MAAM,GACnB,EAAI,eAAe,MAAM,GACzB,QAAgB,EAAI,GACpB,EAAI,cAAc,GAClB,EAAI,cAAc;CACpB;CASA,SAAS,EACP,GACA,GACA,GACM;EACN,KAAK,IAAM,KAAO,EAAa,GACxB,EAAU,CAAG,MAElB,EAAI,WAAW,IAAI,CAAG,CAAC,EAAE,MAAM,GAC/B,EAAI,WAAW,OAAO,CAAG,GACzB,EAAI,MAAM,OAAO,CAAG,GACpB,EAAI,SAAS,OAAO,CAAG,GACvB,EAAI,MAAM,OAAO,CAAG,GACpB,EAAI,QAAQ,OAAO,CAAG,GAElB,EAAI,YAAY,OAAO,CAAG,KAAG,EAAI,iBAAiB;EAGxD,KAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,CAAI,GAAG;GAC/C,IAAM,IAAU,EAAU,CAAG;GAG7B,AADA,EAAI,MAAM,IAAI,GAAS,CAAK,GAC5B,EAAI,SAAS,IAAI,GAAS,CAAK;EACjC;CACF;CAEA,SAAS,EAAQ,GAA0B;EACzC,EAAI,kBAAkB,SAAS;EAE/B,KAAK,IAAM,KAAQ,EAAI,UAAU,EAAK,MAAM;EAU5C,AARA,EAAI,SAAS,MAAM,GACnB,EAAI,eAAe,MAAM,GACzB,QACQ,IACN,EAAc,CAAoC,IACjD,MAAM,CACT,GACA,EAAI,cAAc,GAClB,EAAI,cAAc;CACpB;CAQA,SAAS,EAAU,GAAkC,GAA8C;EACjG,IAAM,IAAO,EAAc,CAAO,GAC5B,IAAwB,CAAC;EAE/B,KAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,CAAI,GAAG;GAC/C,IAAM,IAAU,EAAU,CAAG;GAK7B,AAHA,EAAI,SAAS,IAAI,GAAS,CAAK,GAC/B,EAAI,MAAM,IAAI,GAAS,CAAK,GAC5B,EAAI,MAAM,OAAO,CAAO,GACxB,EAAY,KAAK,CAAO;EAC1B;EAEA,OAAO;CACT;CAEA,SAAS,EAAM,GAAwC;EAErD,AADA,EAAI,kBAAkB,OAAO,GAC7B,EAAI,cAAc,EAAU,IAAU,MAAM,CAAC,CAAC;CAChD;CAIA,SAAS,EAAM,GAAsC;EACnD,EAAI,kBAAkB,OAAO;EAE7B,IAAM,IAAM;EAEZ,EAAc,CAAG;EAEjB,IAAM,IAAS,EAAI,WAAW,IAAI,CAAG;EAErC,IAAI,GAAQ,OAAO;EAEnB,IAAM,IAAU,EAAiB,GAAM,EAAI,OAAO,CAA6C;EAI/F,OAFA,EAAI,WAAW,IAAI,GAAK,CAAO,GAExB;CACT;CAIA,eAAe,EAAkB,GAAc,GAAkD;EAC/F,IAAM,IAAY,EAAI,WAAW,IAAI,CAAI;EAEzC,IAAI,CAAC,GAAW;EAEhB,IAAI,EAAO,SAAS,MAAM,EAAO;EAEjC,IAAM,IAAS,MAAM,EAAU,EAAI,MAAM,IAAI,CAAI,GAAG,CAAM;EAE1D,OAAO,OAAO,KAAW,WAAW,IAAS,KAAA;CAC/C;CAEA,eAAe,EAAiB,GAAsD;EACpF,IAAI,CAAC,EAAI,eAAe,OAAO,CAAC;EAEhC,IAAI,EAAO,SAAS,MAAM,EAAO;EAEjC,IAAM,IAAS,MAAM,EAAI,cAAc,EAAO,GAAG,CAAM,GACjD,IAAiC,CAAC;EAExC,IAAI,QACG,IAAM,CAAC,GAAK,MAAY,OAAO,QAAQ,CAAM,GAGhD,AAAI,EAAU,CAAG,KAAK,OAAO,KAAY,aAAU,EAAO,KAAO;EAIrE,OAAO;CACT;CAEA,SAAS,EACP,GACA,GACA,GACA,GACM;EACN,IAAI,MAAU,QAAQ;GACpB,EAAI,YAAY,MAAM;GAEtB,KAAK,IAAM,CAAC,GAAK,MAAY,OAAO,QAAQ,CAAU,GACpD,AAAI,EAAW,OAAS,KAAA,MAAW,EAAW,KAAO;GAGvD,KAAK,IAAM,CAAC,GAAK,MAAY,OAAO,QAAQ,CAAU,GAAG,EAAI,YAAY,IAAI,GAAK,CAAO;GAGzF,AADA,EAAI,iBAAiB,GACrB,EAAI,cAAc;EACpB,OAAO;GACL,IAAM,oBAAgB,IAAI,IAAY;GAEtC,KAAK,IAAM,KAAQ,GAAU;IAC3B,IAAM,IAAO,EAAW,IAClB,IAAW,EAAI,YAAY,IAAI,CAAI;IAEzC,AAAI,MAAS,KAAA,IAIF,EAAI,YAAY,OAAO,CAAI,KACpC,EAAc,IAAI,CAAI,KAJtB,EAAI,YAAY,IAAI,GAAM,CAAI,GAE1B,MAAa,KAAM,EAAc,IAAI,CAAI;GAIjD;GAIA,AAFI,EAAc,OAAO,KAAG,EAAI,iBAAiB,GAEjD,EAAI,cAAc,CAAa;EACjC;CACF;CAEA,eAAe,EACb,GACA,GACA,GACgD;EAChD,IAAM,IAAW,IAAI,IAAI,CAAM,GACzB,oBAAgB,IAAI,IAA6B;EAEvD,KAAK,IAAM,KAAQ,GAAU;GAC3B,EAAI,WAAW,IAAI,CAAI,CAAC,EAAE,MAAM;GAEhC,IAAM,IAAO,IAAI,gBAAgB;GAGjC,AADA,EAAI,WAAW,IAAI,GAAM,CAAI,GAC7B,EAAc,IAAI,GAAM,CAAI;EAC9B;EAEA,IAAM,IAAU,IAAI,gBAAgB,GAC9B,IAAY,EAAU,EAAQ,QAAQ,GAAQ,EAAI,kBAAkB,MAAM;EAEhF,EAAI,SAAS,IAAI,CAAO;EAIxB,IAAM,IAAQ,OAAO;EAErB,KAAK,IAAM,KAAQ,GAAU;GAC3B,IAAI,IAAO,EAAI,eAAe,IAAI,CAAI;GAOtC,AALK,MACH,oBAAO,IAAI,IAAY,GACvB,EAAI,eAAe,IAAI,GAAM,CAAI,IAGnC,EAAK,IAAI,CAAK;EAChB;EAEA,EAAI,cAAc;EAElB,IAAI;GACF,IAAM,IAAU,MAAM,QAAQ,IAC5B,CAAC,GAAG,CAAQ,CAAC,CAAC,IAAI,OAAO,MAGhB,CAAC,GAAM,MAAM,EAAkB,GAFlB,MAAU,YAAY,EAAU,EAAc,IAAI,CAAI,CAAC,CAAE,QAAQ,CAAS,IAAK,CAE5C,CAAC,CACzD,CACH;GAEA,IAAI,EAAU,SACZ,OAAO;IAAE,SAAS;IAAM,QAAQ,OAAO,YAAY,EAAI,WAAW;IAAG,OAAO,EAAI,YAAY,SAAS;GAAE;GAGzG,IAAM,IAAqC,CAAC;GAE5C,KAAK,IAAM,CAAC,GAAM,MAAY,GAC5B,AAAI,MAAY,KAAA,MAAW,EAAW,KAAQ;GAOhD,OAFA,EAAiB,GAAU,GAFR,MAAU,SAAS,MAAM,EAAiB,CAAS,IAAI,CAAC,GAExB,CAAK,GAEjD;IAAE,SAAS;IAAO,QAAQ,OAAO,YAAY,EAAI,WAAW;IAAG,OAAO,EAAI,YAAY,SAAS;GAAE;EAC1G,SAAS,GAAO;GACd,IAAI,EAAa,CAAK,GACpB,OAAO;IAAE,SAAS;IAAM,QAAQ,OAAO,YAAY,EAAI,WAAW;IAAG,OAAO,EAAI,YAAY,SAAS;GAAE;GAGzG,MAAM;EACR,UAAU;GACR,EAAI,SAAS,OAAO,CAAO;GAE3B,KAAK,IAAM,KAAQ,GAAU;IAC3B,IAAM,IAAO,EAAI,eAAe,IAAI,CAAI;IAExC,AAAI,MACF,EAAK,OAAO,CAAK,GAEb,EAAK,SAAS,KAAG,EAAI,eAAe,OAAO,CAAI;GAEvD;GAEA,EAAI,cAAc;GAElB,KAAK,IAAM,CAAC,GAAM,MAAS,GACzB,AAAI,EAAI,WAAW,IAAI,CAAI,MAAM,KAAM,EAAI,WAAW,OAAO,CAAI;EAErE;CACF;CAEA,eAAe,EACb,GACA,GACyB;EACzB,EAAI,kBAAkB,UAAU;EAEhC,IAAM,IAAS,MAAM,EAAkB,GAAoB,WAAW,CAAM;EAE5E,OAAO;GAAE,QAAQ,EAAO;GAAQ,OAAO,EAAO;EAAM;CACtD;CAEA,eAAe,EACb,GACA,GACyB;EAGzB,IAFA,EAAI,kBAAkB,UAAU,GAE5B,MAAyB,KAAA,KAAa,aAAgC,aAAa;GACrF,IAAM,IAAS,MAAM,EACnB,CAAC,GAAG,EAAI,WAAW,KAAK,CAAC,GACzB,QACA,CACF;GAEA,OAAO;IAAE,QAAQ,EAAO;IAAQ,OAAO,EAAO;GAAM;EACtD;EAEA,IAAI,MAAM,QAAQ,CAAoB,GACpC,OAAO,EAAe,GAAsB,CAAM;EAGpD,MAAM,EAAe,CAAC,CAAoB,GAAG,CAAM;EAEnD,IAAM,IAAO,GACP,IAAQ,EAAI,YAAY,IAAI,CAAI;EAEtC,OAAO;GAAE,QAAQ,MAAU,KAAA,IAAgC,CAAC,IAArB,GAAG,IAAO,EAAM;GAAQ,OAAO,MAAU,KAAA;EAAU;CAC5F;CAIA,eAAe,EAA8B,GAAuE;EAClH,IAAM,IAAS,MAAM,EAAO,CAAO;EAEnC,IAAI,CAAC,EAAO,IAAI,MAAM,IAAI,EAAqB,EAAO,MAAgC;EAEtF,OAAO,EAAO;CAChB;CAEA,eAAe,EACb,GACgC;EAGhC,IAFA,EAAI,kBAAkB,QAAQ,GAE1B,EAAI,mBAAmB,MAAM,IAAI,EAAiB,2DAA2D;EAEjH,EAAI,YAAY;GAGd,AAFA,EAAI,eACJ,EAAI,oBAAoB,IACxB,EAAS;EACX,CAAC;EAED,IAAI;GACF,IAAM,IAAa,MAAM,EAAkB,CAAC,GAAG,EAAI,WAAW,KAAK,CAAC,GAAG,MAAM;GAQ7E,OANA,EAAI,kBAAkB,QAAQ,GAEzB,EAAW,QAIT;IAAE,IAAI;IAAM,OAAO,MAAM,EAAQ,EAAO,CAAC;GAAE,IAHzC;IAAE,QAAQ,EAAW;IAAQ,IAAI;IAAO,MAAM;GAAa;EAItE,UAAU;GAGR,AAFA,EAAI,oBAAoB,IAEnB,EAAI,YAAU,EAAI,cAAc;EACvC;CACF;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}

package/dist/core/lifecycle.cjs

@@ -1,2 +1,2 @@
-const e=require("../_utils.cjs");function t(t){function n(){t.disposed=!0,t.disposeController.abort();for(let e of t.fieldCtrls.values())e.abort();t.fieldCtrls.clear(),t.runCtrls.clear(),t.arrayCache.clear(),t.scopeCache.clear();for(let e of t.rippleSubs)e.dispose();t.rippleSubs.clear(),t.fieldSignals.clear()}function r(){return t.ensureNotDisposed(),Object.freeze({baseline:Object.freeze(Object.fromEntries(t.baseline)),dirty:Object.freeze([...t.dirty]),errors:Object.freeze(Object.fromEntries(t.fieldErrors)),store:Object.freeze(Object.fromEntries(t.store)),submitCount:t.submitCount,touched:Object.freeze([...t.touched])})}function i(n){t.ensureNotDisposed();for(let e of t.runCtrls)e.abort();for(let e of t.fieldCtrls.values())e.abort();t.runCtrls.clear(),t.fieldCtrls.clear(),t.validatingRuns.clear(),t.store.clear(),t.baseline.clear(),t.fieldErrors.clear(),t.touched.clear(),t.dirty.clear();for(let[r,i]of Object.entries(n.store))e.isSafeKey(r)&&t.store.set(r,i);for(let[r,i]of Object.entries(n.baseline))e.isSafeKey(r)&&t.baseline.set(r,i);for(let[r,i]of Object.entries(n.errors))e.isSafeKey(r)&&t.fieldErrors.set(r,i);for(let r of n.touched)e.isSafeKey(r)&&t.touched.add(r);for(let r of n.dirty)e.isSafeKey(r)&&t.dirty.add(r);t.submitCount=n.submitCount,t.invalidateErrors(),t.invalidateValues(),t.requestNotify()}return{dispose:n,restore:i,snapshot:r}}exports.createLifecycleOps=t;
+const e=require("../_utils.cjs");function t(t,n){function r(){t.dispose(),n.onDispose?.()}function i(){return t.ensureNotDisposed(`history.snapshot`),Object.freeze({baseline:Object.freeze(Object.fromEntries(t.baseline)),dirty:Object.freeze([...t.dirty]),errors:Object.freeze(Object.fromEntries(t.fieldErrors)),store:Object.freeze(Object.fromEntries(t.store)),submitCount:t.submitCount,touched:Object.freeze([...t.touched])})}function a(n){t.ensureNotDisposed(`history.restore`);for(let e of t.runCtrls)e.abort();for(let e of t.fieldCtrls.values())e.abort();t.runCtrls.clear(),t.fieldCtrls.clear(),t.validatingRuns.clear(),t.store.clear(),t.baseline.clear(),t.fieldErrors.clear(),t.touched.clear(),t.dirty.clear();for(let[r,i]of Object.entries(n.store))e.isSafeKey(r)&&t.store.set(r,i);for(let[r,i]of Object.entries(n.baseline))e.isSafeKey(r)&&t.baseline.set(r,i);for(let[r,i]of Object.entries(n.errors))e.isSafeKey(r)&&t.fieldErrors.set(r,i);for(let r of n.touched)e.isSafeKey(r)&&t.touched.add(r);for(let r of n.dirty)e.isSafeKey(r)&&t.dirty.add(r);t.submitCount=n.submitCount,t.invalidateErrors(),t.invalidateValues(),t.requestNotify()}return{dispose:r,restore:a,snapshot:i}}exports.createLifecycleOps=t;
 //# sourceMappingURL=lifecycle.cjs.map

package/dist/core/lifecycle.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.cjs","names":[],"sources":["../../src/core/lifecycle.ts"],"sourcesContent":["import type { FormSnapshot } from '../types';\nimport type { FormContext } from './context';\n\nimport { isSafeKey } from '../_utils';\n\n/**\n * Lifecycle operations: `dispose`, `snapshot`, `restore`. Moved verbatim from `createForm()`'s\n * \"Lifecycle: dispose\" and \"Snapshot / Restore\" sections.\n */\nexport function createLifecycleOps<TValues extends Record<string, unknown>>(ctx: FormContext<TValues>) {\n  function dispose(): void {\n    ctx.disposed = true;\n    ctx.disposeController.abort();\n\n    for (const ctrl of ctx.fieldCtrls.values()) ctrl.abort();\n\n    ctx.fieldCtrls.clear();\n    ctx.runCtrls.clear();\n    ctx.arrayCache.clear();\n    ctx.scopeCache.clear();\n\n    for (const sub of ctx.rippleSubs) sub.dispose();\n\n    ctx.rippleSubs.clear();\n    ctx.fieldSignals.clear();\n  }\n\n  function snapshot(): FormSnapshot<TValues> {\n    ctx.ensureNotDisposed();\n\n    // Cast is irreducible: baseline/store are typed Partial<Record<FlatKeyOf<TValues>, unknown>>, a\n    // TValues-dependent mapped type TS cannot verify a plain Object.fromEntries() result against for\n    // a generic TValues param -- no runtime behavior is affected, only static verification.\n    return Object.freeze({\n      baseline: Object.freeze(Object.fromEntries(ctx.baseline)),\n      dirty: Object.freeze([...ctx.dirty]),\n      errors: Object.freeze(Object.fromEntries(ctx.fieldErrors)),\n      store: Object.freeze(Object.fromEntries(ctx.store)),\n      submitCount: ctx.submitCount,\n      touched: Object.freeze([...ctx.touched]),\n    }) as FormSnapshot<TValues>;\n  }\n\n  function restore(snap: FormSnapshot<TValues>): void {\n    ctx.ensureNotDisposed();\n\n    for (const ctrl of ctx.runCtrls) ctrl.abort();\n    for (const ctrl of ctx.fieldCtrls.values()) ctrl.abort();\n\n    ctx.runCtrls.clear();\n    ctx.fieldCtrls.clear();\n    ctx.validatingRuns.clear();\n    ctx.store.clear();\n    ctx.baseline.clear();\n    ctx.fieldErrors.clear();\n    ctx.touched.clear();\n    ctx.dirty.clear();\n\n    // Security: snap may be an externally-sourced blob (e.g. JSON.parse'd persisted state).\n    // Unlike patch()/replace(), restore() writes flat keys directly into the internal Maps —\n    // it must apply the same silent-drop defense-in-depth as flattenValues() does for those.\n    for (const [k, v] of Object.entries(snap.store)) if (isSafeKey(k)) ctx.store.set(k, v);\n    for (const [k, v] of Object.entries(snap.baseline)) if (isSafeKey(k)) ctx.baseline.set(k, v);\n    for (const [k, v] of Object.entries(snap.errors)) if (isSafeKey(k)) ctx.fieldErrors.set(k, v);\n    for (const t of snap.touched) if (isSafeKey(t)) ctx.touched.add(t);\n    for (const d of snap.dirty) if (isSafeKey(d)) ctx.dirty.add(d);\n\n    ctx.submitCount = snap.submitCount;\n\n    ctx.invalidateErrors();\n    ctx.invalidateValues();\n    ctx.requestNotify();\n  }\n\n  return { dispose, restore, snapshot };\n}\n\nexport type LifecycleOps<TValues extends Record<string, unknown>> = ReturnType<typeof createLifecycleOps<TValues>>;\n"],"mappings":"iCASA,SAAgB,EAA4D,EAA2B,CACrG,SAAS,GAAgB,CACvB,EAAI,SAAW,GACf,EAAI,kBAAkB,MAAM,EAE5B,IAAK,IAAM,KAAQ,EAAI,WAAW,OAAO,EAAG,EAAK,MAAM,EAEvD,EAAI,WAAW,MAAM,EACrB,EAAI,SAAS,MAAM,EACnB,EAAI,WAAW,MAAM,EACrB,EAAI,WAAW,MAAM,EAErB,IAAK,IAAM,KAAO,EAAI,WAAY,EAAI,QAAQ,EAE9C,EAAI,WAAW,MAAM,EACrB,EAAI,aAAa,MAAM,CACzB,CAEA,SAAS,GAAkC,CAMzC,OALA,EAAI,kBAAkB,EAKf,OAAO,OAAO,CACnB,SAAU,OAAO,OAAO,OAAO,YAAY,EAAI,QAAQ,CAAC,EACxD,MAAO,OAAO,OAAO,CAAC,GAAG,EAAI,KAAK,CAAC,EACnC,OAAQ,OAAO,OAAO,OAAO,YAAY,EAAI,WAAW,CAAC,EACzD,MAAO,OAAO,OAAO,OAAO,YAAY,EAAI,KAAK,CAAC,EAClD,YAAa,EAAI,YACjB,QAAS,OAAO,OAAO,CAAC,GAAG,EAAI,OAAO,CAAC,CACzC,CAAC,CACH,CAEA,SAAS,EAAQ,EAAmC,CAClD,EAAI,kBAAkB,EAEtB,IAAK,IAAM,KAAQ,EAAI,SAAU,EAAK,MAAM,EAC5C,IAAK,IAAM,KAAQ,EAAI,WAAW,OAAO,EAAG,EAAK,MAAM,EAEvD,EAAI,SAAS,MAAM,EACnB,EAAI,WAAW,MAAM,EACrB,EAAI,eAAe,MAAM,EACzB,EAAI,MAAM,MAAM,EAChB,EAAI,SAAS,MAAM,EACnB,EAAI,YAAY,MAAM,EACtB,EAAI,QAAQ,MAAM,EAClB,EAAI,MAAM,MAAM,EAKhB,IAAK,GAAM,CAAC,EAAG,KAAM,OAAO,QAAQ,EAAK,KAAK,EAAO,EAAA,UAAU,CAAC,GAAG,EAAI,MAAM,IAAI,EAAG,CAAC,EACrF,IAAK,GAAM,CAAC,EAAG,KAAM,OAAO,QAAQ,EAAK,QAAQ,EAAO,EAAA,UAAU,CAAC,GAAG,EAAI,SAAS,IAAI,EAAG,CAAC,EAC3F,IAAK,GAAM,CAAC,EAAG,KAAM,OAAO,QAAQ,EAAK,MAAM,EAAO,EAAA,UAAU,CAAC,GAAG,EAAI,YAAY,IAAI,EAAG,CAAC,EAC5F,IAAK,IAAM,KAAK,EAAK,QAAa,EAAA,UAAU,CAAC,GAAG,EAAI,QAAQ,IAAI,CAAC,EACjE,IAAK,IAAM,KAAK,EAAK,MAAW,EAAA,UAAU,CAAC,GAAG,EAAI,MAAM,IAAI,CAAC,EAE7D,EAAI,YAAc,EAAK,YAEvB,EAAI,iBAAiB,EACrB,EAAI,iBAAiB,EACrB,EAAI,cAAc,CACpB,CAEA,MAAO,CAAE,UAAS,UAAS,UAAS,CACtC"}
+{"version":3,"file":"lifecycle.cjs","names":[],"sources":["../../src/core/lifecycle.ts"],"sourcesContent":["import type { FormSnapshot } from '../types';\nimport type { FormContext } from './context';\n\nimport { isSafeKey } from '../_utils';\n\n/**\n * Lifecycle operations: `dispose`, `snapshot`, `restore`. Moved verbatim from `createForm()`'s\n * \"Lifecycle: dispose\" and \"Snapshot / Restore\" sections.\n */\nexport function createLifecycleOps<TValues extends Record<string, unknown>>(\n  ctx: FormContext<TValues>,\n  deps: { onDispose?: () => void },\n) {\n  function dispose(): void {\n    ctx.dispose();\n    deps.onDispose?.();\n  }\n\n  function snapshot(): FormSnapshot<TValues> {\n    ctx.ensureNotDisposed('history.snapshot');\n\n    // Cast is irreducible: baseline/store are typed Partial<Record<FlatKeyOf<TValues>, unknown>>, a\n    // TValues-dependent mapped type TS cannot verify a plain Object.fromEntries() result against for\n    // a generic TValues param -- no runtime behavior is affected, only static verification.\n    return Object.freeze({\n      baseline: Object.freeze(Object.fromEntries(ctx.baseline)),\n      dirty: Object.freeze([...ctx.dirty]),\n      errors: Object.freeze(Object.fromEntries(ctx.fieldErrors)),\n      store: Object.freeze(Object.fromEntries(ctx.store)),\n      submitCount: ctx.submitCount,\n      touched: Object.freeze([...ctx.touched]),\n    }) as FormSnapshot<TValues>;\n  }\n\n  function restore(snap: FormSnapshot<TValues>): void {\n    ctx.ensureNotDisposed('history.restore');\n\n    for (const ctrl of ctx.runCtrls) ctrl.abort();\n    for (const ctrl of ctx.fieldCtrls.values()) ctrl.abort();\n\n    ctx.runCtrls.clear();\n    ctx.fieldCtrls.clear();\n    ctx.validatingRuns.clear();\n    ctx.store.clear();\n    ctx.baseline.clear();\n    ctx.fieldErrors.clear();\n    ctx.touched.clear();\n    ctx.dirty.clear();\n\n    // Security: snap may be an externally-sourced blob (e.g. JSON.parse'd persisted state).\n    // Unlike patch()/replace(), restore() writes flat keys directly into the internal Maps —\n    // it must apply the same silent-drop defense-in-depth as flattenValues() does for those.\n    for (const [k, v] of Object.entries(snap.store)) if (isSafeKey(k)) ctx.store.set(k, v);\n    for (const [k, v] of Object.entries(snap.baseline)) if (isSafeKey(k)) ctx.baseline.set(k, v);\n    for (const [k, v] of Object.entries(snap.errors)) if (isSafeKey(k)) ctx.fieldErrors.set(k, v);\n    for (const t of snap.touched) if (isSafeKey(t)) ctx.touched.add(t);\n    for (const d of snap.dirty) if (isSafeKey(d)) ctx.dirty.add(d);\n\n    ctx.submitCount = snap.submitCount;\n\n    ctx.invalidateErrors();\n    ctx.invalidateValues();\n    ctx.requestNotify();\n  }\n\n  return { dispose, restore, snapshot };\n}\n\nexport type LifecycleOps<TValues extends Record<string, unknown>> = ReturnType<typeof createLifecycleOps<TValues>>;\n"],"mappings":"iCASA,SAAgB,EACd,EACA,EACA,CACA,SAAS,GAAgB,CACvB,EAAI,QAAQ,EACZ,EAAK,YAAY,CACnB,CAEA,SAAS,GAAkC,CAMzC,OALA,EAAI,kBAAkB,kBAAkB,EAKjC,OAAO,OAAO,CACnB,SAAU,OAAO,OAAO,OAAO,YAAY,EAAI,QAAQ,CAAC,EACxD,MAAO,OAAO,OAAO,CAAC,GAAG,EAAI,KAAK,CAAC,EACnC,OAAQ,OAAO,OAAO,OAAO,YAAY,EAAI,WAAW,CAAC,EACzD,MAAO,OAAO,OAAO,OAAO,YAAY,EAAI,KAAK,CAAC,EAClD,YAAa,EAAI,YACjB,QAAS,OAAO,OAAO,CAAC,GAAG,EAAI,OAAO,CAAC,CACzC,CAAC,CACH,CAEA,SAAS,EAAQ,EAAmC,CAClD,EAAI,kBAAkB,iBAAiB,EAEvC,IAAK,IAAM,KAAQ,EAAI,SAAU,EAAK,MAAM,EAC5C,IAAK,IAAM,KAAQ,EAAI,WAAW,OAAO,EAAG,EAAK,MAAM,EAEvD,EAAI,SAAS,MAAM,EACnB,EAAI,WAAW,MAAM,EACrB,EAAI,eAAe,MAAM,EACzB,EAAI,MAAM,MAAM,EAChB,EAAI,SAAS,MAAM,EACnB,EAAI,YAAY,MAAM,EACtB,EAAI,QAAQ,MAAM,EAClB,EAAI,MAAM,MAAM,EAKhB,IAAK,GAAM,CAAC,EAAG,KAAM,OAAO,QAAQ,EAAK,KAAK,EAAO,EAAA,UAAU,CAAC,GAAG,EAAI,MAAM,IAAI,EAAG,CAAC,EACrF,IAAK,GAAM,CAAC,EAAG,KAAM,OAAO,QAAQ,EAAK,QAAQ,EAAO,EAAA,UAAU,CAAC,GAAG,EAAI,SAAS,IAAI,EAAG,CAAC,EAC3F,IAAK,GAAM,CAAC,EAAG,KAAM,OAAO,QAAQ,EAAK,MAAM,EAAO,EAAA,UAAU,CAAC,GAAG,EAAI,YAAY,IAAI,EAAG,CAAC,EAC5F,IAAK,IAAM,KAAK,EAAK,QAAa,EAAA,UAAU,CAAC,GAAG,EAAI,QAAQ,IAAI,CAAC,EACjE,IAAK,IAAM,KAAK,EAAK,MAAW,EAAA,UAAU,CAAC,GAAG,EAAI,MAAM,IAAI,CAAC,EAE7D,EAAI,YAAc,EAAK,YAEvB,EAAI,iBAAiB,EACrB,EAAI,iBAAiB,EACrB,EAAI,cAAc,CACpB,CAEA,MAAO,CAAE,UAAS,UAAS,UAAS,CACtC"}

package/dist/core/lifecycle.d.ts

@@ -4,7 +4,9 @@ import type { FormContext } from './context';
  * Lifecycle operations: `dispose`, `snapshot`, `restore`. Moved verbatim from `createForm()`'s
  * "Lifecycle: dispose" and "Snapshot / Restore" sections.
  */
-export declare function createLifecycleOps<TValues extends Record<string, unknown>>(ctx: FormContext<TValues>): {
+export declare function createLifecycleOps<TValues extends Record<string, unknown>>(ctx: FormContext<TValues>, deps: {
+    onDispose?: () => void;
+}): {
     dispose: () => void;
     restore: (snap: FormSnapshot<TValues>) => void;
     snapshot: () => FormSnapshot<TValues>;

package/dist/core/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/core/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAI7C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC;mBAC/E,IAAI;oBAiCD,YAAY,CAAC,OAAO,CAAC,KAAG,IAAI;oBAhB9B,YAAY,CAAC,OAAO,CAAC;EAgD3C;AAED,MAAM,MAAM,YAAY,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/core/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAI7C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,EACzB,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE;mBAEZ,IAAI;oBAqBD,YAAY,CAAC,OAAO,CAAC,KAAG,IAAI;oBAhB9B,YAAY,CAAC,OAAO,CAAC;EAgD3C;AAED,MAAM,MAAM,YAAY,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC"}

package/dist/core/lifecycle.js

@@ -1,15 +1,11 @@
 import { isSafeKey as e } from "../_utils.js";
 //#region src/core/lifecycle.ts
-function t(t) {
-	function n() {
-		t.disposed = !0, t.disposeController.abort();
-		for (let e of t.fieldCtrls.values()) e.abort();
-		t.fieldCtrls.clear(), t.runCtrls.clear(), t.arrayCache.clear(), t.scopeCache.clear();
-		for (let e of t.rippleSubs) e.dispose();
-		t.rippleSubs.clear(), t.fieldSignals.clear();
-	}
+function t(t, n) {
 	function r() {
-		return t.ensureNotDisposed(), Object.freeze({
+		t.dispose(), n.onDispose?.();
+	}
+	function i() {
+		return t.ensureNotDisposed("history.snapshot"), Object.freeze({
 			baseline: Object.freeze(Object.fromEntries(t.baseline)),
 			dirty: Object.freeze([...t.dirty]),
 			errors: Object.freeze(Object.fromEntries(t.fieldErrors)),
@@ -18,8 +14,8 @@ function t(t) {
 			touched: Object.freeze([...t.touched])
 		});
 	}
-	function i(n) {
-		t.ensureNotDisposed();
+	function a(n) {
+		t.ensureNotDisposed("history.restore");
 		for (let e of t.runCtrls) e.abort();
 		for (let e of t.fieldCtrls.values()) e.abort();
 		t.runCtrls.clear(), t.fieldCtrls.clear(), t.validatingRuns.clear(), t.store.clear(), t.baseline.clear(), t.fieldErrors.clear(), t.touched.clear(), t.dirty.clear();
@@ -31,9 +27,9 @@ function t(t) {
 		t.submitCount = n.submitCount, t.invalidateErrors(), t.invalidateValues(), t.requestNotify();
 	}
 	return {
-		dispose: n,
-		restore: i,
-		snapshot: r
+		dispose: r,
+		restore: a,
+		snapshot: i
 	};
 }
 //#endregion

package/dist/core/lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.js","names":[],"sources":["../../src/core/lifecycle.ts"],"sourcesContent":["import type { FormSnapshot } from '../types';\nimport type { FormContext } from './context';\n\nimport { isSafeKey } from '../_utils';\n\n/**\n * Lifecycle operations: `dispose`, `snapshot`, `restore`. Moved verbatim from `createForm()`'s\n * \"Lifecycle: dispose\" and \"Snapshot / Restore\" sections.\n */\nexport function createLifecycleOps<TValues extends Record<string, unknown>>(ctx: FormContext<TValues>) {\n  function dispose(): void {\n    ctx.disposed = true;\n    ctx.disposeController.abort();\n\n    for (const ctrl of ctx.fieldCtrls.values()) ctrl.abort();\n\n    ctx.fieldCtrls.clear();\n    ctx.runCtrls.clear();\n    ctx.arrayCache.clear();\n    ctx.scopeCache.clear();\n\n    for (const sub of ctx.rippleSubs) sub.dispose();\n\n    ctx.rippleSubs.clear();\n    ctx.fieldSignals.clear();\n  }\n\n  function snapshot(): FormSnapshot<TValues> {\n    ctx.ensureNotDisposed();\n\n    // Cast is irreducible: baseline/store are typed Partial<Record<FlatKeyOf<TValues>, unknown>>, a\n    // TValues-dependent mapped type TS cannot verify a plain Object.fromEntries() result against for\n    // a generic TValues param -- no runtime behavior is affected, only static verification.\n    return Object.freeze({\n      baseline: Object.freeze(Object.fromEntries(ctx.baseline)),\n      dirty: Object.freeze([...ctx.dirty]),\n      errors: Object.freeze(Object.fromEntries(ctx.fieldErrors)),\n      store: Object.freeze(Object.fromEntries(ctx.store)),\n      submitCount: ctx.submitCount,\n      touched: Object.freeze([...ctx.touched]),\n    }) as FormSnapshot<TValues>;\n  }\n\n  function restore(snap: FormSnapshot<TValues>): void {\n    ctx.ensureNotDisposed();\n\n    for (const ctrl of ctx.runCtrls) ctrl.abort();\n    for (const ctrl of ctx.fieldCtrls.values()) ctrl.abort();\n\n    ctx.runCtrls.clear();\n    ctx.fieldCtrls.clear();\n    ctx.validatingRuns.clear();\n    ctx.store.clear();\n    ctx.baseline.clear();\n    ctx.fieldErrors.clear();\n    ctx.touched.clear();\n    ctx.dirty.clear();\n\n    // Security: snap may be an externally-sourced blob (e.g. JSON.parse'd persisted state).\n    // Unlike patch()/replace(), restore() writes flat keys directly into the internal Maps —\n    // it must apply the same silent-drop defense-in-depth as flattenValues() does for those.\n    for (const [k, v] of Object.entries(snap.store)) if (isSafeKey(k)) ctx.store.set(k, v);\n    for (const [k, v] of Object.entries(snap.baseline)) if (isSafeKey(k)) ctx.baseline.set(k, v);\n    for (const [k, v] of Object.entries(snap.errors)) if (isSafeKey(k)) ctx.fieldErrors.set(k, v);\n    for (const t of snap.touched) if (isSafeKey(t)) ctx.touched.add(t);\n    for (const d of snap.dirty) if (isSafeKey(d)) ctx.dirty.add(d);\n\n    ctx.submitCount = snap.submitCount;\n\n    ctx.invalidateErrors();\n    ctx.invalidateValues();\n    ctx.requestNotify();\n  }\n\n  return { dispose, restore, snapshot };\n}\n\nexport type LifecycleOps<TValues extends Record<string, unknown>> = ReturnType<typeof createLifecycleOps<TValues>>;\n"],"mappings":";;AASA,SAAgB,EAA4D,GAA2B;CACrG,SAAS,IAAgB;EAEvB,AADA,EAAI,WAAW,IACf,EAAI,kBAAkB,MAAM;EAE5B,KAAK,IAAM,KAAQ,EAAI,WAAW,OAAO,GAAG,EAAK,MAAM;EAKvD,AAHA,EAAI,WAAW,MAAM,GACrB,EAAI,SAAS,MAAM,GACnB,EAAI,WAAW,MAAM,GACrB,EAAI,WAAW,MAAM;EAErB,KAAK,IAAM,KAAO,EAAI,YAAY,EAAI,QAAQ;EAG9C,AADA,EAAI,WAAW,MAAM,GACrB,EAAI,aAAa,MAAM;CACzB;CAEA,SAAS,IAAkC;EAMzC,OALA,EAAI,kBAAkB,GAKf,OAAO,OAAO;GACnB,UAAU,OAAO,OAAO,OAAO,YAAY,EAAI,QAAQ,CAAC;GACxD,OAAO,OAAO,OAAO,CAAC,GAAG,EAAI,KAAK,CAAC;GACnC,QAAQ,OAAO,OAAO,OAAO,YAAY,EAAI,WAAW,CAAC;GACzD,OAAO,OAAO,OAAO,OAAO,YAAY,EAAI,KAAK,CAAC;GAClD,aAAa,EAAI;GACjB,SAAS,OAAO,OAAO,CAAC,GAAG,EAAI,OAAO,CAAC;EACzC,CAAC;CACH;CAEA,SAAS,EAAQ,GAAmC;EAClD,EAAI,kBAAkB;EAEtB,KAAK,IAAM,KAAQ,EAAI,UAAU,EAAK,MAAM;EAC5C,KAAK,IAAM,KAAQ,EAAI,WAAW,OAAO,GAAG,EAAK,MAAM;EASvD,AAPA,EAAI,SAAS,MAAM,GACnB,EAAI,WAAW,MAAM,GACrB,EAAI,eAAe,MAAM,GACzB,EAAI,MAAM,MAAM,GAChB,EAAI,SAAS,MAAM,GACnB,EAAI,YAAY,MAAM,GACtB,EAAI,QAAQ,MAAM,GAClB,EAAI,MAAM,MAAM;EAKhB,KAAK,IAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,EAAK,KAAK,GAAG,AAAI,EAAU,CAAC,KAAG,EAAI,MAAM,IAAI,GAAG,CAAC;EACrF,KAAK,IAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,EAAK,QAAQ,GAAG,AAAI,EAAU,CAAC,KAAG,EAAI,SAAS,IAAI,GAAG,CAAC;EAC3F,KAAK,IAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,EAAK,MAAM,GAAG,AAAI,EAAU,CAAC,KAAG,EAAI,YAAY,IAAI,GAAG,CAAC;EAC5F,KAAK,IAAM,KAAK,EAAK,SAAS,AAAI,EAAU,CAAC,KAAG,EAAI,QAAQ,IAAI,CAAC;EACjE,KAAK,IAAM,KAAK,EAAK,OAAO,AAAI,EAAU,CAAC,KAAG,EAAI,MAAM,IAAI,CAAC;EAM7D,AAJA,EAAI,cAAc,EAAK,aAEvB,EAAI,iBAAiB,GACrB,EAAI,iBAAiB,GACrB,EAAI,cAAc;CACpB;CAEA,OAAO;EAAE;EAAS;EAAS;CAAS;AACtC"}
+{"version":3,"file":"lifecycle.js","names":[],"sources":["../../src/core/lifecycle.ts"],"sourcesContent":["import type { FormSnapshot } from '../types';\nimport type { FormContext } from './context';\n\nimport { isSafeKey } from '../_utils';\n\n/**\n * Lifecycle operations: `dispose`, `snapshot`, `restore`. Moved verbatim from `createForm()`'s\n * \"Lifecycle: dispose\" and \"Snapshot / Restore\" sections.\n */\nexport function createLifecycleOps<TValues extends Record<string, unknown>>(\n  ctx: FormContext<TValues>,\n  deps: { onDispose?: () => void },\n) {\n  function dispose(): void {\n    ctx.dispose();\n    deps.onDispose?.();\n  }\n\n  function snapshot(): FormSnapshot<TValues> {\n    ctx.ensureNotDisposed('history.snapshot');\n\n    // Cast is irreducible: baseline/store are typed Partial<Record<FlatKeyOf<TValues>, unknown>>, a\n    // TValues-dependent mapped type TS cannot verify a plain Object.fromEntries() result against for\n    // a generic TValues param -- no runtime behavior is affected, only static verification.\n    return Object.freeze({\n      baseline: Object.freeze(Object.fromEntries(ctx.baseline)),\n      dirty: Object.freeze([...ctx.dirty]),\n      errors: Object.freeze(Object.fromEntries(ctx.fieldErrors)),\n      store: Object.freeze(Object.fromEntries(ctx.store)),\n      submitCount: ctx.submitCount,\n      touched: Object.freeze([...ctx.touched]),\n    }) as FormSnapshot<TValues>;\n  }\n\n  function restore(snap: FormSnapshot<TValues>): void {\n    ctx.ensureNotDisposed('history.restore');\n\n    for (const ctrl of ctx.runCtrls) ctrl.abort();\n    for (const ctrl of ctx.fieldCtrls.values()) ctrl.abort();\n\n    ctx.runCtrls.clear();\n    ctx.fieldCtrls.clear();\n    ctx.validatingRuns.clear();\n    ctx.store.clear();\n    ctx.baseline.clear();\n    ctx.fieldErrors.clear();\n    ctx.touched.clear();\n    ctx.dirty.clear();\n\n    // Security: snap may be an externally-sourced blob (e.g. JSON.parse'd persisted state).\n    // Unlike patch()/replace(), restore() writes flat keys directly into the internal Maps —\n    // it must apply the same silent-drop defense-in-depth as flattenValues() does for those.\n    for (const [k, v] of Object.entries(snap.store)) if (isSafeKey(k)) ctx.store.set(k, v);\n    for (const [k, v] of Object.entries(snap.baseline)) if (isSafeKey(k)) ctx.baseline.set(k, v);\n    for (const [k, v] of Object.entries(snap.errors)) if (isSafeKey(k)) ctx.fieldErrors.set(k, v);\n    for (const t of snap.touched) if (isSafeKey(t)) ctx.touched.add(t);\n    for (const d of snap.dirty) if (isSafeKey(d)) ctx.dirty.add(d);\n\n    ctx.submitCount = snap.submitCount;\n\n    ctx.invalidateErrors();\n    ctx.invalidateValues();\n    ctx.requestNotify();\n  }\n\n  return { dispose, restore, snapshot };\n}\n\nexport type LifecycleOps<TValues extends Record<string, unknown>> = ReturnType<typeof createLifecycleOps<TValues>>;\n"],"mappings":";;AASA,SAAgB,EACd,GACA,GACA;CACA,SAAS,IAAgB;EAEvB,AADA,EAAI,QAAQ,GACZ,EAAK,YAAY;CACnB;CAEA,SAAS,IAAkC;EAMzC,OALA,EAAI,kBAAkB,kBAAkB,GAKjC,OAAO,OAAO;GACnB,UAAU,OAAO,OAAO,OAAO,YAAY,EAAI,QAAQ,CAAC;GACxD,OAAO,OAAO,OAAO,CAAC,GAAG,EAAI,KAAK,CAAC;GACnC,QAAQ,OAAO,OAAO,OAAO,YAAY,EAAI,WAAW,CAAC;GACzD,OAAO,OAAO,OAAO,OAAO,YAAY,EAAI,KAAK,CAAC;GAClD,aAAa,EAAI;GACjB,SAAS,OAAO,OAAO,CAAC,GAAG,EAAI,OAAO,CAAC;EACzC,CAAC;CACH;CAEA,SAAS,EAAQ,GAAmC;EAClD,EAAI,kBAAkB,iBAAiB;EAEvC,KAAK,IAAM,KAAQ,EAAI,UAAU,EAAK,MAAM;EAC5C,KAAK,IAAM,KAAQ,EAAI,WAAW,OAAO,GAAG,EAAK,MAAM;EASvD,AAPA,EAAI,SAAS,MAAM,GACnB,EAAI,WAAW,MAAM,GACrB,EAAI,eAAe,MAAM,GACzB,EAAI,MAAM,MAAM,GAChB,EAAI,SAAS,MAAM,GACnB,EAAI,YAAY,MAAM,GACtB,EAAI,QAAQ,MAAM,GAClB,EAAI,MAAM,MAAM;EAKhB,KAAK,IAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,EAAK,KAAK,GAAG,AAAI,EAAU,CAAC,KAAG,EAAI,MAAM,IAAI,GAAG,CAAC;EACrF,KAAK,IAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,EAAK,QAAQ,GAAG,AAAI,EAAU,CAAC,KAAG,EAAI,SAAS,IAAI,GAAG,CAAC;EAC3F,KAAK,IAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,EAAK,MAAM,GAAG,AAAI,EAAU,CAAC,KAAG,EAAI,YAAY,IAAI,GAAG,CAAC;EAC5F,KAAK,IAAM,KAAK,EAAK,SAAS,AAAI,EAAU,CAAC,KAAG,EAAI,QAAQ,IAAI,CAAC;EACjE,KAAK,IAAM,KAAK,EAAK,OAAO,AAAI,EAAU,CAAC,KAAG,EAAI,MAAM,IAAI,CAAC;EAM7D,AAJA,EAAI,cAAc,EAAK,aAEvB,EAAI,iBAAiB,GACrB,EAAI,iBAAiB,GACrB,EAAI,cAAc;CACpB;CAEA,OAAO;EAAE;EAAS;EAAS;CAAS;AACtC"}

package/dist/core/notifier.cjs

@@ -0,0 +1,2 @@
+const e=require("../_utils.cjs");let t=require("@vielzeug/ripple");function n(n){let r=(0,t.signal)(n.computeState()),i=new Map,a=new Map,o=new Set,s=!1;function c(e){let r=i.get(e);return r||(r=(0,t.signal)(n.buildFieldState(e),{equals:(e,t)=>e.value===t.value&&e.error===t.error&&e.hasError===t.hasError&&e.touched===t.touched&&e.dirty===t.dirty}),i.set(e,r)),r}function l(e){let t=a.get(e);if(t)return t;let r=Object.freeze(n.buildFieldState(e));return a.set(e,r),r}function u(){return r.value}function d(e){if(!s)if(n.invalidateCaches(),e===void 0)a.clear(),(0,t.batch)(()=>{r.value=n.computeState();for(let[e,t]of i)t.value=n.buildFieldState(e)});else if(typeof e==`string`)a.delete(e),(0,t.batch)(()=>{r.value=n.computeState();let t=i.get(e);t&&(t.value=n.buildFieldState(e))});else{let o=[...e];for(let e of o)a.delete(e);(0,t.batch)(()=>{r.value=n.computeState();for(let e of o){let t=i.get(e);t&&(t.value=n.buildFieldState(e))}})}}function f(e,n){if(s)return()=>{};let i=(0,t.watch)(r,t=>{e(t)});return o.add(i),n?.sync&&e(r.value),()=>{i.dispose(),o.delete(i)}}function p(n,r,i){if(s)return()=>{};e.assertSafeKey(n);let a=c(n),l=(0,t.watch)(a,e=>{r(e)});return o.add(l),i?.sync&&r(a.value),()=>{l.dispose(),o.delete(l)}}function m(){s=!0;for(let e of o)e.dispose();o.clear(),i.clear(),a.clear()}return{dispose:m,getFieldSnapshot:l,getOrCreateFieldSignal:c,getStateSnapshot:u,requestNotify:d,subscribe:f,subscribeField:p}}exports.createNotifier=n;
+//# sourceMappingURL=notifier.cjs.map

package/dist/core/notifier.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.cjs","names":[],"sources":["../../src/core/notifier.ts"],"sourcesContent":["import { batch as rippleBatch, signal, watch, type Signal } from '@vielzeug/ripple';\n\nimport type { FieldState, FormState, SubscribeOptions, Unsubscribe } from '../types';\n\nimport { assertSafeKey } from '../_utils';\n\n/**\n * Everything needed to (re)compute fresh state on demand. Supplied by whoever owns the\n * actual field/validator Maps (`core/context.ts`, backing `core/fields.ts`) so this module\n * never touches those Maps directly — it only knows \"how to get current state\" and \"who's\n * listening,\" never \"where the state lives.\"\n */\nexport type NotifierDeps = {\n  buildFieldState(name: string): FieldState<unknown>;\n  computeState(): FormState;\n  /** Called once at the top of every requestNotify(), before state is recomputed — lets the\n   * caller drop its own memoized derived values (e.g. `values()`'s cached unflattened object). */\n  invalidateCaches(): void;\n};\n\n/**\n * Owns every signal, subscription, and derived-state cache a form needs to notify observers.\n * Extracted from the old shared `FormContext` god-object (see `core/context.ts`'s header\n * comment) — this is the one piece of that object with no real dependency on field values or\n * validators, only on \"what does current state look like\" (via `NotifierDeps`), so it's safe\n * to own its signals/caches privately instead of exposing them on a shared mutable bag.\n */\nexport function createNotifier(deps: NotifierDeps) {\n  const formStateSignal: Signal<FormState> = signal(deps.computeState());\n  const fieldSignals = new Map<string, Signal<FieldState<unknown>>>();\n  const fieldStateCache = new Map<string, FieldState<unknown>>();\n  const rippleSubs = new Set<{ dispose(): void }>();\n  let disposed = false;\n\n  function getOrCreateFieldSignal(key: string): Signal<FieldState<unknown>> {\n    let sig = fieldSignals.get(key);\n\n    if (!sig) {\n      sig = signal<FieldState<unknown>>(deps.buildFieldState(key), {\n        equals: (a, b) =>\n          a.value === b.value &&\n          a.error === b.error &&\n          a.hasError === b.hasError &&\n          a.touched === b.touched &&\n          a.dirty === b.dirty,\n      });\n      fieldSignals.set(key, sig);\n    }\n\n    return sig;\n  }\n\n  function getFieldSnapshot(name: string): FieldState<unknown> {\n    const cached = fieldStateCache.get(name);\n\n    if (cached) return cached;\n\n    const snap = Object.freeze(deps.buildFieldState(name));\n\n    fieldStateCache.set(name, snap);\n\n    return snap;\n  }\n\n  function getStateSnapshot(): FormState {\n    return formStateSignal.value;\n  }\n\n  /**\n   * Unified notification — a single write path for every mutation in the package.\n   * - `undefined` → full-form refresh (all field signals + form signal)\n   * - `string`    → single field + form signal\n   * - `Iterable`  → targeted set of fields + form signal\n   * `rippleBatch` deduplicates signal writes within the synchronous call stack.\n   */\n  function requestNotify(target?: string | Iterable<string>): void {\n    if (disposed) return;\n\n    deps.invalidateCaches();\n\n    if (target === undefined) {\n      fieldStateCache.clear();\n      rippleBatch(() => {\n        formStateSignal.value = deps.computeState();\n\n        for (const [name, sig] of fieldSignals) sig.value = deps.buildFieldState(name);\n      });\n    } else if (typeof target === 'string') {\n      fieldStateCache.delete(target);\n      rippleBatch(() => {\n        formStateSignal.value = deps.computeState();\n\n        const sig = fieldSignals.get(target);\n\n        if (sig) sig.value = deps.buildFieldState(target);\n      });\n    } else {\n      // Materialize before rippleBatch so the iterable isn't consumed inside the callback.\n      const fields = [...target];\n\n      for (const field of fields) fieldStateCache.delete(field);\n\n      rippleBatch(() => {\n        formStateSignal.value = deps.computeState();\n\n        for (const field of fields) {\n          const sig = fieldSignals.get(field);\n\n          if (sig) sig.value = deps.buildFieldState(field);\n        }\n      });\n    }\n  }\n\n  function subscribe(listener: (state: FormState) => void, options?: SubscribeOptions): Unsubscribe {\n    if (disposed) return () => {};\n\n    // Wrap listener so it always returns void — ripple watch throws on non-function returns.\n    const sub = watch(formStateSignal, (state) => {\n      listener(state);\n    });\n\n    rippleSubs.add(sub);\n\n    if (options?.sync) listener(formStateSignal.value);\n\n    return () => {\n      sub.dispose();\n      rippleSubs.delete(sub);\n    };\n  }\n\n  function subscribeField(\n    name: string,\n    listener: (state: FieldState<unknown>) => void,\n    options?: SubscribeOptions,\n  ): Unsubscribe {\n    if (disposed) return () => {};\n\n    assertSafeKey(name);\n\n    const sig = getOrCreateFieldSignal(name);\n    const sub = watch(sig, (state) => {\n      listener(state);\n    });\n\n    rippleSubs.add(sub);\n\n    if (options?.sync) listener(sig.value);\n\n    return () => {\n      sub.dispose();\n      rippleSubs.delete(sub);\n    };\n  }\n\n  function dispose(): void {\n    disposed = true;\n\n    for (const sub of rippleSubs) sub.dispose();\n\n    rippleSubs.clear();\n    fieldSignals.clear();\n    fieldStateCache.clear();\n  }\n\n  return {\n    dispose,\n    getFieldSnapshot,\n    getOrCreateFieldSignal,\n    getStateSnapshot,\n    requestNotify,\n    subscribe,\n    subscribeField,\n  };\n}\n\nexport type Notifier = ReturnType<typeof createNotifier>;\n"],"mappings":"mEA2BA,SAAgB,EAAe,EAAoB,CACjD,IAAM,GAAA,EAAA,EAAA,OAAA,CAA4C,EAAK,aAAa,CAAC,EAC/D,EAAe,IAAI,IACnB,EAAkB,IAAI,IACtB,EAAa,IAAI,IACnB,EAAW,GAEf,SAAS,EAAuB,EAA0C,CACxE,IAAI,EAAM,EAAa,IAAI,CAAG,EAc9B,OAZK,IACH,GAAA,EAAA,EAAA,OAAA,CAAkC,EAAK,gBAAgB,CAAG,EAAG,CAC3D,QAAS,EAAG,IACV,EAAE,QAAU,EAAE,OACd,EAAE,QAAU,EAAE,OACd,EAAE,WAAa,EAAE,UACjB,EAAE,UAAY,EAAE,SAChB,EAAE,QAAU,EAAE,KAClB,CAAC,EACD,EAAa,IAAI,EAAK,CAAG,GAGpB,CACT,CAEA,SAAS,EAAiB,EAAmC,CAC3D,IAAM,EAAS,EAAgB,IAAI,CAAI,EAEvC,GAAI,EAAQ,OAAO,EAEnB,IAAM,EAAO,OAAO,OAAO,EAAK,gBAAgB,CAAI,CAAC,EAIrD,OAFA,EAAgB,IAAI,EAAM,CAAI,EAEvB,CACT,CAEA,SAAS,GAA8B,CACrC,OAAO,EAAgB,KACzB,CASA,SAAS,EAAc,EAA0C,CAC3D,MAIJ,GAFA,EAAK,iBAAiB,EAElB,IAAW,IAAA,GACb,EAAgB,MAAM,GACtB,EAAA,EAAA,MAAA,KAAkB,CAChB,EAAgB,MAAQ,EAAK,aAAa,EAE1C,IAAK,GAAM,CAAC,EAAM,KAAQ,EAAc,EAAI,MAAQ,EAAK,gBAAgB,CAAI,CAC/E,CAAC,OACI,GAAI,OAAO,GAAW,SAC3B,EAAgB,OAAO,CAAM,GAC7B,EAAA,EAAA,MAAA,KAAkB,CAChB,EAAgB,MAAQ,EAAK,aAAa,EAE1C,IAAM,EAAM,EAAa,IAAI,CAAM,EAE/B,IAAK,EAAI,MAAQ,EAAK,gBAAgB,CAAM,EAClD,CAAC,MACI,CAEL,IAAM,EAAS,CAAC,GAAG,CAAM,EAEzB,IAAK,IAAM,KAAS,EAAQ,EAAgB,OAAO,CAAK,GAExD,EAAA,EAAA,MAAA,KAAkB,CAChB,EAAgB,MAAQ,EAAK,aAAa,EAE1C,IAAK,IAAM,KAAS,EAAQ,CAC1B,IAAM,EAAM,EAAa,IAAI,CAAK,EAE9B,IAAK,EAAI,MAAQ,EAAK,gBAAgB,CAAK,EACjD,CACF,CAAC,CACH,CACF,CAEA,SAAS,EAAU,EAAsC,EAAyC,CAChG,GAAI,EAAU,UAAa,CAAC,EAG5B,IAAM,GAAA,EAAA,EAAA,MAAA,CAAY,EAAkB,GAAU,CAC5C,EAAS,CAAK,CAChB,CAAC,EAMD,OAJA,EAAW,IAAI,CAAG,EAEd,GAAS,MAAM,EAAS,EAAgB,KAAK,MAEpC,CACX,EAAI,QAAQ,EACZ,EAAW,OAAO,CAAG,CACvB,CACF,CAEA,SAAS,EACP,EACA,EACA,EACa,CACb,GAAI,EAAU,UAAa,CAAC,EAE5B,EAAA,cAAc,CAAI,EAElB,IAAM,EAAM,EAAuB,CAAI,EACjC,GAAA,EAAA,EAAA,MAAA,CAAY,EAAM,GAAU,CAChC,EAAS,CAAK,CAChB,CAAC,EAMD,OAJA,EAAW,IAAI,CAAG,EAEd,GAAS,MAAM,EAAS,EAAI,KAAK,MAExB,CACX,EAAI,QAAQ,EACZ,EAAW,OAAO,CAAG,CACvB,CACF,CAEA,SAAS,GAAgB,CACvB,EAAW,GAEX,IAAK,IAAM,KAAO,EAAY,EAAI,QAAQ,EAE1C,EAAW,MAAM,EACjB,EAAa,MAAM,EACnB,EAAgB,MAAM,CACxB,CAEA,MAAO,CACL,UACA,mBACA,yBACA,mBACA,gBACA,YACA,gBACF,CACF"}

package/dist/core/notifier.d.ts

@@ -0,0 +1,33 @@
+import { type Signal } from '@vielzeug/ripple';
+import type { FieldState, FormState, SubscribeOptions, Unsubscribe } from '../types';
+/**
+ * Everything needed to (re)compute fresh state on demand. Supplied by whoever owns the
+ * actual field/validator Maps (`core/context.ts`, backing `core/fields.ts`) so this module
+ * never touches those Maps directly — it only knows "how to get current state" and "who's
+ * listening," never "where the state lives."
+ */
+export type NotifierDeps = {
+    buildFieldState(name: string): FieldState<unknown>;
+    computeState(): FormState;
+    /** Called once at the top of every requestNotify(), before state is recomputed — lets the
+     * caller drop its own memoized derived values (e.g. `values()`'s cached unflattened object). */
+    invalidateCaches(): void;
+};
+/**
+ * Owns every signal, subscription, and derived-state cache a form needs to notify observers.
+ * Extracted from the old shared `FormContext` god-object (see `core/context.ts`'s header
+ * comment) — this is the one piece of that object with no real dependency on field values or
+ * validators, only on "what does current state look like" (via `NotifierDeps`), so it's safe
+ * to own its signals/caches privately instead of exposing them on a shared mutable bag.
+ */
+export declare function createNotifier(deps: NotifierDeps): {
+    dispose: () => void;
+    getFieldSnapshot: (name: string) => FieldState<unknown>;
+    getOrCreateFieldSignal: (key: string) => Signal<FieldState<unknown>>;
+    getStateSnapshot: () => FormState;
+    requestNotify: (target?: string | Iterable<string>) => void;
+    subscribe: (listener: (state: FormState) => void, options?: SubscribeOptions) => Unsubscribe;
+    subscribeField: (name: string, listener: (state: FieldState<unknown>) => void, options?: SubscribeOptions) => Unsubscribe;
+};
+export type Notifier = ReturnType<typeof createNotifier>;
+//# sourceMappingURL=notifier.d.ts.map

package/dist/core/notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.d.ts","sourceRoot":"","sources":["../../src/core/notifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAEpF,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAIrF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACnD,YAAY,IAAI,SAAS,CAAC;IAC1B;oGACgG;IAChG,gBAAgB,IAAI,IAAI,CAAC;CAC1B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY;mBAiI3B,IAAI;6BAxGQ,MAAM,KAAG,UAAU,CAAC,OAAO,CAAC;kCAlBvB,MAAM,KAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;4BA8B5C,SAAS;6BAWN,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAG,IAAI;0BAuCnC,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,YAAY,gBAAgB,KAAG,WAAW;2BAmBzF,MAAM,YACF,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,IAAI,YACpC,gBAAgB,KACzB,WAAW;EAuCf;AAED,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/core/notifier.js

@@ -0,0 +1,78 @@
+import { assertSafeKey as e } from "../_utils.js";
+import { batch as t, signal as n, watch as r } from "@vielzeug/ripple";
+//#region src/core/notifier.ts
+function i(i) {
+	let a = n(i.computeState()), o = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Map(), c = /* @__PURE__ */ new Set(), l = !1;
+	function u(e) {
+		let t = o.get(e);
+		return t || (t = n(i.buildFieldState(e), { equals: (e, t) => e.value === t.value && e.error === t.error && e.hasError === t.hasError && e.touched === t.touched && e.dirty === t.dirty }), o.set(e, t)), t;
+	}
+	function d(e) {
+		let t = s.get(e);
+		if (t) return t;
+		let n = Object.freeze(i.buildFieldState(e));
+		return s.set(e, n), n;
+	}
+	function f() {
+		return a.value;
+	}
+	function p(e) {
+		if (!l) if (i.invalidateCaches(), e === void 0) s.clear(), t(() => {
+			a.value = i.computeState();
+			for (let [e, t] of o) t.value = i.buildFieldState(e);
+		});
+		else if (typeof e == "string") s.delete(e), t(() => {
+			a.value = i.computeState();
+			let t = o.get(e);
+			t && (t.value = i.buildFieldState(e));
+		});
+		else {
+			let n = [...e];
+			for (let e of n) s.delete(e);
+			t(() => {
+				a.value = i.computeState();
+				for (let e of n) {
+					let t = o.get(e);
+					t && (t.value = i.buildFieldState(e));
+				}
+			});
+		}
+	}
+	function m(e, t) {
+		if (l) return () => {};
+		let n = r(a, (t) => {
+			e(t);
+		});
+		return c.add(n), t?.sync && e(a.value), () => {
+			n.dispose(), c.delete(n);
+		};
+	}
+	function h(t, n, i) {
+		if (l) return () => {};
+		e(t);
+		let a = u(t), o = r(a, (e) => {
+			n(e);
+		});
+		return c.add(o), i?.sync && n(a.value), () => {
+			o.dispose(), c.delete(o);
+		};
+	}
+	function g() {
+		l = !0;
+		for (let e of c) e.dispose();
+		c.clear(), o.clear(), s.clear();
+	}
+	return {
+		dispose: g,
+		getFieldSnapshot: d,
+		getOrCreateFieldSignal: u,
+		getStateSnapshot: f,
+		requestNotify: p,
+		subscribe: m,
+		subscribeField: h
+	};
+}
+//#endregion
+export { i as createNotifier };
+
+//# sourceMappingURL=notifier.js.map