@vielzeug/forge 1.3.1 → 2.0.0

package/dist/form.js

@@ -1,89 +1,243 @@
-import { warn as e } from "./_dev.js";
-import { sanitizeForLog as t } from "./_utils.js";
-import { createFormContext as n } from "./core/context.js";
-import { createLifecycleOps as r } from "./core/lifecycle.js";
-import { createObserveOps as i } from "./core/observe.js";
-import { createScopedForm as a } from "./core/scope.js";
-import { createValidationOps as o } from "./core/validation.js";
-import { createValueOps as s } from "./core/values.js";
+import { ForgeConfigError as e, ForgeDisposedError as t, ForgeSubmitError as n, ForgeValidationError as r } from "./errors.js";
+import { assertSafeKey as i, hasAtPath as a, immutable as o, isRecord as s, normalizeErrors as c, readAtPath as l, readError as u, readMeta as d, resetAtPath as f, touchAll as p, writeAtPath as m, writeMeta as h } from "./core/path.js";
 //#region src/form.ts
-function c(c = {}) {
-	let l = n(c), u = s(l), d = o(l, {
-		touchAll: u.touchAll,
-		values: u.values
-	}), f = i(l, {
-		set: u.set,
-		touch: u.touch,
-		validateFields: d.validateFields
-	}), p = r(l);
-	typeof c.defaultValues == "function" && c.defaultValues().then((e) => {
-		l.loadingState = !1, !l.disposed && u.replace(e);
-	}).catch((n) => {
-		l.loadingState = !1, !l.disposed && (e(`defaultValues factory rejected. Form will be empty. Error: ${t(String(n))}`), c.onLoadError?.(n), l.requestNotify());
+function g(e, t) {
+	let n = e, r = /* @__PURE__ */ new Set();
+	return {
+		dispose() {
+			r.clear();
+		},
+		read: () => n,
+		subscribe(e) {
+			return r.add(e), () => r.delete(e);
+		},
+		write(e) {
+			if (e !== n) {
+				n = e;
+				for (let e of [...r]) try {
+					e();
+				} catch (e) {
+					t(e);
+				}
+			}
+		}
+	};
+}
+function _(e) {
+	queueMicrotask(() => {
+		throw e;
+	});
+}
+function v(e, t) {
+	let n = l(e.value, t), r = l(e.baseline, t);
+	return Object.freeze({
+		dirty: n !== r || a(e.value, t) !== a(e.baseline, t),
+		error: u(e.errors, t),
+		touched: d(e.touched, t),
+		value: n
+	});
+}
+function y(e) {
+	return Object.freeze({
+		error: e.error,
+		errors: e.errors,
+		submitCount: e.submitCount,
+		submitting: e.isSubmitting,
+		touched: Object.keys(e.touched).length > 0,
+		valid: e.error === void 0 && e.errors === void 0,
+		validating: e.isValidating
 	});
-	let { listFields: m, registerField: h, removeField: g, setValidator: _, ...v } = u, { runValidationCore: y, ...b } = d, x = {
-		...v,
-		...b,
-		...f,
-		...p,
-		batch: l.batch,
+}
+function b(a) {
+	let u = o(a.initialValues);
+	function d(e) {
+		if (!a.onSubscriberError) {
+			_(e);
+			return;
+		}
+		try {
+			a.onSubscriberError(e);
+		} catch (e) {
+			_(e);
+		}
+	}
+	let b = g({
+		baseline: u,
+		error: void 0,
+		errors: void 0,
+		isSubmitting: !1,
+		isValidating: !1,
+		submitCount: 0,
+		touched: {},
+		value: u
+	}, d), x = new AbortController(), S = !1, C;
+	function w(e) {
+		if (S) throw new t(e);
+	}
+	function T(e) {
+		b.write(Object.freeze(e(b.read())));
+	}
+	async function E(e) {
+		w("validate"), C?.abort();
+		let t = new AbortController(), n = e ? AbortSignal.any([t.signal, e]) : t.signal;
+		C = t, T((e) => ({
+			...e,
+			isValidating: !0
+		}));
+		try {
+			let e = a.validate ? await a.validate(b.read().value, n) : void 0;
+			if (n.aborted || C !== t) return Object.freeze({ status: "aborted" });
+			let r = e?.fields ? c(o(e.fields)) : void 0, i = e?.formError;
+			return T((e) => ({
+				...e,
+				error: i,
+				errors: r
+			})), Object.freeze(r === void 0 && i === void 0 ? { status: "valid" } : {
+				errors: r,
+				formError: i,
+				status: "invalid"
+			});
+		} catch (e) {
+			if (n.aborted || C !== t) return Object.freeze({ status: "aborted" });
+			throw new r("Form validation failed.", { cause: e });
+		} finally {
+			C === t && (C = void 0, S || T((e) => ({
+				...e,
+				isValidating: !1
+			})));
+		}
+	}
+	function D(t) {
+		return Object.assign({
+			get dirty() {
+				return v(b.read(), t).dirty;
+			},
+			get error() {
+				return v(b.read(), t).error;
+			},
+			reset() {
+				w("field().reset"), C?.abort(), T((e) => ({
+					...e,
+					touched: h(e.touched, t, !1),
+					value: f(e.value, e.baseline, t)
+				}));
+			},
+			set(e) {
+				w("field().set"), C?.abort();
+				let n = l(b.read().value, t), r = typeof e == "function" ? e(n) : e;
+				T((e) => ({
+					...e,
+					value: m(e.value, t, r)
+				}));
+			},
+			subscribe(e, n = {}) {
+				w("field().subscribe");
+				let r = v(b.read(), t);
+				return n.immediate && e(r), b.subscribe(() => {
+					let n = v(b.read(), t);
+					(n.value !== r.value || n.error !== r.error || n.touched !== r.touched || n.dirty !== r.dirty) && (r = n, e(n));
+				});
+			},
+			touch() {
+				w("field().touch"), T((e) => ({
+					...e,
+					touched: h(e.touched, t, !0)
+				}));
+			},
+			get touched() {
+				return v(b.read(), t).touched;
+			},
+			get value() {
+				return v(b.read(), t).value;
+			}
+		}, { field(n) {
+			i(n);
+			let r = l(b.read().value, t);
+			if (r !== void 0 && !s(r)) throw new e(`Cannot select '${n}' because the current field value is not an object.`);
+			return D([...t, n]);
+		} });
+	}
+	let O = {
 		get disposalSignal() {
-			return l.disposeController.signal;
+			return x.signal;
 		},
-		get disposed() {
-			return l.disposed;
+		dispose() {
+			S || (S = !0, x.abort(), C?.abort(), b.dispose());
 		},
-		fields: {
-			list: m,
-			register: h,
-			remove: g,
-			setValidator: _
+		get disposed() {
+			return S;
 		},
-		get isLoading() {
-			return l.loadingState;
+		field(e) {
+			return i(e), D([e]);
 		},
-		get isSubmitting() {
-			return l.isSubmittingState;
+		reset(e) {
+			w("reset"), C?.abort();
+			let t = e === void 0 ? b.read().baseline : o(e);
+			T((e) => ({
+				...e,
+				baseline: t,
+				error: void 0,
+				errors: void 0,
+				touched: {},
+				value: t
+			}));
 		},
-		scope(e) {
-			let t = e, n = l.scopeCache.get(t);
-			if (n) return n;
-			let r = a({
-				baseline: l.baseline,
-				dirty: l.dirty,
-				ensureNotDisposed: l.ensureNotDisposed,
-				fieldCtrls: l.fieldCtrls,
-				fieldErrors: l.fieldErrors,
-				getStateSnapshot: l.getStateSnapshot,
-				incrementSubmitCount: () => {
-					l.submitCount++;
-				},
-				invalidateErrors: l.invalidateErrors,
-				isDisposed: () => l.disposed,
-				isSubmitting: () => l.isSubmittingState,
-				requestNotify: l.requestNotify,
-				root: x,
-				runValidationCore: y,
-				setSubmitting: (e) => {
-					l.isSubmittingState = e;
-				},
-				store: l.store,
-				touched: l.touched,
-				validators: l.validators
-			}, e);
-			return l.scopeCache.set(t, r), r;
+		set(e) {
+			w("set"), C?.abort();
+			let t = typeof e == "function" ? e(O.value) : e;
+			T((e) => ({
+				...e,
+				error: void 0,
+				errors: void 0,
+				value: o(t)
+			}));
 		},
 		get state() {
-			return l.getStateSnapshot();
+			return y(b.read());
+		},
+		async submit(e) {
+			if (w("submit"), b.read().isSubmitting) throw new n("submit() called while a submission is already in progress");
+			T((e) => ({
+				...e,
+				isSubmitting: !0,
+				submitCount: e.submitCount + 1,
+				touched: p(e.value)
+			}));
+			try {
+				let t = await E();
+				return t.status === "aborted" ? Object.freeze({
+					ok: !1,
+					type: "aborted"
+				}) : t.status === "invalid" ? Object.freeze({
+					errors: t.errors,
+					formError: t.formError,
+					ok: !1,
+					type: "validation"
+				}) : Object.freeze({
+					ok: !0,
+					value: await e(O.value)
+				});
+			} finally {
+				S || T((e) => ({
+					...e,
+					isSubmitting: !1
+				}));
+			}
+		},
+		subscribe(e, t = {}) {
+			return w("subscribe"), t.immediate && e(y(b.read())), b.subscribe(() => e(y(b.read())));
 		},
-		subscribeScoped: f.subscribe,
 		[Symbol.dispose]() {
-			this.dispose();
+			O.dispose();
+		},
+		validate: E,
+		get value() {
+			return b.read().value;
 		}
 	};
-	return x;
+	return O;
 }
 //#endregion
-export { c as createForm };
+export { b 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 { warn } from './_dev';\nimport { sanitizeForLog } from './_utils';\nimport { createFormContext } from './core/context';\nimport { createLifecycleOps } from './core/lifecycle';\nimport { createObserveOps } from './core/observe';\nimport { createScopedForm, type ScopeContext } from './core/scope';\nimport { createValidationOps } from './core/validation';\nimport { createValueOps } from './core/values';\nimport { type FlatKeyOf, type Form, type FormOptions, type ScopedValues } from './types';\n\n/* -------------------- createForm -------------------- */\n\nexport function createForm<TInit extends object>(\n  init: Omit<FormOptions<TInit & Record<string, unknown>>, 'defaultValues'> & {\n    defaultValues: TInit | (() => Promise<TInit>);\n  },\n): Form<TInit & Record<string, unknown>>;\nexport function createForm<TValues extends Record<string, unknown> = Record<string, unknown>>(\n  init?: FormOptions<TValues>,\n): Form<TValues>;\nexport function createForm<TValues extends Record<string, unknown> = Record<string, unknown>>(\n  init: FormOptions<TValues> = {},\n): Form<TValues> {\n  const ctx = createFormContext<TValues>(init);\n  const valueOps = createValueOps(ctx);\n  const validationOps = createValidationOps(ctx, { touchAll: valueOps.touchAll, values: valueOps.values });\n  const observeOps = createObserveOps(ctx, {\n    set: valueOps.set,\n    touch: valueOps.touch,\n    validateFields: validationOps.validateFields,\n  });\n  const lifecycleOps = createLifecycleOps(ctx);\n\n  /* ---- Async defaultValues ---- */\n\n  if (typeof init.defaultValues === 'function') {\n    void init\n      .defaultValues()\n      .then((resolved) => {\n        ctx.loadingState = false;\n\n        if (ctx.disposed) return;\n\n        valueOps.replace(resolved);\n      })\n      .catch((err: unknown) => {\n        ctx.loadingState = false;\n\n        if (ctx.disposed) return;\n\n        warn(`defaultValues factory rejected. Form will be empty. Error: ${sanitizeForLog(String(err))}`);\n        init.onLoadError?.(err);\n        ctx.requestNotify();\n      });\n  }\n\n  /* ======== Public form object ======== */\n\n  // registerField/removeField/setValidator/listFields are nested under `fields`, not top-level.\n  const { listFields, registerField, removeField, setValidator, ...publicValueOps } = valueOps;\n  // runValidationCore is internal-only — needed by scope(), not part of the public Form<T> surface.\n  const { runValidationCore, ...publicValidationOps } = validationOps;\n\n  // `scope` is defined as a method on publicForm so that `const publicForm` can capture itself\n  // via closure without a forward-reference lint disable.\n  const publicForm: Form<TValues> = {\n    ...publicValueOps,\n    ...publicValidationOps,\n    ...observeOps,\n    ...lifecycleOps,\n    batch: ctx.batch,\n    get disposalSignal() {\n      return ctx.disposeController.signal;\n    },\n    get disposed() {\n      return ctx.disposed;\n    },\n    fields: {\n      list: listFields,\n      register: registerField,\n      remove: removeField,\n      setValidator,\n    },\n    get isLoading() {\n      return ctx.loadingState;\n    },\n    get isSubmitting() {\n      return ctx.isSubmittingState;\n    },\n    scope<P extends FlatKeyOf<TValues>>(prefix: P): Form<ScopedValues<TValues, P>> {\n      const key = prefix as string;\n      const cached = ctx.scopeCache.get(key);\n\n      if (cached) return cached as Form<ScopedValues<TValues, P>>;\n\n      const scopeCtx: ScopeContext<TValues> = {\n        baseline: ctx.baseline,\n        dirty: ctx.dirty,\n        ensureNotDisposed: ctx.ensureNotDisposed,\n        fieldCtrls: ctx.fieldCtrls,\n        fieldErrors: ctx.fieldErrors,\n        getStateSnapshot: ctx.getStateSnapshot,\n        incrementSubmitCount: () => {\n          ctx.submitCount++;\n        },\n        invalidateErrors: ctx.invalidateErrors,\n        isDisposed: () => ctx.disposed,\n        isSubmitting: () => ctx.isSubmittingState,\n        requestNotify: ctx.requestNotify,\n        root: publicForm,\n        runValidationCore,\n        setSubmitting: (v) => {\n          ctx.isSubmittingState = v;\n        },\n        store: ctx.store,\n        touched: ctx.touched,\n        validators: ctx.validators,\n      };\n\n      const scoped = createScopedForm<TValues, P>(scopeCtx, prefix) as Form<ScopedValues<TValues, P>>;\n\n      ctx.scopeCache.set(key, scoped as Form<never>);\n\n      return scoped;\n    },\n    get state() {\n      return ctx.getStateSnapshot();\n    },\n    // On a root form, subscribeScoped behaves identically to subscribe — no prefix filtering.\n    subscribeScoped: observeOps.subscribe,\n    [Symbol.dispose]() {\n      this.dispose();\n    },\n  };\n\n  return publicForm;\n}\n"],"mappings":";;;;;;;;;AAoBA,SAAgB,EACd,IAA6B,CAAC,GACf;CACf,IAAM,IAAM,EAA2B,CAAI,GACrC,IAAW,EAAe,CAAG,GAC7B,IAAgB,EAAoB,GAAK;EAAE,UAAU,EAAS;EAAU,QAAQ,EAAS;CAAO,CAAC,GACjG,IAAa,EAAiB,GAAK;EACvC,KAAK,EAAS;EACd,OAAO,EAAS;EAChB,gBAAgB,EAAc;CAChC,CAAC,GACK,IAAe,EAAmB,CAAG;CAI3C,AAAI,OAAO,EAAK,iBAAkB,cAChC,EACG,cAAc,CAAC,CACf,MAAM,MAAa;EAClB,EAAI,eAAe,IAEf,GAAI,YAER,EAAS,QAAQ,CAAQ;CAC3B,CAAC,CAAC,CACD,OAAO,MAAiB;EACvB,EAAI,eAAe,IAEf,GAAI,aAER,EAAK,8DAA8D,EAAe,OAAO,CAAG,CAAC,GAAG,GAChG,EAAK,cAAc,CAAG,GACtB,EAAI,cAAc;CACpB,CAAC;CAML,IAAM,EAAE,eAAY,kBAAe,gBAAa,iBAAc,GAAG,MAAmB,GAE9E,EAAE,sBAAmB,GAAG,MAAwB,GAIhD,IAA4B;EAChC,GAAG;EACH,GAAG;EACH,GAAG;EACH,GAAG;EACH,OAAO,EAAI;EACX,IAAI,iBAAiB;GACnB,OAAO,EAAI,kBAAkB;EAC/B;EACA,IAAI,WAAW;GACb,OAAO,EAAI;EACb;EACA,QAAQ;GACN,MAAM;GACN,UAAU;GACV,QAAQ;GACR;EACF;EACA,IAAI,YAAY;GACd,OAAO,EAAI;EACb;EACA,IAAI,eAAe;GACjB,OAAO,EAAI;EACb;EACA,MAAoC,GAA2C;GAC7E,IAAM,IAAM,GACN,IAAS,EAAI,WAAW,IAAI,CAAG;GAErC,IAAI,GAAQ,OAAO;GA0BnB,IAAM,IAAS,EAA6B;IAvB1C,UAAU,EAAI;IACd,OAAO,EAAI;IACX,mBAAmB,EAAI;IACvB,YAAY,EAAI;IAChB,aAAa,EAAI;IACjB,kBAAkB,EAAI;IACtB,4BAA4B;KAC1B,EAAI;IACN;IACA,kBAAkB,EAAI;IACtB,kBAAkB,EAAI;IACtB,oBAAoB,EAAI;IACxB,eAAe,EAAI;IACnB,MAAM;IACN;IACA,gBAAgB,MAAM;KACpB,EAAI,oBAAoB;IAC1B;IACA,OAAO,EAAI;IACX,SAAS,EAAI;IACb,YAAY,EAAI;GAG0B,GAAU,CAAM;GAI5D,OAFA,EAAI,WAAW,IAAI,GAAK,CAAqB,GAEtC;EACT;EACA,IAAI,QAAQ;GACV,OAAO,EAAI,iBAAiB;EAC9B;EAEA,iBAAiB,EAAW;EAC5B,CAAC,OAAO,WAAW;GACjB,KAAK,QAAQ;EACf;CACF;CAEA,OAAO;AACT"}
+{"version":3,"file":"form.js","names":[],"sources":["../src/form.ts"],"sourcesContent":["import type {\n  Field,\n  FieldState,\n  Form,\n  FormErrors,\n  FormOptions,\n  FormState,\n  MaybePromise,\n  ReadonlyDeep,\n  SubmitResult,\n  SubscribeOptions,\n  Unsubscribe,\n  ValidationErrors,\n  ValidationResult,\n} from './types';\n\nimport {\n  assertSafeKey,\n  hasAtPath,\n  immutable,\n  isRecord,\n  normalizeErrors,\n  readAtPath,\n  readError,\n  readMeta,\n  resetAtPath,\n  type MetaRoot,\n  touchAll,\n  writeAtPath,\n  writeMeta,\n} from './core/path';\nimport { ForgeConfigError, ForgeDisposedError, ForgeSubmitError, ForgeValidationError } from './errors';\n\ntype InternalState<TValues extends Record<string, unknown>> = Readonly<{\n  baseline: TValues;\n  error: string | undefined;\n  errors: FormErrors<TValues> | undefined;\n  isSubmitting: boolean;\n  isValidating: boolean;\n  submitCount: number;\n  touched: MetaRoot;\n  value: TValues;\n}>;\n\ntype Store<T> = {\n  dispose(): void;\n  read(): T;\n  subscribe(listener: () => void): Unsubscribe;\n  write(next: T): void;\n};\n\nfunction createStore<T>(initial: T, onListenerError: (error: unknown) => void): Store<T> {\n  let current = initial;\n  const listeners = new Set<() => void>();\n\n  return {\n    dispose() {\n      listeners.clear();\n    },\n    read: () => current,\n    subscribe(listener) {\n      listeners.add(listener);\n\n      return () => listeners.delete(listener);\n    },\n    write(next) {\n      if (next === current) return;\n\n      current = next;\n\n      for (const listener of [...listeners]) {\n        try {\n          listener();\n        } catch (error) {\n          onListenerError(error);\n        }\n      }\n    },\n  };\n}\n\nfunction rethrowAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error;\n  });\n}\n\nfunction makeFieldState<V>(state: InternalState<Record<string, unknown>>, path: readonly string[]): FieldState<V> {\n  const value = readAtPath<V>(state.value, path);\n  const baseline = readAtPath<V>(state.baseline, path);\n\n  return Object.freeze({\n    dirty: value !== baseline || hasAtPath(state.value, path) !== hasAtPath(state.baseline, path),\n    error: readError(state.errors, path),\n    touched: readMeta(state.touched, path),\n    value: value as ReadonlyDeep<V>,\n  });\n}\n\nfunction makeFormState<TValues extends Record<string, unknown>>(current: InternalState<TValues>): FormState<TValues> {\n  return Object.freeze({\n    error: current.error,\n    errors: current.errors,\n    submitCount: current.submitCount,\n    submitting: current.isSubmitting,\n    touched: Object.keys(current.touched).length > 0,\n    valid: current.error === undefined && current.errors === undefined,\n    validating: current.isValidating,\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\n  function reportListenerError(error: unknown): void {\n    if (!options.onSubscriberError) {\n      rethrowAsync(error);\n\n      return;\n    }\n\n    try {\n      options.onSubscriberError(error);\n    } catch (reporterError) {\n      rethrowAsync(reporterError);\n    }\n  }\n\n  const store = createStore<InternalState<TValues>>(\n    {\n      baseline: initial,\n      error: undefined,\n      errors: undefined,\n      isSubmitting: false,\n      isValidating: false,\n      submitCount: 0,\n      touched: {},\n      value: initial,\n    },\n    reportListenerError,\n  );\n  const disposalController = new AbortController();\n  let disposed = false;\n  let validationController: AbortController | undefined;\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    store.write(Object.freeze(update(store.read())));\n  }\n\n  async function validate(externalSignal?: AbortSignal): Promise<ValidationResult<TValues>> {\n    ensureActive('validate');\n    validationController?.abort();\n\n    const controller = new AbortController();\n    const signal = externalSignal ? AbortSignal.any([controller.signal, externalSignal]) : controller.signal;\n\n    validationController = controller;\n    write((current) => ({ ...current, isValidating: true }));\n\n    try {\n      const result: ValidationErrors<TValues> | undefined = options.validate\n        ? await options.validate(store.read().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\n      write((current) => ({ ...current, error: formError, errors }));\n\n      return errors === undefined && formError === undefined\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((current) => ({ ...current, isValidating: false }));\n      }\n    }\n  }\n\n  function createField<V>(path: readonly string[]): Field<V> {\n    const common = {\n      get dirty() {\n        return makeFieldState<V>(store.read() as InternalState<Record<string, unknown>>, path).dirty;\n      },\n      get error() {\n        return makeFieldState<V>(store.read() as InternalState<Record<string, unknown>>, path).error;\n      },\n      reset() {\n        ensureActive('field().reset');\n        validationController?.abort();\n        write((current) => ({\n          ...current,\n          touched: writeMeta(current.touched, path, false),\n          value: resetAtPath(current.value, current.baseline, path),\n        }));\n      },\n      set(next: V | ((previous: ReadonlyDeep<V>) => V)) {\n        ensureActive('field().set');\n        validationController?.abort();\n\n        const previous = readAtPath<V>(store.read().value, path) as ReadonlyDeep<V>;\n        const value = typeof next === 'function' ? (next as (current: ReadonlyDeep<V>) => V)(previous) : next;\n\n        write((current) => ({ ...current, value: writeAtPath(current.value, path, value) }));\n      },\n      subscribe(listener: (state: FieldState<V>) => void, subscribeOptions: SubscribeOptions = {}): Unsubscribe {\n        ensureActive('field().subscribe');\n\n        let previous = makeFieldState<V>(store.read() as InternalState<Record<string, unknown>>, path);\n\n        if (subscribeOptions.immediate) listener(previous);\n\n        return store.subscribe(() => {\n          const next = makeFieldState<V>(store.read() as InternalState<Record<string, unknown>>, path);\n\n          if (\n            next.value === previous.value &&\n            next.error === previous.error &&\n            next.touched === previous.touched &&\n            next.dirty === previous.dirty\n          ) {\n            return;\n          }\n\n          previous = next;\n          listener(next);\n        });\n      },\n      touch() {\n        ensureActive('field().touch');\n        write((current) => ({ ...current, touched: writeMeta(current.touched, path, true) }));\n      },\n      get touched() {\n        return makeFieldState<V>(store.read() as InternalState<Record<string, unknown>>, path).touched;\n      },\n      get value() {\n        return makeFieldState<V>(store.read() as InternalState<Record<string, unknown>>, path).value;\n      },\n    };\n\n    return Object.assign(common, {\n      field<K extends keyof NonNullable<V> & string>(key: K): Field<NonNullable<V>[K]> {\n        assertSafeKey(key);\n\n        const current = readAtPath(store.read().value, path);\n\n        if (current !== undefined && !isRecord(current)) {\n          throw new ForgeConfigError(`Cannot select '${key}' because the current field value is not an object.`);\n        }\n\n        return createField<NonNullable<V>[K]>([...path, key]);\n      },\n    }) as Field<V>;\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      validationController?.abort();\n      store.dispose();\n    },\n    get disposed() {\n      return disposed;\n    },\n    field(key) {\n      assertSafeKey(key);\n\n      return createField<TValues[typeof key]>([key]);\n    },\n    reset(next) {\n      ensureActive('reset');\n      validationController?.abort();\n\n      const baseline = next === undefined ? store.read().baseline : immutable(next);\n\n      write((current) => ({\n        ...current,\n        baseline,\n        error: undefined,\n        errors: undefined,\n        touched: {},\n        value: baseline,\n      }));\n    },\n    set(next) {\n      ensureActive('set');\n      validationController?.abort();\n\n      const value =\n        typeof next === 'function' ? (next as (current: ReadonlyDeep<TValues>) => TValues)(form.value) : next;\n\n      write((current) => ({ ...current, error: undefined, errors: undefined, value: immutable(value) }));\n    },\n    get state() {\n      return makeFormState(store.read());\n    },\n    async submit<TResult = void>(\n      handler: (values: ReadonlyDeep<TValues>) => MaybePromise<TResult>,\n    ): Promise<SubmitResult<TResult, TValues>> {\n      ensureActive('submit');\n\n      if (store.read().isSubmitting)\n        throw new ForgeSubmitError('submit() called while a submission is already in progress');\n\n      write((current) => ({\n        ...current,\n        isSubmitting: true,\n        submitCount: current.submitCount + 1,\n        touched: touchAll(current.value),\n      }));\n\n      try {\n        const result = await validate();\n\n        if (result.status === 'aborted') return Object.freeze({ ok: false, type: 'aborted' });\n\n        if (result.status === 'invalid') {\n          return Object.freeze({\n            errors: result.errors,\n            formError: result.formError,\n            ok: false,\n            type: 'validation',\n          });\n        }\n\n        return Object.freeze({ ok: true, value: await handler(form.value) });\n      } finally {\n        if (!disposed) write((current) => ({ ...current, isSubmitting: false }));\n      }\n    },\n    subscribe(listener, subscribeOptions: SubscribeOptions = {}): Unsubscribe {\n      ensureActive('subscribe');\n\n      if (subscribeOptions.immediate) listener(makeFormState(store.read()));\n\n      return store.subscribe(() => listener(makeFormState(store.read())));\n    },\n    [Symbol.dispose]() {\n      form.dispose();\n    },\n    validate,\n    get value() {\n      return store.read().value as ReadonlyDeep<TValues>;\n    },\n  };\n\n  return form;\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./errors.cjs"),t=require("./types.cjs"),n=require("./form.cjs"),r=require("./adapters/form-data.cjs");exports.FORM_ERROR=t.FORM_ERROR,exports.ForgeConfigError=e.ForgeConfigError,exports.ForgeDisposedError=e.ForgeDisposedError,exports.ForgeError=e.ForgeError,exports.ForgeSubmitError=e.ForgeSubmitError,exports.ForgeValidationError=e.ForgeValidationError,exports.ValidationModes=t.ValidationModes,exports.createForm=n.createForm,exports.toFormData=r.toFormData;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./errors.cjs"),t=require("./form.cjs"),n=require("./adapters/form-data.cjs");exports.ForgeConfigError=e.ForgeConfigError,exports.ForgeDisposedError=e.ForgeDisposedError,exports.ForgeError=e.ForgeError,exports.ForgeSubmitError=e.ForgeSubmitError,exports.ForgeValidationError=e.ForgeValidationError,exports.createForm=t.createForm,exports.toFormData=n.toFormData;

package/dist/index.js

@@ -1,5 +1,4 @@
 import { ForgeConfigError as e, ForgeDisposedError as t, ForgeError as n, ForgeSubmitError as r, ForgeValidationError as i } from "./errors.js";
-import { FORM_ERROR as a, ValidationModes as o } from "./types.js";
-import { createForm as s } from "./form.js";
-import { toFormData as c } from "./adapters/form-data.js";
-export { a as FORM_ERROR, e as ForgeConfigError, t as ForgeDisposedError, n as ForgeError, r as ForgeSubmitError, i as ForgeValidationError, o as ValidationModes, s as createForm, c as toFormData };
+import { createForm as a } from "./form.js";
+import { toFormData as o } from "./adapters/form-data.js";
+export { e as ForgeConfigError, t as ForgeDisposedError, n as ForgeError, r as ForgeSubmitError, i as ForgeValidationError, a as createForm, o as toFormData };

package/dist/spell.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./core/path.cjs");require("@vielzeug/spell");function t(e){return e.code===`invalid_union`}function n(e,t){return t.aborted?Promise.resolve(void 0):new Promise((n,r)=>{let i=()=>n(void 0);t.addEventListener(`abort`,i,{once:!0}),e.then(e=>{t.removeEventListener(`abort`,i),n(e)},e=>{t.removeEventListener(`abort`,i),r(e)})})}function r(e){let t=[];for(let n of e){if(typeof n==`number`)break;t.push(n)}return t}function i(e,t){return t.map(t=>({...t,path:[...e,...t.path]}))}function a(a){return async(o,s)=>{let c=await n(a.safeParseAsync(o),s);if(!c||c.success)return;let l=c.error.issues.flatMap(e=>{if(!t(e))return[e];let n=c.error.bestMatch(e);return n?i(e.path,n):[e]}),u={},d;for(let t of l){if(t.path.length===0){d??=t.message;continue}u=e.writeError(u,r(t.path),t.message)}let f={fields:Object.keys(u).length===0?void 0:u,formError:d};return f.fields===void 0&&f.formError===void 0?void 0:f}}exports.customValidator=a;
+//# sourceMappingURL=spell.cjs.map

package/dist/spell.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"spell.cjs","names":[],"sources":["../src/spell.ts"],"sourcesContent":["import { Schema, type Issue, type SchemaMode } from '@vielzeug/spell';\n\nimport type { FormErrors, FormValidator, ValidationErrors } from './types';\n\nimport { writeError } from './core/path';\n\ntype ErrorTree = Record<string, unknown>;\ntype UnionIssue = Extract<Issue, { code: 'invalid_union' }>;\n\nfunction isUnionIssue(issue: Issue): issue is UnionIssue {\n  return issue.code === 'invalid_union';\n}\n\nfunction abortable<T>(promise: Promise<T>, signal: AbortSignal): Promise<T | undefined> {\n  if (signal.aborted) return Promise.resolve(undefined);\n\n  return new Promise((resolve, reject) => {\n    const abort = () => resolve(undefined);\n\n    signal.addEventListener('abort', abort, { once: true });\n    void promise.then(\n      (value) => {\n        signal.removeEventListener('abort', abort);\n        resolve(value);\n      },\n      (error: unknown) => {\n        signal.removeEventListener('abort', abort);\n        reject(error);\n      },\n    );\n  });\n}\n\nfunction fieldPath(path: readonly (string | number)[]): string[] {\n  const segments: string[] = [];\n\n  for (const segment of path) {\n    if (typeof segment === 'number') break;\n\n    segments.push(segment);\n  }\n\n  return segments;\n}\n\nfunction prefixIssues(path: readonly (string | number)[], issues: readonly Issue[]): Issue[] {\n  return issues.map((issue) => ({ ...issue, path: [...path, ...issue.path] }));\n}\n\n/** Adapts a Spell Schema into Forge's full-form validator without transforming form values. */\nexport function customValidator<TValues extends Record<string, unknown>>(\n  schema: Schema<unknown, TValues, SchemaMode>,\n): FormValidator<TValues> {\n  return async (values, signal) => {\n    const result = await abortable(schema.safeParseAsync(values), signal);\n\n    if (!result || result.success) return undefined;\n\n    const issues = result.error.issues.flatMap((issue) => {\n      if (!isUnionIssue(issue)) return [issue];\n\n      const bestMatch = result.error.bestMatch(issue);\n\n      return bestMatch ? prefixIssues(issue.path, bestMatch) : [issue];\n    });\n    let fields: ErrorTree = {};\n    let formError: string | undefined;\n\n    for (const issue of issues) {\n      if (issue.path.length === 0) {\n        formError ??= issue.message;\n        continue;\n      }\n\n      fields = writeError(fields, fieldPath(issue.path), issue.message);\n    }\n\n    const errors: ValidationErrors<TValues> = {\n      fields: Object.keys(fields).length === 0 ? undefined : (fields as FormErrors<TValues>),\n      formError,\n    };\n\n    return errors.fields === undefined && errors.formError === undefined ? undefined : errors;\n  };\n}\n"],"mappings":"iIASA,SAAS,EAAa,EAAmC,CACvD,OAAO,EAAM,OAAS,eACxB,CAEA,SAAS,EAAa,EAAqB,EAA6C,CAGtF,OAFI,EAAO,QAAgB,QAAQ,QAAQ,IAAA,EAAS,EAE7C,IAAI,SAAS,EAAS,IAAW,CACtC,IAAM,MAAc,EAAQ,IAAA,EAAS,EAErC,EAAO,iBAAiB,QAAS,EAAO,CAAE,KAAM,EAAK,CAAC,EACtD,EAAa,KACV,GAAU,CACT,EAAO,oBAAoB,QAAS,CAAK,EACzC,EAAQ,CAAK,CACf,EACC,GAAmB,CAClB,EAAO,oBAAoB,QAAS,CAAK,EACzC,EAAO,CAAK,CACd,CACF,CACF,CAAC,CACH,CAEA,SAAS,EAAU,EAA8C,CAC/D,IAAM,EAAqB,CAAC,EAE5B,IAAK,IAAM,KAAW,EAAM,CAC1B,GAAI,OAAO,GAAY,SAAU,MAEjC,EAAS,KAAK,CAAO,CACvB,CAEA,OAAO,CACT,CAEA,SAAS,EAAa,EAAoC,EAAmC,CAC3F,OAAO,EAAO,IAAK,IAAW,CAAE,GAAG,EAAO,KAAM,CAAC,GAAG,EAAM,GAAG,EAAM,IAAI,CAAE,EAAE,CAC7E,CAGA,SAAgB,EACd,EACwB,CACxB,OAAO,MAAO,EAAQ,IAAW,CAC/B,IAAM,EAAS,MAAM,EAAU,EAAO,eAAe,CAAM,EAAG,CAAM,EAEpE,GAAI,CAAC,GAAU,EAAO,QAAS,OAE/B,IAAM,EAAS,EAAO,MAAM,OAAO,QAAS,GAAU,CACpD,GAAI,CAAC,EAAa,CAAK,EAAG,MAAO,CAAC,CAAK,EAEvC,IAAM,EAAY,EAAO,MAAM,UAAU,CAAK,EAE9C,OAAO,EAAY,EAAa,EAAM,KAAM,CAAS,EAAI,CAAC,CAAK,CACjE,CAAC,EACG,EAAoB,CAAC,EACrB,EAEJ,IAAK,IAAM,KAAS,EAAQ,CAC1B,GAAI,EAAM,KAAK,SAAW,EAAG,CAC3B,IAAc,EAAM,QACpB,QACF,CAEA,EAAS,EAAA,WAAW,EAAQ,EAAU,EAAM,IAAI,EAAG,EAAM,OAAO,CAClE,CAEA,IAAM,EAAoC,CACxC,OAAQ,OAAO,KAAK,CAAM,CAAC,CAAC,SAAW,EAAI,IAAA,GAAa,EACxD,WACF,EAEA,OAAO,EAAO,SAAW,IAAA,IAAa,EAAO,YAAc,IAAA,GAAY,IAAA,GAAY,CACrF,CACF"}

package/dist/spell.d.ts

@@ -0,0 +1,5 @@
+import { Schema, type SchemaMode } from '@vielzeug/spell';
+import type { FormValidator } from './types';
+/** Adapts a Spell Schema into Forge's full-form validator without transforming form values. */
+export declare function customValidator<TValues extends Record<string, unknown>>(schema: Schema<unknown, TValues, SchemaMode>): FormValidator<TValues>;
+//# sourceMappingURL=spell.d.ts.map

package/dist/spell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spell.d.ts","sourceRoot":"","sources":["../src/spell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAc,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEtE,OAAO,KAAK,EAAc,aAAa,EAAoB,MAAM,SAAS,CAAC;AA+C3E,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,GAC3C,aAAa,CAAC,OAAO,CAAC,CAgCxB"}

package/dist/spell.js

@@ -0,0 +1,57 @@
+import { writeError as e } from "./core/path.js";
+import "@vielzeug/spell";
+//#region src/spell.ts
+function t(e) {
+	return e.code === "invalid_union";
+}
+function n(e, t) {
+	return t.aborted ? Promise.resolve(void 0) : new Promise((n, r) => {
+		let i = () => n(void 0);
+		t.addEventListener("abort", i, { once: !0 }), e.then((e) => {
+			t.removeEventListener("abort", i), n(e);
+		}, (e) => {
+			t.removeEventListener("abort", i), r(e);
+		});
+	});
+}
+function r(e) {
+	let t = [];
+	for (let n of e) {
+		if (typeof n == "number") break;
+		t.push(n);
+	}
+	return t;
+}
+function i(e, t) {
+	return t.map((t) => ({
+		...t,
+		path: [...e, ...t.path]
+	}));
+}
+function a(a) {
+	return async (o, s) => {
+		let c = await n(a.safeParseAsync(o), s);
+		if (!c || c.success) return;
+		let l = c.error.issues.flatMap((e) => {
+			if (!t(e)) return [e];
+			let n = c.error.bestMatch(e);
+			return n ? i(e.path, n) : [e];
+		}), u = {}, d;
+		for (let t of l) {
+			if (t.path.length === 0) {
+				d ??= t.message;
+				continue;
+			}
+			u = e(u, r(t.path), t.message);
+		}
+		let f = {
+			fields: Object.keys(u).length === 0 ? void 0 : u,
+			formError: d
+		};
+		return f.fields === void 0 && f.formError === void 0 ? void 0 : f;
+	};
+}
+//#endregion
+export { a as customValidator };
+
+//# sourceMappingURL=spell.js.map

package/dist/spell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spell.js","names":[],"sources":["../src/spell.ts"],"sourcesContent":["import { Schema, type Issue, type SchemaMode } from '@vielzeug/spell';\n\nimport type { FormErrors, FormValidator, ValidationErrors } from './types';\n\nimport { writeError } from './core/path';\n\ntype ErrorTree = Record<string, unknown>;\ntype UnionIssue = Extract<Issue, { code: 'invalid_union' }>;\n\nfunction isUnionIssue(issue: Issue): issue is UnionIssue {\n  return issue.code === 'invalid_union';\n}\n\nfunction abortable<T>(promise: Promise<T>, signal: AbortSignal): Promise<T | undefined> {\n  if (signal.aborted) return Promise.resolve(undefined);\n\n  return new Promise((resolve, reject) => {\n    const abort = () => resolve(undefined);\n\n    signal.addEventListener('abort', abort, { once: true });\n    void promise.then(\n      (value) => {\n        signal.removeEventListener('abort', abort);\n        resolve(value);\n      },\n      (error: unknown) => {\n        signal.removeEventListener('abort', abort);\n        reject(error);\n      },\n    );\n  });\n}\n\nfunction fieldPath(path: readonly (string | number)[]): string[] {\n  const segments: string[] = [];\n\n  for (const segment of path) {\n    if (typeof segment === 'number') break;\n\n    segments.push(segment);\n  }\n\n  return segments;\n}\n\nfunction prefixIssues(path: readonly (string | number)[], issues: readonly Issue[]): Issue[] {\n  return issues.map((issue) => ({ ...issue, path: [...path, ...issue.path] }));\n}\n\n/** Adapts a Spell Schema into Forge's full-form validator without transforming form values. */\nexport function customValidator<TValues extends Record<string, unknown>>(\n  schema: Schema<unknown, TValues, SchemaMode>,\n): FormValidator<TValues> {\n  return async (values, signal) => {\n    const result = await abortable(schema.safeParseAsync(values), signal);\n\n    if (!result || result.success) return undefined;\n\n    const issues = result.error.issues.flatMap((issue) => {\n      if (!isUnionIssue(issue)) return [issue];\n\n      const bestMatch = result.error.bestMatch(issue);\n\n      return bestMatch ? prefixIssues(issue.path, bestMatch) : [issue];\n    });\n    let fields: ErrorTree = {};\n    let formError: string | undefined;\n\n    for (const issue of issues) {\n      if (issue.path.length === 0) {\n        formError ??= issue.message;\n        continue;\n      }\n\n      fields = writeError(fields, fieldPath(issue.path), issue.message);\n    }\n\n    const errors: ValidationErrors<TValues> = {\n      fields: Object.keys(fields).length === 0 ? undefined : (fields as FormErrors<TValues>),\n      formError,\n    };\n\n    return errors.fields === undefined && errors.formError === undefined ? undefined : errors;\n  };\n}\n"],"mappings":";;;AASA,SAAS,EAAa,GAAmC;CACvD,OAAO,EAAM,SAAS;AACxB;AAEA,SAAS,EAAa,GAAqB,GAA6C;CAGtF,OAFI,EAAO,UAAgB,QAAQ,QAAQ,KAAA,CAAS,IAE7C,IAAI,SAAS,GAAS,MAAW;EACtC,IAAM,UAAc,EAAQ,KAAA,CAAS;EAGrC,AADA,EAAO,iBAAiB,SAAS,GAAO,EAAE,MAAM,GAAK,CAAC,GACtD,EAAa,MACV,MAAU;GAET,AADA,EAAO,oBAAoB,SAAS,CAAK,GACzC,EAAQ,CAAK;EACf,IACC,MAAmB;GAElB,AADA,EAAO,oBAAoB,SAAS,CAAK,GACzC,EAAO,CAAK;EACd,CACF;CACF,CAAC;AACH;AAEA,SAAS,EAAU,GAA8C;CAC/D,IAAM,IAAqB,CAAC;CAE5B,KAAK,IAAM,KAAW,GAAM;EAC1B,IAAI,OAAO,KAAY,UAAU;EAEjC,EAAS,KAAK,CAAO;CACvB;CAEA,OAAO;AACT;AAEA,SAAS,EAAa,GAAoC,GAAmC;CAC3F,OAAO,EAAO,KAAK,OAAW;EAAE,GAAG;EAAO,MAAM,CAAC,GAAG,GAAM,GAAG,EAAM,IAAI;CAAE,EAAE;AAC7E;AAGA,SAAgB,EACd,GACwB;CACxB,OAAO,OAAO,GAAQ,MAAW;EAC/B,IAAM,IAAS,MAAM,EAAU,EAAO,eAAe,CAAM,GAAG,CAAM;EAEpE,IAAI,CAAC,KAAU,EAAO,SAAS;EAE/B,IAAM,IAAS,EAAO,MAAM,OAAO,SAAS,MAAU;GACpD,IAAI,CAAC,EAAa,CAAK,GAAG,OAAO,CAAC,CAAK;GAEvC,IAAM,IAAY,EAAO,MAAM,UAAU,CAAK;GAE9C,OAAO,IAAY,EAAa,EAAM,MAAM,CAAS,IAAI,CAAC,CAAK;EACjE,CAAC,GACG,IAAoB,CAAC,GACrB;EAEJ,KAAK,IAAM,KAAS,GAAQ;GAC1B,IAAI,EAAM,KAAK,WAAW,GAAG;IAC3B,MAAc,EAAM;IACpB;GACF;GAEA,IAAS,EAAW,GAAQ,EAAU,EAAM,IAAI,GAAG,EAAM,OAAO;EAClE;EAEA,IAAM,IAAoC;GACxC,QAAQ,OAAO,KAAK,CAAM,CAAC,CAAC,WAAW,IAAI,KAAA,IAAa;GACxD;EACF;EAEA,OAAO,EAAO,WAAW,KAAA,KAAa,EAAO,cAAc,KAAA,IAAY,KAAA,IAAY;CACrF;AACF"}