Initial commit

packages/services/intl-date/.prettierignore

@@ -0,0 +1,5 @@
+*.md
+node_modules
+dist
+public
+build

packages/services/intl-date/.prettierrc

@@ -0,0 +1,13 @@
+{
+  "printWidth": 150,
+  "tabWidth": 2,
+  "endOfLine": "lf",
+  "singleQuote": true,
+  "trailingComma": "all",
+  "bracketSpacing": true,
+  "semi": true,
+  "bracketSameLine": false,
+  "jsxSingleQuote": false,
+  "arrowParens": "always",
+  "importOrderCaseSensitive": false
+}

packages/services/intl-date/Readme.md

@@ -0,0 +1,143 @@
+# [←](../../../docs/README.md) @crux-kit/intl-date
+
+Конфігурація форматів дат, парсинг, форматування
+
+## Як використовувати
+
+### Ініціалізація сервісу
+
+```ts
+import { intlDateService, EN_LOCALE, UK_LOCALE } from '@crux-kit/intl-date';
+export const IntlDate = intlDateService(
+  {
+    localeMap: {
+      en: {
+        code: "enUS",
+        locale: EN_LOCALE,
+        displayFormats: {
+          DATE: 'yyyy-MM-dd',
+          ...
+        }
+      },
+      uk: {
+        code: "uk",
+        locale: UK_LOCALE,
+      },
+    },
+    language: "uk",
+  },
+  console
+);
+```
+
+1. `localeMap` - Налаштовує локалі
+
+```ts
+    /*
+        код береться з бібліотеки date-fns
+        import { enUS } from "date-fns/locale";
+        code: enUS.code
+    */
+    code: "enUS",
+    /*
+        locale береться з бібліотеки date-fns
+        import { enUS } from "date-fns/locale";
+        locale: enUS
+    */
+    locale: EN_LOCALE,
+    /*
+        displayFormats перезаписує дефолтні формати відображення дати для конкретної мови
+    */
+    displayFormats: {
+        DATE: 'yyyy-MM-dd',
+        ...
+    }
+```
+
+2. `language` - дефолтна мова
+
+3. `displayFormat` - базовий формат відображення дати. Можна перезаписувати лише окремі поля
+
+```ts
+export default {
+  DAY_WITH_STRING_MONTH: 'dd MMMM',
+  DAY_WITH_STRING_SHORT_MONTH: 'dd MMM',
+  DATE: 'dd.MM.yyyy',
+  DATE_WITH_STRING_SHORT_MONTH: 'dd MMM yyyy',
+  DATE_WITH_STRING_MONTH: 'dd MMMM yyyy',
+  DATE_TIME: 'dd.MM.yyyy hh:mm a',
+  DATE_TIME_WITH_SECONDS: 'dd.MM.yyyy HH:mm:ss',
+  DATE_TIME_WITH_STRING_MONTH: 'dd MMMM yyyy HH:mm',
+  DATE_TIME_WITH_STRING_MONTH_WITH_SECONDS: 'dd MMMM yyyy HH:mm:ss',
+  DATE_TIME_WITH_STRING_SHORT_MONTH: 'dd MMM yyyy HH:mm',
+  DATE_TIME_WITH_STRING_SHORT_MONTH_WITH_SECONDS: 'dd MMM yyyy HH:mm:ss',
+  TIME: 'HH:mm',
+  TIME_WITH_SECONDS: 'HH:mm:ss',
+  YEAR: 'yyyy',
+  HOURS: 'HH',
+  SHORT_HOURS: 'H',
+  MINUTES: 'mm',
+  SHORT_MINUTES: 'm',
+  UNIVERSAL_ISO: 'UNIVERSAL_ISO',
+};
+```
+
+4. `sourceFormat` - базові формати, що використовуються при парсингу зовнішніх даних API, form values і тд
+
+```ts
+export default {
+  DATE: 'yyyy-MM-dd',
+  UNIVERSAL_ISO: 'UNIVERSAL_ISO',
+  TIME: 'HH:mm',
+  TIME_WITH_SECONDS: 'HH:mm:ss',
+  DATE_TIME: 'yyyy-MM-dd HH:mm',
+  DATE_TIME_WITH_SECONDS: 'yyyy-MM-dd HH:mm:ss',
+  MINUTES_WITH_SECONDS: 'mm:ss',
+};
+```
+
+### Форматування дати
+
+```ts
+const date = '2025-11-27T13:17:02.174Z';
+
+// "27 листопада 2025 13:17:02"
+IntlDate.parseSource(date, 'UNIVERSAL_ISO').formatToDisplay('DATE_TIME_WITH_STRING_MONTH_WITH_SECONDS');
+
+// "27 листопада 2025 15:17:02"
+IntlDate.parseSource(date, 'UNIVERSAL_ISO').formatToDisplay('DATE_TIME_WITH_STRING_MONTH_WITH_SECONDS', { displayLocal: true });
+```
+
+### Зміна мови
+
+```ts
+IntlDate.setLocaleGlobally('en');
+```
+
+Усі формати дати після цього підуть по новій локалі.
+Потрібно щоб локаль була у `localeMap`!!!
+
+### Додаткові можливості
+
+#### Мутація дати
+
+додати/відняти дату/час від поточної дати
+
+```ts
+const display = IntlDate.parseSource(date, 'UNIVERSAL_ISO')
+  .subtract(2, 'years')
+  .add(2, 'days')
+  .formatToDisplay('DATE_TIME_WITH_STRING_MONTH_WITH_SECONDS', {
+    displayLocal: true,
+  });
+
+type ManipulateUnit = 'years' | 'months' | 'weeks' | 'days' | 'hours' | 'minutes' | 'seconds';
+```
+
+#### Мова
+
+Попередньо налаштовані Укранська, Польська, Англійська мови
+
+```ts
+import { EN_LOCALE_CONFIG, UK_LOCALE_CONFIG, PL_LOCALE_CONFIG } from '@crux-kit/intl-date';
+```

