@vielzeug/forge 3.0.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/forge.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"forge.js","names":[],"sources":["../src/errors.ts","../src/core/path.ts","../src/_field.ts","../src/_notify.ts","../src/form.ts"],"sourcesContent":["/** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */\nexport class ForgeError extends Error {\n protected static readonly errorName: string = 'ForgeError';\n\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = (new.target as typeof ForgeError).errorName;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when any method is called on a disposed form. */\nexport class ForgeDisposedError extends ForgeError {\n protected static override readonly errorName = 'ForgeDisposedError';\n\n /** @param op The public method name that was called (e.g. `'set'`) — included in the\n * message so a stack trace tells you *what* to guard, not just *that* it's disposed. */\n constructor(op?: string) {\n super(op ? `Cannot call ${op}() on a disposed form` : 'Cannot modify a disposed form');\n }\n}\n\n/** Thrown when form configuration or value structure is invalid. */\nexport class ForgeConfigError extends ForgeError {\n protected static override readonly errorName = 'ForgeConfigError';\n}\n\n/** Thrown when `submit()` is called while a submission is already in progress. */\nexport class ForgeSubmitError extends ForgeError {\n protected static override readonly errorName = 'ForgeSubmitError';\n}\n\n/** Wraps unexpected exceptions from a form validator without converting validation failures into exceptions. */\nexport class ForgeValidationError extends ForgeError {\n protected static override readonly errorName = 'ForgeValidationError';\n}\n","import { isPlainObject as isRecord } from '@vielzeug/arsenal';\n\nimport { ForgeConfigError } from '../errors.js';\nimport type { ValidationIssue } from '../types.js';\n\nconst unsafeKeys = new Set(['__proto__', 'constructor', 'prototype']);\n\nexport { isRecord };\n\nexport function isUnsafeKey(key: string): boolean {\n return !key || unsafeKeys.has(key);\n}\n\ntype RecordValue = Record<string, unknown>;\ntype TreeValue = RecordValue | readonly unknown[];\ntype MetaTree = true | MetaNode;\ninterface MetaNode {\n readonly [key: string]: MetaTree;\n}\nexport type MetaRoot = MetaNode;\n\nexport function assertSafeKey(key: string): void {\n if (isUnsafeKey(key)) throw new ForgeConfigError(`Invalid field key '${key}'.`);\n}\n\nexport function assertArrayIndex(index: number): void {\n if (!Number.isSafeInteger(index) || index < 0) throw new ForgeConfigError(`Invalid array index ${index}.`);\n}\n\nfunction tag(value: object): string {\n return Object.prototype.toString.call(value);\n}\n\nfunction isBlobLeaf(value: object): boolean {\n return tag(value) === '[object Blob]' || tag(value) === '[object File]';\n}\n\nfunction invalidValue(): never {\n throw new ForgeConfigError(\n 'Form values must contain only finite JSON primitives, plain objects, arrays, Date, File, or Blob.',\n );\n}\n\nexport function immutable<T>(value: T, ancestors = new Set<object>()): T {\n if (value === null || value === undefined || typeof value === 'string' || typeof value === 'boolean') return value;\n if (typeof value === 'number') return Number.isFinite(value) ? value : invalidValue();\n if (typeof value !== 'object') return invalidValue();\n\n const date = value as unknown as Date;\n if (tag(value) === '[object Date]' && typeof date.getTime === 'function') {\n const time = date.getTime();\n if (!Number.isFinite(time)) return invalidValue();\n return Object.freeze(new Date(time)) as T;\n }\n\n if (isBlobLeaf(value)) return value;\n if (ancestors.has(value)) throw new ForgeConfigError('Form values must not contain circular references.');\n\n ancestors.add(value);\n try {\n if (Array.isArray(value)) {\n const copy: unknown[] = [];\n for (let index = 0; index < value.length; index++) {\n if (!Object.hasOwn(value, index)) throw new ForgeConfigError('Form arrays must not contain empty slots.');\n copy.push(immutable(value[index], ancestors));\n }\n return Object.freeze(copy) as T;\n }\n\n if (!isRecord(value)) return invalidValue();\n const entries = Object.entries(value).map(([key, child]) => {\n assertSafeKey(key);\n return [key, immutable(child, ancestors)] as const;\n });\n return Object.freeze(Object.fromEntries(entries)) as T;\n } finally {\n ancestors.delete(value);\n }\n}\n\nexport function readAtPath<T>(value: unknown, path: readonly (string | number)[]): T | undefined {\n let current: unknown = value;\n\n for (const key of path) {\n if (typeof key === 'number') {\n if (\n !Array.isArray(current) ||\n !Number.isSafeInteger(key) ||\n key < 0 ||\n key >= current.length ||\n !Object.hasOwn(current, key)\n )\n return undefined;\n\n current = current[key];\n } else {\n if (!isRecord(current) || !Object.hasOwn(current, key)) return undefined;\n\n current = current[key];\n }\n }\n\n return current as T | undefined;\n}\n\nexport function hasAtPath(value: unknown, path: readonly (string | number)[]): boolean {\n let current: unknown = value;\n\n for (const key of path) {\n if (typeof key === 'number') {\n if (\n !Array.isArray(current) ||\n !Number.isSafeInteger(key) ||\n key < 0 ||\n key >= current.length ||\n !Object.hasOwn(current, key)\n )\n return false;\n\n current = current[key];\n } else {\n if (!isRecord(current) || !Object.hasOwn(current, key)) return false;\n\n current = current[key];\n }\n }\n\n return true;\n}\n\nexport function writeAtPath<T extends TreeValue>(value: T, path: readonly (string | number)[], next: unknown): T {\n const [key, ...rest] = path;\n\n if (typeof key === 'number') {\n assertArrayIndex(key);\n if (!Array.isArray(value)) {\n throw new ForgeConfigError(`Cannot index ${key} because the current value is not an array.`);\n }\n\n if (key < 0 || key >= value.length) {\n throw new ForgeConfigError(`Index ${key} is out of range for array of length ${value.length}.`);\n }\n\n if (rest.length === 0) {\n const copy = [...value];\n\n copy[key] = immutable(next);\n\n return Object.freeze(copy) as T;\n }\n\n const copy = [...value];\n\n copy[key] = writeAtPath(value[key] as TreeValue, rest, next);\n\n return Object.freeze(copy) as T;\n }\n\n assertSafeKey(key);\n\n if (!isRecord(value)) {\n throw new ForgeConfigError(`Cannot select '${key}' because the current value is not an object.`);\n }\n\n if (rest.length === 0) return Object.freeze({ ...value, [key]: immutable(next) }) as T;\n\n const child = value[key];\n\n if (child !== undefined && !isRecord(child) && !Array.isArray(child)) {\n throw new ForgeConfigError(`Cannot select '${key}' because it is not an object or array.`);\n }\n\n const childTree = (child ?? {}) as TreeValue;\n\n return Object.freeze({ ...value, [key]: writeAtPath(childTree, rest, next) }) as T;\n}\n\nexport function resetAtPath<T extends TreeValue>(value: T, baseline: T, path: readonly (string | number)[]): T {\n const [key, ...rest] = path;\n\n if (typeof key === 'number') {\n assertArrayIndex(key);\n if (!Array.isArray(value)) return value;\n if (!Array.isArray(baseline) || key >= baseline.length || key >= value.length) return value;\n\n if (rest.length === 0) {\n const copy = [...value];\n\n copy[key] = baseline[key];\n\n return Object.freeze(copy) as T;\n }\n\n const copy = [...value];\n\n copy[key] = resetAtPath(value[key] as TreeValue, baseline[key] as TreeValue, rest);\n\n return Object.freeze(copy) as T;\n }\n\n if (!isRecord(value)) return value;\n\n if (rest.length === 0) {\n if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: (baseline as RecordValue)[key] }) as T;\n\n const { [key]: _removed, ...next } = value;\n\n return Object.freeze(next) as T;\n }\n\n const baselineChild = (baseline as RecordValue)[key];\n\n if (!isRecord(baselineChild) && !Array.isArray(baselineChild)) {\n if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: baselineChild }) as T;\n\n const { [key]: _removed, ...next } = value;\n\n return Object.freeze(next) as T;\n }\n\n const currentChild = value[key];\n const childTree = (isRecord(currentChild) || Array.isArray(currentChild) ? currentChild : {}) as TreeValue;\n\n return Object.freeze({ ...value, [key]: resetAtPath(childTree, baselineChild as TreeValue, rest) }) as T;\n}\n\nexport function writeMeta(meta: MetaRoot, path: readonly (string | number)[], next: boolean): MetaRoot {\n const [key, ...rest] = path;\n if (typeof key === 'number') assertArrayIndex(key);\n const stringKey = String(key);\n const copy: Record<string, MetaTree> = { ...meta };\n\n if (rest.length === 0) {\n if (next) copy[stringKey] = true;\n else delete copy[stringKey];\n } else {\n const child = isRecord(meta[stringKey]) ? (meta[stringKey] as MetaRoot) : {};\n const updated = writeMeta(child, rest, next);\n\n if (Object.keys(updated).length === 0) delete copy[stringKey];\n else copy[stringKey] = updated;\n }\n\n return Object.freeze(copy);\n}\n\nexport function readMeta(meta: MetaRoot, path: readonly (string | number)[]): boolean {\n let current: MetaTree | undefined = meta;\n\n for (const key of path) {\n if (typeof key === 'number' && (!Number.isSafeInteger(key) || key < 0)) return false;\n const stringKey = String(key);\n\n if (!isRecord(current) || !Object.hasOwn(current, stringKey)) return false;\n\n current = current[stringKey] as MetaTree;\n }\n\n return current === true;\n}\n\nexport function touchAll(value: unknown): MetaRoot {\n if (Array.isArray(value)) {\n return Object.freeze(\n Object.fromEntries(\n value.map((child, i) => [\n String(i),\n isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n ]),\n ),\n );\n }\n\n if (!isRecord(value)) return {};\n\n return Object.freeze(\n Object.fromEntries(\n Object.entries(value).map(([key, child]) => [\n key,\n isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n ]),\n ),\n );\n}\n\nexport function pathEquals(a: readonly (string | number)[], b: readonly (string | number)[]): boolean {\n if (a.length !== b.length) return false;\n\n for (let i = 0; i < a.length; i++) {\n if (a[i] !== b[i]) return false;\n }\n\n return true;\n}\n\n/** Derives a single field's error message from the flat issue list. */\nexport function findIssue(\n issues: readonly ValidationIssue[] | undefined,\n path: readonly (string | number)[],\n): string | undefined {\n if (!issues) return undefined;\n\n for (const issue of issues) {\n if (pathEquals(issue.path, path)) return issue.message;\n }\n\n return undefined;\n}\n","import { isEqual } from '@vielzeug/arsenal';\n\nimport {\n assertArrayIndex,\n assertSafeKey,\n findIssue,\n hasAtPath,\n isRecord,\n type MetaRoot,\n readAtPath,\n readMeta,\n} from './core/path.js';\nimport { ForgeConfigError } from './errors.js';\nimport type { Field, FieldState, SubscribeOptions, Unsubscribe, ValidationIssue } from './types.js';\n\ntype FieldSourceState = {\n baseline: unknown;\n issues: readonly ValidationIssue[] | undefined;\n touched: MetaRoot;\n value: unknown;\n};\n\nexport interface FieldAccess {\n abortValidation(): void;\n addListener(listener: (state: FieldSourceState) => void): Unsubscribe;\n ensureActive(operation: string): void;\n invokeListener(listener: () => void): void;\n readState(): FieldSourceState;\n resetValue(path: readonly (string | number)[]): void;\n setTouched(path: readonly (string | number)[], touched: boolean): void;\n setValue(path: readonly (string | number)[], next: unknown | ((previous: unknown) => unknown)): void;\n}\n\nfunction makeFieldState<V>(state: FieldSourceState, path: readonly (string | number)[]): 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: !isEqual(value, baseline) || hasAtPath(state.value, path) !== hasAtPath(state.baseline, path),\n error: findIssue(state.issues, path),\n touched: readMeta(state.touched, path),\n value: value as FieldState<V>['value'],\n });\n}\n\nexport function createField<V>(path: readonly (string | number)[], access: FieldAccess): Field<V> {\n const common = {\n get dirty() {\n return makeFieldState<V>(access.readState(), path).dirty;\n },\n get error() {\n return makeFieldState<V>(access.readState(), path).error;\n },\n reset() {\n access.ensureActive('field().reset');\n access.abortValidation();\n access.resetValue(path);\n },\n set(next: V | ((previous: FieldState<V>['value']) => V)) {\n access.ensureActive('field().set');\n access.abortValidation();\n\n access.setValue(path, next as unknown | ((previous: unknown) => unknown));\n },\n get state() {\n return makeFieldState<V>(access.readState(), path);\n },\n subscribe(listener: (state: FieldState<V>) => void, subscribeOptions: SubscribeOptions = {}): Unsubscribe {\n access.ensureActive('field().subscribe');\n\n let previous = makeFieldState<V>(access.readState(), path);\n\n if (subscribeOptions.immediate) access.invokeListener(() => listener(previous));\n\n const filtered = (state: FieldSourceState) => {\n const next = makeFieldState<V>(state, 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 return access.addListener(filtered);\n },\n touch() {\n access.ensureActive('field().touch');\n access.setTouched(path, true);\n },\n get touched() {\n return makeFieldState<V>(access.readState(), path).touched;\n },\n get value() {\n return makeFieldState<V>(access.readState(), path).value;\n },\n };\n\n return Object.assign(common, {\n field(key: string | number): Field<unknown> {\n if (typeof key === 'number') {\n assertArrayIndex(key);\n const currentVal = readAtPath(access.readState().value, path);\n\n if (currentVal !== undefined && !Array.isArray(currentVal)) {\n throw new ForgeConfigError(`Cannot index ${key} because the current field value is not an array.`);\n }\n\n return createField([...path, key], access);\n }\n\n assertSafeKey(key);\n\n const currentVal = readAtPath(access.readState().value, path);\n\n if (currentVal !== undefined && !isRecord(currentVal)) {\n throw new ForgeConfigError(`Cannot select '${key}' because the current field value is not an object.`);\n }\n\n return createField([...path, key], access);\n },\n }) as unknown as Field<V>;\n}\n","import type { Unsubscribe } from './types.js';\n\nexport interface Notifier<T> {\n add(listener: (value: T) => void): Unsubscribe;\n call(listener: () => void): void;\n clear(): void;\n notify(value: T): void;\n}\n\nfunction rethrowAsync(error: unknown): void {\n queueMicrotask(() => {\n throw error;\n });\n}\n\nexport function createNotifier<T>(onError?: (error: unknown) => void): Notifier<T> {\n const listeners = new Set<(value: T) => void>();\n const pending: T[] = [];\n let notifying = false;\n\n function reportError(error: unknown): void {\n if (!onError) {\n rethrowAsync(error);\n return;\n }\n\n try {\n onError(error);\n } catch (reporterError) {\n rethrowAsync(reporterError);\n }\n }\n\n const call = (listener: () => void): void => {\n try {\n listener();\n } catch (error) {\n reportError(error);\n }\n };\n\n return {\n add(listener) {\n listeners.add(listener);\n return () => listeners.delete(listener);\n },\n call,\n clear() {\n listeners.clear();\n pending.length = 0;\n },\n notify(value) {\n pending.push(value);\n if (notifying) return;\n\n notifying = true;\n try {\n while (pending.length > 0) {\n const next = pending.shift()!;\n for (const listener of [...listeners]) {\n if (listeners.has(listener)) call(() => listener(next));\n }\n }\n } finally {\n notifying = false;\n }\n },\n };\n}\n","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":"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"}
1
+ {"version":3,"file":"forge.js","names":[],"sources":["../src/errors.ts","../src/core/path.ts","../src/_field.ts","../src/_notify.ts","../src/form.ts","../src/plain.ts"],"sourcesContent":["/** Base class for all forge errors. Use `instanceof ForgeError` to catch any forge-originated error. */\nexport class ForgeError extends Error {\n protected static readonly errorName: string = 'ForgeError';\n\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = (new.target as typeof ForgeError).errorName;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\n/** Thrown when any method is called on a disposed form. */\nexport class ForgeDisposedError extends ForgeError {\n protected static override readonly errorName = 'ForgeDisposedError';\n\n /** @param op The public method name that was called (e.g. `'set'`) — included in the\n * message so a stack trace tells you *what* to guard, not just *that* it's disposed. */\n constructor(op?: string) {\n super(op ? `Cannot call ${op}() on a disposed form` : 'Cannot modify a disposed form');\n }\n}\n\n/** Thrown when form configuration or value structure is invalid. */\nexport class ForgeConfigError extends ForgeError {\n protected static override readonly errorName = 'ForgeConfigError';\n}\n\n/** Thrown when `submit()` is called while a submission is already in progress. */\nexport class ForgeSubmitError extends ForgeError {\n protected static override readonly errorName = 'ForgeSubmitError';\n}\n\n/** Wraps unexpected exceptions from a form validator without converting validation failures into exceptions. */\nexport class ForgeValidationError extends ForgeError {\n protected static override readonly errorName = 'ForgeValidationError';\n}\n","import { isPlainObject as isRecord } from '@vielzeug/arsenal';\n\nimport { ForgeConfigError } from '../errors.js';\nimport type { ValidationIssue } from '../types.js';\n\nconst unsafeKeys = new Set(['__proto__', 'constructor', 'prototype']);\n\nexport { isRecord };\n\nexport function isUnsafeKey(key: string): boolean {\n return !key || unsafeKeys.has(key);\n}\n\ntype RecordValue = Record<string, unknown>;\ntype TreeValue = RecordValue | readonly unknown[];\ntype MetaTree = true | MetaNode;\ninterface MetaNode {\n readonly [key: string]: MetaTree;\n}\nexport type MetaRoot = MetaNode;\n\nexport function assertSafeKey(key: string): void {\n if (isUnsafeKey(key)) throw new ForgeConfigError(`Invalid field key '${key}'.`);\n}\n\nexport function assertArrayIndex(index: number): void {\n if (!Number.isSafeInteger(index) || index < 0) throw new ForgeConfigError(`Invalid array index ${index}.`);\n}\n\nfunction tag(value: object): string {\n return Object.prototype.toString.call(value);\n}\n\nfunction isBlobLeaf(value: object): boolean {\n return tag(value) === '[object Blob]' || tag(value) === '[object File]';\n}\n\n/** Formats a value path as `list[0].name` for error messages. */\nexport function formatValuePath(path: readonly (string | number)[]): string {\n let out = '';\n for (const segment of path) {\n if (typeof segment === 'number') out += `[${segment}]`;\n else out += out ? `.${segment}` : segment;\n }\n return out;\n}\n\nfunction pathSuffix(path: readonly (string | number)[]): string {\n return path.length > 0 ? ` at '${formatValuePath(path)}'` : '';\n}\n\nfunction invalidValue(path: readonly (string | number)[]): never {\n throw new ForgeConfigError(\n `Form values must contain only finite JSON primitives, plain objects, arrays, Date, File, or Blob${pathSuffix(path)}.`,\n );\n}\n\nexport function immutable<T>(value: T, ancestors = new Set<object>(), path: (string | number)[] = []): T {\n if (value === null || value === undefined || typeof value === 'string' || typeof value === 'boolean') return value;\n if (typeof value === 'number') return Number.isFinite(value) ? value : invalidValue(path);\n if (typeof value !== 'object') return invalidValue(path);\n\n const date = value as unknown as Date;\n if (tag(value) === '[object Date]' && typeof date.getTime === 'function') {\n const time = date.getTime();\n if (!Number.isFinite(time)) return invalidValue(path);\n return Object.freeze(new Date(time)) as T;\n }\n\n if (isBlobLeaf(value)) return value;\n if (ancestors.has(value))\n throw new ForgeConfigError(`Form values must not contain circular references${pathSuffix(path)}.`);\n\n ancestors.add(value);\n try {\n if (Array.isArray(value)) {\n const copy: unknown[] = [];\n for (let index = 0; index < value.length; index++) {\n path.push(index);\n try {\n if (!Object.hasOwn(value, index))\n throw new ForgeConfigError(`Form arrays must not contain empty slots${pathSuffix(path)}.`);\n copy.push(immutable(value[index], ancestors, path));\n } finally {\n path.pop();\n }\n }\n return Object.freeze(copy) as T;\n }\n\n if (!isRecord(value)) return invalidValue(path);\n const entries = Object.entries(value).map(([key, child]) => {\n assertSafeKey(key);\n path.push(key);\n try {\n return [key, immutable(child, ancestors, path)] as const;\n } finally {\n path.pop();\n }\n });\n return Object.freeze(Object.fromEntries(entries)) as T;\n } finally {\n ancestors.delete(value);\n }\n}\n\n/**\n * Deeply converts a value into the plain shape `immutable()` accepts: primitives pass\n * through, `Date` is cloned, `File`/`Blob` keep identity, arrays map, and class instances\n * flatten to their own enumerable entries. Use as the `normalize` option of `createForm`\n * to hold domain-model classes in form state.\n *\n * Lossy conversions, applied instead of the error `immutable()` would throw: `Map`, `Set`,\n * and other keyless built-ins flatten to `{}` (their entries live on the prototype); sparse\n * array slots are dropped, which shifts later indexes; `NaN`, `Infinity`, functions, and\n * circular branches become `undefined`. Normalize model classes, not arbitrary graphs.\n */\nexport function toPlainValues<T>(value: T, seen = new WeakSet<object>()): T {\n if (value === null || value === undefined || typeof value === 'string' || typeof value === 'boolean') return value;\n if (typeof value === 'number') return Number.isFinite(value) ? value : (undefined as T);\n if (typeof value !== 'object') return undefined as T;\n\n const object = value as unknown as object;\n const date = value as unknown as Date;\n if (tag(object) === '[object Date]' && typeof date.getTime === 'function') {\n const time = date.getTime();\n return (Number.isFinite(time) ? new Date(time) : undefined) as T;\n }\n if (isBlobLeaf(object)) return value;\n if (seen.has(object)) return undefined as T;\n\n seen.add(object);\n try {\n if (Array.isArray(value)) {\n const copy: unknown[] = [];\n for (let index = 0; index < value.length; index++) {\n if (Object.hasOwn(value, index)) copy.push(toPlainValues(value[index], seen));\n }\n return copy as T;\n }\n\n // Plain objects and class instances both flatten to own enumerable entries;\n // unsafe keys are dropped so the result always passes immutable()'s key checks.\n const copy: RecordValue = {};\n for (const [key, child] of Object.entries(object)) {\n if (isUnsafeKey(key)) continue;\n copy[key] = toPlainValues(child, seen);\n }\n return copy as T;\n } finally {\n seen.delete(object);\n }\n}\n\nexport function readAtPath<T>(value: unknown, path: readonly (string | number)[]): T | undefined {\n let current: unknown = value;\n\n for (const key of path) {\n if (typeof key === 'number') {\n if (\n !Array.isArray(current) ||\n !Number.isSafeInteger(key) ||\n key < 0 ||\n key >= current.length ||\n !Object.hasOwn(current, key)\n )\n return undefined;\n\n current = current[key];\n } else {\n if (!isRecord(current) || !Object.hasOwn(current, key)) return undefined;\n\n current = current[key];\n }\n }\n\n return current as T | undefined;\n}\n\nexport function hasAtPath(value: unknown, path: readonly (string | number)[]): boolean {\n let current: unknown = value;\n\n for (const key of path) {\n if (typeof key === 'number') {\n if (\n !Array.isArray(current) ||\n !Number.isSafeInteger(key) ||\n key < 0 ||\n key >= current.length ||\n !Object.hasOwn(current, key)\n )\n return false;\n\n current = current[key];\n } else {\n if (!isRecord(current) || !Object.hasOwn(current, key)) return false;\n\n current = current[key];\n }\n }\n\n return true;\n}\n\nexport function writeAtPath<T extends TreeValue>(\n value: T,\n path: readonly (string | number)[],\n next: unknown,\n fullPath: readonly (string | number)[] = [],\n): T {\n const [key, ...rest] = path;\n\n if (typeof key === 'number') {\n assertArrayIndex(key);\n if (!Array.isArray(value)) {\n throw new ForgeConfigError(`Cannot index ${key} because the current value is not an array.`);\n }\n\n if (key < 0 || key >= value.length) {\n throw new ForgeConfigError(`Index ${key} is out of range for array of length ${value.length}.`);\n }\n\n if (rest.length === 0) {\n const copy = [...value];\n\n copy[key] = immutable(next, new Set<object>(), [...fullPath, key]);\n\n return Object.freeze(copy) as T;\n }\n\n const copy = [...value];\n\n copy[key] = writeAtPath(value[key] as TreeValue, rest, next, [...fullPath, key]);\n\n return Object.freeze(copy) as T;\n }\n\n assertSafeKey(key);\n\n if (!isRecord(value)) {\n throw new ForgeConfigError(`Cannot select '${key}' because the current value is not an object.`);\n }\n\n if (rest.length === 0)\n return Object.freeze({ ...value, [key]: immutable(next, new Set<object>(), [...fullPath, key]) }) as T;\n\n const child = value[key];\n\n if (child !== undefined && !isRecord(child) && !Array.isArray(child)) {\n throw new ForgeConfigError(`Cannot select '${key}' because it is not an object or array.`);\n }\n\n const childTree = (child ?? {}) as TreeValue;\n\n return Object.freeze({ ...value, [key]: writeAtPath(childTree, rest, next, [...fullPath, key]) }) as T;\n}\n\nexport function resetAtPath<T extends TreeValue>(value: T, baseline: T, path: readonly (string | number)[]): T {\n const [key, ...rest] = path;\n\n if (typeof key === 'number') {\n assertArrayIndex(key);\n if (!Array.isArray(value)) return value;\n if (!Array.isArray(baseline) || key >= baseline.length || key >= value.length) return value;\n\n if (rest.length === 0) {\n const copy = [...value];\n\n copy[key] = baseline[key];\n\n return Object.freeze(copy) as T;\n }\n\n const copy = [...value];\n\n copy[key] = resetAtPath(value[key] as TreeValue, baseline[key] as TreeValue, rest);\n\n return Object.freeze(copy) as T;\n }\n\n if (!isRecord(value)) return value;\n\n if (rest.length === 0) {\n if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: (baseline as RecordValue)[key] }) as T;\n\n const { [key]: _removed, ...next } = value;\n\n return Object.freeze(next) as T;\n }\n\n const baselineChild = (baseline as RecordValue)[key];\n\n if (!isRecord(baselineChild) && !Array.isArray(baselineChild)) {\n if (Object.hasOwn(baseline, key)) return Object.freeze({ ...value, [key]: baselineChild }) as T;\n\n const { [key]: _removed, ...next } = value;\n\n return Object.freeze(next) as T;\n }\n\n const currentChild = value[key];\n const childTree = (isRecord(currentChild) || Array.isArray(currentChild) ? currentChild : {}) as TreeValue;\n\n return Object.freeze({ ...value, [key]: resetAtPath(childTree, baselineChild as TreeValue, rest) }) as T;\n}\n\nexport function writeMeta(meta: MetaRoot, path: readonly (string | number)[], next: boolean): MetaRoot {\n const [key, ...rest] = path;\n if (typeof key === 'number') assertArrayIndex(key);\n const stringKey = String(key);\n const copy: Record<string, MetaTree> = { ...meta };\n\n if (rest.length === 0) {\n if (next) copy[stringKey] = true;\n else delete copy[stringKey];\n } else {\n const child = isRecord(meta[stringKey]) ? (meta[stringKey] as MetaRoot) : {};\n const updated = writeMeta(child, rest, next);\n\n if (Object.keys(updated).length === 0) delete copy[stringKey];\n else copy[stringKey] = updated;\n }\n\n return Object.freeze(copy);\n}\n\nexport function readMeta(meta: MetaRoot, path: readonly (string | number)[]): boolean {\n let current: MetaTree | undefined = meta;\n\n for (const key of path) {\n if (typeof key === 'number' && (!Number.isSafeInteger(key) || key < 0)) return false;\n const stringKey = String(key);\n\n if (!isRecord(current) || !Object.hasOwn(current, stringKey)) return false;\n\n current = current[stringKey] as MetaTree;\n }\n\n return current === true;\n}\n\nexport function touchAll(value: unknown): MetaRoot {\n if (Array.isArray(value)) {\n return Object.freeze(\n Object.fromEntries(\n value.map((child, i) => [\n String(i),\n isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n ]),\n ),\n );\n }\n\n if (!isRecord(value)) return {};\n\n return Object.freeze(\n Object.fromEntries(\n Object.entries(value).map(([key, child]) => [\n key,\n isRecord(child) || Array.isArray(child) ? touchAll(child) : (true as const),\n ]),\n ),\n );\n}\n\nexport function pathEquals(a: readonly (string | number)[], b: readonly (string | number)[]): boolean {\n if (a.length !== b.length) return false;\n\n for (let i = 0; i < a.length; i++) {\n if (a[i] !== b[i]) return false;\n }\n\n return true;\n}\n\n/** Derives a single field's error message from the flat issue list. */\nexport function findIssue(\n issues: readonly ValidationIssue[] | undefined,\n path: readonly (string | number)[],\n): string | undefined {\n if (!issues) return undefined;\n\n for (const issue of issues) {\n if (pathEquals(issue.path, path)) return issue.message;\n }\n\n return undefined;\n}\n","import { isEqual } from '@vielzeug/arsenal';\n\nimport {\n assertArrayIndex,\n assertSafeKey,\n findIssue,\n hasAtPath,\n isRecord,\n type MetaRoot,\n readAtPath,\n readMeta,\n} from './core/path.js';\nimport { ForgeConfigError } from './errors.js';\nimport type { Field, FieldState, SubscribeOptions, Unsubscribe, ValidationIssue } from './types.js';\n\ntype FieldSourceState = {\n baseline: unknown;\n issues: readonly ValidationIssue[] | undefined;\n touched: MetaRoot;\n value: unknown;\n};\n\nexport interface FieldAccess {\n abortValidation(): void;\n addListener(listener: (state: FieldSourceState) => void): Unsubscribe;\n ensureActive(operation: string): void;\n invokeListener(listener: () => void): void;\n readState(): FieldSourceState;\n resetValue(path: readonly (string | number)[]): void;\n setTouched(path: readonly (string | number)[], touched: boolean): void;\n setValue(path: readonly (string | number)[], next: unknown | ((previous: unknown) => unknown)): void;\n}\n\nfunction makeFieldState<V>(state: FieldSourceState, path: readonly (string | number)[]): 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: !isEqual(value, baseline) || hasAtPath(state.value, path) !== hasAtPath(state.baseline, path),\n error: findIssue(state.issues, path),\n touched: readMeta(state.touched, path),\n value: value as FieldState<V>['value'],\n });\n}\n\nexport function createField<V>(path: readonly (string | number)[], access: FieldAccess): Field<V> {\n const common = {\n get dirty() {\n return makeFieldState<V>(access.readState(), path).dirty;\n },\n get error() {\n return makeFieldState<V>(access.readState(), path).error;\n },\n reset() {\n access.ensureActive('field().reset');\n access.abortValidation();\n access.resetValue(path);\n },\n set(next: V | ((previous: FieldState<V>['value']) => V)) {\n access.ensureActive('field().set');\n access.abortValidation();\n\n access.setValue(path, next as unknown | ((previous: unknown) => unknown));\n },\n get state() {\n return makeFieldState<V>(access.readState(), path);\n },\n subscribe(listener: (state: FieldState<V>) => void, subscribeOptions: SubscribeOptions = {}): Unsubscribe {\n access.ensureActive('field().subscribe');\n\n let previous = makeFieldState<V>(access.readState(), path);\n\n if (subscribeOptions.immediate) access.invokeListener(() => listener(previous));\n\n const filtered = (state: FieldSourceState) => {\n const next = makeFieldState<V>(state, 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 return access.addListener(filtered);\n },\n touch() {\n access.ensureActive('field().touch');\n access.setTouched(path, true);\n },\n get touched() {\n return makeFieldState<V>(access.readState(), path).touched;\n },\n get value() {\n return makeFieldState<V>(access.readState(), path).value;\n },\n };\n\n return Object.assign(common, {\n field(key: string | number): Field<unknown> {\n if (typeof key === 'number') {\n assertArrayIndex(key);\n const currentVal = readAtPath(access.readState().value, path);\n\n if (currentVal !== undefined && !Array.isArray(currentVal)) {\n throw new ForgeConfigError(`Cannot index ${key} because the current field value is not an array.`);\n }\n\n return createField([...path, key], access);\n }\n\n assertSafeKey(key);\n\n const currentVal = readAtPath(access.readState().value, path);\n\n if (currentVal !== undefined && !isRecord(currentVal)) {\n throw new ForgeConfigError(`Cannot select '${key}' because the current field value is not an object.`);\n }\n\n return createField([...path, key], access);\n },\n }) as unknown as Field<V>;\n}\n","import type { Unsubscribe } from './types.js';\n\nexport interface Notifier<T> {\n add(listener: (value: T) => void): Unsubscribe;\n call(listener: () => void): void;\n clear(): void;\n notify(value: T): void;\n}\n\nfunction rethrowAsync(error: unknown): void {\n queueMicrotask(() => {\n throw error;\n });\n}\n\nexport function createNotifier<T>(onError?: (error: unknown) => void): Notifier<T> {\n const listeners = new Set<(value: T) => void>();\n const pending: T[] = [];\n let notifying = false;\n\n function reportError(error: unknown): void {\n if (!onError) {\n rethrowAsync(error);\n return;\n }\n\n try {\n onError(error);\n } catch (reporterError) {\n rethrowAsync(reporterError);\n }\n }\n\n const call = (listener: () => void): void => {\n try {\n listener();\n } catch (error) {\n reportError(error);\n }\n };\n\n return {\n add(listener) {\n listeners.add(listener);\n return () => listeners.delete(listener);\n },\n call,\n clear() {\n listeners.clear();\n pending.length = 0;\n },\n notify(value) {\n pending.push(value);\n if (notifying) return;\n\n notifying = true;\n try {\n while (pending.length > 0) {\n const next = pending.shift()!;\n for (const listener of [...listeners]) {\n if (listeners.has(listener)) call(() => listener(next));\n }\n }\n } finally {\n notifying = false;\n }\n },\n };\n}\n","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 normalize = options.normalize;\n const prepare = (value: unknown): unknown => (normalize ? normalize(value) : value);\n const initial = immutable(prepare(options.initialValues) as TValues);\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 raw = typeof next === 'function' ? next(previous) : next;\n const value = prepare(raw);\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 patch(next) {\n ensureActive('patch');\n abortValidation();\n\n write((c) => {\n const partial =\n typeof next === 'function'\n ? (next as (previous: Form<TValues>['value']) => Partial<TValues>)(c.value as Form<TValues>['value'])\n : next;\n const merged = { ...c.value, ...partial };\n revision++;\n validatedSnapshot = undefined;\n return { ...c, issues: undefined, validity: 'unknown', value: immutable(prepare(merged) as TValues) };\n });\n },\n reset(next) {\n ensureActive('reset');\n abortValidation();\n\n const replacement = next === undefined ? undefined : immutable(prepare(next) as TValues);\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(prepare(value) as TValues) };\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","import { toPlainValues as flattenValue } from './core/path.js';\n\n/**\n * Deeply converts a value into the plain shape Forge accepts: primitives pass through,\n * `Date` is cloned, `File`/`Blob` keep identity, arrays map, and class instances flatten to\n * their own enumerable entries. Unsafe keys (`__proto__`, `constructor`, `prototype`) are\n * dropped, so the output always passes value validation. Use as the `normalize` option of\n * `createForm` to hold domain-model classes in form state.\n *\n * Lossy conversions, applied instead of the error an un-normalized write would throw:\n * `Map`, `Set`, and other keyless built-ins flatten to `{}` (their entries live on the\n * prototype); sparse array slots are dropped, which shifts later indexes; `NaN`, `Infinity`,\n * functions, and circular branches become `undefined`. Normalize model classes, not\n * arbitrary graphs. The type parameter is a convenience cast — the flattened shape differs\n * from the input type whenever class instances are present.\n *\n * This is a public wrapper so the emitted declaration does not name `@vielzeug/arsenal`\n * symbols: exporting the `core/path.ts` original directly pulls arsenal's extensionless\n * re-exports into the NodeNext declaration graph that `test:types` compiles. Keep the\n * implementation in `core/path.ts` beside the `immutable()` leaf rules it mirrors.\n */\nexport function toPlainValues<T>(value: T): T {\n return flattenValue(value);\n}\n"],"mappings":"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"}
package/dist/form.cjs CHANGED
@@ -1,2 +1,2 @@
1
- const e=require("./errors.cjs"),t=require("./core/path.cjs"),n=require("./_field.cjs"),r=require("./_notify.cjs");let i=require("@vielzeug/arsenal");function a(n){if(n!==void 0&&n.length!==0)return Object.freeze(n.map(n=>{if(!n||typeof n.message!=`string`||!Array.isArray(n.path))throw new e.ForgeConfigError(`Validators must return issues with a string message and array path.`);let r=n.path.map(n=>{if(typeof n==`number`){if(!Number.isSafeInteger(n)||n<0)throw new e.ForgeConfigError(`Invalid issue path index ${n}.`);return n}if(typeof n==`string`)return t.assertSafeKey(n),n;throw new e.ForgeConfigError(`Issue paths may contain only string keys and non-negative integer indexes.`)});return Object.freeze({message:n.message,path:Object.freeze(r)})}))}function o(e){return Object.freeze({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,validating:e.isValidating,validity:e.validity})}function s(s){let c=t.immutable(s.initialValues),l=r.createNotifier(s.onSubscriberError),u=new AbortController,d=!1,f=!1,p=[],m,h=0,g,_={baseline:c,isSubmitting:!1,issues:void 0,isValidating:!1,submitCount:0,touched:{},validity:`unknown`,value:c},v=o(_);function y(t){if(d)throw new e.ForgeDisposedError(t)}function b(e){if(p.push(e),!f){f=!0;try{for(;p.length>0;)_=Object.freeze(p.shift()(_)),v=o(_),l.notify(_)}finally{f=!1}}}function x(){m?.abort()}let S={abortValidation:x,addListener:l.add,ensureActive:y,invokeListener:l.call,readState:()=>_,resetValue(e){b(n=>(h++,g=void 0,{...n,touched:t.writeMeta(n.touched,e,!1),validity:`unknown`,value:t.resetAtPath(n.value,n.baseline,e)}))},setTouched(e,n){b(r=>({...r,touched:t.writeMeta(r.touched,e,n)}))},setValue(e,n){b(r=>{let i=t.readAtPath(r.value,e),a=typeof n==`function`?n(i):n;return h++,g=void 0,{...r,validity:`unknown`,value:t.writeAtPath(r.value,e,a)}})}};async function C(t){y(`validate`),x();let n=new AbortController,r=t?AbortSignal.any([n.signal,t]):n.signal;if(r.aborted)return Object.freeze({status:`aborted`});let o=_.value,c=h;m=n,g=void 0,b(e=>({...e,isValidating:!0}));try{if(r.aborted||h!==c)return Object.freeze({status:`aborted`});let e=s.validate?await(0,i.abortable)(Promise.resolve(s.validate(o,r)),r):void 0;if(r.aborted||m!==n||h!==c)return Object.freeze({status:`aborted`});let t=a(e),l=t===void 0?`valid`:`invalid`;return m=void 0,b(e=>({...e,issues:t,isValidating:!1,validity:l})),r.aborted||h!==c||m!==void 0?Object.freeze({status:`aborted`}):(g=l===`valid`?{revision:h,value:o}:void 0,Object.freeze(l===`valid`?{status:`valid`}:{issues:t,status:`invalid`}))}catch(t){if(r.aborted||m!==n)return Object.freeze({status:`aborted`});throw new e.ForgeValidationError(`Form validation failed.`,{cause:t})}finally{m===n&&(m=void 0,d||b(e=>({...e,isValidating:!1})))}}let w={get disposalSignal(){return u.signal},dispose(){d||(d=!0,p.length=0,g=void 0,u.abort(),x(),l.clear())},get disposed(){return d},field(r){if(t.assertSafeKey(r),!(0,i.isPlainObject)(_.value))throw new e.ForgeConfigError(`Form value must be an object.`);return n.createField([r],S)},reset(e){y(`reset`),x();let n=e===void 0?void 0:t.immutable(e);b(e=>{let t=n??e.baseline;return h++,g=void 0,{...e,baseline:t,issues:void 0,touched:{},validity:`unknown`,value:t}})},set(e){y(`set`),x(),b(n=>{let r=typeof e==`function`?e(n.value):e;return h++,g=void 0,{...n,issues:void 0,validity:`unknown`,value:t.immutable(r)}})},get state(){return v},async submit(n,r){if(y(`submit`),_.isSubmitting)throw new e.ForgeSubmitError(`submit() called while a submission is already in progress`);let i=r?AbortSignal.any([u.signal,r]):u.signal;b(e=>({...e,isSubmitting:!0,submitCount:e.submitCount+1,touched:t.touchAll(e.value)}));try{let e=await C(r);if(e.status===`aborted`)return Object.freeze({status:`aborted`});if(e.status===`invalid`)return Object.freeze({issues:e.issues,status:`invalid`});let t=g;if(!t||t.revision!==h||i.aborted)return Object.freeze({status:`aborted`});try{return Object.freeze({status:`ok`,value:await n(t.value,i)})}catch(e){if(i.aborted)return Object.freeze({status:`aborted`});throw e}}finally{d||b(e=>({...e,isSubmitting:!1}))}},subscribe(e,t={}){return y(`subscribe`),t.immediate&&l.call(()=>e(v)),l.add(()=>e(v))},[Symbol.dispose](){w.dispose()},validate:C,get value(){return _.value}};return w}exports.createForm=s;
1
+ const e=require("./errors.cjs"),t=require("./core/path.cjs"),n=require("./_field.cjs"),r=require("./_notify.cjs");let i=require("@vielzeug/arsenal");function a(n){if(n!==void 0&&n.length!==0)return Object.freeze(n.map(n=>{if(!n||typeof n.message!=`string`||!Array.isArray(n.path))throw new e.ForgeConfigError(`Validators must return issues with a string message and array path.`);let r=n.path.map(n=>{if(typeof n==`number`){if(!Number.isSafeInteger(n)||n<0)throw new e.ForgeConfigError(`Invalid issue path index ${n}.`);return n}if(typeof n==`string`)return t.assertSafeKey(n),n;throw new e.ForgeConfigError(`Issue paths may contain only string keys and non-negative integer indexes.`)});return Object.freeze({message:n.message,path:Object.freeze(r)})}))}function o(e){return Object.freeze({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,validating:e.isValidating,validity:e.validity})}function s(s){let c=s.normalize,l=e=>c?c(e):e,u=t.immutable(l(s.initialValues)),d=r.createNotifier(s.onSubscriberError),f=new AbortController,p=!1,m=!1,h=[],g,_=0,v,y={baseline:u,isSubmitting:!1,issues:void 0,isValidating:!1,submitCount:0,touched:{},validity:`unknown`,value:u},b=o(y);function x(t){if(p)throw new e.ForgeDisposedError(t)}function S(e){if(h.push(e),!m){m=!0;try{for(;h.length>0;)y=Object.freeze(h.shift()(y)),b=o(y),d.notify(y)}finally{m=!1}}}function C(){g?.abort()}let w={abortValidation:C,addListener:d.add,ensureActive:x,invokeListener:d.call,readState:()=>y,resetValue(e){S(n=>(_++,v=void 0,{...n,touched:t.writeMeta(n.touched,e,!1),validity:`unknown`,value:t.resetAtPath(n.value,n.baseline,e)}))},setTouched(e,n){S(r=>({...r,touched:t.writeMeta(r.touched,e,n)}))},setValue(e,n){S(r=>{let i=t.readAtPath(r.value,e),a=typeof n==`function`?n(i):n,o=l(a);return _++,v=void 0,{...r,validity:`unknown`,value:t.writeAtPath(r.value,e,o)}})}};async function T(t){x(`validate`),C();let n=new AbortController,r=t?AbortSignal.any([n.signal,t]):n.signal;if(r.aborted)return Object.freeze({status:`aborted`});let o=y.value,c=_;g=n,v=void 0,S(e=>({...e,isValidating:!0}));try{if(r.aborted||_!==c)return Object.freeze({status:`aborted`});let e=s.validate?await(0,i.abortable)(Promise.resolve(s.validate(o,r)),r):void 0;if(r.aborted||g!==n||_!==c)return Object.freeze({status:`aborted`});let t=a(e),l=t===void 0?`valid`:`invalid`;return g=void 0,S(e=>({...e,issues:t,isValidating:!1,validity:l})),r.aborted||_!==c||g!==void 0?Object.freeze({status:`aborted`}):(v=l===`valid`?{revision:_,value:o}:void 0,Object.freeze(l===`valid`?{status:`valid`}:{issues:t,status:`invalid`}))}catch(t){if(r.aborted||g!==n)return Object.freeze({status:`aborted`});throw new e.ForgeValidationError(`Form validation failed.`,{cause:t})}finally{g===n&&(g=void 0,p||S(e=>({...e,isValidating:!1})))}}let E={get disposalSignal(){return f.signal},dispose(){p||(p=!0,h.length=0,v=void 0,f.abort(),C(),d.clear())},get disposed(){return p},field(r){if(t.assertSafeKey(r),!(0,i.isPlainObject)(y.value))throw new e.ForgeConfigError(`Form value must be an object.`);return n.createField([r],w)},patch(e){x(`patch`),C(),S(n=>{let r=typeof e==`function`?e(n.value):e,i={...n.value,...r};return _++,v=void 0,{...n,issues:void 0,validity:`unknown`,value:t.immutable(l(i))}})},reset(e){x(`reset`),C();let n=e===void 0?void 0:t.immutable(l(e));S(e=>{let t=n??e.baseline;return _++,v=void 0,{...e,baseline:t,issues:void 0,touched:{},validity:`unknown`,value:t}})},set(e){x(`set`),C(),S(n=>{let r=typeof e==`function`?e(n.value):e;return _++,v=void 0,{...n,issues:void 0,validity:`unknown`,value:t.immutable(l(r))}})},get state(){return b},async submit(n,r){if(x(`submit`),y.isSubmitting)throw new e.ForgeSubmitError(`submit() called while a submission is already in progress`);let i=r?AbortSignal.any([f.signal,r]):f.signal;S(e=>({...e,isSubmitting:!0,submitCount:e.submitCount+1,touched:t.touchAll(e.value)}));try{let e=await T(r);if(e.status===`aborted`)return Object.freeze({status:`aborted`});if(e.status===`invalid`)return Object.freeze({issues:e.issues,status:`invalid`});let t=v;if(!t||t.revision!==_||i.aborted)return Object.freeze({status:`aborted`});try{return Object.freeze({status:`ok`,value:await n(t.value,i)})}catch(e){if(i.aborted)return Object.freeze({status:`aborted`});throw e}}finally{p||S(e=>({...e,isSubmitting:!1}))}},subscribe(e,t={}){return x(`subscribe`),t.immediate&&d.call(()=>e(b)),d.add(()=>e(b))},[Symbol.dispose](){E.dispose()},validate:T,get value(){return y.value}};return E}exports.createForm=s;
2
2
  //# sourceMappingURL=form.cjs.map
