chronos-date 1.0.2 → 1.1.1

package/dist/helpers-CQzi908i.cjs

@@ -0,0 +1,278 @@
+/**
+ * Copyright 2026 - present Nazmul Hassan
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+const require_basic = require('./basic-DsQqC5nZ.cjs');
+const require_primitives = require('./primitives-CtuSNmV7.cjs');
+const require_non_primitives = require('./non-primitives-D9zxCwX8.cjs');
+const require_utilities = require('./utilities-CpF3uys3.cjs');
+const require_guards = require('./guards.cjs');
+
+//#region src/utils/helpers.ts
+/** Core formatting logic shared by `formatDate` and `Chronos`, `BanglaCalendar` classes */
+function _formatDateCore(format, dateComponents) {
+	const tokenRegex = new RegExp(`^(${require_basic.SORTED_TIME_FORMATS.join("|")})`);
+	let result = "";
+	let i = 0;
+	while (i < format.length) {
+		if (format[i] === "[") {
+			const end = format.indexOf("]", i);
+			if (end !== -1) {
+				result += format.slice(i + 1, end);
+				i = end + 1;
+				continue;
+			}
+		}
+		const match = tokenRegex.exec(format.slice(i));
+		if (match) {
+			result += dateComponents[match[0]] ?? match[0];
+			i += match[0].length;
+		} else {
+			result += format[i];
+			i++;
+		}
+	}
+	return result;
+}
+/** Core formatting logic shared by `formatDate` and `Chronos` class */
+function _formatDate(format, year, month, day, date, hours, minutes, seconds, milliseconds, offset) {
+	const paddedYear = _padZero(year, 4);
+	return _formatDateCore(format, {
+		YYYY: paddedYear,
+		YY: paddedYear.slice(-2),
+		yyyy: paddedYear,
+		yy: paddedYear.slice(-2),
+		M: String(month + 1),
+		MM: _padZero(month + 1),
+		mmm: require_basic.MONTHS[month].slice(0, 3),
+		mmmm: require_basic.MONTHS[month],
+		d: require_basic.DAYS[day].slice(0, 2),
+		dd: require_basic.DAYS[day].slice(0, 3),
+		ddd: require_basic.DAYS[day],
+		D: String(date),
+		DD: _padZero(date),
+		Do: require_utilities.getOrdinal(date),
+		H: String(hours),
+		HH: _padZero(hours),
+		h: String(hours % 12 || 12),
+		hh: _padZero(hours % 12 || 12),
+		m: String(minutes),
+		mm: _padZero(minutes),
+		s: String(seconds),
+		ss: _padZero(seconds),
+		ms: String(milliseconds),
+		mss: _padZero(milliseconds, 3),
+		a: hours < 12 ? "am" : "pm",
+		A: hours < 12 ? "AM" : "PM",
+		Z: offset,
+		ZZ: offset
+	});
+}
+/** Normalize a time string by adding offset at the end */
+function _normalizeOffset(timeStr) {
+	return timeStr.replace(/([+-]\d{2})(?!:)/, "$1:00");
+}
+/** Resolve `timeZoneName` value from `Intl.DateTimeFormat` */
+function _resolveNativeTzName(tzId, type, date) {
+	try {
+		return new Intl.DateTimeFormat("en", {
+			timeZone: tzId,
+			timeZoneName: type
+		}).formatToParts(date).find((p) => p.type === "timeZoneName")?.value;
+	} catch {
+		return;
+	}
+}
+/** Convert `GMT±HH:mm` string to `UTC±HH:mm` format*/
+function _gmtToUtcOffset(gmt) {
+	return gmt === "GMT" ? "UTC+00:00" : gmt?.replace(/^GMT/, "UTC");
+}
+/** Get Bangla season name by month index (`0-11`) */
+function _getBnSeason(month, locale) {
+	const season = require_basic.BN_SEASONS[Math.floor(month / 2)];
+	return locale === "en" ? season.en : season.bn;
+}
+/** Check whether a Bangla year is leap by Gregorian and Bangla years and calendar variant */
+function _isBnLeapYear(by, gy, v) {
+	return v === "revised-1966" ? by % 4 === 2 : require_guards.isLeapYear(gy);
+}
+/** Extract selective unit values from {@link Date} object */
+function _extractDateUnits(date) {
+	const month = date.getMonth();
+	return {
+		gy: date.getFullYear(),
+		$gm: month,
+		gm: month + 1,
+		gd: date.getDate(),
+		wd: date.getDay()
+	};
+}
+/** Get Gregorian base year from {@link Date} object for Bangla year */
+function _getGregBaseYear(date) {
+	const { gy, gm, gd } = _extractDateUnits(date);
+	return gm < 4 || gm === 4 && gd < 14 ? gy - 1 : gy;
+}
+/** Get Bangla year from {@link Date} object */
+function _getBnYear(date) {
+	return _getGregBaseYear(date) - 593;
+}
+/** Get timestamp in milliseconds between midnight, January 1, 1970 (UTC) and the specified {@link Date} object */
+function _getUtcTs(date) {
+	const { gy, $gm, gd } = _extractDateUnits(date);
+	return Date.UTC(gy, $gm, gd);
+}
+/** Get number of days elapsed since midnight April 14, 1970 (UTC) for specific {@link Date} */
+function _getElapsedDays(date) {
+	return Math.floor((_getUtcTs(date) - Date.UTC(_getGregBaseYear(date), 3, 14)) / require_basic.MS_PER_DAY);
+}
+/** Get number of days elapsed since midnight April 14, 1970 (UTC) and month index for specific `Date` and Bangla calendar variant */
+function _bnDaysMonthIdx(date, variant) {
+	const v = variant ?? "revised-2019";
+	const table = _isBnLeapYear(_getBnYear(date), date.getFullYear(), v) ? require_basic.BN_MONTH_TABLES?.[v].leap : require_basic.BN_MONTH_TABLES?.[v].normal;
+	let days = _getElapsedDays(date);
+	let monthIdx = 0;
+	while (days >= table[monthIdx]) {
+		days -= table[monthIdx];
+		monthIdx++;
+	}
+	return {
+		days,
+		monthIdx
+	};
+}
+/**
+* Convert number to string and pad at the start with zero (`'0'`)
+* @param value Value to convert and pad with
+* @param length Maximum length to pad, default is `2`
+* @returns The padded string
+*/
+function _padZero(value, length = 2) {
+	return String(value).padStart(length, "0");
+}
+/**
+* Pad at the start of a string with Bangla zero (`'০'`)
+* @param str String to pad with
+* @param length Maximum length to pad, default is `2`
+* @returns The padded string
+*/
+function _padShunno(str, length = 2) {
+	return str.padStart(length, "০");
+}
+/**
+* Convert a string, number, or `Date` object to a `Date` object.
+* - If the input is already a `Date`, it is returned as is.
+* - If it's a string, it is parsed into a `Date`.
+* - If it's a number or undefined, it is treated as a timestamp and converted to a `Date`.
+* @param value The date input to convert, which can be a `Date` object, a date string, a timestamp number, or undefined (which defaults to the current date and time).
+* @returns A `Date` object representing the input date.
+*/
+function _dateArgsToDate(value) {
+	return require_guards.isDate(value) ? value : new Date(require_primitives.isString(value) ? value.replace(/['"]/g, "") : value ?? Date.now());
+}
+/**
+* Type guard to check if a value has the necessary properties to be reconstructed into a `Chronos` instance.
+* - Validates that the value is an object with the required keys and that the `native` property is a valid date or date string, and that the `utcOffset` is valid.
+* @param value The value to check for reconstructability.
+* @returns `true` if the value has the required properties for reconstruction, otherwise `false`.
+*/
+function _hasChronosProperties(value) {
+	return require_non_primitives.isObjectWithKeys(value, [
+		"origin",
+		"native",
+		"utcOffset",
+		"timeZoneName",
+		"timeZoneId"
+	]) && require_primitives.isNonEmptyString(value.origin) && (require_guards.isDate(value.native) || require_guards.isDateString(value.native)) && require_guards.isValidUTCOffset(value.utcOffset) && require_primitives.isNonEmptyString(value.timeZoneName) && (require_primitives.isNonEmptyString(value.timeZoneId) || require_non_primitives.isValidArray(value.timeZoneId));
+}
+
+//#endregion
+Object.defineProperty(exports, '_bnDaysMonthIdx', {
+  enumerable: true,
+  get: function () {
+    return _bnDaysMonthIdx;
+  }
+});
+Object.defineProperty(exports, '_dateArgsToDate', {
+  enumerable: true,
+  get: function () {
+    return _dateArgsToDate;
+  }
+});
+Object.defineProperty(exports, '_formatDate', {
+  enumerable: true,
+  get: function () {
+    return _formatDate;
+  }
+});
+Object.defineProperty(exports, '_formatDateCore', {
+  enumerable: true,
+  get: function () {
+    return _formatDateCore;
+  }
+});
+Object.defineProperty(exports, '_getBnSeason', {
+  enumerable: true,
+  get: function () {
+    return _getBnSeason;
+  }
+});
+Object.defineProperty(exports, '_getBnYear', {
+  enumerable: true,
+  get: function () {
+    return _getBnYear;
+  }
+});
+Object.defineProperty(exports, '_gmtToUtcOffset', {
+  enumerable: true,
+  get: function () {
+    return _gmtToUtcOffset;
+  }
+});
+Object.defineProperty(exports, '_hasChronosProperties', {
+  enumerable: true,
+  get: function () {
+    return _hasChronosProperties;
+  }
+});
+Object.defineProperty(exports, '_isBnLeapYear', {
+  enumerable: true,
+  get: function () {
+    return _isBnLeapYear;
+  }
+});
+Object.defineProperty(exports, '_normalizeOffset', {
+  enumerable: true,
+  get: function () {
+    return _normalizeOffset;
+  }
+});
+Object.defineProperty(exports, '_padShunno', {
+  enumerable: true,
+  get: function () {
+    return _padShunno;
+  }
+});
+Object.defineProperty(exports, '_padZero', {
+  enumerable: true,
+  get: function () {
+    return _padZero;
+  }
+});
+Object.defineProperty(exports, '_resolveNativeTzName', {
+  enumerable: true,
+  get: function () {
+    return _resolveNativeTzName;
+  }
+});

package/dist/helpers-DEf4sevD.mjs

@@ -0,0 +1,201 @@
+/**
+ * Copyright 2026 - present Nazmul Hassan
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { c as MONTHS, d as SORTED_TIME_FORMATS, i as BN_SEASONS, o as DAYS, r as BN_MONTH_TABLES, u as MS_PER_DAY } from "./basic-DqKyujoj.mjs";
+import { i as isString, n as isNonEmptyString } from "./primitives-dXzXlzJw.mjs";
+import { a as isValidArray, i as isObjectWithKeys } from "./non-primitives-DBtomDty.mjs";
+import { t as getOrdinal } from "./utilities-BKtVo78T.mjs";
+import { isDate, isDateString, isLeapYear, isValidUTCOffset } from "./guards.mjs";
+
+//#region src/utils/helpers.ts
+/** Core formatting logic shared by `formatDate` and `Chronos`, `BanglaCalendar` classes */
+function _formatDateCore(format, dateComponents) {
+	const tokenRegex = new RegExp(`^(${SORTED_TIME_FORMATS.join("|")})`);
+	let result = "";
+	let i = 0;
+	while (i < format.length) {
+		if (format[i] === "[") {
+			const end = format.indexOf("]", i);
+			if (end !== -1) {
+				result += format.slice(i + 1, end);
+				i = end + 1;
+				continue;
+			}
+		}
+		const match = tokenRegex.exec(format.slice(i));
+		if (match) {
+			result += dateComponents[match[0]] ?? match[0];
+			i += match[0].length;
+		} else {
+			result += format[i];
+			i++;
+		}
+	}
+	return result;
+}
+/** Core formatting logic shared by `formatDate` and `Chronos` class */
+function _formatDate(format, year, month, day, date, hours, minutes, seconds, milliseconds, offset) {
+	const paddedYear = _padZero(year, 4);
+	return _formatDateCore(format, {
+		YYYY: paddedYear,
+		YY: paddedYear.slice(-2),
+		yyyy: paddedYear,
+		yy: paddedYear.slice(-2),
+		M: String(month + 1),
+		MM: _padZero(month + 1),
+		mmm: MONTHS[month].slice(0, 3),
+		mmmm: MONTHS[month],
+		d: DAYS[day].slice(0, 2),
+		dd: DAYS[day].slice(0, 3),
+		ddd: DAYS[day],
+		D: String(date),
+		DD: _padZero(date),
+		Do: getOrdinal(date),
+		H: String(hours),
+		HH: _padZero(hours),
+		h: String(hours % 12 || 12),
+		hh: _padZero(hours % 12 || 12),
+		m: String(minutes),
+		mm: _padZero(minutes),
+		s: String(seconds),
+		ss: _padZero(seconds),
+		ms: String(milliseconds),
+		mss: _padZero(milliseconds, 3),
+		a: hours < 12 ? "am" : "pm",
+		A: hours < 12 ? "AM" : "PM",
+		Z: offset,
+		ZZ: offset
+	});
+}
+/** Normalize a time string by adding offset at the end */
+function _normalizeOffset(timeStr) {
+	return timeStr.replace(/([+-]\d{2})(?!:)/, "$1:00");
+}
+/** Resolve `timeZoneName` value from `Intl.DateTimeFormat` */
+function _resolveNativeTzName(tzId, type, date) {
+	try {
+		return new Intl.DateTimeFormat("en", {
+			timeZone: tzId,
+			timeZoneName: type
+		}).formatToParts(date).find((p) => p.type === "timeZoneName")?.value;
+	} catch {
+		return;
+	}
+}
+/** Convert `GMT±HH:mm` string to `UTC±HH:mm` format*/
+function _gmtToUtcOffset(gmt) {
+	return gmt === "GMT" ? "UTC+00:00" : gmt?.replace(/^GMT/, "UTC");
+}
+/** Get Bangla season name by month index (`0-11`) */
+function _getBnSeason(month, locale) {
+	const season = BN_SEASONS[Math.floor(month / 2)];
+	return locale === "en" ? season.en : season.bn;
+}
+/** Check whether a Bangla year is leap by Gregorian and Bangla years and calendar variant */
+function _isBnLeapYear(by, gy, v) {
+	return v === "revised-1966" ? by % 4 === 2 : isLeapYear(gy);
+}
+/** Extract selective unit values from {@link Date} object */
+function _extractDateUnits(date) {
+	const month = date.getMonth();
+	return {
+		gy: date.getFullYear(),
+		$gm: month,
+		gm: month + 1,
+		gd: date.getDate(),
+		wd: date.getDay()
+	};
+}
+/** Get Gregorian base year from {@link Date} object for Bangla year */
+function _getGregBaseYear(date) {
+	const { gy, gm, gd } = _extractDateUnits(date);
+	return gm < 4 || gm === 4 && gd < 14 ? gy - 1 : gy;
+}
+/** Get Bangla year from {@link Date} object */
+function _getBnYear(date) {
+	return _getGregBaseYear(date) - 593;
+}
+/** Get timestamp in milliseconds between midnight, January 1, 1970 (UTC) and the specified {@link Date} object */
+function _getUtcTs(date) {
+	const { gy, $gm, gd } = _extractDateUnits(date);
+	return Date.UTC(gy, $gm, gd);
+}
+/** Get number of days elapsed since midnight April 14, 1970 (UTC) for specific {@link Date} */
+function _getElapsedDays(date) {
+	return Math.floor((_getUtcTs(date) - Date.UTC(_getGregBaseYear(date), 3, 14)) / MS_PER_DAY);
+}
+/** Get number of days elapsed since midnight April 14, 1970 (UTC) and month index for specific `Date` and Bangla calendar variant */
+function _bnDaysMonthIdx(date, variant) {
+	const v = variant ?? "revised-2019";
+	const table = _isBnLeapYear(_getBnYear(date), date.getFullYear(), v) ? BN_MONTH_TABLES?.[v].leap : BN_MONTH_TABLES?.[v].normal;
+	let days = _getElapsedDays(date);
+	let monthIdx = 0;
+	while (days >= table[monthIdx]) {
+		days -= table[monthIdx];
+		monthIdx++;
+	}
+	return {
+		days,
+		monthIdx
+	};
+}
+/**
+* Convert number to string and pad at the start with zero (`'0'`)
+* @param value Value to convert and pad with
+* @param length Maximum length to pad, default is `2`
+* @returns The padded string
+*/
+function _padZero(value, length = 2) {
+	return String(value).padStart(length, "0");
+}
+/**
+* Pad at the start of a string with Bangla zero (`'০'`)
+* @param str String to pad with
+* @param length Maximum length to pad, default is `2`
+* @returns The padded string
+*/
+function _padShunno(str, length = 2) {
+	return str.padStart(length, "০");
+}
+/**
+* Convert a string, number, or `Date` object to a `Date` object.
+* - If the input is already a `Date`, it is returned as is.
+* - If it's a string, it is parsed into a `Date`.
+* - If it's a number or undefined, it is treated as a timestamp and converted to a `Date`.
+* @param value The date input to convert, which can be a `Date` object, a date string, a timestamp number, or undefined (which defaults to the current date and time).
+* @returns A `Date` object representing the input date.
+*/
+function _dateArgsToDate(value) {
+	return isDate(value) ? value : new Date(isString(value) ? value.replace(/['"]/g, "") : value ?? Date.now());
+}
+/**
+* Type guard to check if a value has the necessary properties to be reconstructed into a `Chronos` instance.
+* - Validates that the value is an object with the required keys and that the `native` property is a valid date or date string, and that the `utcOffset` is valid.
+* @param value The value to check for reconstructability.
+* @returns `true` if the value has the required properties for reconstruction, otherwise `false`.
+*/
+function _hasChronosProperties(value) {
+	return isObjectWithKeys(value, [
+		"origin",
+		"native",
+		"utcOffset",
+		"timeZoneName",
+		"timeZoneId"
+	]) && isNonEmptyString(value.origin) && (isDate(value.native) || isDateString(value.native)) && isValidUTCOffset(value.utcOffset) && isNonEmptyString(value.timeZoneName) && (isNonEmptyString(value.timeZoneId) || isValidArray(value.timeZoneId));
+}
+
+//#endregion
+export { _getBnSeason as a, _hasChronosProperties as c, _padShunno as d, _padZero as f, _formatDateCore as i, _isBnLeapYear as l, _dateArgsToDate as n, _getBnYear as o, _resolveNativeTzName as p, _formatDate as r, _gmtToUtcOffset as s, _bnDaysMonthIdx as t, _normalizeOffset as u };