packages/services/intl-date/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@crux-kit/intl-date",
+  "version": "1.0.0",
+  "type": "module",
+  "types": "src/index.ts",
+  "private": true,
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "format": "prettier --write ."
+  },
+  "dependencies": {
+    "@crux-kit/types": "*"
+  },
+  "devDependencies": {}
+}

packages/services/intl-date/src/constants/enums.ts

@@ -0,0 +1,114 @@
+export const INTL_DATE_DISPLAY_FORMAT = {
+  /**
+   * @example 29 December
+   */
+  DAY_WITH_STRING_MONTH: 'DAY_WITH_STRING_MONTH',
+  /**
+   * @example 29 Dec
+   */
+  DAY_WITH_STRING_SHORT_MONTH: 'DAY_WITH_STRING_SHORT_MONTH',
+  /**
+   * @example 29.12.2024
+   */
+  DATE: 'DATE',
+  /**
+   * @example 29 Dec 2024
+   */
+  DATE_WITH_STRING_SHORT_MONTH: 'DATE_WITH_STRING_SHORT_MONTH',
+  /**
+   * @example 29 December 2000
+   */
+  DATE_WITH_STRING_MONTH: 'DATE_WITH_STRING_MONTH',
+  /**
+   * @example 29.12.2024 20:30
+   */
+  DATE_TIME: 'DATE_TIME',
+  /**
+   * @example 29.12.2024 20:30:43
+   */
+  DATE_TIME_WITH_SECONDS: 'DATE_TIME_WITH_SECONDS',
+  /**
+   * @example 29 December 2024 20:30
+   */
+  DATE_TIME_WITH_STRING_MONTH: 'DATE_TIME_WITH_STRING_MONTH',
+  /**
+   * @example 29 December 2024 20:30:23
+   */
+  DATE_TIME_WITH_STRING_MONTH_WITH_SECONDS: 'DATE_TIME_WITH_STRING_MONTH_WITH_SECONDS',
+  /**
+   * @example 29 Dec 2024 20:30
+   */
+  DATE_TIME_WITH_STRING_SHORT_MONTH: 'DATE_TIME_WITH_STRING_SHORT_MONTH',
+  /**
+   * @example 29 Dec 2024 20:30:23
+   */
+  DATE_TIME_WITH_STRING_SHORT_MONTH_WITH_SECONDS: 'DATE_TIME_WITH_STRING_SHORT_MONTH_WITH_SECONDS',
+  /**
+   * @example 20:30
+   */
+  TIME: 'TIME',
+  /**
+   * @example 20:30:59
+   */
+  TIME_WITH_SECONDS: 'TIME_WITH_SECONDS',
+  /**
+   * @example 2024
+   */
+  YEAR: 'YEAR',
+  /**
+   * @example 23
+   */
+  HOURS: 'HOURS',
+  /**
+   * @example 5
+   */
+  SHORT_HOURS: 'SHORT_HOURS',
+  /**
+   * @example 04
+   */
+  MINUTES: 'MINUTES',
+  /**
+   * @example 1
+   */
+  SHORT_MINUTES: 'SHORT_MINUTES',
+  /**
+   * @example 2024-06-03T12:47:04.000000Z
+   */
+  UNIVERSAL_ISO: 'UNIVERSAL_ISO',
+} as const;
+
+export type IntlDateDisplayFormatEnum = (typeof INTL_DATE_DISPLAY_FORMAT)[keyof typeof INTL_DATE_DISPLAY_FORMAT];
+
+export const INTL_DATE_SOURCE_FORMAT = {
+  /**
+   * @example 2023-11-27
+   */
+  DATE: 'DATE',
+  /**
+   * @example 2024-06-03T12:47:04.000000Z
+   */
+  UNIVERSAL_ISO: 'UNIVERSAL_ISO',
+  /**
+   * @example 20:40
+   */
+  TIME: 'TIME',
+  /**
+   * @example 20:40:33
+   */
+  TIME_WITH_SECONDS: 'TIME_WITH_SECONDS',
+  /**
+   * @example 2023-11-27 20:40
+   */
+  DATE_TIME: 'DATE_TIME',
+  /**
+   * @example 2023-11-27 20:40:33
+   */
+  DATE_TIME_WITH_SECONDS: 'DATE_TIME_WITH_SECONDS',
+  // 40:59
+  /**
+   * @example 40:59
+   */
+  MINUTES_WITH_SECONDS: 'MINUTES_WITH_SECONDS',
+} as const;
+
+export type IntlDateSourceFormatEnum = (typeof INTL_DATE_SOURCE_FORMAT)[keyof typeof INTL_DATE_SOURCE_FORMAT];

