@react-stately/datepicker 3.16.0 → 3.17.0

package/src/IncompleteDate.ts

@@ -1,392 +0,0 @@
-/*
- * Copyright 2026 Adobe. All rights reserved.
- * This file is licensed to you under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License. You may obtain a copy
- * of the License at http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software distributed under
- * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
- * OF ANY KIND, either express or implied. See the License for the specific language
- * governing permissions and limitations under the License.
- */
-
-import {AnyDateTime, Calendar, CalendarDate, ZonedDateTime} from '@internationalized/date';
-import {DateValue} from '@react-types/datepicker';
-import {SegmentType} from './useDateFieldState';
-
-type HourCycle = 'h12' | 'h11' | 'h23' | 'h24';
-
-/**
- * This class represents a date that is incomplete or otherwise invalid as a result of user editing.
- * For example, it can represent temporary dates such as February 31st if the user edits the day before the month.
- * Times are represented according to an hour cycle rather than always in 24 hour time. This enables the user to adjust
- * the day period (e.g. am/pm) independently from the hour.
- */
-export class IncompleteDate {
-  calendar: Calendar;
-  era: string | null;
-  year: number | null;
-  month: number | null;
-  day: number | null;
-  hour: number | null;
-  hourCycle: HourCycle;
-  dayPeriod: number | null;
-  minute: number | null;
-  second: number | null;
-  millisecond: number | null;
-  offset: number | null;
-
-  constructor(calendar: Calendar, hourCycle: HourCycle, dateValue?: Partial<Omit<AnyDateTime, 'copy'>> | null) {
-    this.era = dateValue?.era ?? null;
-    this.calendar = calendar;
-    this.year = dateValue?.year ?? null;
-    this.month = dateValue?.month ?? null;
-    this.day = dateValue?.day ?? null;
-    this.hour = dateValue?.hour ?? null;
-    this.hourCycle = hourCycle;
-    this.dayPeriod = null;
-    this.minute = dateValue?.minute ?? null;
-    this.second = dateValue?.second ?? null;
-    this.millisecond = dateValue?.millisecond ?? null;
-    this.offset = 'offset' in (dateValue ?? {}) ? (dateValue as any).offset : null;
-
-    // Convert the hour from 24 hour time to the given hour cycle.
-    if (this.hour != null) {
-      let [dayPeriod, hour] = toHourCycle(this.hour, hourCycle);
-      this.dayPeriod = dayPeriod;
-      this.hour = hour;
-    }
-  }
-
-  copy(): IncompleteDate {
-    let res = new IncompleteDate(this.calendar, this.hourCycle);
-    res.era = this.era;
-    res.year = this.year;
-    res.month = this.month;
-    res.day = this.day;
-    res.hour = this.hour;
-    res.dayPeriod = this.dayPeriod;
-    res.minute = this.minute;
-    res.second = this.second;
-    res.millisecond = this.millisecond;
-    res.offset = this.offset;
-    return res;
-  }
-
-  /** Checks whether all the specified segments have a value. */
-  isComplete(segments: SegmentType[]) {
-    return segments.every(segment => this[segment] != null);
-  }
-
-  /** Checks whether the given date value matches this value for the specified segments. */
-  validate(dt: DateValue, segments: SegmentType[]) {
-    return segments.every(segment => {
-      if ((segment === 'hour' || segment === 'dayPeriod') && 'hour' in dt) {
-        let [dayPeriod, hour] = toHourCycle(dt.hour, this.hourCycle);
-        return this.dayPeriod === dayPeriod && this.hour === hour;
-      }
-      return this[segment] === dt[segment];
-    });
-  }
-
-  /** Checks if the date is empty (i.e. all specified segments are null). */
-  isCleared(segments: SegmentType[]): boolean {
-    return segments.every(segment => this[segment] === null);
-  }
-
-  /** Sets the given field. */
-  set(field: SegmentType, value: number | string, placeholder: DateValue): IncompleteDate {
-    let result = this.copy();
-    result[field] = value;
-    if (field === 'hour' && result.dayPeriod == null && 'hour' in placeholder) {
-      result.dayPeriod = toHourCycle(placeholder.hour, this.hourCycle)[0];
-    }
-    if (field === 'year' && result.era == null) {
-      result.era = placeholder.era;
-    }
-
-    // clear offset when a date/time field changes since it may no longer be valid
-    if (field !== 'second' && field !== 'literal' && field !== 'timeZoneName') {
-      result.offset = null;
-    }
-    return result;
-  }
-
-  /** Sets the given field to null. */
-  clear(field: SegmentType): IncompleteDate {
-    let result = this.copy();
-    // @ts-ignore
-    result[field] = null;
-    if (field === 'year') {
-      result.era = null;
-    }
-
-    // clear offset when a field is cleared since it may no longer be valid
-    result.offset = null;
-    return result;
-  }
-
-  /** Increments or decrements the given field. If it is null, then it is set to the placeholder value. */
-  cycle(field: SegmentType, amount: number, placeholder: DateValue, displaySegments: SegmentType[]): IncompleteDate {
-    let res = this.copy();
-
-    // If field is null, default to placeholder.
-    if (res[field] == null && field !== 'dayPeriod' && field !== 'era') {
-      if (field === 'hour' && 'hour' in placeholder) {
-        let [dayPeriod, hour] = toHourCycle(placeholder.hour, this.hourCycle);
-        res.dayPeriod = dayPeriod;
-        res.hour = hour;
-      } else {
-        res[field] = placeholder[field];
-      }
-      if (field === 'year' && res.era == null) {
-        res.era = placeholder.era;
-      }
-
-      return res;
-    }
-
-    switch (field) {
-      case 'era': {
-        let eras = this.calendar.getEras();
-        let index = eras.indexOf(res.era!);
-        index = cycleValue(index, amount, 0, eras.length - 1);
-        res.era = eras[index];
-        break;
-      }
-      case 'year': {
-        // Use CalendarDate to cycle so that we update the era when going between 1 AD and 1 BC.
-        let date = new CalendarDate(this.calendar, this.era ?? placeholder.era, this.year ?? placeholder.year, this.month ?? 1, this.day ?? 1);
-        date = date.cycle(field, amount, {round: field === 'year'});
-        res.era = date.era;
-        res.year = date.year;
-        break;
-      }
-      case 'month':
-        res.month = cycleValue(res.month ?? 1, amount, 1, this.calendar.getMaximumMonthsInYear());
-        break;
-      case 'day':
-        // Allow incrementing up to the maximum number of days in any month.
-        res.day = cycleValue(res.day ?? 1, amount, 1, this.calendar.getMaximumDaysInMonth());
-        break;
-      case 'hour': {
-        // if date is fully defined or it is just a time field, and we have a time zone, use toValue to get a ZonedDateTime to cycle
-        // so DST fallback is properly handled
-        let hasDateSegements = displaySegments.some(s => ['year', 'month', 'day'].includes(s));
-        if ('timeZone' in placeholder && (!hasDateSegements || (res.year != null && res.month != null && res.day != null))) {
-          let date = this.toValue(placeholder) as ZonedDateTime;
-          date = date.cycle('hour', amount, {hourCycle: this.hourCycle === 'h12' ? 12 : 24, round: false});
-          let [dayPeriod, adjustedHour] = toHourCycle(date.hour, this.hourCycle);
-          res.hour = adjustedHour;
-          res.dayPeriod = dayPeriod;
-          res.offset = date.offset;
-        } else {
-          let hours = res.hour ?? 0;
-          let limits = this.getSegmentLimits('hour')!;
-          res.hour = cycleValue(hours, amount, limits.minValue, limits.maxValue);
-          if (res.dayPeriod == null && 'hour' in placeholder) {
-            res.dayPeriod = toHourCycle(placeholder.hour, this.hourCycle)[0];
-          }
-        }
-        break;
-      }
-      case 'dayPeriod':
-        res.dayPeriod = cycleValue(res.dayPeriod ?? 0, amount, 0, 1);
-        break;
-      case 'minute':
-        res.minute = cycleValue(res.minute ?? 0, amount, 0, 59, true);
-        break;
-      case 'second':
-        res.second = cycleValue(res.second ?? 0, amount, 0, 59, true);
-        break;
-    }
-
-    return res;
-  }
-
-  /** Converts the incomplete date to a full date value, using the provided value for any unset fields. */
-  toValue(value: DateValue): DateValue {
-    if ('hour' in value) {
-      let hour = this.hour;
-      if (hour != null) {
-        hour = fromHourCycle(hour, this.dayPeriod ?? 0, this.hourCycle);
-      } else if (this.hourCycle === 'h12' || this.hourCycle === 'h11') {
-        hour = this.dayPeriod === 1 ? 12 : 0;
-      }
-
-      let res = value.set({
-        era: this.era ?? value.era,
-        year: this.year ?? value.year,
-        month: this.month ?? value.month,
-        day: this.day ?? value.day,
-        hour: hour ?? value.hour,
-        minute: this.minute ?? value.minute,
-        second: this.second ?? value.second,
-        millisecond: this.millisecond ?? value.millisecond
-      });
-
-      if ('offset' in res && this.offset != null && res.offset !== this.offset) {
-        res = res.add({milliseconds: res.offset - this.offset});
-      }
-
-      return res;
-    } else {
-      return value.set({
-        era: this.era ?? value.era,
-        year: this.year ?? value.year,
-        month: this.month ?? value.month,
-        day: this.day ?? value.day
-      });
-    }
-  }
-
-  getSegmentLimits(type: string): {value: number | null, minValue: number, maxValue: number} | undefined {
-    switch (type) {
-      case 'era': {
-        let eras = this.calendar.getEras();
-        return {
-          value: this.era != null ? eras.indexOf(this.era) : eras.length - 1,
-          minValue: 0,
-          maxValue: eras.length - 1
-        };
-      }
-      case 'year':
-        return {
-          value: this.year,
-          minValue: 1,
-          maxValue: 9999
-        };
-      case 'month':
-        return {
-          value: this.month,
-          minValue: 1,
-          maxValue: this.calendar.getMaximumMonthsInYear()
-        };
-      case 'day':
-        return {
-          value: this.day,
-          minValue: 1,
-          maxValue: this.calendar.getMaximumDaysInMonth()
-        };
-      case 'dayPeriod': {
-        return {
-          value: this.dayPeriod,
-          minValue: 0,
-          maxValue: 1
-        };
-      }
-      case 'hour': {
-        let minValue = 0;
-        let maxValue = 23;
-        if (this.hourCycle === 'h12') {
-          minValue = 1;
-          maxValue = 12;
-        } else if (this.hourCycle === 'h11') {
-          minValue = 0;
-          maxValue = 11;
-        }
-
-        return {
-          value: this.hour,
-          minValue,
-          maxValue
-        };
-      }
-      case 'minute':
-        return {
-          value: this.minute,
-          minValue: 0,
-          maxValue: 59
-        };
-      case 'second':
-        return {
-          value: this.second,
-          minValue: 0,
-          maxValue: 59
-        };
-    }
-  }
-}
-
-function cycleValue(value: number, amount: number, min: number, max: number, round = false) {
-  if (round) {
-    value += Math.sign(amount);
-
-    if (value < min) {
-      value = max;
-    }
-
-    let div = Math.abs(amount);
-    if (amount > 0) {
-      value = Math.ceil(value / div) * div;
-    } else {
-      value = Math.floor(value / div) * div;
-    }
-
-    if (value > max) {
-      value = min;
-    }
-  } else {
-    value += amount;
-    if (value < min) {
-      value = max - (min - value - 1);
-    } else if (value > max) {
-      value = min + (value - max - 1);
-    }
-  }
-
-  return value;
-}
-
-function toHourCycle(hour: number, hourCycle: HourCycle): [number | null, number] {
-  let dayPeriod: number | null = hour >= 12 ? 1 : 0;
-  switch (hourCycle) {
-    case 'h11':
-      // Hours are numbered from 0 to 11. Used in Japan.
-      if (hour >= 12) {
-        hour -= 12;
-      }
-      break;
-    case 'h12':
-      // Hours are numbered from 12 (representing 0) to 11.
-      if (hour === 0) {
-        hour = 12;
-      } else if (hour > 12) {
-        hour -= 12;
-      }
-      break;
-    case 'h23':
-      // 24 hour time, numbered 0 to 23.
-      dayPeriod = null;
-      break;
-    case 'h24':
-      // 24 hour time numbered 24 to 23. Unused but supported by Intl.DateTimeFormat.
-      hour += 1;
-      dayPeriod = null;
-  }
-
-  return [dayPeriod, hour];
-}
-
-function fromHourCycle(hour: number, dayPeriod: number, hourCycle: HourCycle): number {
-  switch (hourCycle) {
-    case 'h11':
-      if (dayPeriod === 1) {
-        hour += 12;
-      }
-      break;
-    case 'h12':
-      if (hour === 12) {
-        hour = 0;
-      }
-      if (dayPeriod === 1) {
-        hour += 12;
-      }
-      break;
-    case 'h24':
-      hour -= 1;
-      break;
-  }
-
-  return hour;
-}

