yummies 7.19.4 → 7.20.0

package/date-time.cjs

@@ -1,5 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("./chunk-CZWwpsFl.cjs");
 let yummies_type_guard = require("yummies/type-guard");
 let yummies_format = require("yummies/format");
 let yummies_ms = require("yummies/ms");
@@ -23,9 +22,9 @@ var Y = "year";
 var DATE = "date";
 var INVALID_DATE_STRING = "Invalid Date";
 var REGEX_PARSE = /^(\d{4})[-/]?(\d{1,2})?[-/]?(\d{0,2})[Tt\s]*(\d{1,2})?:?(\d{1,2})?:?(\d{1,2})?[.:]?(\d+)?$/;
-var REGEX_FORMAT = /\[([^\]]+)]|Y{1,4}|M{1,4}|D{1,2}|d{1,4}|H{1,2}|h{1,2}|a|A|m{1,2}|s{1,2}|Z{1,2}|SSS/g;
+var REGEX_FORMAT = /\[([^\]]+)]|YYYY|YY|M{1,4}|D{1,2}|d{1,4}|H{1,2}|h{1,2}|a|A|m{1,2}|s{1,2}|Z{1,2}|SSS/g;
 //#endregion
-//#region node_modules/.pnpm/dayjs@1.11.20/node_modules/dayjs/esm/locale/en.js
+//#region node_modules/.pnpm/dayjs@1.11.21/node_modules/dayjs/esm/locale/en.js
 var en_default = {
 	name: "en",
 	weekdays: "Sunday_Monday_Tuesday_Wednesday_Thursday_Friday_Saturday".split("_"),
@@ -42,7 +41,7 @@ var en_default = {
 	}
 };
 //#endregion
-//#region node_modules/.pnpm/dayjs@1.11.20/node_modules/dayjs/esm/utils.js
+//#region node_modules/.pnpm/dayjs@1.11.21/node_modules/dayjs/esm/utils.js
 var padStart = function padStart(string, length, pad) {
 	var s = String(string);
 	if (!s || s.length >= length) return string;
@@ -87,7 +86,7 @@ var utils_default = {
 	}
 };
 //#endregion
-//#region node_modules/.pnpm/dayjs@1.11.20/node_modules/dayjs/esm/index.js
+//#region node_modules/.pnpm/dayjs@1.11.21/node_modules/dayjs/esm/index.js
 var L = "en";
 var Ls = {};
 Ls[L] = en_default;
@@ -150,7 +149,7 @@ var parseDate = function parseDate(cfg) {
 	}
 	return new Date(date);
 };