packages/services/intl-date/src/constants/index.ts

@@ -0,0 +1,6 @@
+import SOURCE_FORMAT from './source-format';
+import UNITS_MAP from './units-map';
+
+export * from './enums';
+export * from './system-timezone';
+export { SOURCE_FORMAT, UNITS_MAP };

packages/services/intl-date/src/constants/source-format.ts

@@ -0,0 +1,9 @@
+export default {
+  DATE: 'yyyy-MM-dd',
+  UNIVERSAL_ISO: 'UNIVERSAL_ISO',
+  TIME: 'HH:mm',
+  TIME_WITH_SECONDS: 'HH:mm:ss',
+  DATE_TIME: 'yyyy-MM-dd HH:mm',
+  DATE_TIME_WITH_SECONDS: 'yyyy-MM-dd HH:mm:ss',
+  MINUTES_WITH_SECONDS: 'mm:ss',
+};

packages/services/intl-date/src/constants/system-timezone.ts

@@ -0,0 +1 @@
+export const SYSTEM_TZ = Intl.DateTimeFormat().resolvedOptions().timeZone;

packages/services/intl-date/src/constants/units-map.ts

@@ -0,0 +1,9 @@
+export default {
+  years: undefined,
+  months: undefined,
+  weeks: undefined,
+  days: undefined,
+  hours: undefined,
+  minutes: undefined,
+  seconds: undefined,
+};

packages/services/intl-date/src/index.ts

