@vielzeug/forge 1.3.1 → 1.4.0

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/** A callback to remove a subscription. */\nexport type Unsubscribe = () => void;\n\nexport type MaybePromise<T> = T | PromiseLike<T>;\n\nexport type FieldValidator<V = unknown> = (value: V, signal?: AbortSignal) => MaybePromise<string | undefined>;\n\nexport type FormValidator<TValues extends Record<string, unknown> = Record<string, unknown>> = (\n  values: TValues,\n  signal?: AbortSignal,\n) => MaybePromise<Partial<Record<ErrorKeyOf<TValues>, string>> | undefined>;\n\nexport type SetOptions = {\n  /** Whether to mark the field as touched. Default: false. */\n  touched?: boolean;\n};\n\nexport type FormState = {\n  errors: Readonly<Record<string, string> & { [FORM_ERROR]?: string }>;\n  isDirty: boolean;\n  /** `true` while an async `defaultValues` factory is resolving. */\n  isLoading: boolean;\n  isSubmitting: boolean;\n  isTouched: boolean;\n  isValid: boolean;\n  isValidating: boolean;\n  submitCount: number;\n  /**\n   * Field names that are currently touched, as full dot-notation paths.\n   * On a scoped form these are still full paths (e.g. `\"address.city\"`, not `\"city\"`).\n   * Prefer calling `scopedForm.validate()` to run scoped validation rather than\n   * passing `state.touchedFields` directly — scoped `validate(fields[])` expects relative paths.\n   */\n  touchedFields: readonly string[];\n  /** Field names that currently have an active async validation run. Useful for per-field loading indicators. */\n  validatingFields: readonly string[];\n};\n\nexport type SubscribeOptions = {\n  /** Call the listener immediately with the current state on subscription. Default: false. */\n  sync?: boolean;\n};\n\n/** Shared field key for root-level / form-level validation errors. */\nexport const FORM_ERROR = '_form' as const;\n\nexport type ValidateResult = {\n  errors: Readonly<Record<string, string>>;\n  valid: boolean;\n};\n\nexport type SubmitResult<TResult = void> =\n  { ok: true; value: TResult } | { errors: Record<string, string>; ok: false; type: 'validation' };\n\n/* -------------------- Utility Types -------------------- */\n\n/**\n * Recursively makes all properties optional.\n * Used by `form.patch()` to accept partial nested updates.\n */\nexport type DeepPartial<T> = T extends Record<string, unknown> ? { [K in keyof T]?: DeepPartial<T[K]> } : T;\n\n/**\n * Recursively extracts all dot-notation leaf keys from a values shape.\n * Depth-limited to 5: TypeScript compilation time grows non-linearly beyond this point.\n */\nexport type FlatKeyOf<\n  T extends Record<string, unknown>,\n  P extends string = '',\n  D extends readonly 0[] = [],\n> = D['length'] extends 5\n  ? string\n  : {\n      [K in keyof T & string]: T[K] extends unknown[] | File | Blob | Date\n        ? P extends ''\n          ? K\n          : `${P}.${K}`\n        : T[K] extends Record<string, unknown>\n          ? FlatKeyOf<T[K] & Record<string, unknown>, P extends '' ? K : `${P}.${K}`, [...D, 0]>\n          : P extends ''\n            ? K\n            : `${P}.${K}`;\n    }[keyof T & string];\n\n/** Resolves the value type at a dot-notation path within a values shape. */\nexport type TypeAtPath<T, K extends string> = K extends `${infer Head}.${infer Tail}`\n  ? Head extends keyof T\n    ? T[Head] extends Record<string, unknown>\n      ? TypeAtPath<T[Head], Tail>\n      : unknown\n    : unknown\n  : K extends keyof T\n    ? T[K]\n    : unknown;\n\n/** Field error keys include field paths plus the reserved `_form` key for root-level issues. */\nexport type ErrorKeyOf<TValues extends Record<string, unknown>> = FlatKeyOf<TValues> | typeof FORM_ERROR;\n\n/**\n * Structural interface for safeParse-compatible schemas.\n * Works with `@vielzeug/spell`, Zod, Valibot, and any Standard Schema compliant library.\n */\nexport type SafeParseSchema = {\n  safeParse(\n    data: unknown,\n  ): { success: true } | { error: { issues: { message: string; path: (string | number)[] }[] }; success: false };\n};\n\n/** The type of values accessible at a scoped sub-form prefix. */\nexport type ScopedValues<TValues, P extends string> =\n  TypeAtPath<TValues, P> extends Record<string, unknown>\n    ? TypeAtPath<TValues, P> & Record<string, unknown>\n    : Record<string, unknown>;\n\n/**\n * The live connection object returned by `form.connect()`.\n * Getters re-evaluate on every property access — store the object once per field, do not destructure.\n * Call `dispose()` to cancel any pending debounce timers when the field unmounts.\n */\nexport type ConnectionResult<V = unknown> = {\n  [Symbol.dispose](): void;\n  readonly dirty: boolean;\n  /** Cancels the debounce timer owned by this specific binding. Safe to call multiple times. */\n  dispose(): void;\n  /** `true` after `dispose()` has been called on this binding. */\n  readonly disposed: boolean;\n  readonly error: string | undefined;\n  onBlur(): void;\n  onChange(value: V): void;\n  readonly touched: boolean;\n  readonly value: V;\n};\n\n/** Per-field or global validation trigger configuration. */\nexport type ConnectOptions = {\n  /**\n   * Debounce auto-triggered validation by this many milliseconds.\n   * Each `connect()` call owns its own timer — cancelling one binding does not affect others.\n   * Default: 0.\n   */\n  debounce?: number;\n  /** Auto-mark the field as touched when it loses focus. Default: false. */\n  touchOnBlur?: boolean;\n  /** Validate the field automatically when it loses focus. Default: false. */\n  validateOnBlur?: boolean;\n  /** Validate the field automatically after each value change. Default: false. */\n  validateOnChange?: boolean;\n  /** Validate on change only after the field has been touched at least once. */\n  validateOnTouch?: boolean;\n};\n\n// Resolves the element type of an array, or `unknown` for non-arrays.\ntype ElementOf<T> = T extends readonly (infer E)[] ? E : unknown;\n\nexport type ArrayField<T = unknown> = {\n  append(value: T): void;\n  insert(index: number, value: T): void;\n  move(from: number, to: number): void;\n  prepend(value: T): void;\n  remove(index: number): void;\n  replace(index: number, value: T): void;\n  swap(a: number, b: number): void;\n};\n\nexport type FieldState<V = unknown> = {\n  dirty: boolean;\n  error: string | undefined;\n  /** `true` when `error` is not `undefined`. Convenience alias for `error !== undefined`. */\n  hasError: boolean;\n  touched: boolean;\n  value: V;\n};\n\n/**\n * Options for registering a dynamic field. Both properties are optional;\n * omitting `defaultValue` leaves the field uninitialized and omitting `validator`\n * skips field-level validation.\n */\nexport type RegisterFieldOptions<V = unknown> = {\n  /** Initial value. Also becomes the baseline, so the field starts clean. */\n  defaultValue?: V;\n  /** Field-level validator to attach. */\n  validator?: FieldValidator<V>;\n};\n\n/**\n * A complete snapshot of form state that can be restored via `form.restore()`.\n * `store` and `baseline` keys are the flattened dot-notation paths used internally.\n * Typed with `TValues` for nominal clarity — structurally both are `Record<string, unknown>`.\n */\nexport type FormSnapshot<TValues extends Record<string, unknown> = Record<string, unknown>> = {\n  readonly baseline: Partial<Record<FlatKeyOf<TValues>, unknown>>;\n  readonly dirty: readonly string[];\n  readonly errors: Readonly<Record<string, string>>;\n  readonly store: Partial<Record<FlatKeyOf<TValues>, unknown>>;\n  readonly submitCount: number;\n  readonly touched: readonly string[];\n};\n\nexport type FormOptions<TValues extends Record<string, unknown> = Record<string, unknown>> = {\n  /**\n   * Default connect behavior applied when `connect(name, config)` omits specific options.\n   * Use `ValidationModes` presets for common strategies:\n   * - `ValidationModes.onSubmit` (default) — validates only on submit, no touch-on-blur\n   * - `ValidationModes.onBlur` — validates each field on blur\n   * - `ValidationModes.onChange` — validates each field on every change\n   * - `ValidationModes.onTouched` — validates on blur first, then on every change once touched\n   */\n  connect?: ConnectOptions;\n  /**\n   * Initial form values. May be a static object or an async factory function.\n   * While a factory is pending, `form.isLoading` is `true` and the form is read-only.\n   */\n  defaultValues?: { [K in keyof TValues]: TValues[K] } | (() => Promise<{ [K in keyof TValues]: TValues[K] }>);\n  /**\n   * Called when an async `defaultValues` factory rejects.\n   * Use to show an error UI or retry logic. In development, a warning is also emitted via `console.warn`.\n   */\n  onLoadError?: (error: unknown) => void;\n  /**\n   * Form-level validator. Accepts either:\n   * - A `FormValidator` function\n   * - Any `safeParse`-compatible schema (auto-detected, works with `@vielzeug/spell`, Zod, Valibot)\n   */\n  validator?: FormValidator<TValues> | SafeParseSchema;\n  /** Field-level validators keyed by field name or dot-notation path. */\n  validators?: Partial<Record<FlatKeyOf<TValues>, FieldValidator>>;\n};\n\n/**\n * Named presets for common validation trigger strategies.\n * Pass to `createForm({ connect: ValidationModes.onBlur })`.\n *\n * - `onSubmit` — no automatic validation or touch. Clean until the user submits.\n * - `onBlur` — validates and marks touched on blur.\n * - `onChange` — validates on every keystroke (marks touched on blur).\n * - `onTouched` — validates on blur first, then on every change once touched.\n */\nexport const ValidationModes = {\n  onBlur: { touchOnBlur: true, validateOnBlur: true },\n  onChange: { touchOnBlur: true, validateOnChange: true },\n  onSubmit: {},\n  onTouched: { touchOnBlur: true, validateOnBlur: true, validateOnTouch: true },\n} as const satisfies Record<string, ConnectOptions>;\n\nexport interface Form<TValues extends Record<string, unknown> = Record<string, unknown>> {\n  /** Returns a cached typed `ArrayField` helper for mutating array-valued fields. */\n  array<K extends FlatKeyOf<TValues>>(name: K): ArrayField<ElementOf<TypeAtPath<TValues, K>>>;\n  batch(fn: () => void): void;\n  /** Clear a single field error. No-op if the field has no error. */\n  clearError(name: ErrorKeyOf<TValues>): void;\n  /**\n   * Returns a live connection object for a field (DOM event handlers + live getters).\n   * Each call to `connect()` creates a new object with its own debounce timer.\n   * Call `binding.dispose()` on unmount to cancel any pending debounce timer.\n   * Do not destructure: getters re-evaluate on every property access.\n   */\n  connect<K extends FlatKeyOf<TValues>>(name: K, config?: ConnectOptions): ConnectionResult<TypeAtPath<TValues, K>>;\n  dispose(): void;\n  /** Aborted when `dispose()` is called. Use to cancel async work tied to this form's lifetime. */\n  readonly disposalSignal: AbortSignal;\n  readonly disposed: boolean;\n  field<K extends FlatKeyOf<TValues>>(name: K): FieldState<TypeAtPath<TValues, K>>;\n  get<K extends FlatKeyOf<TValues>>(name: K): TypeAtPath<TValues, K>;\n  /** `true` while an async `defaultValues` factory is resolving. Mirrors `state.isLoading`. */\n  readonly isLoading: boolean;\n  /** `true` while a `submit()` call is in progress. Mirrors `state.isSubmitting`. */\n  readonly isSubmitting: boolean;\n  /**\n   * Merge a partial server response into the form: updates both the store and the baseline\n   * for each provided field, marking them clean. Fields not included in `partial` are untouched.\n   */\n  patch(partial: DeepPartial<TValues>): void;\n  /**\n   * Field-lifecycle namespace — use to dynamically register/remove fields and manage validators.\n   *\n   * @example\n   * const unsub = form.fields.register('email', { defaultValue: '', validator: required });\n   * form.fields.setValidator('email', (v) => v ? undefined : 'Required');\n   * form.fields.remove('email');\n   */\n  fields: {\n    /**\n     * Enumerate all currently-known field paths: the deduplicated union of populated store\n     * keys and keys with a registered validator (the same definition `touchAll()` uses).\n     * On a scoped form, paths are relative to the scope's prefix — matching `scope.state`'s\n     * relative-path convention, not `state.touchedFields`'s absolute-path convention.\n     */\n    list(): readonly string[];\n    /**\n     * Declare a dynamic field with an optional default value and validator.\n     * If the field does not yet exist in the store, `defaultValue` is written to both the\n     * store and the baseline so the field starts clean (not dirty).\n     * Returns an **unregister** callback that calls `fields.remove()` on the same field.\n     */\n    register<K extends FlatKeyOf<TValues>>(\n      name: K,\n      options?: RegisterFieldOptions<TypeAtPath<TValues, K>>,\n    ): Unsubscribe;\n    /** Remove a field entirely: drops value, dirty, touched, error, and any registered validator. */\n    remove(name: FlatKeyOf<TValues>): void;\n    /**\n     * Add, replace, or remove a field validator.\n     * Removing a validator (passing `undefined`) also immediately clears any existing error for that field.\n     */\n    setValidator(name: FlatKeyOf<TValues>, validator?: FieldValidator): void;\n  };\n  /** Replace values and baseline in one operation. Aborts any in-flight validation. */\n  replace(newValues: TValues): void;\n  /** Restore values from the current baseline and clear errors/touched/dirty. Aborts any in-flight validation. */\n  reset(): void;\n  resetField(name: FlatKeyOf<TValues>): void;\n  /** Replace the entire error map. Use `undefined` values to omit entries. */\n  resetErrors(errors?: Partial<Record<ErrorKeyOf<TValues>, string | undefined>>): void;\n  /**\n   * Returns a scoped sub-form whose field paths are relative to `prefix`.\n   * `scopedForm.get('city')` is equivalent to `form.get('${prefix}.city')`.\n   * The scoped form shares state and lifecycle with the parent — `dispose()` on a scoped\n   * form is a no-op; call `parentForm.dispose()` to tear down the whole form.\n   *\n   * Results are memoized — calling `scope(prefix)` multiple times with the same prefix\n   * returns the same object. Safe to call on every render.\n   *\n   * **`state`** returns a scoped projection: `errors`, `touchedFields`, `validatingFields`,\n   * `isValid`, `isDirty`, and `isTouched` reflect only fields within this prefix.\n   * `isSubmitting`, `isLoading`, `isValidating`, and `submitCount` reflect the full form.\n   */\n  scope<P extends FlatKeyOf<TValues>>(prefix: P): Form<ScopedValues<TValues, P>>;\n  set<K extends FlatKeyOf<TValues>>(name: K, value: TypeAtPath<TValues, K>, options?: SetOptions): void;\n  /** Set a field error. */\n  setError(name: ErrorKeyOf<TValues>, message: string): void;\n  /**\n   * Capture the complete form state into a snapshot that can be passed to `restore()`.\n   * Useful for undo/redo, draft saving, and \"discard changes\" flows.\n   */\n  snapshot(): FormSnapshot<TValues>;\n  /**\n   * Restore the form to a previously captured snapshot. Replaces all state:\n   * values, baseline, errors, touched, dirty, and submitCount.\n   * Aborts any in-flight validation.\n   */\n  restore(snapshot: FormSnapshot<TValues>): void;\n  readonly state: FormState;\n  submit<TResult = void>(handler: (values: TValues) => MaybePromise<TResult>): Promise<SubmitResult<TResult>>;\n  /**\n   * Like `submit()` but throws a `ForgeValidationError` when validation fails instead of returning\n   * `{ ok: false, ... }`. Use when you prefer a throw-based control flow.\n   *\n   * @throws {ForgeValidationError} when validation fails.\n   * @throws {Error} when `submit()` is already in progress.\n   */\n  submitOrThrow<TResult = void>(handler: (values: TValues) => MaybePromise<TResult>): Promise<TResult>;\n  subscribe(listener: (state: FormState) => void, options?: SubscribeOptions): Unsubscribe;\n  /**\n   * Subscribe to form state changes filtered to this scope's prefix.\n   * `errors`, `touchedFields`, and `validatingFields` are remapped to relative paths;\n   * all other state flags reflect the full form.\n   * The listener fires only when the scoped projection changes — unrelated field mutations\n   * outside this prefix are suppressed.\n   * On a root form, behaves identically to `subscribe` — no prefix filtering is applied.\n   */\n  subscribeScoped(listener: (state: FormState) => void, options?: SubscribeOptions): Unsubscribe;\n  subscribeField<K extends FlatKeyOf<TValues>>(\n    name: K,\n    listener: (state: FieldState<TypeAtPath<TValues, K>>) => void,\n    options?: SubscribeOptions,\n  ): Unsubscribe;\n  /**\n   * Iterate over form state changes via `for await`.\n   * Yields the current state immediately, then once per mutation until the iterator\n   * is returned or the form is disposed.\n   *\n   * @example\n   * for await (const state of form) {\n   *   if (state.isSubmitting) showSpinner();\n   * }\n   */\n  [Symbol.asyncIterator](): AsyncIterableIterator<FormState>;\n  /** Delegates to `dispose()`. Enables `using` declarations. */\n  [Symbol.dispose](): void;\n  /** Mark a field as touched. */\n  touch(name: FlatKeyOf<TValues>): void;\n  /** Mark all known fields (store + validators) as touched. */\n  touchAll(): void;\n  /** Mark a field as untouched. No-op if the field is not currently touched. */\n  untouch(name: FlatKeyOf<TValues>): void;\n  /** Mark all fields as untouched. */\n  untouchAll(): void;\n  /**\n   * Validate all registered field validators and the optional form validator.\n   *\n   * On a scoped form: validates only the fields within the scope and does not run the\n   * form-level validator. Errors and `valid` reflect only scoped fields.\n   */\n  validate(signal?: AbortSignal): Promise<ValidateResult>;\n  /**\n   * Validate a single named field. Preserves other fields' errors. Does not run the form-level validator.\n   * Returns a `ValidateResult` scoped to that field — `errors` contains at most one entry.\n   */\n  validate(name: FlatKeyOf<TValues>, signal?: AbortSignal): Promise<ValidateResult>;\n  /**\n   * Validate a specific set of fields. Preserves other fields' errors. Does not run the form-level validator.\n   * Returns a `ValidateResult` scoped to the requested fields.\n   */\n  validate(fields: FlatKeyOf<TValues>[], signal?: AbortSignal): Promise<ValidateResult>;\n  /**\n   * Streaming validation — yields each field result as soon as its validator resolves.\n   * The final item in the stream is the form-level validator result (field: '_form'), if configured.\n   *\n   * @example\n   * for await (const result of form.validateStream()) {\n   *   console.log(result.field, result.error ?? 'ok');\n   * }\n   */\n  validateStream(signal?: AbortSignal): AsyncIterableIterator<{ error: string | undefined; field: string }>;\n  values(): TValues;\n}\n"],"mappings":";AA4CA,IAAa,IAAa,SAkMb,IAAkB;CAC7B,QAAQ;EAAE,aAAa;EAAM,gBAAgB;CAAK;CAClD,UAAU;EAAE,aAAa;EAAM,kBAAkB;CAAK;CACtD,UAAU,CAAC;CACX,WAAW;EAAE,aAAa;EAAM,gBAAgB;EAAM,iBAAiB;CAAK;AAC9E"}
+{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/** A callback to remove a subscription. */\nexport type Unsubscribe = () => void;\n\nexport type MaybePromise<T> = T | PromiseLike<T>;\n\nexport type FieldValidator<V = unknown> = (value: V, signal?: AbortSignal) => MaybePromise<string | undefined>;\n\nexport type FormValidator<TValues extends Record<string, unknown> = Record<string, unknown>> = (\n  values: TValues,\n  signal?: AbortSignal,\n) => MaybePromise<Partial<Record<ErrorKeyOf<TValues>, string>> | undefined>;\n\nexport type SetOptions = {\n  /** Whether to mark the field as touched. Default: false. */\n  touched?: boolean;\n};\n\nexport type FormState = {\n  errors: Readonly<Record<string, string> & { [FORM_ERROR]?: string }>;\n  isDirty: boolean;\n  /** `true` while an async `defaultValues` factory is resolving. */\n  isLoading: boolean;\n  isSubmitting: boolean;\n  isTouched: boolean;\n  isValid: boolean;\n  isValidating: boolean;\n  submitCount: number;\n  /**\n   * Field names that are currently touched, as full dot-notation paths.\n   * On a scoped form these are still full paths (e.g. `\"address.city\"`, not `\"city\"`).\n   * Prefer calling `scopedForm.validate()` to run scoped validation rather than\n   * passing `state.touchedFields` directly — scoped `validate(fields[])` expects relative paths.\n   */\n  touchedFields: readonly string[];\n  /** Field names that currently have an active async validation run. Useful for per-field loading indicators. */\n  validatingFields: readonly string[];\n};\n\nexport type SubscribeOptions = {\n  /** Call the listener immediately with the current state on subscription. Default: false. */\n  sync?: boolean;\n};\n\n/** Shared field key for root-level / form-level validation errors. */\nexport const FORM_ERROR = '_form' as const;\n\nexport type ValidateResult = {\n  errors: Readonly<Record<string, string>>;\n  valid: boolean;\n};\n\nexport type SubmitResult<TResult = void> =\n  { ok: true; value: TResult } | { errors: Record<string, string>; ok: false; type: 'validation' };\n\n/* -------------------- Utility Types -------------------- */\n\n/**\n * Recursively makes all properties optional.\n * Used by `form.patch()` to accept partial nested updates.\n */\nexport type DeepPartial<T> = T extends Record<string, unknown> ? { [K in keyof T]?: DeepPartial<T[K]> } : T;\n\n/**\n * Single source of truth for the typed-path depth ceiling, shared by `FlatKeyOf`'s\n * type-level cutoff below and `_utils.ts`'s matching runtime dev-warning threshold —\n * one named constant instead of two hardcoded `5`s that could silently drift apart.\n *\n * Deliberately not a per-form generic parameter (e.g. `Form<TValues, MaxDepth>`): the\n * whole point of this cutoff is protecting TypeScript compile time, which is a\n * repo-wide concern, not a per-form preference. Making it user-configurable would let\n * one form's type param silently regress compile performance for everyone who imports\n * it. If a real shape needs deeper typed paths, flatten it or accept `string` typing\n * for those leaves — `FlatKeyOf` already falls back to `string` gracefully past this\n * depth, so nothing is a hard error either way.\n */\nexport const MAX_TYPED_PATH_DEPTH = 5 as const;\n\n/**\n * Recursively extracts all dot-notation leaf keys from a values shape.\n * Depth-limited to {@link MAX_TYPED_PATH_DEPTH}: TypeScript compilation time grows\n * non-linearly beyond this point.\n */\nexport type FlatKeyOf<\n  T extends Record<string, unknown>,\n  P extends string = '',\n  D extends readonly 0[] = [],\n> = D['length'] extends typeof MAX_TYPED_PATH_DEPTH\n  ? string\n  : {\n      [K in keyof T & string]: T[K] extends unknown[] | File | Blob | Date\n        ? P extends ''\n          ? K\n          : `${P}.${K}`\n        : T[K] extends Record<string, unknown>\n          ? FlatKeyOf<T[K] & Record<string, unknown>, P extends '' ? K : `${P}.${K}`, [...D, 0]>\n          : P extends ''\n            ? K\n            : `${P}.${K}`;\n    }[keyof T & string];\n\n/** Resolves the value type at a dot-notation path within a values shape. */\nexport type TypeAtPath<T, K extends string> = K extends `${infer Head}.${infer Tail}`\n  ? Head extends keyof T\n    ? T[Head] extends Record<string, unknown>\n      ? TypeAtPath<T[Head], Tail>\n      : unknown\n    : unknown\n  : K extends keyof T\n    ? T[K]\n    : unknown;\n\n/** Field error keys include field paths plus the reserved `_form` key for root-level issues. */\nexport type ErrorKeyOf<TValues extends Record<string, unknown>> = FlatKeyOf<TValues> | typeof FORM_ERROR;\n\n/**\n * Structural interface for safeParse-compatible schemas.\n * Works with `@vielzeug/spell`, Zod, Valibot, and any Standard Schema compliant library.\n */\nexport type SafeParseSchema = {\n  safeParse(\n    data: unknown,\n  ): { success: true } | { error: { issues: { message: string; path: (string | number)[] }[] }; success: false };\n};\n\n/** The type of values accessible at a scoped sub-form prefix. */\nexport type ScopedValues<TValues, P extends string> =\n  TypeAtPath<TValues, P> extends Record<string, unknown>\n    ? TypeAtPath<TValues, P> & Record<string, unknown>\n    : Record<string, unknown>;\n\n/**\n * The live connection object returned by `form.connect()`.\n * Getters re-evaluate on every property access — store the object once per field, do not destructure.\n * Call `dispose()` to cancel any pending debounce timers when the field unmounts.\n */\nexport type ConnectionResult<V = unknown> = {\n  [Symbol.dispose](): void;\n  readonly dirty: boolean;\n  /** Cancels the debounce timer owned by this specific binding. Safe to call multiple times. */\n  dispose(): void;\n  /** `true` after `dispose()` has been called on this binding. */\n  readonly disposed: boolean;\n  readonly error: string | undefined;\n  onBlur(): void;\n  onChange(value: V): void;\n  readonly touched: boolean;\n  readonly value: V;\n};\n\n/** Per-field or global validation trigger configuration. */\nexport type ConnectOptions = {\n  /**\n   * Debounce auto-triggered validation by this many milliseconds.\n   * Each `connect()` call owns its own timer — cancelling one binding does not affect others.\n   * Default: 0.\n   */\n  debounce?: number;\n  /** Auto-mark the field as touched when it loses focus. Default: false. */\n  touchOnBlur?: boolean;\n  /** Validate the field automatically when it loses focus. Default: false. */\n  validateOnBlur?: boolean;\n  /** Validate the field automatically after each value change. Default: false. */\n  validateOnChange?: boolean;\n  /** Validate on change only after the field has been touched at least once. */\n  validateOnTouch?: boolean;\n};\n\n// Resolves the element type of an array, or `unknown` for non-arrays.\ntype ElementOf<T> = T extends readonly (infer E)[] ? E : unknown;\n\nexport type ArrayField<T = unknown> = {\n  append(value: T): void;\n  insert(index: number, value: T): void;\n  move(from: number, to: number): void;\n  prepend(value: T): void;\n  remove(index: number): void;\n  replace(index: number, value: T): void;\n  swap(a: number, b: number): void;\n};\n\nexport type FieldState<V = unknown> = {\n  dirty: boolean;\n  error: string | undefined;\n  /** `true` when `error` is not `undefined`. Convenience alias for `error !== undefined`. */\n  hasError: boolean;\n  touched: boolean;\n  value: V;\n};\n\n/**\n * Options for registering a dynamic field. Both properties are optional;\n * omitting `defaultValue` leaves the field uninitialized and omitting `validator`\n * skips field-level validation.\n */\nexport type RegisterFieldOptions<V = unknown> = {\n  /** Initial value. Also becomes the baseline, so the field starts clean. */\n  defaultValue?: V;\n  /** Field-level validator to attach. */\n  validator?: FieldValidator<V>;\n};\n\n/**\n * A complete snapshot of form state that can be restored via `form.history.restore()`.\n * `store` and `baseline` keys are the flattened dot-notation paths used internally.\n * Typed with `TValues` for nominal clarity — structurally both are `Record<string, unknown>`.\n */\nexport type FormSnapshot<TValues extends Record<string, unknown> = Record<string, unknown>> = {\n  readonly baseline: Partial<Record<FlatKeyOf<TValues>, unknown>>;\n  readonly dirty: readonly string[];\n  readonly errors: Readonly<Record<string, string>>;\n  readonly store: Partial<Record<FlatKeyOf<TValues>, unknown>>;\n  readonly submitCount: number;\n  readonly touched: readonly string[];\n};\n\n/**\n * Undo/redo-style snapshotting, namespaced off the main `Form<T>` surface since it's a\n * distinctly less common operation than reading/writing values — grouped the same way\n * `fields` already groups dynamic-field-lifecycle operations.\n */\nexport type FormHistory<TValues extends Record<string, unknown> = Record<string, unknown>> = {\n  /**\n   * Restore the form to a previously captured snapshot. Replaces all state:\n   * values, baseline, errors, touched, dirty, and submitCount.\n   * Aborts any in-flight validation.\n   */\n  restore(snapshot: FormSnapshot<TValues>): void;\n  /**\n   * Capture the complete form state into a snapshot that can be passed to `restore()`.\n   * Useful for undo/redo, draft saving, and \"discard changes\" flows.\n   */\n  snapshot(): FormSnapshot<TValues>;\n};\n\nexport type FormOptions<TValues extends Record<string, unknown> = Record<string, unknown>> = {\n  /**\n   * Default connect behavior applied when `connect(name, config)` omits specific options.\n   * Use `ValidationModes` presets for common strategies:\n   * - `ValidationModes.onSubmit` (default) — validates only on submit, no touch-on-blur\n   * - `ValidationModes.onBlur` — validates each field on blur\n   * - `ValidationModes.onChange` — validates each field on every change\n   * - `ValidationModes.onTouched` — validates on blur first, then on every change once touched\n   */\n  connect?: ConnectOptions;\n  /**\n   * Initial form values. May be a static object or an async factory function.\n   * While a factory is pending, `form.isLoading` is `true` and the form is read-only.\n   */\n  defaultValues?: { [K in keyof TValues]: TValues[K] } | (() => Promise<{ [K in keyof TValues]: TValues[K] }>);\n  /**\n   * Called when an async `defaultValues` factory rejects.\n   * Use to show an error UI or retry logic. In development, a warning is also emitted via `console.warn`.\n   */\n  onLoadError?: (error: unknown) => void;\n  /**\n   * Form-level validator. Accepts either:\n   * - A `FormValidator` function\n   * - Any `safeParse`-compatible schema (auto-detected, works with `@vielzeug/spell`, Zod, Valibot)\n   */\n  validator?: FormValidator<TValues> | SafeParseSchema;\n  /** Field-level validators keyed by field name or dot-notation path. */\n  validators?: Partial<Record<FlatKeyOf<TValues>, FieldValidator>>;\n};\n\n/**\n * Named presets for common validation trigger strategies.\n * Pass to `createForm({ connect: ValidationModes.onBlur })`.\n *\n * - `onSubmit` — no automatic validation or touch. Clean until the user submits.\n * - `onBlur` — validates and marks touched on blur.\n * - `onChange` — validates on every keystroke (marks touched on blur).\n * - `onTouched` — validates on blur first, then on every change once touched.\n */\nexport const ValidationModes = {\n  onBlur: { touchOnBlur: true, validateOnBlur: true },\n  onChange: { touchOnBlur: true, validateOnChange: true },\n  onSubmit: {},\n  onTouched: { touchOnBlur: true, validateOnBlur: true, validateOnTouch: true },\n} as const satisfies Record<string, ConnectOptions>;\n\nexport interface Form<TValues extends Record<string, unknown> = Record<string, unknown>> {\n  /** Returns a cached typed `ArrayField` helper for mutating array-valued fields. */\n  array<K extends FlatKeyOf<TValues>>(name: K): ArrayField<ElementOf<TypeAtPath<TValues, K>>>;\n  batch(fn: () => void): void;\n  /** Clear a single field error. No-op if the field has no error. */\n  clearError(name: ErrorKeyOf<TValues>): void;\n  /**\n   * Returns a live connection object for a field (DOM event handlers + live getters).\n   * Each call to `connect()` creates a new object with its own debounce timer.\n   * Call `binding.dispose()` on unmount to cancel any pending debounce timer.\n   * Do not destructure: getters re-evaluate on every property access.\n   */\n  connect<K extends FlatKeyOf<TValues>>(name: K, config?: ConnectOptions): ConnectionResult<TypeAtPath<TValues, K>>;\n  dispose(): void;\n  /** Aborted when `dispose()` is called. Use to cancel async work tied to this form's lifetime. */\n  readonly disposalSignal: AbortSignal;\n  readonly disposed: boolean;\n  field<K extends FlatKeyOf<TValues>>(name: K): FieldState<TypeAtPath<TValues, K>>;\n  get<K extends FlatKeyOf<TValues>>(name: K): TypeAtPath<TValues, K>;\n  /** `true` while an async `defaultValues` factory is resolving. Mirrors `state.isLoading`. */\n  readonly isLoading: boolean;\n  /** `true` while a `submit()` call is in progress. Mirrors `state.isSubmitting`. */\n  readonly isSubmitting: boolean;\n  /**\n   * Merge a partial server response into the form: updates both the store and the baseline\n   * for each provided field, marking them clean. Fields not included in `partial` are untouched.\n   */\n  patch(partial: DeepPartial<TValues>): void;\n  /**\n   * Field-lifecycle namespace — use to dynamically register/remove fields and manage validators.\n   *\n   * @example\n   * const unsub = form.fields.register('email', { defaultValue: '', validator: required });\n   * form.fields.setValidator('email', (v) => v ? undefined : 'Required');\n   * form.fields.remove('email');\n   */\n  fields: {\n    /**\n     * Enumerate all currently-known field paths: the deduplicated union of populated store\n     * keys and keys with a registered validator (the same definition `touchAll()` uses).\n     * On a scoped form, paths are relative to the scope's prefix — matching `scope.state`'s\n     * relative-path convention, not `state.touchedFields`'s absolute-path convention.\n     */\n    list(): readonly string[];\n    /**\n     * Declare a dynamic field with an optional default value and validator.\n     * If the field does not yet exist in the store, `defaultValue` is written to both the\n     * store and the baseline so the field starts clean (not dirty).\n     * Returns an **unregister** callback that calls `fields.remove()` on the same field.\n     */\n    register<K extends FlatKeyOf<TValues>>(\n      name: K,\n      options?: RegisterFieldOptions<TypeAtPath<TValues, K>>,\n    ): Unsubscribe;\n    /** Remove a field entirely: drops value, dirty, touched, error, and any registered validator. */\n    remove(name: FlatKeyOf<TValues>): void;\n    /**\n     * Add, replace, or remove a field validator.\n     * Removing a validator (passing `undefined`) also immediately clears any existing error for that field.\n     */\n    setValidator(name: FlatKeyOf<TValues>, validator?: FieldValidator): void;\n  };\n  /**\n   * Undo/redo-style snapshotting — see {@link FormHistory}. Namespaced off the main surface\n   * since it's a distinctly less common operation than reading/writing values.\n   *\n   * @example\n   * const before = form.history.snapshot();\n   * form.patch({ status: 'archived' });\n   * form.history.restore(before); // undo\n   */\n  history: FormHistory<TValues>;\n  /** Replace values and baseline in one operation. Aborts any in-flight validation. */\n  replace(newValues: TValues): void;\n  /** Restore values from the current baseline and clear errors/touched/dirty. Aborts any in-flight validation. */\n  reset(): void;\n  resetField(name: FlatKeyOf<TValues>): void;\n  /** Replace the entire error map. Use `undefined` values to omit entries. */\n  resetErrors(errors?: Partial<Record<ErrorKeyOf<TValues>, string | undefined>>): void;\n  /**\n   * Returns a scoped sub-form whose field paths are relative to `prefix`.\n   * `scopedForm.get('city')` is equivalent to `form.get('${prefix}.city')`.\n   * The scoped form shares state and lifecycle with the parent — `dispose()` on a scoped\n   * form is a no-op; call `parentForm.dispose()` to tear down the whole form.\n   *\n   * Results are memoized — calling `scope(prefix)` multiple times with the same prefix\n   * returns the same object. Safe to call on every render.\n   *\n   * **`state`** returns a scoped projection: `errors`, `touchedFields`, `validatingFields`,\n   * `isValid`, `isDirty`, and `isTouched` reflect only fields within this prefix.\n   * `isSubmitting`, `isLoading`, `isValidating`, and `submitCount` reflect the full form.\n   */\n  scope<P extends FlatKeyOf<TValues>>(prefix: P): Form<ScopedValues<TValues, P>>;\n  set<K extends FlatKeyOf<TValues>>(name: K, value: TypeAtPath<TValues, K>, options?: SetOptions): void;\n  /** Set a field error. */\n  setError(name: ErrorKeyOf<TValues>, message: string): void;\n  readonly state: FormState;\n  submit<TResult = void>(handler: (values: TValues) => MaybePromise<TResult>): Promise<SubmitResult<TResult>>;\n  /**\n   * Like `submit()` but throws a `ForgeValidationError` when validation fails instead of returning\n   * `{ ok: false, ... }`. Use when you prefer a throw-based control flow.\n   *\n   * @throws {ForgeValidationError} when validation fails.\n   * @throws {ForgeSubmitError} when `submit()` is already in progress.\n   */\n  submitOrThrow<TResult = void>(handler: (values: TValues) => MaybePromise<TResult>): Promise<TResult>;\n  /**\n   * Subscribe to form state changes.\n   * On a scoped form (`form.scope(prefix)`), `errors`, `touchedFields`, and `validatingFields`\n   * are remapped to relative paths, and the listener fires only when the scoped projection\n   * changes — mutations outside the scope's prefix are suppressed. On a root form, no\n   * filtering is applied.\n   */\n  subscribe(listener: (state: FormState) => void, options?: SubscribeOptions): Unsubscribe;\n  subscribeField<K extends FlatKeyOf<TValues>>(\n    name: K,\n    listener: (state: FieldState<TypeAtPath<TValues, K>>) => void,\n    options?: SubscribeOptions,\n  ): Unsubscribe;\n  /**\n   * Iterate over form state changes via `for await`.\n   * Yields the current state immediately, then once per mutation until the iterator\n   * is returned or the form is disposed.\n   *\n   * @example\n   * for await (const state of form) {\n   *   if (state.isSubmitting) showSpinner();\n   * }\n   */\n  [Symbol.asyncIterator](): AsyncIterableIterator<FormState>;\n  /** Delegates to `dispose()`. Enables `using` declarations. */\n  [Symbol.dispose](): void;\n  /** Mark a field as touched. */\n  touch(name: FlatKeyOf<TValues>): void;\n  /** Mark all known fields (store + validators) as touched. */\n  touchAll(): void;\n  /** Mark a field as untouched. No-op if the field is not currently touched. */\n  untouch(name: FlatKeyOf<TValues>): void;\n  /** Mark all fields as untouched. */\n  untouchAll(): void;\n  /**\n   * Validate all registered field validators and the optional form validator.\n   *\n   * On a scoped form: validates only the fields within the scope and does not run the\n   * form-level validator. Errors and `valid` reflect only scoped fields.\n   */\n  validate(signal?: AbortSignal): Promise<ValidateResult>;\n  /**\n   * Validate a single named field. Preserves other fields' errors. Does not run the form-level validator.\n   * Returns a `ValidateResult` scoped to that field — `errors` contains at most one entry.\n   */\n  validate(name: FlatKeyOf<TValues>, signal?: AbortSignal): Promise<ValidateResult>;\n  /**\n   * Validate a specific set of fields. Preserves other fields' errors. Does not run the form-level validator.\n   * Returns a `ValidateResult` scoped to the requested fields.\n   */\n  validate(fields: FlatKeyOf<TValues>[], signal?: AbortSignal): Promise<ValidateResult>;\n  values(): TValues;\n}\n"],"mappings":";AA4CA,IAAa,IAAa,SA+Bb,IAAuB,GAsMvB,IAAkB;CAC7B,QAAQ;EAAE,aAAa;EAAM,gBAAgB;CAAK;CAClD,UAAU;EAAE,aAAa;EAAM,kBAAkB;CAAK;CACtD,UAAU,CAAC;CACX,WAAW;EAAE,aAAa;EAAM,gBAAgB;EAAM,iBAAiB;CAAK;AAC9E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vielzeug/forge",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "Type-safe form state — field-level validation, submission, dirty tracking, field arrays, and async default values",
   "type": "module",
   "files": [
@@ -48,7 +48,7 @@
   },
   "dependencies": {
     "@vielzeug/arsenal": "1.1.2",
-    "@vielzeug/ripple": "1.2.3"
+    "@vielzeug/ripple": "1.3.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.0",

package/dist/core/validation.cjs

@@ -1,2 +0,0 @@
-const e=require("../errors.cjs"),t=require("../_utils.cjs"),n=require("../types.cjs"),r=require("./asyncQueue.cjs");let i=require("@vielzeug/arsenal");function a(a,o){async function s(e,t){let n=a.validators.get(e);if(!n)return;if(t.aborted)throw t.reason;let r=await n(a.store.get(e),t);return typeof r==`string`?r:void 0}async function c(e){if(!a.formValidator)return{};if(e.aborted)throw e.reason;let n=await a.formValidator(o.values(),e),r={};if(n)for(let[e,i]of Object.entries(n))t.isSafeKey(e)&&typeof i==`string`&&(r[e]=i);return r}function l(e,t,n,r){if(r===`full`){a.fieldErrors.clear();for(let[e,r]of Object.entries(n))t[e]===void 0&&(t[e]=r);for(let[e,n]of Object.entries(t))a.fieldErrors.set(e,n);a.invalidateErrors(),a.requestNotify()}else{let n=new Set;for(let r of e){let e=t[r],i=a.fieldErrors.get(r);e===void 0?a.fieldErrors.delete(r)&&n.add(r):(a.fieldErrors.set(r,e),i!==e&&n.add(r))}n.size>0&&a.invalidateErrors(),a.requestNotify(n)}}async function u(e,n,r){let o=new Set(e),u=new Map;for(let e of o){a.fieldCtrls.get(e)?.abort();let t=new AbortController;a.fieldCtrls.set(e,t),u.set(e,t)}let d=new AbortController,f=t.anySignal(d.signal,r,a.disposeController.signal);a.runCtrls.add(d);let p=Symbol();for(let e of o){let t=a.validatingRuns.get(e);t||(t=new Set,a.validatingRuns.set(e,t)),t.add(p)}a.requestNotify();try{let e=await Promise.all([...o].map(async e=>[e,await s(e,n===`partial`?t.anySignal(u.get(e).signal,f):f)]));if(f.aborted)return{aborted:!0,errors:Object.fromEntries(a.fieldErrors),valid:a.fieldErrors.size===0};let r={};for(let[t,n]of e)n!==void 0&&(r[t]=n);return l(o,r,n===`full`?await c(f):{},n),{aborted:!1,errors:Object.fromEntries(a.fieldErrors),valid:a.fieldErrors.size===0}}catch(e){if((0,i.isAbortError)(e))return{aborted:!0,errors:Object.fromEntries(a.fieldErrors),valid:a.fieldErrors.size===0};throw e}finally{a.runCtrls.delete(d);for(let e of o){let t=a.validatingRuns.get(e);t&&(t.delete(p),t.size===0&&a.validatingRuns.delete(e))}a.requestNotify();for(let[e,t]of u)a.fieldCtrls.get(e)===t&&a.fieldCtrls.delete(e)}}async function d(e,t){a.ensureNotDisposed();let n=await u(e,`partial`,t);return{errors:n.errors,valid:n.valid}}async function f(e,t){if(a.ensureNotDisposed(),e===void 0||e instanceof AbortSignal){let t=await u([...a.validators.keys()],`full`,e);return{errors:t.errors,valid:t.valid}}if(Array.isArray(e))return d(e,t);await d([e],t);let n=e,r=a.fieldErrors.get(n);return{errors:r===void 0?{}:{[n]:r},valid:r===void 0}}async function p(t){let n=await m(t);if(!n.ok)throw new e.ForgeValidationError(n.errors);return n.value}async function m(t){if(a.ensureNotDisposed(),a.isSubmittingState)throw new e.ForgeSubmitError(`submit() called while a submission is already in progress`);a.batch(()=>{a.submitCount++,a.isSubmittingState=!0,o.touchAll()});try{let e=await u([...a.validators.keys()],`full`);return a.ensureNotDisposed(),e.valid?{ok:!0,value:await t(o.values())}:{errors:e.errors,ok:!1,type:`validation`}}finally{a.isSubmittingState=!1,a.disposed||a.requestNotify()}}function h(e){a.ensureNotDisposed();let o=[...a.validators.keys()],l=new AbortController,u=e?t.anySignal(l.signal,e,a.disposeController.signal):t.anySignal(l.signal,a.disposeController.signal),d=r.createAsyncQueue(()=>l.abort());return Promise.all(o.map(async e=>{if(!u.aborted)try{let t=await s(e,u);u.aborted||d.push({error:t,field:e})}catch(e){if(!(0,i.isAbortError)(e))throw e}})).then(async()=>{if(a.formValidator&&!u.aborted)try{let e=await c(u);if(!u.aborted){let t=new Set([n.FORM_ERROR,...Object.keys(e)]);for(let n of t)d.push({error:e[n],field:n})}}catch{}}).catch(e=>{(0,i.isAbortError)(e)||(l.abort(),d.fail(e))}).finally(()=>{l.abort(),d.finish()}),d.iterator}return{runValidationCore:u,submit:m,submitOrThrow:p,validate:f,validateFields:d,validateStream:h}}exports.createValidationOps=a;
-//# sourceMappingURL=validation.cjs.map

package/dist/core/validation.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.cjs","names":[],"sources":["../../src/core/validation.ts"],"sourcesContent":["import { isAbortError } from '@vielzeug/arsenal';\n\nimport type { FormContext } from './context';\nimport type { ValueOps } from './values';\n\nimport { anySignal, isSafeKey } from '../_utils';\nimport { ForgeSubmitError, ForgeValidationError } from '../errors';\nimport { type FlatKeyOf, FORM_ERROR, type MaybePromise, type SubmitResult, type ValidateResult } from '../types';\nimport { createAsyncQueue } from './asyncQueue';\n\n/**\n * Validation + submit operations: field/form validator execution, error application,\n * `validate()`/`validateFields()`/`validateStream()`, and `submit()`/`submitOrThrow()`.\n * Moved verbatim from `createForm()`'s \"Validation\" and \"Submit\" sections.\n */\nexport function createValidationOps<TValues extends Record<string, unknown>>(\n  ctx: FormContext<TValues>,\n  deps: Pick<ValueOps<TValues>, 'touchAll' | 'values'>,\n) {\n  async function runFieldValidator(name: string, signal: AbortSignal): Promise<string | undefined> {\n    const validator = ctx.validators.get(name);\n\n    if (!validator) return undefined;\n\n    if (signal.aborted) throw signal.reason;\n\n    const result = await validator(ctx.store.get(name), signal);\n\n    return typeof result === 'string' ? result : undefined;\n  }\n\n  async function runFormValidator(signal: AbortSignal): Promise<Record<string, string>> {\n    if (!ctx.formValidator) return {};\n\n    if (signal.aborted) throw signal.reason;\n\n    const result = await ctx.formValidator(deps.values(), signal);\n    const errors: Record<string, string> = {};\n\n    if (result) {\n      for (const [key, message] of Object.entries(result)) {\n        // Security: a custom FormValidator function is caller-authored code — its returned\n        // keys are just as untrusted as a schema's `issue.path`. Reject reserved segments.\n        if (isSafeKey(key) && typeof message === 'string') errors[key] = message;\n      }\n    }\n\n    return errors;\n  }\n\n  function applyFieldErrors(\n    fieldSet: Set<string>,\n    nextErrors: Record<string, string>,\n    formErrors: Record<string, string>,\n    scope: 'full' | 'partial',\n  ): void {\n    if (scope === 'full') {\n      ctx.fieldErrors.clear();\n\n      for (const [key, message] of Object.entries(formErrors)) {\n        if (nextErrors[key] === undefined) nextErrors[key] = message;\n      }\n\n      for (const [key, message] of Object.entries(nextErrors)) ctx.fieldErrors.set(key, message);\n\n      ctx.invalidateErrors();\n      ctx.requestNotify();\n    } else {\n      const changedFields = new Set<string>();\n\n      for (const name of fieldSet) {\n        const next = nextErrors[name];\n        const previous = ctx.fieldErrors.get(name);\n\n        if (next !== undefined) {\n          ctx.fieldErrors.set(name, next);\n\n          if (previous !== next) changedFields.add(name);\n        } else if (ctx.fieldErrors.delete(name)) {\n          changedFields.add(name);\n        }\n      }\n\n      if (changedFields.size > 0) ctx.invalidateErrors();\n\n      ctx.requestNotify(changedFields);\n    }\n  }\n\n  async function runValidationCore(\n    fields: string[],\n    scope: 'full' | 'partial',\n    signal?: AbortSignal,\n  ): Promise<ValidateResult & { aborted: boolean }> {\n    const fieldSet = new Set(fields);\n    const fieldRunCtrls = new Map<string, AbortController>();\n\n    for (const name of fieldSet) {\n      ctx.fieldCtrls.get(name)?.abort();\n\n      const ctrl = new AbortController();\n\n      ctx.fieldCtrls.set(name, ctrl);\n      fieldRunCtrls.set(name, ctrl);\n    }\n\n    const runCtrl = new AbortController();\n    const runSignal = anySignal(runCtrl.signal, signal, ctx.disposeController.signal)!;\n\n    ctx.runCtrls.add(runCtrl);\n\n    // Symbol-based ref-counting: each run gets a unique token per field.\n    // The field leaves validatingFields only when its Set empties — impossible to miscount.\n    const runId = Symbol();\n\n    for (const name of fieldSet) {\n      let runs = ctx.validatingRuns.get(name);\n\n      if (!runs) {\n        runs = new Set<symbol>();\n        ctx.validatingRuns.set(name, runs);\n      }\n\n      runs.add(runId);\n    }\n\n    ctx.requestNotify();\n\n    try {\n      const results = await Promise.all(\n        [...fieldSet].map(async (name) => {\n          const fieldSignal = scope === 'partial' ? anySignal(fieldRunCtrls.get(name)!.signal, runSignal)! : runSignal;\n\n          return [name, await runFieldValidator(name, fieldSignal)] as const;\n        }),\n      );\n\n      if (runSignal.aborted) {\n        return { aborted: true, errors: Object.fromEntries(ctx.fieldErrors), valid: ctx.fieldErrors.size === 0 };\n      }\n\n      const nextErrors: Record<string, string> = {};\n\n      for (const [name, message] of results) {\n        if (message !== undefined) nextErrors[name] = message;\n      }\n\n      const formErrors = scope === 'full' ? await runFormValidator(runSignal) : {};\n\n      applyFieldErrors(fieldSet, nextErrors, formErrors, scope);\n\n      return { aborted: false, errors: Object.fromEntries(ctx.fieldErrors), valid: ctx.fieldErrors.size === 0 };\n    } catch (error) {\n      if (isAbortError(error)) {\n        return { aborted: true, errors: Object.fromEntries(ctx.fieldErrors), valid: ctx.fieldErrors.size === 0 };\n      }\n\n      throw error;\n    } finally {\n      ctx.runCtrls.delete(runCtrl);\n\n      for (const name of fieldSet) {\n        const runs = ctx.validatingRuns.get(name);\n\n        if (runs) {\n          runs.delete(runId);\n\n          if (runs.size === 0) ctx.validatingRuns.delete(name);\n        }\n      }\n\n      ctx.requestNotify();\n\n      for (const [name, ctrl] of fieldRunCtrls) {\n        if (ctx.fieldCtrls.get(name) === ctrl) ctx.fieldCtrls.delete(name);\n      }\n    }\n  }\n\n  async function validateFields(\n    fields: FlatKeyOf<TValues>[] | string[],\n    signal?: AbortSignal,\n  ): Promise<ValidateResult> {\n    ctx.ensureNotDisposed();\n\n    const result = await runValidationCore(fields as string[], 'partial', signal);\n\n    return { errors: result.errors, valid: result.valid };\n  }\n\n  async function validate(\n    nameOrFieldsOrSignal?: FlatKeyOf<TValues> | FlatKeyOf<TValues>[] | AbortSignal,\n    signal?: AbortSignal,\n  ): Promise<ValidateResult> {\n    ctx.ensureNotDisposed();\n\n    if (nameOrFieldsOrSignal === undefined || nameOrFieldsOrSignal instanceof AbortSignal) {\n      const result = await runValidationCore(\n        [...ctx.validators.keys()],\n        'full',\n        nameOrFieldsOrSignal as AbortSignal | undefined,\n      );\n\n      return { errors: result.errors, valid: result.valid };\n    }\n\n    if (Array.isArray(nameOrFieldsOrSignal)) {\n      return validateFields(nameOrFieldsOrSignal, signal);\n    }\n\n    await validateFields([nameOrFieldsOrSignal], signal);\n\n    const name = nameOrFieldsOrSignal as string;\n    const error = ctx.fieldErrors.get(name);\n\n    return { errors: error !== undefined ? { [name]: error } : {}, valid: error === undefined };\n  }\n\n  /* ======== Submit ======== */\n\n  async function submitOrThrow<TResult = void>(handler: (values: TValues) => MaybePromise<TResult>): Promise<TResult> {\n    const result = await submit(handler);\n\n    if (!result.ok) throw new ForgeValidationError(result.errors as Record<string, string>);\n\n    return result.value;\n  }\n\n  async function submit<TResult = void>(\n    handler: (values: TValues) => MaybePromise<TResult>,\n  ): Promise<SubmitResult<TResult>> {\n    ctx.ensureNotDisposed();\n\n    if (ctx.isSubmittingState) throw new ForgeSubmitError('submit() called while a submission is already in progress');\n\n    ctx.batch(() => {\n      ctx.submitCount++;\n      ctx.isSubmittingState = true;\n      deps.touchAll();\n    });\n\n    try {\n      const validation = await runValidationCore([...ctx.validators.keys()], 'full');\n\n      ctx.ensureNotDisposed();\n\n      if (!validation.valid) {\n        return { errors: validation.errors, ok: false, type: 'validation' };\n      }\n\n      return { ok: true, value: await handler(deps.values()) };\n    } finally {\n      ctx.isSubmittingState = false;\n\n      if (!ctx.disposed) ctx.requestNotify();\n    }\n  }\n\n  /* ======== validateStream ======== */\n\n  function validateStream(signal?: AbortSignal): AsyncIterableIterator<{ error: string | undefined; field: string }> {\n    ctx.ensureNotDisposed();\n\n    const fields = [...ctx.validators.keys()];\n    const ctrl = new AbortController();\n    const combined = signal\n      ? anySignal(ctrl.signal, signal, ctx.disposeController.signal)!\n      : anySignal(ctrl.signal, ctx.disposeController.signal)!;\n\n    type Item = { error: string | undefined; field: string };\n\n    const queue = createAsyncQueue<Item>(() => ctrl.abort());\n\n    // Run validators read-only — does NOT write to fieldErrors or fire requestNotify.\n    // Each result is yielded as it settles; the form-level validator is yielded last.\n    Promise.all(\n      fields.map(async (f) => {\n        if (combined.aborted) return;\n\n        try {\n          const error = await runFieldValidator(f, combined);\n\n          if (!combined.aborted) queue.push({ error, field: f });\n        } catch (err) {\n          if (!isAbortError(err)) throw err;\n\n          // aborted or disposed — skip this field\n        }\n      }),\n    )\n      .then(async () => {\n        // Yield the form-level validator result last (F4: streams _form key too)\n        if (ctx.formValidator && !combined.aborted) {\n          try {\n            const formErrors = await runFormValidator(combined);\n\n            if (!combined.aborted) {\n              const allKeys = new Set([FORM_ERROR, ...Object.keys(formErrors)]);\n\n              for (const key of allKeys) {\n                queue.push({ error: formErrors[key], field: key });\n              }\n            }\n          } catch {\n            // aborted\n          }\n        }\n      })\n      .catch((err) => {\n        if (!isAbortError(err)) {\n          ctrl.abort();\n          queue.fail(err);\n        }\n      })\n      .finally(() => {\n        ctrl.abort();\n        queue.finish();\n      });\n\n    return queue.iterator;\n  }\n\n  return { runValidationCore, submit, submitOrThrow, validate, validateFields, validateStream };\n}\n\nexport type ValidationOps<TValues extends Record<string, unknown>> = ReturnType<typeof createValidationOps<TValues>>;\n"],"mappings":"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"}

package/dist/core/validation.d.ts

@@ -1,23 +0,0 @@
-import type { FormContext } from './context';
-import type { ValueOps } from './values';
-import { type FlatKeyOf, type MaybePromise, type SubmitResult, type ValidateResult } from '../types';
-/**
- * Validation + submit operations: field/form validator execution, error application,
- * `validate()`/`validateFields()`/`validateStream()`, and `submit()`/`submitOrThrow()`.
- * Moved verbatim from `createForm()`'s "Validation" and "Submit" sections.
- */
-export declare function createValidationOps<TValues extends Record<string, unknown>>(ctx: FormContext<TValues>, deps: Pick<ValueOps<TValues>, 'touchAll' | 'values'>): {
-    runValidationCore: (fields: string[], scope: "full" | "partial", signal?: AbortSignal) => Promise<ValidateResult & {
-        aborted: boolean;
-    }>;
-    submit: <TResult = void>(handler: (values: TValues) => MaybePromise<TResult>) => Promise<SubmitResult<TResult>>;
-    submitOrThrow: <TResult = void>(handler: (values: TValues) => MaybePromise<TResult>) => Promise<TResult>;
-    validate: (nameOrFieldsOrSignal?: FlatKeyOf<TValues> | FlatKeyOf<TValues>[] | AbortSignal, signal?: AbortSignal) => Promise<ValidateResult>;
-    validateFields: (fields: FlatKeyOf<TValues>[] | string[], signal?: AbortSignal) => Promise<ValidateResult>;
-    validateStream: (signal?: AbortSignal) => AsyncIterableIterator<{
-        error: string | undefined;
-        field: string;
-    }>;
-};
-export type ValidationOps<TValues extends Record<string, unknown>> = ReturnType<typeof createValidationOps<TValues>>;
-//# sourceMappingURL=validation.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAIzC,OAAO,EAAE,KAAK,SAAS,EAAc,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAGjH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzE,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,EACzB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;gCAyE1C,MAAM,EAAE,SACT,MAAM,GAAG,SAAS,WAChB,WAAW,KACnB,OAAO,CAAC,cAAc,GAAG;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;aAuI3B,OAAO,kBAClB,CAAC,MAAM,EAAE,OAAO,KAAK,YAAY,CAAC,OAAO,CAAC,KAClD,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;oBAVJ,OAAO,kBAAkB,CAAC,MAAM,EAAE,OAAO,KAAK,YAAY,CAAC,OAAO,CAAC,KAAG,OAAO,CAAC,OAAO,CAAC;sCA7B1F,SAAS,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,WAAW,WACrE,WAAW,KACnB,OAAO,CAAC,cAAc,CAAC;6BAbhB,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,WAC9B,WAAW,KACnB,OAAO,CAAC,cAAc,CAAC;8BA8EO,WAAW,KAAG,qBAAqB,CAAC;QAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;EA+DnH;AAED,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC"}

package/dist/core/validation.js

@@ -1,173 +0,0 @@
-import { ForgeSubmitError as e, ForgeValidationError as t } from "../errors.js";
-import { anySignal as n, isSafeKey as r } from "../_utils.js";
-import { FORM_ERROR as i } from "../types.js";
-import { createAsyncQueue as a } from "./asyncQueue.js";
-import { isAbortError as o } from "@vielzeug/arsenal";
-//#region src/core/validation.ts
-function s(s, c) {
-	async function l(e, t) {
-		let n = s.validators.get(e);
-		if (!n) return;
-		if (t.aborted) throw t.reason;
-		let r = await n(s.store.get(e), t);
-		return typeof r == "string" ? r : void 0;
-	}
-	async function u(e) {
-		if (!s.formValidator) return {};
-		if (e.aborted) throw e.reason;
-		let t = await s.formValidator(c.values(), e), n = {};
-		if (t) for (let [e, i] of Object.entries(t)) r(e) && typeof i == "string" && (n[e] = i);
-		return n;
-	}
-	function d(e, t, n, r) {
-		if (r === "full") {
-			s.fieldErrors.clear();
-			for (let [e, r] of Object.entries(n)) t[e] === void 0 && (t[e] = r);
-			for (let [e, n] of Object.entries(t)) s.fieldErrors.set(e, n);
-			s.invalidateErrors(), s.requestNotify();
-		} else {
-			let n = /* @__PURE__ */ new Set();
-			for (let r of e) {
-				let e = t[r], i = s.fieldErrors.get(r);
-				e === void 0 ? s.fieldErrors.delete(r) && n.add(r) : (s.fieldErrors.set(r, e), i !== e && n.add(r));
-			}
-			n.size > 0 && s.invalidateErrors(), s.requestNotify(n);
-		}
-	}
-	async function f(e, t, r) {
-		let i = new Set(e), a = /* @__PURE__ */ new Map();
-		for (let e of i) {
-			s.fieldCtrls.get(e)?.abort();
-			let t = new AbortController();
-			s.fieldCtrls.set(e, t), a.set(e, t);
-		}
-		let c = new AbortController(), f = n(c.signal, r, s.disposeController.signal);
-		s.runCtrls.add(c);
-		let p = Symbol();
-		for (let e of i) {
-			let t = s.validatingRuns.get(e);
-			t || (t = /* @__PURE__ */ new Set(), s.validatingRuns.set(e, t)), t.add(p);
-		}
-		s.requestNotify();
-		try {
-			let e = await Promise.all([...i].map(async (e) => [e, await l(e, t === "partial" ? n(a.get(e).signal, f) : f)]));
-			if (f.aborted) return {
-				aborted: !0,
-				errors: Object.fromEntries(s.fieldErrors),
-				valid: s.fieldErrors.size === 0
-			};
-			let r = {};
-			for (let [t, n] of e) n !== void 0 && (r[t] = n);
-			return d(i, r, t === "full" ? await u(f) : {}, t), {
-				aborted: !1,
-				errors: Object.fromEntries(s.fieldErrors),
-				valid: s.fieldErrors.size === 0
-			};
-		} catch (e) {
-			if (o(e)) return {
-				aborted: !0,
-				errors: Object.fromEntries(s.fieldErrors),
-				valid: s.fieldErrors.size === 0
-			};
-			throw e;
-		} finally {
-			s.runCtrls.delete(c);
-			for (let e of i) {
-				let t = s.validatingRuns.get(e);
-				t && (t.delete(p), t.size === 0 && s.validatingRuns.delete(e));
-			}
-			s.requestNotify();
-			for (let [e, t] of a) s.fieldCtrls.get(e) === t && s.fieldCtrls.delete(e);
-		}
-	}
-	async function p(e, t) {
-		s.ensureNotDisposed();
-		let n = await f(e, "partial", t);
-		return {
-			errors: n.errors,
-			valid: n.valid
-		};
-	}
-	async function m(e, t) {
-		if (s.ensureNotDisposed(), e === void 0 || e instanceof AbortSignal) {
-			let t = await f([...s.validators.keys()], "full", e);
-			return {
-				errors: t.errors,
-				valid: t.valid
-			};
-		}
-		if (Array.isArray(e)) return p(e, t);
-		await p([e], t);
-		let n = e, r = s.fieldErrors.get(n);
-		return {
-			errors: r === void 0 ? {} : { [n]: r },
-			valid: r === void 0
-		};
-	}
-	async function h(e) {
-		let n = await g(e);
-		if (!n.ok) throw new t(n.errors);
-		return n.value;
-	}
-	async function g(t) {
-		if (s.ensureNotDisposed(), s.isSubmittingState) throw new e("submit() called while a submission is already in progress");
-		s.batch(() => {
-			s.submitCount++, s.isSubmittingState = !0, c.touchAll();
-		});
-		try {
-			let e = await f([...s.validators.keys()], "full");
-			return s.ensureNotDisposed(), e.valid ? {
-				ok: !0,
-				value: await t(c.values())
-			} : {
-				errors: e.errors,
-				ok: !1,
-				type: "validation"
-			};
-		} finally {
-			s.isSubmittingState = !1, s.disposed || s.requestNotify();
-		}
-	}
-	function _(e) {
-		s.ensureNotDisposed();
-		let t = [...s.validators.keys()], r = new AbortController(), c = e ? n(r.signal, e, s.disposeController.signal) : n(r.signal, s.disposeController.signal), d = a(() => r.abort());
-		return Promise.all(t.map(async (e) => {
-			if (!c.aborted) try {
-				let t = await l(e, c);
-				c.aborted || d.push({
-					error: t,
-					field: e
-				});
-			} catch (e) {
-				if (!o(e)) throw e;
-			}
-		})).then(async () => {
-			if (s.formValidator && !c.aborted) try {
-				let e = await u(c);
-				if (!c.aborted) {
-					let t = /* @__PURE__ */ new Set([i, ...Object.keys(e)]);
-					for (let n of t) d.push({
-						error: e[n],
-						field: n
-					});
-				}
-			} catch {}
-		}).catch((e) => {
-			o(e) || (r.abort(), d.fail(e));
-		}).finally(() => {
-			r.abort(), d.finish();
-		}), d.iterator;
-	}
-	return {
-		runValidationCore: f,
-		submit: g,
-		submitOrThrow: h,
-		validate: m,
-		validateFields: p,
-		validateStream: _
-	};
-}
-//#endregion
-export { s as createValidationOps };
-
-//# sourceMappingURL=validation.js.map

package/dist/core/validation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.js","names":[],"sources":["../../src/core/validation.ts"],"sourcesContent":["import { isAbortError } from '@vielzeug/arsenal';\n\nimport type { FormContext } from './context';\nimport type { ValueOps } from './values';\n\nimport { anySignal, isSafeKey } from '../_utils';\nimport { ForgeSubmitError, ForgeValidationError } from '../errors';\nimport { type FlatKeyOf, FORM_ERROR, type MaybePromise, type SubmitResult, type ValidateResult } from '../types';\nimport { createAsyncQueue } from './asyncQueue';\n\n/**\n * Validation + submit operations: field/form validator execution, error application,\n * `validate()`/`validateFields()`/`validateStream()`, and `submit()`/`submitOrThrow()`.\n * Moved verbatim from `createForm()`'s \"Validation\" and \"Submit\" sections.\n */\nexport function createValidationOps<TValues extends Record<string, unknown>>(\n  ctx: FormContext<TValues>,\n  deps: Pick<ValueOps<TValues>, 'touchAll' | 'values'>,\n) {\n  async function runFieldValidator(name: string, signal: AbortSignal): Promise<string | undefined> {\n    const validator = ctx.validators.get(name);\n\n    if (!validator) return undefined;\n\n    if (signal.aborted) throw signal.reason;\n\n    const result = await validator(ctx.store.get(name), signal);\n\n    return typeof result === 'string' ? result : undefined;\n  }\n\n  async function runFormValidator(signal: AbortSignal): Promise<Record<string, string>> {\n    if (!ctx.formValidator) return {};\n\n    if (signal.aborted) throw signal.reason;\n\n    const result = await ctx.formValidator(deps.values(), signal);\n    const errors: Record<string, string> = {};\n\n    if (result) {\n      for (const [key, message] of Object.entries(result)) {\n        // Security: a custom FormValidator function is caller-authored code — its returned\n        // keys are just as untrusted as a schema's `issue.path`. Reject reserved segments.\n        if (isSafeKey(key) && typeof message === 'string') errors[key] = message;\n      }\n    }\n\n    return errors;\n  }\n\n  function applyFieldErrors(\n    fieldSet: Set<string>,\n    nextErrors: Record<string, string>,\n    formErrors: Record<string, string>,\n    scope: 'full' | 'partial',\n  ): void {\n    if (scope === 'full') {\n      ctx.fieldErrors.clear();\n\n      for (const [key, message] of Object.entries(formErrors)) {\n        if (nextErrors[key] === undefined) nextErrors[key] = message;\n      }\n\n      for (const [key, message] of Object.entries(nextErrors)) ctx.fieldErrors.set(key, message);\n\n      ctx.invalidateErrors();\n      ctx.requestNotify();\n    } else {\n      const changedFields = new Set<string>();\n\n      for (const name of fieldSet) {\n        const next = nextErrors[name];\n        const previous = ctx.fieldErrors.get(name);\n\n        if (next !== undefined) {\n          ctx.fieldErrors.set(name, next);\n\n          if (previous !== next) changedFields.add(name);\n        } else if (ctx.fieldErrors.delete(name)) {\n          changedFields.add(name);\n        }\n      }\n\n      if (changedFields.size > 0) ctx.invalidateErrors();\n\n      ctx.requestNotify(changedFields);\n    }\n  }\n\n  async function runValidationCore(\n    fields: string[],\n    scope: 'full' | 'partial',\n    signal?: AbortSignal,\n  ): Promise<ValidateResult & { aborted: boolean }> {\n    const fieldSet = new Set(fields);\n    const fieldRunCtrls = new Map<string, AbortController>();\n\n    for (const name of fieldSet) {\n      ctx.fieldCtrls.get(name)?.abort();\n\n      const ctrl = new AbortController();\n\n      ctx.fieldCtrls.set(name, ctrl);\n      fieldRunCtrls.set(name, ctrl);\n    }\n\n    const runCtrl = new AbortController();\n    const runSignal = anySignal(runCtrl.signal, signal, ctx.disposeController.signal)!;\n\n    ctx.runCtrls.add(runCtrl);\n\n    // Symbol-based ref-counting: each run gets a unique token per field.\n    // The field leaves validatingFields only when its Set empties — impossible to miscount.\n    const runId = Symbol();\n\n    for (const name of fieldSet) {\n      let runs = ctx.validatingRuns.get(name);\n\n      if (!runs) {\n        runs = new Set<symbol>();\n        ctx.validatingRuns.set(name, runs);\n      }\n\n      runs.add(runId);\n    }\n\n    ctx.requestNotify();\n\n    try {\n      const results = await Promise.all(\n        [...fieldSet].map(async (name) => {\n          const fieldSignal = scope === 'partial' ? anySignal(fieldRunCtrls.get(name)!.signal, runSignal)! : runSignal;\n\n          return [name, await runFieldValidator(name, fieldSignal)] as const;\n        }),\n      );\n\n      if (runSignal.aborted) {\n        return { aborted: true, errors: Object.fromEntries(ctx.fieldErrors), valid: ctx.fieldErrors.size === 0 };\n      }\n\n      const nextErrors: Record<string, string> = {};\n\n      for (const [name, message] of results) {\n        if (message !== undefined) nextErrors[name] = message;\n      }\n\n      const formErrors = scope === 'full' ? await runFormValidator(runSignal) : {};\n\n      applyFieldErrors(fieldSet, nextErrors, formErrors, scope);\n\n      return { aborted: false, errors: Object.fromEntries(ctx.fieldErrors), valid: ctx.fieldErrors.size === 0 };\n    } catch (error) {\n      if (isAbortError(error)) {\n        return { aborted: true, errors: Object.fromEntries(ctx.fieldErrors), valid: ctx.fieldErrors.size === 0 };\n      }\n\n      throw error;\n    } finally {\n      ctx.runCtrls.delete(runCtrl);\n\n      for (const name of fieldSet) {\n        const runs = ctx.validatingRuns.get(name);\n\n        if (runs) {\n          runs.delete(runId);\n\n          if (runs.size === 0) ctx.validatingRuns.delete(name);\n        }\n      }\n\n      ctx.requestNotify();\n\n      for (const [name, ctrl] of fieldRunCtrls) {\n        if (ctx.fieldCtrls.get(name) === ctrl) ctx.fieldCtrls.delete(name);\n      }\n    }\n  }\n\n  async function validateFields(\n    fields: FlatKeyOf<TValues>[] | string[],\n    signal?: AbortSignal,\n  ): Promise<ValidateResult> {\n    ctx.ensureNotDisposed();\n\n    const result = await runValidationCore(fields as string[], 'partial', signal);\n\n    return { errors: result.errors, valid: result.valid };\n  }\n\n  async function validate(\n    nameOrFieldsOrSignal?: FlatKeyOf<TValues> | FlatKeyOf<TValues>[] | AbortSignal,\n    signal?: AbortSignal,\n  ): Promise<ValidateResult> {\n    ctx.ensureNotDisposed();\n\n    if (nameOrFieldsOrSignal === undefined || nameOrFieldsOrSignal instanceof AbortSignal) {\n      const result = await runValidationCore(\n        [...ctx.validators.keys()],\n        'full',\n        nameOrFieldsOrSignal as AbortSignal | undefined,\n      );\n\n      return { errors: result.errors, valid: result.valid };\n    }\n\n    if (Array.isArray(nameOrFieldsOrSignal)) {\n      return validateFields(nameOrFieldsOrSignal, signal);\n    }\n\n    await validateFields([nameOrFieldsOrSignal], signal);\n\n    const name = nameOrFieldsOrSignal as string;\n    const error = ctx.fieldErrors.get(name);\n\n    return { errors: error !== undefined ? { [name]: error } : {}, valid: error === undefined };\n  }\n\n  /* ======== Submit ======== */\n\n  async function submitOrThrow<TResult = void>(handler: (values: TValues) => MaybePromise<TResult>): Promise<TResult> {\n    const result = await submit(handler);\n\n    if (!result.ok) throw new ForgeValidationError(result.errors as Record<string, string>);\n\n    return result.value;\n  }\n\n  async function submit<TResult = void>(\n    handler: (values: TValues) => MaybePromise<TResult>,\n  ): Promise<SubmitResult<TResult>> {\n    ctx.ensureNotDisposed();\n\n    if (ctx.isSubmittingState) throw new ForgeSubmitError('submit() called while a submission is already in progress');\n\n    ctx.batch(() => {\n      ctx.submitCount++;\n      ctx.isSubmittingState = true;\n      deps.touchAll();\n    });\n\n    try {\n      const validation = await runValidationCore([...ctx.validators.keys()], 'full');\n\n      ctx.ensureNotDisposed();\n\n      if (!validation.valid) {\n        return { errors: validation.errors, ok: false, type: 'validation' };\n      }\n\n      return { ok: true, value: await handler(deps.values()) };\n    } finally {\n      ctx.isSubmittingState = false;\n\n      if (!ctx.disposed) ctx.requestNotify();\n    }\n  }\n\n  /* ======== validateStream ======== */\n\n  function validateStream(signal?: AbortSignal): AsyncIterableIterator<{ error: string | undefined; field: string }> {\n    ctx.ensureNotDisposed();\n\n    const fields = [...ctx.validators.keys()];\n    const ctrl = new AbortController();\n    const combined = signal\n      ? anySignal(ctrl.signal, signal, ctx.disposeController.signal)!\n      : anySignal(ctrl.signal, ctx.disposeController.signal)!;\n\n    type Item = { error: string | undefined; field: string };\n\n    const queue = createAsyncQueue<Item>(() => ctrl.abort());\n\n    // Run validators read-only — does NOT write to fieldErrors or fire requestNotify.\n    // Each result is yielded as it settles; the form-level validator is yielded last.\n    Promise.all(\n      fields.map(async (f) => {\n        if (combined.aborted) return;\n\n        try {\n          const error = await runFieldValidator(f, combined);\n\n          if (!combined.aborted) queue.push({ error, field: f });\n        } catch (err) {\n          if (!isAbortError(err)) throw err;\n\n          // aborted or disposed — skip this field\n        }\n      }),\n    )\n      .then(async () => {\n        // Yield the form-level validator result last (F4: streams _form key too)\n        if (ctx.formValidator && !combined.aborted) {\n          try {\n            const formErrors = await runFormValidator(combined);\n\n            if (!combined.aborted) {\n              const allKeys = new Set([FORM_ERROR, ...Object.keys(formErrors)]);\n\n              for (const key of allKeys) {\n                queue.push({ error: formErrors[key], field: key });\n              }\n            }\n          } catch {\n            // aborted\n          }\n        }\n      })\n      .catch((err) => {\n        if (!isAbortError(err)) {\n          ctrl.abort();\n          queue.fail(err);\n        }\n      })\n      .finally(() => {\n        ctrl.abort();\n        queue.finish();\n      });\n\n    return queue.iterator;\n  }\n\n  return { runValidationCore, submit, submitOrThrow, validate, validateFields, validateStream };\n}\n\nexport type ValidationOps<TValues extends Record<string, unknown>> = ReturnType<typeof createValidationOps<TValues>>;\n"],"mappings":"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"}

package/dist/core/values.cjs

@@ -1,2 +0,0 @@
-const e=require("../_dev.cjs"),t=require("../_utils.cjs"),n=require("./array.cjs");let r=require("@vielzeug/arsenal");function i(i){function a(e){let n=e;return t.assertSafeKey(n),i.store.get(n)}function o(){return i.cachedValues??=(0,r.unflattenPaths)(Object.fromEntries(i.store))}function s(e,t){i.baseline.get(e)===t?i.dirty.delete(e):i.dirty.add(e)}function c(e,n,r={}){i.ensureNotDisposed();let a=e;t.assertSafeKey(a),i.store.set(a,n),s(a,n),r.touched&&i.touched.add(a),i.requestNotify(a)}function l(e){let n=e;return t.assertSafeKey(n),i.getFieldSnapshot(n)}function u(e,n){i.ensureNotDisposed();let r=e;t.assertSafeKey(r),i.fieldErrors.set(r,n),i.invalidateErrors(),i.requestNotify(r)}function d(e){i.ensureNotDisposed();let n=e;t.assertSafeKey(n),i.fieldErrors.delete(n)&&(i.invalidateErrors(),i.requestNotify(n))}function f(e={}){i.ensureNotDisposed(),i.fieldErrors.clear();for(let[n,r]of Object.entries(e))t.assertSafeKey(n),typeof r==`string`&&i.fieldErrors.set(n,r);i.invalidateErrors(),i.requestNotify()}function p(n,r){/\.\d+(\.|$)/.test(n)&&!i.store.has(n)&&e.warn(`${r}('${t.sanitizeForLog(n,80)}'): path looks like an array item key. Array items are stored as whole arrays — register on the parent key instead.`)}function m(e,n){i.ensureNotDisposed();let r=e;t.assertSafeKey(r),p(r,`setValidator`),i.fieldCtrls.get(r)?.abort(),i.fieldCtrls.delete(r),n?i.validators.set(r,n):(i.validators.delete(r),i.fieldErrors.delete(r)&&(i.invalidateErrors(),i.requestNotify(r)))}function h(e,n={}){i.ensureNotDisposed();let r=e;return t.assertSafeKey(r),p(r,`fields.register`),n.validator!==void 0&&m(e,n.validator),n.defaultValue!==void 0&&!i.store.has(r)&&(i.store.set(r,n.defaultValue),i.baseline.set(r,n.defaultValue),i.requestNotify(r)),()=>{i.disposed||S(e)}}function g(){let e=new Set;for(let t of i.store.keys())e.add(t);for(let t of i.validators.keys())e.add(t);return Object.freeze([...e])}function _(e){i.ensureNotDisposed();let n=e;t.assertSafeKey(n),i.touched.add(n),i.requestNotify(n)}function v(e){i.ensureNotDisposed();let n=e;t.assertSafeKey(n),i.touched.delete(n)&&i.requestNotify(n)}function y(){i.ensureNotDisposed();for(let e of i.store.keys())i.touched.add(e);for(let e of i.validators.keys())i.touched.add(e);i.requestNotify()}function b(){i.ensureNotDisposed(),i.touched.clear(),i.requestNotify()}function x(e){i.ensureNotDisposed();let n=e;t.assertSafeKey(n),i.fieldCtrls.get(n)?.abort(),i.fieldCtrls.delete(n),i.store.set(n,i.baseline.get(n)),i.dirty.delete(n),i.touched.delete(n),i.fieldErrors.delete(n)&&i.invalidateErrors(),i.requestNotify(n)}function S(e){i.ensureNotDisposed();let n=e;t.assertSafeKey(n),i.store.delete(n),i.baseline.delete(n),i.dirty.delete(n),i.touched.delete(n),i.validators.delete(n),i.arrayCache.delete(n),i.fieldCtrls.get(n)?.abort(),i.fieldCtrls.delete(n),i.fieldErrors.delete(n)&&i.invalidateErrors(),i.requestNotify(n)}function C(){i.ensureNotDisposed();for(let e of i.runCtrls)e.abort();for(let e of i.fieldCtrls.values())e.abort();i.runCtrls.clear(),i.fieldCtrls.clear(),i.validatingRuns.clear(),i.store.clear(),i.fieldErrors.clear(),i.touched.clear(),i.dirty.clear(),i.submitCount=0,i.invalidateErrors();for(let[e,t]of i.baseline)i.store.set(e,t);i.requestNotify()}function w(e){i.ensureNotDisposed();for(let e of i.runCtrls)e.abort();for(let e of i.fieldCtrls.values())e.abort();i.runCtrls.clear(),i.fieldCtrls.clear(),i.validatingRuns.clear();let t=(0,r.flattenPaths)(e);i.store.clear(),i.baseline.clear(),i.fieldErrors.clear(),i.touched.clear(),i.dirty.clear(),i.submitCount=0,i.invalidateErrors();for(let[e,n]of Object.entries(t))i.store.set(e,n),i.baseline.set(e,n);i.requestNotify()}function T(e){i.ensureNotDisposed();let t=(0,r.flattenPaths)(e);for(let[e,n]of Object.entries(t))i.baseline.set(e,n),i.store.set(e,n),i.dirty.delete(e);i.requestNotify(Object.keys(t))}function E(e){i.ensureNotDisposed();let r=e;t.assertSafeKey(r);let a=i.arrayCache.get(r);if(a)return a;let o=n.createArrayField(e,i.store,c);return i.arrayCache.set(r,o),o}return{array:E,clearError:d,field:l,get:a,listFields:g,patch:T,registerField:h,removeField:S,replace:w,reset:C,resetErrors:f,resetField:x,set:c,setError:u,setValidator:m,touch:_,touchAll:y,untouch:v,untouchAll:b,values:o}}exports.createValueOps=i;
-//# sourceMappingURL=values.cjs.map

package/dist/core/values.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"values.cjs","names":[],"sources":["../../src/core/values.ts"],"sourcesContent":["import type { FormContext } from './context';\n\nimport { warn } from '../_dev';\nimport { assertSafeKey, flattenValues, sanitizeForLog, unflattenValues } from '../_utils';\nimport {\n  type ArrayField,\n  type ErrorKeyOf,\n  type FieldState,\n  type FieldValidator,\n  type FlatKeyOf,\n  type RegisterFieldOptions,\n  type SetOptions,\n  type TypeAtPath,\n  type Unsubscribe,\n} from '../types';\nimport { createArrayField } from './array';\n\n/**\n * Value/field-mutation operations: get/set/values, dirty tracking, errors, dynamic field\n * registration, touch, and reset/replace/patch/array. Moved verbatim from `createForm()`'s\n * \"Value access\" through \"Lifecycle: field operations\" sections.\n */\nexport function createValueOps<TValues extends Record<string, unknown>>(ctx: FormContext<TValues>) {\n  function get<K extends FlatKeyOf<TValues>>(name: K): TypeAtPath<TValues, K> {\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    return ctx.store.get(key) as TypeAtPath<TValues, K>;\n  }\n\n  function values(): TValues {\n    return (ctx.cachedValues ??= unflattenValues(Object.fromEntries(ctx.store)) as TValues);\n  }\n\n  /* ======== Dirty tracking ======== */\n\n  function trackDirty(name: string, value: unknown): void {\n    if (ctx.baseline.get(name) === value) ctx.dirty.delete(name);\n    else ctx.dirty.add(name);\n  }\n\n  /* ======== Field mutation ======== */\n\n  function set<K extends FlatKeyOf<TValues>>(name: K, value: TypeAtPath<TValues, K>, options: SetOptions = {}): void {\n    ctx.ensureNotDisposed();\n\n    const key = name as string;\n\n    assertSafeKey(key);\n    ctx.store.set(key, value);\n    trackDirty(key, value);\n\n    if (options.touched) ctx.touched.add(key);\n\n    ctx.requestNotify(key);\n  }\n\n  function field<K extends FlatKeyOf<TValues>>(name: K): FieldState<TypeAtPath<TValues, K>> {\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    return ctx.getFieldSnapshot(key) as FieldState<TypeAtPath<TValues, K>>;\n  }\n\n  function setError(name: ErrorKeyOf<TValues>, message: string): void {\n    ctx.ensureNotDisposed();\n\n    const key = name as string;\n\n    assertSafeKey(key);\n    ctx.fieldErrors.set(key, message);\n    ctx.invalidateErrors();\n    ctx.requestNotify(key);\n  }\n\n  function clearError(name: ErrorKeyOf<TValues>): void {\n    ctx.ensureNotDisposed();\n\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    if (ctx.fieldErrors.delete(key)) {\n      ctx.invalidateErrors();\n      ctx.requestNotify(key);\n    }\n  }\n\n  function resetErrors(nextErrors: Partial<Record<ErrorKeyOf<TValues>, string | undefined>> = {}): void {\n    ctx.ensureNotDisposed();\n\n    ctx.fieldErrors.clear();\n\n    for (const [key, message] of Object.entries(nextErrors)) {\n      assertSafeKey(key);\n\n      if (typeof message === 'string') ctx.fieldErrors.set(key, message);\n    }\n\n    ctx.invalidateErrors();\n    ctx.requestNotify();\n  }\n\n  /**\n   * Warns when `key` looks like a dot-notation array item path (e.g. \"tags.0\") that isn't\n   * already a real store entry — array items are stored as whole arrays, not individual keys.\n   * Shared by `setValidator()` and `registerField()`.\n   */\n  function warnIfArrayItemKey(key: string, apiLabel: string): void {\n    if (/\\.\\d+(\\.|$)/.test(key) && !ctx.store.has(key)) {\n      const displayKey = sanitizeForLog(key, 80);\n\n      warn(\n        `${apiLabel}('${displayKey}'): path looks like an array item key. ` +\n          `Array items are stored as whole arrays — register on the parent key instead.`,\n      );\n    }\n  }\n\n  function setValidator(name: FlatKeyOf<TValues>, validator?: FieldValidator<unknown>): void {\n    ctx.ensureNotDisposed();\n\n    const key = name as string;\n\n    assertSafeKey(key);\n    warnIfArrayItemKey(key, 'setValidator');\n\n    ctx.fieldCtrls.get(key)?.abort();\n    ctx.fieldCtrls.delete(key);\n\n    if (validator) {\n      ctx.validators.set(key, validator);\n    } else {\n      ctx.validators.delete(key);\n\n      if (ctx.fieldErrors.delete(key)) {\n        ctx.invalidateErrors();\n        ctx.requestNotify(key);\n      }\n    }\n  }\n\n  /* ======== Dynamic field registration ======== */\n\n  function registerField<K extends FlatKeyOf<TValues>>(\n    name: K,\n    options: RegisterFieldOptions<TypeAtPath<TValues, K>> = {},\n  ): Unsubscribe {\n    ctx.ensureNotDisposed();\n\n    const key = name as string;\n\n    assertSafeKey(key);\n    warnIfArrayItemKey(key, 'fields.register');\n\n    if (options.validator !== undefined) setValidator(name, options.validator as FieldValidator<unknown>);\n\n    if (options.defaultValue !== undefined && !ctx.store.has(key)) {\n      ctx.store.set(key, options.defaultValue);\n      ctx.baseline.set(key, options.defaultValue);\n      ctx.requestNotify(key);\n    }\n\n    return () => {\n      if (!ctx.disposed) removeField(name);\n    };\n  }\n\n  /* ======== Field enumeration ======== */\n\n  function listFields(): readonly string[] {\n    const known = new Set<string>();\n\n    for (const name of ctx.store.keys()) known.add(name);\n    for (const name of ctx.validators.keys()) known.add(name);\n\n    return Object.freeze([...known]);\n  }\n\n  /* ======== Touch ======== */\n\n  function touch(name: FlatKeyOf<TValues>): void {\n    ctx.ensureNotDisposed();\n\n    const key = name as string;\n\n    assertSafeKey(key);\n    ctx.touched.add(key);\n    ctx.requestNotify(key);\n  }\n\n  function untouch(name: FlatKeyOf<TValues>): void {\n    ctx.ensureNotDisposed();\n\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    if (ctx.touched.delete(key)) ctx.requestNotify(key);\n  }\n\n  function touchAll(): void {\n    ctx.ensureNotDisposed();\n\n    for (const name of ctx.store.keys()) ctx.touched.add(name);\n    for (const name of ctx.validators.keys()) ctx.touched.add(name);\n\n    ctx.requestNotify();\n  }\n\n  function untouchAll(): void {\n    ctx.ensureNotDisposed();\n    ctx.touched.clear();\n    ctx.requestNotify();\n  }\n\n  /* ======== Lifecycle: field operations ======== */\n\n  function resetField(name: FlatKeyOf<TValues>): void {\n    ctx.ensureNotDisposed();\n\n    const key = name as string;\n\n    assertSafeKey(key);\n    ctx.fieldCtrls.get(key)?.abort();\n    ctx.fieldCtrls.delete(key);\n    ctx.store.set(key, ctx.baseline.get(key));\n    ctx.dirty.delete(key);\n    ctx.touched.delete(key);\n\n    if (ctx.fieldErrors.delete(key)) ctx.invalidateErrors();\n\n    ctx.requestNotify(key);\n  }\n\n  function removeField(name: FlatKeyOf<TValues>): void {\n    ctx.ensureNotDisposed();\n\n    const key = name as string;\n\n    assertSafeKey(key);\n    ctx.store.delete(key);\n    ctx.baseline.delete(key);\n    ctx.dirty.delete(key);\n    ctx.touched.delete(key);\n    ctx.validators.delete(key);\n    ctx.arrayCache.delete(key);\n    ctx.fieldCtrls.get(key)?.abort();\n    ctx.fieldCtrls.delete(key);\n\n    if (ctx.fieldErrors.delete(key)) ctx.invalidateErrors();\n\n    ctx.requestNotify(key);\n  }\n\n  function reset(): void {\n    ctx.ensureNotDisposed();\n\n    for (const ctrl of ctx.runCtrls) ctrl.abort();\n    for (const ctrl of ctx.fieldCtrls.values()) ctrl.abort();\n\n    ctx.runCtrls.clear();\n    ctx.fieldCtrls.clear();\n    ctx.validatingRuns.clear();\n    ctx.store.clear();\n    ctx.fieldErrors.clear();\n    ctx.touched.clear();\n    ctx.dirty.clear();\n    ctx.submitCount = 0;\n    ctx.invalidateErrors();\n\n    for (const [name, value] of ctx.baseline) ctx.store.set(name, value);\n\n    ctx.requestNotify();\n  }\n\n  function replace(newValues: TValues): void {\n    ctx.ensureNotDisposed();\n\n    for (const ctrl of ctx.runCtrls) ctrl.abort();\n    for (const ctrl of ctx.fieldCtrls.values()) ctrl.abort();\n\n    ctx.runCtrls.clear();\n    ctx.fieldCtrls.clear();\n    ctx.validatingRuns.clear();\n\n    const flat = flattenValues(newValues as Record<string, unknown>);\n\n    ctx.store.clear();\n    ctx.baseline.clear();\n    ctx.fieldErrors.clear();\n    ctx.touched.clear();\n    ctx.dirty.clear();\n    ctx.submitCount = 0;\n    ctx.invalidateErrors();\n\n    for (const [name, value] of Object.entries(flat)) {\n      ctx.store.set(name, value);\n      ctx.baseline.set(name, value);\n    }\n\n    ctx.requestNotify();\n  }\n\n  function patch(partial: Record<string, unknown>): void {\n    ctx.ensureNotDisposed();\n\n    const flat = flattenValues(partial);\n\n    for (const [key, value] of Object.entries(flat)) {\n      ctx.baseline.set(key, value);\n      ctx.store.set(key, value);\n      ctx.dirty.delete(key);\n    }\n\n    ctx.requestNotify(Object.keys(flat));\n  }\n\n  /* ======== Array helpers ======== */\n\n  function array(name: FlatKeyOf<TValues>): ArrayField {\n    ctx.ensureNotDisposed();\n\n    const key = name as string;\n\n    assertSafeKey(key);\n\n    const cached = ctx.arrayCache.get(key);\n\n    if (cached) return cached;\n\n    const helpers = createArrayField(name, ctx.store, set as (name: string, value: unknown) => void);\n\n    ctx.arrayCache.set(key, helpers);\n\n    return helpers;\n  }\n\n  return {\n    array,\n    clearError,\n    field,\n    get,\n    listFields,\n    patch,\n    registerField,\n    removeField,\n    replace,\n    reset,\n    resetErrors,\n    resetField,\n    set,\n    setError,\n    setValidator,\n    touch,\n    touchAll,\n    untouch,\n    untouchAll,\n    values,\n  };\n}\n\nexport type ValueOps<TValues extends Record<string, unknown>> = ReturnType<typeof createValueOps<TValues>>;\n"],"mappings":"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"}

package/dist/core/values.d.ts

@@ -1,31 +0,0 @@
-import type { FormContext } from './context';
-import { type ArrayField, type ErrorKeyOf, type FieldState, type FieldValidator, type FlatKeyOf, type RegisterFieldOptions, type SetOptions, type TypeAtPath, type Unsubscribe } from '../types';
-/**
- * Value/field-mutation operations: get/set/values, dirty tracking, errors, dynamic field
- * registration, touch, and reset/replace/patch/array. Moved verbatim from `createForm()`'s
- * "Value access" through "Lifecycle: field operations" sections.
- */
-export declare function createValueOps<TValues extends Record<string, unknown>>(ctx: FormContext<TValues>): {
-    array: (name: FlatKeyOf<TValues>) => ArrayField;
-    clearError: (name: ErrorKeyOf<TValues>) => void;
-    field: <K extends FlatKeyOf<TValues>>(name: K) => FieldState<TypeAtPath<TValues, K>>;
-    get: <K extends FlatKeyOf<TValues>>(name: K) => TypeAtPath<TValues, K>;
-    listFields: () => readonly string[];
-    patch: (partial: Record<string, unknown>) => void;
-    registerField: <K extends FlatKeyOf<TValues>>(name: K, options?: RegisterFieldOptions<TypeAtPath<TValues, K>>) => Unsubscribe;
-    removeField: (name: FlatKeyOf<TValues>) => void;
-    replace: (newValues: TValues) => void;
-    reset: () => void;
-    resetErrors: (nextErrors?: Partial<Record<ErrorKeyOf<TValues>, string | undefined>>) => void;
-    resetField: (name: FlatKeyOf<TValues>) => void;
-    set: <K extends FlatKeyOf<TValues>>(name: K, value: TypeAtPath<TValues, K>, options?: SetOptions) => void;
-    setError: (name: ErrorKeyOf<TValues>, message: string) => void;
-    setValidator: (name: FlatKeyOf<TValues>, validator?: FieldValidator<unknown>) => void;
-    touch: (name: FlatKeyOf<TValues>) => void;
-    touchAll: () => void;
-    untouch: (name: FlatKeyOf<TValues>) => void;
-    untouchAll: () => void;
-    values: () => TValues;
-};
-export type ValueOps<TValues extends Record<string, unknown>> = ReturnType<typeof createValueOps<TValues>>;
-//# sourceMappingURL=values.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/core/values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAI7C,OAAO,EACL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,UAAU,CAAC;AAGlB;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC;kBA4S1E,SAAS,CAAC,OAAO,CAAC,KAAG,UAAU;uBArP1B,UAAU,CAAC,OAAO,CAAC,KAAG,IAAI;YAnBrC,CAAC,SAAS,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAG,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;UAnC5E,CAAC,SAAS,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAG,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;sBAqJpD,SAAS,MAAM,EAAE;qBAsIhB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;oBAhK/B,CAAC,SAAS,SAAS,CAAC,OAAO,CAAC,QAC3C,CAAC,YACE,oBAAoB,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KACpD,WAAW;wBAwFa,SAAS,CAAC,OAAO,CAAC,KAAG,IAAI;yBAyCxB,OAAO,KAAG,IAAI;iBArBxB,IAAI;+BAvKW,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,KAAQ,IAAI;uBAkI3E,SAAS,CAAC,OAAO,CAAC,KAAG,IAAI;UAhLtC,CAAC,SAAS,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,YAAW,UAAU,KAAQ,IAAI;qBAsB1F,UAAU,CAAC,OAAO,CAAC,WAAW,MAAM,KAAG,IAAI;yBAuDvC,SAAS,CAAC,OAAO,CAAC,cAAc,cAAc,CAAC,OAAO,CAAC,KAAG,IAAI;kBA8DrE,SAAS,CAAC,OAAO,CAAC,KAAG,IAAI;oBAoBzB,IAAI;oBAVF,SAAS,CAAC,OAAO,CAAC,KAAG,IAAI;sBAmBzB,IAAI;kBArLR,OAAO;EA2U3B;AAED,MAAM,MAAM,QAAQ,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC"}