@vielzeug/forge 2.3.1 → 3.0.0

package/dist/form.js

@@ -1,13 +1,31 @@
 import { ForgeConfigError as e, ForgeDisposedError as t, ForgeSubmitError as n, ForgeValidationError as r } from "./errors.js";
-import { assertSafeKey as i, immutable as a, isRecord as o, normalizeErrors as s, resetAtPath as c, touchAll as l, writeAtPath as u, writeMeta as d } from "./core/path.js";
+import { assertSafeKey as i, immutable as a, isRecord as o, readAtPath as s, resetAtPath as c, touchAll as l, writeAtPath as u, writeMeta as d } from "./core/path.js";
 import { createField as f } from "./_field.js";
 import { createNotifier as p } from "./_notify.js";
+import { abortable as m } from "@vielzeug/arsenal";
 //#region src/form.ts
-function m(e) {
+function h(t) {
+	if (t !== void 0 && t.length !== 0) return Object.freeze(t.map((t) => {
+		if (!t || typeof t.message != "string" || !Array.isArray(t.path)) throw new e("Validators must return issues with a string message and array path.");
+		let n = t.path.map((t) => {
+			if (typeof t == "number") {
+				if (!Number.isSafeInteger(t) || t < 0) throw new e(`Invalid issue path index ${t}.`);
+				return t;
+			}
+			if (typeof t == "string") return i(t), t;
+			throw new e("Issue paths may contain only string keys and non-negative integer indexes.");
+		});
+		return Object.freeze({
+			message: t.message,
+			path: Object.freeze(n)
+		});
+	}));
+}
+function g(e) {
 	return Object.freeze({
-		errors: e.errors,
-		formError: e.formError,
-		hasErrors: e.formError !== void 0 || e.errors !== void 0,
+		formError: e.issues?.find((e) => e.path.length === 0)?.message,
+		hasErrors: (e.issues?.length ?? 0) > 0,
+		issues: e.issues,
 		submitCount: e.submitCount,
 		submitting: e.isSubmitting,
 		touched: Object.keys(e.touched).length > 0,
@@ -15,34 +33,41 @@ function m(e) {
 		validity: e.validity
 	});
 }
-function h(h) {
-	let g = a(h.initialValues), _ = p(h.onSubscriberError), v = new AbortController(), y = !1, b, x = {
-		baseline: g,
-		errors: void 0,
-		formError: void 0,
+function _(_) {
+	let v = a(_.initialValues), y = p(_.onSubscriberError), b = new AbortController(), x = !1, S = !1, C = [], w, T = 0, E, D = {
+		baseline: v,
 		isSubmitting: !1,
+		issues: void 0,
 		isValidating: !1,
 		submitCount: 0,
 		touched: {},
 		validity: "unknown",
-		value: g
-	};
-	function S(e) {
-		if (y) throw new t(e);
+		value: v
+	}, O = g(D);
+	function k(e) {
+		if (x) throw new t(e);
 	}
-	function C(e) {
-		x = Object.freeze(e(x)), _.notify();
+	function A(e) {
+		if (C.push(e), !S) {
+			S = !0;
+			try {
+				for (; C.length > 0;) D = Object.freeze(C.shift()(D)), O = g(D), y.notify(D);
+			} finally {
+				S = !1;
+			}
+		}
 	}
-	function w() {
-		b?.abort();
+	function j() {
+		w?.abort();
 	}
-	let T = {
-		abortValidation: w,
-		addListener: _.add,
-		ensureActive: S,
-		readState: () => x,
+	let M = {
+		abortValidation: j,
+		addListener: y.add,
+		ensureActive: k,
+		invokeListener: y.call,
+		readState: () => D,
 		resetValue(e) {
-			C((t) => ({
+			A((t) => (T++, E = void 0, {
 				...t,
 				touched: d(t.touched, e, !1),
 				validity: "unknown",
@@ -50,138 +75,149 @@ function h(h) {
 			}));
 		},
 		setTouched(e, t) {
-			C((n) => ({
+			A((n) => ({
 				...n,
 				touched: d(n.touched, e, t)
 			}));
 		},
 		setValue(e, t) {
-			C((n) => ({
-				...n,
-				validity: "unknown",
-				value: u(n.value, e, t)
-			}));
+			A((n) => {
+				let r = s(n.value, e), i = typeof t == "function" ? t(r) : t;
+				return T++, E = void 0, {
+					...n,
+					validity: "unknown",
+					value: u(n.value, e, i)
+				};
+			});
 		}
 	};
-	async function E(e) {
-		S("validate"), w();
+	async function N(e) {
+		k("validate"), j();
 		let t = new AbortController(), n = e ? AbortSignal.any([t.signal, e]) : t.signal;
-		b = t, C((e) => ({
+		if (n.aborted) return Object.freeze({ status: "aborted" });
+		let i = D.value, a = T;
+		w = t, E = void 0, A((e) => ({
 			...e,
 			isValidating: !0
 		}));
 		try {
-			let e = h.validate ? await h.validate(x.value, n) : void 0;
-			if (n.aborted || b !== t) return Object.freeze({ status: "aborted" });
-			let r = e?.fields ? s(a(e.fields)) : void 0, i = e?.formError, o = r === void 0 && i === void 0 ? "valid" : "invalid";
-			return C((e) => ({
+			if (n.aborted || T !== a) return Object.freeze({ status: "aborted" });
+			let e = _.validate ? await m(Promise.resolve(_.validate(i, n)), n) : void 0;
+			if (n.aborted || w !== t || T !== a) return Object.freeze({ status: "aborted" });
+			let r = h(e), o = r === void 0 ? "valid" : "invalid";
+			return w = void 0, A((e) => ({
 				...e,
-				errors: r,
-				formError: i,
+				issues: r,
+				isValidating: !1,
 				validity: o
-			})), Object.freeze(o === "valid" ? { status: "valid" } : {
-				errors: r,
-				formError: i,
+			})), n.aborted || T !== a || w !== void 0 ? Object.freeze({ status: "aborted" }) : (E = o === "valid" ? {
+				revision: T,
+				value: i
+			} : void 0, Object.freeze(o === "valid" ? { status: "valid" } : {
+				issues: r,
 				status: "invalid"
-			});
+			}));
 		} catch (e) {
-			if (n.aborted || b !== t) return Object.freeze({ status: "aborted" });
+			if (n.aborted || w !== t) return Object.freeze({ status: "aborted" });
 			throw new r("Form validation failed.", { cause: e });
 		} finally {
-			b === t && (b = void 0, y || C((e) => ({
+			w === t && (w = void 0, x || A((e) => ({
 				...e,
 				isValidating: !1
 			})));
 		}
 	}
-	let D = {
+	let P = {
 		get disposalSignal() {
-			return v.signal;
+			return b.signal;
 		},
 		dispose() {
-			y || (y = !0, v.abort(), w(), _.clear());
+			x || (x = !0, C.length = 0, E = void 0, b.abort(), j(), y.clear());
 		},
 		get disposed() {
-			return y;
+			return x;
 		},
 		field(t) {
-			if (i(t), !o(x.value)) throw new e("Form value must be an object.");
-			return f([t], T);
+			if (i(t), !o(D.value)) throw new e("Form value must be an object.");
+			return f([t], M);
 		},
 		reset(e) {
-			S("reset"), w();
-			let t = e === void 0 ? x.baseline : a(e);
-			C((e) => ({
-				...e,
-				baseline: t,
-				errors: void 0,
-				formError: void 0,
-				touched: {},
-				validity: "unknown",
-				value: t
-			}));
+			k("reset"), j();
+			let t = e === void 0 ? void 0 : a(e);
+			A((e) => {
+				let n = t ?? e.baseline;
+				return T++, E = void 0, {
+					...e,
+					baseline: n,
+					issues: void 0,
+					touched: {},
+					validity: "unknown",
+					value: n
+				};
+			});
 		},
 		set(e) {
-			S("set"), w();
-			let t = typeof e == "function" ? e(D.value) : e;
-			C((e) => ({
-				...e,
-				errors: void 0,
-				formError: void 0,
-				validity: "unknown",
-				value: a(t)
-			}));
+			k("set"), j(), A((t) => {
+				let n = typeof e == "function" ? e(t.value) : e;
+				return T++, E = void 0, {
+					...t,
+					issues: void 0,
+					validity: "unknown",
+					value: a(n)
+				};
+			});
 		},
 		get state() {
-			return m(x);
+			return O;
 		},
 		async submit(e, t) {
-			if (S("submit"), x.isSubmitting) throw new n("submit() called while a submission is already in progress");
-			let r = t ? AbortSignal.any([v.signal, t]) : v.signal;
-			C((e) => ({
+			if (k("submit"), D.isSubmitting) throw new n("submit() called while a submission is already in progress");
+			let r = t ? AbortSignal.any([b.signal, t]) : b.signal;
+			A((e) => ({
 				...e,
 				isSubmitting: !0,
 				submitCount: e.submitCount + 1,
 				touched: l(e.value)
 			}));
 			try {
-				let n = await E(t);
+				let n = await N(t);
 				if (n.status === "aborted") return Object.freeze({ status: "aborted" });
 				if (n.status === "invalid") return Object.freeze({
-					errors: n.errors,
-					formError: n.formError,
+					issues: n.issues,
 					status: "invalid"
 				});
+				let i = E;
+				if (!i || i.revision !== T || r.aborted) return Object.freeze({ status: "aborted" });
 				try {
 					return Object.freeze({
 						status: "ok",
-						value: await e(D.value, r)
+						value: await e(i.value, r)
 					});
 				} catch (e) {
 					if (r.aborted) return Object.freeze({ status: "aborted" });
 					throw e;
 				}
 			} finally {
-				y || C((e) => ({
+				x || A((e) => ({
 					...e,
 					isSubmitting: !1
 				}));
 			}
 		},
 		subscribe(e, t = {}) {
-			return S("subscribe"), t.immediate && e(m(x)), _.add(() => e(m(x)));
+			return k("subscribe"), t.immediate && y.call(() => e(O)), y.add(() => e(O));
 		},
 		[Symbol.dispose]() {
-			D.dispose();
+			P.dispose();
 		},
-		validate: E,
+		validate: N,
 		get value() {
-			return x.value;
+			return D.value;
 		}
 	};
-	return D;
+	return P;
 }
 //#endregion
-export { h as createForm };
+export { _ as createForm };
 
 //# sourceMappingURL=form.js.map

package/dist/form.js.map

@@ -1 +1 @@
-{"version":3,"file":"form.js","names":[],"sources":["../src/form.ts"],"sourcesContent":["import { createField, type FieldAccess } from './_field';\nimport { createNotifier } from './_notify';\nimport {\n  assertSafeKey,\n  immutable,\n  isRecord,\n  type MetaRoot,\n  normalizeErrors,\n  resetAtPath,\n  touchAll,\n  writeAtPath,\n  writeMeta,\n} from './core/path';\nimport { ForgeConfigError, ForgeDisposedError, ForgeSubmitError, ForgeValidationError } from './errors';\nimport type {\n  Form,\n  FormErrors,\n  FormOptions,\n  FormState,\n  MaybePromise,\n  ReadonlyDeep,\n  SubmitResult,\n  Unsubscribe,\n  ValidationErrors,\n  ValidationResult,\n} from './types';\n\ntype Validity = 'invalid' | 'unknown' | 'valid';\n\ntype InternalState<TValues extends Record<string, unknown>> = Readonly<{\n  baseline: TValues;\n  errors: FormErrors<TValues> | undefined;\n  formError: string | undefined;\n  isSubmitting: boolean;\n  isValidating: boolean;\n  submitCount: number;\n  touched: MetaRoot;\n  validity: Validity;\n  value: TValues;\n}>;\n\nfunction makeFormState<TValues extends Record<string, unknown>>(current: InternalState<TValues>): FormState<TValues> {\n  return Object.freeze({\n    errors: current.errors,\n    formError: current.formError,\n    hasErrors: current.formError !== undefined || current.errors !== undefined,\n    submitCount: current.submitCount,\n    submitting: current.isSubmitting,\n    touched: Object.keys(current.touched).length > 0,\n    validating: current.isValidating,\n    validity: current.validity,\n  });\n}\n\n/** One immutable value tree and one explicit full-form validator keep form behavior locally understandable. */\nexport function createForm<TValues extends Record<string, unknown>>(options: FormOptions<TValues>): Form<TValues> {\n  const initial = immutable(options.initialValues);\n  const notifier = createNotifier(options.onSubscriberError);\n  const disposalController = new AbortController();\n  let disposed = false;\n  let validationController: AbortController | undefined;\n  let current: InternalState<TValues> = {\n    baseline: initial,\n    errors: undefined,\n    formError: undefined,\n    isSubmitting: false,\n    isValidating: false,\n    submitCount: 0,\n    touched: {},\n    validity: 'unknown',\n    value: initial,\n  };\n\n  function ensureActive(operation: string): void {\n    if (disposed) throw new ForgeDisposedError(operation);\n  }\n\n  function write(update: (current: InternalState<TValues>) => InternalState<TValues>): void {\n    current = Object.freeze(update(current));\n    notifier.notify();\n  }\n\n  function abortValidation(): void {\n    validationController?.abort();\n  }\n\n  const access: FieldAccess = {\n    abortValidation,\n    addListener: notifier.add,\n    ensureActive,\n    readState: () => current,\n    resetValue(path) {\n      write((c) => ({\n        ...c,\n        touched: writeMeta(c.touched, path, false),\n        validity: 'unknown',\n        value: resetAtPath(c.value, c.baseline, path),\n      }));\n    },\n    setTouched(path, touched) {\n      write((c) => ({ ...c, touched: writeMeta(c.touched, path, touched) }));\n    },\n    setValue(path, next) {\n      write((c) => ({\n        ...c,\n        validity: 'unknown',\n        value: writeAtPath(c.value, path, next),\n      }));\n    },\n  };\n\n  async function validate(externalSignal?: AbortSignal): Promise<ValidationResult<TValues>> {\n    ensureActive('validate');\n    abortValidation();\n\n    const controller = new AbortController();\n    const signal = externalSignal ? AbortSignal.any([controller.signal, externalSignal]) : controller.signal;\n\n    validationController = controller;\n    write((c) => ({ ...c, isValidating: true }));\n\n    try {\n      const result: ValidationErrors<TValues> | undefined = options.validate\n        ? await options.validate(current.value as ReadonlyDeep<TValues>, signal)\n        : undefined;\n\n      if (signal.aborted || validationController !== controller) return Object.freeze({ status: 'aborted' });\n\n      const errors = result?.fields\n        ? (normalizeErrors(immutable(result.fields)) as FormErrors<TValues> | undefined)\n        : undefined;\n      const formError = result?.formError;\n      const validity: Validity = errors === undefined && formError === undefined ? 'valid' : 'invalid';\n\n      write((c) => ({ ...c, errors, formError, validity }));\n\n      return validity === 'valid'\n        ? Object.freeze({ status: 'valid' })\n        : Object.freeze({ errors, formError, status: 'invalid' });\n    } catch (error) {\n      if (signal.aborted || validationController !== controller) return Object.freeze({ status: 'aborted' });\n\n      throw new ForgeValidationError('Form validation failed.', { cause: error });\n    } finally {\n      if (validationController === controller) {\n        validationController = undefined;\n\n        if (!disposed) write((c) => ({ ...c, isValidating: false }));\n      }\n    }\n  }\n\n  const form: Form<TValues> = {\n    get disposalSignal() {\n      return disposalController.signal;\n    },\n    dispose() {\n      if (disposed) return;\n\n      disposed = true;\n      disposalController.abort();\n      abortValidation();\n      notifier.clear();\n    },\n    get disposed() {\n      return disposed;\n    },\n    field(key) {\n      assertSafeKey(key);\n      if (!isRecord(current.value)) throw new ForgeConfigError('Form value must be an object.');\n\n      return createField<TValues[typeof key]>([key], access);\n    },\n    reset(next) {\n      ensureActive('reset');\n      abortValidation();\n\n      const baseline = next === undefined ? current.baseline : immutable(next);\n\n      write((c) => ({\n        ...c,\n        baseline,\n        errors: undefined,\n        formError: undefined,\n        touched: {},\n        validity: 'unknown',\n        value: baseline,\n      }));\n    },\n    set(next) {\n      ensureActive('set');\n      abortValidation();\n\n      const value =\n        typeof next === 'function' ? (next as (current: ReadonlyDeep<TValues>) => TValues)(form.value) : next;\n\n      write((c) => ({ ...c, errors: undefined, formError: undefined, validity: 'unknown', value: immutable(value) }));\n    },\n    get state() {\n      return makeFormState(current);\n    },\n    async submit<TResult = void>(\n      handler: (values: ReadonlyDeep<TValues>, signal: AbortSignal) => MaybePromise<TResult>,\n      externalSignal?: AbortSignal,\n    ): Promise<SubmitResult<TResult, TValues>> {\n      ensureActive('submit');\n\n      if (current.isSubmitting) {\n        throw new ForgeSubmitError('submit() called while a submission is already in progress');\n      }\n\n      const signal = externalSignal\n        ? AbortSignal.any([disposalController.signal, externalSignal])\n        : disposalController.signal;\n\n      write((c) => ({\n        ...c,\n        isSubmitting: true,\n        submitCount: c.submitCount + 1,\n        touched: touchAll(c.value),\n      }));\n\n      try {\n        const result = await validate(externalSignal);\n\n        if (result.status === 'aborted') return Object.freeze({ status: 'aborted' });\n\n        if (result.status === 'invalid') {\n          return Object.freeze({ errors: result.errors, formError: result.formError, status: 'invalid' });\n        }\n\n        try {\n          return Object.freeze({ status: 'ok', value: await handler(form.value, signal) });\n        } catch (error) {\n          if (signal.aborted) return Object.freeze({ status: 'aborted' });\n\n          throw error;\n        }\n      } finally {\n        if (!disposed) write((c) => ({ ...c, isSubmitting: false }));\n      }\n    },\n    subscribe(listener, subscribeOptions = {}): Unsubscribe {\n      ensureActive('subscribe');\n\n      if (subscribeOptions.immediate) listener(makeFormState(current));\n\n      return notifier.add(() => listener(makeFormState(current)));\n    },\n    [Symbol.dispose]() {\n      form.dispose();\n    },\n    validate,\n    get value() {\n      return current.value as ReadonlyDeep<TValues>;\n    },\n  };\n\n  return form;\n}\n"],"mappings":"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"}
+{"version":3,"file":"form.js","names":[],"sources":["../src/form.ts"],"sourcesContent":["import { abortable } from '@vielzeug/arsenal';\n\nimport { createField, type FieldAccess } from './_field.js';\nimport { createNotifier } from './_notify.js';\nimport {\n  assertSafeKey,\n  immutable,\n  isRecord,\n  type MetaRoot,\n  readAtPath,\n  resetAtPath,\n  touchAll,\n  writeAtPath,\n  writeMeta,\n} from './core/path.js';\nimport { ForgeConfigError, ForgeDisposedError, ForgeSubmitError, ForgeValidationError } from './errors.js';\nimport type {\n  Form,\n  FormOptions,\n  FormState,\n  FormValidator,\n  MaybePromise,\n  SubmitResult,\n  Unsubscribe,\n  ValidationIssue,\n  ValidationResult,\n} from './types.js';\n\ntype Validity = 'invalid' | 'unknown' | 'valid';\n\ntype InternalState<TValues extends Record<string, unknown>> = Readonly<{\n  baseline: TValues;\n  issues: readonly ValidationIssue[] | undefined;\n  isSubmitting: boolean;\n  isValidating: boolean;\n  submitCount: number;\n  touched: MetaRoot;\n  validity: Validity;\n  value: TValues;\n}>;\n\nfunction normalizeIssues(result: readonly ValidationIssue[] | undefined): readonly ValidationIssue[] | undefined {\n  if (result === undefined || result.length === 0) return undefined;\n\n  return Object.freeze(\n    result.map((issue) => {\n      if (!issue || typeof issue.message !== 'string' || !Array.isArray(issue.path)) {\n        throw new ForgeConfigError('Validators must return issues with a string message and array path.');\n      }\n\n      const path = issue.path.map((part) => {\n        if (typeof part === 'number') {\n          if (!Number.isSafeInteger(part) || part < 0) throw new ForgeConfigError(`Invalid issue path index ${part}.`);\n          return part;\n        }\n        if (typeof part === 'string') {\n          assertSafeKey(part);\n          return part;\n        }\n        throw new ForgeConfigError('Issue paths may contain only string keys and non-negative integer indexes.');\n      });\n\n      return Object.freeze({ message: issue.message, path: Object.freeze(path) });\n    }),\n  );\n}\n\nfunction makeFormState<TValues extends Record<string, unknown>>(current: InternalState<TValues>): FormState {\n  return Object.freeze({\n    formError: current.issues?.find((issue) => issue.path.length === 0)?.message,\n    hasErrors: (current.issues?.length ?? 0) > 0,\n    issues: current.issues,\n    submitCount: current.submitCount,\n    submitting: current.isSubmitting,\n    touched: Object.keys(current.touched).length > 0,\n    validating: current.isValidating,\n    validity: current.validity,\n  });\n}\n\n/** One immutable value tree and one explicit full-form validator keep form behavior locally understandable. */\nexport function createForm<TValues extends Record<string, unknown>>(options: FormOptions<TValues>): Form<TValues> {\n  const initial = immutable(options.initialValues);\n  const notifier = createNotifier<InternalState<TValues>>(options.onSubscriberError);\n  const disposalController = new AbortController();\n  let disposed = false;\n  let dispatching = false;\n  const pendingWrites: Array<(current: InternalState<TValues>) => InternalState<TValues>> = [];\n  let validationController: AbortController | undefined;\n  let revision = 0;\n  let validatedSnapshot: { revision: number; value: TValues } | undefined;\n  let current: InternalState<TValues> = {\n    baseline: initial,\n    isSubmitting: false,\n    issues: undefined,\n    isValidating: false,\n    submitCount: 0,\n    touched: {},\n    validity: 'unknown',\n    value: initial,\n  };\n  let publicState = makeFormState(current);\n\n  function ensureActive(operation: string): void {\n    if (disposed) throw new ForgeDisposedError(operation);\n  }\n\n  function write(update: (current: InternalState<TValues>) => InternalState<TValues>): void {\n    pendingWrites.push(update);\n    if (dispatching) return;\n\n    dispatching = true;\n    try {\n      while (pendingWrites.length > 0) {\n        current = Object.freeze(pendingWrites.shift()!(current));\n        publicState = makeFormState(current);\n        notifier.notify(current);\n      }\n    } finally {\n      dispatching = false;\n    }\n  }\n\n  function abortValidation(): void {\n    validationController?.abort();\n  }\n\n  const access: FieldAccess = {\n    abortValidation,\n    addListener: notifier.add,\n    ensureActive,\n    invokeListener: notifier.call,\n    readState: () => current,\n    resetValue(path) {\n      write((c) => {\n        revision++;\n        validatedSnapshot = undefined;\n        return {\n          ...c,\n          touched: writeMeta(c.touched, path, false),\n          validity: 'unknown',\n          value: resetAtPath(c.value, c.baseline, path),\n        };\n      });\n    },\n    setTouched(path, touched) {\n      write((c) => ({ ...c, touched: writeMeta(c.touched, path, touched) }));\n    },\n    setValue(path, next) {\n      write((c) => {\n        const previous = readAtPath(c.value, path);\n        const value = typeof next === 'function' ? next(previous) : next;\n        revision++;\n        validatedSnapshot = undefined;\n        return { ...c, validity: 'unknown', value: writeAtPath(c.value, path, value) };\n      });\n    },\n  };\n\n  async function validate(externalSignal?: AbortSignal): Promise<ValidationResult> {\n    ensureActive('validate');\n    abortValidation();\n\n    const controller = new AbortController();\n    const signal = externalSignal ? AbortSignal.any([controller.signal, externalSignal]) : controller.signal;\n    if (signal.aborted) return Object.freeze({ status: 'aborted' });\n\n    const snapshot = current.value;\n    const snapshotRevision = revision;\n    validationController = controller;\n    validatedSnapshot = undefined;\n    write((c) => ({ ...c, isValidating: true }));\n\n    try {\n      if (signal.aborted || revision !== snapshotRevision) return Object.freeze({ status: 'aborted' });\n      const result: readonly ValidationIssue[] | undefined = options.validate\n        ? await abortable(\n            Promise.resolve(options.validate(snapshot as Parameters<FormValidator<TValues>>[0], signal)),\n            signal,\n          )\n        : undefined;\n\n      if (signal.aborted || validationController !== controller || revision !== snapshotRevision) {\n        return Object.freeze({ status: 'aborted' });\n      }\n\n      const issues = normalizeIssues(result);\n      const validity: Validity = issues === undefined ? 'valid' : 'invalid';\n      validationController = undefined;\n      write((c) => ({ ...c, issues, isValidating: false, validity }));\n\n      if (signal.aborted || revision !== snapshotRevision || validationController !== undefined) {\n        return Object.freeze({ status: 'aborted' });\n      }\n\n      validatedSnapshot = validity === 'valid' ? { revision, value: snapshot } : undefined;\n      return validity === 'valid'\n        ? Object.freeze({ status: 'valid' })\n        : Object.freeze({ issues: issues as readonly ValidationIssue[], status: 'invalid' });\n    } catch (error) {\n      if (signal.aborted || validationController !== controller) return Object.freeze({ status: 'aborted' });\n      throw new ForgeValidationError('Form validation failed.', { cause: error });\n    } finally {\n      if (validationController === controller) {\n        validationController = undefined;\n        if (!disposed) write((c) => ({ ...c, isValidating: false }));\n      }\n    }\n  }\n\n  const form: Form<TValues> = {\n    get disposalSignal() {\n      return disposalController.signal;\n    },\n    dispose() {\n      if (disposed) return;\n\n      disposed = true;\n      pendingWrites.length = 0;\n      validatedSnapshot = undefined;\n      disposalController.abort();\n      abortValidation();\n      notifier.clear();\n    },\n    get disposed() {\n      return disposed;\n    },\n    field(key) {\n      assertSafeKey(key);\n      if (!isRecord(current.value)) throw new ForgeConfigError('Form value must be an object.');\n\n      return createField<TValues[typeof key]>([key], access);\n    },\n    reset(next) {\n      ensureActive('reset');\n      abortValidation();\n\n      const replacement = next === undefined ? undefined : immutable(next);\n      write((c) => {\n        const baseline = replacement ?? c.baseline;\n        revision++;\n        validatedSnapshot = undefined;\n        return { ...c, baseline, issues: undefined, touched: {}, validity: 'unknown', value: baseline };\n      });\n    },\n    set(next) {\n      ensureActive('set');\n      abortValidation();\n\n      write((c) => {\n        const value =\n          typeof next === 'function'\n            ? (next as (previous: Form<TValues>['value']) => TValues)(c.value as Form<TValues>['value'])\n            : next;\n        revision++;\n        validatedSnapshot = undefined;\n        return { ...c, issues: undefined, validity: 'unknown', value: immutable(value) };\n      });\n    },\n    get state() {\n      return publicState;\n    },\n    async submit<TResult = void>(\n      handler: (values: Form<TValues>['value'], signal: AbortSignal) => MaybePromise<TResult>,\n      externalSignal?: AbortSignal,\n    ): Promise<SubmitResult<TResult>> {\n      ensureActive('submit');\n\n      if (current.isSubmitting) {\n        throw new ForgeSubmitError('submit() called while a submission is already in progress');\n      }\n\n      const signal = externalSignal\n        ? AbortSignal.any([disposalController.signal, externalSignal])\n        : disposalController.signal;\n\n      write((c) => ({\n        ...c,\n        isSubmitting: true,\n        submitCount: c.submitCount + 1,\n        touched: touchAll(c.value),\n      }));\n\n      try {\n        const result = await validate(externalSignal);\n\n        if (result.status === 'aborted') return Object.freeze({ status: 'aborted' });\n\n        if (result.status === 'invalid') {\n          return Object.freeze({ issues: result.issues, status: 'invalid' });\n        }\n\n        const validated = validatedSnapshot;\n        if (!validated || validated.revision !== revision || signal.aborted) {\n          return Object.freeze({ status: 'aborted' });\n        }\n\n        try {\n          return Object.freeze({\n            status: 'ok',\n            value: await handler(validated.value as Form<TValues>['value'], signal),\n          });\n        } catch (error) {\n          if (signal.aborted) return Object.freeze({ status: 'aborted' });\n\n          throw error;\n        }\n      } finally {\n        if (!disposed) write((c) => ({ ...c, isSubmitting: false }));\n      }\n    },\n    subscribe(listener, subscribeOptions = {}): Unsubscribe {\n      ensureActive('subscribe');\n\n      if (subscribeOptions.immediate) notifier.call(() => listener(publicState));\n\n      return notifier.add(() => listener(publicState));\n    },\n    [Symbol.dispose]() {\n      form.dispose();\n    },\n    validate,\n    get value() {\n      return current.value as Form<TValues>['value'];\n    },\n  };\n\n  return form;\n}\n"],"mappings":";;;;;;AAyCA,SAAS,EAAgB,GAAwF;CAC3G,UAAW,KAAA,KAAa,EAAO,WAAW,GAE9C,OAAO,OAAO,OACZ,EAAO,KAAK,MAAU;EACpB,IAAI,CAAC,KAAS,OAAO,EAAM,WAAY,YAAY,CAAC,MAAM,QAAQ,EAAM,IAAI,GAC1E,MAAM,IAAI,EAAiB,qEAAqE;EAGlG,IAAM,IAAO,EAAM,KAAK,KAAK,MAAS;GACpC,IAAI,OAAO,KAAS,UAAU;IAC5B,IAAI,CAAC,OAAO,cAAc,CAAI,KAAK,IAAO,GAAG,MAAM,IAAI,EAAiB,4BAA4B,EAAK,EAAE;IAC3G,OAAO;GACT;GACA,IAAI,OAAO,KAAS,UAElB,OADA,EAAc,CAAI,GACX;GAET,MAAM,IAAI,EAAiB,4EAA4E;EACzG,CAAC;EAED,OAAO,OAAO,OAAO;GAAE,SAAS,EAAM;GAAS,MAAM,OAAO,OAAO,CAAI;EAAE,CAAC;CAC5E,CAAC,CACH;AACF;AAEA,SAAS,EAAuD,GAA4C;CAC1G,OAAO,OAAO,OAAO;EACnB,WAAW,EAAQ,QAAQ,MAAM,MAAU,EAAM,KAAK,WAAW,CAAC,CAAC,EAAE;EACrE,YAAY,EAAQ,QAAQ,UAAU,KAAK;EAC3C,QAAQ,EAAQ;EAChB,aAAa,EAAQ;EACrB,YAAY,EAAQ;EACpB,SAAS,OAAO,KAAK,EAAQ,OAAO,CAAC,CAAC,SAAS;EAC/C,YAAY,EAAQ;EACpB,UAAU,EAAQ;CACpB,CAAC;AACH;AAGA,SAAgB,EAAoD,GAA8C;CAChH,IAAM,IAAU,EAAU,EAAQ,aAAa,GACzC,IAAW,EAAuC,EAAQ,iBAAiB,GAC3E,IAAqB,IAAI,gBAAgB,GAC3C,IAAW,IACX,IAAc,IACZ,IAAoF,CAAC,GACvF,GACA,IAAW,GACX,GACA,IAAkC;EACpC,UAAU;EACV,cAAc;EACd,QAAQ,KAAA;EACR,cAAc;EACd,aAAa;EACb,SAAS,CAAC;EACV,UAAU;EACV,OAAO;CACT,GACI,IAAc,EAAc,CAAO;CAEvC,SAAS,EAAa,GAAyB;EAC7C,IAAI,GAAU,MAAM,IAAI,EAAmB,CAAS;CACtD;CAEA,SAAS,EAAM,GAA2E;EACxF,MAAc,KAAK,CAAM,GACrB,IAEJ;OAAc;GACd,IAAI;IACF,OAAO,EAAc,SAAS,IAG5B,AAFA,IAAU,OAAO,OAAO,EAAc,MAAM,CAAC,CAAE,CAAO,CAAC,GACvD,IAAc,EAAc,CAAO,GACnC,EAAS,OAAO,CAAO;GAE3B,UAAU;IACR,IAAc;GAChB;EATc;CAUhB;CAEA,SAAS,IAAwB;EAC/B,GAAsB,MAAM;CAC9B;CAEA,IAAM,IAAsB;EAC1B;EACA,aAAa,EAAS;EACtB;EACA,gBAAgB,EAAS;EACzB,iBAAiB;EACjB,WAAW,GAAM;GACf,GAAO,OACL,KACA,IAAoB,KAAA,GACb;IACL,GAAG;IACH,SAAS,EAAU,EAAE,SAAS,GAAM,EAAK;IACzC,UAAU;IACV,OAAO,EAAY,EAAE,OAAO,EAAE,UAAU,CAAI;GAC9C,EACD;EACH;EACA,WAAW,GAAM,GAAS;GACxB,GAAO,OAAO;IAAE,GAAG;IAAG,SAAS,EAAU,EAAE,SAAS,GAAM,CAAO;GAAE,EAAE;EACvE;EACA,SAAS,GAAM,GAAM;GACnB,GAAO,MAAM;IACX,IAAM,IAAW,EAAW,EAAE,OAAO,CAAI,GACnC,IAAQ,OAAO,KAAS,aAAa,EAAK,CAAQ,IAAI;IAG5D,OAFA,KACA,IAAoB,KAAA,GACb;KAAE,GAAG;KAAG,UAAU;KAAW,OAAO,EAAY,EAAE,OAAO,GAAM,CAAK;IAAE;GAC/E,CAAC;EACH;CACF;CAEA,eAAe,EAAS,GAAyD;EAE/E,AADA,EAAa,UAAU,GACvB,EAAgB;EAEhB,IAAM,IAAa,IAAI,gBAAgB,GACjC,IAAS,IAAiB,YAAY,IAAI,CAAC,EAAW,QAAQ,CAAc,CAAC,IAAI,EAAW;EAClG,IAAI,EAAO,SAAS,OAAO,OAAO,OAAO,EAAE,QAAQ,UAAU,CAAC;EAE9D,IAAM,IAAW,EAAQ,OACnB,IAAmB;EAGzB,AAFA,IAAuB,GACvB,IAAoB,KAAA,GACpB,GAAO,OAAO;GAAE,GAAG;GAAG,cAAc;EAAK,EAAE;EAE3C,IAAI;GACF,IAAI,EAAO,WAAW,MAAa,GAAkB,OAAO,OAAO,OAAO,EAAE,QAAQ,UAAU,CAAC;GAC/F,IAAM,IAAiD,EAAQ,WAC3D,MAAM,EACJ,QAAQ,QAAQ,EAAQ,SAAS,GAAmD,CAAM,CAAC,GAC3F,CACF,IACA,KAAA;GAEJ,IAAI,EAAO,WAAW,MAAyB,KAAc,MAAa,GACxE,OAAO,OAAO,OAAO,EAAE,QAAQ,UAAU,CAAC;GAG5C,IAAM,IAAS,EAAgB,CAAM,GAC/B,IAAqB,MAAW,KAAA,IAAY,UAAU;GAS5D,OARA,IAAuB,KAAA,GACvB,GAAO,OAAO;IAAE,GAAG;IAAG;IAAQ,cAAc;IAAO;GAAS,EAAE,GAE1D,EAAO,WAAW,MAAa,KAAoB,MAAyB,KAAA,IACvE,OAAO,OAAO,EAAE,QAAQ,UAAU,CAAC,KAG5C,IAAoB,MAAa,UAAU;IAAE;IAAU,OAAO;GAAS,IAAI,KAAA,GAEvE,OAAO,OADJ,MAAa,UACF,EAAE,QAAQ,QAAQ,IAClB;IAAU;IAAsC,QAAQ;GAAU,CAAC;EACvF,SAAS,GAAO;GACd,IAAI,EAAO,WAAW,MAAyB,GAAY,OAAO,OAAO,OAAO,EAAE,QAAQ,UAAU,CAAC;GACrG,MAAM,IAAI,EAAqB,2BAA2B,EAAE,OAAO,EAAM,CAAC;EAC5E,UAAU;GACR,AAAI,MAAyB,MAC3B,IAAuB,KAAA,GAClB,KAAU,GAAO,OAAO;IAAE,GAAG;IAAG,cAAc;GAAM,EAAE;EAE/D;CACF;CAEA,IAAM,IAAsB;EAC1B,IAAI,iBAAiB;GACnB,OAAO,EAAmB;EAC5B;EACA,UAAU;GACJ,MAEJ,IAAW,IACX,EAAc,SAAS,GACvB,IAAoB,KAAA,GACpB,EAAmB,MAAM,GACzB,EAAgB,GAChB,EAAS,MAAM;EACjB;EACA,IAAI,WAAW;GACb,OAAO;EACT;EACA,MAAM,GAAK;GAET,IADA,EAAc,CAAG,GACb,CAAC,EAAS,EAAQ,KAAK,GAAG,MAAM,IAAI,EAAiB,+BAA+B;GAExF,OAAO,EAAiC,CAAC,CAAG,GAAG,CAAM;EACvD;EACA,MAAM,GAAM;GAEV,AADA,EAAa,OAAO,GACpB,EAAgB;GAEhB,IAAM,IAAc,MAAS,KAAA,IAAY,KAAA,IAAY,EAAU,CAAI;GACnE,GAAO,MAAM;IACX,IAAM,IAAW,KAAe,EAAE;IAGlC,OAFA,KACA,IAAoB,KAAA,GACb;KAAE,GAAG;KAAG;KAAU,QAAQ,KAAA;KAAW,SAAS,CAAC;KAAG,UAAU;KAAW,OAAO;IAAS;GAChG,CAAC;EACH;EACA,IAAI,GAAM;GAIR,AAHA,EAAa,KAAK,GAClB,EAAgB,GAEhB,GAAO,MAAM;IACX,IAAM,IACJ,OAAO,KAAS,aACX,EAAuD,EAAE,KAA+B,IACzF;IAGN,OAFA,KACA,IAAoB,KAAA,GACb;KAAE,GAAG;KAAG,QAAQ,KAAA;KAAW,UAAU;KAAW,OAAO,EAAU,CAAK;IAAE;GACjF,CAAC;EACH;EACA,IAAI,QAAQ;GACV,OAAO;EACT;EACA,MAAM,OACJ,GACA,GACgC;GAGhC,IAFA,EAAa,QAAQ,GAEjB,EAAQ,cACV,MAAM,IAAI,EAAiB,2DAA2D;GAGxF,IAAM,IAAS,IACX,YAAY,IAAI,CAAC,EAAmB,QAAQ,CAAc,CAAC,IAC3D,EAAmB;GAEvB,GAAO,OAAO;IACZ,GAAG;IACH,cAAc;IACd,aAAa,EAAE,cAAc;IAC7B,SAAS,EAAS,EAAE,KAAK;GAC3B,EAAE;GAEF,IAAI;IACF,IAAM,IAAS,MAAM,EAAS,CAAc;IAE5C,IAAI,EAAO,WAAW,WAAW,OAAO,OAAO,OAAO,EAAE,QAAQ,UAAU,CAAC;IAE3E,IAAI,EAAO,WAAW,WACpB,OAAO,OAAO,OAAO;KAAE,QAAQ,EAAO;KAAQ,QAAQ;IAAU,CAAC;IAGnE,IAAM,IAAY;IAClB,IAAI,CAAC,KAAa,EAAU,aAAa,KAAY,EAAO,SAC1D,OAAO,OAAO,OAAO,EAAE,QAAQ,UAAU,CAAC;IAG5C,IAAI;KACF,OAAO,OAAO,OAAO;MACnB,QAAQ;MACR,OAAO,MAAM,EAAQ,EAAU,OAAiC,CAAM;KACxE,CAAC;IACH,SAAS,GAAO;KACd,IAAI,EAAO,SAAS,OAAO,OAAO,OAAO,EAAE,QAAQ,UAAU,CAAC;KAE9D,MAAM;IACR;GACF,UAAU;IACR,AAAK,KAAU,GAAO,OAAO;KAAE,GAAG;KAAG,cAAc;IAAM,EAAE;GAC7D;EACF;EACA,UAAU,GAAU,IAAmB,CAAC,GAAgB;GAKtD,OAJA,EAAa,WAAW,GAEpB,EAAiB,aAAW,EAAS,WAAW,EAAS,CAAW,CAAC,GAElE,EAAS,UAAU,EAAS,CAAW,CAAC;EACjD;EACA,CAAC,OAAO,WAAW;GACjB,EAAK,QAAQ;EACf;EACA;EACA,IAAI,QAAQ;GACV,OAAO,EAAQ;EACjB;CACF;CAEA,OAAO;AACT"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { ForgeConfigError, ForgeDisposedError, ForgeError, ForgeSubmitError, ForgeValidationError } from './errors';
-export { createForm } from './form';
-export * from './types';
+export { ForgeConfigError, ForgeDisposedError, ForgeError, ForgeSubmitError, ForgeValidationError } from './errors.js';
+export { createForm } from './form.js';
+export * from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACpH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,cAAc,YAAY,CAAC"}

package/dist/persist.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@vielzeug/arsenal");async function t(t,n,r,i,a,o={}){let s=o.signal?AbortSignal.any([t.disposalSignal,o.signal]):t.disposalSignal;if(s.aborted)throw(0,e.abortError)(s);let c=t.value,l=await(0,e.abortable)(n.get(r,i),s);if(l===void 0||t.value!==c)return!1;let u=a.fromRecord(l);return u===void 0||t.value!==c?!1:(t.reset(u),!0)}async function n(t,n,r,i,a={}){let o=a.signal?AbortSignal.any([t.disposalSignal,a.signal]):t.disposalSignal;if(o.aborted)throw(0,e.abortError)(o);await(0,e.abortable)(n.put(r,i.toRecord(t.value)),o)}exports.loadForm=t,exports.saveForm=n;
+//# sourceMappingURL=persist.cjs.map

package/dist/persist.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.cjs","names":[],"sources":["../src/persist.ts"],"sourcesContent":["import { abortable, abortError } from '@vielzeug/arsenal';\n\nimport type { Form } from './types.js';\n\nexport type FormDraftCodec<TValues extends Record<string, unknown>, RecordValue> = Readonly<{\n  fromRecord(record: RecordValue): TValues | undefined;\n  toRecord(values: Form<TValues>['value']): RecordValue;\n}>;\n\nexport type FormDraftStore<Table extends string, Key, RecordValue> = {\n  get(table: Table, key: Key): Promise<RecordValue | undefined>;\n  put(table: Table, value: RecordValue): Promise<void>;\n};\n\nexport type FormPersistenceOptions = Readonly<{ signal?: AbortSignal }>;\n\nexport type FormDraftWriteStore<Table extends string, RecordValue> = {\n  put(table: Table, value: RecordValue): Promise<void>;\n};\n\nexport async function loadForm<TValues extends Record<string, unknown>, Table extends string, Key, RecordValue>(\n  form: Form<TValues>,\n  store: FormDraftStore<Table, Key, RecordValue>,\n  table: Table,\n  key: Key,\n  codec: FormDraftCodec<TValues, RecordValue>,\n  options: FormPersistenceOptions = {},\n): Promise<boolean> {\n  const signal = options.signal ? AbortSignal.any([form.disposalSignal, options.signal]) : form.disposalSignal;\n  if (signal.aborted) throw abortError(signal);\n  const snapshot = form.value;\n  const record = await abortable(store.get(table, key), signal);\n  if (record === undefined || form.value !== snapshot) return false;\n\n  const values = codec.fromRecord(record);\n  if (values === undefined || form.value !== snapshot) return false;\n\n  form.reset(values);\n  return true;\n}\n\nexport async function saveForm<TValues extends Record<string, unknown>, Table extends string, RecordValue>(\n  form: Form<TValues>,\n  store: FormDraftWriteStore<Table, RecordValue>,\n  table: Table,\n  codec: FormDraftCodec<TValues, RecordValue>,\n  options: FormPersistenceOptions = {},\n): Promise<void> {\n  const signal = options.signal ? AbortSignal.any([form.disposalSignal, options.signal]) : form.disposalSignal;\n  if (signal.aborted) throw abortError(signal);\n  await abortable(store.put(table, codec.toRecord(form.value)), signal);\n}\n"],"mappings":"sGAoBA,eAAsB,EACpB,EACA,EACA,EACA,EACA,EACA,EAAkC,CAAC,EACjB,CAClB,IAAM,EAAS,EAAQ,OAAS,YAAY,IAAI,CAAC,EAAK,eAAgB,EAAQ,MAAM,CAAC,EAAI,EAAK,eAC9F,GAAI,EAAO,QAAS,MAAA,EAAM,EAAA,WAAA,CAAW,CAAM,EAC3C,IAAM,EAAW,EAAK,MAChB,EAAS,MAAA,EAAM,EAAA,UAAA,CAAU,EAAM,IAAI,EAAO,CAAG,EAAG,CAAM,EAC5D,GAAI,IAAW,IAAA,IAAa,EAAK,QAAU,EAAU,MAAO,GAE5D,IAAM,EAAS,EAAM,WAAW,CAAM,EAItC,OAHI,IAAW,IAAA,IAAa,EAAK,QAAU,EAAiB,IAE5D,EAAK,MAAM,CAAM,EACV,GACT,CAEA,eAAsB,EACpB,EACA,EACA,EACA,EACA,EAAkC,CAAC,EACpB,CACf,IAAM,EAAS,EAAQ,OAAS,YAAY,IAAI,CAAC,EAAK,eAAgB,EAAQ,MAAM,CAAC,EAAI,EAAK,eAC9F,GAAI,EAAO,QAAS,MAAA,EAAM,EAAA,WAAA,CAAW,CAAM,EAC3C,MAAA,EAAM,EAAA,UAAA,CAAU,EAAM,IAAI,EAAO,EAAM,SAAS,EAAK,KAAK,CAAC,EAAG,CAAM,CACtE"}

package/dist/persist.d.ts

@@ -0,0 +1,18 @@
+import type { Form } from './types.js';
+export type FormDraftCodec<TValues extends Record<string, unknown>, RecordValue> = Readonly<{
+    fromRecord(record: RecordValue): TValues | undefined;
+    toRecord(values: Form<TValues>['value']): RecordValue;
+}>;
+export type FormDraftStore<Table extends string, Key, RecordValue> = {
+    get(table: Table, key: Key): Promise<RecordValue | undefined>;
+    put(table: Table, value: RecordValue): Promise<void>;
+};
+export type FormPersistenceOptions = Readonly<{
+    signal?: AbortSignal;
+}>;
+export type FormDraftWriteStore<Table extends string, RecordValue> = {
+    put(table: Table, value: RecordValue): Promise<void>;
+};
+export declare function loadForm<TValues extends Record<string, unknown>, Table extends string, Key, RecordValue>(form: Form<TValues>, store: FormDraftStore<Table, Key, RecordValue>, table: Table, key: Key, codec: FormDraftCodec<TValues, RecordValue>, options?: FormPersistenceOptions): Promise<boolean>;
+export declare function saveForm<TValues extends Record<string, unknown>, Table extends string, RecordValue>(form: Form<TValues>, store: FormDraftWriteStore<Table, RecordValue>, table: Table, codec: FormDraftCodec<TValues, RecordValue>, options?: FormPersistenceOptions): Promise<void>;
+//# sourceMappingURL=persist.d.ts.map

package/dist/persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../src/persist.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,cAAc,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,IAAI,QAAQ,CAAC;IAC1F,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC;CACvD,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,CAAC,KAAK,SAAS,MAAM,EAAE,GAAG,EAAE,WAAW,IAAI;IACnE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAC9D,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC;AAExE,MAAM,MAAM,mBAAmB,CAAC,KAAK,SAAS,MAAM,EAAE,WAAW,IAAI;IACnE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD,CAAC;AAEF,wBAAsB,QAAQ,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,SAAS,MAAM,EAAE,GAAG,EAAE,WAAW,EAC5G,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EACnB,KAAK,EAAE,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,WAAW,CAAC,EAC9C,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,EAC3C,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED,wBAAsB,QAAQ,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,SAAS,MAAM,EAAE,WAAW,EACvG,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EACnB,KAAK,EAAE,mBAAmB,CAAC,KAAK,EAAE,WAAW,CAAC,EAC9C,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,EAC3C,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/persist.js

@@ -0,0 +1,19 @@
+import { abortError as e, abortable as t } from "@vielzeug/arsenal";
+//#region src/persist.ts
+async function n(n, r, i, a, o, s = {}) {
+	let c = s.signal ? AbortSignal.any([n.disposalSignal, s.signal]) : n.disposalSignal;
+	if (c.aborted) throw e(c);
+	let l = n.value, u = await t(r.get(i, a), c);
+	if (u === void 0 || n.value !== l) return !1;
+	let d = o.fromRecord(u);
+	return d === void 0 || n.value !== l ? !1 : (n.reset(d), !0);
+}
+async function r(n, r, i, a, o = {}) {
+	let s = o.signal ? AbortSignal.any([n.disposalSignal, o.signal]) : n.disposalSignal;
+	if (s.aborted) throw e(s);
+	await t(r.put(i, a.toRecord(n.value)), s);
+}
+//#endregion
+export { n as loadForm, r as saveForm };
+
+//# sourceMappingURL=persist.js.map

package/dist/persist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.js","names":[],"sources":["../src/persist.ts"],"sourcesContent":["import { abortable, abortError } from '@vielzeug/arsenal';\n\nimport type { Form } from './types.js';\n\nexport type FormDraftCodec<TValues extends Record<string, unknown>, RecordValue> = Readonly<{\n  fromRecord(record: RecordValue): TValues | undefined;\n  toRecord(values: Form<TValues>['value']): RecordValue;\n}>;\n\nexport type FormDraftStore<Table extends string, Key, RecordValue> = {\n  get(table: Table, key: Key): Promise<RecordValue | undefined>;\n  put(table: Table, value: RecordValue): Promise<void>;\n};\n\nexport type FormPersistenceOptions = Readonly<{ signal?: AbortSignal }>;\n\nexport type FormDraftWriteStore<Table extends string, RecordValue> = {\n  put(table: Table, value: RecordValue): Promise<void>;\n};\n\nexport async function loadForm<TValues extends Record<string, unknown>, Table extends string, Key, RecordValue>(\n  form: Form<TValues>,\n  store: FormDraftStore<Table, Key, RecordValue>,\n  table: Table,\n  key: Key,\n  codec: FormDraftCodec<TValues, RecordValue>,\n  options: FormPersistenceOptions = {},\n): Promise<boolean> {\n  const signal = options.signal ? AbortSignal.any([form.disposalSignal, options.signal]) : form.disposalSignal;\n  if (signal.aborted) throw abortError(signal);\n  const snapshot = form.value;\n  const record = await abortable(store.get(table, key), signal);\n  if (record === undefined || form.value !== snapshot) return false;\n\n  const values = codec.fromRecord(record);\n  if (values === undefined || form.value !== snapshot) return false;\n\n  form.reset(values);\n  return true;\n}\n\nexport async function saveForm<TValues extends Record<string, unknown>, Table extends string, RecordValue>(\n  form: Form<TValues>,\n  store: FormDraftWriteStore<Table, RecordValue>,\n  table: Table,\n  codec: FormDraftCodec<TValues, RecordValue>,\n  options: FormPersistenceOptions = {},\n): Promise<void> {\n  const signal = options.signal ? AbortSignal.any([form.disposalSignal, options.signal]) : form.disposalSignal;\n  if (signal.aborted) throw abortError(signal);\n  await abortable(store.put(table, codec.toRecord(form.value)), signal);\n}\n"],"mappings":";;AAoBA,eAAsB,EACpB,GACA,GACA,GACA,GACA,GACA,IAAkC,CAAC,GACjB;CAClB,IAAM,IAAS,EAAQ,SAAS,YAAY,IAAI,CAAC,EAAK,gBAAgB,EAAQ,MAAM,CAAC,IAAI,EAAK;CAC9F,IAAI,EAAO,SAAS,MAAM,EAAW,CAAM;CAC3C,IAAM,IAAW,EAAK,OAChB,IAAS,MAAM,EAAU,EAAM,IAAI,GAAO,CAAG,GAAG,CAAM;CAC5D,IAAI,MAAW,KAAA,KAAa,EAAK,UAAU,GAAU,OAAO;CAE5D,IAAM,IAAS,EAAM,WAAW,CAAM;CAItC,OAHI,MAAW,KAAA,KAAa,EAAK,UAAU,IAAiB,MAE5D,EAAK,MAAM,CAAM,GACV;AACT;AAEA,eAAsB,EACpB,GACA,GACA,GACA,GACA,IAAkC,CAAC,GACpB;CACf,IAAM,IAAS,EAAQ,SAAS,YAAY,IAAI,CAAC,EAAK,gBAAgB,EAAQ,MAAM,CAAC,IAAI,EAAK;CAC9F,IAAI,EAAO,SAAS,MAAM,EAAW,CAAM;CAC3C,MAAM,EAAU,EAAM,IAAI,GAAO,EAAM,SAAS,EAAK,KAAK,CAAC,GAAG,CAAM;AACtE"}

package/dist/schema.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@vielzeug/arsenal");var t=e=>{let t=[];for(let n of e??[]){let e=typeof n==`object`&&n&&`key`in n?n.key:n;if(typeof e==`string`)t.push(e);else if(typeof e==`number`&&Number.isSafeInteger(e)&&e>=0)t.push(e);else return[]}return t};function n(n){return async(r,i)=>{if(i.aborted)return;let a=await(0,e.abortable)(Promise.resolve(n[`~standard`].validate(r)),i);if(!(i.aborted||`value`in a))return a.issues.map(e=>({message:e.message,path:t(e.path)}))}}exports.schemaValidator=n;
+//# sourceMappingURL=schema.cjs.map

package/dist/schema.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.cjs","names":[],"sources":["../src/schema.ts"],"sourcesContent":["import { abortable } from '@vielzeug/arsenal';\n\nimport type { FormValidator, ValidationIssue } from './types.js';\n\nexport type StandardSchemaLike<Output> = {\n  readonly '~standard': {\n    readonly validate: (\n      value: unknown,\n    ) =>\n      | PromiseLike<\n          | { readonly issues: readonly { readonly message: string; readonly path?: readonly unknown[] }[] }\n          | { readonly value: Output }\n        >\n      | { readonly issues: readonly { readonly message: string; readonly path?: readonly unknown[] }[] }\n      | { readonly value: Output };\n  };\n};\n\nconst toPath = (path: readonly unknown[] | undefined): ValidationIssue['path'] => {\n  const result: Array<string | number> = [];\n\n  for (const part of path ?? []) {\n    const key = typeof part === 'object' && part !== null && 'key' in part ? part.key : part;\n    if (typeof key === 'string') result.push(key);\n    else if (typeof key === 'number' && Number.isSafeInteger(key) && key >= 0) result.push(key);\n    else return [];\n  }\n\n  return result;\n};\n\nexport function schemaValidator<TValues extends Record<string, unknown>>(\n  schema: StandardSchemaLike<TValues>,\n): FormValidator<TValues> {\n  return async (values, signal) => {\n    if (signal.aborted) return undefined;\n\n    const result = await abortable(Promise.resolve(schema['~standard'].validate(values)), signal);\n\n    if (signal.aborted || 'value' in result) return undefined;\n\n    return result.issues.map((issue) => ({ message: issue.message, path: toPath(issue.path) }));\n  };\n}\n"],"mappings":"sGAkBA,IAAM,EAAU,GAAkE,CAChF,IAAM,EAAiC,CAAC,EAExC,IAAK,IAAM,KAAQ,GAAQ,CAAC,EAAG,CAC7B,IAAM,EAAM,OAAO,GAAS,UAAY,GAAiB,QAAS,EAAO,EAAK,IAAM,EACpF,GAAI,OAAO,GAAQ,SAAU,EAAO,KAAK,CAAG,OACvC,GAAI,OAAO,GAAQ,UAAY,OAAO,cAAc,CAAG,GAAK,GAAO,EAAG,EAAO,KAAK,CAAG,OACrF,MAAO,CAAC,CACf,CAEA,OAAO,CACT,EAEA,SAAgB,EACd,EACwB,CACxB,OAAO,MAAO,EAAQ,IAAW,CAC/B,GAAI,EAAO,QAAS,OAEpB,IAAM,EAAS,MAAA,EAAM,EAAA,UAAA,CAAU,QAAQ,QAAQ,EAAO,YAAY,CAAC,SAAS,CAAM,CAAC,EAAG,CAAM,EAExF,OAAO,SAAW,UAAW,GAEjC,OAAO,EAAO,OAAO,IAAK,IAAW,CAAE,QAAS,EAAM,QAAS,KAAM,EAAO,EAAM,IAAI,CAAE,EAAE,CAC5F,CACF"}

package/dist/schema.d.ts

@@ -0,0 +1,22 @@
+import type { FormValidator } from './types.js';
+export type StandardSchemaLike<Output> = {
+    readonly '~standard': {
+        readonly validate: (value: unknown) => PromiseLike<{
+            readonly issues: readonly {
+                readonly message: string;
+                readonly path?: readonly unknown[];
+            }[];
+        } | {
+            readonly value: Output;
+        }> | {
+            readonly issues: readonly {
+                readonly message: string;
+                readonly path?: readonly unknown[];
+            }[];
+        } | {
+            readonly value: Output;
+        };
+    };
+};
+export declare function schemaValidator<TValues extends Record<string, unknown>>(schema: StandardSchemaLike<TValues>): FormValidator<TValues>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,YAAY,CAAC;AAEjE,MAAM,MAAM,kBAAkB,CAAC,MAAM,IAAI;IACvC,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,QAAQ,EAAE,CACjB,KAAK,EAAE,OAAO,KAEZ,WAAW,CACP;YAAE,QAAQ,CAAC,MAAM,EAAE,SAAS;gBAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;aAAE,EAAE,CAAA;SAAE,GAChG;YAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAC7B,GACD;YAAE,QAAQ,CAAC,MAAM,EAAE,SAAS;gBAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;aAAE,EAAE,CAAA;SAAE,GAChG;YAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KAChC,CAAC;CACH,CAAC;AAeF,wBAAgB,eAAe,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAClC,aAAa,CAAC,OAAO,CAAC,CAUxB"}

package/dist/schema.js

@@ -0,0 +1,26 @@
+import { abortable as e } from "@vielzeug/arsenal";
+//#region src/schema.ts
+var t = (e) => {
+	let t = [];
+	for (let n of e ?? []) {
+		let e = typeof n == "object" && n && "key" in n ? n.key : n;
+		if (typeof e == "string") t.push(e);
+		else if (typeof e == "number" && Number.isSafeInteger(e) && e >= 0) t.push(e);
+		else return [];
+	}
+	return t;
+};
+function n(n) {
+	return async (r, i) => {
+		if (i.aborted) return;
+		let a = await e(Promise.resolve(n["~standard"].validate(r)), i);
+		if (!(i.aborted || "value" in a)) return a.issues.map((e) => ({
+			message: e.message,
+			path: t(e.path)
+		}));
+	};
+}
+//#endregion
+export { n as schemaValidator };
+
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../src/schema.ts"],"sourcesContent":["import { abortable } from '@vielzeug/arsenal';\n\nimport type { FormValidator, ValidationIssue } from './types.js';\n\nexport type StandardSchemaLike<Output> = {\n  readonly '~standard': {\n    readonly validate: (\n      value: unknown,\n    ) =>\n      | PromiseLike<\n          | { readonly issues: readonly { readonly message: string; readonly path?: readonly unknown[] }[] }\n          | { readonly value: Output }\n        >\n      | { readonly issues: readonly { readonly message: string; readonly path?: readonly unknown[] }[] }\n      | { readonly value: Output };\n  };\n};\n\nconst toPath = (path: readonly unknown[] | undefined): ValidationIssue['path'] => {\n  const result: Array<string | number> = [];\n\n  for (const part of path ?? []) {\n    const key = typeof part === 'object' && part !== null && 'key' in part ? part.key : part;\n    if (typeof key === 'string') result.push(key);\n    else if (typeof key === 'number' && Number.isSafeInteger(key) && key >= 0) result.push(key);\n    else return [];\n  }\n\n  return result;\n};\n\nexport function schemaValidator<TValues extends Record<string, unknown>>(\n  schema: StandardSchemaLike<TValues>,\n): FormValidator<TValues> {\n  return async (values, signal) => {\n    if (signal.aborted) return undefined;\n\n    const result = await abortable(Promise.resolve(schema['~standard'].validate(values)), signal);\n\n    if (signal.aborted || 'value' in result) return undefined;\n\n    return result.issues.map((issue) => ({ message: issue.message, path: toPath(issue.path) }));\n  };\n}\n"],"mappings":";;AAkBA,IAAM,KAAU,MAAkE;CAChF,IAAM,IAAiC,CAAC;CAExC,KAAK,IAAM,KAAQ,KAAQ,CAAC,GAAG;EAC7B,IAAM,IAAM,OAAO,KAAS,YAAY,KAAiB,SAAS,IAAO,EAAK,MAAM;EACpF,IAAI,OAAO,KAAQ,UAAU,EAAO,KAAK,CAAG;OACvC,IAAI,OAAO,KAAQ,YAAY,OAAO,cAAc,CAAG,KAAK,KAAO,GAAG,EAAO,KAAK,CAAG;OACrF,OAAO,CAAC;CACf;CAEA,OAAO;AACT;AAEA,SAAgB,EACd,GACwB;CACxB,OAAO,OAAO,GAAQ,MAAW;EAC/B,IAAI,EAAO,SAAS;EAEpB,IAAM,IAAS,MAAM,EAAU,QAAQ,QAAQ,EAAO,YAAY,CAAC,SAAS,CAAM,CAAC,GAAG,CAAM;EAExF,QAAO,WAAW,WAAW,IAEjC,OAAO,EAAO,OAAO,KAAK,OAAW;GAAE,SAAS,EAAM;GAAS,MAAM,EAAO,EAAM,IAAI;EAAE,EAAE;CAC5F;AACF"}

package/dist/types.d.ts

@@ -1,16 +1,22 @@
 export type Unsubscribe = () => void;
 export type MaybePromise<T> = T | PromiseLike<T>;
-export type ReadonlyDeep<T> = T extends (...args: never[]) => unknown ? T : T extends readonly (infer Item)[] ? readonly ReadonlyDeep<Item>[] : T extends Record<string, unknown> ? {
+/**
+ * `Date`, `File`, and `Blob` are built-in atomic leaves. Dates are cloned and exposed
+ * without mutator methods; browser binary values preserve identity. Other values must be
+ * finite JSON primitives, plain objects, or dense arrays.
+ */
+export type Atomic = Date | File | Blob;
+type DateMutator = Extract<keyof Date, `set${string}`>;
+export type ReadonlyDate = Omit<Date, DateMutator>;
+export type ReadonlyDeep<T> = T extends Date ? ReadonlyDate : T extends File | Blob ? T : T extends readonly (infer Item)[] ? readonly ReadonlyDeep<Item>[] : T extends Record<string, unknown> ? {
     readonly [K in keyof T]: ReadonlyDeep<T[K]>;
 } : T;
-export type FormErrors<T> = T extends readonly (infer Item)[] ? string | readonly (FormErrors<Item> | undefined)[] : T extends Record<string, unknown> ? string | {
-    readonly [K in keyof T]?: FormErrors<T[K]>;
-} : string;
-export type ValidationErrors<TValues extends Record<string, unknown>> = Readonly<{
-    fields?: FormErrors<TValues>;
-    formError?: string;
+/** A single flat validation issue. `path: []` denotes a form-level error. */
+export type ValidationIssue = Readonly<{
+    path: readonly (string | number)[];
+    message: string;
 }>;
-export type FormValidator<TValues extends Record<string, unknown>> = (values: ReadonlyDeep<TValues>, signal: AbortSignal) => MaybePromise<ValidationErrors<TValues> | undefined>;
+export type FormValidator<TValues extends Record<string, unknown>> = (values: ReadonlyDeep<TValues>, signal: AbortSignal) => MaybePromise<readonly ValidationIssue[] | undefined>;
 export type FormOptions<TValues extends Record<string, unknown>> = Readonly<{
     initialValues: TValues;
     onSubscriberError?: (error: unknown) => void;
@@ -25,31 +31,29 @@ export type FieldState<V> = Readonly<{
     touched: boolean;
     value: ReadonlyDeep<V>;
 }>;
-export type FormState<TValues extends Record<string, unknown>> = Readonly<{
-    errors: FormErrors<TValues> | undefined;
+export type FormState = Readonly<{
     formError: string | undefined;
     hasErrors: boolean;
+    issues: readonly ValidationIssue[] | undefined;
     submitCount: number;
     submitting: boolean;
     touched: boolean;
     validity: 'invalid' | 'unknown' | 'valid';
     validating: boolean;
 }>;
-export type ValidationResult<TValues extends Record<string, unknown>> = Readonly<{
+export type ValidationResult = Readonly<{
     status: 'aborted';
 }> | Readonly<{
     status: 'valid';
 }> | Readonly<{
-    errors: FormErrors<TValues> | undefined;
-    formError: string | undefined;
+    issues: readonly ValidationIssue[];
     status: 'invalid';
 }>;
-export type SubmitResult<TResult = void, TValues extends Record<string, unknown> = Record<string, unknown>> = Readonly<{
+export type SubmitResult<TResult = void> = Readonly<{
     status: 'aborted';
 }> | Readonly<{
+    issues: readonly ValidationIssue[];
     status: 'invalid';
-    errors: FormErrors<TValues> | undefined;
-    formError: string | undefined;
 }> | Readonly<{
     status: 'ok';
     value: TResult;
@@ -78,10 +82,10 @@ export type Form<TValues extends Record<string, unknown>> = {
     field<K extends keyof TValues & string>(key: K): Field<TValues[K]>;
     reset(next?: TValues): void;
     set(next: TValues | ((previous: ReadonlyDeep<TValues>) => TValues)): void;
-    readonly state: FormState<TValues>;
-    submit<TResult = void>(handler: (values: ReadonlyDeep<TValues>, signal: AbortSignal) => MaybePromise<TResult>, signal?: AbortSignal): Promise<SubmitResult<TResult, TValues>>;
-    subscribe(listener: (state: FormState<TValues>) => void, options?: SubscribeOptions): Unsubscribe;
-    validate(signal?: AbortSignal): Promise<ValidationResult<TValues>>;
+    readonly state: FormState;
+    submit<TResult = void>(handler: (values: ReadonlyDeep<TValues>, signal: AbortSignal) => MaybePromise<TResult>, signal?: AbortSignal): Promise<SubmitResult<TResult>>;
+    subscribe(listener: (state: FormState) => void, options?: SubscribeOptions): Unsubscribe;
+    validate(signal?: AbortSignal): Promise<ValidationResult>;
     readonly value: ReadonlyDeep<TValues>;
 };
 export {};