@@ -0,0 +1,9 @@
+export * from './main';
+
+/*
+ *  PREDEFINED LOCALES
+ *  Ukrainian, English, Polish
+ */
+export * from './locales/en';
+export * from './locales/uk';
+export * from './locales/pl';

packages/services/intl-date/src/lib/create-config.ts

@@ -0,0 +1,23 @@
+import type { InitIntlDateServiceConfig, IntlDateConfig } from './types';
+import { DEFAULT_CONFIG } from './default-config';
+
+export function createConfig(config?: InitIntlDateServiceConfig): IntlDateConfig {
+  if (config == null) return DEFAULT_CONFIG;
+
+  const __: IntlDateConfig = Object.assign(DEFAULT_CONFIG);
+
+  if (config.language) {
+    __.language = config.language;
+  }
+  if (config.displayFormat) {
+    __.displayFormat = Object.assign(__.displayFormat, config.displayFormat);
+  }
+  if (config.sourceFormat) {
+    __.sourceFormat = Object.assign(__.sourceFormat, config.sourceFormat);
+  }
+  if (config.localeMap) {
+    __.localeMap = Object.assign(__.localeMap, config.localeMap);
+  }
+
+  return __;
+}

packages/services/intl-date/src/lib/default-config.ts

@@ -0,0 +1,12 @@
+import { EN_LOCALE_CONFIG, EN_DISPLAY_FORMAT, EN_LANGUAGE } from '../locales/en';
+import { SOURCE_FORMAT } from '../constants';
+import type { IntlDateConfig } from './types';
+
+export const DEFAULT_CONFIG: IntlDateConfig = {
+  displayFormat: EN_DISPLAY_FORMAT,
+  language: EN_LANGUAGE,
+  sourceFormat: SOURCE_FORMAT,
+  localeMap: {
+    [EN_LANGUAGE]: EN_LOCALE_CONFIG,
+  },
+};

packages/services/intl-date/src/lib/index.ts

@@ -0,0 +1,4 @@
+export * from './default-config';
+export * from './create-config';
+export * from './language';
+export * from './types';

packages/services/intl-date/src/lib/language.ts

@@ -0,0 +1,18 @@
+import type { Locale } from 'date-fns';
+import * as locales from 'date-fns/locale';
+import type { IntlDateDisplayFormatEnum } from '../constants';
+
+export type IntlDateLocaleCode = keyof typeof locales;
+export type IntlDateLanguage = string;
+
+export type IntlDateLocaleMap = Partial<Record<IntlDateLanguage, IntlDateLocaleConfig>>;
+
+export type IntlDateLocaleConfig = {
+  code: IntlDateLocaleCode;
+  locale?: Locale;
+  displayFormats?: Partial<Record<IntlDateDisplayFormatEnum, string>>;
+};
+
+export function getLocale(lang: IntlDateLocaleCode): Locale {
+  return locales[lang];
+}

packages/services/intl-date/src/lib/types.ts

