@samline/date 2.0.0 → 2.1.0

package/README.md

@@ -45,6 +45,21 @@ const date = await getDate({
 })
 ```
 
+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
@@ -67,7 +82,7 @@ const date = formatter.getDate({
 
 ```ts
 createDateFormatter(config?: {
-  locale?: SupportedLocale
+  locale?: LocaleInput
   strict?: boolean
   invalid?: string
 }): {
@@ -76,7 +91,7 @@ createDateFormatter(config?: {
   isValidDate(props: DateParsingOptions): boolean
   getSupportedLocales(): readonly SupportedLocale[]
   getCurrentLocale(): SupportedLocale
-  setLocale(locale: SupportedLocale): Promise<void>
+  setLocale(locale: LocaleInput): Promise<void>
   ready: Promise<void>
 }
 ```
@@ -85,7 +100,9 @@ Creates a formatter instance with its own locale state. This avoids coupling fra
 
 `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:
 
@@ -97,6 +114,19 @@ 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
@@ -176,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,11 +1,13 @@
-import { DateFormatterConfig, DateFormatter, GetDateOptions, SupportedLocale, DateParsingOptions, ParseDateResult } 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];
@@ -52,10 +73,19 @@ 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) => {
-  return props?.locale ?? config?.locale ?? DEFAULT_LOCALE;
+  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) {
@@ -118,10 +148,14 @@ 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) => {
@@ -143,7 +177,7 @@ var isValidDate = async (props, config) => {
   return formatter.isValidDate(props);
 };
 var createDateFormatter = (config) => {
-  let currentLocale = config?.locale ?? DEFAULT_LOCALE;
+  let currentLocale = config?.locale ? resolveLocaleOrThrow(config.locale) : DEFAULT_LOCALE;
   const getConfig = () => createResolvedConfig(currentLocale, config);
   const ready = ensureLocaleLoaded(currentLocale);
   const parseDate2 = createFormatterParseDate(getConfig);
@@ -154,9 +188,9 @@ var createDateFormatter = (config) => {
     getSupportedLocales,
     getCurrentLocale: () => currentLocale,
     setLocale: async (locale) => {
-      assertSupportedLocale(locale);
-      await ensureLocaleLoaded(locale);
-      currentLocale = locale;
+      const resolvedLocale = resolveLocaleOrThrow(locale);
+      await ensureLocaleLoaded(resolvedLocale);
+      currentLocale = resolvedLocale;
     },
     ready
   };
@@ -167,8 +201,10 @@ var DateKit = {
   createDateFormatter,
   getDate,
   getSupportedLocales,
+  isSupportedLocale,
   parseDate,
-  isValidDate
+  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'\nconst DEFAULT_STRICT = true\n\nconst createResolvedConfig = (\n  locale: SupportedLocale,\n  config?: DateFormatterConfig\n): Required<DateFormatterConfig> => ({\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  return props?.locale ?? currentLocale\n}\n\nconst getHelperLocale = <T extends { locale?: SupportedLocale }>(\n  config?: DateFormatterConfig,\n  props?: T\n): SupportedLocale => {\n  return props?.locale ?? config?.locale ?? 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: () => 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 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 ?? DEFAULT_LOCALE\n\n  const getConfig = (): Required<DateFormatterConfig> => 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: 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, getDate, getSupportedLocales, isValidDate, parseDate } from '../index.js'\n\nexport const DateKit = {\n  createDateFormatter,\n  getDate,\n  getSupportedLocales\n  ,\n  parseDate,\n  isValidDate\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"]}
+{"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 = {
@@ -52,4 +55,4 @@ declare const parseDate: (props: DateParsingOptions, config?: DateFormatterConfi
 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, getDate, getSupportedLocales, isValidDate, parseDate };
+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];
@@ -52,10 +73,19 @@ 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) => {
-  return props?.locale ?? config?.locale ?? DEFAULT_LOCALE;
+  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) {
@@ -118,10 +148,14 @@ 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) => {
@@ -143,7 +177,7 @@ var isValidDate = async (props, config) => {
   return formatter.isValidDate(props);
 };
 var createDateFormatter = (config) => {
-  let currentLocale = config?.locale ?? DEFAULT_LOCALE;
+  let currentLocale = config?.locale ? resolveLocaleOrThrow(config.locale) : DEFAULT_LOCALE;
   const getConfig = () => createResolvedConfig(currentLocale, config);
   const ready = ensureLocaleLoaded(currentLocale);
   const parseDate2 = createFormatterParseDate(getConfig);
@@ -154,9 +188,9 @@ var createDateFormatter = (config) => {
     getSupportedLocales,
     getCurrentLocale: () => currentLocale,
     setLocale: async (locale) => {
-      assertSupportedLocale(locale);
-      await ensureLocaleLoaded(locale);
-      currentLocale = locale;
+      const resolvedLocale = resolveLocaleOrThrow(locale);
+      await ensureLocaleLoaded(resolvedLocale);
+      currentLocale = resolvedLocale;
     },
     ready
   };
@@ -166,7 +200,9 @@ export {
   createDateFormatter,
   getDate,
   getSupportedLocales,
+  isSupportedLocale,
   isValidDate,
-  parseDate
+  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'\nconst DEFAULT_STRICT = true\n\nconst createResolvedConfig = (\n  locale: SupportedLocale,\n  config?: DateFormatterConfig\n): Required<DateFormatterConfig> => ({\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  return props?.locale ?? currentLocale\n}\n\nconst getHelperLocale = <T extends { locale?: SupportedLocale }>(\n  config?: DateFormatterConfig,\n  props?: T\n): SupportedLocale => {\n  return props?.locale ?? config?.locale ?? 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: () => 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 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 ?? DEFAULT_LOCALE\n\n  const getConfig = (): Required<DateFormatterConfig> => 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: 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":["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 { 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 };

package/dist/react/index.js

@@ -28,8 +28,26 @@ var localeLoaders = {
   it: () => import("dayjs/locale/it.js"),
   ja: () => import("dayjs/locale/ja.js")
 };
-var isSupportedLocale = (locale) => {
-  return SUPPORTED_LOCALES.includes(locale);
+var normalizeLocale = (locale) => {
+  return locale.trim().toLowerCase().replace(/_/g, "-");
+};
+var asSupportedLocale = (locale) => {
+  if (!SUPPORTED_LOCALES.includes(locale)) {
+    return null;
+  }
+  return locale;
+};
+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];
@@ -55,7 +73,10 @@ 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 parseDateValue = (value, input, locale, strict) => {
   if (!input) {
@@ -118,14 +139,18 @@ 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 createDateFormatter = (config) => {
-  let currentLocale = config?.locale ?? DEFAULT_LOCALE;
+  let currentLocale = config?.locale ? resolveLocaleOrThrow(config.locale) : DEFAULT_LOCALE;
   const getConfig = () => createResolvedConfig(currentLocale, config);
   const ready = ensureLocaleLoaded(currentLocale);
   const parseDate2 = createFormatterParseDate(getConfig);
@@ -136,9 +161,9 @@ var createDateFormatter = (config) => {
     getSupportedLocales,
     getCurrentLocale: () => currentLocale,
     setLocale: async (locale) => {
-      assertSupportedLocale(locale);
-      await ensureLocaleLoaded(locale);
-      currentLocale = locale;
+      const resolvedLocale = resolveLocaleOrThrow(locale);
+      await ensureLocaleLoaded(resolvedLocale);
+      currentLocale = resolvedLocale;
     },
     ready
   };
@@ -158,7 +183,7 @@ var useDateFormatter = (options) => {
     ready: formatterRef.current.ready,
     setLocale: async (nextLocale) => {
       await formatterRef.current.setLocale(nextLocale);
-      setLocaleState(nextLocale);
+      setLocaleState(formatterRef.current.getCurrentLocale());
     }
   };
 };

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/react/index.ts","../../src/core/date.ts","../../src/core/locales.ts"],"sourcesContent":["import { useRef, useState } from 'react'\n\nimport {\n  createDateFormatter,\n  getSupportedLocales,\n  type DateFormatterConfig,\n  type DateParsingOptions,\n  type GetDateOptions,\n  type SupportedLocale\n} from '../index.js'\n\nexport type UseDateFormatterOptions = DateFormatterConfig\n\nexport const useDateFormatter = (options?: UseDateFormatterOptions) => {\n  const formatterRef = useRef(createDateFormatter(options))\n  const [locale, setLocaleState] = useState<SupportedLocale>(formatterRef.current.getCurrentLocale())\n\n  return {\n    locale,\n    currentLocale: locale,\n    getDate: (props?: GetDateOptions) => formatterRef.current.getDate(props),\n    parseDate: (props: DateParsingOptions) => formatterRef.current.parseDate(props),\n    isValidDate: (props: DateParsingOptions) => formatterRef.current.isValidDate(props),\n    getSupportedLocales,\n    ready: formatterRef.current.ready,\n    setLocale: async (nextLocale: SupportedLocale) => {\n      await formatterRef.current.setLocale(nextLocale)\n      setLocaleState(nextLocale)\n    }\n  }\n}\n","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'\nconst DEFAULT_STRICT = true\n\nconst createResolvedConfig = (\n  locale: SupportedLocale,\n  config?: DateFormatterConfig\n): Required<DateFormatterConfig> => ({\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  return props?.locale ?? currentLocale\n}\n\nconst getHelperLocale = <T extends { locale?: SupportedLocale }>(\n  config?: DateFormatterConfig,\n  props?: T\n): SupportedLocale => {\n  return props?.locale ?? config?.locale ?? 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: () => 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 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 ?? DEFAULT_LOCALE\n\n  const getConfig = (): Required<DateFormatterConfig> => 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: 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":";AAAA,SAAS,QAAQ,gBAAgB;;;ACAjC,OAAO,uBAAuB;AAC9B,OAAO,WAAW;;;ACDX,IAAM,oBAAoB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIA,IAAM,gBAA0E;AAAA,EAC9E,IAAI;AAAA,EACJ,IAAI,MAAM,OAAO,oBAAoB;AAAA,EACrC,SAAS,MAAM,OAAO,uBAAuB;AAAA,EAC7C,IAAI,MAAM,OAAO,oBAAoB;AAAA,EACrC,IAAI,MAAM,OAAO,oBAAoB;AAAA,EACrC,SAAS,MAAM,OAAO,uBAAuB;AAAA,EAC7C,IAAI,MAAM,OAAO,oBAAoB;AAAA,EACrC,IAAI,MAAM,OAAO,oBAAoB;AAAA,EACrC,IAAI,MAAM,OAAO,oBAAoB;AACvC;AAEO,IAAM,oBAAoB,CAAC,WAA8C;AAC9E,SAAO,kBAAkB,SAAS,MAAyB;AAC7D;AAEO,IAAM,qBAAqB,OAAO,WAA2C;AAClF,QAAM,OAAO,cAAc,MAAM;AAEjC,MAAI,CAAC,MAAM;AACT;AAAA,EACF;AAEA,QAAM,KAAK;AACb;;;ADhCA,MAAM,OAAO,iBAAiB;AAC9B,MAAM,OAAO,IAAI;AAwDjB,IAAM,iBAAiB;AACvB,IAAM,iBAAkC;AACxC,IAAM,uBAAuB;AAC7B,IAAM,iBAAiB;AAEvB,IAAM,uBAAuB,CAC3B,QACA,YACmC;AAAA,EACnC;AAAA,EACA,QAAQ,QAAQ,UAAU;AAAA,EAC1B,SAAS,QAAQ,WAAW;AAC9B;AAEA,IAAM,qBAAqB,CAAC,QAA8B,UAAmC;AAC3F,SAAO,OAAO,WAAW,QAAQ,WAAW;AAC9C;AAEA,IAAM,kBAAkB,CAAC,eAAgC,UAA4C;AACnG,SAAO,OAAO,UAAU;AAC1B;AASA,IAAM,iBAAiB,CACrB,OACA,OACA,QACA,WACU;AACV,MAAI,CAAC,OAAO;AACV,WAAO,MAAM,KAAK,EAAE,OAAO,MAAM;AAAA,EACnC;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,MAAM,OAAO,OAAO,QAAQ,MAAM,EAAE,OAAO,MAAM;AAAA,EAC1D;AAEA,SAAO,MAAM,OAAO,CAAC,GAAG,KAAK,GAAG,QAAQ,MAAM,EAAE,OAAO,MAAM;AAC/D;AAEA,IAAM,2BAA2B,CAAC,cAAmD;AACnF,SAAO,CAAC,UAA+C;AACrD,UAAM,SAAS,UAAU;AACzB,UAAM,SAAS,gBAAgB,OAAO,QAAQ,KAAK;AACnD,UAAM,SAAS,eAAe,MAAM,MAAM,MAAM,OAAO,QAAQ,MAAM,UAAU,OAAO,MAAM;AAE5F,QAAI,CAAC,OAAO,QAAQ,GAAG;AACrB,aAAO;AAAA,QACL,SAAS;AAAA,QACT;AAAA,QACA,MAAM;AAAA,QACN,KAAK;AAAA,QACL,WAAW;AAAA,QACX,OAAO,mBAAmB,QAAQ,KAAK;AAAA,MACzC;AAAA,IACF;AAEA,WAAO;AAAA,MACL,SAAS;AAAA,MACT;AAAA,MACA,MAAM,OAAO,OAAO;AAAA,MACpB,KAAK,OAAO,YAAY;AAAA,MACxB,WAAW,OAAO,QAAQ;AAAA,MAC1B,QAAQ,CAAC,SAAS,mBAAmB,OAAO,OAAO,MAAM;AAAA,IAC3D;AAAA,EACF;AACF;AAEA,IAAM,6BAA6B,CAACA,eAA8D;AAChG,SAAO,CAAC,UAAuCA,WAAU,KAAK,EAAE;AAClE;AAEA,IAAM,yBAAyB,CAAC,cAAmD;AACjF,QAAMA,aAAY,yBAAyB,SAAS;AAEpD,SAAO,CAAC,UAAmC;AACzC,UAAM,SAAS,UAAU;AACzB,UAAM,SAAS,gBAAgB,OAAO,QAAQ,KAAK;AACnD,UAAM,SAAS,OAAO,UAAU;AAEhC,QAAI,CAAC,OAAO;AACV,aAAO,MAAM,EAAE,OAAO,MAAM,EAAE,OAAO,cAAc;AAAA,IACrD;AAEA,QAAI,MAAM,SAAS,QAAW;AAC5B,aAAO,MAAM,EAAE,OAAO,MAAM,EAAE,OAAO,MAAM;AAAA,IAC7C;AAEA,UAAM,SAASA,WAAU;AAAA,MACvB,MAAM,MAAM;AAAA,MACZ,OAAO,MAAM;AAAA,MACb,QAAQ,MAAM;AAAA,MACd,QAAQ,MAAM;AAAA,IAChB,CAAC;AAED,QAAI,CAAC,OAAO,SAAS;AACnB,aAAO,MAAM,WAAW,OAAO;AAAA,IACjC;AAEA,WAAO,OAAO,OAAO,MAAM;AAAA,EAC7B;AACF;AAEA,SAAS,sBAAsB,QAAmD;AAChF,MAAI,CAAC,kBAAkB,MAAM,GAAG;AAC9B,UAAM,IAAI,MAAM,uBAAuB,MAAM,EAAE;AAAA,EACjD;AACF;AAEO,IAAM,sBAAsB,MAAkC;AAmC9D,IAAM,sBAAsB,CAAC,WAAgD;AAClF,MAAI,gBAAgB,QAAQ,UAAU;AAEtC,QAAM,YAAY,MAAqC,qBAAqB,eAAe,MAAM;AAEjG,QAAM,QAAQ,mBAAmB,aAAa;AAC9C,QAAMC,aAAY,yBAAyB,SAAS;AAEpD,SAAO;AAAA,IACL,SAAS,uBAAuB,SAAS;AAAA,IACzC,WAAAA;AAAA,IACA,aAAa,2BAA2BA,UAAS;AAAA,IACjD;AAAA,IACA,kBAAkB,MAAM;AAAA,IACxB,WAAW,OAAO,WAA4B;AAC5C,4BAAsB,MAAM;AAC5B,YAAM,mBAAmB,MAAM;AAC/B,sBAAgB;AAAA,IAClB;AAAA,IACA;AAAA,EACF;AACF;;;AD7NO,IAAM,mBAAmB,CAAC,YAAsC;AACrE,QAAM,eAAe,OAAO,oBAAoB,OAAO,CAAC;AACxD,QAAM,CAAC,QAAQ,cAAc,IAAI,SAA0B,aAAa,QAAQ,iBAAiB,CAAC;AAElG,SAAO;AAAA,IACL;AAAA,IACA,eAAe;AAAA,IACf,SAAS,CAAC,UAA2B,aAAa,QAAQ,QAAQ,KAAK;AAAA,IACvE,WAAW,CAAC,UAA8B,aAAa,QAAQ,UAAU,KAAK;AAAA,IAC9E,aAAa,CAAC,UAA8B,aAAa,QAAQ,YAAY,KAAK;AAAA,IAClF;AAAA,IACA,OAAO,aAAa,QAAQ;AAAA,IAC5B,WAAW,OAAO,eAAgC;AAChD,YAAM,aAAa,QAAQ,UAAU,UAAU;AAC/C,qBAAe,UAAU;AAAA,IAC3B;AAAA,EACF;AACF;","names":["parseDate","parseDate"]}
+{"version":3,"sources":["../../src/react/index.ts","../../src/core/date.ts","../../src/core/locales.ts"],"sourcesContent":["import { useRef, useState } from 'react'\n\nimport {\n  createDateFormatter,\n  getSupportedLocales,\n  type DateFormatterConfig,\n  type DateParsingOptions,\n  type GetDateOptions,\n  type LocaleInput,\n  type SupportedLocale\n} from '../index.js'\n\nexport type UseDateFormatterOptions = DateFormatterConfig\n\nexport const useDateFormatter = (options?: UseDateFormatterOptions) => {\n  const formatterRef = useRef(createDateFormatter(options))\n  const [locale, setLocaleState] = useState<SupportedLocale>(formatterRef.current.getCurrentLocale())\n\n  return {\n    locale,\n    currentLocale: locale,\n    getDate: (props?: GetDateOptions) => formatterRef.current.getDate(props),\n    parseDate: (props: DateParsingOptions) => formatterRef.current.parseDate(props),\n    isValidDate: (props: DateParsingOptions) => formatterRef.current.isValidDate(props),\n    getSupportedLocales,\n    ready: formatterRef.current.ready,\n    setLocale: async (nextLocale: LocaleInput) => {\n      await formatterRef.current.setLocale(nextLocale)\n      setLocaleState(formatterRef.current.getCurrentLocale())\n    }\n  }\n}\n","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","parseDate"]}

package/dist/svelte/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';
 import * as svelte_store from 'svelte/store';
 
 type CreateDateFormatterStoreOptions = DateFormatterConfig;
@@ -12,7 +12,7 @@ declare const createDateFormatterStore: (options?: CreateDateFormatterStoreOptio
     isValidDate: (props: DateParsingOptions) => boolean;
     getSupportedLocales: () => readonly SupportedLocale[];
     ready: Promise<void>;
-    setLocale: (nextLocale: SupportedLocale) => Promise<void>;
+    setLocale: (nextLocale: LocaleInput) => Promise<void>;
     getLocale: () => "en" | "es" | "es-mx" | "fr" | "pt" | "pt-br" | "de" | "it" | "ja";
 };
 

package/dist/svelte/index.js

@@ -28,8 +28,26 @@ var localeLoaders = {
   it: () => import("dayjs/locale/it.js"),
   ja: () => import("dayjs/locale/ja.js")
 };
-var isSupportedLocale = (locale) => {
-  return SUPPORTED_LOCALES.includes(locale);
+var normalizeLocale = (locale) => {
+  return locale.trim().toLowerCase().replace(/_/g, "-");
+};
+var asSupportedLocale = (locale) => {
+  if (!SUPPORTED_LOCALES.includes(locale)) {
+    return null;
+  }
+  return locale;
+};
+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];
@@ -55,7 +73,10 @@ 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 parseDateValue = (value, input, locale, strict) => {
   if (!input) {
@@ -118,14 +139,18 @@ 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 createDateFormatter = (config) => {
-  let currentLocale = config?.locale ?? DEFAULT_LOCALE;
+  let currentLocale = config?.locale ? resolveLocaleOrThrow(config.locale) : DEFAULT_LOCALE;
   const getConfig = () => createResolvedConfig(currentLocale, config);
   const ready = ensureLocaleLoaded(currentLocale);
   const parseDate2 = createFormatterParseDate(getConfig);
@@ -136,9 +161,9 @@ var createDateFormatter = (config) => {
     getSupportedLocales,
     getCurrentLocale: () => currentLocale,
     setLocale: async (locale) => {
-      assertSupportedLocale(locale);
-      await ensureLocaleLoaded(locale);
-      currentLocale = locale;
+      const resolvedLocale = resolveLocaleOrThrow(locale);
+      await ensureLocaleLoaded(resolvedLocale);
+      currentLocale = resolvedLocale;
     },
     ready
   };
@@ -160,7 +185,7 @@ var createDateFormatterStore = (options) => {
     ready: formatter.ready,
     setLocale: async (nextLocale) => {
       await formatter.setLocale(nextLocale);
-      locale.set(nextLocale);
+      locale.set(formatter.getCurrentLocale());
     },
     getLocale: () => get(locale)
   };

package/dist/svelte/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/svelte/index.ts","../../src/core/date.ts","../../src/core/locales.ts"],"sourcesContent":["import { get, writable } from 'svelte/store'\n\nimport {\n  createDateFormatter,\n  getSupportedLocales,\n  type DateFormatterConfig,\n  type DateParsingOptions,\n  type GetDateOptions,\n  type SupportedLocale\n} from '../index.js'\n\nexport type CreateDateFormatterStoreOptions = DateFormatterConfig\n\nexport const createDateFormatterStore = (options?: CreateDateFormatterStoreOptions) => {\n  const formatter = createDateFormatter(options)\n  const locale = writable<SupportedLocale>(formatter.getCurrentLocale())\n\n  return {\n    locale: {\n      subscribe: locale.subscribe\n    },\n    currentLocale: () => get(locale),\n    getDate: (props?: GetDateOptions) => formatter.getDate(props),\n    parseDate: (props: DateParsingOptions) => formatter.parseDate(props),\n    isValidDate: (props: DateParsingOptions) => formatter.isValidDate(props),\n    getSupportedLocales,\n    ready: formatter.ready,\n    setLocale: async (nextLocale: SupportedLocale) => {\n      await formatter.setLocale(nextLocale)\n      locale.set(nextLocale)\n    },\n    getLocale: () => get(locale)\n  }\n}\n","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'\nconst DEFAULT_STRICT = true\n\nconst createResolvedConfig = (\n  locale: SupportedLocale,\n  config?: DateFormatterConfig\n): Required<DateFormatterConfig> => ({\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  return props?.locale ?? currentLocale\n}\n\nconst getHelperLocale = <T extends { locale?: SupportedLocale }>(\n  config?: DateFormatterConfig,\n  props?: T\n): SupportedLocale => {\n  return props?.locale ?? config?.locale ?? 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: () => 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 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 ?? DEFAULT_LOCALE\n\n  const getConfig = (): Required<DateFormatterConfig> => 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: 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":["parseDate","parseDate"]}
+{"version":3,"sources":["../../src/svelte/index.ts","../../src/core/date.ts","../../src/core/locales.ts"],"sourcesContent":["import { get, writable } from 'svelte/store'\n\nimport {\n  createDateFormatter,\n  getSupportedLocales,\n  type DateFormatterConfig,\n  type DateParsingOptions,\n  type GetDateOptions,\n  type LocaleInput,\n  type SupportedLocale\n} from '../index.js'\n\nexport type CreateDateFormatterStoreOptions = DateFormatterConfig\n\nexport const createDateFormatterStore = (options?: CreateDateFormatterStoreOptions) => {\n  const formatter = createDateFormatter(options)\n  const locale = writable<SupportedLocale>(formatter.getCurrentLocale())\n\n  return {\n    locale: {\n      subscribe: locale.subscribe\n    },\n    currentLocale: () => get(locale),\n    getDate: (props?: GetDateOptions) => formatter.getDate(props),\n    parseDate: (props: DateParsingOptions) => formatter.parseDate(props),\n    isValidDate: (props: DateParsingOptions) => formatter.isValidDate(props),\n    getSupportedLocales,\n    ready: formatter.ready,\n    setLocale: async (nextLocale: LocaleInput) => {\n      await formatter.setLocale(nextLocale)\n      locale.set(formatter.getCurrentLocale())\n    },\n    getLocale: () => get(locale)\n  }\n}\n","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","parseDate"]}

package/dist/vanilla/index.d.ts

@@ -1 +1 @@
-export { DateFormatter, DateFormatterConfig, DateParsingOptions, DateValue, GetDateOptions, ParseDateFailure, ParseDateResult, ParseDateSuccess, SUPPORTED_LOCALES, SupportedLocale, createDateFormatter, getDate, getSupportedLocales, isValidDate, parseDate } from '../index.js';
+export { DateFormatter, DateFormatterConfig, DateParsingOptions, DateValue, GetDateOptions, LocaleInput, ParseDateFailure, ParseDateResult, ParseDateSuccess, SUPPORTED_LOCALES, SupportedLocale, createDateFormatter, getDate, getSupportedLocales, isSupportedLocale, isValidDate, parseDate, resolveLocale } from '../index.js';

package/dist/vanilla/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];
@@ -52,10 +73,19 @@ 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) => {
-  return props?.locale ?? config?.locale ?? DEFAULT_LOCALE;
+  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) {
@@ -118,10 +148,14 @@ 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) => {
@@ -143,7 +177,7 @@ var isValidDate = async (props, config) => {
   return formatter.isValidDate(props);
 };
 var createDateFormatter = (config) => {
-  let currentLocale = config?.locale ?? DEFAULT_LOCALE;
+  let currentLocale = config?.locale ? resolveLocaleOrThrow(config.locale) : DEFAULT_LOCALE;
   const getConfig = () => createResolvedConfig(currentLocale, config);
   const ready = ensureLocaleLoaded(currentLocale);
   const parseDate2 = createFormatterParseDate(getConfig);
@@ -154,9 +188,9 @@ var createDateFormatter = (config) => {
     getSupportedLocales,
     getCurrentLocale: () => currentLocale,
     setLocale: async (locale) => {
-      assertSupportedLocale(locale);
-      await ensureLocaleLoaded(locale);
-      currentLocale = locale;
+      const resolvedLocale = resolveLocaleOrThrow(locale);
+      await ensureLocaleLoaded(resolvedLocale);
+      currentLocale = resolvedLocale;
     },
     ready
   };
@@ -166,7 +200,9 @@ export {
   createDateFormatter,
   getDate,
   getSupportedLocales,
+  isSupportedLocale,
   isValidDate,
-  parseDate
+  parseDate,
+  resolveLocale
 };
 //# sourceMappingURL=index.js.map

package/dist/vanilla/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'\nconst DEFAULT_STRICT = true\n\nconst createResolvedConfig = (\n  locale: SupportedLocale,\n  config?: DateFormatterConfig\n): Required<DateFormatterConfig> => ({\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  return props?.locale ?? currentLocale\n}\n\nconst getHelperLocale = <T extends { locale?: SupportedLocale }>(\n  config?: DateFormatterConfig,\n  props?: T\n): SupportedLocale => {\n  return props?.locale ?? config?.locale ?? 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: () => 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 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 ?? DEFAULT_LOCALE\n\n  const getConfig = (): Required<DateFormatterConfig> => 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: 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":["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 { 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/vue/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';
 import * as vue from 'vue';
 
 type UseDateFormatterOptions = DateFormatterConfig;
@@ -10,7 +10,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 };

package/dist/vue/index.js

@@ -28,8 +28,26 @@ var localeLoaders = {
   it: () => import("dayjs/locale/it.js"),
   ja: () => import("dayjs/locale/ja.js")
 };
-var isSupportedLocale = (locale) => {
-  return SUPPORTED_LOCALES.includes(locale);
+var normalizeLocale = (locale) => {
+  return locale.trim().toLowerCase().replace(/_/g, "-");
+};
+var asSupportedLocale = (locale) => {
+  if (!SUPPORTED_LOCALES.includes(locale)) {
+    return null;
+  }
+  return locale;
+};
+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];
@@ -55,7 +73,10 @@ 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 parseDateValue = (value, input, locale, strict) => {
   if (!input) {
@@ -118,14 +139,18 @@ 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 createDateFormatter = (config) => {
-  let currentLocale = config?.locale ?? DEFAULT_LOCALE;
+  let currentLocale = config?.locale ? resolveLocaleOrThrow(config.locale) : DEFAULT_LOCALE;
   const getConfig = () => createResolvedConfig(currentLocale, config);
   const ready = ensureLocaleLoaded(currentLocale);
   const parseDate2 = createFormatterParseDate(getConfig);
@@ -136,9 +161,9 @@ var createDateFormatter = (config) => {
     getSupportedLocales,
     getCurrentLocale: () => currentLocale,
     setLocale: async (locale) => {
-      assertSupportedLocale(locale);
-      await ensureLocaleLoaded(locale);
-      currentLocale = locale;
+      const resolvedLocale = resolveLocaleOrThrow(locale);
+      await ensureLocaleLoaded(resolvedLocale);
+      currentLocale = resolvedLocale;
     },
     ready
   };
@@ -150,7 +175,7 @@ var useDateFormatter = (options) => {
   const locale = ref(formatter.getCurrentLocale());
   const setLocale = async (nextLocale) => {
     await formatter.setLocale(nextLocale);
-    locale.value = nextLocale;
+    locale.value = formatter.getCurrentLocale();
   };
   return {
     locale,

package/dist/vue/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/vue/index.ts","../../src/core/date.ts","../../src/core/locales.ts"],"sourcesContent":["import { computed, ref } from 'vue'\n\nimport {\n  createDateFormatter,\n  getSupportedLocales,\n  type DateFormatterConfig,\n  type DateParsingOptions,\n  type GetDateOptions,\n  type SupportedLocale\n} from '../index.js'\n\nexport type UseDateFormatterOptions = DateFormatterConfig\n\nexport const useDateFormatter = (options?: UseDateFormatterOptions) => {\n  const formatter = createDateFormatter(options)\n  const locale = ref<SupportedLocale>(formatter.getCurrentLocale())\n\n  const setLocale = async (nextLocale: SupportedLocale) => {\n    await formatter.setLocale(nextLocale)\n    locale.value = nextLocale\n  }\n\n  return {\n    locale,\n    currentLocale: computed(() => locale.value),\n    getDate: (props?: GetDateOptions) => formatter.getDate(props),\n    parseDate: (props: DateParsingOptions) => formatter.parseDate(props),\n    isValidDate: (props: DateParsingOptions) => formatter.isValidDate(props),\n    getSupportedLocales,\n    ready: formatter.ready,\n    setLocale\n  }\n}\n","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'\nconst DEFAULT_STRICT = true\n\nconst createResolvedConfig = (\n  locale: SupportedLocale,\n  config?: DateFormatterConfig\n): Required<DateFormatterConfig> => ({\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  return props?.locale ?? currentLocale\n}\n\nconst getHelperLocale = <T extends { locale?: SupportedLocale }>(\n  config?: DateFormatterConfig,\n  props?: T\n): SupportedLocale => {\n  return props?.locale ?? config?.locale ?? 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: () => 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 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 ?? DEFAULT_LOCALE\n\n  const getConfig = (): Required<DateFormatterConfig> => 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: 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":["parseDate","parseDate"]}
+{"version":3,"sources":["../../src/vue/index.ts","../../src/core/date.ts","../../src/core/locales.ts"],"sourcesContent":["import { computed, ref } from 'vue'\n\nimport {\n  createDateFormatter,\n  getSupportedLocales,\n  type DateFormatterConfig,\n  type DateParsingOptions,\n  type GetDateOptions,\n  type LocaleInput,\n  type SupportedLocale\n} from '../index.js'\n\nexport type UseDateFormatterOptions = DateFormatterConfig\n\nexport const useDateFormatter = (options?: UseDateFormatterOptions) => {\n  const formatter = createDateFormatter(options)\n  const locale = ref<SupportedLocale>(formatter.getCurrentLocale())\n\n  const setLocale = async (nextLocale: LocaleInput) => {\n    await formatter.setLocale(nextLocale)\n    locale.value = formatter.getCurrentLocale()\n  }\n\n  return {\n    locale,\n    currentLocale: computed(() => locale.value),\n    getDate: (props?: GetDateOptions) => formatter.getDate(props),\n    parseDate: (props: DateParsingOptions) => formatter.parseDate(props),\n    isValidDate: (props: DateParsingOptions) => formatter.isValidDate(props),\n    getSupportedLocales,\n    ready: formatter.ready,\n    setLocale\n  }\n}\n","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","parseDate"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@samline/date",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Format and localize dates with Day.js through a small multi-entrypoint API.",
   "type": "module",
   "license": "MIT",