Class FieldValidationState

packages/forms/signals/src/field/validation.ts:150–373

 *    form submit fails with errors.
 */
export class FieldValidationState implements ValidationState {
  constructor(readonly node: FieldNode) {}

  /**
   * The full set of synchronous tree errors visible to this field. This includes ones that are
   * targeted at a descendant field rather than at this field.
   */
  readonly rawSyncTreeErrors: Signal<ValidationError.WithFieldTree[]> = computed(
    () => {
      if (this.shouldSkipValidation()) {
        return [];
      }

      return [
        ...this.node.logicNode.logic.syncTreeErrors.compute(this.node.context),
        ...(this.node.structure.parent?.validationState.rawSyncTreeErrors() ?? []),
      ];
    },
    {equal: shallowArrayEquals},
  );

  /**
   * The full set of synchronous errors for this field, including synchronous tree errors and
   * submission errors. Submission errors are considered "synchronous" because they are imperatively
   * added. From the perspective of the field state they are either there or not, they are never in a
   * pending state.
   */
  readonly syncErrors: Signal<ValidationError.WithFieldTree[]> = computed(
    () => {
      // Short-circuit running validators if validation doesn't apply to this field.
      if (this.shouldSkipValidation()) {
        return [];
      }

      return [
        ...this.node.logicNode.logic.syncErrors.compute(this.node.context),
        ...this.syncTreeErrors(),
        ...normalizeErrors(this.node.submitState.submissionErrors()),
      ];
    },
    {equal: shallowArrayEquals},
  );

  /**
   * Whether the field is considered valid according solely to its synchronous validators.
   * Errors resulting from a previous submit attempt are also considered for this state.
   */
  readonly syncValid: Signal<boolean> = computed(() => {
    // Short-circuit checking children if validation doesn't apply to this field.
    if (this.shouldSkipValidation()) {
      return true;
    }

    return this.node.structure.reduceChildren(
      this.syncErrors().length === 0,
      (child, value) => value && child.validationState.syncValid(),
      shortCircuitFalse,
    );