@@ -0,0 +1,54 @@
+import type { IntlDateDisplayFormatEnum, IntlDateSourceFormatEnum } from '../constants';
+import type { IntlDateLanguage, IntlDateLocaleMap } from './language.ts';
+
+export interface IntlDateConfig {
+  displayFormat: Record<IntlDateDisplayFormatEnum, string>;
+  sourceFormat: Record<IntlDateSourceFormatEnum, string>;
+  language: IntlDateLanguage;
+  localeMap: IntlDateLocaleMap;
+}
+
+export type InitIntlDateServiceConfig = {
+  displayFormat?: Partial<Record<IntlDateDisplayFormatEnum, string>>;
+  sourceFormat?: Partial<Record<IntlDateSourceFormatEnum, string>>;
+} & Partial<Omit<IntlDateConfig, 'displayFormat' | 'sourceFormat'>>;
+
+export type ManipulateUnit = 'years' | 'months' | 'weeks' | 'days' | 'hours' | 'minutes' | 'seconds';
+
+type OmitMethods = 'parseDisplay' | 'parseSource' | 'setNow' | 'setSupportedLanguages' | 'setLocaleGlobally' | 'getMonthLong' | 'getMonthShort';
+
+interface ParseOptions {
+  strict?: boolean;
+  lang?: IntlDateLanguage;
+}
+
+type DateServiceMethods = Omit<IntlDateMethods, OmitMethods>;
+
+export interface IntlDateMethods {
+  parseSource: (date: string, format: IntlDateSourceFormatEnum, options?: ParseOptions) => DateServiceMethods;
+  parseDisplay: (date: string, format: IntlDateDisplayFormatEnum, options?: ParseOptions) => DateServiceMethods;
+  formatToDisplay: (
+    format: IntlDateDisplayFormatEnum,
+    options?: {
+      displayLocal?: boolean;
+    },
+  ) => string;
+  formatToSource: (
+    format: IntlDateSourceFormatEnum,
+    options?: {
+      displayLocal?: boolean;
+    },
+  ) => string;
+  toDate: () => Date;
+  subtract: (value: number, unit: ManipulateUnit) => DateServiceMethods;
+  add: (value: number, unit: ManipulateUnit) => DateServiceMethods;
+  setNow: () => DateServiceMethods;
+  setSupportedLanguages: (supportedLanguages: IntlDateLocaleMap) => void;
+  setLocaleGlobally: (language: IntlDateLanguage) => void;
+  getMonthLong: (index: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11) => string;
+  getMonthShort: (index: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11) => string;
+}
+
+export interface IntlDateInstanceInterface extends IntlDateMethods {
+  (date: Date): IntlDateMethods;
+}

packages/services/intl-date/src/locales/en/display-format.ts

@@ -0,0 +1,29 @@
+export default {
+  DAY_WITH_STRING_MONTH: 'MMMM dd',
+  DAY_WITH_STRING_SHORT_MONTH: 'MMM dd',
+
+  DATE: 'MM.dd.yyyy',
+
+  DATE_WITH_STRING_SHORT_MONTH: 'MMM dd, yyyy',
+  DATE_WITH_STRING_MONTH: 'MMMM dd, yyyy',
+
+  DATE_TIME: 'MM.dd.yyyy hh:mm a',
+  DATE_TIME_WITH_SECONDS: 'MM.dd.yyyy HH:mm:ss',
+
+  DATE_TIME_WITH_STRING_MONTH: 'MMMM dd, yyyy HH:mm',
+  DATE_TIME_WITH_STRING_MONTH_WITH_SECONDS: 'MMMM dd, yyyy HH:mm:ss',
+
+  DATE_TIME_WITH_STRING_SHORT_MONTH: 'MMM dd, yyyy HH:mm',
+  DATE_TIME_WITH_STRING_SHORT_MONTH_WITH_SECONDS: 'MMM dd, yyyy HH:mm:ss',
+
+  TIME: 'HH:mm',
+  TIME_WITH_SECONDS: 'HH:mm:ss',
+
+  YEAR: 'yyyy',
+  HOURS: 'HH',
+  SHORT_HOURS: 'H',
+  MINUTES: 'mm',
+  SHORT_MINUTES: 'm',
+
+  UNIVERSAL_ISO: 'UNIVERSAL_ISO',
+};

packages/services/intl-date/src/locales/en/index.ts

@@ -0,0 +1,11 @@
+import EN_LANGUAGE from './language.ts';
+import EN_DISPLAY_FORMAT from './display-format.ts';
+import EN_LOCALE from './locale.ts';
+import { IntlDateLocaleConfig } from '../../lib';
+
+const EN_LOCALE_CONFIG: IntlDateLocaleConfig = {
+  code: EN_LOCALE.code as IntlDateLocaleConfig['code'],
+  locale: EN_LOCALE,
+  displayFormats: EN_DISPLAY_FORMAT,
+};
+export { EN_LANGUAGE, EN_DISPLAY_FORMAT, EN_LOCALE, EN_LOCALE_CONFIG };

packages/services/intl-date/src/locales/en/language.ts

@@ -0,0 +1 @@
+export default 'en';

packages/services/intl-date/src/locales/en/locale.ts

