@samline/date 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 samline
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,141 @@
+# @samline/date
+
+Small date formatting package built on top of Day.js with a shared core API, framework wrappers, 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.
+
+Repository: https://github.com/iamkun/dayjs
+
+## Features
+
+- format dates with configurable input and output patterns
+- default locale is English
+- load and switch supported locales on demand
+- create formatter instances with isolated locale state
+- enable strict parsing globally per formatter or per call
+- parse and validate dates with explicit result objects
+- use the same API from core, vanilla, React, Vue, Svelte, or browser global builds
+
+## Installation
+
+```bash
+npm install @samline/date
+```
+
+## 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 |
+
+## Quick Start
+
+```ts
+import { createDateFormatter } from '@samline/date'
+
+const formatter = createDateFormatter({ locale: 'es-mx', strict: true })
+
+await formatter.ready
+
+const date = formatter.getDate({
+  date: '23/03/2026',
+  input: 'DD/MM/YYYY',
+  output: 'MMMM D, YYYY'
+})
+```
+
+## API
+
+### createDateFormatter
+
+```ts
+createDateFormatter(config?: {
+  locale?: SupportedLocale
+  strict?: boolean
+  invalid?: string
+}): {
+  getDate(props?: GetDateOptions): string
+  parseDate(props: DateParsingOptions): ParseDateResult
+  isValidDate(props: DateParsingOptions): boolean
+  getSupportedLocales(): readonly SupportedLocale[]
+  getCurrentLocale(): SupportedLocale
+  setLocale(locale: SupportedLocale): Promise<void>
+  ready: Promise<void>
+}
+```
+
+Creates a formatter instance with its own locale state. This avoids coupling framework wrappers and utility calls to the global Day.js locale.
+
+Use `strict: true` to make parsing fail when the input does not match the provided format exactly.
+
+If you override `locale` per call, make sure that locale was already loaded by a formatter instance.
+
+The formatter instance exposes:
+
+- `getDate(props?)`
+- `parseDate(props)`
+- `isValidDate(props)`
+- `getCurrentLocale()`
+- `setLocale(locale)`
+- `getSupportedLocales()`
+- `ready`
+
+### parseDate
+
+```ts
+formatter.parseDate({
+  date: '23/03/2026',
+  input: 'DD/MM/YYYY',
+  strict: true
+})
+```
+
+Returns a structured result.
+
+- Valid parse: `isValid`, `date`, `iso`, `timestamp`, `format(output?)`
+- Invalid parse: `isValid: false`, `error`, and null date fields
+
+### isValidDate
+
+```ts
+formatter.isValidDate({
+  date: '1970-00-00',
+  input: 'YYYY-MM-DD',
+  strict: true
+})
+```
+
+Returns a boolean when you only need validation without formatting.
+
+## Supported Locales
+
+The package ships helper support for these locale keys:
+
+- `en`
+- `es`
+- `es-mx`
+- `fr`
+- `pt`
+- `pt-br`
+- `de`
+- `it`
+- `ja`
+
+Use `createDateFormatter({ locale: 'es-mx' })` when you need a locale other than English.
+
+## 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)
+
+## License
+
+MIT

package/dist/browser/global.d.ts

@@ -0,0 +1,13 @@
+import { DateFormatterConfig, DateFormatter, SupportedLocale } from '../index.js';
+
+declare const DateKit: {
+    createDateFormatter: (config?: DateFormatterConfig) => DateFormatter;
+    getSupportedLocales: () => readonly SupportedLocale[];
+};
+declare global {
+    interface Window {
+        DateKit: typeof DateKit;
+    }
+}
+
+export { DateKit };

package/dist/browser/global.js

