@samline/date 1.0.0 → 2.1.0

package/README.md

@@ -35,10 +35,37 @@ npm install @samline/date
 
 ## Quick Start
 
+```ts
+import { getDate } from '@samline/date'
+
+const date = await getDate({
+  date: '23/03/2026',
+  input: 'DD/MM/YYYY',
+  output: 'MMMM D, YYYY'
+})
+```
+
+You can also inspect the effective locale before formatting:
+
+```ts
+import { resolveLocale } from '@samline/date'
+
+resolveLocale('es-mx')
+// es-mx
+
+resolveLocale('en-us')
+// en
+
+resolveLocale('zz-zz')
+// null
+```
+
+For repeated work with the same locale or invalid text, create one formatter instance and reuse it:
+
 ```ts
 import { createDateFormatter } from '@samline/date'
 
-const formatter = createDateFormatter({ locale: 'es-mx', strict: true })
+const formatter = createDateFormatter({ locale: 'es-mx' })
 
 await formatter.ready
 
@@ -55,7 +82,7 @@ const date = formatter.getDate({
 
 ```ts
 createDateFormatter(config?: {
-  locale?: SupportedLocale
+  locale?: LocaleInput
   strict?: boolean
   invalid?: string
 }): {
@@ -64,16 +91,18 @@ createDateFormatter(config?: {
   isValidDate(props: DateParsingOptions): boolean
   getSupportedLocales(): readonly SupportedLocale[]
   getCurrentLocale(): SupportedLocale
-  setLocale(locale: SupportedLocale): Promise<void>
+  setLocale(locale: LocaleInput): Promise<void>
   ready: Promise<void>
 }
 ```
 
 Creates a formatter instance with its own locale state. This avoids coupling framework wrappers and utility calls to the global Day.js locale.
 
-Use `strict: true` to make parsing fail when the input does not match the provided format exactly.
+`strict` is `true` by default, so parsing fails when the input does not match the provided format exactly. Use `strict: false` only when you explicitly want lenient parsing.
 
-If you override `locale` per call, make sure that locale was already loaded by a formatter instance.
+If you override `locale` per call, make sure the effective locale was already loaded by a formatter instance.
+
+Regional locale input falls back to the base locale when the exact variant is not supported by the package. For example, `en-us` resolves to `en`, while `es-mx` stays as `es-mx` because that locale is supported explicitly.
 
 The formatter instance exposes:
 
@@ -85,6 +114,57 @@ The formatter instance exposes:
 - `getSupportedLocales()`
 - `ready`
 
+### Locale helpers
+
+```ts
+resolveLocale(locale: LocaleInput): SupportedLocale | null
+isSupportedLocale(locale: string): boolean
+```
+
+Use `resolveLocale` when you want to know the effective locale before creating a formatter or calling a helper.
+
+Use `isSupportedLocale` when you only need a boolean check after the package applies its exact-match and base-locale fallback rules.
+
+These helpers are also available in the browser build through `DateKit.resolveLocale(...)` and `DateKit.isSupportedLocale(...)`.
+
+### One-shot helpers
+
+```ts
+getDate(props?: GetDateOptions, config?: DateFormatterConfig): Promise<string>
+parseDate(props: DateParsingOptions, config?: DateFormatterConfig): Promise<ParseDateResult>
+isValidDate(props: DateParsingOptions, config?: DateFormatterConfig): Promise<boolean>
+```
+
+Use these helpers when you only need a single operation and do not want to create a formatter instance manually.
+
+| Helper | Returns | Use it when you need |
+| --- | --- | --- |
+| `getDate(...)` | formatted string | a final display value |
+| `parseDate(...)` | structured parse result | validation details, `Date`, `iso`, `timestamp`, or deferred formatting |
+| `isValidDate(...)` | boolean | only a yes or no validation check |
+
+```ts
+import { getDate, isValidDate, parseDate } from '@samline/date'
+
+const value = await getDate({
+  date: '23/03/2026',
+  input: 'DD/MM/YYYY',
+  output: 'YYYY-MM-DD'
+})
+
+const parsed = await parseDate({
+  date: '23/03/2026',
+  input: 'DD/MM/YYYY'
+})
+
+const valid = await isValidDate({
+  date: '1970-00-00',
+  input: 'YYYY-MM-DD'
+})
+```
+
+They load the requested locale automatically and also use `strict: true` by default.
+
 ### parseDate
 
 ```ts
@@ -126,7 +206,23 @@ The package ships helper support for these locale keys:
 - `it`
 - `ja`
 
-Use `createDateFormatter({ locale: 'es-mx' })` when you need a locale other than English.
+You can also pass regional locale input such as `en-us`, `fr-ca`, or `pt-pt`.
+
+The resolution rule is:
+
+- if the exact locale exists, use it
+- otherwise, try the base locale before the hyphen
+- if neither exists, throw an unsupported locale error
+
+Examples:
+
+- `es-mx` -> `es-mx`
+- `es-ar` -> `es`
+- `en-us` -> `en`
+- `pt-pt` -> `pt`
+- `zz-zz` -> error
+
+Use a simple locale like `fr` or `en` when the base language is enough. Use a regional locale like `es-mx` or `pt-br` when you need a supported country-specific variant.
 
 ## Documentation
 

package/dist/browser/global.d.ts

@@ -1,8 +1,13 @@
-import { DateFormatterConfig, DateFormatter, SupportedLocale } from '../index.js';
+import { DateFormatterConfig, DateFormatter, GetDateOptions, SupportedLocale, DateParsingOptions, ParseDateResult, LocaleInput } from '../index.js';
 
 declare const DateKit: {
     createDateFormatter: (config?: DateFormatterConfig) => DateFormatter;
+    getDate: (props?: GetDateOptions, config?: DateFormatterConfig) => Promise<string>;
     getSupportedLocales: () => readonly SupportedLocale[];
+    isSupportedLocale: (locale: string) => boolean;
+    parseDate: (props: DateParsingOptions, config?: DateFormatterConfig) => Promise<ParseDateResult>;
+    isValidDate: (props: DateParsingOptions, config?: DateFormatterConfig) => Promise<boolean>;
+    resolveLocale: (locale: LocaleInput) => SupportedLocale | null;
 };
 declare global {
     interface Window {

package/dist/browser/global.js

@@ -25,8 +25,29 @@ var localeLoaders = {
   it: () => import("dayjs/locale/it.js"),
   ja: () => import("dayjs/locale/ja.js")
 };
+var normalizeLocale = (locale) => {
+  return locale.trim().toLowerCase().replace(/_/g, "-");
+};
+var asSupportedLocale = (locale) => {
+  if (!SUPPORTED_LOCALES.includes(locale)) {
+    return null;
+  }
+  return locale;
+};
 var isSupportedLocale = (locale) => {
-  return SUPPORTED_LOCALES.includes(locale);
+  return resolveLocale(locale) !== null;
+};
+var resolveLocale = (locale) => {
+  const normalizedLocale = normalizeLocale(locale);
+  const exactLocale = asSupportedLocale(normalizedLocale);
+  if (exactLocale) {
+    return exactLocale;
+  }
+  const [baseLocale] = normalizedLocale.split("-");
+  if (!baseLocale) {
+    return null;
+  }
+  return asSupportedLocale(baseLocale);
 };
 var ensureLocaleLoaded = async (locale) => {
   const load = localeLoaders[locale];
@@ -42,11 +63,29 @@ dayjs.locale("en");
 var DEFAULT_FORMAT = "YYYY-MM-DD";
 var DEFAULT_LOCALE = "en";
 var DEFAULT_INVALID_DATE = "Invalid Date";
+var DEFAULT_STRICT = true;
+var createResolvedConfig = (locale, config) => ({
+  locale,
+  strict: config?.strict ?? DEFAULT_STRICT,
+  invalid: config?.invalid ?? DEFAULT_INVALID_DATE
+});
 var getInvalidDateText = (config, props) => {
   return props?.invalid ?? config?.invalid ?? DEFAULT_INVALID_DATE;
 };
 var getTargetLocale = (currentLocale, props) => {
-  return props?.locale ?? currentLocale;
+  if (!props?.locale) {
+    return currentLocale;
+  }
+  return resolveLocaleOrThrow(props.locale);
+};
+var getHelperLocale = (config, props) => {
+  if (props?.locale) {
+    return resolveLocaleOrThrow(props.locale);
+  }
+  if (config?.locale) {
+    return resolveLocaleOrThrow(config.locale);
+  }
+  return DEFAULT_LOCALE;
 };
 var parseDateValue = (value, input, locale, strict) => {
   if (!input) {
@@ -82,11 +121,11 @@ var createFormatterParseDate = (getConfig) => {
     };
   };
 };
-var createFormatterIsValidDate = (parseDate) => {
-  return (props) => parseDate(props).isValid;
+var createFormatterIsValidDate = (parseDate2) => {
+  return (props) => parseDate2(props).isValid;
 };
 var createFormatterGetDate = (getConfig) => {
-  const parseDate = createFormatterParseDate(getConfig);
+  const parseDate2 = createFormatterParseDate(getConfig);
   return (props) => {
     const config = getConfig();
     const locale = getTargetLocale(config.locale, props);
@@ -97,7 +136,7 @@ var createFormatterGetDate = (getConfig) => {
     if (props.date === void 0) {
       return dayjs().locale(locale).format(output);
     }
-    const parsed = parseDate({
+    const parsed = parseDate2({
       date: props.date,
       input: props.input,
       locale: props.locale,
@@ -109,31 +148,49 @@ var createFormatterGetDate = (getConfig) => {
     return parsed.format(output);
   };
 };
-function assertSupportedLocale(locale) {
-  if (!isSupportedLocale(locale)) {
-    throw new Error(`Unsupported locale: ${locale}`);
+function resolveLocaleOrThrow(locale) {
+  const resolvedLocale = resolveLocale(locale);
+  if (!resolvedLocale) {
+    throw new Error(
+      `Unsupported locale: ${locale}. The package tries an exact locale match first and then falls back to the base locale.`
+    );
   }
+  return resolvedLocale;
 }
 var getSupportedLocales = () => SUPPORTED_LOCALES;
+var getDate = async (props, config) => {
+  const locale = getHelperLocale(config, props);
+  const formatter = createDateFormatter({ ...config, locale });
+  await formatter.ready;
+  return formatter.getDate(props);
+};
+var parseDate = async (props, config) => {
+  const locale = getHelperLocale(config, props);
+  const formatter = createDateFormatter({ ...config, locale });
+  await formatter.ready;
+  return formatter.parseDate(props);
+};
+var isValidDate = async (props, config) => {
+  const locale = getHelperLocale(config, props);
+  const formatter = createDateFormatter({ ...config, locale });
+  await formatter.ready;
+  return formatter.isValidDate(props);
+};
 var createDateFormatter = (config) => {
-  let currentLocale = config?.locale ?? DEFAULT_LOCALE;
-  const getConfig = () => ({
-    locale: currentLocale,
-    strict: config?.strict ?? false,
-    invalid: config?.invalid ?? DEFAULT_INVALID_DATE
-  });
+  let currentLocale = config?.locale ? resolveLocaleOrThrow(config.locale) : DEFAULT_LOCALE;
+  const getConfig = () => createResolvedConfig(currentLocale, config);
   const ready = ensureLocaleLoaded(currentLocale);
-  const parseDate = createFormatterParseDate(getConfig);
+  const parseDate2 = createFormatterParseDate(getConfig);
   return {
     getDate: createFormatterGetDate(getConfig),
-    parseDate,
-    isValidDate: createFormatterIsValidDate(parseDate),
+    parseDate: parseDate2,
+    isValidDate: createFormatterIsValidDate(parseDate2),
     getSupportedLocales,
     getCurrentLocale: () => currentLocale,
     setLocale: async (locale) => {
-      assertSupportedLocale(locale);
-      await ensureLocaleLoaded(locale);
-      currentLocale = locale;
+      const resolvedLocale = resolveLocaleOrThrow(locale);
+      await ensureLocaleLoaded(resolvedLocale);
+      currentLocale = resolvedLocale;
     },
     ready
   };
@@ -142,7 +199,12 @@ var createDateFormatter = (config) => {
 // src/browser/global.ts
 var DateKit = {
   createDateFormatter,
-  getSupportedLocales
+  getDate,
+  getSupportedLocales,
+  isSupportedLocale,
+  parseDate,
+  isValidDate,
+  resolveLocale
 };
 if (typeof window !== "undefined") {
   window.DateKit = DateKit;

package/dist/browser/global.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/date.ts","../../src/core/locales.ts","../../src/browser/global.ts"],"sourcesContent":["import customParseFormat from 'dayjs/plugin/customParseFormat.js'\nimport dayjs from 'dayjs'\nimport type { Dayjs } from 'dayjs'\n\nimport { ensureLocaleLoaded, isSupportedLocale, SUPPORTED_LOCALES, 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?: SupportedLocale\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?: 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: SupportedLocale) => 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'\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  return props?.locale ?? currentLocale\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: () => Required<DateFormatterConfig>) => {\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: () => Required<DateFormatterConfig>) => {\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 assertSupportedLocale(locale: string): asserts locale is SupportedLocale {\n  if (!isSupportedLocale(locale)) {\n    throw new Error(`Unsupported locale: ${locale}`)\n  }\n}\n\nexport const getSupportedLocales = (): readonly SupportedLocale[] => SUPPORTED_LOCALES\n\nexport const createDateFormatter = (config?: DateFormatterConfig): DateFormatter => {\n  let currentLocale = config?.locale ?? DEFAULT_LOCALE\n\n  const getConfig = (): Required<DateFormatterConfig> => ({\n    locale: currentLocale,\n    strict: config?.strict ?? false,\n    invalid: config?.invalid ?? DEFAULT_INVALID_DATE\n  })\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: SupportedLocale) => {\n      assertSupportedLocale(locale)\n      await ensureLocaleLoaded(locale)\n      currentLocale = locale\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]\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\nexport const isSupportedLocale = (locale: string): locale is SupportedLocale => {\n  return SUPPORTED_LOCALES.includes(locale as SupportedLocale)\n}\n\nexport const ensureLocaleLoaded = async (locale: SupportedLocale): Promise<void> => {\n  const load = localeLoaders[locale]\n\n  if (!load) {\n    return\n  }\n\n  await load()\n}\n","import { createDateFormatter, getSupportedLocales } from '../index.js'\n\nexport const DateKit = {\n  createDateFormatter,\n  getSupportedLocales\n}\n\ndeclare global {\n  interface Window {\n    DateKit: typeof DateKit\n  }\n}\n\nif (typeof window !== 'undefined') {\n  window.DateKit = DateKit\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/core/date.ts","../../src/core/locales.ts","../../src/browser/global.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 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 ensureLocaleLoaded = async (locale: SupportedLocale): Promise<void> => {\n  const load = localeLoaders[locale]\n\n  if (!load) {\n    return\n  }\n\n  await load()\n}\n","import {\n  createDateFormatter,\n  getDate,\n  getSupportedLocales,\n  isSupportedLocale,\n  isValidDate,\n  parseDate,\n  resolveLocale\n} from '../index.js'\n\nexport const DateKit = {\n  createDateFormatter,\n  getDate,\n  getSupportedLocales,\n  isSupportedLocale,\n  parseDate,\n  isValidDate,\n  resolveLocale\n}\n\ndeclare global {\n  interface Window {\n    DateKit: typeof DateKit\n  }\n}\n\nif (typeof window !== 'undefined') {\n  window.DateKit = DateKit\n}\n"],"mappings":"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","names":["parseDate"]}

package/dist/index.d.ts

@@ -1,10 +1,13 @@
 declare const SUPPORTED_LOCALES: readonly ["en", "es", "es-mx", "fr", "pt", "pt-br", "de", "it", "ja"];
 type SupportedLocale = (typeof SUPPORTED_LOCALES)[number];
+type LocaleInput = string;
+declare const isSupportedLocale: (locale: string) => boolean;
+declare const resolveLocale: (locale: LocaleInput) => SupportedLocale | null;
 
 type DateValue = string | number | Date;
 type DateInputOptions = {
     input?: string | readonly string[];
-    locale?: SupportedLocale;
+    locale?: LocaleInput;
     strict?: boolean;
 };
 type DateParsingOptions = DateInputOptions & {
@@ -16,7 +19,7 @@ type GetDateOptions = DateInputOptions & {
     invalid?: string;
 };
 type DateFormatterConfig = {
-    locale?: SupportedLocale;
+    locale?: LocaleInput;
     strict?: boolean;
     invalid?: string;
 };
@@ -26,7 +29,7 @@ type DateFormatter = {
     isValidDate: (props: DateParsingOptions) => boolean;
     getSupportedLocales: () => readonly SupportedLocale[];
     getCurrentLocale: () => SupportedLocale;
-    setLocale: (locale: SupportedLocale) => Promise<void>;
+    setLocale: (locale: LocaleInput) => Promise<void>;
     ready: Promise<void>;
 };
 type ParseDateSuccess = {
@@ -47,6 +50,9 @@ type ParseDateFailure = {
 };
 type ParseDateResult = ParseDateSuccess | ParseDateFailure;
 declare const getSupportedLocales: () => readonly SupportedLocale[];
+declare const getDate: (props?: GetDateOptions, config?: DateFormatterConfig) => Promise<string>;
+declare const parseDate: (props: DateParsingOptions, config?: DateFormatterConfig) => Promise<ParseDateResult>;
+declare const isValidDate: (props: DateParsingOptions, config?: DateFormatterConfig) => Promise<boolean>;
 declare const createDateFormatter: (config?: DateFormatterConfig) => DateFormatter;
 
-export { type DateFormatter, type DateFormatterConfig, type DateParsingOptions, type DateValue, type GetDateOptions, type ParseDateFailure, type ParseDateResult, type ParseDateSuccess, SUPPORTED_LOCALES, type SupportedLocale, createDateFormatter, getSupportedLocales };
+export { type DateFormatter, type DateFormatterConfig, type DateParsingOptions, type DateValue, type GetDateOptions, type LocaleInput, type ParseDateFailure, type ParseDateResult, type ParseDateSuccess, SUPPORTED_LOCALES, type SupportedLocale, createDateFormatter, getDate, getSupportedLocales, isSupportedLocale, isValidDate, parseDate, resolveLocale };

package/dist/index.js

@@ -25,8 +25,29 @@ var localeLoaders = {
   it: () => import("dayjs/locale/it.js"),
   ja: () => import("dayjs/locale/ja.js")
 };
+var normalizeLocale = (locale) => {
+  return locale.trim().toLowerCase().replace(/_/g, "-");
+};
+var asSupportedLocale = (locale) => {
+  if (!SUPPORTED_LOCALES.includes(locale)) {
+    return null;
+  }
+  return locale;
+};
 var isSupportedLocale = (locale) => {
-  return SUPPORTED_LOCALES.includes(locale);
+  return resolveLocale(locale) !== null;
+};
+var resolveLocale = (locale) => {
+  const normalizedLocale = normalizeLocale(locale);
+  const exactLocale = asSupportedLocale(normalizedLocale);
+  if (exactLocale) {
+    return exactLocale;
+  }
+  const [baseLocale] = normalizedLocale.split("-");
+  if (!baseLocale) {
+    return null;
+  }
+  return asSupportedLocale(baseLocale);
 };
 var ensureLocaleLoaded = async (locale) => {
   const load = localeLoaders[locale];
@@ -42,11 +63,29 @@ dayjs.locale("en");
 var DEFAULT_FORMAT = "YYYY-MM-DD";
 var DEFAULT_LOCALE = "en";
 var DEFAULT_INVALID_DATE = "Invalid Date";
+var DEFAULT_STRICT = true;
+var createResolvedConfig = (locale, config) => ({
+  locale,
+  strict: config?.strict ?? DEFAULT_STRICT,
+  invalid: config?.invalid ?? DEFAULT_INVALID_DATE
+});
 var getInvalidDateText = (config, props) => {
   return props?.invalid ?? config?.invalid ?? DEFAULT_INVALID_DATE;
 };
 var getTargetLocale = (currentLocale, props) => {
-  return props?.locale ?? currentLocale;
+  if (!props?.locale) {
+    return currentLocale;
+  }
+  return resolveLocaleOrThrow(props.locale);
+};
+var getHelperLocale = (config, props) => {
+  if (props?.locale) {
+    return resolveLocaleOrThrow(props.locale);
+  }
+  if (config?.locale) {
+    return resolveLocaleOrThrow(config.locale);
+  }
+  return DEFAULT_LOCALE;
 };
 var parseDateValue = (value, input, locale, strict) => {
   if (!input) {
@@ -82,11 +121,11 @@ var createFormatterParseDate = (getConfig) => {
     };
   };
 };
-var createFormatterIsValidDate = (parseDate) => {
-  return (props) => parseDate(props).isValid;
+var createFormatterIsValidDate = (parseDate2) => {
+  return (props) => parseDate2(props).isValid;
 };
 var createFormatterGetDate = (getConfig) => {
-  const parseDate = createFormatterParseDate(getConfig);
+  const parseDate2 = createFormatterParseDate(getConfig);
   return (props) => {
     const config = getConfig();
     const locale = getTargetLocale(config.locale, props);
@@ -97,7 +136,7 @@ var createFormatterGetDate = (getConfig) => {
     if (props.date === void 0) {
       return dayjs().locale(locale).format(output);
     }
-    const parsed = parseDate({
+    const parsed = parseDate2({
       date: props.date,
       input: props.input,
       locale: props.locale,
@@ -109,31 +148,49 @@ var createFormatterGetDate = (getConfig) => {
     return parsed.format(output);
   };
 };
-function assertSupportedLocale(locale) {
-  if (!isSupportedLocale(locale)) {
-    throw new Error(`Unsupported locale: ${locale}`);
+function resolveLocaleOrThrow(locale) {
+  const resolvedLocale = resolveLocale(locale);
+  if (!resolvedLocale) {
+    throw new Error(
+      `Unsupported locale: ${locale}. The package tries an exact locale match first and then falls back to the base locale.`
+    );
   }
+  return resolvedLocale;
 }
 var getSupportedLocales = () => SUPPORTED_LOCALES;
+var getDate = async (props, config) => {
+  const locale = getHelperLocale(config, props);
+  const formatter = createDateFormatter({ ...config, locale });
+  await formatter.ready;
+  return formatter.getDate(props);
+};
+var parseDate = async (props, config) => {
+  const locale = getHelperLocale(config, props);
+  const formatter = createDateFormatter({ ...config, locale });
+  await formatter.ready;
+  return formatter.parseDate(props);
+};
+var isValidDate = async (props, config) => {
+  const locale = getHelperLocale(config, props);
+  const formatter = createDateFormatter({ ...config, locale });
+  await formatter.ready;
+  return formatter.isValidDate(props);
+};
 var createDateFormatter = (config) => {
-  let currentLocale = config?.locale ?? DEFAULT_LOCALE;
-  const getConfig = () => ({
-    locale: currentLocale,
-    strict: config?.strict ?? false,
-    invalid: config?.invalid ?? DEFAULT_INVALID_DATE
-  });
+  let currentLocale = config?.locale ? resolveLocaleOrThrow(config.locale) : DEFAULT_LOCALE;
+  const getConfig = () => createResolvedConfig(currentLocale, config);
   const ready = ensureLocaleLoaded(currentLocale);
-  const parseDate = createFormatterParseDate(getConfig);
+  const parseDate2 = createFormatterParseDate(getConfig);
   return {
     getDate: createFormatterGetDate(getConfig),
-    parseDate,
-    isValidDate: createFormatterIsValidDate(parseDate),
+    parseDate: parseDate2,
+    isValidDate: createFormatterIsValidDate(parseDate2),
     getSupportedLocales,
     getCurrentLocale: () => currentLocale,
     setLocale: async (locale) => {
-      assertSupportedLocale(locale);
-      await ensureLocaleLoaded(locale);
-      currentLocale = locale;
+      const resolvedLocale = resolveLocaleOrThrow(locale);
+      await ensureLocaleLoaded(resolvedLocale);
+      currentLocale = resolvedLocale;
     },
     ready
   };
@@ -141,6 +198,11 @@ var createDateFormatter = (config) => {
 export {
   SUPPORTED_LOCALES,
   createDateFormatter,
-  getSupportedLocales
+  getDate,
+  getSupportedLocales,
+  isSupportedLocale,
+  isValidDate,
+  parseDate,
+  resolveLocale
 };
 //# sourceMappingURL=index.js.map

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, isSupportedLocale, SUPPORTED_LOCALES, 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?: SupportedLocale\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?: 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: SupportedLocale) => 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'\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  return props?.locale ?? currentLocale\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: () => Required<DateFormatterConfig>) => {\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: () => Required<DateFormatterConfig>) => {\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 assertSupportedLocale(locale: string): asserts locale is SupportedLocale {\n  if (!isSupportedLocale(locale)) {\n    throw new Error(`Unsupported locale: ${locale}`)\n  }\n}\n\nexport const getSupportedLocales = (): readonly SupportedLocale[] => SUPPORTED_LOCALES\n\nexport const createDateFormatter = (config?: DateFormatterConfig): DateFormatter => {\n  let currentLocale = config?.locale ?? DEFAULT_LOCALE\n\n  const getConfig = (): Required<DateFormatterConfig> => ({\n    locale: currentLocale,\n    strict: config?.strict ?? false,\n    invalid: config?.invalid ?? DEFAULT_INVALID_DATE\n  })\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: SupportedLocale) => {\n      assertSupportedLocale(locale)\n      await ensureLocaleLoaded(locale)\n      currentLocale = locale\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]\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\nexport const isSupportedLocale = (locale: string): locale is SupportedLocale => {\n  return SUPPORTED_LOCALES.includes(locale as SupportedLocale)\n}\n\nexport const ensureLocaleLoaded = async (locale: SupportedLocale): Promise<void> => {\n  const load = localeLoaders[locale]\n\n  if (!load) {\n    return\n  }\n\n  await load()\n}\n"],"mappings":"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","names":[]}
+{"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 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 ensureLocaleLoaded = async (locale: SupportedLocale): Promise<void> => {\n  const load = localeLoaders[locale]\n\n  if (!load) {\n    return\n  }\n\n  await load()\n}\n"],"mappings":"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","names":["parseDate"]}

package/dist/react/index.d.ts

@@ -1,4 +1,4 @@
-import { DateFormatterConfig, GetDateOptions, DateParsingOptions, ParseDateResult, SupportedLocale } from '../index.js';
+import { DateFormatterConfig, GetDateOptions, DateParsingOptions, ParseDateResult, SupportedLocale, LocaleInput } from '../index.js';
 
 type UseDateFormatterOptions = DateFormatterConfig;
 declare const useDateFormatter: (options?: UseDateFormatterOptions) => {
@@ -9,7 +9,7 @@ declare const useDateFormatter: (options?: UseDateFormatterOptions) => {
     isValidDate: (props: DateParsingOptions) => boolean;
     getSupportedLocales: () => readonly SupportedLocale[];
     ready: Promise<void>;
-    setLocale: (nextLocale: SupportedLocale) => Promise<void>;
+    setLocale: (nextLocale: LocaleInput) => Promise<void>;
 };
 
 export { type UseDateFormatterOptions, useDateFormatter };