enabledWhen()

Enables a field only when the predicate returns true. The most common rule for condition-driven gating — plan tiers, feature flags, permissions, environment checks.

Signature

enabledWhen(
  field,
  (values, conditions) => boolean,
  {
    reason?: string | ((values, conditions) => string)
  },
)

Example

enabledWhen('companyName', (_values, conditions) => conditions.plan === 'business', {
  reason: 'business plan required',
})

Default reason

"condition not met"

See also

• Quick Start: enabledWhen — interactive demo
• check() — bridge validators into enabledWhen predicates
• Custom Reasons — static and dynamic reason strings