@vielzeug/forge 1.3.1 → 1.4.0

package/dist/core/scope.js

@@ -2,24 +2,24 @@ import { ForgeSubmitError as e, ForgeValidationError as t } from "../errors.js";
 import { flattenValues as n, unflattenValues as r } from "../_utils.js";
 //#region src/core/scope.ts
 function i(a, o) {
-	let s = `${o}.`;
-	function c(e) {
+	let { ctx: s, fieldOps: c, root: l } = a, u = `${o}.`;
+	function d(e) {
 		return `${o}.${e}`;
 	}
-	function l(e) {
-		return e === o || e.startsWith(s);
+	function f(e) {
+		return e === o || e.startsWith(u);
 	}
-	function u(e) {
-		return e.startsWith(s) ? e.slice(s.length) : e;
+	function p(e) {
+		return e.startsWith(u) ? e.slice(u.length) : e;
 	}
-	function d() {
-		let e = a.getStateSnapshot(), t = Object.fromEntries(Object.entries(e.errors).filter(([e]) => l(e)).map(([e, t]) => [u(e), t])), n = e.touchedFields.filter(l).map(u), r = e.validatingFields.filter(l).map(u), i = Object.keys(t).length === 0, o = [...a.dirty].some(l), s = [...a.touched].some(l), c = r.length > 0;
+	function m() {
+		let e = s.getStateSnapshot(), t = Object.fromEntries(Object.entries(e.errors).filter(([e]) => f(e)).map(([e, t]) => [p(e), t])), n = e.touchedFields.filter(f).map(p), r = e.validatingFields.filter(f).map(p), i = Object.keys(t).length === 0, a = [...s.dirty].some(f), o = [...s.touched].some(f), c = r.length > 0;
 		return Object.freeze({
 			errors: Object.freeze(t),
-			isDirty: o,
+			isDirty: a,
 			isLoading: e.isLoading,
 			isSubmitting: e.isSubmitting,
-			isTouched: s,
+			isTouched: o,
 			isValid: i,
 			isValidating: c,
 			submitCount: e.submitCount,
@@ -27,118 +27,93 @@ function i(a, o) {
 			validatingFields: Object.freeze(r)
 		});
 	}
-	function f() {
+	function h() {
 		let e = {};
-		for (let [t, n] of a.store) t.startsWith(s) && (e[t.slice(s.length)] = n);
+		for (let [t, n] of s.store) t.startsWith(u) && (e[t.slice(u.length)] = n);
 		return r(e);
 	}
-	function p() {
+	function g() {
 		let e = /* @__PURE__ */ new Set();
-		for (let t of a.store.keys()) l(t) && e.add(u(t));
-		for (let t of a.validators.keys()) l(t) && e.add(u(t));
+		for (let t of s.store.keys()) f(t) && e.add(p(t));
+		for (let t of s.validators.keys()) f(t) && e.add(p(t));
 		return Object.freeze([...e]);
 	}
-	function m() {
-		a.ensureNotDisposed();
-		for (let e of a.store.keys()) l(e) && a.touched.add(e);
-		for (let e of a.validators.keys()) l(e) && a.touched.add(e);
-		a.requestNotify();
+	function _() {
+		s.ensureNotDisposed("touchAll"), c.touchAllKeys(f), s.requestNotify();
 	}
-	function h() {
-		a.ensureNotDisposed();
-		for (let e of [...a.touched]) l(e) && a.touched.delete(e);
-		a.requestNotify();
+	function v() {
+		s.ensureNotDisposed("untouchAll"), c.untouchAllKeys(f), s.requestNotify();
 	}
-	function g() {
-		a.ensureNotDisposed();
-		for (let e of [...a.store.keys()]) l(e) && (a.fieldCtrls.get(e)?.abort(), a.fieldCtrls.delete(e), a.store.set(e, a.baseline.get(e)), a.dirty.delete(e), a.touched.delete(e), a.fieldErrors.delete(e) && a.invalidateErrors());
-		a.requestNotify();
+	function y() {
+		s.ensureNotDisposed("reset"), c.resetKeys(f), s.requestNotify();
 	}
-	function _(e) {
-		a.ensureNotDisposed();
-		for (let e of [...a.fieldCtrls.keys()]) l(e) && (a.fieldCtrls.get(e)?.abort(), a.fieldCtrls.delete(e));
-		let t = n(e);
-		for (let e of [...a.store.keys()]) l(e) && (a.store.delete(e), a.baseline.delete(e), a.dirty.delete(e), a.touched.delete(e), a.fieldErrors.delete(e));
-		a.invalidateErrors();
-		for (let [e, n] of Object.entries(t)) {
-			let t = c(e);
-			a.store.set(t, n), a.baseline.set(t, n);
-		}
-		a.requestNotify();
+	function b(e) {
+		s.ensureNotDisposed("replace"), c.replaceKeys(f, n(e), d), s.requestNotify();
 	}
-	function v(e) {
-		a.ensureNotDisposed();
-		let t = n(e), r = [];
-		for (let [e, n] of Object.entries(t)) {
-			let t = c(e);
-			a.baseline.set(t, n), a.store.set(t, n), a.dirty.delete(t), r.push(t);
-		}
-		a.requestNotify(r);
+	function x(e) {
+		s.ensureNotDisposed("patch"), s.requestNotify(c.patchKeys(e, d));
 	}
-	function y(e) {
-		a.ensureNotDisposed();
-		for (let e of [...a.fieldErrors.keys()]) l(e) && a.fieldErrors.delete(e);
-		if (e) for (let [t, n] of Object.entries(e)) typeof n == "string" && a.fieldErrors.set(c(t), n);
-		a.invalidateErrors(), a.requestNotify();
+	function S(e) {
+		s.ensureNotDisposed("resetErrors"), c.resetErrorsKeys(f, e ?? {}, d), s.requestNotify();
 	}
-	async function b(e, t) {
-		if (a.ensureNotDisposed(), e !== void 0 && !Array.isArray(e) && !(e instanceof AbortSignal)) {
-			let n = c(e);
-			await a.runValidationCore([n], "partial", t);
-			let r = a.fieldErrors.get(n);
+	async function C(e, t) {
+		if (s.ensureNotDisposed("validate"), e !== void 0 && !Array.isArray(e) && !(e instanceof AbortSignal)) {
+			let n = d(e);
+			await c.runValidationCore([n], "partial", t);
+			let r = s.fieldErrors.get(n);
 			return {
 				errors: r === void 0 ? {} : { [e]: r },
 				valid: r === void 0
 			};
 		}
 		if (Array.isArray(e)) {
-			let n = e.map((e) => c(e));
-			await a.runValidationCore(n, "partial", t);
+			let n = e.map((e) => d(e));
+			await c.runValidationCore(n, "partial", t);
 			let r = {};
 			for (let e of n) {
-				let t = a.fieldErrors.get(e);
-				t !== void 0 && (r[u(e)] = t);
+				let t = s.fieldErrors.get(e);
+				t !== void 0 && (r[p(e)] = t);
 			}
 			return {
 				errors: r,
 				valid: Object.keys(r).length === 0
 			};
 		}
-		let n = e, r = [...a.validators.keys()].filter(l);
-		await a.runValidationCore(r, "partial", n);
+		let n = e, r = [...s.validators.keys()].filter(f);
+		await c.runValidationCore(r, "partial", n);
 		let i = {};
-		for (let [e, t] of a.fieldErrors) l(e) && (i[u(e)] = t);
+		for (let [e, t] of s.fieldErrors) f(e) && (i[p(e)] = t);
 		return {
 			errors: i,
 			valid: Object.keys(i).length === 0
 		};
 	}
-	async function x(t) {
-		if (a.ensureNotDisposed(), a.isSubmitting()) throw new e("submit() called while a submission is already in progress");
-		a.root.batch(() => {
-			a.incrementSubmitCount(), a.setSubmitting(!0), m();
+	async function w(t) {
+		if (s.ensureNotDisposed("submit"), s.isSubmittingState) throw new e("submit() called while a submission is already in progress");
+		s.batch(() => {
+			s.submitCount++, s.isSubmittingState = !0, _();
 		});
 		try {
-			let e = [...a.validators.keys()].filter(l);
-			await a.runValidationCore(e, "partial"), a.ensureNotDisposed();
+			let e = [...s.validators.keys()].filter(f);
+			await c.runValidationCore(e, "partial"), s.ensureNotDisposed("submit");
 			let n = {};
-			for (let [e, t] of a.fieldErrors) l(e) && (n[u(e)] = t);
+			for (let [e, t] of s.fieldErrors) f(e) && (n[p(e)] = t);
 			return Object.keys(n).length > 0 ? {
 				errors: n,
 				ok: !1,
 				type: "validation"
 			} : {
 				ok: !0,
-				value: await t(f())
+				value: await t(h())
 			};
 		} finally {
-			a.setSubmitting(!1), a.isDisposed() || a.requestNotify();
+			s.isSubmittingState = !1, s.disposed || s.requestNotify();
 		}
 	}
-	function S(e, t) {
+	function T(e, t) {
 		let n = null;
-		return a.root.subscribe(() => {
-			let t = d();
+		return l.subscribe(() => {
+			let t = m();
 			if (n) {
 				let e = n, r = Object.keys(t.errors), i = Object.keys(e.errors), a = r.length === i.length && r.every((n) => t.errors[n] === e.errors[n]), o = t.touchedFields.length === e.touchedFields.length && t.touchedFields.every((t, n) => t === e.touchedFields[n]), s = t.validatingFields.length === e.validatingFields.length && t.validatingFields.every((t, n) => t === e.validatingFields[n]);
 				if (t.isDirty === e.isDirty && t.isLoading === e.isLoading && t.isSubmitting === e.isSubmitting && t.isTouched === e.isTouched && t.isValid === e.isValid && t.isValidating === e.isValidating && t.submitCount === e.submitCount && a && o && s) return;
@@ -146,138 +121,112 @@ function i(a, o) {
 			n = t, e(t);
 		}, t);
 	}
-	function C() {
+	function E() {
 		return {
 			array(e) {
-				return a.root.array(c(e));
+				return l.array(d(e));
 			},
 			clearError(e) {
-				a.root.clearError(c(e));
+				l.clearError(d(e));
 			},
 			connect(e, t) {
-				return a.root.connect(c(e), t);
+				return l.connect(d(e), t);
 			},
 			field(e) {
-				return a.root.field(c(e));
+				return l.field(d(e));
 			},
 			get(e) {
-				return a.root.get(c(e));
+				return l.get(d(e));
 			},
 			register(e, t) {
-				return a.root.fields.register(c(e), t);
+				return l.fields.register(d(e), t);
 			},
 			remove(e) {
-				a.root.fields.remove(c(e));
+				l.fields.remove(d(e));
 			},
 			resetField(e) {
-				a.root.resetField(c(e));
+				l.resetField(d(e));
 			},
 			set(e, t, n) {
-				a.root.set(c(e), t, n);
+				l.set(d(e), t, n);
 			},
 			setError(e, t) {
-				a.root.setError(c(e), t);
+				l.setError(d(e), t);
 			},
 			setValidator(e, t) {
-				a.root.fields.setValidator(c(e), t);
+				l.fields.setValidator(d(e), t);
 			},
 			subscribeField(e, t, n) {
-				return a.root.subscribeField(c(e), t, n);
+				return l.subscribeField(d(e), t, n);
 			},
 			touch(e) {
-				a.root.touch(c(e));
+				l.touch(d(e));
 			},
 			untouch(e) {
-				a.root.untouch(c(e));
+				l.untouch(d(e));
 			}
 		};
 	}
-	let w = C();
+	let D = E();
 	return {
-		array: (e) => w.array(e),
-		batch: (e) => a.root.batch(e),
-		clearError: (e) => w.clearError(e),
-		connect: (e, t) => w.connect(e, t),
+		array: (e) => D.array(e),
+		batch: (e) => l.batch(e),
+		clearError: (e) => D.clearError(e),
+		connect: (e, t) => D.connect(e, t),
 		get disposalSignal() {
-			return a.root.disposalSignal;
+			return l.disposalSignal;
 		},
 		dispose: () => {},
 		get disposed() {
-			return a.isDisposed();
+			return s.disposed;
 		},
-		field: (e) => w.field(e),
+		field: (e) => D.field(e),
 		fields: {
-			list: p,
-			register: (e, t) => w.register(e, t),
-			remove: (e) => w.remove(e),
-			setValidator: (e, t) => w.setValidator(e, t)
+			list: g,
+			register: (e, t) => D.register(e, t),
+			remove: (e) => D.remove(e),
+			setValidator: (e, t) => D.setValidator(e, t)
+		},
+		get: (e) => D.get(e),
+		history: {
+			restore: (e) => l.history.restore(e),
+			snapshot: () => l.history.snapshot()
 		},
-		get: (e) => w.get(e),
 		get isLoading() {
-			return a.root.isLoading;
+			return l.isLoading;
 		},
 		get isSubmitting() {
-			return a.root.isSubmitting;
+			return l.isSubmitting;
 		},
-		patch: v,
-		replace: _,
-		reset: g,
-		resetErrors: y,
-		resetField: (e) => w.resetField(e),
-		restore: (e) => a.root.restore(e),
-		scope: (e) => i(a, c(e)),
-		set: (e, t, n) => w.set(e, t, n),
-		setError: (e, t) => w.setError(e, t),
-		snapshot: () => a.root.snapshot(),
+		patch: x,
+		replace: b,
+		reset: y,
+		resetErrors: S,
+		resetField: (e) => D.resetField(e),
+		scope: (e) => i(a, d(e)),
+		set: (e, t, n) => D.set(e, t, n),
+		setError: (e, t) => D.setError(e, t),
 		get state() {
-			return d();
+			return m();
 		},
-		submit: x,
+		submit: w,
 		submitOrThrow: async (e) => {
-			let n = await x(e);
+			let n = await w(e);
 			if (!n.ok) throw new t(n.errors);
 			return n.value;
 		},
-		subscribe: (e, t) => a.root.subscribe(e, t),
-		subscribeField: (e, t, n) => w.subscribeField(e, t, n),
-		subscribeScoped: S,
-		[Symbol.asyncIterator]: () => a.root[Symbol.asyncIterator](),
+		subscribe: T,
+		subscribeField: (e, t, n) => D.subscribeField(e, t, n),
+		[Symbol.asyncIterator]: () => l[Symbol.asyncIterator](),
 		[Symbol.dispose]() {
 			this.dispose();
 		},
-		touch: (e) => w.touch(e),
-		touchAll: m,
-		untouch: (e) => w.untouch(e),
-		untouchAll: h,
-		validate: b,
-		validateStream(e) {
-			let t = a.root.validateStream(e);
-			return {
-				async next() {
-					for (;;) {
-						let e = await t.next();
-						if (e.done) return e;
-						if (l(e.value.field)) return {
-							done: !1,
-							value: {
-								error: e.value.error,
-								field: u(e.value.field)
-							}
-						};
-					}
-				},
-				return() {
-					return t.return ? t.return() : Promise.resolve({
-						done: !0,
-						value: void 0
-					});
-				},
-				[Symbol.asyncIterator]() {
-					return this;
-				}
-			};
-		},
-		values: f
+		touch: (e) => D.touch(e),
+		touchAll: _,
+		untouch: (e) => D.untouch(e),
+		untouchAll: v,
+		validate: C,
+		values: h
 	};
 }
 //#endregion

package/dist/core/scope.js.map

@@ -1 +1 @@
-{"version":3,"file":"scope.js","names":[],"sources":["../../src/core/scope.ts"],"sourcesContent":["import type {\n  ArrayField,\n  ConnectOptions,\n  ConnectionResult,\n  ErrorKeyOf,\n  FieldState,\n  FieldValidator,\n  FlatKeyOf,\n  Form,\n  FormSnapshot,\n  FormState,\n  MaybePromise,\n  RegisterFieldOptions,\n  ScopedValues,\n  SetOptions,\n  SubmitResult,\n  SubscribeOptions,\n  TypeAtPath,\n  Unsubscribe,\n  ValidateResult,\n} from '../types';\n\nimport { flattenValues, unflattenValues } from '../_utils';\nimport { ForgeSubmitError, ForgeValidationError } from '../errors';\n\n/**\n * R3: Slim ScopeContext — delegates simple operations through `root: Form<TValues>`.\n * Only the Maps/Sets needed for bulk scoped operations are passed directly.\n * @internal\n */\nexport interface ScopeContext<TValues extends Record<string, unknown> = Record<string, unknown>> {\n  /** The fully-featured root form — used for all simple one-field delegations. */\n  root: Form<TValues>;\n\n  /* ---- Shared mutable state (passed by reference, needed by bulk scoped ops) ---- */\n  store: Map<string, unknown>;\n  baseline: Map<string, unknown>;\n  validators: Map<string, FieldValidator<unknown>>;\n  fieldErrors: Map<string, string>;\n  touched: Set<string>;\n  dirty: Set<string>;\n  fieldCtrls: Map<string, AbortController>;\n\n  /* ---- Scalar state accessors ---- */\n  isSubmitting(): boolean;\n  setSubmitting(value: boolean): void;\n  incrementSubmitCount(): void;\n  isDisposed(): boolean;\n\n  /* ---- Core helpers ---- */\n  ensureNotDisposed(): void;\n  invalidateErrors(): void;\n  requestNotify(target?: string | Iterable<string>): void;\n  getStateSnapshot(): FormState;\n\n  /* ---- Validation core (needed for scoped validate/submit) ---- */\n  runValidationCore(\n    fields: string[],\n    scope: 'full' | 'partial',\n    signal?: AbortSignal,\n  ): Promise<ValidateResult & { aborted: boolean }>;\n}\n\n/**\n * Creates a scoped sub-form whose field paths are relative to `pfx`.\n * All simple single-field operations delegate to `ctx.root`.\n * Only prefix-aware bulk operations (submit, validate, replace, reset, etc.) contain custom code.\n */\nexport function createScopedForm<TValues extends Record<string, unknown>, P extends string>(\n  ctx: ScopeContext<TValues>,\n  pfx: P,\n): Form<ScopedValues<TValues, P>> {\n  const pfxDot = `${pfx}.`;\n\n  function pre(name: string): string {\n    return `${pfx}.${name}`;\n  }\n\n  function isScopedKey(key: string): boolean {\n    return key === pfx || key.startsWith(pfxDot);\n  }\n\n  function unscope(key: string): string {\n    return key.startsWith(pfxDot) ? key.slice(pfxDot.length) : key;\n  }\n\n  /* ---- Non-trivial scoped implementations ---- */\n\n  /**\n   * Compute a scoped projection of FormState from current raw Maps.\n   * Errors, touchedFields, validatingFields, isValid, isDirty, isTouched reflect only\n   * fields within the prefix. isSubmitting, isLoading, isValidating, submitCount are full-form.\n   */\n  function getScopedState(): FormState {\n    const rootState = ctx.getStateSnapshot();\n    const errors = Object.fromEntries(\n      Object.entries(rootState.errors)\n        .filter(([k]) => isScopedKey(k))\n        .map(([k, v]) => [unscope(k), v]),\n    );\n    const touchedFields = rootState.touchedFields.filter(isScopedKey).map(unscope);\n    const validatingFields = rootState.validatingFields.filter(isScopedKey).map(unscope);\n    const isValid = Object.keys(errors).length === 0;\n    const isDirty = [...ctx.dirty].some(isScopedKey);\n    const isTouched = [...ctx.touched].some(isScopedKey);\n    const isValidating = validatingFields.length > 0;\n\n    return Object.freeze({\n      errors: Object.freeze(errors) as FormState['errors'],\n      isDirty,\n      isLoading: rootState.isLoading,\n      isSubmitting: rootState.isSubmitting,\n      isTouched,\n      isValid,\n      isValidating,\n      submitCount: rootState.submitCount,\n      touchedFields: Object.freeze(touchedFields) as readonly string[],\n      validatingFields: Object.freeze(validatingFields) as readonly string[],\n    });\n  }\n\n  function scopedValues(): ScopedValues<TValues, P> {\n    const sub: Record<string, unknown> = {};\n\n    for (const [key, value] of ctx.store) {\n      if (key.startsWith(pfxDot)) sub[key.slice(pfxDot.length)] = value;\n    }\n\n    return unflattenValues(sub) as ScopedValues<TValues, P>;\n  }\n\n  /**\n   * Enumerate field paths within this scope's prefix, stripped to relative paths —\n   * matching `scope.state`'s relative-path convention, not `state.touchedFields`'s\n   * absolute-path convention. Same \"known field\" definition `scopedTouchAll()` uses.\n   */\n  function scopedListFields(): readonly string[] {\n    const known = new Set<string>();\n\n    for (const key of ctx.store.keys()) {\n      if (isScopedKey(key)) known.add(unscope(key));\n    }\n\n    for (const key of ctx.validators.keys()) {\n      if (isScopedKey(key)) known.add(unscope(key));\n    }\n\n    return Object.freeze([...known]);\n  }\n\n  function scopedTouchAll(): void {\n    ctx.ensureNotDisposed();\n\n    for (const name of ctx.store.keys()) {\n      if (isScopedKey(name)) ctx.touched.add(name);\n    }\n\n    for (const name of ctx.validators.keys()) {\n      if (isScopedKey(name)) ctx.touched.add(name);\n    }\n\n    ctx.requestNotify();\n  }\n\n  function scopedUntouchAll(): void {\n    ctx.ensureNotDisposed();\n\n    for (const name of [...ctx.touched]) {\n      if (isScopedKey(name)) ctx.touched.delete(name);\n    }\n\n    ctx.requestNotify();\n  }\n\n  function scopedReset(): void {\n    ctx.ensureNotDisposed();\n\n    for (const key of [...ctx.store.keys()]) {\n      if (!isScopedKey(key)) continue;\n\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\n    ctx.requestNotify();\n  }\n\n  function scopedReplace(newValues: ScopedValues<TValues, P>): void {\n    ctx.ensureNotDisposed();\n\n    for (const key of [...ctx.fieldCtrls.keys()]) {\n      if (isScopedKey(key)) {\n        ctx.fieldCtrls.get(key)?.abort();\n        ctx.fieldCtrls.delete(key);\n      }\n    }\n\n    const flat = flattenValues(newValues as Record<string, unknown>);\n\n    for (const key of [...ctx.store.keys()]) {\n      if (!isScopedKey(key)) continue;\n\n      ctx.store.delete(key);\n      ctx.baseline.delete(key);\n      ctx.dirty.delete(key);\n      ctx.touched.delete(key);\n      ctx.fieldErrors.delete(key);\n    }\n\n    ctx.invalidateErrors();\n\n    for (const [key, value] of Object.entries(flat)) {\n      const full = pre(key);\n\n      ctx.store.set(full, value);\n      ctx.baseline.set(full, value);\n    }\n\n    ctx.requestNotify();\n  }\n\n  function scopedPatch(partial: Record<string, unknown>): void {\n    ctx.ensureNotDisposed();\n\n    const flat = flattenValues(partial);\n    const changedKeys: string[] = [];\n\n    for (const [key, value] of Object.entries(flat)) {\n      const full = pre(key);\n\n      ctx.baseline.set(full, value);\n      ctx.store.set(full, value);\n      ctx.dirty.delete(full);\n      changedKeys.push(full);\n    }\n\n    ctx.requestNotify(changedKeys);\n  }\n\n  function scopedResetErrors(\n    nextErrors?: Partial<Record<ErrorKeyOf<ScopedValues<TValues, P>>, string | undefined>>,\n  ): void {\n    ctx.ensureNotDisposed();\n\n    for (const key of [...ctx.fieldErrors.keys()]) {\n      if (isScopedKey(key)) ctx.fieldErrors.delete(key);\n    }\n\n    if (nextErrors) {\n      for (const [key, message] of Object.entries(nextErrors)) {\n        if (typeof message === 'string') ctx.fieldErrors.set(pre(key), message);\n      }\n    }\n\n    ctx.invalidateErrors();\n    ctx.requestNotify();\n  }\n\n  async function scopedValidate(\n    nameOrFieldsOrSignal?: FlatKeyOf<ScopedValues<TValues, P>> | FlatKeyOf<ScopedValues<TValues, P>>[] | AbortSignal,\n    signal?: AbortSignal,\n  ): Promise<ValidateResult> {\n    ctx.ensureNotDisposed();\n\n    if (\n      nameOrFieldsOrSignal !== undefined &&\n      !Array.isArray(nameOrFieldsOrSignal) &&\n      !(nameOrFieldsOrSignal instanceof AbortSignal)\n    ) {\n      // validate(name) — single field\n      const prefixedName = pre(nameOrFieldsOrSignal as string) as FlatKeyOf<TValues>;\n\n      await ctx.runValidationCore([prefixedName as string], 'partial', signal);\n\n      const error = ctx.fieldErrors.get(prefixedName as string);\n\n      return {\n        errors: error !== undefined ? { [nameOrFieldsOrSignal as string]: error } : {},\n        valid: error === undefined,\n      };\n    }\n\n    if (Array.isArray(nameOrFieldsOrSignal)) {\n      // validate(fields[]) — specific subset\n      const prefixedFields = nameOrFieldsOrSignal.map((f) => pre(f as string)) as string[];\n\n      await ctx.runValidationCore(prefixedFields, 'partial', signal);\n\n      const errors: Record<string, string> = {};\n\n      for (const pf of prefixedFields) {\n        const msg = ctx.fieldErrors.get(pf);\n\n        if (msg !== undefined) errors[unscope(pf)] = msg;\n      }\n\n      return { errors, valid: Object.keys(errors).length === 0 };\n    }\n\n    // validate(signal?) — all scoped fields\n    const sig = nameOrFieldsOrSignal as AbortSignal | undefined;\n    const fields = [...ctx.validators.keys()].filter(isScopedKey);\n\n    await ctx.runValidationCore(fields, 'partial', sig);\n\n    const errors: Record<string, string> = {};\n\n    for (const [key, message] of ctx.fieldErrors) {\n      if (isScopedKey(key)) errors[unscope(key)] = message;\n    }\n\n    return { errors, valid: Object.keys(errors).length === 0 };\n  }\n\n  async function scopedSubmit<TResult>(\n    handler: (values: ScopedValues<TValues, P>) => MaybePromise<TResult>,\n  ): Promise<SubmitResult<TResult>> {\n    ctx.ensureNotDisposed();\n\n    if (ctx.isSubmitting()) throw new ForgeSubmitError('submit() called while a submission is already in progress');\n\n    ctx.root.batch(() => {\n      ctx.incrementSubmitCount();\n      ctx.setSubmitting(true);\n      scopedTouchAll();\n    });\n\n    try {\n      const fields = [...ctx.validators.keys()].filter(isScopedKey);\n\n      await ctx.runValidationCore(fields, 'partial');\n\n      ctx.ensureNotDisposed();\n\n      const errors: Record<string, string> = {};\n\n      for (const [key, message] of ctx.fieldErrors) {\n        if (isScopedKey(key)) errors[unscope(key)] = message;\n      }\n\n      if (Object.keys(errors).length > 0) {\n        return { errors, ok: false, type: 'validation' as const };\n      }\n\n      return { ok: true as const, value: await handler(scopedValues()) };\n    } finally {\n      ctx.setSubmitting(false);\n\n      if (!ctx.isDisposed()) ctx.requestNotify();\n    }\n  }\n\n  /**\n   * Subscribe filtered to scoped fields only.\n   * Errors, touchedFields, and validatingFields are remapped to relative paths.\n   * `isValid`, `isDirty`, and `isTouched` reflect only fields within this scope's prefix.\n   * `isSubmitting`, `isLoading`, `isValidating`, and `submitCount` reflect the full form.\n   *\n   * The listener fires only when the scoped projection changes — mutations outside this\n   * prefix do not fire the listener.\n   */\n  function subscribeScoped(listener: (state: FormState) => void, options?: SubscribeOptions): Unsubscribe {\n    // Track the previous scoped projection for equality comparison.\n    let prevState: FormState | null = null;\n\n    return ctx.root.subscribe(() => {\n      const next = getScopedState();\n\n      // Skip if no scoped-relevant state has changed.\n      if (prevState) {\n        const p = prevState;\n        const errKeys = Object.keys(next.errors);\n        const prevErrKeys = Object.keys(p.errors);\n        const errorsMatch =\n          errKeys.length === prevErrKeys.length && errKeys.every((k) => next.errors[k] === p.errors[k]);\n\n        const touchedMatch =\n          next.touchedFields.length === p.touchedFields.length &&\n          next.touchedFields.every((v, i) => v === p.touchedFields[i]);\n\n        const validatingMatch =\n          next.validatingFields.length === p.validatingFields.length &&\n          next.validatingFields.every((v, i) => v === p.validatingFields[i]);\n\n        const flagsMatch =\n          next.isDirty === p.isDirty &&\n          next.isLoading === p.isLoading &&\n          next.isSubmitting === p.isSubmitting &&\n          next.isTouched === p.isTouched &&\n          next.isValid === p.isValid &&\n          next.isValidating === p.isValidating &&\n          next.submitCount === p.submitCount;\n\n        if (flagsMatch && errorsMatch && touchedMatch && validatingMatch) return;\n      }\n\n      prevState = next;\n      listener(next);\n    }, options);\n  }\n\n  function createScopedAdapter() {\n    return {\n      array(name: string): ArrayField {\n        return ctx.root.array(pre(name) as FlatKeyOf<TValues>) as ArrayField;\n      },\n      clearError(name: string): void {\n        ctx.root.clearError(pre(name) as ErrorKeyOf<TValues>);\n      },\n      connect(name: string, config?: ConnectOptions): ConnectionResult<unknown> {\n        return ctx.root.connect(pre(name) as FlatKeyOf<TValues>, config) as ConnectionResult<unknown>;\n      },\n      field(name: string): FieldState<unknown> {\n        return ctx.root.field(pre(name) as FlatKeyOf<TValues>) as FieldState<unknown>;\n      },\n      get(name: string): unknown {\n        return ctx.root.get(pre(name) as FlatKeyOf<TValues>);\n      },\n      register(name: string, options?: RegisterFieldOptions<unknown>): Unsubscribe {\n        return ctx.root.fields.register(\n          pre(name) as FlatKeyOf<TValues>,\n          options as RegisterFieldOptions<TypeAtPath<TValues, FlatKeyOf<TValues>>>,\n        );\n      },\n      remove(name: string): void {\n        ctx.root.fields.remove(pre(name) as FlatKeyOf<TValues>);\n      },\n      resetField(name: string): void {\n        ctx.root.resetField(pre(name) as FlatKeyOf<TValues>);\n      },\n      set(name: string, value: unknown, options?: SetOptions): void {\n        ctx.root.set(pre(name) as FlatKeyOf<TValues>, value as TypeAtPath<TValues, FlatKeyOf<TValues>>, options);\n      },\n      setError(name: string, message: string): void {\n        ctx.root.setError(pre(name) as ErrorKeyOf<TValues>, message);\n      },\n      setValidator(name: string, validator?: FieldValidator): void {\n        ctx.root.fields.setValidator(pre(name) as FlatKeyOf<TValues>, validator);\n      },\n      subscribeField(\n        name: string,\n        listener: (state: FieldState<unknown>) => void,\n        options?: SubscribeOptions,\n      ): Unsubscribe {\n        return ctx.root.subscribeField(\n          pre(name) as FlatKeyOf<TValues>,\n          listener as (state: FieldState<TypeAtPath<TValues, FlatKeyOf<TValues>>>) => void,\n          options,\n        );\n      },\n      touch(name: string): void {\n        ctx.root.touch(pre(name) as FlatKeyOf<TValues>);\n      },\n      untouch(name: string): void {\n        ctx.root.untouch(pre(name) as FlatKeyOf<TValues>);\n      },\n    };\n  }\n\n  /* ---- Public scoped form object ---- */\n\n  type S = ScopedValues<TValues, P>;\n\n  const adapter = createScopedAdapter();\n\n  return {\n    array: (name) =>\n      adapter.array(name as string) as ArrayField<\n        TypeAtPath<S, typeof name> extends readonly (infer E)[] ? E : unknown\n      >,\n    batch: (fn) => ctx.root.batch(fn),\n    clearError: (name) => adapter.clearError(name as string),\n    connect: (name, config?) => adapter.connect(name as string, config) as ConnectionResult<TypeAtPath<S, typeof name>>,\n    get disposalSignal() {\n      return ctx.root.disposalSignal;\n    },\n    dispose: () => {\n      /* Scoped forms share lifecycle with parent — call parentForm.dispose() to tear down */\n    },\n    get disposed() {\n      return ctx.isDisposed();\n    },\n    field: (name) => adapter.field(name as string) as FieldState<TypeAtPath<S, typeof name>>,\n    fields: {\n      list: scopedListFields,\n      register: (name, options?) => adapter.register(name as string, options as RegisterFieldOptions<unknown>),\n      remove: (name) => adapter.remove(name as string),\n      setValidator: (name, validator?) => adapter.setValidator(name as string, validator),\n    },\n    get: (name) => adapter.get(name as string) as TypeAtPath<S, typeof name>,\n    get isLoading() {\n      return ctx.root.isLoading;\n    },\n    get isSubmitting() {\n      return ctx.root.isSubmitting;\n    },\n    patch: scopedPatch as Form<S>['patch'],\n    replace: scopedReplace as Form<S>['replace'],\n    reset: scopedReset,\n    resetErrors: scopedResetErrors as Form<S>['resetErrors'],\n    resetField: (name) => adapter.resetField(name as string),\n    // Cast is irreducible: FormSnapshot<ScopedValues<TValues,P>> and FormSnapshot<TValues> are\n    // structurally unrelated generic instantiations -- TS cannot verify one against the other.\n    restore: (snap) => ctx.root.restore(snap as FormSnapshot<TValues>),\n    scope: (subPrefix) => createScopedForm(ctx, pre(subPrefix as string)) as Form<ScopedValues<S, typeof subPrefix>>,\n    set: (name, value, options?: SetOptions) => adapter.set(name as string, value, options),\n    setError: (name, message) => adapter.setError(name as string, message),\n    // Cast is irreducible: FormSnapshot<TValues> and FormSnapshot<ScopedValues<TValues,P>> are\n    // structurally unrelated generic instantiations -- TS cannot verify one against the other.\n    snapshot: () => ctx.root.snapshot() as FormSnapshot<S>,\n    get state() {\n      return getScopedState();\n    },\n    submit: scopedSubmit as Form<S>['submit'],\n    submitOrThrow: async (handler) => {\n      const result = await scopedSubmit(handler);\n\n      if (!result.ok) throw new ForgeValidationError(result.errors as Record<string, string>);\n\n      return result.value;\n    },\n    subscribe: (listener, options?) => ctx.root.subscribe(listener, options),\n    subscribeField: (name, listener, options?) =>\n      adapter.subscribeField(name as string, listener as (state: FieldState<unknown>) => void, options),\n    subscribeScoped,\n    [Symbol.asyncIterator]: () => ctx.root[Symbol.asyncIterator](),\n    [Symbol.dispose]() {\n      this.dispose();\n    },\n    touch: (name) => adapter.touch(name as string),\n    touchAll: scopedTouchAll,\n    untouch: (name) => adapter.untouch(name as string),\n    untouchAll: scopedUntouchAll,\n    validate: scopedValidate as Form<S>['validate'],\n    validateStream(signal?) {\n      const rootIter = ctx.root.validateStream(signal);\n\n      const iter: AsyncIterableIterator<{ error: string | undefined; field: string }> = {\n        async next() {\n          for (;;) {\n            const item = await rootIter.next();\n\n            if (item.done) return item;\n\n            if (isScopedKey(item.value.field))\n              return { done: false, value: { error: item.value.error, field: unscope(item.value.field) } };\n          }\n        },\n        return() {\n          return rootIter.return ? rootIter.return() : Promise.resolve({ done: true as const, value: undefined });\n        },\n        [Symbol.asyncIterator]() {\n          return this;\n        },\n      };\n\n      return iter;\n    },\n    values: scopedValues,\n  };\n}\n"],"mappings":";;;AAoEA,SAAgB,EACd,GACA,GACgC;CAChC,IAAM,IAAS,GAAG,EAAI;CAEtB,SAAS,EAAI,GAAsB;EACjC,OAAO,GAAG,EAAI,GAAG;CACnB;CAEA,SAAS,EAAY,GAAsB;EACzC,OAAO,MAAQ,KAAO,EAAI,WAAW,CAAM;CAC7C;CAEA,SAAS,EAAQ,GAAqB;EACpC,OAAO,EAAI,WAAW,CAAM,IAAI,EAAI,MAAM,EAAO,MAAM,IAAI;CAC7D;CASA,SAAS,IAA4B;EACnC,IAAM,IAAY,EAAI,iBAAiB,GACjC,IAAS,OAAO,YACpB,OAAO,QAAQ,EAAU,MAAM,CAAC,CAC7B,QAAQ,CAAC,OAAO,EAAY,CAAC,CAAC,CAAC,CAC/B,KAAK,CAAC,GAAG,OAAO,CAAC,EAAQ,CAAC,GAAG,CAAC,CAAC,CACpC,GACM,IAAgB,EAAU,cAAc,OAAO,CAAW,CAAC,CAAC,IAAI,CAAO,GACvE,IAAmB,EAAU,iBAAiB,OAAO,CAAW,CAAC,CAAC,IAAI,CAAO,GAC7E,IAAU,OAAO,KAAK,CAAM,CAAC,CAAC,WAAW,GACzC,IAAU,CAAC,GAAG,EAAI,KAAK,CAAC,CAAC,KAAK,CAAW,GACzC,IAAY,CAAC,GAAG,EAAI,OAAO,CAAC,CAAC,KAAK,CAAW,GAC7C,IAAe,EAAiB,SAAS;EAE/C,OAAO,OAAO,OAAO;GACnB,QAAQ,OAAO,OAAO,CAAM;GAC5B;GACA,WAAW,EAAU;GACrB,cAAc,EAAU;GACxB;GACA;GACA;GACA,aAAa,EAAU;GACvB,eAAe,OAAO,OAAO,CAAa;GAC1C,kBAAkB,OAAO,OAAO,CAAgB;EAClD,CAAC;CACH;CAEA,SAAS,IAAyC;EAChD,IAAM,IAA+B,CAAC;EAEtC,KAAK,IAAM,CAAC,GAAK,MAAU,EAAI,OAC7B,AAAI,EAAI,WAAW,CAAM,MAAG,EAAI,EAAI,MAAM,EAAO,MAAM,KAAK;EAG9D,OAAO,EAAgB,CAAG;CAC5B;CAOA,SAAS,IAAsC;EAC7C,IAAM,oBAAQ,IAAI,IAAY;EAE9B,KAAK,IAAM,KAAO,EAAI,MAAM,KAAK,GAC/B,AAAI,EAAY,CAAG,KAAG,EAAM,IAAI,EAAQ,CAAG,CAAC;EAG9C,KAAK,IAAM,KAAO,EAAI,WAAW,KAAK,GACpC,AAAI,EAAY,CAAG,KAAG,EAAM,IAAI,EAAQ,CAAG,CAAC;EAG9C,OAAO,OAAO,OAAO,CAAC,GAAG,CAAK,CAAC;CACjC;CAEA,SAAS,IAAuB;EAC9B,EAAI,kBAAkB;EAEtB,KAAK,IAAM,KAAQ,EAAI,MAAM,KAAK,GAChC,AAAI,EAAY,CAAI,KAAG,EAAI,QAAQ,IAAI,CAAI;EAG7C,KAAK,IAAM,KAAQ,EAAI,WAAW,KAAK,GACrC,AAAI,EAAY,CAAI,KAAG,EAAI,QAAQ,IAAI,CAAI;EAG7C,EAAI,cAAc;CACpB;CAEA,SAAS,IAAyB;EAChC,EAAI,kBAAkB;EAEtB,KAAK,IAAM,KAAQ,CAAC,GAAG,EAAI,OAAO,GAChC,AAAI,EAAY,CAAI,KAAG,EAAI,QAAQ,OAAO,CAAI;EAGhD,EAAI,cAAc;CACpB;CAEA,SAAS,IAAoB;EAC3B,EAAI,kBAAkB;EAEtB,KAAK,IAAM,KAAO,CAAC,GAAG,EAAI,MAAM,KAAK,CAAC,GAC/B,EAAY,CAAG,MAEpB,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;EAGxD,EAAI,cAAc;CACpB;CAEA,SAAS,EAAc,GAA2C;EAChE,EAAI,kBAAkB;EAEtB,KAAK,IAAM,KAAO,CAAC,GAAG,EAAI,WAAW,KAAK,CAAC,GACzC,AAAI,EAAY,CAAG,MACjB,EAAI,WAAW,IAAI,CAAG,CAAC,EAAE,MAAM,GAC/B,EAAI,WAAW,OAAO,CAAG;EAI7B,IAAM,IAAO,EAAc,CAAoC;EAE/D,KAAK,IAAM,KAAO,CAAC,GAAG,EAAI,MAAM,KAAK,CAAC,GAC/B,EAAY,CAAG,MAEpB,EAAI,MAAM,OAAO,CAAG,GACpB,EAAI,SAAS,OAAO,CAAG,GACvB,EAAI,MAAM,OAAO,CAAG,GACpB,EAAI,QAAQ,OAAO,CAAG,GACtB,EAAI,YAAY,OAAO,CAAG;EAG5B,EAAI,iBAAiB;EAErB,KAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,CAAI,GAAG;GAC/C,IAAM,IAAO,EAAI,CAAG;GAGpB,AADA,EAAI,MAAM,IAAI,GAAM,CAAK,GACzB,EAAI,SAAS,IAAI,GAAM,CAAK;EAC9B;EAEA,EAAI,cAAc;CACpB;CAEA,SAAS,EAAY,GAAwC;EAC3D,EAAI,kBAAkB;EAEtB,IAAM,IAAO,EAAc,CAAO,GAC5B,IAAwB,CAAC;EAE/B,KAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,CAAI,GAAG;GAC/C,IAAM,IAAO,EAAI,CAAG;GAKpB,AAHA,EAAI,SAAS,IAAI,GAAM,CAAK,GAC5B,EAAI,MAAM,IAAI,GAAM,CAAK,GACzB,EAAI,MAAM,OAAO,CAAI,GACrB,EAAY,KAAK,CAAI;EACvB;EAEA,EAAI,cAAc,CAAW;CAC/B;CAEA,SAAS,EACP,GACM;EACN,EAAI,kBAAkB;EAEtB,KAAK,IAAM,KAAO,CAAC,GAAG,EAAI,YAAY,KAAK,CAAC,GAC1C,AAAI,EAAY,CAAG,KAAG,EAAI,YAAY,OAAO,CAAG;EAGlD,IAAI,QACG,IAAM,CAAC,GAAK,MAAY,OAAO,QAAQ,CAAU,GACpD,AAAI,OAAO,KAAY,YAAU,EAAI,YAAY,IAAI,EAAI,CAAG,GAAG,CAAO;EAK1E,AADA,EAAI,iBAAiB,GACrB,EAAI,cAAc;CACpB;CAEA,eAAe,EACb,GACA,GACyB;EAGzB,IAFA,EAAI,kBAAkB,GAGpB,MAAyB,KAAA,KACzB,CAAC,MAAM,QAAQ,CAAoB,KACnC,EAAE,aAAgC,cAClC;GAEA,IAAM,IAAe,EAAI,CAA8B;GAEvD,MAAM,EAAI,kBAAkB,CAAC,CAAsB,GAAG,WAAW,CAAM;GAEvE,IAAM,IAAQ,EAAI,YAAY,IAAI,CAAsB;GAExD,OAAO;IACL,QAAQ,MAAU,KAAA,IAA0D,CAAC,IAA/C,GAAG,IAAiC,EAAM;IACxE,OAAO,MAAU,KAAA;GACnB;EACF;EAEA,IAAI,MAAM,QAAQ,CAAoB,GAAG;GAEvC,IAAM,IAAiB,EAAqB,KAAK,MAAM,EAAI,CAAW,CAAC;GAEvE,MAAM,EAAI,kBAAkB,GAAgB,WAAW,CAAM;GAE7D,IAAM,IAAiC,CAAC;GAExC,KAAK,IAAM,KAAM,GAAgB;IAC/B,IAAM,IAAM,EAAI,YAAY,IAAI,CAAE;IAElC,AAAI,MAAQ,KAAA,MAAW,EAAO,EAAQ,CAAE,KAAK;GAC/C;GAEA,OAAO;IAAE;IAAQ,OAAO,OAAO,KAAK,CAAM,CAAC,CAAC,WAAW;GAAE;EAC3D;EAGA,IAAM,IAAM,GACN,IAAS,CAAC,GAAG,EAAI,WAAW,KAAK,CAAC,CAAC,CAAC,OAAO,CAAW;EAE5D,MAAM,EAAI,kBAAkB,GAAQ,WAAW,CAAG;EAElD,IAAM,IAAiC,CAAC;EAExC,KAAK,IAAM,CAAC,GAAK,MAAY,EAAI,aAC/B,AAAI,EAAY,CAAG,MAAG,EAAO,EAAQ,CAAG,KAAK;EAG/C,OAAO;GAAE;GAAQ,OAAO,OAAO,KAAK,CAAM,CAAC,CAAC,WAAW;EAAE;CAC3D;CAEA,eAAe,EACb,GACgC;EAGhC,IAFA,EAAI,kBAAkB,GAElB,EAAI,aAAa,GAAG,MAAM,IAAI,EAAiB,2DAA2D;EAE9G,EAAI,KAAK,YAAY;GAGnB,AAFA,EAAI,qBAAqB,GACzB,EAAI,cAAc,EAAI,GACtB,EAAe;EACjB,CAAC;EAED,IAAI;GACF,IAAM,IAAS,CAAC,GAAG,EAAI,WAAW,KAAK,CAAC,CAAC,CAAC,OAAO,CAAW;GAI5D,AAFA,MAAM,EAAI,kBAAkB,GAAQ,SAAS,GAE7C,EAAI,kBAAkB;GAEtB,IAAM,IAAiC,CAAC;GAExC,KAAK,IAAM,CAAC,GAAK,MAAY,EAAI,aAC/B,AAAI,EAAY,CAAG,MAAG,EAAO,EAAQ,CAAG,KAAK;GAO/C,OAJI,OAAO,KAAK,CAAM,CAAC,CAAC,SAAS,IACxB;IAAE;IAAQ,IAAI;IAAO,MAAM;GAAsB,IAGnD;IAAE,IAAI;IAAe,OAAO,MAAM,EAAQ,EAAa,CAAC;GAAE;EACnE,UAAU;GAGR,AAFA,EAAI,cAAc,EAAK,GAElB,EAAI,WAAW,KAAG,EAAI,cAAc;EAC3C;CACF;CAWA,SAAS,EAAgB,GAAsC,GAAyC;EAEtG,IAAI,IAA8B;EAElC,OAAO,EAAI,KAAK,gBAAgB;GAC9B,IAAM,IAAO,EAAe;GAG5B,IAAI,GAAW;IACb,IAAM,IAAI,GACJ,IAAU,OAAO,KAAK,EAAK,MAAM,GACjC,IAAc,OAAO,KAAK,EAAE,MAAM,GAClC,IACJ,EAAQ,WAAW,EAAY,UAAU,EAAQ,OAAO,MAAM,EAAK,OAAO,OAAO,EAAE,OAAO,EAAE,GAExF,IACJ,EAAK,cAAc,WAAW,EAAE,cAAc,UAC9C,EAAK,cAAc,OAAO,GAAG,MAAM,MAAM,EAAE,cAAc,EAAE,GAEvD,IACJ,EAAK,iBAAiB,WAAW,EAAE,iBAAiB,UACpD,EAAK,iBAAiB,OAAO,GAAG,MAAM,MAAM,EAAE,iBAAiB,EAAE;IAWnE,IARE,EAAK,YAAY,EAAE,WACnB,EAAK,cAAc,EAAE,aACrB,EAAK,iBAAiB,EAAE,gBACxB,EAAK,cAAc,EAAE,aACrB,EAAK,YAAY,EAAE,WACnB,EAAK,iBAAiB,EAAE,gBACxB,EAAK,gBAAgB,EAAE,eAEP,KAAe,KAAgB,GAAiB;GACpE;GAGA,AADA,IAAY,GACZ,EAAS,CAAI;EACf,GAAG,CAAO;CACZ;CAEA,SAAS,IAAsB;EAC7B,OAAO;GACL,MAAM,GAA0B;IAC9B,OAAO,EAAI,KAAK,MAAM,EAAI,CAAI,CAAuB;GACvD;GACA,WAAW,GAAoB;IAC7B,EAAI,KAAK,WAAW,EAAI,CAAI,CAAwB;GACtD;GACA,QAAQ,GAAc,GAAoD;IACxE,OAAO,EAAI,KAAK,QAAQ,EAAI,CAAI,GAAyB,CAAM;GACjE;GACA,MAAM,GAAmC;IACvC,OAAO,EAAI,KAAK,MAAM,EAAI,CAAI,CAAuB;GACvD;GACA,IAAI,GAAuB;IACzB,OAAO,EAAI,KAAK,IAAI,EAAI,CAAI,CAAuB;GACrD;GACA,SAAS,GAAc,GAAsD;IAC3E,OAAO,EAAI,KAAK,OAAO,SACrB,EAAI,CAAI,GACR,CACF;GACF;GACA,OAAO,GAAoB;IACzB,EAAI,KAAK,OAAO,OAAO,EAAI,CAAI,CAAuB;GACxD;GACA,WAAW,GAAoB;IAC7B,EAAI,KAAK,WAAW,EAAI,CAAI,CAAuB;GACrD;GACA,IAAI,GAAc,GAAgB,GAA4B;IAC5D,EAAI,KAAK,IAAI,EAAI,CAAI,GAAyB,GAAkD,CAAO;GACzG;GACA,SAAS,GAAc,GAAuB;IAC5C,EAAI,KAAK,SAAS,EAAI,CAAI,GAA0B,CAAO;GAC7D;GACA,aAAa,GAAc,GAAkC;IAC3D,EAAI,KAAK,OAAO,aAAa,EAAI,CAAI,GAAyB,CAAS;GACzE;GACA,eACE,GACA,GACA,GACa;IACb,OAAO,EAAI,KAAK,eACd,EAAI,CAAI,GACR,GACA,CACF;GACF;GACA,MAAM,GAAoB;IACxB,EAAI,KAAK,MAAM,EAAI,CAAI,CAAuB;GAChD;GACA,QAAQ,GAAoB;IAC1B,EAAI,KAAK,QAAQ,EAAI,CAAI,CAAuB;GAClD;EACF;CACF;CAMA,IAAM,IAAU,EAAoB;CAEpC,OAAO;EACL,QAAQ,MACN,EAAQ,MAAM,CAAc;EAG9B,QAAQ,MAAO,EAAI,KAAK,MAAM,CAAE;EAChC,aAAa,MAAS,EAAQ,WAAW,CAAc;EACvD,UAAU,GAAM,MAAY,EAAQ,QAAQ,GAAgB,CAAM;EAClE,IAAI,iBAAiB;GACnB,OAAO,EAAI,KAAK;EAClB;EACA,eAAe,CAEf;EACA,IAAI,WAAW;GACb,OAAO,EAAI,WAAW;EACxB;EACA,QAAQ,MAAS,EAAQ,MAAM,CAAc;EAC7C,QAAQ;GACN,MAAM;GACN,WAAW,GAAM,MAAa,EAAQ,SAAS,GAAgB,CAAwC;GACvG,SAAS,MAAS,EAAQ,OAAO,CAAc;GAC/C,eAAe,GAAM,MAAe,EAAQ,aAAa,GAAgB,CAAS;EACpF;EACA,MAAM,MAAS,EAAQ,IAAI,CAAc;EACzC,IAAI,YAAY;GACd,OAAO,EAAI,KAAK;EAClB;EACA,IAAI,eAAe;GACjB,OAAO,EAAI,KAAK;EAClB;EACA,OAAO;EACP,SAAS;EACT,OAAO;EACP,aAAa;EACb,aAAa,MAAS,EAAQ,WAAW,CAAc;EAGvD,UAAU,MAAS,EAAI,KAAK,QAAQ,CAA6B;EACjE,QAAQ,MAAc,EAAiB,GAAK,EAAI,CAAmB,CAAC;EACpE,MAAM,GAAM,GAAO,MAAyB,EAAQ,IAAI,GAAgB,GAAO,CAAO;EACtF,WAAW,GAAM,MAAY,EAAQ,SAAS,GAAgB,CAAO;EAGrE,gBAAgB,EAAI,KAAK,SAAS;EAClC,IAAI,QAAQ;GACV,OAAO,EAAe;EACxB;EACA,QAAQ;EACR,eAAe,OAAO,MAAY;GAChC,IAAM,IAAS,MAAM,EAAa,CAAO;GAEzC,IAAI,CAAC,EAAO,IAAI,MAAM,IAAI,EAAqB,EAAO,MAAgC;GAEtF,OAAO,EAAO;EAChB;EACA,YAAY,GAAU,MAAa,EAAI,KAAK,UAAU,GAAU,CAAO;EACvE,iBAAiB,GAAM,GAAU,MAC/B,EAAQ,eAAe,GAAgB,GAAkD,CAAO;EAClG;GACC,OAAO,sBAAsB,EAAI,KAAK,OAAO,cAAc,CAAC;EAC7D,CAAC,OAAO,WAAW;GACjB,KAAK,QAAQ;EACf;EACA,QAAQ,MAAS,EAAQ,MAAM,CAAc;EAC7C,UAAU;EACV,UAAU,MAAS,EAAQ,QAAQ,CAAc;EACjD,YAAY;EACZ,UAAU;EACV,eAAe,GAAS;GACtB,IAAM,IAAW,EAAI,KAAK,eAAe,CAAM;GAqB/C,OAAO;IAlBL,MAAM,OAAO;KACX,SAAS;MACP,IAAM,IAAO,MAAM,EAAS,KAAK;MAEjC,IAAI,EAAK,MAAM,OAAO;MAEtB,IAAI,EAAY,EAAK,MAAM,KAAK,GAC9B,OAAO;OAAE,MAAM;OAAO,OAAO;QAAE,OAAO,EAAK,MAAM;QAAO,OAAO,EAAQ,EAAK,MAAM,KAAK;OAAE;MAAE;KAC/F;IACF;IACA,SAAS;KACP,OAAO,EAAS,SAAS,EAAS,OAAO,IAAI,QAAQ,QAAQ;MAAE,MAAM;MAAe,OAAO,KAAA;KAAU,CAAC;IACxG;IACA,CAAC,OAAO,iBAAiB;KACvB,OAAO;IACT;GAGK;EACT;EACA,QAAQ;CACV;AACF"}
+{"version":3,"file":"scope.js","names":[],"sources":["../../src/core/scope.ts"],"sourcesContent":["import type {\n  ArrayField,\n  ConnectOptions,\n  ConnectionResult,\n  ErrorKeyOf,\n  FieldState,\n  FieldValidator,\n  FlatKeyOf,\n  Form,\n  FormSnapshot,\n  FormState,\n  MaybePromise,\n  RegisterFieldOptions,\n  ScopedValues,\n  SetOptions,\n  SubmitResult,\n  SubscribeOptions,\n  TypeAtPath,\n  Unsubscribe,\n  ValidateResult,\n} from '../types';\nimport type { FormContext } from './context';\nimport type { FieldOps } from './fields';\n\nimport { flattenValues, unflattenValues } from '../_utils';\nimport { ForgeSubmitError, ForgeValidationError } from '../errors';\n\n/**\n * Everything a scoped sub-form needs from its parent. Deliberately just three members —\n * `ctx` (the same `FormContext` the root form's own ops read/write, not a copy of its\n * fields) and a narrow slice of `fieldOps`'s predicate-based bulk primitives\n * (`reset`/`replace`/`patch`/`touchAll`/`untouchAll`/`resetErrors`'s shared implementations,\n * plus `runValidationCore`). Bulk scoped operations call these with an `isScopedKey`\n * predicate instead of maintaining a second copy of each loop.\n * @internal\n */\nexport interface ScopeContext<TValues extends Record<string, unknown> = Record<string, unknown>> {\n  ctx: FormContext<TValues>;\n  fieldOps: Pick<\n    FieldOps<TValues>,\n    | 'patchKeys'\n    | 'replaceKeys'\n    | 'resetErrorsKeys'\n    | 'resetKeys'\n    | 'runValidationCore'\n    | 'touchAllKeys'\n    | 'untouchAllKeys'\n  >;\n  /** The fully-featured root form — used for all simple one-field delegations. */\n  root: Form<TValues>;\n}\n\n/**\n * Creates a scoped sub-form whose field paths are relative to `pfx`.\n * All simple single-field operations delegate to `scopeCtx.root`. Bulk operations\n * (reset, replace, patch, touchAll, untouchAll, resetErrors) call `scopeCtx.fieldOps`'s\n * shared predicate-based primitives with an `isScopedKey` filter. Only `validate`/`submit`\n * (which need to compute a scoped field-name subset before calling `runValidationCore`) and\n * the handful of read-only projections (`state`, `values`, `fields.list`) contain custom code.\n */\nexport function createScopedForm<TValues extends Record<string, unknown>, P extends string>(\n  scopeCtx: ScopeContext<TValues>,\n  pfx: P,\n): Form<ScopedValues<TValues, P>> {\n  const { ctx, fieldOps, root } = scopeCtx;\n  const pfxDot = `${pfx}.`;\n\n  function pre(name: string): string {\n    return `${pfx}.${name}`;\n  }\n\n  function isScopedKey(key: string): boolean {\n    return key === pfx || key.startsWith(pfxDot);\n  }\n\n  function unscope(key: string): string {\n    return key.startsWith(pfxDot) ? key.slice(pfxDot.length) : key;\n  }\n\n  /* ---- Non-trivial scoped implementations ---- */\n\n  /**\n   * Compute a scoped projection of FormState from current raw Maps.\n   * Errors, touchedFields, validatingFields, isValid, isDirty, isTouched reflect only\n   * fields within the prefix. isSubmitting, isLoading, isValidating, submitCount are full-form.\n   */\n  function getScopedState(): FormState {\n    const rootState = ctx.getStateSnapshot();\n    const errors = Object.fromEntries(\n      Object.entries(rootState.errors)\n        .filter(([k]) => isScopedKey(k))\n        .map(([k, v]) => [unscope(k), v]),\n    );\n    const touchedFields = rootState.touchedFields.filter(isScopedKey).map(unscope);\n    const validatingFields = rootState.validatingFields.filter(isScopedKey).map(unscope);\n    const isValid = Object.keys(errors).length === 0;\n    const isDirty = [...ctx.dirty].some(isScopedKey);\n    const isTouched = [...ctx.touched].some(isScopedKey);\n    const isValidating = validatingFields.length > 0;\n\n    return Object.freeze({\n      errors: Object.freeze(errors) as FormState['errors'],\n      isDirty,\n      isLoading: rootState.isLoading,\n      isSubmitting: rootState.isSubmitting,\n      isTouched,\n      isValid,\n      isValidating,\n      submitCount: rootState.submitCount,\n      touchedFields: Object.freeze(touchedFields) as readonly string[],\n      validatingFields: Object.freeze(validatingFields) as readonly string[],\n    });\n  }\n\n  function scopedValues(): ScopedValues<TValues, P> {\n    const sub: Record<string, unknown> = {};\n\n    for (const [key, value] of ctx.store) {\n      if (key.startsWith(pfxDot)) sub[key.slice(pfxDot.length)] = value;\n    }\n\n    return unflattenValues(sub) as ScopedValues<TValues, P>;\n  }\n\n  /**\n   * Enumerate field paths within this scope's prefix, stripped to relative paths —\n   * matching `scope.state`'s relative-path convention, not `state.touchedFields`'s\n   * absolute-path convention. Same \"known field\" definition `scopedTouchAll()` uses.\n   */\n  function scopedListFields(): readonly string[] {\n    const known = new Set<string>();\n\n    for (const key of ctx.store.keys()) {\n      if (isScopedKey(key)) known.add(unscope(key));\n    }\n\n    for (const key of ctx.validators.keys()) {\n      if (isScopedKey(key)) known.add(unscope(key));\n    }\n\n    return Object.freeze([...known]);\n  }\n\n  function scopedTouchAll(): void {\n    ctx.ensureNotDisposed('touchAll');\n    fieldOps.touchAllKeys(isScopedKey);\n    ctx.requestNotify();\n  }\n\n  function scopedUntouchAll(): void {\n    ctx.ensureNotDisposed('untouchAll');\n    fieldOps.untouchAllKeys(isScopedKey);\n    ctx.requestNotify();\n  }\n\n  function scopedReset(): void {\n    ctx.ensureNotDisposed('reset');\n    fieldOps.resetKeys(isScopedKey);\n    ctx.requestNotify();\n  }\n\n  function scopedReplace(newValues: ScopedValues<TValues, P>): void {\n    ctx.ensureNotDisposed('replace');\n    fieldOps.replaceKeys(isScopedKey, flattenValues(newValues as Record<string, unknown>), pre);\n    ctx.requestNotify();\n  }\n\n  function scopedPatch(partial: Record<string, unknown>): void {\n    ctx.ensureNotDisposed('patch');\n    ctx.requestNotify(fieldOps.patchKeys(partial, pre));\n  }\n\n  function scopedResetErrors(\n    nextErrors?: Partial<Record<ErrorKeyOf<ScopedValues<TValues, P>>, string | undefined>>,\n  ): void {\n    ctx.ensureNotDisposed('resetErrors');\n    fieldOps.resetErrorsKeys(isScopedKey, nextErrors ?? {}, pre);\n    ctx.requestNotify();\n  }\n\n  async function scopedValidate(\n    nameOrFieldsOrSignal?: FlatKeyOf<ScopedValues<TValues, P>> | FlatKeyOf<ScopedValues<TValues, P>>[] | AbortSignal,\n    signal?: AbortSignal,\n  ): Promise<ValidateResult> {\n    ctx.ensureNotDisposed('validate');\n\n    if (\n      nameOrFieldsOrSignal !== undefined &&\n      !Array.isArray(nameOrFieldsOrSignal) &&\n      !(nameOrFieldsOrSignal instanceof AbortSignal)\n    ) {\n      // validate(name) — single field\n      const prefixedName = pre(nameOrFieldsOrSignal as string) as FlatKeyOf<TValues>;\n\n      await fieldOps.runValidationCore([prefixedName as string], 'partial', signal);\n\n      const error = ctx.fieldErrors.get(prefixedName as string);\n\n      return {\n        errors: error !== undefined ? { [nameOrFieldsOrSignal as string]: error } : {},\n        valid: error === undefined,\n      };\n    }\n\n    if (Array.isArray(nameOrFieldsOrSignal)) {\n      // validate(fields[]) — specific subset\n      const prefixedFields = nameOrFieldsOrSignal.map((f) => pre(f as string)) as string[];\n\n      await fieldOps.runValidationCore(prefixedFields, 'partial', signal);\n\n      const errors: Record<string, string> = {};\n\n      for (const pf of prefixedFields) {\n        const msg = ctx.fieldErrors.get(pf);\n\n        if (msg !== undefined) errors[unscope(pf)] = msg;\n      }\n\n      return { errors, valid: Object.keys(errors).length === 0 };\n    }\n\n    // validate(signal?) — all scoped fields\n    const sig = nameOrFieldsOrSignal as AbortSignal | undefined;\n    const fields = [...ctx.validators.keys()].filter(isScopedKey);\n\n    await fieldOps.runValidationCore(fields, 'partial', sig);\n\n    const errors: Record<string, string> = {};\n\n    for (const [key, message] of ctx.fieldErrors) {\n      if (isScopedKey(key)) errors[unscope(key)] = message;\n    }\n\n    return { errors, valid: Object.keys(errors).length === 0 };\n  }\n\n  async function scopedSubmit<TResult>(\n    handler: (values: ScopedValues<TValues, P>) => 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      scopedTouchAll();\n    });\n\n    try {\n      const fields = [...ctx.validators.keys()].filter(isScopedKey);\n\n      await fieldOps.runValidationCore(fields, 'partial');\n\n      ctx.ensureNotDisposed('submit');\n\n      const errors: Record<string, string> = {};\n\n      for (const [key, message] of ctx.fieldErrors) {\n        if (isScopedKey(key)) errors[unscope(key)] = message;\n      }\n\n      if (Object.keys(errors).length > 0) {\n        return { errors, ok: false, type: 'validation' as const };\n      }\n\n      return { ok: true as const, value: await handler(scopedValues()) };\n    } finally {\n      ctx.isSubmittingState = false;\n\n      if (!ctx.disposed) ctx.requestNotify();\n    }\n  }\n\n  /**\n   * Subscribe filtered to scoped fields only — this scoped form's `subscribe()` implementation.\n   * Errors, touchedFields, and validatingFields are remapped to relative paths.\n   * `isValid`, `isDirty`, and `isTouched` reflect only fields within this scope's prefix.\n   * `isSubmitting`, `isLoading`, `isValidating`, and `submitCount` reflect the full form.\n   *\n   * The listener fires only when the scoped projection changes — mutations outside this\n   * prefix do not fire the listener.\n   */\n  function scopedSubscribe(listener: (state: FormState) => void, options?: SubscribeOptions): Unsubscribe {\n    // Track the previous scoped projection for equality comparison.\n    let prevState: FormState | null = null;\n\n    return root.subscribe(() => {\n      const next = getScopedState();\n\n      // Skip if no scoped-relevant state has changed.\n      if (prevState) {\n        const p = prevState;\n        const errKeys = Object.keys(next.errors);\n        const prevErrKeys = Object.keys(p.errors);\n        const errorsMatch =\n          errKeys.length === prevErrKeys.length && errKeys.every((k) => next.errors[k] === p.errors[k]);\n\n        const touchedMatch =\n          next.touchedFields.length === p.touchedFields.length &&\n          next.touchedFields.every((v, i) => v === p.touchedFields[i]);\n\n        const validatingMatch =\n          next.validatingFields.length === p.validatingFields.length &&\n          next.validatingFields.every((v, i) => v === p.validatingFields[i]);\n\n        const flagsMatch =\n          next.isDirty === p.isDirty &&\n          next.isLoading === p.isLoading &&\n          next.isSubmitting === p.isSubmitting &&\n          next.isTouched === p.isTouched &&\n          next.isValid === p.isValid &&\n          next.isValidating === p.isValidating &&\n          next.submitCount === p.submitCount;\n\n        if (flagsMatch && errorsMatch && touchedMatch && validatingMatch) return;\n      }\n\n      prevState = next;\n      listener(next);\n    }, options);\n  }\n\n  function createScopedAdapter() {\n    return {\n      array(name: string): ArrayField {\n        return root.array(pre(name) as FlatKeyOf<TValues>) as ArrayField;\n      },\n      clearError(name: string): void {\n        root.clearError(pre(name) as ErrorKeyOf<TValues>);\n      },\n      connect(name: string, config?: ConnectOptions): ConnectionResult<unknown> {\n        return root.connect(pre(name) as FlatKeyOf<TValues>, config) as ConnectionResult<unknown>;\n      },\n      field(name: string): FieldState<unknown> {\n        return root.field(pre(name) as FlatKeyOf<TValues>) as FieldState<unknown>;\n      },\n      get(name: string): unknown {\n        return root.get(pre(name) as FlatKeyOf<TValues>);\n      },\n      register(name: string, options?: RegisterFieldOptions<unknown>): Unsubscribe {\n        return root.fields.register(\n          pre(name) as FlatKeyOf<TValues>,\n          options as RegisterFieldOptions<TypeAtPath<TValues, FlatKeyOf<TValues>>>,\n        );\n      },\n      remove(name: string): void {\n        root.fields.remove(pre(name) as FlatKeyOf<TValues>);\n      },\n      resetField(name: string): void {\n        root.resetField(pre(name) as FlatKeyOf<TValues>);\n      },\n      set(name: string, value: unknown, options?: SetOptions): void {\n        root.set(pre(name) as FlatKeyOf<TValues>, value as TypeAtPath<TValues, FlatKeyOf<TValues>>, options);\n      },\n      setError(name: string, message: string): void {\n        root.setError(pre(name) as ErrorKeyOf<TValues>, message);\n      },\n      setValidator(name: string, validator?: FieldValidator): void {\n        root.fields.setValidator(pre(name) as FlatKeyOf<TValues>, validator);\n      },\n      subscribeField(\n        name: string,\n        listener: (state: FieldState<unknown>) => void,\n        options?: SubscribeOptions,\n      ): Unsubscribe {\n        return root.subscribeField(\n          pre(name) as FlatKeyOf<TValues>,\n          listener as (state: FieldState<TypeAtPath<TValues, FlatKeyOf<TValues>>>) => void,\n          options,\n        );\n      },\n      touch(name: string): void {\n        root.touch(pre(name) as FlatKeyOf<TValues>);\n      },\n      untouch(name: string): void {\n        root.untouch(pre(name) as FlatKeyOf<TValues>);\n      },\n    };\n  }\n\n  /* ---- Public scoped form object ---- */\n\n  type S = ScopedValues<TValues, P>;\n\n  const adapter = createScopedAdapter();\n\n  return {\n    array: (name) =>\n      adapter.array(name as string) as ArrayField<\n        TypeAtPath<S, typeof name> extends readonly (infer E)[] ? E : unknown\n      >,\n    batch: (fn) => root.batch(fn),\n    clearError: (name) => adapter.clearError(name as string),\n    connect: (name, config?) => adapter.connect(name as string, config) as ConnectionResult<TypeAtPath<S, typeof name>>,\n    get disposalSignal() {\n      return root.disposalSignal;\n    },\n    dispose: () => {\n      /* Scoped forms share lifecycle with parent — call parentForm.dispose() to tear down */\n    },\n    get disposed() {\n      return ctx.disposed;\n    },\n    field: (name) => adapter.field(name as string) as FieldState<TypeAtPath<S, typeof name>>,\n    fields: {\n      list: scopedListFields,\n      register: (name, options?) => adapter.register(name as string, options as RegisterFieldOptions<unknown>),\n      remove: (name) => adapter.remove(name as string),\n      setValidator: (name, validator?) => adapter.setValidator(name as string, validator),\n    },\n    get: (name) => adapter.get(name as string) as TypeAtPath<S, typeof name>,\n    history: {\n      // Casts are irreducible: FormSnapshot<S> and FormSnapshot<TValues> are structurally\n      // unrelated generic instantiations -- TS cannot verify one against the other.\n      restore: (snap) => root.history.restore(snap as FormSnapshot<TValues>),\n      snapshot: () => root.history.snapshot() as FormSnapshot<S>,\n    },\n    get isLoading() {\n      return root.isLoading;\n    },\n    get isSubmitting() {\n      return root.isSubmitting;\n    },\n    patch: scopedPatch as Form<S>['patch'],\n    replace: scopedReplace as Form<S>['replace'],\n    reset: scopedReset,\n    resetErrors: scopedResetErrors as Form<S>['resetErrors'],\n    resetField: (name) => adapter.resetField(name as string),\n    scope: (subPrefix) =>\n      createScopedForm(scopeCtx, pre(subPrefix as string)) as Form<ScopedValues<S, typeof subPrefix>>,\n    set: (name, value, options?: SetOptions) => adapter.set(name as string, value, options),\n    setError: (name, message) => adapter.setError(name as string, message),\n    get state() {\n      return getScopedState();\n    },\n    submit: scopedSubmit as Form<S>['submit'],\n    submitOrThrow: async (handler) => {\n      const result = await scopedSubmit(handler);\n\n      if (!result.ok) throw new ForgeValidationError(result.errors as Record<string, string>);\n\n      return result.value;\n    },\n    // Scoped forms filter+remap; on a root form this method is the unfiltered notifier pass-through.\n    subscribe: scopedSubscribe,\n    subscribeField: (name, listener, options?) =>\n      adapter.subscribeField(name as string, listener as (state: FieldState<unknown>) => void, options),\n    [Symbol.asyncIterator]: () => root[Symbol.asyncIterator](),\n    [Symbol.dispose]() {\n      this.dispose();\n    },\n    touch: (name) => adapter.touch(name as string),\n    touchAll: scopedTouchAll,\n    untouch: (name) => adapter.untouch(name as string),\n    untouchAll: scopedUntouchAll,\n    validate: scopedValidate as Form<S>['validate'],\n    values: scopedValues,\n  };\n}\n"],"mappings":";;;AA4DA,SAAgB,EACd,GACA,GACgC;CAChC,IAAM,EAAE,QAAK,aAAU,YAAS,GAC1B,IAAS,GAAG,EAAI;CAEtB,SAAS,EAAI,GAAsB;EACjC,OAAO,GAAG,EAAI,GAAG;CACnB;CAEA,SAAS,EAAY,GAAsB;EACzC,OAAO,MAAQ,KAAO,EAAI,WAAW,CAAM;CAC7C;CAEA,SAAS,EAAQ,GAAqB;EACpC,OAAO,EAAI,WAAW,CAAM,IAAI,EAAI,MAAM,EAAO,MAAM,IAAI;CAC7D;CASA,SAAS,IAA4B;EACnC,IAAM,IAAY,EAAI,iBAAiB,GACjC,IAAS,OAAO,YACpB,OAAO,QAAQ,EAAU,MAAM,CAAC,CAC7B,QAAQ,CAAC,OAAO,EAAY,CAAC,CAAC,CAAC,CAC/B,KAAK,CAAC,GAAG,OAAO,CAAC,EAAQ,CAAC,GAAG,CAAC,CAAC,CACpC,GACM,IAAgB,EAAU,cAAc,OAAO,CAAW,CAAC,CAAC,IAAI,CAAO,GACvE,IAAmB,EAAU,iBAAiB,OAAO,CAAW,CAAC,CAAC,IAAI,CAAO,GAC7E,IAAU,OAAO,KAAK,CAAM,CAAC,CAAC,WAAW,GACzC,IAAU,CAAC,GAAG,EAAI,KAAK,CAAC,CAAC,KAAK,CAAW,GACzC,IAAY,CAAC,GAAG,EAAI,OAAO,CAAC,CAAC,KAAK,CAAW,GAC7C,IAAe,EAAiB,SAAS;EAE/C,OAAO,OAAO,OAAO;GACnB,QAAQ,OAAO,OAAO,CAAM;GAC5B;GACA,WAAW,EAAU;GACrB,cAAc,EAAU;GACxB;GACA;GACA;GACA,aAAa,EAAU;GACvB,eAAe,OAAO,OAAO,CAAa;GAC1C,kBAAkB,OAAO,OAAO,CAAgB;EAClD,CAAC;CACH;CAEA,SAAS,IAAyC;EAChD,IAAM,IAA+B,CAAC;EAEtC,KAAK,IAAM,CAAC,GAAK,MAAU,EAAI,OAC7B,AAAI,EAAI,WAAW,CAAM,MAAG,EAAI,EAAI,MAAM,EAAO,MAAM,KAAK;EAG9D,OAAO,EAAgB,CAAG;CAC5B;CAOA,SAAS,IAAsC;EAC7C,IAAM,oBAAQ,IAAI,IAAY;EAE9B,KAAK,IAAM,KAAO,EAAI,MAAM,KAAK,GAC/B,AAAI,EAAY,CAAG,KAAG,EAAM,IAAI,EAAQ,CAAG,CAAC;EAG9C,KAAK,IAAM,KAAO,EAAI,WAAW,KAAK,GACpC,AAAI,EAAY,CAAG,KAAG,EAAM,IAAI,EAAQ,CAAG,CAAC;EAG9C,OAAO,OAAO,OAAO,CAAC,GAAG,CAAK,CAAC;CACjC;CAEA,SAAS,IAAuB;EAG9B,AAFA,EAAI,kBAAkB,UAAU,GAChC,EAAS,aAAa,CAAW,GACjC,EAAI,cAAc;CACpB;CAEA,SAAS,IAAyB;EAGhC,AAFA,EAAI,kBAAkB,YAAY,GAClC,EAAS,eAAe,CAAW,GACnC,EAAI,cAAc;CACpB;CAEA,SAAS,IAAoB;EAG3B,AAFA,EAAI,kBAAkB,OAAO,GAC7B,EAAS,UAAU,CAAW,GAC9B,EAAI,cAAc;CACpB;CAEA,SAAS,EAAc,GAA2C;EAGhE,AAFA,EAAI,kBAAkB,SAAS,GAC/B,EAAS,YAAY,GAAa,EAAc,CAAoC,GAAG,CAAG,GAC1F,EAAI,cAAc;CACpB;CAEA,SAAS,EAAY,GAAwC;EAE3D,AADA,EAAI,kBAAkB,OAAO,GAC7B,EAAI,cAAc,EAAS,UAAU,GAAS,CAAG,CAAC;CACpD;CAEA,SAAS,EACP,GACM;EAGN,AAFA,EAAI,kBAAkB,aAAa,GACnC,EAAS,gBAAgB,GAAa,KAAc,CAAC,GAAG,CAAG,GAC3D,EAAI,cAAc;CACpB;CAEA,eAAe,EACb,GACA,GACyB;EAGzB,IAFA,EAAI,kBAAkB,UAAU,GAG9B,MAAyB,KAAA,KACzB,CAAC,MAAM,QAAQ,CAAoB,KACnC,EAAE,aAAgC,cAClC;GAEA,IAAM,IAAe,EAAI,CAA8B;GAEvD,MAAM,EAAS,kBAAkB,CAAC,CAAsB,GAAG,WAAW,CAAM;GAE5E,IAAM,IAAQ,EAAI,YAAY,IAAI,CAAsB;GAExD,OAAO;IACL,QAAQ,MAAU,KAAA,IAA0D,CAAC,IAA/C,GAAG,IAAiC,EAAM;IACxE,OAAO,MAAU,KAAA;GACnB;EACF;EAEA,IAAI,MAAM,QAAQ,CAAoB,GAAG;GAEvC,IAAM,IAAiB,EAAqB,KAAK,MAAM,EAAI,CAAW,CAAC;GAEvE,MAAM,EAAS,kBAAkB,GAAgB,WAAW,CAAM;GAElE,IAAM,IAAiC,CAAC;GAExC,KAAK,IAAM,KAAM,GAAgB;IAC/B,IAAM,IAAM,EAAI,YAAY,IAAI,CAAE;IAElC,AAAI,MAAQ,KAAA,MAAW,EAAO,EAAQ,CAAE,KAAK;GAC/C;GAEA,OAAO;IAAE;IAAQ,OAAO,OAAO,KAAK,CAAM,CAAC,CAAC,WAAW;GAAE;EAC3D;EAGA,IAAM,IAAM,GACN,IAAS,CAAC,GAAG,EAAI,WAAW,KAAK,CAAC,CAAC,CAAC,OAAO,CAAW;EAE5D,MAAM,EAAS,kBAAkB,GAAQ,WAAW,CAAG;EAEvD,IAAM,IAAiC,CAAC;EAExC,KAAK,IAAM,CAAC,GAAK,MAAY,EAAI,aAC/B,AAAI,EAAY,CAAG,MAAG,EAAO,EAAQ,CAAG,KAAK;EAG/C,OAAO;GAAE;GAAQ,OAAO,OAAO,KAAK,CAAM,CAAC,CAAC,WAAW;EAAE;CAC3D;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,EAAe;EACjB,CAAC;EAED,IAAI;GACF,IAAM,IAAS,CAAC,GAAG,EAAI,WAAW,KAAK,CAAC,CAAC,CAAC,OAAO,CAAW;GAI5D,AAFA,MAAM,EAAS,kBAAkB,GAAQ,SAAS,GAElD,EAAI,kBAAkB,QAAQ;GAE9B,IAAM,IAAiC,CAAC;GAExC,KAAK,IAAM,CAAC,GAAK,MAAY,EAAI,aAC/B,AAAI,EAAY,CAAG,MAAG,EAAO,EAAQ,CAAG,KAAK;GAO/C,OAJI,OAAO,KAAK,CAAM,CAAC,CAAC,SAAS,IACxB;IAAE;IAAQ,IAAI;IAAO,MAAM;GAAsB,IAGnD;IAAE,IAAI;IAAe,OAAO,MAAM,EAAQ,EAAa,CAAC;GAAE;EACnE,UAAU;GAGR,AAFA,EAAI,oBAAoB,IAEnB,EAAI,YAAU,EAAI,cAAc;EACvC;CACF;CAWA,SAAS,EAAgB,GAAsC,GAAyC;EAEtG,IAAI,IAA8B;EAElC,OAAO,EAAK,gBAAgB;GAC1B,IAAM,IAAO,EAAe;GAG5B,IAAI,GAAW;IACb,IAAM,IAAI,GACJ,IAAU,OAAO,KAAK,EAAK,MAAM,GACjC,IAAc,OAAO,KAAK,EAAE,MAAM,GAClC,IACJ,EAAQ,WAAW,EAAY,UAAU,EAAQ,OAAO,MAAM,EAAK,OAAO,OAAO,EAAE,OAAO,EAAE,GAExF,IACJ,EAAK,cAAc,WAAW,EAAE,cAAc,UAC9C,EAAK,cAAc,OAAO,GAAG,MAAM,MAAM,EAAE,cAAc,EAAE,GAEvD,IACJ,EAAK,iBAAiB,WAAW,EAAE,iBAAiB,UACpD,EAAK,iBAAiB,OAAO,GAAG,MAAM,MAAM,EAAE,iBAAiB,EAAE;IAWnE,IARE,EAAK,YAAY,EAAE,WACnB,EAAK,cAAc,EAAE,aACrB,EAAK,iBAAiB,EAAE,gBACxB,EAAK,cAAc,EAAE,aACrB,EAAK,YAAY,EAAE,WACnB,EAAK,iBAAiB,EAAE,gBACxB,EAAK,gBAAgB,EAAE,eAEP,KAAe,KAAgB,GAAiB;GACpE;GAGA,AADA,IAAY,GACZ,EAAS,CAAI;EACf,GAAG,CAAO;CACZ;CAEA,SAAS,IAAsB;EAC7B,OAAO;GACL,MAAM,GAA0B;IAC9B,OAAO,EAAK,MAAM,EAAI,CAAI,CAAuB;GACnD;GACA,WAAW,GAAoB;IAC7B,EAAK,WAAW,EAAI,CAAI,CAAwB;GAClD;GACA,QAAQ,GAAc,GAAoD;IACxE,OAAO,EAAK,QAAQ,EAAI,CAAI,GAAyB,CAAM;GAC7D;GACA,MAAM,GAAmC;IACvC,OAAO,EAAK,MAAM,EAAI,CAAI,CAAuB;GACnD;GACA,IAAI,GAAuB;IACzB,OAAO,EAAK,IAAI,EAAI,CAAI,CAAuB;GACjD;GACA,SAAS,GAAc,GAAsD;IAC3E,OAAO,EAAK,OAAO,SACjB,EAAI,CAAI,GACR,CACF;GACF;GACA,OAAO,GAAoB;IACzB,EAAK,OAAO,OAAO,EAAI,CAAI,CAAuB;GACpD;GACA,WAAW,GAAoB;IAC7B,EAAK,WAAW,EAAI,CAAI,CAAuB;GACjD;GACA,IAAI,GAAc,GAAgB,GAA4B;IAC5D,EAAK,IAAI,EAAI,CAAI,GAAyB,GAAkD,CAAO;GACrG;GACA,SAAS,GAAc,GAAuB;IAC5C,EAAK,SAAS,EAAI,CAAI,GAA0B,CAAO;GACzD;GACA,aAAa,GAAc,GAAkC;IAC3D,EAAK,OAAO,aAAa,EAAI,CAAI,GAAyB,CAAS;GACrE;GACA,eACE,GACA,GACA,GACa;IACb,OAAO,EAAK,eACV,EAAI,CAAI,GACR,GACA,CACF;GACF;GACA,MAAM,GAAoB;IACxB,EAAK,MAAM,EAAI,CAAI,CAAuB;GAC5C;GACA,QAAQ,GAAoB;IAC1B,EAAK,QAAQ,EAAI,CAAI,CAAuB;GAC9C;EACF;CACF;CAMA,IAAM,IAAU,EAAoB;CAEpC,OAAO;EACL,QAAQ,MACN,EAAQ,MAAM,CAAc;EAG9B,QAAQ,MAAO,EAAK,MAAM,CAAE;EAC5B,aAAa,MAAS,EAAQ,WAAW,CAAc;EACvD,UAAU,GAAM,MAAY,EAAQ,QAAQ,GAAgB,CAAM;EAClE,IAAI,iBAAiB;GACnB,OAAO,EAAK;EACd;EACA,eAAe,CAEf;EACA,IAAI,WAAW;GACb,OAAO,EAAI;EACb;EACA,QAAQ,MAAS,EAAQ,MAAM,CAAc;EAC7C,QAAQ;GACN,MAAM;GACN,WAAW,GAAM,MAAa,EAAQ,SAAS,GAAgB,CAAwC;GACvG,SAAS,MAAS,EAAQ,OAAO,CAAc;GAC/C,eAAe,GAAM,MAAe,EAAQ,aAAa,GAAgB,CAAS;EACpF;EACA,MAAM,MAAS,EAAQ,IAAI,CAAc;EACzC,SAAS;GAGP,UAAU,MAAS,EAAK,QAAQ,QAAQ,CAA6B;GACrE,gBAAgB,EAAK,QAAQ,SAAS;EACxC;EACA,IAAI,YAAY;GACd,OAAO,EAAK;EACd;EACA,IAAI,eAAe;GACjB,OAAO,EAAK;EACd;EACA,OAAO;EACP,SAAS;EACT,OAAO;EACP,aAAa;EACb,aAAa,MAAS,EAAQ,WAAW,CAAc;EACvD,QAAQ,MACN,EAAiB,GAAU,EAAI,CAAmB,CAAC;EACrD,MAAM,GAAM,GAAO,MAAyB,EAAQ,IAAI,GAAgB,GAAO,CAAO;EACtF,WAAW,GAAM,MAAY,EAAQ,SAAS,GAAgB,CAAO;EACrE,IAAI,QAAQ;GACV,OAAO,EAAe;EACxB;EACA,QAAQ;EACR,eAAe,OAAO,MAAY;GAChC,IAAM,IAAS,MAAM,EAAa,CAAO;GAEzC,IAAI,CAAC,EAAO,IAAI,MAAM,IAAI,EAAqB,EAAO,MAAgC;GAEtF,OAAO,EAAO;EAChB;EAEA,WAAW;EACX,iBAAiB,GAAM,GAAU,MAC/B,EAAQ,eAAe,GAAgB,GAAkD,CAAO;GACjG,OAAO,sBAAsB,EAAK,OAAO,cAAc,CAAC;EACzD,CAAC,OAAO,WAAW;GACjB,KAAK,QAAQ;EACf;EACA,QAAQ,MAAS,EAAQ,MAAM,CAAc;EAC7C,UAAU;EACV,UAAU,MAAS,EAAQ,QAAQ,CAAc;EACjD,YAAY;EACZ,UAAU;EACV,QAAQ;CACV;AACF"}

package/dist/errors.cjs

@@ -1,2 +1,2 @@
-var e=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},t=class extends e{constructor(){super(`Cannot modify a disposed form`)}},n=class extends e{},r=class extends e{},i=class extends e{errors;constructor(e){super(`Form validation failed`),this.errors=e}};exports.ForgeConfigError=n,exports.ForgeDisposedError=t,exports.ForgeError=e,exports.ForgeSubmitError=r,exports.ForgeValidationError=i;
+var e=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},t=class extends e{constructor(e){super(e?`Cannot call ${e}() on a disposed form`:`Cannot modify a disposed form`)}},n=class extends e{},r=class extends e{},i=class extends e{errors;constructor(e){super(`Form validation failed`),this.errors=e}};exports.ForgeConfigError=n,exports.ForgeDisposedError=t,exports.ForgeError=e,exports.ForgeSubmitError=r,exports.ForgeValidationError=i;
 //# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */\nexport class ForgeError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is ForgeError {\n    return err instanceof ForgeError;\n  }\n}\n\n/** Thrown when any method is called on a disposed form. */\nexport class ForgeDisposedError extends ForgeError {\n  constructor() {\n    super('Cannot modify a disposed form');\n  }\n}\n\n/** Thrown when a form key contains reserved prototype-polluting segments. */\nexport class ForgeConfigError extends ForgeError {}\n\n/** Thrown when `submit()` is called while a submission is already in progress. */\nexport class ForgeSubmitError extends ForgeError {}\n\n/** Thrown by `submitOrThrow()` when validation fails. */\nexport class ForgeValidationError extends ForgeError {\n  readonly errors: Record<string, string>;\n\n  constructor(errors: Record<string, string>) {\n    super('Form validation failed');\n    this.errors = errors;\n  }\n}\n"],"mappings":"AACA,IAAa,EAAb,MAAa,UAAmB,KAAM,CACpC,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAO,IAAI,OAAO,KACvB,OAAO,eAAe,KAAM,IAAI,OAAO,SAAS,CAClD,CAEA,OAAO,GAAG,EAAiC,CACzC,OAAO,aAAe,CACxB,CACF,EAGa,EAAb,cAAwC,CAAW,CACjD,aAAc,CACZ,MAAM,+BAA+B,CACvC,CACF,EAGa,EAAb,cAAsC,CAAW,CAAC,EAGrC,EAAb,cAAsC,CAAW,CAAC,EAGrC,EAAb,cAA0C,CAAW,CACnD,OAEA,YAAY,EAAgC,CAC1C,MAAM,wBAAwB,EAC9B,KAAK,OAAS,CAChB,CACF"}
+{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */\nexport class ForgeError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is ForgeError {\n    return err instanceof ForgeError;\n  }\n}\n\n/** Thrown when any method is called on a disposed form. */\nexport class ForgeDisposedError extends ForgeError {\n  /** @param op The public method name that was called (e.g. `'set'`) — included in the\n   * message so a stack trace tells you *what* to guard, not just *that* it's disposed. */\n  constructor(op?: string) {\n    super(op ? `Cannot call ${op}() on a disposed form` : 'Cannot modify a disposed form');\n  }\n}\n\n/** Thrown when a form key contains reserved prototype-polluting segments. */\nexport class ForgeConfigError extends ForgeError {}\n\n/** Thrown when `submit()` is called while a submission is already in progress. */\nexport class ForgeSubmitError extends ForgeError {}\n\n/** Thrown by `submitOrThrow()` when validation fails. */\nexport class ForgeValidationError extends ForgeError {\n  readonly errors: Record<string, string>;\n\n  constructor(errors: Record<string, string>) {\n    super('Form validation failed');\n    this.errors = errors;\n  }\n}\n"],"mappings":"AACA,IAAa,EAAb,MAAa,UAAmB,KAAM,CACpC,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAO,IAAI,OAAO,KACvB,OAAO,eAAe,KAAM,IAAI,OAAO,SAAS,CAClD,CAEA,OAAO,GAAG,EAAiC,CACzC,OAAO,aAAe,CACxB,CACF,EAGa,EAAb,cAAwC,CAAW,CAGjD,YAAY,EAAa,CACvB,MAAM,EAAK,eAAe,EAAG,uBAAyB,+BAA+B,CACvF,CACF,EAGa,EAAb,cAAsC,CAAW,CAAC,EAGrC,EAAb,cAAsC,CAAW,CAAC,EAGrC,EAAb,cAA0C,CAAW,CACnD,OAEA,YAAY,EAAgC,CAC1C,MAAM,wBAAwB,EAC9B,KAAK,OAAS,CAChB,CACF"}

package/dist/errors.d.ts

@@ -5,7 +5,9 @@ export declare class ForgeError extends Error {
 }
 /** Thrown when any method is called on a disposed form. */
 export declare class ForgeDisposedError extends ForgeError {
-    constructor();
+    /** @param op The public method name that was called (e.g. `'set'`) — included in the
+     * message so a stack trace tells you *what* to guard, not just *that* it's disposed. */
+    constructor(op?: string);
 }
 /** Thrown when a form key contains reserved prototype-polluting segments. */
 export declare class ForgeConfigError extends ForgeError {

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;IAMhD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU;CAG3C;AAED,2DAA2D;AAC3D,qBAAa,kBAAmB,SAAQ,UAAU;;CAIjD;AAED,6EAA6E;AAC7E,qBAAa,gBAAiB,SAAQ,UAAU;CAAG;AAEnD,kFAAkF;AAClF,qBAAa,gBAAiB,SAAQ,UAAU;CAAG;AAEnD,yDAAyD;AACzD,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAE5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAI3C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;IAMhD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU;CAG3C;AAED,2DAA2D;AAC3D,qBAAa,kBAAmB,SAAQ,UAAU;IAChD;4FACwF;gBAC5E,EAAE,CAAC,EAAE,MAAM;CAGxB;AAED,6EAA6E;AAC7E,qBAAa,gBAAiB,SAAQ,UAAU;CAAG;AAEnD,kFAAkF;AAClF,qBAAa,gBAAiB,SAAQ,UAAU;CAAG;AAEnD,yDAAyD;AACzD,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAE5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAI3C"}

package/dist/errors.js

@@ -7,8 +7,8 @@ var e = class e extends Error {
 		return t instanceof e;
 	}
 }, t = class extends e {
-	constructor() {
-		super("Cannot modify a disposed form");
+	constructor(e) {
+		super(e ? `Cannot call ${e}() on a disposed form` : "Cannot modify a disposed form");
 	}
 }, n = class extends e {}, r = class extends e {}, i = class extends e {
 	errors;

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */\nexport class ForgeError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is ForgeError {\n    return err instanceof ForgeError;\n  }\n}\n\n/** Thrown when any method is called on a disposed form. */\nexport class ForgeDisposedError extends ForgeError {\n  constructor() {\n    super('Cannot modify a disposed form');\n  }\n}\n\n/** Thrown when a form key contains reserved prototype-polluting segments. */\nexport class ForgeConfigError extends ForgeError {}\n\n/** Thrown when `submit()` is called while a submission is already in progress. */\nexport class ForgeSubmitError extends ForgeError {}\n\n/** Thrown by `submitOrThrow()` when validation fails. */\nexport class ForgeValidationError extends ForgeError {\n  readonly errors: Record<string, string>;\n\n  constructor(errors: Record<string, string>) {\n    super('Form validation failed');\n    this.errors = errors;\n  }\n}\n"],"mappings":";AACA,IAAa,IAAb,MAAa,UAAmB,MAAM;CACpC,YAAY,GAAiB,GAAqB;EAGhD,AAFA,MAAM,GAAS,CAAI,GACnB,KAAK,OAAO,IAAI,OAAO,MACvB,OAAO,eAAe,MAAM,IAAI,OAAO,SAAS;CAClD;CAEA,OAAO,GAAG,GAAiC;EACzC,OAAO,aAAe;CACxB;AACF,GAGa,IAAb,cAAwC,EAAW;CACjD,cAAc;EACZ,MAAM,+BAA+B;CACvC;AACF,GAGa,IAAb,cAAsC,EAAW,CAAC,GAGrC,IAAb,cAAsC,EAAW,CAAC,GAGrC,IAAb,cAA0C,EAAW;CACnD;CAEA,YAAY,GAAgC;EAE1C,AADA,MAAM,wBAAwB,GAC9B,KAAK,SAAS;CAChB;AACF"}
+{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */\nexport class ForgeError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is ForgeError {\n    return err instanceof ForgeError;\n  }\n}\n\n/** Thrown when any method is called on a disposed form. */\nexport class ForgeDisposedError extends ForgeError {\n  /** @param op The public method name that was called (e.g. `'set'`) — included in the\n   * message so a stack trace tells you *what* to guard, not just *that* it's disposed. */\n  constructor(op?: string) {\n    super(op ? `Cannot call ${op}() on a disposed form` : 'Cannot modify a disposed form');\n  }\n}\n\n/** Thrown when a form key contains reserved prototype-polluting segments. */\nexport class ForgeConfigError extends ForgeError {}\n\n/** Thrown when `submit()` is called while a submission is already in progress. */\nexport class ForgeSubmitError extends ForgeError {}\n\n/** Thrown by `submitOrThrow()` when validation fails. */\nexport class ForgeValidationError extends ForgeError {\n  readonly errors: Record<string, string>;\n\n  constructor(errors: Record<string, string>) {\n    super('Form validation failed');\n    this.errors = errors;\n  }\n}\n"],"mappings":";AACA,IAAa,IAAb,MAAa,UAAmB,MAAM;CACpC,YAAY,GAAiB,GAAqB;EAGhD,AAFA,MAAM,GAAS,CAAI,GACnB,KAAK,OAAO,IAAI,OAAO,MACvB,OAAO,eAAe,MAAM,IAAI,OAAO,SAAS;CAClD;CAEA,OAAO,GAAG,GAAiC;EACzC,OAAO,aAAe;CACxB;AACF,GAGa,IAAb,cAAwC,EAAW;CAGjD,YAAY,GAAa;EACvB,MAAM,IAAK,eAAe,EAAG,yBAAyB,+BAA+B;CACvF;AACF,GAGa,IAAb,cAAsC,EAAW,CAAC,GAGrC,IAAb,cAAsC,EAAW,CAAC,GAGrC,IAAb,cAA0C,EAAW;CACnD;CAEA,YAAY,GAAgC;EAE1C,AADA,MAAM,wBAAwB,GAC9B,KAAK,SAAS;CAChB;AACF"}