@samline/date 2.0.0 → 2.1.1

package/README.md

@@ -1,10 +1,10 @@
 # @samline/date
 
-Small date formatting package built on top of Day.js with a shared core API, framework wrappers, and browser usage.
+Small date formatting package built on top of Day.js with strict parsing, locale-aware formatting, and a shared API for core, vanilla, React, Vue, Svelte, and browser usage.
 
-This package uses Day.js as its date engine. We are grateful for the existence of the package and will make good use of it in this project.
+This package uses Day.js as its date engine. Thanks to the Day.js project for making that foundation available.
 
-Repository: https://github.com/iamkun/dayjs
+Day.js repository: https://github.com/iamkun/dayjs
 
 ## Features
 
@@ -16,25 +16,86 @@ Repository: https://github.com/iamkun/dayjs
 - parse and validate dates with explicit result objects
 - use the same API from core, vanilla, React, Vue, Svelte, or browser global builds
 
+## Table of Contents
+
+- [Installation](#installation)
+- [Browser and CDN](#browser-and-cdn)
+- [Entrypoints](#entrypoints)
+- [Quick Start](#quick-start)
+- [API](#api)
+- [Supported Locales](#supported-locales)
+- [Documentation](#documentation)
+- [License](#license)
+
 ## Installation
 
+Use the package manager that matches your project. The published package targets Node 20 or newer.
+
 ```bash
 npm install @samline/date
 ```
 
+```bash
+pnpm add @samline/date
+```
+
+```bash
+yarn add @samline/date
+```
+
+```bash
+bun add @samline/date
+```
+
+## Browser and CDN
+
+If your project does not use a bundler, load the browser build from a CDN. Prefer pinning a version instead of using `latest` in production.
+
+```html
+<script type="module">
+  import { DateKit } from 'https://cdn.jsdelivr.net/npm/@samline/date@2.1.1/dist/browser/global.js'
+
+  const value = await DateKit.getDate({
+    date: '23/03/2026',
+    input: 'DD/MM/YYYY',
+    output: 'MMMM D, YYYY'
+  })
+
+  console.log(value)
+  console.log(window.DateKit.resolveLocale('en-us'))
+</script>
+```
+
+You can also use unpkg:
+
+```html
+<script type="module">
+  import { DateKit } from 'https://unpkg.com/@samline/date@2.1.1/dist/browser/global.js'
+
+  console.log(await DateKit.isValidDate({
+    date: '23/03/2026',
+    input: 'DD/MM/YYYY'
+  }))
+</script>
+```
+
+The browser bundle exposes `window.DateKit` and the same shared helpers documented below.
+
 ## Entrypoints
 
-| Entrypoint | Purpose |
-| --- | --- |
-| `@samline/date` | shared core API |
-| `@samline/date/vanilla` | utility wrapper for plain TypeScript or JavaScript |
-| `@samline/date/react` | React hook |
-| `@samline/date/vue` | Vue composable |
-| `@samline/date/svelte` | Svelte store helpers |
-| `@samline/date/browser` | browser global build |
+| Entrypoint | Main API | Purpose |
+| --- | --- | --- |
+| `@samline/date` | `createDateFormatter`, `getDate`, `parseDate`, `isValidDate` | shared core API |
+| `@samline/date/vanilla` | same exports as root | utility wrapper for plain TypeScript or JavaScript |
+| `@samline/date/react` | `useDateFormatter` | React hook with scoped formatter state |
+| `@samline/date/vue` | `useDateFormatter` | Vue composable with reactive locale state |
+| `@samline/date/svelte` | `createDateFormatterStore` | Svelte store-driven formatter API |
+| `@samline/date/browser` | `DateKit` | browser global build for projects without a bundler |
 
 ## Quick Start
 
+Use the one-shot helpers when you only need a single async operation.
+
 ```ts
 import { getDate } from '@samline/date'
 
@@ -45,7 +106,7 @@ const date = await getDate({
 })
 ```
 
-For repeated work with the same locale or invalid text, create one formatter instance and reuse it:
+If you need repeated formatting, parsing, or locale changes, create one formatter instance and reuse it.
 
 ```ts
 import { createDateFormatter } from '@samline/date'
@@ -61,13 +122,42 @@ const date = formatter.getDate({
 })
 ```
 
+You can also inspect the effective locale before formatting:
+
+```ts
+import { getSupportedLocales, resolveLocale } from '@samline/date'
+
+getSupportedLocales()
+// ['en', 'es', 'es-mx', 'fr', 'pt', 'pt-br', 'de', 'it', 'ja']
+
+resolveLocale('es-mx')
+// es-mx
+
+resolveLocale('en-us')
+// en
+
+resolveLocale('zz-zz')
+// null
+```
+
 ## API
 
+The shared root entrypoint exports:
+
+- `createDateFormatter(config?)`
+- `getDate(props?, config?)`
+- `parseDate(props, config?)`
+- `isValidDate(props, config?)`
+- `getSupportedLocales()`
+- `SUPPORTED_LOCALES`
+- `resolveLocale(locale)`
+- `isSupportedLocale(locale)`
+
 ### createDateFormatter
 
 ```ts
 createDateFormatter(config?: {
-  locale?: SupportedLocale
+  locale?: LocaleInput
   strict?: boolean
   invalid?: string
 }): {
@@ -76,7 +166,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 +175,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 +189,23 @@ The formatter instance exposes:
 - `getSupportedLocales()`
 - `ready`
 
+### Locale helpers
+
+```ts
+SUPPORTED_LOCALES: readonly SupportedLocale[]
+getSupportedLocales(): readonly SupportedLocale[]
+resolveLocale(locale: LocaleInput): SupportedLocale | null
+isSupportedLocale(locale: string): boolean
+```
+
+Use `SUPPORTED_LOCALES` or `getSupportedLocales()` when you need the list of locale keys exposed by the package.
+
+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.getSupportedLocales()`, `DateKit.resolveLocale(...)`, and `DateKit.isSupportedLocale(...)`.
+
 ### One-shot helpers
 
 ```ts
@@ -107,6 +216,8 @@ isValidDate(props: DateParsingOptions, config?: DateFormatterConfig): Promise<bo
 
 Use these helpers when you only need a single operation and do not want to create a formatter instance manually.
 
+All three helpers are async because they can load locale data before running the operation.
+
 | Helper | Returns | Use it when you need |
 | --- | --- | --- |
 | `getDate(...)` | formatted string | a final display value |
@@ -135,6 +246,8 @@ const valid = await isValidDate({
 
 They load the requested locale automatically and also use `strict: true` by default.
 
+If you call `getDate()` without props, it returns the current date formatted with the default formatter settings.
+
 ### parseDate
 
 ```ts
@@ -150,6 +263,8 @@ Returns a structured result.
 - Valid parse: `isValid`, `date`, `iso`, `timestamp`, `format(output?)`
 - Invalid parse: `isValid: false`, `error`, and null date fields
 
+This makes `parseDate` the right choice when you need validation details, an ISO value, a timestamp, or deferred formatting from the same parsed input.
+
 ### isValidDate
 
 ```ts
@@ -164,7 +279,7 @@ Returns a boolean when you only need validation without formatting.
 
 ## Supported Locales
 
-The package ships helper support for these locale keys:
+The package ships helper support for these locale keys through `SUPPORTED_LOCALES` and `getSupportedLocales()`:
 
 - `en`
 - `es`
@@ -176,15 +291,31 @@ 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
 
-- [docs/vanilla.md](docs/vanilla.md)
-- [docs/browser.md](docs/browser.md)
-- [docs/react.md](docs/react.md)
-- [docs/vue.md](docs/vue.md)
-- [docs/svelte.md](docs/svelte.md)
+- [docs/vanilla.md](docs/vanilla.md) for the shared API in plain TypeScript or JavaScript
+- [docs/browser.md](docs/browser.md) for browser-only usage without a bundler
+- [docs/react.md](docs/react.md) for the React hook entrypoint
+- [docs/vue.md](docs/vue.md) for the Vue composable entrypoint
+- [docs/svelte.md](docs/svelte.md) for the Svelte store entrypoint
 
 ## License
 

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"]}