package/src/placeholders.ts

@@ -1,109 +0,0 @@
-/*
- * Copyright 2020 Adobe. All rights reserved.
- * This file is licensed to you under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License. You may obtain a copy
- * of the License at http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software distributed under
- * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
- * OF ANY KIND, either express or implied. See the License for the specific language
- * governing permissions and limitations under the License.
- */
-
-import {LocalizedStringDictionary} from '@internationalized/string';
-
-// These placeholders are based on the strings used by the <input type="date">
-// implementations in Chrome and Firefox. Additional languages are supported
-// here than React Spectrum's typical translations.
-const placeholders = new LocalizedStringDictionary({
-  ach: {year: 'mwaka', month: 'dwe', day: 'nino'},
-  af: {year: 'jjjj', month: 'mm', day: 'dd'},
-  am: {year: 'ዓዓዓዓ', month: 'ሚሜ', day: 'ቀቀ'},
-  an: {year: 'aaaa', month: 'mm', day: 'dd'},
-  ar: {year: 'سنة', month: 'شهر', day: 'يوم'},
-  ast: {year: 'aaaa', month: 'mm', day: 'dd'},
-  az: {year: 'iiii', month: 'aa', day: 'gg'},
-  be: {year: 'гггг', month: 'мм', day: 'дд'},
-  bg: {year: 'гггг', month: 'мм', day: 'дд'},
-  bn: {year: 'yyyy', month: 'মিমি', day: 'dd'},
-  br: {year: 'bbbb', month: 'mm', day: 'dd'},
-  bs: {year: 'gggg', month: 'mm', day: 'dd'},
-  ca: {year: 'aaaa', month: 'mm', day: 'dd'},
-  cak: {year: 'jjjj', month: 'ii', day: "q'q'"},
-  ckb: {year: 'ساڵ', month: 'مانگ', day: 'ڕۆژ'},
-  cs: {year: 'rrrr', month: 'mm', day: 'dd'},
-  cy: {year: 'bbbb', month: 'mm', day: 'dd'},
-  da: {year: 'åååå', month: 'mm', day: 'dd'},
-  de: {year: 'jjjj', month: 'mm', day: 'tt'},
-  dsb: {year: 'llll', month: 'mm', day: 'źź'},
-  el: {year: 'εεεε', month: 'μμ', day: 'ηη'},
-  en: {year: 'yyyy', month: 'mm', day: 'dd'},
-  eo: {year: 'jjjj', month: 'mm', day: 'tt'},
-  es: {year: 'aaaa', month: 'mm', day: 'dd'},
-  et: {year: 'aaaa', month: 'kk', day: 'pp'},
-  eu: {year: 'uuuu', month: 'hh', day: 'ee'},
-  fa: {year: 'سال', month: 'ماه', day: 'روز'},
-  ff: {year: 'hhhh', month: 'll', day: 'ññ'},
-  fi: {year: 'vvvv', month: 'kk', day: 'pp'},
-  fr: {year: 'aaaa', month: 'mm', day: 'jj'},
-  fy: {year: 'jjjj', month: 'mm', day: 'dd'},
-  ga: {year: 'bbbb', month: 'mm', day: 'll'},
-  gd: {year: 'bbbb', month: 'mm', day: 'll'},
-  gl: {year: 'aaaa', month: 'mm', day: 'dd'},
-  he: {year: 'שנה', month: 'חודש', day: 'יום'},
-  hr: {year: 'gggg', month: 'mm', day: 'dd'},
-  hsb: {year: 'llll', month: 'mm', day: 'dd'},
-  hu: {year: 'éééé', month: 'hh', day: 'nn'},
-  ia: {year: 'aaaa', month: 'mm', day: 'dd'},
-  id: {year: 'tttt', month: 'bb', day: 'hh'},
-  it: {year: 'aaaa', month: 'mm', day: 'gg'},
-  ja: {year: '年', month: '月', day: '日'},
-  ka: {year: 'წწწწ', month: 'თთ', day: 'რრ'},
-  kk: {year: 'жжжж', month: 'аа', day: 'кк'},
-  kn: {year: 'ವವವವ', month: 'ಮಿಮೀ', day: 'ದಿದಿ'},
-  ko: {year: '연도', month: '월', day: '일'},
-  lb: {year: 'jjjj', month: 'mm', day: 'dd'},
-  lo: {year: 'ປປປປ', month: 'ດດ', day: 'ວວ'},
-  lt: {year: 'mmmm', month: 'mm', day: 'dd'},
-  lv: {year: 'gggg', month: 'mm', day: 'dd'},
-  meh: {year: 'aaaa', month: 'mm', day: 'dd'},
-  ml: {year: 'വർഷം', month: 'മാസം', day: 'തീയതി'},
-  ms: {year: 'tttt', month: 'mm', day: 'hh'},
-  nb: {year: 'åååå', month: 'mm', day: 'dd'},
-  nl: {year: 'jjjj', month: 'mm', day: 'dd'},
-  nn: {year: 'åååå', month: 'mm', day: 'dd'},
-  no: {year: 'åååå', month: 'mm', day: 'dd'},
-  oc: {year: 'aaaa', month: 'mm', day: 'jj'},
-  pl: {year: 'rrrr', month: 'mm', day: 'dd'},
-  pt: {year: 'aaaa', month: 'mm', day: 'dd'},
-  rm: {year: 'oooo', month: 'mm', day: 'dd'},
-  ro: {year: 'aaaa', month: 'll', day: 'zz'},
-  ru: {year: 'гггг', month: 'мм', day: 'дд'},
-  sc: {year: 'aaaa', month: 'mm', day: 'dd'},
-  scn: {year: 'aaaa', month: 'mm', day: 'jj'},
-  sk: {year: 'rrrr', month: 'mm', day: 'dd'},
-  sl: {year: 'llll', month: 'mm', day: 'dd'},
-  sr: {year: 'гггг', month: 'мм', day: 'дд'},
-  sv: {year: 'åååå', month: 'mm', day: 'dd'},
-  szl: {year: 'rrrr', month: 'mm', day: 'dd'},
-  tg: {year: 'сссс', month: 'мм', day: 'рр'},
-  th: {year: 'ปปปป', month: 'ดด', day: 'วว'},
-  tr: {year: 'yyyy', month: 'aa', day: 'gg'},
-  uk: {year: 'рррр', month: 'мм', day: 'дд'},
-  'zh-CN': {year: '年', month: '月', day: '日'},
-  'zh-TW': {year: '年', month: '月', day: '日'}
-}, 'en');
-
-export function getPlaceholder(field: string, value: string, locale: string): string {
-  // Use the actual placeholder value for the era and day period fields.
-  if (field === 'era' || field === 'dayPeriod') {
-    return value;
-  }
-
-  if (field === 'year' || field === 'month' || field === 'day') {
-    return placeholders.getStringForLocale(field, locale);
-  }
-
-  // For time fields (e.g. hour, minute, etc.), use two dashes as the placeholder.
-  return '––';
-}