fix: (DNM) Constrain day on blur

[LFDanLu]

courtesy of #8385, so we have a build to test on Monday

✅ Pull Request Checklist:

• Included link to corresponding React Spectrum GitHub Issue.
• Added/updated unit tests and storybook for this change (for new code or code which already has tests).
• Filled out test instructions.
• Updated documentation (if it already exists for this component).
• Looked at the Accessibility Practices for this feature - Aria Practices

📝 Test Instructions:

🧢 Your Project:

[rspbot]

Build successful! 🎉

• View the storybook
• View the S2 storybook
• View the documentation
• View the S2 docs

[rspbot]

Build successful! 🎉

• View the storybook
• View the S2 storybook
• View the documentation
• View the S2 docs

[rspbot]

## API Changes

react-aria-components

/react-aria-components:DateFieldState

 DateFieldState {
   calendar: Calendar
   clearSegment: (SegmentType) => void
   commitValidation: () => void
   confirmPlaceholder: () => void
   dateFormatter: DateFormatter
   dateValue: Date
   decrement: (SegmentType) => void
   decrementPage: (SegmentType) => void
   defaultValue: DateValue | null
   displayValidation: ValidationResult
   formatValue: (FieldOptions) => string
   getDateFormatter: (string, FormatterOptions) => DateFormatter
   granularity: Granularity
   increment: (SegmentType) => void
   incrementPage: (SegmentType) => void
+  incrementToMinMax: (SegmentType, number) => void
   isDisabled: boolean
   isInvalid: boolean
   isReadOnly: boolean
   isRequired: boolean
   maxGranularity: 'year' | 'month' | Granularity
   realtimeValidation: ValidationResult
   resetValidation: () => void
   segments: Array<DateSegment>
   setSegment: (SegmentType, number) => void
+  setShouldValidate: (boolean) => void
   setValue: (DateValue | null) => void
+  shouldValidate: boolean
   updateValidation: (ValidationResult) => void
   value: DateValue | null
 }

/react-aria-components:TimeFieldState

 TimeFieldState {
   calendar: Calendar
   clearSegment: (SegmentType) => void
   commitValidation: () => void
   confirmPlaceholder: () => void
   dateFormatter: DateFormatter
   dateValue: Date
   decrement: (SegmentType) => void
   decrementPage: (SegmentType) => void
   defaultValue: DateValue | null
   displayValidation: ValidationResult
   formatValue: (FieldOptions) => string
   getDateFormatter: (string, FormatterOptions) => DateFormatter
   granularity: Granularity
   increment: (SegmentType) => void
   incrementPage: (SegmentType) => void
+  incrementToMinMax: (SegmentType, number) => void
   isDisabled: boolean
   isInvalid: boolean
   isReadOnly: boolean
   isRequired: boolean
   maxGranularity: 'year' | 'month' | Granularity
   realtimeValidation: ValidationResult
   resetValidation: () => void
   segments: Array<DateSegment>
   setSegment: (SegmentType, number) => void
+  setShouldValidate: (boolean) => void
   setValue: (DateValue | null) => void
+  shouldValidate: boolean
   timeValue: Time
   updateValidation: (ValidationResult) => void
   value: DateValue | null
 }

---

@internationalized/date

/@internationalized/date:Calendar

 Calendar {
   fromJulianDay: (number) => CalendarDate
   getDaysInMonth: (AnyCalendarDate) => number
   getEras: () => Array<string>
   getFormattableMonth: (AnyCalendarDate) => CalendarDate
+  getMaxDays: () => number
   getMinimumDayInMonth: (AnyCalendarDate) => number
   getMinimumMonthInYear: (AnyCalendarDate) => number
   getMonthsInYear: (AnyCalendarDate) => number
   getYearsInEra: (AnyCalendarDate) => number
   isEqual: (Calendar) => boolean
   toJulianDay: (AnyCalendarDate) => number
 }

/@internationalized/date:CalendarDate

 CalendarDate {
   add: (DateDuration) => CalendarDate
   calendar: Calendar
   compare: (AnyCalendarDate) => number
   constructor: (Array<any>) => void
-  copy: () => CalendarDate
-  cycle: (DateField, number, CycleOptions) => CalendarDate
+  copy: (boolean) => CalendarDate
+  cycle: (DateField, number, CycleOptions, boolean) => CalendarDate
   day: number
   era: string
   month: number
-  set: (DateFields) => CalendarDate
+  set: (DateFields, boolean) => CalendarDate
   subtract: (DateDuration) => CalendarDate
   toDate: (string) => Date
   toString: () => string
   UNKNOWN: any
 }