@@ -0,0 +1,3 @@
+import { enUS } from 'date-fns/locale';
+
+export default enUS;

packages/services/intl-date/src/locales/pl/display-format.ts

@@ -0,0 +1,21 @@
+export default {
+  DAY_WITH_STRING_MONTH: 'dd MMMM',
+  DAY_WITH_STRING_SHORT_MONTH: 'dd MMM',
+  DATE: 'dd.MM.yyyy',
+  DATE_WITH_STRING_SHORT_MONTH: 'dd MMM yyyy',
+  DATE_WITH_STRING_MONTH: 'dd MMMM yyyy',
+  DATE_TIME: 'dd.MM.yyyy HH:mm',
+  DATE_TIME_WITH_SECONDS: 'dd.MM.yyyy HH:mm:ss',
+  DATE_TIME_WITH_STRING_MONTH: 'dd MMMM yyyy HH:mm',
+  DATE_TIME_WITH_STRING_MONTH_WITH_SECONDS: 'dd MMMM yyyy HH:mm:ss',
+  DATE_TIME_WITH_STRING_SHORT_MONTH: 'dd MMM yyyy HH:mm',
+  DATE_TIME_WITH_STRING_SHORT_MONTH_WITH_SECONDS: 'dd MMM yyyy HH:mm:ss',
+  TIME: 'HH:mm',
+  TIME_WITH_SECONDS: 'HH:mm:ss',
+  YEAR: 'yyyy',
+  HOURS: 'HH',
+  SHORT_HOURS: 'H',
+  MINUTES: 'mm',
+  SHORT_MINUTES: 'm',
+  UNIVERSAL_ISO: 'UNIVERSAL_ISO',
+};

packages/services/intl-date/src/locales/pl/index.ts

@@ -0,0 +1,12 @@
+import PL_LANGUAGE from './language.ts';
+import PL_DISPLAY_FORMAT from './display-format.ts';
+import PL_LOCALE from './locale.ts';
+import { IntlDateLocaleConfig } from '../../lib';
+
+const PL_LOCALE_CONFIG: IntlDateLocaleConfig = {
+  code: PL_LOCALE.code as IntlDateLocaleConfig['code'],
+  locale: PL_LOCALE,
+  displayFormats: PL_DISPLAY_FORMAT,
+};
+
+export { PL_LOCALE_CONFIG, PL_LANGUAGE, PL_DISPLAY_FORMAT, PL_LOCALE };

packages/services/intl-date/src/locales/pl/language.ts

@@ -0,0 +1 @@
+export default 'pl';

packages/services/intl-date/src/locales/pl/locale.ts

@@ -0,0 +1,3 @@
+import { pl } from 'date-fns/locale';
+
+export default pl;

packages/services/intl-date/src/locales/uk/display-format.ts

@@ -0,0 +1,21 @@
+export default {
+  DAY_WITH_STRING_MONTH: 'dd MMMM',
+  DAY_WITH_STRING_SHORT_MONTH: 'dd MMM',
+  DATE: 'dd.MM.yyyy',
+  DATE_WITH_STRING_SHORT_MONTH: 'dd MMM yyyy',
+  DATE_WITH_STRING_MONTH: 'dd MMMM yyyy',
+  DATE_TIME: 'dd.MM.yyyy HH:mm',
+  DATE_TIME_WITH_SECONDS: 'dd.MM.yyyy HH:mm:ss',
+  DATE_TIME_WITH_STRING_MONTH: 'dd MMMM yyyy HH:mm',
+  DATE_TIME_WITH_STRING_MONTH_WITH_SECONDS: 'dd MMMM yyyy HH:mm:ss',
+  DATE_TIME_WITH_STRING_SHORT_MONTH: 'dd MMM yyyy HH:mm',
+  DATE_TIME_WITH_STRING_SHORT_MONTH_WITH_SECONDS: 'dd MMM yyyy HH:mm:ss',
+  TIME: 'HH:mm',
+  TIME_WITH_SECONDS: 'HH:mm:ss',
+  YEAR: 'yyyy',
+  HOURS: 'HH',
+  SHORT_HOURS: 'H',
+  MINUTES: 'mm',
+  SHORT_MINUTES: 'm',
+  UNIVERSAL_ISO: 'UNIVERSAL_ISO',
+};