@@ -0,0 +1,153 @@
+// src/core/date.ts
+import customParseFormat from "dayjs/plugin/customParseFormat.js";
+import dayjs from "dayjs";
+
+// src/core/locales.ts
+var SUPPORTED_LOCALES = [
+  "en",
+  "es",
+  "es-mx",
+  "fr",
+  "pt",
+  "pt-br",
+  "de",
+  "it",
+  "ja"
+];
+var localeLoaders = {
+  en: null,
+  es: () => import("dayjs/locale/es.js"),
+  "es-mx": () => import("dayjs/locale/es-mx.js"),
+  fr: () => import("dayjs/locale/fr.js"),
+  pt: () => import("dayjs/locale/pt.js"),
+  "pt-br": () => import("dayjs/locale/pt-br.js"),
+  de: () => import("dayjs/locale/de.js"),
+  it: () => import("dayjs/locale/it.js"),
+  ja: () => import("dayjs/locale/ja.js")
+};
+var isSupportedLocale = (locale) => {
+  return SUPPORTED_LOCALES.includes(locale);
+};
+var ensureLocaleLoaded = async (locale) => {
+  const load = localeLoaders[locale];
+  if (!load) {
+    return;
+  }
+  await load();
+};
+
+// src/core/date.ts
+dayjs.extend(customParseFormat);
+dayjs.locale("en");
+var DEFAULT_FORMAT = "YYYY-MM-DD";
+var DEFAULT_LOCALE = "en";
+var DEFAULT_INVALID_DATE = "Invalid Date";
+var getInvalidDateText = (config, props) => {
+  return props?.invalid ?? config?.invalid ?? DEFAULT_INVALID_DATE;
+};
+var getTargetLocale = (currentLocale, props) => {
+  return props?.locale ?? currentLocale;
+};
+var parseDateValue = (value, input, locale, strict) => {
+  if (!input) {
+    return dayjs(value).locale(locale);
+  }
+  if (typeof input === "string") {
+    return dayjs(value, input, locale, strict).locale(locale);
+  }
+  return dayjs(value, [...input], locale, strict).locale(locale);
+};
+var createFormatterParseDate = (getConfig) => {
+  return (props) => {
+    const config = getConfig();
+    const locale = getTargetLocale(config.locale, props);
+    const parsed = parseDateValue(props.date, props.input, locale, props.strict ?? config.strict);
+    if (!parsed.isValid()) {
+      return {
+        isValid: false,
+        locale,
+        date: null,
+        iso: null,
+        timestamp: null,
+        error: getInvalidDateText(config, props)
+      };
+    }
+    return {
+      isValid: true,
+      locale,
+      date: parsed.toDate(),
+      iso: parsed.toISOString(),
+      timestamp: parsed.valueOf(),
+      format: (output = DEFAULT_FORMAT) => parsed.format(output)
+    };
+  };
+};
+var createFormatterIsValidDate = (parseDate) => {
+  return (props) => parseDate(props).isValid;
+};
+var createFormatterGetDate = (getConfig) => {
+  const parseDate = createFormatterParseDate(getConfig);
+  return (props) => {
+    const config = getConfig();
+    const locale = getTargetLocale(config.locale, props);
+    const output = props?.output ?? DEFAULT_FORMAT;
+    if (!props) {
+      return dayjs().locale(locale).format(DEFAULT_FORMAT);
+    }
+    if (props.date === void 0) {
+      return dayjs().locale(locale).format(output);
+    }
+    const parsed = parseDate({
+      date: props.date,
+      input: props.input,
+      locale: props.locale,
+      strict: props.strict
+    });
+    if (!parsed.isValid) {
+      return props.invalid ?? parsed.error;
+    }
+    return parsed.format(output);
+  };
+};
+function assertSupportedLocale(locale) {
+  if (!isSupportedLocale(locale)) {
+    throw new Error(`Unsupported locale: ${locale}`);
+  }
+}
+var getSupportedLocales = () => SUPPORTED_LOCALES;
+var createDateFormatter = (config) => {
+  let currentLocale = config?.locale ?? DEFAULT_LOCALE;
+  const getConfig = () => ({
+    locale: currentLocale,
+    strict: config?.strict ?? false,
+    invalid: config?.invalid ?? DEFAULT_INVALID_DATE
+  });
+  const ready = ensureLocaleLoaded(currentLocale);
+  const parseDate = createFormatterParseDate(getConfig);
+  return {
+    getDate: createFormatterGetDate(getConfig),
+    parseDate,
+    isValidDate: createFormatterIsValidDate(parseDate),
+    getSupportedLocales,
+    getCurrentLocale: () => currentLocale,
+    setLocale: async (locale) => {
+      assertSupportedLocale(locale);
+      await ensureLocaleLoaded(locale);
+      currentLocale = locale;
+    },
+    ready
+  };
+};
+
+// src/browser/global.ts
+var DateKit = {
+  createDateFormatter,
+  getSupportedLocales
+};
+if (typeof window !== "undefined") {
+  window.DateKit = DateKit;
+}
+export {
+  DateKit
+};
+//# sourceMappingURL=global.js.map

