API reference > @kontsedal/olas-core > FormIssue

FormIssue type

A single validation issue, optionally targeting a descendant of a form tree.

• An **empty** path means the node the validator is attached to itself — for a leaf Field that's the field; for a Form / FieldArray it's the node's topLevelErrors. - A **non-empty** path routes the message to the matching descendant (Form walks keys, FieldArray walks numeric indices). Unresolvable paths fall back to the owning node's topLevelErrors rather than vanishing.

Segments are object keys (string) or array indices (number). Returned by form-level validators (cross-field rules) and by the Standard-Schemavalidator(...) adapter, which maps each issue.path here. See SPEC §8.3.

Signature:

type FormIssue = {
  path: (string | number)[];
  message: string;
};