package/dist/form.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"form.cjs","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":"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"}
1
+ {"version":3,"file":"form.cjs","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 normalize = options.normalize;\n const prepare = (value: unknown): unknown => (normalize ? normalize(value) : value);\n const initial = immutable(prepare(options.initialValues) as TValues);\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 raw = typeof next === 'function' ? next(previous) : next;\n const value = prepare(raw);\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 patch(next) {\n ensureActive('patch');\n abortValidation();\n\n write((c) => {\n const partial =\n typeof next === 'function'\n ? (next as (previous: Form<TValues>['value']) => Partial<TValues>)(c.value as Form<TValues>['value'])\n : next;\n const merged = { ...c.value, ...partial };\n revision++;\n validatedSnapshot = undefined;\n return { ...c, issues: undefined, validity: 'unknown', value: immutable(prepare(merged) as TValues) };\n });\n },\n reset(next) {\n ensureActive('reset');\n abortValidation();\n\n const replacement = next === undefined ? undefined : immutable(prepare(next) as TValues);\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(prepare(value) as TValues) };\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":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../src/form.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EAQZ,MAAM,YAAY,CAAC;AAsDpB,+GAA+G;AAC/G,wBAAgB,UAAU,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAuPhH"}
1
+ {"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../src/form.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EAQZ,MAAM,YAAY,CAAC;AAsDpB,+GAA+G;AAC/G,wBAAgB,UAAU,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAyQhH"}
package/dist/form.js CHANGED
@@ -34,40 +34,40 @@ function g(e) {
34
34
  });
