@samline/date 2.1.2 → 2.2.0

package/dist/index.js

@@ -50,6 +50,9 @@ var resolveLocale = (locale) => {
   }
   return asSupportedLocale(baseLocale);
 };
+var isLocaleLoaded = (locale) => {
+  return loadedLocales.has(locale);
+};
 var ensureLocaleLoaded = async (locale) => {
   if (loadedLocales.has(locale)) {
     return;
@@ -76,7 +79,13 @@ var createResolvedConfig = (locale, config) => ({
   invalid: config?.invalid ?? DEFAULT_INVALID_DATE
 });
 var getInvalidDateText = (config, props) => {
-  return props?.invalid ?? config?.invalid ?? DEFAULT_INVALID_DATE;
+  if (typeof props === "object" && props !== null && "invalid" in props) {
+    const invalid = props.invalid;
+    if (invalid !== void 0) {
+      return invalid;
+    }
+  }
+  return config?.invalid ?? DEFAULT_INVALID_DATE;
 };
 var getTargetLocale = (currentLocale, props) => {
   if (!props?.locale) {
@@ -102,29 +111,193 @@ var parseDateValue = (value, input, locale, strict) => {
   }
   return dayjs(value, [...input], locale, strict).locale(locale);
 };
+var getCurrentDayjs = (locale) => {
+  return dayjs().locale(locale);
+};
+var createParseSuccess = (parsed, locale) => {
+  return {
+    isValid: true,
+    locale,
+    date: parsed.toDate(),
+    iso: parsed.toISOString(),
+    timestamp: parsed.valueOf(),
+    format: (output = DEFAULT_FORMAT) => parsed.format(output)
+  };
+};
+var createParseFailure = (locale, error) => {
+  return {
+    isValid: false,
+    locale,
+    date: null,
+    iso: null,
+    timestamp: null,
+    error
+  };
+};
+var createDateChainSuccessState = (parsed, locale) => {
+  return {
+    isValid: true,
+    locale,
+    date: parsed.toDate(),
+    iso: parsed.toISOString(),
+    timestamp: parsed.valueOf()
+  };
+};
+var createDateChainFailureState = (locale, error) => {
+  return {
+    isValid: false,
+    locale,
+    date: null,
+    iso: null,
+    timestamp: null,
+    error
+  };
+};
+var mapChainSetUnit = (unit) => {
+  if (unit === "day") {
+    return "date";
+  }
+  return unit;
+};
+var createReadyError = () => {
+  return new Error("Date chain is not ready. Await chain.ready before using it with locales that may need to load.");
+};
+var assertDateChainReady = (state) => {
+  if (!state.ready) {
+    throw createReadyError();
+  }
+};
+var getComparableDayjs = (value) => {
+  if (typeof value === "object" && value !== null && "toState" in value) {
+    const state = value.toState();
+    if (!state.isValid) {
+      return null;
+    }
+    return dayjs(state.date);
+  }
+  const comparable = dayjs(value);
+  if (!comparable.isValid()) {
+    return null;
+  }
+  return comparable;
+};
+var createDateChainApi = (state, ready) => {
+  const applyMutation = (transform) => {
+    assertDateChainReady(state);
+    if (state.current) {
+      state.current = transform(state.current);
+    }
+    return chain;
+  };
+  const compare = (other, comparator) => {
+    assertDateChainReady(state);
+    if (!state.current) {
+      return false;
+    }
+    const comparable = getComparableDayjs(other);
+    if (!comparable) {
+      return false;
+    }
+    return comparator(state.current, comparable);
+  };
+  const chain = {
+    ready,
+    add: (value, unit) => applyMutation((current) => current.add(value, unit)),
+    subtract: (value, unit) => applyMutation((current) => current.subtract(value, unit)),
+    set: (unit, value) => applyMutation((current) => current.set(mapChainSetUnit(unit), value)),
+    startOf: (unit) => applyMutation((current) => current.startOf(unit)),
+    endOf: (unit) => applyMutation((current) => current.endOf(unit)),
+    format: (output = DEFAULT_FORMAT) => {
+      assertDateChainReady(state);
+      if (!state.current) {
+        return state.invalid;
+      }
+      return state.current.format(output);
+    },
+    toDate: () => {
+      assertDateChainReady(state);
+      return state.current ? state.current.toDate() : null;
+    },
+    toISOString: () => {
+      assertDateChainReady(state);
+      return state.current ? state.current.toISOString() : null;
+    },
+    toTimestamp: () => {
+      assertDateChainReady(state);
+      return state.current ? state.current.valueOf() : null;
+    },
+    isValid: () => {
+      assertDateChainReady(state);
+      return state.current !== null;
+    },
+    isBefore: (other, unit) => compare(other, (current, comparable) => current.isBefore(comparable, unit)),
+    isAfter: (other, unit) => compare(other, (current, comparable) => current.isAfter(comparable, unit)),
+    isSame: (other, unit) => compare(other, (current, comparable) => current.isSame(comparable, unit)),
+    toState: () => {
+      assertDateChainReady(state);
+      if (!state.current) {
+        return createDateChainFailureState(state.locale, state.error ?? state.invalid);
+      }
+      return createDateChainSuccessState(state.current, state.locale);
+    }
+  };
+  return chain;
+};
+var createDateChainState = (locale, invalid, getInitialDate) => {
+  const state = {
+    locale,
+    invalid,
+    current: null,
+    ready: false,
+    error: invalid
+  };
+  const initialize = () => {
+    const parsed = getInitialDate();
+    state.ready = true;
+    if (!parsed.isValid()) {
+      state.current = null;
+      state.error = invalid;
+      return;
+    }
+    state.current = parsed;
+    state.error = null;
+  };
+  if (isLocaleLoaded(locale)) {
+    initialize();
+    return {
+      state,
+      ready: Promise.resolve()
+    };
+  }
+  return {
+    state,
+    ready: ensureLocaleLoaded(locale).then(() => {
+      initialize();
+    })
+  };
+};
+var createDateChainFromResolvedConfig = (props, config) => {
+  const locale = getTargetLocale(config.locale, props);
+  const invalid = getInvalidDateText(config, props);
+  const strict = props?.strict ?? config.strict;
+  const getInitialDate = () => {
+    if (props?.date === void 0) {
+      return getCurrentDayjs(locale);
+    }
+    return parseDateValue(props.date, props.input, locale, strict);
+  };
+  const { state, ready } = createDateChainState(locale, invalid, getInitialDate);
+  return createDateChainApi(state, ready);
+};
 var createFormatterParseDate = (getConfig) => {
   return (props) => {
     const config = getConfig();
     const locale = getTargetLocale(config.locale, props);
     const parsed = parseDateValue(props.date, props.input, locale, props.strict ?? config.strict);
     if (!parsed.isValid()) {
-      return {
-        isValid: false,
-        locale,
-        date: null,
-        iso: null,
-        timestamp: null,
-        error: getInvalidDateText(config, props)
-      };
+      return createParseFailure(locale, getInvalidDateText(config, props));
     }
-    return {
-      isValid: true,
-      locale,
-      date: parsed.toDate(),
-      iso: parsed.toISOString(),
-      timestamp: parsed.valueOf(),
-      format: (output = DEFAULT_FORMAT) => parsed.format(output)
-    };
+    return createParseSuccess(parsed, locale);
   };
 };
 var createFormatterIsValidDate = (parseDate2) => {
@@ -137,10 +310,10 @@ var createFormatterGetDate = (getConfig) => {
     const locale = getTargetLocale(config.locale, props);
     const output = props?.output ?? DEFAULT_FORMAT;
     if (!props) {
-      return dayjs().locale(locale).format(DEFAULT_FORMAT);
+      return getCurrentDayjs(locale).format(DEFAULT_FORMAT);
     }
     if (props.date === void 0) {
-      return dayjs().locale(locale).format(output);
+      return getCurrentDayjs(locale).format(output);
     }
     const parsed = parseDate2({
       date: props.date,
@@ -154,6 +327,11 @@ var createFormatterGetDate = (getConfig) => {
     return parsed.format(output);
   };
 };
+var createFormatterCreateDateChain = (getConfig) => {
+  return (props) => {
+    return createDateChainFromResolvedConfig(props, getConfig());
+  };
+};
 function resolveLocaleOrThrow(locale) {
   const resolvedLocale = resolveLocale(locale);
   if (!resolvedLocale) {
@@ -164,6 +342,10 @@ function resolveLocaleOrThrow(locale) {
   return resolvedLocale;
 }
 var getSupportedLocales = () => SUPPORTED_LOCALES;
+var createDateChain = (props, config) => {
+  const locale = getHelperLocale(config, props);
+  return createDateChainFromResolvedConfig(props, createResolvedConfig(locale, config));
+};
 var getDate = async (props, config) => {
   const locale = getHelperLocale(config, props);
   const formatter = createDateFormatter({ ...config, locale });
@@ -191,6 +373,7 @@ var createDateFormatter = (config) => {
     getDate: createFormatterGetDate(getConfig),
     parseDate: parseDate2,
     isValidDate: createFormatterIsValidDate(parseDate2),
+    createDateChain: createFormatterCreateDateChain(getConfig),
     getSupportedLocales,
     getCurrentLocale: () => currentLocale,
     setLocale: async (locale) => {
@@ -203,6 +386,7 @@ var createDateFormatter = (config) => {
 };
 export {
   SUPPORTED_LOCALES,
+  createDateChain,
   createDateFormatter,
   getDate,
   getSupportedLocales,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/date.ts","../src/core/locales.ts"],"sourcesContent":["import customParseFormat from 'dayjs/plugin/customParseFormat.js'\nimport dayjs from 'dayjs'\nimport type { Dayjs } from 'dayjs'\n\nimport { ensureLocaleLoaded, resolveLocale, SUPPORTED_LOCALES, type LocaleInput, type SupportedLocale } from './locales.js'\n\ndayjs.extend(customParseFormat)\ndayjs.locale('en')\n\nexport type DateValue = string | number | Date\n\ntype DateInputOptions = {\n  input?: string | readonly string[]\n  locale?: LocaleInput\n  strict?: boolean\n}\n\nexport type DateParsingOptions = DateInputOptions & {\n  date: DateValue\n}\n\nexport type GetDateOptions = DateInputOptions & {\n  date?: DateValue\n  output?: string\n  invalid?: string\n}\n\nexport type DateFormatterConfig = {\n  locale?: LocaleInput\n  strict?: boolean\n  invalid?: string\n}\n\ntype ResolvedDateFormatterConfig = {\n  locale: SupportedLocale\n  strict: boolean\n  invalid: string\n}\n\nexport type DateFormatter = {\n  getDate: (props?: GetDateOptions) => string\n  parseDate: (props: DateParsingOptions) => ParseDateResult\n  isValidDate: (props: DateParsingOptions) => boolean\n  getSupportedLocales: () => readonly SupportedLocale[]\n  getCurrentLocale: () => SupportedLocale\n  setLocale: (locale: LocaleInput) => Promise<void>\n  ready: Promise<void>\n}\n\nexport type ParseDateSuccess = {\n  isValid: true\n  locale: SupportedLocale\n  date: Date\n  iso: string\n  timestamp: number\n  format: (output?: string) => string\n}\n\nexport type ParseDateFailure = {\n  isValid: false\n  locale: SupportedLocale\n  date: null\n  iso: null\n  timestamp: null\n  error: string\n}\n\nexport type ParseDateResult = ParseDateSuccess | ParseDateFailure\n\nconst DEFAULT_FORMAT = 'YYYY-MM-DD'\nconst DEFAULT_LOCALE: SupportedLocale = 'en'\nconst DEFAULT_INVALID_DATE = 'Invalid Date'\nconst DEFAULT_STRICT = true\n\nconst createResolvedConfig = (\n  locale: SupportedLocale,\n  config?: DateFormatterConfig\n): ResolvedDateFormatterConfig => ({\n  locale,\n  strict: config?.strict ?? DEFAULT_STRICT,\n  invalid: config?.invalid ?? DEFAULT_INVALID_DATE\n})\n\nconst getInvalidDateText = (config?: DateFormatterConfig, props?: GetDateOptions): string => {\n  return props?.invalid ?? config?.invalid ?? DEFAULT_INVALID_DATE\n}\n\nconst getTargetLocale = (currentLocale: SupportedLocale, props?: GetDateOptions): SupportedLocale => {\n  if (!props?.locale) {\n    return currentLocale\n  }\n\n  return resolveLocaleOrThrow(props.locale)\n}\n\nconst getHelperLocale = <T extends { locale?: LocaleInput }>(\n  config?: DateFormatterConfig,\n  props?: T\n): SupportedLocale => {\n  if (props?.locale) {\n    return resolveLocaleOrThrow(props.locale)\n  }\n\n  if (config?.locale) {\n    return resolveLocaleOrThrow(config.locale)\n  }\n\n  return DEFAULT_LOCALE\n}\n\nconst parseDateValue = (\n  value: DateValue,\n  input: DateParsingOptions['input'],\n  locale: SupportedLocale,\n  strict: boolean\n): Dayjs => {\n  if (!input) {\n    return dayjs(value).locale(locale)\n  }\n\n  if (typeof input === 'string') {\n    return dayjs(value, input, locale, strict).locale(locale)\n  }\n\n  return dayjs(value, [...input], locale, strict).locale(locale)\n}\n\nconst createFormatterParseDate = (getConfig: () => ResolvedDateFormatterConfig) => {\n  return (props: DateParsingOptions): ParseDateResult => {\n    const config = getConfig()\n    const locale = getTargetLocale(config.locale, props)\n    const parsed = parseDateValue(props.date, props.input, locale, props.strict ?? config.strict)\n\n    if (!parsed.isValid()) {\n      return {\n        isValid: false,\n        locale,\n        date: null,\n        iso: null,\n        timestamp: null,\n        error: getInvalidDateText(config, props)\n      }\n    }\n\n    return {\n      isValid: true,\n      locale,\n      date: parsed.toDate(),\n      iso: parsed.toISOString(),\n      timestamp: parsed.valueOf(),\n      format: (output = DEFAULT_FORMAT) => parsed.format(output)\n    }\n  }\n}\n\nconst createFormatterIsValidDate = (parseDate: (props: DateParsingOptions) => ParseDateResult) => {\n  return (props: DateParsingOptions): boolean => parseDate(props).isValid\n}\n\nconst createFormatterGetDate = (getConfig: () => ResolvedDateFormatterConfig) => {\n  const parseDate = createFormatterParseDate(getConfig)\n\n  return (props?: GetDateOptions): string => {\n    const config = getConfig()\n    const locale = getTargetLocale(config.locale, props)\n    const output = props?.output ?? DEFAULT_FORMAT\n\n    if (!props) {\n      return dayjs().locale(locale).format(DEFAULT_FORMAT)\n    }\n\n    if (props.date === undefined) {\n      return dayjs().locale(locale).format(output)\n    }\n\n    const parsed = parseDate({\n      date: props.date,\n      input: props.input,\n      locale: props.locale,\n      strict: props.strict\n    })\n\n    if (!parsed.isValid) {\n      return props.invalid ?? parsed.error\n    }\n\n    return parsed.format(output)\n  }\n}\n\nfunction resolveLocaleOrThrow(locale: LocaleInput): SupportedLocale {\n  const resolvedLocale = resolveLocale(locale)\n\n  if (!resolvedLocale) {\n    throw new Error(\n      `Unsupported locale: ${locale}. The package tries an exact locale match first and then falls back to the base locale.`\n    )\n  }\n\n  return resolvedLocale\n}\n\nexport const getSupportedLocales = (): readonly SupportedLocale[] => SUPPORTED_LOCALES\n\nexport const getDate = async (props?: GetDateOptions, config?: DateFormatterConfig): Promise<string> => {\n  const locale = getHelperLocale(config, props)\n  const formatter = createDateFormatter({ ...config, locale })\n\n  await formatter.ready\n\n  return formatter.getDate(props)\n}\n\nexport const parseDate = async (\n  props: DateParsingOptions,\n  config?: DateFormatterConfig\n): Promise<ParseDateResult> => {\n  const locale = getHelperLocale(config, props)\n  const formatter = createDateFormatter({ ...config, locale })\n\n  await formatter.ready\n\n  return formatter.parseDate(props)\n}\n\nexport const isValidDate = async (\n  props: DateParsingOptions,\n  config?: DateFormatterConfig\n): Promise<boolean> => {\n  const locale = getHelperLocale(config, props)\n  const formatter = createDateFormatter({ ...config, locale })\n\n  await formatter.ready\n\n  return formatter.isValidDate(props)\n}\n\nexport const createDateFormatter = (config?: DateFormatterConfig): DateFormatter => {\n  let currentLocale = config?.locale ? resolveLocaleOrThrow(config.locale) : DEFAULT_LOCALE\n\n  const getConfig = (): ResolvedDateFormatterConfig => createResolvedConfig(currentLocale, config)\n\n  const ready = ensureLocaleLoaded(currentLocale)\n  const parseDate = createFormatterParseDate(getConfig)\n\n  return {\n    getDate: createFormatterGetDate(getConfig),\n    parseDate,\n    isValidDate: createFormatterIsValidDate(parseDate),\n    getSupportedLocales,\n    getCurrentLocale: () => currentLocale,\n    setLocale: async (locale: LocaleInput) => {\n      const resolvedLocale = resolveLocaleOrThrow(locale)\n\n      await ensureLocaleLoaded(resolvedLocale)\n      currentLocale = resolvedLocale\n    },\n    ready\n  }\n}\n","export const SUPPORTED_LOCALES = [\n  'en',\n  'es',\n  'es-mx',\n  'fr',\n  'pt',\n  'pt-br',\n  'de',\n  'it',\n  'ja'\n] as const\n\nexport type SupportedLocale = (typeof SUPPORTED_LOCALES)[number]\nexport type LocaleInput = string\n\nconst loadedLocales = new Set<SupportedLocale>(['en'])\n\nconst localeLoaders: Record<SupportedLocale, (() => Promise<unknown>) | null> = {\n  en: null,\n  es: () => import('dayjs/locale/es.js'),\n  'es-mx': () => import('dayjs/locale/es-mx.js'),\n  fr: () => import('dayjs/locale/fr.js'),\n  pt: () => import('dayjs/locale/pt.js'),\n  'pt-br': () => import('dayjs/locale/pt-br.js'),\n  de: () => import('dayjs/locale/de.js'),\n  it: () => import('dayjs/locale/it.js'),\n  ja: () => import('dayjs/locale/ja.js')\n}\n\nconst normalizeLocale = (locale: string): string => {\n  return locale.trim().toLowerCase().replace(/_/g, '-')\n}\n\nconst asSupportedLocale = (locale: string): SupportedLocale | null => {\n  if (!SUPPORTED_LOCALES.includes(locale as SupportedLocale)) {\n    return null\n  }\n\n  return locale as SupportedLocale\n}\n\nexport const isSupportedLocale = (locale: string): boolean => {\n  return resolveLocale(locale) !== null\n}\n\nexport const resolveLocale = (locale: LocaleInput): SupportedLocale | null => {\n  const normalizedLocale = normalizeLocale(locale)\n  const exactLocale = asSupportedLocale(normalizedLocale)\n\n  if (exactLocale) {\n    return exactLocale\n  }\n\n  const [baseLocale] = normalizedLocale.split('-')\n\n  if (!baseLocale) {\n    return null\n  }\n\n  return asSupportedLocale(baseLocale)\n}\n\nexport const markLocaleAsLoaded = (locale: SupportedLocale): void => {\n  loadedLocales.add(locale)\n}\n\nexport const ensureLocaleLoaded = async (locale: SupportedLocale): Promise<void> => {\n  if (loadedLocales.has(locale)) {\n    return\n  }\n\n  const load = localeLoaders[locale]\n\n  if (!load) {\n    loadedLocales.add(locale)\n    return\n  }\n\n  await load()\n  loadedLocales.add(locale)\n}\n"],"mappings":"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","names":["parseDate"]}
+{"version":3,"sources":["../src/core/date.ts","../src/core/locales.ts"],"sourcesContent":["import customParseFormat from 'dayjs/plugin/customParseFormat.js'\nimport dayjs from 'dayjs'\nimport type { Dayjs } from 'dayjs'\n\nimport {\n  ensureLocaleLoaded,\n  isLocaleLoaded,\n  resolveLocale,\n  SUPPORTED_LOCALES,\n  type LocaleInput,\n  type SupportedLocale\n} from './locales.js'\n\ndayjs.extend(customParseFormat)\ndayjs.locale('en')\n\nexport type DateValue = string | number | Date\n\ntype DateInputOptions = {\n  input?: string | readonly string[]\n  locale?: LocaleInput\n  strict?: boolean\n}\n\nexport type DateParsingOptions = DateInputOptions & {\n  date: DateValue\n}\n\nexport type GetDateOptions = DateInputOptions & {\n  date?: DateValue\n  output?: string\n  invalid?: string\n}\n\nexport type CreateDateChainOptions = DateInputOptions & {\n  date?: DateValue\n  invalid?: string\n}\n\nexport type DateFormatterConfig = {\n  locale?: LocaleInput\n  strict?: boolean\n  invalid?: string\n}\n\nexport type DateChainManipulateUnit =\n  | 'millisecond'\n  | 'second'\n  | 'minute'\n  | 'hour'\n  | 'day'\n  | 'week'\n  | 'month'\n  | 'year'\n\nexport type DateChainBoundaryUnit =\n  | 'year'\n  | 'month'\n  | 'week'\n  | 'day'\n  | 'hour'\n  | 'minute'\n  | 'second'\n\nexport type DateChainCompareUnit = DateChainBoundaryUnit | 'millisecond'\n\nexport type DateChainSetUnit =\n  | 'year'\n  | 'month'\n  | 'day'\n  | 'hour'\n  | 'minute'\n  | 'second'\n  | 'millisecond'\n\ntype ResolvedDateFormatterConfig = {\n  locale: SupportedLocale\n  strict: boolean\n  invalid: string\n}\n\nexport type DateChainSuccessState = {\n  isValid: true\n  locale: SupportedLocale\n  date: Date\n  iso: string\n  timestamp: number\n}\n\nexport type DateChainFailureState = {\n  isValid: false\n  locale: SupportedLocale\n  date: null\n  iso: null\n  timestamp: null\n  error: string\n}\n\nexport type DateChainState = DateChainSuccessState | DateChainFailureState\n\nexport type DateChain = {\n  ready: Promise<void>\n  add: (value: number, unit: DateChainManipulateUnit) => DateChain\n  subtract: (value: number, unit: DateChainManipulateUnit) => DateChain\n  set: (unit: DateChainSetUnit, value: number) => DateChain\n  startOf: (unit: DateChainBoundaryUnit) => DateChain\n  endOf: (unit: DateChainBoundaryUnit) => DateChain\n  format: (output?: string) => string\n  toDate: () => Date | null\n  toISOString: () => string | null\n  toTimestamp: () => number | null\n  isValid: () => boolean\n  isBefore: (other: DateChainComparable, unit?: DateChainCompareUnit) => boolean\n  isAfter: (other: DateChainComparable, unit?: DateChainCompareUnit) => boolean\n  isSame: (other: DateChainComparable, unit?: DateChainCompareUnit) => boolean\n  toState: () => DateChainState\n}\n\nexport type DateChainComparable = DateValue | DateChain\n\nexport type DateFormatter = {\n  getDate: (props?: GetDateOptions) => string\n  parseDate: (props: DateParsingOptions) => ParseDateResult\n  isValidDate: (props: DateParsingOptions) => boolean\n  createDateChain: (props?: CreateDateChainOptions) => DateChain\n  getSupportedLocales: () => readonly SupportedLocale[]\n  getCurrentLocale: () => SupportedLocale\n  setLocale: (locale: LocaleInput) => Promise<void>\n  ready: Promise<void>\n}\n\nexport type ParseDateSuccess = {\n  isValid: true\n  locale: SupportedLocale\n  date: Date\n  iso: string\n  timestamp: number\n  format: (output?: string) => string\n}\n\nexport type ParseDateFailure = {\n  isValid: false\n  locale: SupportedLocale\n  date: null\n  iso: null\n  timestamp: null\n  error: string\n}\n\nexport type ParseDateResult = ParseDateSuccess | ParseDateFailure\n\ntype InternalDateChainState = {\n  locale: SupportedLocale\n  invalid: string\n  current: Dayjs | null\n  ready: boolean\n  error: string | null\n}\n\nconst DEFAULT_FORMAT = 'YYYY-MM-DD'\nconst DEFAULT_LOCALE: SupportedLocale = 'en'\nconst DEFAULT_INVALID_DATE = 'Invalid Date'\nconst DEFAULT_STRICT = true\n\nconst createResolvedConfig = (\n  locale: SupportedLocale,\n  config?: DateFormatterConfig\n): ResolvedDateFormatterConfig => ({\n  locale,\n  strict: config?.strict ?? DEFAULT_STRICT,\n  invalid: config?.invalid ?? DEFAULT_INVALID_DATE\n})\n\nconst getInvalidDateText = <T>(config?: DateFormatterConfig, props?: T): string => {\n  if (typeof props === 'object' && props !== null && 'invalid' in props) {\n    const invalid = (props as { invalid?: string }).invalid\n\n    if (invalid !== undefined) {\n      return invalid\n    }\n  }\n\n  return config?.invalid ?? DEFAULT_INVALID_DATE\n}\n\nconst getTargetLocale = <T extends { locale?: LocaleInput }>(\n  currentLocale: SupportedLocale,\n  props?: T\n): SupportedLocale => {\n  if (!props?.locale) {\n    return currentLocale\n  }\n\n  return resolveLocaleOrThrow(props.locale)\n}\n\nconst getHelperLocale = <T extends { locale?: LocaleInput }>(\n  config?: DateFormatterConfig,\n  props?: T\n): SupportedLocale => {\n  if (props?.locale) {\n    return resolveLocaleOrThrow(props.locale)\n  }\n\n  if (config?.locale) {\n    return resolveLocaleOrThrow(config.locale)\n  }\n\n  return DEFAULT_LOCALE\n}\n\nconst parseDateValue = (\n  value: DateValue,\n  input: DateParsingOptions['input'],\n  locale: SupportedLocale,\n  strict: boolean\n): Dayjs => {\n  if (!input) {\n    return dayjs(value).locale(locale)\n  }\n\n  if (typeof input === 'string') {\n    return dayjs(value, input, locale, strict).locale(locale)\n  }\n\n  return dayjs(value, [...input], locale, strict).locale(locale)\n}\n\nconst getCurrentDayjs = (locale: SupportedLocale): Dayjs => {\n  return dayjs().locale(locale)\n}\n\nconst createParseSuccess = (parsed: Dayjs, locale: SupportedLocale): ParseDateSuccess => {\n  return {\n    isValid: true,\n    locale,\n    date: parsed.toDate(),\n    iso: parsed.toISOString(),\n    timestamp: parsed.valueOf(),\n    format: (output = DEFAULT_FORMAT) => parsed.format(output)\n  }\n}\n\nconst createParseFailure = (locale: SupportedLocale, error: string): ParseDateFailure => {\n  return {\n    isValid: false,\n    locale,\n    date: null,\n    iso: null,\n    timestamp: null,\n    error\n  }\n}\n\nconst createDateChainSuccessState = (parsed: Dayjs, locale: SupportedLocale): DateChainSuccessState => {\n  return {\n    isValid: true,\n    locale,\n    date: parsed.toDate(),\n    iso: parsed.toISOString(),\n    timestamp: parsed.valueOf()\n  }\n}\n\nconst createDateChainFailureState = (locale: SupportedLocale, error: string): DateChainFailureState => {\n  return {\n    isValid: false,\n    locale,\n    date: null,\n    iso: null,\n    timestamp: null,\n    error\n  }\n}\n\nconst mapChainSetUnit = (unit: DateChainSetUnit): 'year' | 'month' | 'date' | 'hour' | 'minute' | 'second' | 'millisecond' => {\n  if (unit === 'day') {\n    return 'date'\n  }\n\n  return unit\n}\n\nconst createReadyError = (): Error => {\n  return new Error('Date chain is not ready. Await chain.ready before using it with locales that may need to load.')\n}\n\nconst assertDateChainReady = (state: InternalDateChainState): void => {\n  if (!state.ready) {\n    throw createReadyError()\n  }\n}\n\nconst getComparableDayjs = (value: DateChainComparable): Dayjs | null => {\n  if (typeof value === 'object' && value !== null && 'toState' in value) {\n    const state = value.toState()\n\n    if (!state.isValid) {\n      return null\n    }\n\n    return dayjs(state.date)\n  }\n\n  const comparable = dayjs(value)\n\n  if (!comparable.isValid()) {\n    return null\n  }\n\n  return comparable\n}\n\nconst createDateChainApi = (state: InternalDateChainState, ready: Promise<void>): DateChain => {\n  const applyMutation = (transform: (current: Dayjs) => Dayjs): DateChain => {\n    assertDateChainReady(state)\n\n    if (state.current) {\n      state.current = transform(state.current)\n    }\n\n    return chain\n  }\n\n  const compare = (\n    other: DateChainComparable,\n    comparator: (current: Dayjs, comparable: Dayjs) => boolean\n  ): boolean => {\n    assertDateChainReady(state)\n\n    if (!state.current) {\n      return false\n    }\n\n    const comparable = getComparableDayjs(other)\n\n    if (!comparable) {\n      return false\n    }\n\n    return comparator(state.current, comparable)\n  }\n\n  const chain: DateChain = {\n    ready,\n    add: (value, unit) => applyMutation((current) => current.add(value, unit)),\n    subtract: (value, unit) => applyMutation((current) => current.subtract(value, unit)),\n    set: (unit, value) => applyMutation((current) => current.set(mapChainSetUnit(unit), value)),\n    startOf: (unit) => applyMutation((current) => current.startOf(unit)),\n    endOf: (unit) => applyMutation((current) => current.endOf(unit)),\n    format: (output = DEFAULT_FORMAT) => {\n      assertDateChainReady(state)\n\n      if (!state.current) {\n        return state.invalid\n      }\n\n      return state.current.format(output)\n    },\n    toDate: () => {\n      assertDateChainReady(state)\n\n      return state.current ? state.current.toDate() : null\n    },\n    toISOString: () => {\n      assertDateChainReady(state)\n\n      return state.current ? state.current.toISOString() : null\n    },\n    toTimestamp: () => {\n      assertDateChainReady(state)\n\n      return state.current ? state.current.valueOf() : null\n    },\n    isValid: () => {\n      assertDateChainReady(state)\n\n      return state.current !== null\n    },\n    isBefore: (other, unit) => compare(other, (current, comparable) => current.isBefore(comparable, unit)),\n    isAfter: (other, unit) => compare(other, (current, comparable) => current.isAfter(comparable, unit)),\n    isSame: (other, unit) => compare(other, (current, comparable) => current.isSame(comparable, unit)),\n    toState: () => {\n      assertDateChainReady(state)\n\n      if (!state.current) {\n        return createDateChainFailureState(state.locale, state.error ?? state.invalid)\n      }\n\n      return createDateChainSuccessState(state.current, state.locale)\n    }\n  }\n\n  return chain\n}\n\nconst createDateChainState = (\n  locale: SupportedLocale,\n  invalid: string,\n  getInitialDate: () => Dayjs\n): { state: InternalDateChainState; ready: Promise<void> } => {\n  const state: InternalDateChainState = {\n    locale,\n    invalid,\n    current: null,\n    ready: false,\n    error: invalid\n  }\n\n  const initialize = () => {\n    const parsed = getInitialDate()\n\n    state.ready = true\n\n    if (!parsed.isValid()) {\n      state.current = null\n      state.error = invalid\n      return\n    }\n\n    state.current = parsed\n    state.error = null\n  }\n\n  if (isLocaleLoaded(locale)) {\n    initialize()\n\n    return {\n      state,\n      ready: Promise.resolve()\n    }\n  }\n\n  return {\n    state,\n    ready: ensureLocaleLoaded(locale).then(() => {\n      initialize()\n    })\n  }\n}\n\nconst createDateChainFromResolvedConfig = (\n  props: CreateDateChainOptions | undefined,\n  config: ResolvedDateFormatterConfig\n): DateChain => {\n  const locale = getTargetLocale(config.locale, props)\n  const invalid = getInvalidDateText(config, props)\n  const strict = props?.strict ?? config.strict\n  const getInitialDate = () => {\n    if (props?.date === undefined) {\n      return getCurrentDayjs(locale)\n    }\n\n    return parseDateValue(props.date, props.input, locale, strict)\n  }\n\n  const { state, ready } = createDateChainState(locale, invalid, getInitialDate)\n\n  return createDateChainApi(state, ready)\n}\n\nconst createFormatterParseDate = (getConfig: () => ResolvedDateFormatterConfig) => {\n  return (props: DateParsingOptions): ParseDateResult => {\n    const config = getConfig()\n    const locale = getTargetLocale(config.locale, props)\n    const parsed = parseDateValue(props.date, props.input, locale, props.strict ?? config.strict)\n\n    if (!parsed.isValid()) {\n      return createParseFailure(locale, getInvalidDateText(config, props))\n    }\n\n    return createParseSuccess(parsed, locale)\n  }\n}\n\nconst createFormatterIsValidDate = (parseDate: (props: DateParsingOptions) => ParseDateResult) => {\n  return (props: DateParsingOptions): boolean => parseDate(props).isValid\n}\n\nconst createFormatterGetDate = (getConfig: () => ResolvedDateFormatterConfig) => {\n  const parseDate = createFormatterParseDate(getConfig)\n\n  return (props?: GetDateOptions): string => {\n    const config = getConfig()\n    const locale = getTargetLocale(config.locale, props)\n    const output = props?.output ?? DEFAULT_FORMAT\n\n    if (!props) {\n      return getCurrentDayjs(locale).format(DEFAULT_FORMAT)\n    }\n\n    if (props.date === undefined) {\n      return getCurrentDayjs(locale).format(output)\n    }\n\n    const parsed = parseDate({\n      date: props.date,\n      input: props.input,\n      locale: props.locale,\n      strict: props.strict\n    })\n\n    if (!parsed.isValid) {\n      return props.invalid ?? parsed.error\n    }\n\n    return parsed.format(output)\n  }\n}\n\nconst createFormatterCreateDateChain = (getConfig: () => ResolvedDateFormatterConfig) => {\n  return (props?: CreateDateChainOptions): DateChain => {\n    return createDateChainFromResolvedConfig(props, getConfig())\n  }\n}\n\nfunction resolveLocaleOrThrow(locale: LocaleInput): SupportedLocale {\n  const resolvedLocale = resolveLocale(locale)\n\n  if (!resolvedLocale) {\n    throw new Error(\n      `Unsupported locale: ${locale}. The package tries an exact locale match first and then falls back to the base locale.`\n    )\n  }\n\n  return resolvedLocale\n}\n\nexport const getSupportedLocales = (): readonly SupportedLocale[] => SUPPORTED_LOCALES\n\nexport const createDateChain = (props?: CreateDateChainOptions, config?: DateFormatterConfig): DateChain => {\n  const locale = getHelperLocale(config, props)\n\n  return createDateChainFromResolvedConfig(props, createResolvedConfig(locale, config))\n}\n\nexport const getDate = async (props?: GetDateOptions, config?: DateFormatterConfig): Promise<string> => {\n  const locale = getHelperLocale(config, props)\n  const formatter = createDateFormatter({ ...config, locale })\n\n  await formatter.ready\n\n  return formatter.getDate(props)\n}\n\nexport const parseDate = async (\n  props: DateParsingOptions,\n  config?: DateFormatterConfig\n): Promise<ParseDateResult> => {\n  const locale = getHelperLocale(config, props)\n  const formatter = createDateFormatter({ ...config, locale })\n\n  await formatter.ready\n\n  return formatter.parseDate(props)\n}\n\nexport const isValidDate = async (\n  props: DateParsingOptions,\n  config?: DateFormatterConfig\n): Promise<boolean> => {\n  const locale = getHelperLocale(config, props)\n  const formatter = createDateFormatter({ ...config, locale })\n\n  await formatter.ready\n\n  return formatter.isValidDate(props)\n}\n\nexport const createDateFormatter = (config?: DateFormatterConfig): DateFormatter => {\n  let currentLocale = config?.locale ? resolveLocaleOrThrow(config.locale) : DEFAULT_LOCALE\n\n  const getConfig = (): ResolvedDateFormatterConfig => createResolvedConfig(currentLocale, config)\n\n  const ready = ensureLocaleLoaded(currentLocale)\n  const parseDate = createFormatterParseDate(getConfig)\n\n  return {\n    getDate: createFormatterGetDate(getConfig),\n    parseDate,\n    isValidDate: createFormatterIsValidDate(parseDate),\n    createDateChain: createFormatterCreateDateChain(getConfig),\n    getSupportedLocales,\n    getCurrentLocale: () => currentLocale,\n    setLocale: async (locale: LocaleInput) => {\n      const resolvedLocale = resolveLocaleOrThrow(locale)\n\n      await ensureLocaleLoaded(resolvedLocale)\n      currentLocale = resolvedLocale\n    },\n    ready\n  }\n}\n","export const SUPPORTED_LOCALES = [\n  'en',\n  'es',\n  'es-mx',\n  'fr',\n  'pt',\n  'pt-br',\n  'de',\n  'it',\n  'ja'\n] as const\n\nexport type SupportedLocale = (typeof SUPPORTED_LOCALES)[number]\nexport type LocaleInput = string\n\nconst loadedLocales = new Set<SupportedLocale>(['en'])\n\nconst localeLoaders: Record<SupportedLocale, (() => Promise<unknown>) | null> = {\n  en: null,\n  es: () => import('dayjs/locale/es.js'),\n  'es-mx': () => import('dayjs/locale/es-mx.js'),\n  fr: () => import('dayjs/locale/fr.js'),\n  pt: () => import('dayjs/locale/pt.js'),\n  'pt-br': () => import('dayjs/locale/pt-br.js'),\n  de: () => import('dayjs/locale/de.js'),\n  it: () => import('dayjs/locale/it.js'),\n  ja: () => import('dayjs/locale/ja.js')\n}\n\nconst normalizeLocale = (locale: string): string => {\n  return locale.trim().toLowerCase().replace(/_/g, '-')\n}\n\nconst asSupportedLocale = (locale: string): SupportedLocale | null => {\n  if (!SUPPORTED_LOCALES.includes(locale as SupportedLocale)) {\n    return null\n  }\n\n  return locale as SupportedLocale\n}\n\nexport const isSupportedLocale = (locale: string): boolean => {\n  return resolveLocale(locale) !== null\n}\n\nexport const resolveLocale = (locale: LocaleInput): SupportedLocale | null => {\n  const normalizedLocale = normalizeLocale(locale)\n  const exactLocale = asSupportedLocale(normalizedLocale)\n\n  if (exactLocale) {\n    return exactLocale\n  }\n\n  const [baseLocale] = normalizedLocale.split('-')\n\n  if (!baseLocale) {\n    return null\n  }\n\n  return asSupportedLocale(baseLocale)\n}\n\nexport const markLocaleAsLoaded = (locale: SupportedLocale): void => {\n  loadedLocales.add(locale)\n}\n\nexport const isLocaleLoaded = (locale: SupportedLocale): boolean => {\n  return loadedLocales.has(locale)\n}\n\nexport const ensureLocaleLoaded = async (locale: SupportedLocale): Promise<void> => {\n  if (loadedLocales.has(locale)) {\n    return\n  }\n\n  const load = localeLoaders[locale]\n\n  if (!load) {\n    loadedLocales.add(locale)\n    return\n  }\n\n  await load()\n  loadedLocales.add(locale)\n}\n"],"mappings":"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","names":["parseDate"]}

package/dist/react/index.d.ts

@@ -1,9 +1,10 @@
-import { DateFormatterConfig, GetDateOptions, DateParsingOptions, ParseDateResult, SupportedLocale, LocaleInput } from '../index.js';
+import { DateFormatterConfig, CreateDateChainOptions, DateChain, GetDateOptions, DateParsingOptions, ParseDateResult, SupportedLocale, LocaleInput } from '../index.js';
 
 type UseDateFormatterOptions = DateFormatterConfig;
 declare const useDateFormatter: (options?: UseDateFormatterOptions) => {
     locale: "en" | "es" | "es-mx" | "fr" | "pt" | "pt-br" | "de" | "it" | "ja";
     currentLocale: "en" | "es" | "es-mx" | "fr" | "pt" | "pt-br" | "de" | "it" | "ja";
+    createDateChain: (props?: CreateDateChainOptions) => DateChain;
     getDate: (props?: GetDateOptions) => string;
     parseDate: (props: DateParsingOptions) => ParseDateResult;
     isValidDate: (props: DateParsingOptions) => boolean;

package/dist/react/index.js

@@ -50,6 +50,9 @@ var resolveLocale = (locale) => {
   }
   return asSupportedLocale(baseLocale);
 };
+var isLocaleLoaded = (locale) => {
+  return loadedLocales.has(locale);
+};
 var ensureLocaleLoaded = async (locale) => {
   if (loadedLocales.has(locale)) {
     return;
@@ -76,7 +79,13 @@ var createResolvedConfig = (locale, config) => ({
   invalid: config?.invalid ?? DEFAULT_INVALID_DATE
 });
 var getInvalidDateText = (config, props) => {
-  return props?.invalid ?? config?.invalid ?? DEFAULT_INVALID_DATE;
+  if (typeof props === "object" && props !== null && "invalid" in props) {
+    const invalid = props.invalid;
+    if (invalid !== void 0) {
+      return invalid;
+    }
+  }
+  return config?.invalid ?? DEFAULT_INVALID_DATE;
 };
 var getTargetLocale = (currentLocale, props) => {
   if (!props?.locale) {
@@ -93,29 +102,193 @@ var parseDateValue = (value, input, locale, strict) => {
   }
   return dayjs(value, [...input], locale, strict).locale(locale);
 };
+var getCurrentDayjs = (locale) => {
+  return dayjs().locale(locale);
+};
+var createParseSuccess = (parsed, locale) => {
+  return {
+    isValid: true,
+    locale,
+    date: parsed.toDate(),
+    iso: parsed.toISOString(),
+    timestamp: parsed.valueOf(),
+    format: (output = DEFAULT_FORMAT) => parsed.format(output)
+  };
+};
+var createParseFailure = (locale, error) => {
+  return {
+    isValid: false,
+    locale,
+    date: null,
+    iso: null,
+    timestamp: null,
+    error
+  };
+};
+var createDateChainSuccessState = (parsed, locale) => {
+  return {
+    isValid: true,
+    locale,
+    date: parsed.toDate(),
+    iso: parsed.toISOString(),
+    timestamp: parsed.valueOf()
+  };
+};
+var createDateChainFailureState = (locale, error) => {
+  return {
+    isValid: false,
+    locale,
+    date: null,
+    iso: null,
+    timestamp: null,
+    error
+  };
+};
+var mapChainSetUnit = (unit) => {
+  if (unit === "day") {
+    return "date";
+  }
+  return unit;
+};
+var createReadyError = () => {
+  return new Error("Date chain is not ready. Await chain.ready before using it with locales that may need to load.");
+};
+var assertDateChainReady = (state) => {
+  if (!state.ready) {
+    throw createReadyError();
+  }
+};
+var getComparableDayjs = (value) => {
+  if (typeof value === "object" && value !== null && "toState" in value) {
+    const state = value.toState();
+    if (!state.isValid) {
+      return null;
+    }
+    return dayjs(state.date);
+  }
+  const comparable = dayjs(value);
+  if (!comparable.isValid()) {
+    return null;
+  }
+  return comparable;
+};
+var createDateChainApi = (state, ready) => {
+  const applyMutation = (transform) => {
+    assertDateChainReady(state);
+    if (state.current) {
+      state.current = transform(state.current);
+    }
+    return chain;
+  };
+  const compare = (other, comparator) => {
+    assertDateChainReady(state);
+    if (!state.current) {
+      return false;
+    }
+    const comparable = getComparableDayjs(other);
+    if (!comparable) {
+      return false;
+    }
+    return comparator(state.current, comparable);
+  };
+  const chain = {
+    ready,
+    add: (value, unit) => applyMutation((current) => current.add(value, unit)),
+    subtract: (value, unit) => applyMutation((current) => current.subtract(value, unit)),
+    set: (unit, value) => applyMutation((current) => current.set(mapChainSetUnit(unit), value)),
+    startOf: (unit) => applyMutation((current) => current.startOf(unit)),
+    endOf: (unit) => applyMutation((current) => current.endOf(unit)),
+    format: (output = DEFAULT_FORMAT) => {
+      assertDateChainReady(state);
+      if (!state.current) {
+        return state.invalid;
+      }
+      return state.current.format(output);
+    },
+    toDate: () => {
+      assertDateChainReady(state);
+      return state.current ? state.current.toDate() : null;
+    },
+    toISOString: () => {
+      assertDateChainReady(state);
+      return state.current ? state.current.toISOString() : null;
+    },
+    toTimestamp: () => {
+      assertDateChainReady(state);
+      return state.current ? state.current.valueOf() : null;
+    },
+    isValid: () => {
+      assertDateChainReady(state);
+      return state.current !== null;
+    },
+    isBefore: (other, unit) => compare(other, (current, comparable) => current.isBefore(comparable, unit)),
+    isAfter: (other, unit) => compare(other, (current, comparable) => current.isAfter(comparable, unit)),
+    isSame: (other, unit) => compare(other, (current, comparable) => current.isSame(comparable, unit)),
+    toState: () => {
+      assertDateChainReady(state);
+      if (!state.current) {
+        return createDateChainFailureState(state.locale, state.error ?? state.invalid);
+      }
+      return createDateChainSuccessState(state.current, state.locale);
+    }
+  };
+  return chain;
+};
+var createDateChainState = (locale, invalid, getInitialDate) => {
+  const state = {
+    locale,
+    invalid,
+    current: null,
+    ready: false,
+    error: invalid
+  };
+  const initialize = () => {
+    const parsed = getInitialDate();
+    state.ready = true;
+    if (!parsed.isValid()) {
+      state.current = null;
+      state.error = invalid;
+      return;
+    }
+    state.current = parsed;
+    state.error = null;
+  };
+  if (isLocaleLoaded(locale)) {
+    initialize();
+    return {
+      state,
+      ready: Promise.resolve()
+    };
+  }
+  return {
+    state,
+    ready: ensureLocaleLoaded(locale).then(() => {
+      initialize();
+    })
+  };
+};
+var createDateChainFromResolvedConfig = (props, config) => {
+  const locale = getTargetLocale(config.locale, props);
+  const invalid = getInvalidDateText(config, props);
+  const strict = props?.strict ?? config.strict;
+  const getInitialDate = () => {
+    if (props?.date === void 0) {
+      return getCurrentDayjs(locale);
+    }
+    return parseDateValue(props.date, props.input, locale, strict);
+  };
+  const { state, ready } = createDateChainState(locale, invalid, getInitialDate);
+  return createDateChainApi(state, ready);
+};
 var createFormatterParseDate = (getConfig) => {
   return (props) => {
     const config = getConfig();
     const locale = getTargetLocale(config.locale, props);
     const parsed = parseDateValue(props.date, props.input, locale, props.strict ?? config.strict);
     if (!parsed.isValid()) {
-      return {
-        isValid: false,
-        locale,
-        date: null,
-        iso: null,
-        timestamp: null,
-        error: getInvalidDateText(config, props)
-      };
+      return createParseFailure(locale, getInvalidDateText(config, props));
     }
-    return {
-      isValid: true,
-      locale,
-      date: parsed.toDate(),
-      iso: parsed.toISOString(),
-      timestamp: parsed.valueOf(),
-      format: (output = DEFAULT_FORMAT) => parsed.format(output)
-    };
+    return createParseSuccess(parsed, locale);
   };
 };
 var createFormatterIsValidDate = (parseDate2) => {
@@ -128,10 +301,10 @@ var createFormatterGetDate = (getConfig) => {
     const locale = getTargetLocale(config.locale, props);
     const output = props?.output ?? DEFAULT_FORMAT;
     if (!props) {
-      return dayjs().locale(locale).format(DEFAULT_FORMAT);
+      return getCurrentDayjs(locale).format(DEFAULT_FORMAT);
     }
     if (props.date === void 0) {
-      return dayjs().locale(locale).format(output);
+      return getCurrentDayjs(locale).format(output);
     }
     const parsed = parseDate2({
       date: props.date,
@@ -145,6 +318,11 @@ var createFormatterGetDate = (getConfig) => {
     return parsed.format(output);
   };
 };
+var createFormatterCreateDateChain = (getConfig) => {
+  return (props) => {
+    return createDateChainFromResolvedConfig(props, getConfig());
+  };
+};
 function resolveLocaleOrThrow(locale) {
   const resolvedLocale = resolveLocale(locale);
   if (!resolvedLocale) {
@@ -164,6 +342,7 @@ var createDateFormatter = (config) => {
     getDate: createFormatterGetDate(getConfig),
     parseDate: parseDate2,
     isValidDate: createFormatterIsValidDate(parseDate2),
+    createDateChain: createFormatterCreateDateChain(getConfig),
     getSupportedLocales,
     getCurrentLocale: () => currentLocale,
     setLocale: async (locale) => {
@@ -182,6 +361,7 @@ var useDateFormatter = (options) => {
   return {
     locale,
     currentLocale: locale,
+    createDateChain: (props) => formatterRef.current.createDateChain(props),
     getDate: (props) => formatterRef.current.getDate(props),
     parseDate: (props) => formatterRef.current.parseDate(props),
     isValidDate: (props) => formatterRef.current.isValidDate(props),