-var Dayjs = /* @__PURE__ */ function() {
+var Dayjs = /*#__PURE__*/ function() {
 	function Dayjs(cfg) {
 		this.$L = parseLocale(cfg.locale, null, true);
 		this.parse(cfg);
@@ -438,10 +437,11 @@ dayjs.en = Ls[L];
 dayjs.Ls = Ls;
 dayjs.p = {};
 //#endregion
-//#region node_modules/.pnpm/dayjs@1.11.20/node_modules/dayjs/esm/plugin/duration/index.js
+//#region node_modules/.pnpm/dayjs@1.11.21/node_modules/dayjs/esm/plugin/duration/index.js
 var MILLISECONDS_A_YEAR = MILLISECONDS_A_DAY * 365;
 var MILLISECONDS_A_MONTH = MILLISECONDS_A_YEAR / 12;
-var durationRegex = /^(-|\+)?P(?:([-+]?[0-9,.]*)Y)?(?:([-+]?[0-9,.]*)M)?(?:([-+]?[0-9,.]*)W)?(?:([-+]?[0-9,.]*)D)?(?:T(?:([-+]?[0-9,.]*)H)?(?:([-+]?[0-9,.]*)M)?(?:([-+]?[0-9,.]*)S)?)?$/;
+var DURATION_REGEX_PARSE = /^(-|\+)?P(?:([-+]?[0-9,.]*)Y)?(?:([-+]?[0-9,.]*)M)?(?:([-+]?[0-9,.]*)W)?(?:([-+]?[0-9,.]*)D)?(?:T(?:([-+]?[0-9,.]*)H)?(?:([-+]?[0-9,.]*)M)?(?:([-+]?[0-9,.]*)S)?)?$/;
+var DURATION_REGEX_FORMAT = /\[([^\]]+)]|YYYY|YY|Y|M{1,2}|D{1,2}|H{1,2}|m{1,2}|s{1,2}|SSS/g;
 var unitToMS = {
 	years: MILLISECONDS_A_YEAR,
 	months: MILLISECONDS_A_MONTH,
@@ -486,7 +486,7 @@ var getNumberUnitFormat = function getNumberUnitFormat(number, unit) {
 		format: "" + number + unit
 	};
 };
-var Duration = /* @__PURE__ */ function() {
+var Duration = /*#__PURE__*/ function() {
 	function Duration(input, unit, locale) {
 		var _this = this;
 		this.$d = {};
@@ -509,7 +509,7 @@ var Duration = /* @__PURE__ */ function() {
 			return this;
 		}
 		if (typeof input === "string") {
-			var d = input.match(durationRegex);
+			var d = input.match(DURATION_REGEX_PARSE);
 			if (d) {
 				var numberD = d.slice(2).map(function(value) {
 					return value != null ? Number(value) : 0;
@@ -590,7 +590,7 @@ var Duration = /* @__PURE__ */ function() {
 			ss: $u.s(this.$d.seconds, 2, "0"),
 			SSS: $u.s(this.$d.milliseconds, 3, "0")
 		};
-		return str.replace(REGEX_FORMAT, function(match, $1) {
+		return str.replace(DURATION_REGEX_FORMAT, function(match, $1) {
 			return $1 || String(matches[match]);
 		});
 	};
@@ -701,7 +701,7 @@ var duration_default = (function(option, Dayjs, dayjs) {
 	};
 });
 //#endregion
-//#region node_modules/.pnpm/dayjs@1.11.20/node_modules/dayjs/esm/plugin/relativeTime/index.js
+//#region node_modules/.pnpm/dayjs@1.11.21/node_modules/dayjs/esm/plugin/relativeTime/index.js
 var relativeTime_default = (function(o, c, d) {
 	o = o || {};
 	var proto = c.prototype;
@@ -817,7 +817,7 @@ var relativeTime_default = (function(o, c, d) {
 	};
 });
 //#endregion
-//#region node_modules/.pnpm/dayjs@1.11.20/node_modules/dayjs/esm/locale/ru.js
+//#region node_modules/.pnpm/dayjs@1.11.21/node_modules/dayjs/esm/locale/ru.js
 var monthFormat = "января_февраля_марта_апреля_мая_июня_июля_августа_сентября_октября_ноября_декабря".split("_");
 var monthStandalone = "январь_февраль_март_апрель_май_июнь_июль_август_сентябрь_октябрь_ноябрь_декабрь".split("_");
 var monthShortFormat = "янв._февр._мар._апр._мая_июня_июля_авг._сент._окт._нояб._дек.".split("_");
@@ -894,23 +894,7 @@ var locale = {
 };
 dayjs.locale(locale, null, true);
 //#endregion
-//#region src/date-time.ts
-/**
-* ---header-docs-section---
-* # yummies/date-time
-*
-* ## Description
-*
-* Date and time formatting built on **dayjs** with locale plugins, human-readable presets, relative
-* phrases, and duration helpers tailored to UI copy. It composes with `yummies/format`, `yummies/ms`,
-* and `yummies/text` for declensions so timestamps read naturally in Russian-facing apps.
-*
-* ## Usage
-*
-* ```ts
-* import { formatDate } from "yummies/date-time";
-* ```
-*/
+//#region src/date-time/_shared.ts
 dayjs.extend(relativeTime_default);
 dayjs.extend(duration_default);
 dayjs.locale("ru");
@@ -921,35 +905,49 @@ var toLibFormat = (value) => {
 	if (!result?.isValid()) return null;
 	return result;
 };
+//#endregion
+//#region src/date-time/add-days.ts
 /**
-* Formats a date-like value using predefined presets or a custom pattern.
+* Returns a new date shifted forward by the provided number of days.
 *
 * @example
 * ```ts
-* formatDate('2024-03-15', { format: 'time-short' });
+* addDays(new Date('2024-03-15'), 7);
 * ```
 */
-var formatDate = (value, settings) => {
-	const dateFormat = settings?.format;
-	const datePattern = settings?.pattern;
-	const asTime = settings?.asTime;
-	let libDate = null;
-	if (asTime && yummies_type_guard.typeGuard.isNumber(value)) libDate = dayjs.duration(value);
-	else libDate = toLibFormat(value);
-	if (!libDate) return yummies_format.format.NO_VALUE;
-	if (datePattern) return libDate.format(datePattern);
-	if (dateFormat === "human" || dateFormat === "spent-time") if ("fromNow" in libDate) return libDate.fromNow(dateFormat === "spent-time");
-	else return yummies_format.format.NO_VALUE;
-	switch (dateFormat) {
-		case "full": return libDate.format("DD MMM YYYY HH:mm:ss");
-		case "short": return libDate.format("DD MMM HH:mm");
-		case "time": return libDate.format("HH:mm:ss");
-		case "time-short": return libDate.format("HH:mm");
-		case "day": return libDate.format("DD MMM YYYY");
-		case "month": return libDate.format("MMMM YYYY");
-		default: return libDate.format("DD.MM.YYYY");
+var addDays = (date, count) => toLibFormat(date)?.add(count, "d").toDate();
+//#endregion
+//#region src/date-time/add-minutes.ts
+/**
+* Returns a new date shifted forward by the provided number of minutes.
+*
+* @example
+* ```ts
+* addMinutes(new Date('2024-03-15T12:00:00'), 15);
+* ```
+*/
+var addMinutes = (date, count) => toLibFormat(date)?.add(count, "m").toDate();
+//#endregion
+//#region src/date-time/change-date.ts
+/**
+* Applies one or more date adjustments and returns a new `Date` instance.
+*
+* @example
+* ```ts
+* changeDate(new Date(), 1, 'day', 30, 'minute');
+* ```
+*/
+var changeDate = (date, ...args) => {
+	let wrappedDate = toLibFormat(date);
+	for (let i = 0; i < args.length; i += 2) {
+		const amount = args[i];
+		const unit = args[i + 1];
+		if (unit != null) wrappedDate = wrappedDate.add(amount, unit);
 	}
+	return wrappedDate.toDate();
 };
+//#endregion
+//#region src/date-time/day-time-duration.ts
 /**
 * Splits a duration in milliseconds into day-based time parts.
 *
@@ -976,40 +974,39 @@ var dayTimeDuration = (timeInMs) => {
 		milliseconds: Math.floor(left)
 	};
 };
+//#endregion
+//#region src/date-time/format-date.ts
 /**
-* Applies one or more date adjustments and returns a new `Date` instance.
+* Formats a date-like value using predefined presets or a custom pattern.
 *
 * @example
 * ```ts
-* changeDate(new Date(), 1, 'day', 30, 'minute');
+* formatDate('2024-03-15', { format: 'time-short' });
 * ```
 */
-var changeDate = (date, ...args) => {
-	let wrappedDate = toLibFormat(date);
-	for (let i = 0; i < args.length; i += 2) {
-		const amount = args[i];
-		const unit = args[i + 1];
-		if (unit != null) wrappedDate = wrappedDate.add(amount, unit);
+var formatDate = (value, settings) => {
+	const dateFormat = settings?.format;
+	const datePattern = settings?.pattern;
+	const asTime = settings?.asTime;
+	let libDate = null;
+	if (asTime && yummies_type_guard.typeGuard.isNumber(value)) libDate = dayjs.duration(value);
+	else libDate = toLibFormat(value);
+	if (!libDate) return yummies_format.format.NO_VALUE;
+	if (datePattern) return libDate.format(datePattern);
+	if (dateFormat === "human" || dateFormat === "spent-time") if ("fromNow" in libDate) return libDate.fromNow(dateFormat === "spent-time");
+	else return yummies_format.format.NO_VALUE;
+	switch (dateFormat) {
+		case "full": return libDate.format("DD MMM YYYY HH:mm:ss");
+		case "short": return libDate.format("DD MMM HH:mm");
+		case "time": return libDate.format("HH:mm:ss");
+		case "time-short": return libDate.format("HH:mm");
+		case "day": return libDate.format("DD MMM YYYY");
+		case "month": return libDate.format("MMMM YYYY");
+		default: return libDate.format("DD.MM.YYYY");
 	}
-	return wrappedDate.toDate();
-};
-/**
-* Converts milliseconds into hour-based time parts without keeping full days separately.
-*
-* @example
-* ```ts
-* timeDuration(ms(1, 'hour') + ms(30, 'min'));
-* ```
-*/
-var timeDuration = (timeInMs) => {
-	const { days, hours, milliseconds, minutes, seconds } = dayTimeDuration(timeInMs);
-	return {
-		hours: hours + yummies_ms.unitsToMs.day * days,
-		milliseconds,
-		minutes,
-		seconds
-	};
 };
+//#endregion
+//#region src/date-time/get-format-duration.ts
 var durationFormatLabels = {
 	days: {
 		compact: "д",
@@ -1067,6 +1064,8 @@ function getFormatDuration(...args) {
 	else formattedParts.push(`${seconds} ${(0, yummies_text.declension)(seconds, durationFormatLabels.seconds.full)}`);
 	return formattedParts.join(" ");
 }
+//#endregion
+//#region src/date-time/get-time-diff.ts
 /**
 * Calculates the difference between two dates in minutes, seconds and total units.
 *
@@ -1096,51 +1095,58 @@ var getTimeDiff = (dateA, dateB) => {
 		}
 	};
 };
+//#endregion
+//#region src/date-time/set-hours.ts
 /**
-* Returns a new date shifted forward by the provided number of days.
-*
-* @example
-* ```ts
-* addDays(new Date('2024-03-15'), 7);
-* ```
-*/
-var addDays = (date, count) => toLibFormat(date)?.add(count, "d").toDate();
-/**
-* Returns a new date shifted backward by the provided number of days.
+* Returns a new date with the hours field replaced.
 *
 * @example
 * ```ts
-* subtractDays(new Date('2024-03-15'), 7);
+* setHours(new Date('2024-03-15T12:00:00'), 9);
 * ```
 */
-var subtractDays = (date, count) => toLibFormat(date)?.subtract(count, "d").toDate();
+var setHours = (date, hours) => toLibFormat(date)?.set("h", hours).toDate();
+//#endregion
+//#region src/date-time/set-minutes.ts
 /**
-* Returns a new date shifted forward by the provided number of minutes.
+* Returns a new date with the minutes field replaced.
 *
 * @example
 * ```ts
-* addMinutes(new Date('2024-03-15T12:00:00'), 15);
+* setMinutes(new Date('2024-03-15T12:00:00'), 45);
 * ```
 */
-var addMinutes = (date, count) => toLibFormat(date)?.add(count, "m").toDate();
+var setMinutes = (date, minutes) => toLibFormat(date)?.set("m", minutes).toDate();
+//#endregion
+//#region src/date-time/subtract-days.ts
 /**
-* Returns a new date with the minutes field replaced.
+* Returns a new date shifted backward by the provided number of days.
 *
 * @example
 * ```ts
-* setMinutes(new Date('2024-03-15T12:00:00'), 45);
+* subtractDays(new Date('2024-03-15'), 7);
 * ```
 */
-var setMinutes = (date, minutes) => toLibFormat(date)?.set("m", minutes).toDate();
+var subtractDays = (date, count) => toLibFormat(date)?.subtract(count, "d").toDate();
+//#endregion
+//#region src/date-time/time-duration.ts
 /**
-* Returns a new date with the hours field replaced.
+* Converts milliseconds into hour-based time parts without keeping full days separately.
 *
 * @example
 * ```ts
-* setHours(new Date('2024-03-15T12:00:00'), 9);
+* timeDuration(ms(1, 'hour') + ms(30, 'min'));
 * ```
 */
-var setHours = (date, hours) => toLibFormat(date)?.set("h", hours).toDate();
+var timeDuration = (timeInMs) => {
+	const { days, hours, milliseconds, minutes, seconds } = dayTimeDuration(timeInMs);
+	return {
+		hours: hours + yummies_ms.unitsToMs.day * days,
+		milliseconds,
+		minutes,
+		seconds
+	};
+};
 //#endregion
 exports.addDays = addDays;
 exports.addMinutes = addMinutes;