/@internationalized/date:CalendarDateTime

 CalendarDateTime {
   add: (DateTimeDuration) => CalendarDateTime
   calendar: Calendar
   compare: (CalendarDate | CalendarDateTime | ZonedDateTime) => number
   constructor: (Array<any>) => void
-  copy: () => CalendarDateTime
-  cycle: (DateField | TimeField, number, CycleTimeOptions) => CalendarDateTime
+  copy: (boolean) => CalendarDateTime
+  cycle: (DateField | TimeField, number, CycleTimeOptions, boolean) => CalendarDateTime
   day: number
   era: string
   hour: number
   millisecond: number
   minute: number
   month: number
   second: number
-  set: ((DateFields & TimeFields)) => CalendarDateTime
+  set: ((DateFields & TimeFields), boolean) => CalendarDateTime
   subtract: (DateTimeDuration) => CalendarDateTime
   toDate: (string, Disambiguation) => Date
   toString: () => string
   UNKNOWN: any
 }

/@internationalized/date:Time

 Time {
   add: (TimeDuration) => Time
   compare: (AnyTime) => number
   constructor: (number, number, number, number) => void
   copy: () => Time
   cycle: (TimeField, number, CycleTimeOptions) => Time
   hour: number
   millisecond: number
   minute: number
   second: number
-  set: (TimeFields) => Time
+  set: (TimeFields, boolean) => Time
   subtract: (TimeDuration) => Time
   toString: () => string
   UNKNOWN: any
 }

/@internationalized/date:ZonedDateTime

 ZonedDateTime {
   add: (DateTimeDuration) => ZonedDateTime
   calendar: Calendar
   compare: (CalendarDate | CalendarDateTime | ZonedDateTime) => number
   constructor: (Array<any>) => void
-  copy: () => ZonedDateTime
-  cycle: (DateField | TimeField, number, CycleTimeOptions) => ZonedDateTime
+  copy: (boolean) => ZonedDateTime
+  cycle: (DateField | TimeField, number, CycleTimeOptions, boolean) => ZonedDateTime
   day: number
   era: string
   hour: number
   millisecond: number
   minute: number
   month: number
   offset: number
   second: number
-  set: ((DateFields & TimeFields), Disambiguation) => ZonedDateTime
+  set: ((DateFields & TimeFields), Disambiguation | boolean) => ZonedDateTime
   subtract: (DateTimeDuration) => ZonedDateTime
   timeZone: string
   toAbsoluteString: () => string
   toDate: () => Date
   UNKNOWN: any
   year: number
 }

/@internationalized/date:GregorianCalendar

 GregorianCalendar {
   balanceDate: (Mutable<AnyCalendarDate>) => void
   fromJulianDay: (number) => CalendarDate
   getDaysInMonth: (AnyCalendarDate) => number
   getDaysInYear: (AnyCalendarDate) => number
   getEras: () => Array<string>
+  getMaxDays: () => number
   getMonthsInYear: (AnyCalendarDate) => number
   getYearsInEra: (AnyCalendarDate) => number
   identifier: CalendarIdentifier
   isInverseEra: (AnyCalendarDate) => boolean
 }

/@internationalized/date:JapaneseCalendar

 JapaneseCalendar {
   balanceDate: (Mutable<AnyCalendarDate>) => void
   constrainDate: (Mutable<AnyCalendarDate>) => void
   fromJulianDay: (number) => CalendarDate
   getDaysInMonth: (AnyCalendarDate) => number
   getDaysInYear: (AnyCalendarDate) => number
   getEras: () => Array<string>
+  getMaxDays: () => number
   getMinimumDayInMonth: (AnyCalendarDate) => number
   getMinimumMonthInYear: (AnyCalendarDate) => number
   getMonthsInYear: (AnyCalendarDate) => number
   getYearsInEra: (AnyCalendarDate) => number
   isInverseEra: (AnyCalendarDate) => boolean
   toJulianDay: (AnyCalendarDate) => number
 }