packages/services/intl-date/src/locales/uk/index.ts

@@ -0,0 +1,12 @@
+import UK_LANGUAGE from './language.ts';
+import UK_DISPLAY_FORMAT from './display-format.ts';
+import UK_LOCALE from './locale.ts';
+import { IntlDateLocaleConfig } from '../../lib';
+
+const UK_LOCALE_CONFIG = {
+  code: UK_LOCALE.code as IntlDateLocaleConfig['code'],
+  locale: UK_LOCALE,
+  displayFormats: UK_DISPLAY_FORMAT,
+};
+
+export { UK_LOCALE_CONFIG, UK_LANGUAGE, UK_DISPLAY_FORMAT, UK_LOCALE };

packages/services/intl-date/src/locales/uk/language.ts

@@ -0,0 +1 @@
+export default 'uk';

packages/services/intl-date/src/locales/uk/locale.ts

@@ -0,0 +1,3 @@
+import { uk } from 'date-fns/locale';
+
+export default uk;

packages/services/intl-date/src/main.ts

@@ -0,0 +1,168 @@
+import { parse, add, sub, type Locale } from 'date-fns';
+import { toZonedTime, fromZonedTime, formatInTimeZone } from 'date-fns-tz';
+import { SYSTEM_TZ, UNITS_MAP, type IntlDateDisplayFormatEnum, type IntlDateSourceFormatEnum } from './constants';
+import { getLocale, createConfig } from './lib';
+import type {
+  IntlDateConfig,
+  IntlDateInstanceInterface,
+  IntlDateMethods,
+  IntlDateLocaleMap,
+  IntlDateLanguage,
+  InitIntlDateServiceConfig,
+} from './lib';
+
+class IntlDateService {
+  private _locale: Locale | undefined;
+  private _date: Date;
+  private _config: IntlDateConfig;
+  private _logger?: Console;
+
+  constructor(config: IntlDateConfig, date: Date, logger?: Console) {
+    this._config = config;
+    this._logger = logger;
+
+    const initialLang = config.localeMap[config.language];
+
+    this._locale = initialLang?.locale || (initialLang ? getLocale(initialLang.code) : undefined);
+    this._date = fromZonedTime(date, 'UTC');
+  }
+
+  _call(date: Date): this {
+    this._date = fromZonedTime(date, 'UTC');
+    return this;
+  }
+
+  public setSupportedLanguages(supportedLanguages: IntlDateLocaleMap): void {
+    this._logger?.log('Set supported languages: ', supportedLanguages);
+    this._config.localeMap = supportedLanguages;
+  }
+
+  public setLocaleGlobally(lang: IntlDateLanguage): void {
+    const language = this._config.localeMap[lang];
+
+    if (!language) {
+      this._logger?.error('Language is not supported. Add it to the supported list.');
+      return;
+    }
+
+    this._locale = language.locale ?? getLocale(language.code);
+    this._config.language = lang;
+    this._logger?.log('Set global language: ', lang);
+  }
+  private _getSourceFormat(fmt: IntlDateSourceFormatEnum): string {
+    return this._config.sourceFormat[fmt];
+  }
+  private _getDisplayFormat(fmt: IntlDateDisplayFormatEnum): string {
+    const localeFormat = this._config.localeMap[this._config.language]?.displayFormats?.[fmt];
+    if (localeFormat) return localeFormat;
+    return this._config.displayFormat[fmt];
+  }
+  private _parseDate(dateStr: string, formatStr: string, options?: { strict?: boolean; lang?: IntlDateLanguage }): Date {
+    if (formatStr === 'UNIVERSAL_ISO') {
+      return new Date(dateStr);
+    }
+
+    const locale = this._config.localeMap[options?.lang ?? this._config.language]?.locale;
+
+    const parsedLocal = parse(dateStr, formatStr, new Date(), {
+      locale: locale,
+    });
+
+    return fromZonedTime(parsedLocal, SYSTEM_TZ);
+  }
+  private _formatDate(date: Date, pattern: string, displayLocal?: boolean): string {
+    if (pattern === 'UNIVERSAL_ISO') {
+      return displayLocal ? toZonedTime(date, SYSTEM_TZ).toISOString() : date.toISOString();
+    }
+
+    if (!displayLocal) {
+      return formatInTimeZone(date, 'UTC', pattern, {
+        locale: this._locale,
+      });
+    }
+
+    return formatInTimeZone(date, SYSTEM_TZ, pattern, {
+      locale: this._locale,
+    });
+  }
+
+  public parseSource: IntlDateMethods['parseSource'] = (date, fmt, options) => {
+    this._date = this._parseDate(date, this._getSourceFormat(fmt), options);
+    return this;
+  };
+
+  public parseDisplay: IntlDateMethods['parseDisplay'] = (date, fmt, options) => {
+    this._date = this._parseDate(date, this._getDisplayFormat(fmt), options);
+    return this;
+  };
+
+  public formatToDisplay: IntlDateMethods['formatToDisplay'] = (fmt, options) => {
+    try {
+      const pattern = this._getDisplayFormat(fmt);
+      return this._formatDate(this._date, pattern, options?.displayLocal);
+    } catch {
+      return 'Invalid date';
+    }
+  };
+
+  public formatToSource: IntlDateMethods['formatToSource'] = (fmt, options) => {
+    try {
+      const pattern = this._getSourceFormat(fmt);
+      return this._formatDate(this._date, pattern, options?.displayLocal);
+    } catch {
+      return 'Invalid date';
+    }
+  };
+
+  public add: IntlDateMethods['add'] = (value, unit) => {
+    const duration = Object.assign(UNITS_MAP, { [unit]: value });
+    const result = add(this._date, duration);
+    this._date = fromZonedTime(result, 'UTC');
+    return this;
+  };
+
+  public subtract: IntlDateMethods['subtract'] = (value, unit) => {
+    const duration = Object.assign(UNITS_MAP, { [unit]: value });
+    const result = sub(this._date, duration);
+    this._date = fromZonedTime(result, 'UTC');
+    return this;
+  };
+
+  public toDate = () => this._date;
+
+  public setNow = () => {
+    this._date = fromZonedTime(new Date(), 'UTC');
+    return this;
+  };
+
+  public getMonthShort = (index: number): string => {
+    const d = new Date(Date.UTC(2020, index, 1));
+    return formatInTimeZone(d, 'UTC', 'MMM', { locale: this._locale });
+  };
+
+  public getMonthLong = (index: number): string => {
+    const d = new Date(Date.UTC(2020, index, 1));
+    return formatInTimeZone(d, 'UTC', 'MMMM', { locale: this._locale });
+  };
+}
+
+export const intlDateService = (config?: InitIntlDateServiceConfig, logger?: Console): IntlDateInstanceInterface => {
+  const instance = new IntlDateService(createConfig(config), new Date(), logger);
+
+  const methods: IntlDateMethods = {
+    parseSource: instance.parseSource.bind(instance),
+    parseDisplay: instance.parseDisplay.bind(instance),
+    formatToDisplay: instance.formatToDisplay.bind(instance),
+    formatToSource: instance.formatToSource.bind(instance),
+    toDate: instance.toDate.bind(instance),
+    subtract: instance.subtract.bind(instance),
+    add: instance.add.bind(instance),
+    setNow: instance.setNow.bind(instance),
+    setSupportedLanguages: instance.setSupportedLanguages.bind(instance),
+    setLocaleGlobally: instance.setLocaleGlobally.bind(instance),
+    getMonthShort: instance.getMonthShort.bind(instance),
+    getMonthLong: instance.getMonthLong.bind(instance),
+  };
+
+  return Object.assign((date: Date) => instance._call(date), methods);
+};

packages/services/intl-date/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2023"],
+    "skipLibCheck": true,
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "strict": true,
+    "composite": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  },
+  "include": ["src"]
+}