package/dist/browser/global.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/date.ts","../../src/core/locales.ts","../../src/browser/global.ts"],"sourcesContent":["import customParseFormat from 'dayjs/plugin/customParseFormat.js'\nimport dayjs from 'dayjs'\nimport type { Dayjs } from 'dayjs'\n\nimport { ensureLocaleLoaded, isSupportedLocale, SUPPORTED_LOCALES, type SupportedLocale } from './locales.js'\n\ndayjs.extend(customParseFormat)\ndayjs.locale('en')\n\nexport type DateValue = string | number | Date\n\ntype DateInputOptions = {\n  input?: string | readonly string[]\n  locale?: SupportedLocale\n  strict?: boolean\n}\n\nexport type DateParsingOptions = DateInputOptions & {\n  date: DateValue\n}\n\nexport type GetDateOptions = DateInputOptions & {\n  date?: DateValue\n  output?: string\n  invalid?: string\n}\n\nexport type DateFormatterConfig = {\n  locale?: SupportedLocale\n  strict?: boolean\n  invalid?: string\n}\n\nexport type DateFormatter = {\n  getDate: (props?: GetDateOptions) => string\n  parseDate: (props: DateParsingOptions) => ParseDateResult\n  isValidDate: (props: DateParsingOptions) => boolean\n  getSupportedLocales: () => readonly SupportedLocale[]\n  getCurrentLocale: () => SupportedLocale\n  setLocale: (locale: SupportedLocale) => Promise<void>\n  ready: Promise<void>\n}\n\nexport type ParseDateSuccess = {\n  isValid: true\n  locale: SupportedLocale\n  date: Date\n  iso: string\n  timestamp: number\n  format: (output?: string) => string\n}\n\nexport type ParseDateFailure = {\n  isValid: false\n  locale: SupportedLocale\n  date: null\n  iso: null\n  timestamp: null\n  error: string\n}\n\nexport type ParseDateResult = ParseDateSuccess | ParseDateFailure\n\nconst DEFAULT_FORMAT = 'YYYY-MM-DD'\nconst DEFAULT_LOCALE: SupportedLocale = 'en'\nconst DEFAULT_INVALID_DATE = 'Invalid Date'\n\nconst getInvalidDateText = (config?: DateFormatterConfig, props?: GetDateOptions): string => {\n  return props?.invalid ?? config?.invalid ?? DEFAULT_INVALID_DATE\n}\n\nconst getTargetLocale = (currentLocale: SupportedLocale, props?: GetDateOptions): SupportedLocale => {\n  return props?.locale ?? currentLocale\n}\n\nconst parseDateValue = (\n  value: DateValue,\n  input: DateParsingOptions['input'],\n  locale: SupportedLocale,\n  strict: boolean\n): Dayjs => {\n  if (!input) {\n    return dayjs(value).locale(locale)\n  }\n\n  if (typeof input === 'string') {\n    return dayjs(value, input, locale, strict).locale(locale)\n  }\n\n  return dayjs(value, [...input], locale, strict).locale(locale)\n}\n\nconst createFormatterParseDate = (getConfig: () => Required<DateFormatterConfig>) => {\n  return (props: DateParsingOptions): ParseDateResult => {\n    const config = getConfig()\n    const locale = getTargetLocale(config.locale, props)\n    const parsed = parseDateValue(props.date, props.input, locale, props.strict ?? config.strict)\n\n    if (!parsed.isValid()) {\n      return {\n        isValid: false,\n        locale,\n        date: null,\n        iso: null,\n        timestamp: null,\n        error: getInvalidDateText(config, props)\n      }\n    }\n\n    return {\n      isValid: true,\n      locale,\n      date: parsed.toDate(),\n      iso: parsed.toISOString(),\n      timestamp: parsed.valueOf(),\n      format: (output = DEFAULT_FORMAT) => parsed.format(output)\n    }\n  }\n}\n\nconst createFormatterIsValidDate = (parseDate: (props: DateParsingOptions) => ParseDateResult) => {\n  return (props: DateParsingOptions): boolean => parseDate(props).isValid\n}\n\nconst createFormatterGetDate = (getConfig: () => Required<DateFormatterConfig>) => {\n  const parseDate = createFormatterParseDate(getConfig)\n\n  return (props?: GetDateOptions): string => {\n    const config = getConfig()\n    const locale = getTargetLocale(config.locale, props)\n    const output = props?.output ?? DEFAULT_FORMAT\n\n    if (!props) {\n      return dayjs().locale(locale).format(DEFAULT_FORMAT)\n    }\n\n    if (props.date === undefined) {\n      return dayjs().locale(locale).format(output)\n    }\n\n    const parsed = parseDate({\n      date: props.date,\n      input: props.input,\n      locale: props.locale,\n      strict: props.strict\n    })\n\n    if (!parsed.isValid) {\n      return props.invalid ?? parsed.error\n    }\n\n    return parsed.format(output)\n  }\n}\n\nfunction assertSupportedLocale(locale: string): asserts locale is SupportedLocale {\n  if (!isSupportedLocale(locale)) {\n    throw new Error(`Unsupported locale: ${locale}`)\n  }\n}\n\nexport const getSupportedLocales = (): readonly SupportedLocale[] => SUPPORTED_LOCALES\n\nexport const createDateFormatter = (config?: DateFormatterConfig): DateFormatter => {\n  let currentLocale = config?.locale ?? DEFAULT_LOCALE\n\n  const getConfig = (): Required<DateFormatterConfig> => ({\n    locale: currentLocale,\n    strict: config?.strict ?? false,\n    invalid: config?.invalid ?? DEFAULT_INVALID_DATE\n  })\n\n  const ready = ensureLocaleLoaded(currentLocale)\n  const parseDate = createFormatterParseDate(getConfig)\n\n  return {\n    getDate: createFormatterGetDate(getConfig),\n    parseDate,\n    isValidDate: createFormatterIsValidDate(parseDate),\n    getSupportedLocales,\n    getCurrentLocale: () => currentLocale,\n    setLocale: async (locale: SupportedLocale) => {\n      assertSupportedLocale(locale)\n      await ensureLocaleLoaded(locale)\n      currentLocale = locale\n    },\n    ready\n  }\n}\n","export const SUPPORTED_LOCALES = [\n  'en',\n  'es',\n  'es-mx',\n  'fr',\n  'pt',\n  'pt-br',\n  'de',\n  'it',\n  'ja'\n] as const\n\nexport type SupportedLocale = (typeof SUPPORTED_LOCALES)[number]\n\nconst localeLoaders: Record<SupportedLocale, (() => Promise<unknown>) | null> = {\n  en: null,\n  es: () => import('dayjs/locale/es.js'),\n  'es-mx': () => import('dayjs/locale/es-mx.js'),\n  fr: () => import('dayjs/locale/fr.js'),\n  pt: () => import('dayjs/locale/pt.js'),\n  'pt-br': () => import('dayjs/locale/pt-br.js'),\n  de: () => import('dayjs/locale/de.js'),\n  it: () => import('dayjs/locale/it.js'),\n  ja: () => import('dayjs/locale/ja.js')\n}\n\nexport const isSupportedLocale = (locale: string): locale is SupportedLocale => {\n  return SUPPORTED_LOCALES.includes(locale as SupportedLocale)\n}\n\nexport const ensureLocaleLoaded = async (locale: SupportedLocale): Promise<void> => {\n  const load = localeLoaders[locale]\n\n  if (!load) {\n    return\n  }\n\n  await load()\n}\n","import { createDateFormatter, getSupportedLocales } from '../index.js'\n\nexport const DateKit = {\n  createDateFormatter,\n  getSupportedLocales\n}\n\ndeclare global {\n  interface Window {\n    DateKit: typeof DateKit\n  }\n}\n\nif (typeof window !== 'undefined') {\n  window.DateKit = DateKit\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+declare const SUPPORTED_LOCALES: readonly ["en", "es", "es-mx", "fr", "pt", "pt-br", "de", "it", "ja"];
+type SupportedLocale = (typeof SUPPORTED_LOCALES)[number];
+
+type DateValue = string | number | Date;
+type DateInputOptions = {
+    input?: string | readonly string[];
+    locale?: SupportedLocale;
+    strict?: boolean;
+};
+type DateParsingOptions = DateInputOptions & {
+    date: DateValue;
+};
+type GetDateOptions = DateInputOptions & {
+    date?: DateValue;
+    output?: string;
+    invalid?: string;
+};
+type DateFormatterConfig = {
+    locale?: SupportedLocale;
+    strict?: boolean;
+    invalid?: string;
+};
+type DateFormatter = {
+    getDate: (props?: GetDateOptions) => string;
+    parseDate: (props: DateParsingOptions) => ParseDateResult;
+    isValidDate: (props: DateParsingOptions) => boolean;
+    getSupportedLocales: () => readonly SupportedLocale[];
+    getCurrentLocale: () => SupportedLocale;
+    setLocale: (locale: SupportedLocale) => Promise<void>;
+    ready: Promise<void>;
+};
+type ParseDateSuccess = {
+    isValid: true;
+    locale: SupportedLocale;
+    date: Date;
+    iso: string;
+    timestamp: number;
+    format: (output?: string) => string;
+};
+type ParseDateFailure = {
+    isValid: false;
+    locale: SupportedLocale;
+    date: null;
+    iso: null;
+    timestamp: null;
+    error: string;
+};
+type ParseDateResult = ParseDateSuccess | ParseDateFailure;
+declare const getSupportedLocales: () => readonly SupportedLocale[];
+declare const createDateFormatter: (config?: DateFormatterConfig) => DateFormatter;
+
+export { type DateFormatter, type DateFormatterConfig, type DateParsingOptions, type DateValue, type GetDateOptions, type ParseDateFailure, type ParseDateResult, type ParseDateSuccess, SUPPORTED_LOCALES, type SupportedLocale, createDateFormatter, getSupportedLocales };

package/dist/index.js

@@ -0,0 +1,146 @@
+// src/core/date.ts
+import customParseFormat from "dayjs/plugin/customParseFormat.js";
+import dayjs from "dayjs";
+
+// src/core/locales.ts
+var SUPPORTED_LOCALES = [
+  "en",
+  "es",
+  "es-mx",
+  "fr",
+  "pt",
+  "pt-br",
+  "de",
+  "it",
+  "ja"
+];
+var localeLoaders = {
+  en: null,
+  es: () => import("dayjs/locale/es.js"),
+  "es-mx": () => import("dayjs/locale/es-mx.js"),
+  fr: () => import("dayjs/locale/fr.js"),
+  pt: () => import("dayjs/locale/pt.js"),
+  "pt-br": () => import("dayjs/locale/pt-br.js"),
+  de: () => import("dayjs/locale/de.js"),
+  it: () => import("dayjs/locale/it.js"),
+  ja: () => import("dayjs/locale/ja.js")
+};
+var isSupportedLocale = (locale) => {
+  return SUPPORTED_LOCALES.includes(locale);
+};
+var ensureLocaleLoaded = async (locale) => {
+  const load = localeLoaders[locale];
+  if (!load) {
+    return;
+  }
+  await load();
+};
+
+// src/core/date.ts
+dayjs.extend(customParseFormat);
+dayjs.locale("en");
+var DEFAULT_FORMAT = "YYYY-MM-DD";
+var DEFAULT_LOCALE = "en";
+var DEFAULT_INVALID_DATE = "Invalid Date";
+var getInvalidDateText = (config, props) => {
+  return props?.invalid ?? config?.invalid ?? DEFAULT_INVALID_DATE;
+};
+var getTargetLocale = (currentLocale, props) => {
+  return props?.locale ?? currentLocale;
+};
+var parseDateValue = (value, input, locale, strict) => {
+  if (!input) {
+    return dayjs(value).locale(locale);
+  }
+  if (typeof input === "string") {
+    return dayjs(value, input, locale, strict).locale(locale);
+  }
+  return dayjs(value, [...input], locale, strict).locale(locale);
+};
+var createFormatterParseDate = (getConfig) => {
+  return (props) => {
+    const config = getConfig();
+    const locale = getTargetLocale(config.locale, props);
+    const parsed = parseDateValue(props.date, props.input, locale, props.strict ?? config.strict);
+    if (!parsed.isValid()) {
+      return {
+        isValid: false,
+        locale,
+        date: null,
+        iso: null,
+        timestamp: null,
+        error: getInvalidDateText(config, props)
+      };
+    }
+    return {
+      isValid: true,
+      locale,
+      date: parsed.toDate(),
+      iso: parsed.toISOString(),
+      timestamp: parsed.valueOf(),
+      format: (output = DEFAULT_FORMAT) => parsed.format(output)
+    };
+  };
+};
+var createFormatterIsValidDate = (parseDate) => {
+  return (props) => parseDate(props).isValid;
+};
+var createFormatterGetDate = (getConfig) => {
+  const parseDate = createFormatterParseDate(getConfig);
+  return (props) => {
+    const config = getConfig();
+    const locale = getTargetLocale(config.locale, props);
+    const output = props?.output ?? DEFAULT_FORMAT;
+    if (!props) {
+      return dayjs().locale(locale).format(DEFAULT_FORMAT);
+    }
+    if (props.date === void 0) {
+      return dayjs().locale(locale).format(output);
+    }
+    const parsed = parseDate({
+      date: props.date,
+      input: props.input,
+      locale: props.locale,
+      strict: props.strict
+    });
+    if (!parsed.isValid) {
+      return props.invalid ?? parsed.error;
+    }
+    return parsed.format(output);
+  };
+};
+function assertSupportedLocale(locale) {
+  if (!isSupportedLocale(locale)) {
+    throw new Error(`Unsupported locale: ${locale}`);
+  }
+}
+var getSupportedLocales = () => SUPPORTED_LOCALES;
+var createDateFormatter = (config) => {
+  let currentLocale = config?.locale ?? DEFAULT_LOCALE;
+  const getConfig = () => ({
+    locale: currentLocale,
+    strict: config?.strict ?? false,
+    invalid: config?.invalid ?? DEFAULT_INVALID_DATE
+  });
+  const ready = ensureLocaleLoaded(currentLocale);
+  const parseDate = createFormatterParseDate(getConfig);
+  return {
+    getDate: createFormatterGetDate(getConfig),
+    parseDate,
+    isValidDate: createFormatterIsValidDate(parseDate),
+    getSupportedLocales,
+    getCurrentLocale: () => currentLocale,
+    setLocale: async (locale) => {
+      assertSupportedLocale(locale);
+      await ensureLocaleLoaded(locale);
+      currentLocale = locale;
+    },
+    ready
+  };
+};
+export {
+  SUPPORTED_LOCALES,
+  createDateFormatter,
+  getSupportedLocales
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/date.ts","../src/core/locales.ts"],"sourcesContent":["import customParseFormat from 'dayjs/plugin/customParseFormat.js'\nimport dayjs from 'dayjs'\nimport type { Dayjs } from 'dayjs'\n\nimport { ensureLocaleLoaded, isSupportedLocale, SUPPORTED_LOCALES, type SupportedLocale } from './locales.js'\n\ndayjs.extend(customParseFormat)\ndayjs.locale('en')\n\nexport type DateValue = string | number | Date\n\ntype DateInputOptions = {\n  input?: string | readonly string[]\n  locale?: SupportedLocale\n  strict?: boolean\n}\n\nexport type DateParsingOptions = DateInputOptions & {\n  date: DateValue\n}\n\nexport type GetDateOptions = DateInputOptions & {\n  date?: DateValue\n  output?: string\n  invalid?: string\n}\n\nexport type DateFormatterConfig = {\n  locale?: SupportedLocale\n  strict?: boolean\n  invalid?: string\n}\n\nexport type DateFormatter = {\n  getDate: (props?: GetDateOptions) => string\n  parseDate: (props: DateParsingOptions) => ParseDateResult\n  isValidDate: (props: DateParsingOptions) => boolean\n  getSupportedLocales: () => readonly SupportedLocale[]\n  getCurrentLocale: () => SupportedLocale\n  setLocale: (locale: SupportedLocale) => Promise<void>\n  ready: Promise<void>\n}\n\nexport type ParseDateSuccess = {\n  isValid: true\n  locale: SupportedLocale\n  date: Date\n  iso: string\n  timestamp: number\n  format: (output?: string) => string\n}\n\nexport type ParseDateFailure = {\n  isValid: false\n  locale: SupportedLocale\n  date: null\n  iso: null\n  timestamp: null\n  error: string\n}\n\nexport type ParseDateResult = ParseDateSuccess | ParseDateFailure\n\nconst DEFAULT_FORMAT = 'YYYY-MM-DD'\nconst DEFAULT_LOCALE: SupportedLocale = 'en'\nconst DEFAULT_INVALID_DATE = 'Invalid Date'\n\nconst getInvalidDateText = (config?: DateFormatterConfig, props?: GetDateOptions): string => {\n  return props?.invalid ?? config?.invalid ?? DEFAULT_INVALID_DATE\n}\n\nconst getTargetLocale = (currentLocale: SupportedLocale, props?: GetDateOptions): SupportedLocale => {\n  return props?.locale ?? currentLocale\n}\n\nconst parseDateValue = (\n  value: DateValue,\n  input: DateParsingOptions['input'],\n  locale: SupportedLocale,\n  strict: boolean\n): Dayjs => {\n  if (!input) {\n    return dayjs(value).locale(locale)\n  }\n\n  if (typeof input === 'string') {\n    return dayjs(value, input, locale, strict).locale(locale)\n  }\n\n  return dayjs(value, [...input], locale, strict).locale(locale)\n}\n\nconst createFormatterParseDate = (getConfig: () => Required<DateFormatterConfig>) => {\n  return (props: DateParsingOptions): ParseDateResult => {\n    const config = getConfig()\n    const locale = getTargetLocale(config.locale, props)\n    const parsed = parseDateValue(props.date, props.input, locale, props.strict ?? config.strict)\n\n    if (!parsed.isValid()) {\n      return {\n        isValid: false,\n        locale,\n        date: null,\n        iso: null,\n        timestamp: null,\n        error: getInvalidDateText(config, props)\n      }\n    }\n\n    return {\n      isValid: true,\n      locale,\n      date: parsed.toDate(),\n      iso: parsed.toISOString(),\n      timestamp: parsed.valueOf(),\n      format: (output = DEFAULT_FORMAT) => parsed.format(output)\n    }\n  }\n}\n\nconst createFormatterIsValidDate = (parseDate: (props: DateParsingOptions) => ParseDateResult) => {\n  return (props: DateParsingOptions): boolean => parseDate(props).isValid\n}\n\nconst createFormatterGetDate = (getConfig: () => Required<DateFormatterConfig>) => {\n  const parseDate = createFormatterParseDate(getConfig)\n\n  return (props?: GetDateOptions): string => {\n    const config = getConfig()\n    const locale = getTargetLocale(config.locale, props)\n    const output = props?.output ?? DEFAULT_FORMAT\n\n    if (!props) {\n      return dayjs().locale(locale).format(DEFAULT_FORMAT)\n    }\n\n    if (props.date === undefined) {\n      return dayjs().locale(locale).format(output)\n    }\n\n    const parsed = parseDate({\n      date: props.date,\n      input: props.input,\n      locale: props.locale,\n      strict: props.strict\n    })\n\n    if (!parsed.isValid) {\n      return props.invalid ?? parsed.error\n    }\n\n    return parsed.format(output)\n  }\n}\n\nfunction assertSupportedLocale(locale: string): asserts locale is SupportedLocale {\n  if (!isSupportedLocale(locale)) {\n    throw new Error(`Unsupported locale: ${locale}`)\n  }\n}\n\nexport const getSupportedLocales = (): readonly SupportedLocale[] => SUPPORTED_LOCALES\n\nexport const createDateFormatter = (config?: DateFormatterConfig): DateFormatter => {\n  let currentLocale = config?.locale ?? DEFAULT_LOCALE\n\n  const getConfig = (): Required<DateFormatterConfig> => ({\n    locale: currentLocale,\n    strict: config?.strict ?? false,\n    invalid: config?.invalid ?? DEFAULT_INVALID_DATE\n  })\n\n  const ready = ensureLocaleLoaded(currentLocale)\n  const parseDate = createFormatterParseDate(getConfig)\n\n  return {\n    getDate: createFormatterGetDate(getConfig),\n    parseDate,\n    isValidDate: createFormatterIsValidDate(parseDate),\n    getSupportedLocales,\n    getCurrentLocale: () => currentLocale,\n    setLocale: async (locale: SupportedLocale) => {\n      assertSupportedLocale(locale)\n      await ensureLocaleLoaded(locale)\n      currentLocale = locale\n    },\n    ready\n  }\n}\n","export const SUPPORTED_LOCALES = [\n  'en',\n  'es',\n  'es-mx',\n  'fr',\n  'pt',\n  'pt-br',\n  'de',\n  'it',\n  'ja'\n] as const\n\nexport type SupportedLocale = (typeof SUPPORTED_LOCALES)[number]\n\nconst localeLoaders: Record<SupportedLocale, (() => Promise<unknown>) | null> = {\n  en: null,\n  es: () => import('dayjs/locale/es.js'),\n  'es-mx': () => import('dayjs/locale/es-mx.js'),\n  fr: () => import('dayjs/locale/fr.js'),\n  pt: () => import('dayjs/locale/pt.js'),\n  'pt-br': () => import('dayjs/locale/pt-br.js'),\n  de: () => import('dayjs/locale/de.js'),\n  it: () => import('dayjs/locale/it.js'),\n  ja: () => import('dayjs/locale/ja.js')\n}\n\nexport const isSupportedLocale = (locale: string): locale is SupportedLocale => {\n  return SUPPORTED_LOCALES.includes(locale as SupportedLocale)\n}\n\nexport const ensureLocaleLoaded = async (locale: SupportedLocale): Promise<void> => {\n  const load = localeLoaders[locale]\n\n  if (!load) {\n    return\n  }\n\n  await load()\n}\n"],"mappings":"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","names":[]}

package/dist/react/index.d.ts

@@ -0,0 +1,15 @@
+import { DateFormatterConfig, GetDateOptions, DateParsingOptions, ParseDateResult, SupportedLocale } from '../index.js';
+
+type UseDateFormatterOptions = DateFormatterConfig;
+declare const useDateFormatter: (options?: UseDateFormatterOptions) => {
+    locale: "en" | "es" | "es-mx" | "fr" | "pt" | "pt-br" | "de" | "it" | "ja";
+    currentLocale: "en" | "es" | "es-mx" | "fr" | "pt" | "pt-br" | "de" | "it" | "ja";
+    getDate: (props?: GetDateOptions) => string;
+    parseDate: (props: DateParsingOptions) => ParseDateResult;
+    isValidDate: (props: DateParsingOptions) => boolean;
+    getSupportedLocales: () => readonly SupportedLocale[];
+    ready: Promise<void>;
+    setLocale: (nextLocale: SupportedLocale) => Promise<void>;
+};
+
+export { type UseDateFormatterOptions, useDateFormatter };