@alexstukovnikov/oz-time 1.0.0

package/README.md

@@ -0,0 +1,567 @@
+# OzTime
+
+JavaScript-библиотека для работы с датой и временем.
+
+`OzTime` предоставляет неизменяемые объекты времени, фабричные функции создания экземпляров, арифметику по фиксированным и календарным единицам, сравнение, форматирование, работу с часовыми поясами, интервалы и длительности.
+
+[Полная документация API](https://AlexStukovnikov.github.io/oz-time/)
+
+## Содержание
+
+- [Почему OzTime](#почему-oztime)
+- [Возможности](#возможности)
+- [Установка](#установка)
+- [Быстрый старт](#быстрый-старт)
+- [Что использовать в каком случае](#что-использовать-в-каком-случае)
+- [Создание экземпляров](#создание-экземпляров)
+- [Арифметика](#арифметика)
+- [Сравнение](#сравнение)
+- [Форматирование](#форматирование)
+- [Часовые пояса](#часовые-пояса)
+- [Интервалы](#интервалы)
+- [Длительности](#длительности)
+- [Поддерживаемые единицы времени](#поддерживаемые-единицы-времени)
+- [Токены форматирования](#токены-форматирования)
+- [Публичный API](#публичный-api)
+- [FAQ](#faq)
+- [Разработка](#разработка)
+- [Генерация документации](#генерация-документации)
+- [Ограничения и особенности](#ограничения-и-особенности)
+- [Лицензия](#лицензия)
+
+## Почему OzTime
+
+`OzTime` подойдёт, если нужна небольшая и понятная библиотека без перегруженного API.
+
+Основные идеи:
+
+- время хранится как Unix timestamp в миллисекундах;
+- экземпляры `OzTime` неизменяемы;
+- часовой пояс и локаль сохраняются как часть объекта;
+- арифметика, сравнение и форматирование работают через единый API.
+
+Библиотека хорошо подходит для:
+
+- прикладных JavaScript-проектов;
+- учебных и дипломных проектов;
+- небольших библиотек и утилит;
+- кода, где важна предсказуемость и неизменяемость.
+
+## Возможности
+
+- Неизменяемые экземпляры `OzTime`
+- Фабричные функции:
+    - `now`
+    - `fromTimestamp`
+    - `fromDate`
+    - `fromISO`
+    - `fromComponents`
+- Арифметика по времени:
+    - `add`
+    - `subtract`
+- Сравнение:
+    - `isSame`
+    - `isBefore`
+    - `isAfter`
+    - `isBetween`
+- Форматирование по шаблону
+- Работа с часовыми поясами:
+    - `setTimezone`
+    - `getTimezoneOffset`
+- Интервалы:
+    - `Interval`
+    - `interval`
+- Длительности:
+    - `Duration`
+    - `duration`
+- Календарные утилиты:
+    - `isLeapYear`
+    - `daysInMonth`
+
+## Установка
+
+### Как зависимость проекта
+
+```bash
+npm install @alexstukovnikov/oz-time
+```
+
+### Для локальной разработки
+
+```bash
+npm install
+```
+
+## Быстрый старт
+
+```js
+import { now, fromISO, duration, interval } from '@alexstukovnikov/oz-time';
+
+const current = now('Europe/Moscow', 'ru-RU');
+const release = fromISO('2024-05-25T12:00:00Z', 'UTC', 'ru-RU');
+
+const nextWeek = release.add(7, 'day');
+const diffHours = nextWeek.diff(release, 'hour');
+
+console.log(current.getTimezone()); // ожидаемый результат: Europe/Moscow
+console.log(nextWeek.format('DD.MM.YYYY HH:mm')); // ожидаемый результат: 01.06.2024 12:00
+console.log(diffHours); // ожидаемый результат: 168
+
+const range = interval(release, nextWeek);
+console.log(range.contains(release)); // ожидаемый результат: true
+
+const oneHour = duration(1, 'hour');
+console.log(oneHour.asMinutes()); // ожидаемый результат: 60
+```
+
+## Что использовать в каком случае
+
+| Сценарий                                  | Что использовать                        | Почему                                                                               |
+| ----------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------ |
+| Нужен текущий момент времени              | `now()`                                 | Самый простой способ получить новый экземпляр `OzTime` для текущего момента.         |
+| Есть Unix timestamp в миллисекундах       | `fromTimestamp()`                       | Подходит для работы с временем из API, БД и системных источников.                    |
+| Есть нативный `Date`                      | `fromDate()`                            | Удобно интегрировать библиотеку в существующий код на JavaScript.                    |
+| Есть ISO-строка                           | `fromISO()`                             | Лучший вариант для внешних API и сериализованных значений времени.                   |
+| Нужно создать дату вручную из компонентов | `fromComponents()`                      | Подходит, когда год, месяц, день и время приходят по отдельности.                    |
+| Нужно прибавить или вычесть время         | `add()` / `subtract()`                  | Возвращают новый экземпляр и не изменяют исходный объект.                            |
+| Нужно сравнить два значения               | `isSame()` / `isBefore()` / `isAfter()` | Дают читаемый API для логики сравнения.                                              |
+| Нужно проверить попадание в диапазон      | `isBetween()`                           | Удобнее, чем писать проверку вручную.                                                |
+| Нужно получить красивую строку            | `format()`                              | Форматирование по шаблону с токенами.                                                |
+| Нужно изменить отображаемый часовой пояс  | `setTimezone()`                         | Меняет timezone у нового экземпляра, не меняя абсолютный момент времени.             |
+| Нужно узнать смещение UTC                 | `getTimezoneOffset()`                   | Полезно для отображения, отладки и расчётов.                                         |
+| Нужно описать диапазон времени            | `Interval` / `interval()`               | Подходит для проверки попадания, пересечений и длительности интервала.               |
+| Нужно описать фиксированную длительность  | `Duration` / `duration()`               | Удобно для преобразования между миллисекундами, секундами, минутами, часами и днями. |
+| Нужно проверить високосный год            | `isLeapYear()`                          | Простая календарная утилита.                                                         |
+| Нужно узнать число дней в месяце          | `daysInMonth()`                         | Удобно для валидации и генерации дат.                                                |
+
+## Создание экземпляров
+
+### `now(timezone?, locale?)`
+
+Создаёт экземпляр `OzTime` для текущего момента времени.
+
+```js
+import { now } from '@alexstukovnikov/oz-time';
+
+const current = now('Europe/Moscow', 'ru-RU');
+console.log(current.getTimezone()); // ожидаемый результат: Europe/Moscow
+```
+
+### `fromTimestamp(timestamp, timezone?, locale?)`
+
+Создаёт экземпляр из Unix timestamp в миллисекундах.
+
+```js
+import { fromTimestamp } from '@alexstukovnikov/oz-time';
+
+const time = fromTimestamp(1716638400000, 'UTC', 'ru-RU');
+console.log(time.toISOString()); // ожидаемый результат: 2024-05-25T12:00:00.000Z
+```
+
+### `fromDate(date, timezone?, locale?)`
+
+Создаёт экземпляр из объекта `Date`.
+
+```js
+import { fromDate } from '@alexstukovnikov/oz-time';
+
+const time = fromDate(new Date('2024-05-25T12:00:00Z'), 'UTC', 'ru-RU');
+console.log(time.toTimestamp()); // ожидаемый результат: 1716638400000
+```
+
+### `fromISO(isoString, timezone?, locale?)`
+
+Создаёт экземпляр из ISO-строки.
+
+```js
+import { fromISO } from '@alexstukovnikov/oz-time';
+
+const time = fromISO('2024-05-25T12:00:00Z', 'UTC', 'ru-RU');
+console.log(time.format('DD.MM.YYYY HH:mm')); // ожидаемый результат: 25.05.2024 12:00
+```
+
+### `fromComponents(year, month, day, hour?, minute?, second?, ms?, timezone?, locale?)`
+
+Создаёт экземпляр из отдельных компонентов даты и времени.
+
+```js
+import { fromComponents } from '@alexstukovnikov/oz-time';
+
+const time = fromComponents(2024, 5, 25, 12, 0, 0, 0, 'UTC', 'ru-RU');
+console.log(time.toISOString()); // ожидаемый результат: 2024-05-25T12:00:00.000Z
+```
+
+## Арифметика
+
+Все арифметические операции возвращают новый экземпляр `OzTime` и не изменяют исходный объект.
+
+### Добавление времени
+
+```js
+import { fromISO } from '@alexstukovnikov/oz-time';
+
+const time = fromISO('2024-05-25T12:00:00Z');
+const result = time.add(1, 'day');
+
+console.log(result.toISOString()); // ожидаемый результат: 2024-05-26T12:00:00.000Z
+```
+
+### Вычитание времени
+
+```js
+import { fromISO } from '@alexstukovnikov/oz-time';
+
+const time = fromISO('2024-05-25T12:00:00Z');
+const result = time.subtract(2, 'hour');
+
+console.log(result.toISOString()); // ожидаемый результат: 2024-05-25T10:00:00.000Z
+```
+
+### Разница между датами
+
+```js
+import { fromISO } from '@alexstukovnikov/oz-time';
+
+const start = fromISO('2024-05-25T12:00:00Z');
+const end = fromISO('2024-05-25T15:00:00Z');
+
+console.log(end.diff(start, 'hour')); // ожидаемый результат: 3
+```
+
+### Календарная арифметика
+
+```js
+import { fromISO } from '@alexstukovnikov/oz-time';
+
+const date = fromISO('2024-01-31T00:00:00Z');
+const result = date.add(1, 'month');
+
+console.log(result.toISOString()); // ожидаемый результат: 2024-02-29T00:00:00.000Z
+```
+
+## Сравнение
+
+### `isSame`
+
+```js
+import { fromISO } from '@alexstukovnikov/oz-time';
+
+const a = fromISO('2024-05-25T12:00:00.100Z');
+const b = fromISO('2024-05-25T12:00:00.900Z');
+
+console.log(a.isSame(b, 'second')); // ожидаемый результат: true
+```
+
+### `isBefore`
+
+```js
+import { fromISO } from '@alexstukovnikov/oz-time';
+
+const a = fromISO('2024-05-25T12:00:00Z');
+const b = fromISO('2024-05-26T12:00:00Z');
+
+console.log(a.isBefore(b)); // ожидаемый результат: true
+```
+
+### `isAfter`
+
+```js
+import { fromISO } from '@alexstukovnikov/oz-time';
+
+const a = fromISO('2024-05-26T12:00:00Z');
+const b = fromISO('2024-05-25T12:00:00Z');
+
+console.log(a.isAfter(b)); // ожидаемый результат: true
+```
+
+### `isBetween`
+
+```js
+import { fromISO } from '@alexstukovnikov/oz-time';
+
+const target = fromISO('2024-05-25T12:00:00Z');
+const start = fromISO('2024-05-25T10:00:00Z');
+const end = fromISO('2024-05-25T14:00:00Z');
+
+console.log(target.isBetween(start, end)); // ожидаемый результат: true
+```
+
+## Форматирование
+
+Функция `format()` и метод `OzTime#format()` поддерживают шаблоны.
+
+```js
+import { fromISO } from '@alexstukovnikov/oz-time';
+
+const time = fromISO('2024-05-25T12:00:00Z', 'UTC', 'ru-RU');
+
+console.log(time.format('DD.MM.YYYY HH:mm')); // ожидаемый результат: 25.05.2024 12:00
+console.log(time.format('dddd, D MMMM YYYY', 'ru-RU')); // пример: суббота, 25 мая 2024
+```
+
+## Часовые пояса
+
+`OzTime` хранит абсолютное время как timestamp, а часовой пояс используется как метаданные для отображения и форматирования.
+
+### Смена часового пояса
+
+```js
+import { fromISO } from '@alexstukovnikov/oz-time';
+
+const time = fromISO('2024-05-25T12:00:00Z', 'UTC', 'ru-RU');
+const moscow = time.setTimezone('Europe/Moscow');
+
+console.log(moscow.getTimezone()); // ожидаемый результат: Europe/Moscow
+```
+
+### Смещение относительно UTC
+
+```js
+import { fromISO } from '@alexstukovnikov/oz-time';
+
+const time = fromISO('2024-05-25T12:00:00Z', 'Europe/Moscow', 'ru-RU');
+console.log(time.getTimezoneOffset()); // ожидаемый результат: 180
+```
+
+## Интервалы
+
+Интервал представляет диапазон между двумя экземплярами `OzTime`, включая границы.
+
+```js
+import { interval, fromISO } from '@alexstukovnikov/oz-time';
+
+const start = fromISO('2024-05-25T10:00:00Z');
+const end = fromISO('2024-05-25T12:00:00Z');
+const range = interval(start, end);
+
+console.log(range.contains(fromISO('2024-05-25T11:00:00Z'))); // ожидаемый результат: true
+console.log(range.duration('hour')); // ожидаемый результат: 2
+```
+
+### Пересечение интервалов
+
+```js
+import { Interval, fromISO } from '@alexstukovnikov/oz-time';
+
+const a = new Interval(fromISO('2024-05-25T10:00:00Z'), fromISO('2024-05-25T12:00:00Z'));
+
+const b = new Interval(fromISO('2024-05-25T11:00:00Z'), fromISO('2024-05-25T13:00:00Z'));
+
+console.log(a.overlaps(b)); // ожидаемый результат: true
+```
+
+## Длительности
+
+`Duration` используется для работы с фиксированными единицами времени.
+
+```js
+import { duration } from '@alexstukovnikov/oz-time';
+
+const twoHours = duration(2, 'hour');
+
+console.log(twoHours.asMilliseconds()); // ожидаемый результат: 7200000
+console.log(twoHours.asMinutes()); // ожидаемый результат: 120
+console.log(twoHours.asHours()); // ожидаемый результат: 2
+```
+
+### Сложение длительностей
+
+```js
+import { duration } from '@alexstukovnikov/oz-time';
+
+const a = duration(30, 'minute');
+const b = duration(45, 'minute');
+
+console.log(a.add(b).asMinutes()); // ожидаемый результат: 75
+```
+
+## Поддерживаемые единицы времени
+
+Поддерживаются канонические имена и алиасы.
+
+| Единица      | Каноническое имя | Алиасы               |
+| ------------ | ---------------- | -------------------- |
+| Миллисекунда | `millisecond`    | `milliseconds`, `ms` |
+| Секунда      | `second`         | `seconds`, `s`       |
+| Минута       | `minute`         | `minutes`, `m`       |
+| Час          | `hour`           | `hours`, `h`         |
+| День         | `day`            | `days`, `d`          |
+| Месяц        | `month`          | `months`             |
+| Год          | `year`           | `years`, `y`         |
+
+Фиксированные единицы:
+
+- `millisecond`
+- `second`
+- `minute`
+- `hour`
+- `day`
+
+Календарные единицы:
+
+- `month`
+- `year`
+
+## Токены форматирования
+
+| Токен  | Описание                           | Пример        |
+| ------ | ---------------------------------- | ------------- |
+| `YYYY` | Год из 4 цифр                      | `2024`        |
+| `YY`   | Короткий год                       | `24`          |
+| `MMMM` | Полное название месяца             | `май` / `May` |
+| `MMM`  | Короткое название месяца           | `мая` / `May` |
+| `MM`   | Месяц с ведущим нулём              | `05`          |
+| `M`    | Месяц без ведущего нуля            | `5`           |
+| `dddd` | Полное название дня недели         | `суббота`     |
+| `ddd`  | Короткое название дня недели       | `сб`          |
+| `DD`   | День месяца с ведущим нулём        | `25`          |
+| `D`    | День месяца без ведущего нуля      | `25`          |
+| `HH`   | Часы в 24-часовом формате          | `09`, `18`    |
+| `H`    | Часы в 24-часовом формате без нуля | `9`, `18`     |
+| `hh`   | Часы в 12-часовом формате          | `01`, `12`    |
+| `h`    | Часы в 12-часовом формате без нуля | `1`, `12`     |
+| `mm`   | Минуты                             | `07`          |
+| `ss`   | Секунды                            | `05`          |
+| `SSS`  | Миллисекунды                       | `123`         |
+| `A`    | AM/PM                              | `AM`, `PM`    |
+
+## Публичный API
+
+### Core
+
+- `OzTime`
+- `now`
+- `fromTimestamp`
+- `fromDate`
+- `fromISO`
+- `fromComponents`
+
+### Арифметика и сравнение
+
+- `add`
+- `subtract`
+- `isSame`
+- `isBefore`
+- `isAfter`
+- `isBetween`
+
+### Форматирование и часовые пояса
+
+- `format`
+- `setTimezone`
+- `getTimezoneOffset`
+
+### Интервалы и длительности
+
+- `Interval`
+- `interval`
+- `Duration`
+- `duration`
+
+### Календарные утилиты
+
+- `isLeapYear`
+- `daysInMonth`
+
+## FAQ
+
+### Чем `fromISO()` отличается от `fromTimestamp()`?
+
+`fromISO()` принимает строку в формате ISO 8601 и сначала парсит её, а `fromTimestamp()` принимает уже готовое число миллисекунд. Если данные приходят из JSON API как строка, чаще удобнее `fromISO()`. Если уже есть timestamp из базы, системы или вычислений, лучше использовать `fromTimestamp()`.
+
+### Меняет ли `setTimezone()` сам момент времени?
+
+Нет. `setTimezone()` не меняет абсолютный момент времени. Он возвращает новый экземпляр с тем же timestamp, но с другим часовым поясом для форматирования и вычисления смещения.
+
+### Изменяют ли методы `add()` и `subtract()` текущий объект?
+
+Нет. `OzTime` построен как неизменяемый объект. Все операции возвращают новый экземпляр, а исходный объект остаётся без изменений.
+
+### Почему `Duration` не поддерживает `month` и `year`?
+
+Потому что `Duration` предназначен только для фиксированных единиц времени, которые можно точно перевести в миллисекунды. Месяцы и годы имеют переменную длину, поэтому для них используется календарная арифметика через `OzTime#add()` и `OzTime#diff()`.
+
+### Почему `diff(..., 'month')` и `diff(..., 'year')` работают не так, как разница в миллисекундах?
+
+Потому что для месяцев и лет применяется календарная логика, а не деление на фиксированное число миллисекунд. Это позволяет корректнее учитывать разную длину месяцев и переходы между датами.
+
+### Что лучше использовать: метод экземпляра или функцию модуля?
+
+Если уже есть экземпляр `OzTime`, обычно удобнее использовать методы экземпляра: `time.add(...)`, `time.format(...)`, `time.isBefore(...)`. Если нужен функциональный стиль или работаешь с импортированными утилитами напрямую, можно использовать функции модулей.
+
+### В каком часовом поясе хранится время внутри `OzTime`?
+
+Внутри хранится Unix timestamp в миллисекундах. Это абсолютное значение времени. Часовой пояс хранится отдельно как метаданные экземпляра.
+
+### Можно ли использовать библиотеку без locale и timezone?
+
+Да. По умолчанию используются:
+
+- `timezone = 'UTC'`
+- `locale = 'en-US'`
+
+### Когда использовать `Interval`, а когда `Duration`?
+
+Используй `Interval`, когда есть начало и конец диапазона. Используй `Duration`, когда нужна именно фиксированная длина времени, например 2 часа, 30 минут или 7 дней.
+
+## Разработка
+
+### Запуск dev-режима
+
+```bash
+npm run dev
+```
+
+### Сборка библиотеки
+
+```bash
+npm run build
+```
+
+### Запуск тестов
+
+```bash
+npm test
+```
+
+### Однократный запуск тестов
+
+```bash
+npm run test:run
+```
+
+### Покрытие тестами
+
+```bash
+npm run test:coverage
+```
+
+## Генерация документации
+
+### Генерация HTML-документации JSDoc
+
+```bash
+npm run docs
+```
+
+### Полная пересборка документации
+
+```bash
+npm run docs:build
+```
+
+После генерации документация будет находиться в папке `docs/`.
+
+## Ограничения и особенности
+
+- Внутреннее значение времени хранится как Unix timestamp в миллисекундах.
+- Часовой пояс не меняет абсолютный момент времени, а влияет на форматирование и вычисление смещения.
+- Методы `add`, `subtract`, `setTimezone` и другие операции не изменяют текущий экземпляр, а возвращают новый.
+- `Duration` поддерживает только фиксированные единицы времени.
+- Календарная арифметика через `month` и `year` учитывает реальную длину месяцев.
+- Разница в `month` и `year` считается календарно, а не через точное число миллисекунд.
+- Поддержка часовых поясов зависит от `Intl` и доступных IANA time zone в среде выполнения.
+
+## Лицензия
+
+ISC

package/dist/oz-time.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e={millisecond:`millisecond`,milliseconds:`millisecond`,ms:`millisecond`,second:`second`,seconds:`second`,s:`second`,minute:`minute`,minutes:`minute`,m:`minute`,hour:`hour`,hours:`hour`,h:`hour`,day:`day`,days:`day`,d:`day`,month:`month`,months:`month`,year:`year`,years:`year`,y:`year`},t={millisecond:1,second:1e3,minute:60*1e3,hour:3600*1e3,day:1440*60*1e3},n=[`month`,`year`];function r(t){if(typeof t!=`string`||t.trim()===``)throw TypeError(`normalizeUnit: unit must be a non-empty string`);let n=e[t.toLowerCase().trim()];if(!n)throw Error(`Unsupported unit: ${t}`);return n}function i(e){return r(e)in t}function a(e){return n.includes(r(e))}function o(e){let n=r(e);if(!(n in t))throw Error(`Unit cannot be converted to milliseconds exactly: ${e}`);return t[n]}function s(e,t){if(typeof e!=`number`||Number.isNaN(e))throw TypeError(`${t}: timestamp must be a valid number`)}function c(e,t){if(typeof e!=`number`||Number.isNaN(e))throw TypeError(`${t}: amount must be a valid number`)}function l(e,t){if(!(e instanceof B))throw TypeError(`${t} must be OzTime`)}function u(e,t){let n=new Date(e),r=new Date(t),i=(n.getUTCFullYear()-r.getUTCFullYear())*12+(n.getUTCMonth()-r.getUTCMonth()),a=n.getUTCDate(),o=r.getUTCDate();return i>0&&a<o?--i:i<0&&a>o&&(i+=1),i}function d(e,t){let n=new Date(e),r=new Date(t),i=n.getUTCFullYear()-r.getUTCFullYear(),a=n.getUTCMonth(),o=r.getUTCMonth(),s=n.getUTCDate(),c=r.getUTCDate();return i>0&&(a<o||a===o&&s<c)?--i:i<0&&(a>o||a===o&&s>c)&&(i+=1),i}function f(e){if(!Number.isInteger(e))throw TypeError(`isLeapYear: year must be an integer`);return e%4==0&&(e%100!=0||e%400==0)}function p(e,t){if(!Number.isInteger(e)||!Number.isInteger(t))throw TypeError(`daysInMonth: year and month must be integers`);if(t<1||t>12)throw RangeError(`daysInMonth: month must be between 1 and 12`);return new Date(Date.UTC(e,t,0)).getUTCDate()}function m(e,t,n){s(e,`addByFixedUnit`),c(t,`addByFixedUnit`);let a=r(n);if(!i(a))throw Error(`addByFixedUnit does not support calendar unit: ${n}`);return e+t*o(a)}function h(e,t,n){s(e,`addByCalendarUnit`),c(t,`addByCalendarUnit`);let i=r(n),a=new Date(e);if(i===`month`){let e=a.getUTCDate();a.setUTCDate(1),a.setUTCMonth(a.getUTCMonth()+t);let n=p(a.getUTCFullYear(),a.getUTCMonth()+1);return a.setUTCDate(Math.min(e,n)),a.getTime()}if(i===`year`){let e=a.getUTCMonth(),n=a.getUTCDate();a.setUTCDate(1),a.setUTCFullYear(a.getUTCFullYear()+t),a.setUTCMonth(e);let r=p(a.getUTCFullYear(),e+1);return a.setUTCDate(Math.min(n,r)),a.getTime()}throw Error(`addByCalendarUnit supports only month and year: ${n}`)}function g(e,t,n=`millisecond`){l(e,`left`),l(t,`right`);let a=r(n),s=e.getTimestamp(),c=t.getTimestamp();if(i(a))return(s-c)/o(a);if(a===`month`)return u(s,c);if(a===`year`)return d(s,c);throw Error(`Unsupported unit: ${n}`)}function _(e,t){if(!(e instanceof B))throw TypeError(`${t} must be OzTime`)}function v(e){if(typeof e!=`number`||Number.isNaN(e))throw TypeError(`amount must be a valid number`)}function y(e,t,n){_(e,`time`),v(t);let o=r(n),s=e.getTimestamp(),c;return i(o)?c=m(s,t,o):a(o)&&(c=h(s,t,o)),new B(c,e.getTimezone(),e.getLocale())}function b(e,t,n){return _(e,`time`),v(t),y(e,-t,n)}function x(e){if(!(e instanceof B))throw TypeError(`format: first argument must be OzTime`)}function S(e,t=2){return String(e).padStart(t,`0`)}function C(e,t){let n=new Intl.DateTimeFormat(t,{timeZone:e.getTimezone(),year:`numeric`,month:`numeric`,day:`numeric`,hour:`numeric`,minute:`2-digit`,second:`2-digit`,hour12:!1}).formatToParts(new Date(e.getTimestamp()));return Object.fromEntries(n.map(e=>[e.type,e.value]))}function w(e,t,n){return new Intl.DateTimeFormat(t,{timeZone:e.getTimezone(),month:n}).format(new Date(e.getTimestamp()))}function T(e,t,n){return new Intl.DateTimeFormat(t,{timeZone:e.getTimezone(),weekday:n}).format(new Date(e.getTimestamp()))}function E(e,t,n){if(x(e),typeof t!=`string`||t.trim()===``)throw TypeError(`format: template must be a non-empty string`);let r=n??e.getLocale(),i=C(e,r),a=Number(i.year),o=Number(i.month),s=Number(i.day),c=Number(i.hour),l=Number(i.minute),u=Number(i.second),d=new Date(e.getTimestamp()).getUTCMilliseconds(),f=c%12,p=f===0?12:f,m=c>=12?`PM`:`AM`,h={YYYY:String(a),YY:String(a).slice(-2),MMMM:w(e,r,`long`),MMM:w(e,r,`short`),MM:S(o),M:String(o),dddd:T(e,r,`long`),ddd:T(e,r,`short`),DD:S(s),D:String(s),HH:S(c),H:String(c),hh:S(p),h:String(p),mm:S(l),ss:S(u),SSS:S(d,3),A:m};return t.replace(/YYYY|MMMM|MMM|MM|M|dddd|ddd|DD|D|HH|H|hh|h|mm|ss|SSS|YY|A/g,e=>h[e]??e)}function D(e,t){if(!(e instanceof B))throw TypeError(`${t} must be OzTime`)}function O(e,t){let n=r(t),i=new Date(e);switch(n){case`millisecond`:return i.getTime();case`second`:i.setUTCMilliseconds(0);break;case`minute`:i.setUTCSeconds(0,0);break;case`hour`:i.setUTCMinutes(0,0,0);break;case`day`:i.setUTCHours(0,0,0,0);break;case`month`:i.setUTCHours(0,0,0,0),i.setUTCDate(1);break;case`year`:i.setUTCHours(0,0,0,0),i.setUTCDate(1),i.setUTCMonth(0);break;default:throw Error(`Unsupported unit for truncateToUnit: ${t}`)}return i.getTime()}function k(e,t,n=`millisecond`){return D(e,`a`),D(t,`b`),O(e.getTimestamp(),n)===O(t.getTimestamp(),n)}function A(e,t,n=`millisecond`){return D(e,`a`),D(t,`b`),O(e.getTimestamp(),n)<O(t.getTimestamp(),n)}function j(e,t,n=`millisecond`){return D(e,`a`),D(t,`b`),O(e.getTimestamp(),n)>O(t.getTimestamp(),n)}function M(e,t,n,r=`millisecond`,i=`[]`){D(e,`target`),D(t,`left`),D(n,`right`);let a=O(e.getTimestamp(),r),o=O(t.getTimestamp(),r),s=O(n.getTimestamp(),r),c=Math.min(o,s),l=Math.max(o,s);switch(i){case`[]`:return a>=c&&a<=l;case`[)`:return a>=c&&a<l;case`(]`:return a>c&&a<=l;case`()`:return a>c&&a<l;default:throw Error(`Invalid inclusivity value: ${i}`)}}function N(e){if(typeof e!=`string`||e.trim()===``)throw TypeError(`setTimezone: timezone must be a non-empty string`);if(!Intl.supportedValuesOf(`timeZone`).includes(e))throw Error(`Unsupported timezone: ${e}`)}function P(e,t){let n=new Date(e),r=new Intl.DateTimeFormat(`en-US`,{timeZone:t,year:`numeric`,month:`2-digit`,day:`2-digit`,hour:`2-digit`,minute:`2-digit`,second:`2-digit`,hour12:!1}).formatToParts(n),i=Object.fromEntries(r.map(e=>[e.type,e.value])),a=Number(i.year),o=Number(i.month),s=Number(i.day),c=Number(i.hour),l=Number(i.minute),u=Number(i.second);return(Date.UTC(a,o-1,s,c,l,u)-e)/6e4}function F(e,t){if(!(e instanceof B))throw TypeError(`tz: first argument must be OzTime`);return N(t),new B(e.getTimestamp(),t,e.getLocale())}function I(e){if(!(e instanceof B))throw TypeError(`getTimezoneOffset: argument must be OzTime`);return P(e.getTimestamp(),e.getTimezone())}function L(e){if(typeof e!=`number`||Number.isNaN(e))throw TypeError(`OzTime: timestamp must be a valid number`)}function R(e){if(typeof e!=`string`||e.trim()===``)throw TypeError(`OzTime: timezone must be a non-empty string`)}function z(e){if(typeof e!=`string`||e.trim()===``)throw TypeError(`OzTime: locale must be a non-empty string`)}var B=class{constructor(e,t=`UTC`,n=`en-US`){L(e),R(t),z(n),this._timestamp=e,this._timezone=t,this._locale=n}getTimestamp(){return this._timestamp}getTimezone(){return this._timezone}getLocale(){return this._locale}toTimestamp(){return this._timestamp}toISOString(){return new Date(this._timestamp).toISOString()}add(e,t){return y(this,e,t)}subtract(e,t){return b(this,e,t)}format(e,t){return E(this,e,t)}isSame(e,t=`millisecond`){return k(this,e,t)}isBefore(e,t=`millisecond`){return A(this,e,t)}isAfter(e,t=`millisecond`){return j(this,e,t)}isBetween(e,t,n=`millisecond`,r=`[]`){return M(this,e,t,n,r)}setTimezone(e){return F(this,e)}getTimezoneOffset(){return I(this)}diff(e,t=`millisecond`){return g(this,e,t)}};function V(e){if(typeof e!=`number`||Number.isNaN(e))throw TypeError(`fromTimestamp: timestamp must be a valid number`)}function H(e){if(!(e instanceof Date)||Number.isNaN(e.getTime()))throw TypeError(`fromDate: date must be a valid Date`)}function U(e,t){if(!Number.isInteger(e))throw TypeError(`${t} must be an integer`)}function W(e=`UTC`,t=`en-US`){return new B(Date.now(),e,t)}function G(e,t=`UTC`,n=`en-US`){return V(e),new B(e,t,n)}function K(e,t=`UTC`,n=`en-US`){return H(e),new B(e.getTime(),t,n)}function q(e,t=`UTC`,n=`en-US`){if(typeof e!=`string`||e.trim()===``)throw TypeError(`fromISO: isoString must be a non-empty string`);let r=Date.parse(e);if(Number.isNaN(r))throw Error(`Invalid ISO date string: ${e}`);return new B(r,t,n)}function J(e,t,n,r=0,i=0,a=0,o=0,s=`UTC`,c=`en-US`){if(U(e,`year`),U(t,`month`),U(n,`day`),U(r,`hour`),U(i,`minute`),U(a,`second`),U(o,`millisecond`),t<1||t>12)throw RangeError(`month must be between 1 and 12`);if(r<0||r>23)throw RangeError(`hour must be between 0 and 23`);if(i<0||i>59)throw RangeError(`minute must be between 0 and 59`);if(a<0||a>59)throw RangeError(`second must be between 0 and 59`);if(o<0||o>999)throw RangeError(`millisecond must be between 0 and 999`);let l=p(e,t);if(n<1||n>l)throw RangeError(`day must be between 1 and ${l} for ${e}-${t}`);return new B(Date.UTC(e,t-1,n,r,i,a,o),s,c)}function Y(e,t){if(!(e instanceof B))throw TypeError(`${t} must be OzTime`)}var X=class e{constructor(e,t){if(Y(e,`start`),Y(t,`end`),e.getTimestamp()>t.getTimestamp())throw RangeError(`Interval: start must be before or equal to end`);this._start=e,this._end=t}getStart(){return this._start}getEnd(){return this._end}contains(e){Y(e,`moment`);let t=e.getTimestamp();return t>=this._start.getTimestamp()&&t<=this._end.getTimestamp()}overlaps(t){if(!(t instanceof e))throw TypeError(`other must be Interval`);let n=this._start.getTimestamp(),r=this._end.getTimestamp(),i=t.getStart().getTimestamp();return n<=t.getEnd().getTimestamp()&&i<=r}duration(e=`millisecond`){let t=r(e);if(!i(t))throw Error(`Interval.duration supports only fixed units: ${e}`);return(this._end.getTimestamp()-this._start.getTimestamp())/o(t)}};function Z(e,t){return new X(e,t)}function Q(e){if(typeof e!=`number`||Number.isNaN(e))throw TypeError(`amount must be a valid number`)}var $=class e{constructor(e){if(typeof e!=`number`||Number.isNaN(e))throw TypeError(`Duration: milliseconds must be a valid number`);this._milliseconds=e}asMilliseconds(){return this._milliseconds}asSeconds(){return this._milliseconds/o(`second`)}asMinutes(){return this._milliseconds/o(`minute`)}asHours(){return this._milliseconds/o(`hour`)}asDays(){return this._milliseconds/o(`day`)}add(t){if(!(t instanceof e))throw TypeError(`Duration.add: other must be Duration`);return new e(this._milliseconds+t._milliseconds)}};function ee(e,t){Q(e);let n=r(t);if(!i(n))throw Error(`duration supports only fixed units: ${t}`);return new $(e*o(n))}exports.Duration=$,exports.Interval=X,exports.OzTime=B,exports.add=y,exports.daysInMonth=p,exports.duration=ee,exports.format=E,exports.fromComponents=J,exports.fromDate=K,exports.fromISO=q,exports.fromTimestamp=G,exports.getTimezoneOffset=I,exports.interval=Z,exports.isAfter=j,exports.isBefore=A,exports.isBetween=M,exports.isLeapYear=f,exports.isSame=k,exports.now=W,exports.setTimezone=F,exports.subtract=b;

package/dist/oz-time.esm.js

@@ -0,0 +1,426 @@
+//#region src/utils/units.js
+var e = {
+	millisecond: "millisecond",
+	milliseconds: "millisecond",
+	ms: "millisecond",
+	second: "second",
+	seconds: "second",
+	s: "second",
+	minute: "minute",
+	minutes: "minute",
+	m: "minute",
+	hour: "hour",
+	hours: "hour",
+	h: "hour",
+	day: "day",
+	days: "day",
+	d: "day",
+	month: "month",
+	months: "month",
+	year: "year",
+	years: "year",
+	y: "year"
+}, t = {
+	millisecond: 1,
+	second: 1e3,
+	minute: 60 * 1e3,
+	hour: 3600 * 1e3,
+	day: 1440 * 60 * 1e3
+}, n = ["month", "year"];
+function r(t) {
+	if (typeof t != "string" || t.trim() === "") throw TypeError("normalizeUnit: unit must be a non-empty string");
+	let n = e[t.toLowerCase().trim()];
+	if (!n) throw Error(`Unsupported unit: ${t}`);
+	return n;
+}
+function i(e) {
+	return r(e) in t;
+}
+function a(e) {
+	return n.includes(r(e));
+}
+function o(e) {
+	let n = r(e);
+	if (!(n in t)) throw Error(`Unit cannot be converted to milliseconds exactly: ${e}`);
+	return t[n];
+}
+//#endregion
+//#region src/utils/calendar.js
+function s(e, t) {
+	if (typeof e != "number" || Number.isNaN(e)) throw TypeError(`${t}: timestamp must be a valid number`);
+}
+function c(e, t) {
+	if (typeof e != "number" || Number.isNaN(e)) throw TypeError(`${t}: amount must be a valid number`);
+}
+function l(e, t) {
+	if (!(e instanceof B)) throw TypeError(`${t} must be OzTime`);
+}
+function u(e, t) {
+	let n = new Date(e), r = new Date(t), i = (n.getUTCFullYear() - r.getUTCFullYear()) * 12 + (n.getUTCMonth() - r.getUTCMonth()), a = n.getUTCDate(), o = r.getUTCDate();
+	return i > 0 && a < o ? --i : i < 0 && a > o && (i += 1), i;
+}
+function d(e, t) {
+	let n = new Date(e), r = new Date(t), i = n.getUTCFullYear() - r.getUTCFullYear(), a = n.getUTCMonth(), o = r.getUTCMonth(), s = n.getUTCDate(), c = r.getUTCDate();
+	return i > 0 && (a < o || a === o && s < c) ? --i : i < 0 && (a > o || a === o && s > c) && (i += 1), i;
+}
+function f(e) {
+	if (!Number.isInteger(e)) throw TypeError("isLeapYear: year must be an integer");
+	return e % 4 == 0 && (e % 100 != 0 || e % 400 == 0);
+}
+function p(e, t) {
+	if (!Number.isInteger(e) || !Number.isInteger(t)) throw TypeError("daysInMonth: year and month must be integers");
+	if (t < 1 || t > 12) throw RangeError("daysInMonth: month must be between 1 and 12");
+	return new Date(Date.UTC(e, t, 0)).getUTCDate();
+}
+function m(e, t, n) {
+	s(e, "addByFixedUnit"), c(t, "addByFixedUnit");
+	let a = r(n);
+	if (!i(a)) throw Error(`addByFixedUnit does not support calendar unit: ${n}`);
+	return e + t * o(a);
+}
+function h(e, t, n) {
+	s(e, "addByCalendarUnit"), c(t, "addByCalendarUnit");
+	let i = r(n), a = new Date(e);
+	if (i === "month") {
+		let e = a.getUTCDate();
+		a.setUTCDate(1), a.setUTCMonth(a.getUTCMonth() + t);
+		let n = p(a.getUTCFullYear(), a.getUTCMonth() + 1);
+		return a.setUTCDate(Math.min(e, n)), a.getTime();
+	}
+	if (i === "year") {
+		let e = a.getUTCMonth(), n = a.getUTCDate();
+		a.setUTCDate(1), a.setUTCFullYear(a.getUTCFullYear() + t), a.setUTCMonth(e);
+		let r = p(a.getUTCFullYear(), e + 1);
+		return a.setUTCDate(Math.min(n, r)), a.getTime();
+	}
+	throw Error(`addByCalendarUnit supports only month and year: ${n}`);
+}
+function g(e, t, n = "millisecond") {
+	l(e, "left"), l(t, "right");
+	let a = r(n), s = e.getTimestamp(), c = t.getTimestamp();
+	if (i(a)) return (s - c) / o(a);
+	if (a === "month") return u(s, c);
+	if (a === "year") return d(s, c);
+	throw Error(`Unsupported unit: ${n}`);
+}
+//#endregion
+//#region src/modules/arithmetic.js
+function _(e, t) {
+	if (!(e instanceof B)) throw TypeError(`${t} must be OzTime`);
+}
+function v(e) {
+	if (typeof e != "number" || Number.isNaN(e)) throw TypeError("amount must be a valid number");
+}
+function y(e, t, n) {
+	_(e, "time"), v(t);
+	let o = r(n), s = e.getTimestamp(), c;
+	return i(o) ? c = m(s, t, o) : a(o) && (c = h(s, t, o)), new B(c, e.getTimezone(), e.getLocale());
+}
+function b(e, t, n) {
+	return _(e, "time"), v(t), y(e, -t, n);
+}
+//#endregion
+//#region src/modules/format.js
+function x(e) {
+	if (!(e instanceof B)) throw TypeError("format: first argument must be OzTime");
+}
+function S(e, t = 2) {
+	return String(e).padStart(t, "0");
+}
+function C(e, t) {
+	let n = new Intl.DateTimeFormat(t, {
+		timeZone: e.getTimezone(),
+		year: "numeric",
+		month: "numeric",
+		day: "numeric",
+		hour: "numeric",
+		minute: "2-digit",
+		second: "2-digit",
+		hour12: !1
+	}).formatToParts(new Date(e.getTimestamp()));
+	return Object.fromEntries(n.map((e) => [e.type, e.value]));
+}
+function w(e, t, n) {
+	return new Intl.DateTimeFormat(t, {
+		timeZone: e.getTimezone(),
+		month: n
+	}).format(new Date(e.getTimestamp()));
+}
+function T(e, t, n) {
+	return new Intl.DateTimeFormat(t, {
+		timeZone: e.getTimezone(),
+		weekday: n
+	}).format(new Date(e.getTimestamp()));
+}
+function E(e, t, n) {
+	if (x(e), typeof t != "string" || t.trim() === "") throw TypeError("format: template must be a non-empty string");
+	let r = n ?? e.getLocale(), i = C(e, r), a = Number(i.year), o = Number(i.month), s = Number(i.day), c = Number(i.hour), l = Number(i.minute), u = Number(i.second), d = new Date(e.getTimestamp()).getUTCMilliseconds(), f = c % 12, p = f === 0 ? 12 : f, m = c >= 12 ? "PM" : "AM", h = {
+		YYYY: String(a),
+		YY: String(a).slice(-2),
+		MMMM: w(e, r, "long"),
+		MMM: w(e, r, "short"),
+		MM: S(o),
+		M: String(o),
+		dddd: T(e, r, "long"),
+		ddd: T(e, r, "short"),
+		DD: S(s),
+		D: String(s),
+		HH: S(c),
+		H: String(c),
+		hh: S(p),
+		h: String(p),
+		mm: S(l),
+		ss: S(u),
+		SSS: S(d, 3),
+		A: m
+	};
+	return t.replace(/YYYY|MMMM|MMM|MM|M|dddd|ddd|DD|D|HH|H|hh|h|mm|ss|SSS|YY|A/g, (e) => h[e] ?? e);
+}
+//#endregion
+//#region src/modules/compare.js
+function D(e, t) {
+	if (!(e instanceof B)) throw TypeError(`${t} must be OzTime`);
+}
+function O(e, t) {
+	let n = r(t), i = new Date(e);
+	switch (n) {
+		case "millisecond": return i.getTime();
+		case "second":
+			i.setUTCMilliseconds(0);
+			break;
+		case "minute":
+			i.setUTCSeconds(0, 0);
+			break;
+		case "hour":
+			i.setUTCMinutes(0, 0, 0);
+			break;
+		case "day":
+			i.setUTCHours(0, 0, 0, 0);
+			break;
+		case "month":
+			i.setUTCHours(0, 0, 0, 0), i.setUTCDate(1);
+			break;
+		case "year":
+			i.setUTCHours(0, 0, 0, 0), i.setUTCDate(1), i.setUTCMonth(0);
+			break;
+		default: throw Error(`Unsupported unit for truncateToUnit: ${t}`);
+	}
+	return i.getTime();
+}
+function k(e, t, n = "millisecond") {
+	return D(e, "a"), D(t, "b"), O(e.getTimestamp(), n) === O(t.getTimestamp(), n);
+}
+function A(e, t, n = "millisecond") {
+	return D(e, "a"), D(t, "b"), O(e.getTimestamp(), n) < O(t.getTimestamp(), n);
+}
+function j(e, t, n = "millisecond") {
+	return D(e, "a"), D(t, "b"), O(e.getTimestamp(), n) > O(t.getTimestamp(), n);
+}
+function M(e, t, n, r = "millisecond", i = "[]") {
+	D(e, "target"), D(t, "left"), D(n, "right");
+	let a = O(e.getTimestamp(), r), o = O(t.getTimestamp(), r), s = O(n.getTimestamp(), r), c = Math.min(o, s), l = Math.max(o, s);
+	switch (i) {
+		case "[]": return a >= c && a <= l;
+		case "[)": return a >= c && a < l;
+		case "(]": return a > c && a <= l;
+		case "()": return a > c && a < l;
+		default: throw Error(`Invalid inclusivity value: ${i}`);
+	}
+}
+//#endregion
+//#region src/modules/timezone.js
+function N(e) {
+	if (typeof e != "string" || e.trim() === "") throw TypeError("setTimezone: timezone must be a non-empty string");
+	if (!Intl.supportedValuesOf("timeZone").includes(e)) throw Error(`Unsupported timezone: ${e}`);
+}
+function P(e, t) {
+	let n = new Date(e), r = new Intl.DateTimeFormat("en-US", {
+		timeZone: t,
+		year: "numeric",
+		month: "2-digit",
+		day: "2-digit",
+		hour: "2-digit",
+		minute: "2-digit",
+		second: "2-digit",
+		hour12: !1
+	}).formatToParts(n), i = Object.fromEntries(r.map((e) => [e.type, e.value])), a = Number(i.year), o = Number(i.month), s = Number(i.day), c = Number(i.hour), l = Number(i.minute), u = Number(i.second);
+	return (Date.UTC(a, o - 1, s, c, l, u) - e) / 6e4;
+}
+function F(e, t) {
+	if (!(e instanceof B)) throw TypeError("tz: first argument must be OzTime");
+	return N(t), new B(e.getTimestamp(), t, e.getLocale());
+}
+function I(e) {
+	if (!(e instanceof B)) throw TypeError("getTimezoneOffset: argument must be OzTime");
+	return P(e.getTimestamp(), e.getTimezone());
+}
+//#endregion
+//#region src/core/core.js
+function L(e) {
+	if (typeof e != "number" || Number.isNaN(e)) throw TypeError("OzTime: timestamp must be a valid number");
+}
+function R(e) {
+	if (typeof e != "string" || e.trim() === "") throw TypeError("OzTime: timezone must be a non-empty string");
+}
+function z(e) {
+	if (typeof e != "string" || e.trim() === "") throw TypeError("OzTime: locale must be a non-empty string");
+}
+var B = class {
+	constructor(e, t = "UTC", n = "en-US") {
+		L(e), R(t), z(n), this._timestamp = e, this._timezone = t, this._locale = n;
+	}
+	getTimestamp() {
+		return this._timestamp;
+	}
+	getTimezone() {
+		return this._timezone;
+	}
+	getLocale() {
+		return this._locale;
+	}
+	toTimestamp() {
+		return this._timestamp;
+	}
+	toISOString() {
+		return new Date(this._timestamp).toISOString();
+	}
+	add(e, t) {
+		return y(this, e, t);
+	}
+	subtract(e, t) {
+		return b(this, e, t);
+	}
+	format(e, t) {
+		return E(this, e, t);
+	}
+	isSame(e, t = "millisecond") {
+		return k(this, e, t);
+	}
+	isBefore(e, t = "millisecond") {
+		return A(this, e, t);
+	}
+	isAfter(e, t = "millisecond") {
+		return j(this, e, t);
+	}
+	isBetween(e, t, n = "millisecond", r = "[]") {
+		return M(this, e, t, n, r);
+	}
+	setTimezone(e) {
+		return F(this, e);
+	}
+	getTimezoneOffset() {
+		return I(this);
+	}
+	diff(e, t = "millisecond") {
+		return g(this, e, t);
+	}
+};
+//#endregion
+//#region src/core/factory.js
+function V(e) {
+	if (typeof e != "number" || Number.isNaN(e)) throw TypeError("fromTimestamp: timestamp must be a valid number");
+}
+function H(e) {
+	if (!(e instanceof Date) || Number.isNaN(e.getTime())) throw TypeError("fromDate: date must be a valid Date");
+}
+function U(e, t) {
+	if (!Number.isInteger(e)) throw TypeError(`${t} must be an integer`);
+}
+function W(e = "UTC", t = "en-US") {
+	return new B(Date.now(), e, t);
+}
+function G(e, t = "UTC", n = "en-US") {
+	return V(e), new B(e, t, n);
+}
+function K(e, t = "UTC", n = "en-US") {
+	return H(e), new B(e.getTime(), t, n);
+}
+function q(e, t = "UTC", n = "en-US") {
+	if (typeof e != "string" || e.trim() === "") throw TypeError("fromISO: isoString must be a non-empty string");
+	let r = Date.parse(e);
+	if (Number.isNaN(r)) throw Error(`Invalid ISO date string: ${e}`);
+	return new B(r, t, n);
+}
+function J(e, t, n, r = 0, i = 0, a = 0, o = 0, s = "UTC", c = "en-US") {
+	if (U(e, "year"), U(t, "month"), U(n, "day"), U(r, "hour"), U(i, "minute"), U(a, "second"), U(o, "millisecond"), t < 1 || t > 12) throw RangeError("month must be between 1 and 12");
+	if (r < 0 || r > 23) throw RangeError("hour must be between 0 and 23");
+	if (i < 0 || i > 59) throw RangeError("minute must be between 0 and 59");
+	if (a < 0 || a > 59) throw RangeError("second must be between 0 and 59");
+	if (o < 0 || o > 999) throw RangeError("millisecond must be between 0 and 999");
+	let l = p(e, t);
+	if (n < 1 || n > l) throw RangeError(`day must be between 1 and ${l} for ${e}-${t}`);
+	return new B(Date.UTC(e, t - 1, n, r, i, a, o), s, c);
+}
+//#endregion
+//#region src/modules/interval.js
+function Y(e, t) {
+	if (!(e instanceof B)) throw TypeError(`${t} must be OzTime`);
+}
+var X = class e {
+	constructor(e, t) {
+		if (Y(e, "start"), Y(t, "end"), e.getTimestamp() > t.getTimestamp()) throw RangeError("Interval: start must be before or equal to end");
+		this._start = e, this._end = t;
+	}
+	getStart() {
+		return this._start;
+	}
+	getEnd() {
+		return this._end;
+	}
+	contains(e) {
+		Y(e, "moment");
+		let t = e.getTimestamp();
+		return t >= this._start.getTimestamp() && t <= this._end.getTimestamp();
+	}
+	overlaps(t) {
+		if (!(t instanceof e)) throw TypeError("other must be Interval");
+		let n = this._start.getTimestamp(), r = this._end.getTimestamp(), i = t.getStart().getTimestamp();
+		return n <= t.getEnd().getTimestamp() && i <= r;
+	}
+	duration(e = "millisecond") {
+		let t = r(e);
+		if (!i(t)) throw Error(`Interval.duration supports only fixed units: ${e}`);
+		return (this._end.getTimestamp() - this._start.getTimestamp()) / o(t);
+	}
+};
+function Z(e, t) {
+	return new X(e, t);
+}
+//#endregion
+//#region src/modules/duration.js
+function Q(e) {
+	if (typeof e != "number" || Number.isNaN(e)) throw TypeError("amount must be a valid number");
+}
+var $ = class e {
+	constructor(e) {
+		if (typeof e != "number" || Number.isNaN(e)) throw TypeError("Duration: milliseconds must be a valid number");
+		this._milliseconds = e;
+	}
+	asMilliseconds() {
+		return this._milliseconds;
+	}
+	asSeconds() {
+		return this._milliseconds / o("second");
+	}
+	asMinutes() {
+		return this._milliseconds / o("minute");
+	}
+	asHours() {
+		return this._milliseconds / o("hour");
+	}
+	asDays() {
+		return this._milliseconds / o("day");
+	}
+	add(t) {
+		if (!(t instanceof e)) throw TypeError("Duration.add: other must be Duration");
+		return new e(this._milliseconds + t._milliseconds);
+	}
+};
+function ee(e, t) {
+	Q(e);
+	let n = r(t);
+	if (!i(n)) throw Error(`duration supports only fixed units: ${t}`);
+	return new $(e * o(n));
+}
+//#endregion
+export { $ as Duration, X as Interval, B as OzTime, y as add, p as daysInMonth, ee as duration, E as format, J as fromComponents, K as fromDate, q as fromISO, G as fromTimestamp, I as getTimezoneOffset, Z as interval, j as isAfter, A as isBefore, M as isBetween, f as isLeapYear, k as isSame, W as now, F as setTimezone, b as subtract };

package/package.json

@@ -0,0 +1,48 @@
+{
+    "name": "@alexstukovnikov/oz-time",
+    "version": "1.0.0",
+    "description": "Lightweight JavaScript date-time library",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/AlexStukovnikov/oz-time.git"
+    },
+    "type": "module",
+    "main": "./dist/oz-time.cjs",
+    "module": "./dist/oz-time.esm.js",
+    "exports": {
+        ".": {
+            "import": "./dist/oz-time.esm.js",
+            "require": "./dist/oz-time.cjs"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "sideEffects": false,
+    "scripts": {
+        "dev": "vite",
+        "build": "vite build",
+        "test": "vitest",
+        "test:run": "vitest run",
+        "test:coverage": "vitest run --coverage",
+        "docs": "jsdoc -c jsdoc.json",
+        "docs:clean": "rimraf docs",
+        "docs:build": "npm run docs:clean && npm run docs",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "date",
+        "time",
+        "datetime"
+    ],
+    "author": "",
+    "license": "ISC",
+    "devDependencies": {
+        "@vitest/coverage-v8": "^4.1.7",
+        "@vitest/ui": "^4.1.7",
+        "docdash": "^2.0.2",
+        "jsdoc": "^4.0.5",
+        "vite": "^8.0.14",
+        "vitest": "^4.1.7"
+    }
+}