35
35
  }
36
36
  function _(_) {
37
- let v = a(_.initialValues), y = p(_.onSubscriberError), b = new AbortController(), x = !1, S = !1, C = [], w, T = 0, E, D = {
38
- baseline: v,
37
+ let v = _.normalize, y = (e) => v ? v(e) : e, b = a(y(_.initialValues)), x = p(_.onSubscriberError), S = new AbortController(), C = !1, w = !1, T = [], E, D = 0, O, k = {
38
+ baseline: b,
39
39
  isSubmitting: !1,
40
40
  issues: void 0,
41
41
  isValidating: !1,
42
42
  submitCount: 0,
43
43
  touched: {},
44
44
  validity: "unknown",
45
- value: v
46
- }, O = g(D);
47
- function k(e) {
48
- if (x) throw new t(e);
45
+ value: b
46
+ }, A = g(k);
47
+ function j(e) {
48
+ if (C) throw new t(e);
49
49
  }
50
- function A(e) {
51
- if (C.push(e), !S) {
52
- S = !0;
50
+ function M(e) {
51
+ if (T.push(e), !w) {
52
+ w = !0;
53
53
  try {
54
- for (; C.length > 0;) D = Object.freeze(C.shift()(D)), O = g(D), y.notify(D);
54
+ for (; T.length > 0;) k = Object.freeze(T.shift()(k)), A = g(k), x.notify(k);
55
55
  } finally {
56
- S = !1;
56
+ w = !1;
57
57
  }
58
58
  }
59
59
  }
60
- function j() {
61
- w?.abort();
60
+ function N() {
61
+ E?.abort();
62
62
  }
63
- let M = {
64
- abortValidation: j,
65
- addListener: y.add,
66
- ensureActive: k,
67
- invokeListener: y.call,
68
- readState: () => D,
63
+ let P = {
64
+ abortValidation: N,
65
+ addListener: x.add,
66
+ ensureActive: j,
67
+ invokeListener: x.call,
68
+ readState: () => k,
69
69
  resetValue(e) {
70
- A((t) => (T++, E = void 0, {
70
+ M((t) => (D++, O = void 0, {
71
71
  ...t,
72
72
  touched: d(t.touched, e, !1),
73
73
  validity: "unknown",
@@ -75,78 +75,92 @@ function _(_) {
75
75
  }));
76
76
  },
77
77
  setTouched(e, t) {
78
- A((n) => ({
78
+ M((n) => ({
79
79
  ...n,
80
80
  touched: d(n.touched, e, t)
81
81
  }));
82
82
  },
83
83
  setValue(e, t) {
84
- A((n) => {
85
- let r = s(n.value, e), i = typeof t == "function" ? t(r) : t;
86
- return T++, E = void 0, {
84
+ M((n) => {
85
+ let r = s(n.value, e), i = typeof t == "function" ? t(r) : t, a = y(i);
86
+ return D++, O = void 0, {
87
87
  ...n,
88
88
  validity: "unknown",
89
- value: u(n.value, e, i)
89
+ value: u(n.value, e, a)
90
90
  };
91
91
  });
92
92
  }
93
93
  };
94
- async function N(e) {
95
- k("validate"), j();
94
+ async function F(e) {
95
+ j("validate"), N();
96
96
  let t = new AbortController(), n = e ? AbortSignal.any([t.signal, e]) : t.signal;
97
97
  if (n.aborted) return Object.freeze({ status: "aborted" });
98
- let i = D.value, a = T;
99
- w = t, E = void 0, A((e) => ({
98
+ let i = k.value, a = D;
99
+ E = t, O = void 0, M((e) => ({
100
100
  ...e,
101
101
  isValidating: !0
102
102
  }));
103
103
  try {
104
- if (n.aborted || T !== a) return Object.freeze({ status: "aborted" });
104
+ if (n.aborted || D !== a) return Object.freeze({ status: "aborted" });
105
105
  let e = _.validate ? await m(Promise.resolve(_.validate(i, n)), n) : void 0;
106
- if (n.aborted || w !== t || T !== a) return Object.freeze({ status: "aborted" });
106
+ if (n.aborted || E !== t || D !== a) return Object.freeze({ status: "aborted" });
107
107
  let r = h(e), o = r === void 0 ? "valid" : "invalid";
108
- return w = void 0, A((e) => ({
108
+ return E = void 0, M((e) => ({
109
109
  ...e,
110
110
  issues: r,
111
111
  isValidating: !1,
112
112
  validity: o
113
- })), n.aborted || T !== a || w !== void 0 ? Object.freeze({ status: "aborted" }) : (E = o === "valid" ? {
114
- revision: T,
113
+ })), n.aborted || D !== a || E !== void 0 ? Object.freeze({ status: "aborted" }) : (O = o === "valid" ? {
114
+ revision: D,
115
115
  value: i
116
116
  } : void 0, Object.freeze(o === "valid" ? { status: "valid" } : {
117
117
  issues: r,
118
118
  status: "invalid"
119
119
  }));
120
120
  } catch (e) {
121
- if (n.aborted || w !== t) return Object.freeze({ status: "aborted" });
121
+ if (n.aborted || E !== t) return Object.freeze({ status: "aborted" });
122
122
  throw new r("Form validation failed.", { cause: e });
123
123
  } finally {
124
- w === t && (w = void 0, x || A((e) => ({
124
+ E === t && (E = void 0, C || M((e) => ({
125
125
  ...e,
126
126
  isValidating: !1
127
127
  })));
128
128
  }
129
129
  }
130
- let P = {
130
+ let I = {
131
131
  get disposalSignal() {
132
- return b.signal;
132
+ return S.signal;
133
133
  },
134
134
  dispose() {
135
- x || (x = !0, C.length = 0, E = void 0, b.abort(), j(), y.clear());
135
+ C || (C = !0, T.length = 0, O = void 0, S.abort(), N(), x.clear());
136
136
  },
137
137
  get disposed() {
138
- return x;
138
+ return C;
139
139
  },
140
140
  field(t) {
141
- if (i(t), !o(D.value)) throw new e("Form value must be an object.");
142
- return f([t], M);
141
+ if (i(t), !o(k.value)) throw new e("Form value must be an object.");
142
+ return f([t], P);
143
+ },
144
+ patch(e) {
145
+ j("patch"), N(), M((t) => {
146
+ let n = typeof e == "function" ? e(t.value) : e, r = {
147
+ ...t.value,
148
+ ...n
149
+ };
150
+ return D++, O = void 0, {
151
+ ...t,
152
+ issues: void 0,
153
+ validity: "unknown",
154
+ value: a(y(r))
155
+ };
156
+ });
143
157
  },
144
158
  reset(e) {
145
- k("reset"), j();
146
- let t = e === void 0 ? void 0 : a(e);
147
- A((e) => {
159
+ j("reset"), N();
160
+ let t = e === void 0 ? void 0 : a(y(e));
161
+ M((e) => {
148
162
  let n = t ?? e.baseline;
149
- return T++, E = void 0, {
163
+ return D++, O = void 0, {
150
164
  ...e,
151
165
  baseline: n,
152
166
  issues: void 0,
@@ -157,37 +171,37 @@ function _(_) {
157
171
  });
158
172
  },
159
173
  set(e) {
160
- k("set"), j(), A((t) => {
174
+ j("set"), N(), M((t) => {
161
175
  let n = typeof e == "function" ? e(t.value) : e;
162
- return T++, E = void 0, {
176
+ return D++, O = void 0, {
163
177
  ...t,
164
178
  issues: void 0,
165
179
  validity: "unknown",
166
- value: a(n)
180
+ value: a(y(n))
167
181
  };
168
182
  });
169
183
  },
170
184
  get state() {
171
- return O;
185
+ return A;
172
186
  },
173
187
  async submit(e, t) {
174
- if (k("submit"), D.isSubmitting) throw new n("submit() called while a submission is already in progress");
175
- let r = t ? AbortSignal.any([b.signal, t]) : b.signal;
176
- A((e) => ({
188
+ if (j("submit"), k.isSubmitting) throw new n("submit() called while a submission is already in progress");
189
+ let r = t ? AbortSignal.any([S.signal, t]) : S.signal;
190
+ M((e) => ({
177
191
  ...e,
178
192
  isSubmitting: !0,
179
193
  submitCount: e.submitCount + 1,
180
194
  touched: l(e.value)
181
195
  }));
182
196
  try {
183
- let n = await N(t);
197
+ let n = await F(t);
184
198
  if (n.status === "aborted") return Object.freeze({ status: "aborted" });
185
199
  if (n.status === "invalid") return Object.freeze({
186
200
  issues: n.issues,
187
201
  status: "invalid"
188
202
  });
189
- let i = E;
190
- if (!i || i.revision !== T || r.aborted) return Object.freeze({ status: "aborted" });
203
+ let i = O;
204
+ if (!i || i.revision !== D || r.aborted) return Object.freeze({ status: "aborted" });
191
205
  try {
192
206
  return Object.freeze({
193
207
  status: "ok",
@@ -198,24 +212,24 @@ function _(_) {
198
212
  throw e;
199
213
  }
200
214
  } finally {
201
- x || A((e) => ({
215
+ C || M((e) => ({
202
216
  ...e,
203
217
  isSubmitting: !1
204
218
  }));
205
219
  }
206
220
  },
207
221
  subscribe(e, t = {}) {
208
- return k("subscribe"), t.immediate && y.call(() => e(O)), y.add(() => e(O));
222
+ return j("subscribe"), t.immediate && x.call(() => e(A)), x.add(() => e(A));
209
223
  },
210
224
  [Symbol.dispose]() {
211
- P.dispose();
225
+ I.dispose();
212
226
  },
213
- validate: N,
227
+ validate: F,
214
228
  get value() {
215
- return D.value;
229
+ return k.value;
216
230
  }
217
231
  };
218
- return P;
232
+ return I;
219
233
  }
220
234
  //#endregion
221
235
  export { _ as createForm };