/@internationalized/date:BuddhistCalendar

 BuddhistCalendar {
   balanceDate: () => void
   fromJulianDay: (number) => CalendarDate
   getDaysInMonth: (AnyCalendarDate) => number
   getDaysInYear: (AnyCalendarDate) => number
   getEras: () => Array<string>
+  getMaxDays: () => number
   getMonthsInYear: (AnyCalendarDate) => number
   getYearsInEra: (AnyCalendarDate) => number
   identifier: CalendarIdentifier
   isInverseEra: (AnyCalendarDate) => boolean
 }

/@internationalized/date:TaiwanCalendar

 TaiwanCalendar {
   balanceDate: (Mutable<AnyCalendarDate>) => void
   fromJulianDay: (number) => CalendarDate
   getDaysInMonth: (AnyCalendarDate) => number
   getDaysInYear: (AnyCalendarDate) => number
   getEras: () => Array<string>
+  getMaxDays: () => number
   getMonthsInYear: (AnyCalendarDate) => number
   getYearsInEra: (AnyCalendarDate) => number
   identifier: CalendarIdentifier
   isInverseEra: (AnyCalendarDate) => boolean
 }

/@internationalized/date:PersianCalendar

 PersianCalendar {
   fromJulianDay: (number) => CalendarDate
   getDaysInMonth: (AnyCalendarDate) => number
   getEras: () => Array<string>
+  getMaxDays: () => number
   getMonthsInYear: () => number
   getYearsInEra: () => number
   identifier: CalendarIdentifier
   toJulianDay: (AnyCalendarDate) => number

/@internationalized/date:IndianCalendar

 IndianCalendar {
   balanceDate: () => void
   fromJulianDay: (number) => CalendarDate
   getDaysInMonth: (AnyCalendarDate) => number
   getDaysInYear: (AnyCalendarDate) => number
   getEras: () => Array<string>
+  getMaxDays: () => number
   getMonthsInYear: (AnyCalendarDate) => number
   getYearsInEra: () => number
   identifier: CalendarIdentifier
   isInverseEra: (AnyCalendarDate) => boolean
 }

/@internationalized/date:IslamicCivilCalendar

 IslamicCivilCalendar {
   fromJulianDay: (number) => CalendarDate
   getDaysInMonth: (AnyCalendarDate) => number
   getDaysInYear: (AnyCalendarDate) => number
   getEras: () => Array<string>
+  getMaxDays: () => number
   getMonthsInYear: () => number
   getYearsInEra: () => number
   identifier: CalendarIdentifier
   toJulianDay: (AnyCalendarDate) => number

/@internationalized/date:IslamicTabularCalendar

 IslamicTabularCalendar {
   fromJulianDay: (number) => CalendarDate
   getDaysInMonth: (AnyCalendarDate) => number
   getDaysInYear: (AnyCalendarDate) => number
   getEras: () => Array<string>
+  getMaxDays: () => number
   getMonthsInYear: () => number
   getYearsInEra: () => number
   identifier: CalendarIdentifier
   toJulianDay: (AnyCalendarDate) => number

/@internationalized/date:IslamicUmalquraCalendar

 IslamicUmalquraCalendar {
   constructor: () => void
   fromJulianDay: (number) => CalendarDate
   getDaysInMonth: (AnyCalendarDate) => number
   getDaysInYear: (AnyCalendarDate) => number
   getEras: () => Array<string>
+  getMaxDays: () => number
   getMonthsInYear: () => number
   getYearsInEra: () => number
   identifier: CalendarIdentifier
   toJulianDay: (AnyCalendarDate) => number

/@internationalized/date:HebrewCalendar

 HebrewCalendar {
   balanceYearMonth: (Mutable<AnyCalendarDate>, AnyCalendarDate) => void
   fromJulianDay: (number) => CalendarDate
   getDaysInMonth: (AnyCalendarDate) => number
   getDaysInYear: (AnyCalendarDate) => number
   getEras: () => Array<string>
+  getMaxDays: () => number
   getMonthsInYear: (AnyCalendarDate) => number
   getYearsInEra: () => number
   identifier: CalendarIdentifier
   toJulianDay: (AnyCalendarDate) => number

/@internationalized/date:EthiopicCalendar

 EthiopicCalendar {
   fromJulianDay: (number) => CalendarDate
   getDaysInMonth: (AnyCalendarDate) => number
   getDaysInYear: (AnyCalendarDate) => number
   getEras: () => Array<string>
+  getMaxDays: () => number
   getMonthsInYear: () => number
   getYearsInEra: (AnyCalendarDate) => number
   identifier: CalendarIdentifier
   toJulianDay: (AnyCalendarDate) => number

/@internationalized/date:EthiopicAmeteAlemCalendar

 EthiopicAmeteAlemCalendar {
   fromJulianDay: (number) => CalendarDate
   getDaysInMonth: (AnyCalendarDate) => number
   getDaysInYear: (AnyCalendarDate) => number
   getEras: () => Array<string>
+  getMaxDays: () => number
   getMonthsInYear: () => number
   getYearsInEra: () => number
   identifier: CalendarIdentifier
   toJulianDay: (AnyCalendarDate) => number

/@internationalized/date:CopticCalendar

 CopticCalendar {
   balanceDate: (Mutable<AnyCalendarDate>) => void
   fromJulianDay: (number) => CalendarDate
   getDaysInMonth: (AnyCalendarDate) => number
   getDaysInYear: (AnyCalendarDate) => number
   getEras: () => Array<string>
+  getMaxDays: () => number
   getMonthsInYear: () => number
   getYearsInEra: (AnyCalendarDate) => number
   identifier: CalendarIdentifier
   isInverseEra: (AnyCalendarDate) => boolean
 }

/@internationalized/date:toCalendar

 toCalendar <T extends AnyCalendarDate> {
   date: T
   calendar: Calendar
+  constrainDay?: boolean
   returnVal: undefined
 }

---

@react-stately/datepicker

/@react-stately/datepicker:DateFieldState

 DateFieldState {
   calendar: Calendar
   clearSegment: (SegmentType) => void
   commitValidation: () => void
   confirmPlaceholder: () => void
   dateFormatter: DateFormatter
   dateValue: Date
   decrement: (SegmentType) => void
   decrementPage: (SegmentType) => void
   defaultValue: DateValue | null
   displayValidation: ValidationResult
   formatValue: (FieldOptions) => string
   getDateFormatter: (string, FormatterOptions) => DateFormatter
   granularity: Granularity
   increment: (SegmentType) => void
   incrementPage: (SegmentType) => void
+  incrementToMinMax: (SegmentType, number) => void
   isDisabled: boolean
   isInvalid: boolean
   isReadOnly: boolean
   isRequired: boolean
   maxGranularity: 'year' | 'month' | Granularity
   realtimeValidation: ValidationResult
   resetValidation: () => void
   segments: Array<DateSegment>
   setSegment: (SegmentType, number) => void
+  setShouldValidate: (boolean) => void
   setValue: (DateValue | null) => void
+  shouldValidate: boolean
   updateValidation: (ValidationResult) => void
   value: DateValue | null
 }

/@react-stately/datepicker:TimeFieldState

 TimeFieldState {
   calendar: Calendar
   clearSegment: (SegmentType) => void
   commitValidation: () => void
   confirmPlaceholder: () => void
   dateFormatter: DateFormatter
   dateValue: Date
   decrement: (SegmentType) => void
   decrementPage: (SegmentType) => void
   defaultValue: DateValue | null
   displayValidation: ValidationResult
   formatValue: (FieldOptions) => string
   getDateFormatter: (string, FormatterOptions) => DateFormatter
   granularity: Granularity
   increment: (SegmentType) => void
   incrementPage: (SegmentType) => void
+  incrementToMinMax: (SegmentType, number) => void
   isDisabled: boolean
   isInvalid: boolean
   isReadOnly: boolean
   isRequired: boolean
   maxGranularity: 'year' | 'month' | Granularity
   realtimeValidation: ValidationResult
   resetValidation: () => void
   segments: Array<DateSegment>
   setSegment: (SegmentType, number) => void
+  setShouldValidate: (boolean) => void
   setValue: (DateValue | null) => void
+  shouldValidate: boolean
   timeValue: Time
   updateValidation: (ValidationResult) => void
   value: DateValue | null
 }

---