chronos-date 1.0.2 → 1.1.1

package/dist/utilities-CpF3uys3.cjs

@@ -0,0 +1,88 @@
+/**
+ * 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_primitives = require('./primitives-CtuSNmV7.cjs');
+
+//#region node_modules/.pnpm/nhb-toolbox@4.30.1/node_modules/nhb-toolbox/dist/esm/guards/specials.js
+function isNumericString(value) {
+	return require_primitives.isString(value) && value?.trim() !== "" && Number.isFinite(Number(value));
+}
+
+//#endregion
+//#region node_modules/.pnpm/nhb-toolbox@4.30.1/node_modules/nhb-toolbox/dist/esm/number/constants.js
+const BN_DIGITS = /* @__PURE__ */ Object.freeze({
+	"০": 0,
+	"১": 1,
+	"২": 2,
+	"৩": 3,
+	"৪": 4,
+	"৫": 5,
+	"৬": 6,
+	"৭": 7,
+	"৮": 8,
+	"৯": 9
+});
+
+//#endregion
+//#region node_modules/.pnpm/nhb-toolbox@4.30.1/node_modules/nhb-toolbox/dist/esm/number/utilities.js
+const roundToNearest = (value, interval = 5) => {
+	return Math.round(Number(value) / interval) * interval;
+};
+const getOrdinal = (num, withNumber = true) => {
+	const remainder10 = Number(num) % 10;
+	const remainder100 = Number(num) % 100;
+	let suffix;
+	if (remainder10 === 1 && remainder100 !== 11) suffix = "st";
+	else if (remainder10 === 2 && remainder100 !== 12) suffix = "nd";
+	else if (remainder10 === 3 && remainder100 !== 13) suffix = "rd";
+	else suffix = "th";
+	return withNumber ? String(num).concat(suffix) : suffix;
+};
+function normalizeNumber(num) {
+	return require_primitives.isNumber(num) ? num : isNumericString(num) ? Number(num) : void 0;
+}
+
+//#endregion
+Object.defineProperty(exports, 'BN_DIGITS', {
+  enumerable: true,
+  get: function () {
+    return BN_DIGITS;
+  }
+});
+Object.defineProperty(exports, 'getOrdinal', {
+  enumerable: true,
+  get: function () {
+    return getOrdinal;
+  }
+});
+Object.defineProperty(exports, 'isNumericString', {
+  enumerable: true,
+  get: function () {
+    return isNumericString;
+  }
+});
+Object.defineProperty(exports, 'normalizeNumber', {
+  enumerable: true,
+  get: function () {
+    return normalizeNumber;
+  }
+});
+Object.defineProperty(exports, 'roundToNearest', {
+  enumerable: true,
+  get: function () {
+    return roundToNearest;
+  }
+});

package/dist/utilities-D47SN9EZ.cjs

@@ -0,0 +1,334 @@
+/**
+ * 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_timezone = require('./timezone-BNnHFgki.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');
+const require_helpers = require('./helpers-CQzi908i.cjs');
+
+//#region src/utils/utilities.ts
+/**
+* * Extracts the hour and minute from a time string in `HH:MM` or `-HH:MM` format.
+*
+* @param time - The time string to extract from.
+* @return The extracted hour and minute as number tuple.
+*/
+function extractHourMinute(time) {
+	const [hour, minute] = time.split(":").map(Number);
+	return [hour, minute];
+}
+/**
+* * Converts a time string `HH:MM` or `-HH:MM` into total minutes from `00:00`.
+*
+* @param time - The time in `HH:MM` or `-HH:MM` format.
+* @returns The total minutes elapsed since `00:00`.
+*/
+function getTotalMinutes(time) {
+	const isNegative = time.startsWith("-");
+	const [h, m] = extractHourMinute(isNegative ? time.slice(1) : time);
+	const total = h * 60 + m;
+	return isNegative ? -total : total;
+}
+/**
+* * Extract Time in `HH:MM` format from given UTC value.
+*
+* @param utc UTC value in `UTC-01:30` or `UTC+01:30` format.
+* @returns The UTC value in `HH:MM` format.
+*/
+function extractTimeFromUTC(utc) {
+	return utc.replace(/^UTC[+]?/g, "");
+}
+/**
+* * Converts a UTC value in `UTC-01:30` or `UTC+01:30` format into total minutes in number.
+*
+* @param time - UTC value in `UTC-01:30` or `UTC+01:30` format.
+* @returns The total minutes elapsed since `00:00`.
+*/
+function extractMinutesFromUTC(utc) {
+	return getTotalMinutes(extractTimeFromUTC(utc));
+}
+/**
+* * Converts a number of minutes into a time string in "HH:MM" format.
+*
+* @param minutes - The number of minutes to convert. Can be a number or a numeric string.
+* @returns A string representing the time in "HH:MM" format.
+*
+* @remarks Always returns the absolute value of the minutes, ignoring the sign if they are negative.
+*
+* @example
+* convertMinutesToTime(75); // "1:15"
+* convertMinutesToTime(-45); // "0:45"
+*/
+function convertMinutesToTime(minutes) {
+	const parsed = require_utilities.normalizeNumber(minutes);
+	if (require_primitives.isUndefined(parsed)) throw new TypeError(`Invalid numeric input!`, { cause: `${minutes} cannot be converted to a number.` });
+	const numMIn = Math.abs(parsed);
+	return `${String(Math.floor(numMIn / 60))}:${String(numMIn % 60).padStart(2, "0")}`;
+}
+/**
+* * Converts a minute-based offset to a UTC offset string in the format `UTC±HH:MM`.
+*
+* @param minutes - The offset in minutes (positive or negative).
+* @returns A formatted UTC offset string like `UTC+05:30` or `UTC-04:00`.
+*/
+function formatUTCOffset(minutes) {
+	const parsed = require_utilities.normalizeNumber(minutes);
+	if (require_primitives.isUndefined(parsed)) throw new TypeError(`Invalid numeric input!`, { cause: `${minutes} cannot be converted to a number.` });
+	const sign = parsed < 0 ? "-" : "+";
+	const abs = Math.abs(parsed);
+	return `UTC${sign}${String(Math.floor(abs / 60)).padStart(2, "0")}:${String(abs % 60).padStart(2, "0")}`;
+}
+/** Get the current system's time zone identifier using {@link Intl.DateTimeFormat} API. */
+function getNativeTimeZoneId() {
+	return Intl.DateTimeFormat().resolvedOptions().timeZone;
+}
+/**
+* * Retrieves comprehensive time zone details using the {@link Intl.DateTimeFormat} API.
+* @param tzId Optional timezone identifier. Defaults to the system timezone.
+* @param date Optional date for which to resolve the information.
+* @returns Object containing time zone identifier, names, and offset.
+*/
+function getTimeZoneDetails(tzId, date) {
+	const TZ_NAME_TYPES = [
+		"long",
+		"longGeneric",
+		"longOffset"
+	];
+	const $tzId = tzId || getNativeTimeZoneId();
+	const obj = { tzIdentifier: $tzId };
+	for (const type of TZ_NAME_TYPES) {
+		const key = `tzName${type[0].toUpperCase()}${type.slice(1)}`;
+		obj[key] = require_helpers._resolveNativeTzName($tzId, type, date);
+	}
+	return obj;
+}
+/** Cache for offset to time zone */
+const TZ_MAP = /* @__PURE__ */ new Map();
+/**
+* * Resolves all IANA time-zone identifiers that match a given UTC offset.
+*
+* @remarks
+* - Uses an internal in-memory cache that persists for the lifetime of the running application.
+* - The cache is lazily populated so the `offset`-to-`time-zone` mapping is computed only once per offset.
+* - Offset and time-zone identifier detection uses the {@link Intl.DateTimeFormat} API.
+*
+* @param offset The UTC offset in `"UTC±HH:MM"` format.
+* @returns An array of matching IANA time-zone identifiers, or an empty array if the offset is invalid.
+*/
+function getTimeZoneIds(offset) {
+	if (!require_guards.isValidUTCOffset(offset)) return [];
+	if (TZ_MAP.has(offset)) return TZ_MAP.get(offset) ?? [];
+	for (const zone of require_timezone.NATIVE_TZ_IDS) {
+		const off = require_helpers._gmtToUtcOffset(require_helpers._resolveNativeTzName(zone, "longOffset"));
+		if (off) TZ_MAP.set(off, [...TZ_MAP.get(off) ?? [], zone]);
+	}
+	return TZ_MAP.get(offset) ?? [];
+}
+/**
+* * Formats a date into a specified string format.
+*
+* @param options Options to control date and time formatting.
+*
+* @remarks
+* - If no date is provided, the current date and time will be used.
+* - If the provided date is invalid, the function will return `'Invalid Date!'`.
+* - The default format is `'dd, mmm DD, YYYY HH:mm:ss'` (e.g., `'Sun, Apr 06, 2025 16:11:55'`).
+* - By default, local time is used; set `useUTC` to `true` to format in UTC.
+* - The format string supports various tokens for date and time components, as well as literal text enclosed in square brackets.
+* - See {@link https://toolbox.nazmul-nhb.dev/docs/utilities/date/formatDate#format-tokens format tokens} for details on supported tokens.
+* - For more complex date/time manipulations, consider using the {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos Chronos} class.
+*
+* @returns Date/time string in specified format.
+*/
+function formatDate(options) {
+	const { date = /* @__PURE__ */ new Date(), format = "dd, mmm DD, YYYY HH:mm:ss", useUTC = false } = options ?? {};
+	const $date = require_helpers._dateArgsToDate(date);
+	if (isNaN($date.getTime())) return "Invalid Date!";
+	/** Get unit value for {@link $date} for specific unit in local or UTC time */
+	const _getUnitValue = (suffix) => {
+		return useUTC ? $date[`getUTC${suffix}`]() : $date[`get${suffix}`]();
+	};
+	return require_helpers._formatDate(format, _getUnitValue("FullYear"), _getUnitValue("Month"), _getUnitValue("Day"), _getUnitValue("Date"), _getUnitValue("Hours"), _getUnitValue("Minutes"), _getUnitValue("Seconds"), _getUnitValue("Milliseconds"), useUTC ? "Z" : formatUTCOffset(-$date.getTimezoneOffset()).slice(3));
+}
+/**
+* * Formats a time-only string into a formatted time string.
+*
+* @param time - Time string to be formatted. Supported formats include:
+* - `HH:mm` → e.g., `'14:50'`
+* - `HH:mm:ss` → e.g., `'14:50:00'`
+* - `HH:mm:ss.mss` → e.g., `'14:50:00.800'`
+* - `HH:mm+TimeZoneOffset(HH)` → e.g., `'14:50+06'`
+* - `HH:mm+TimeZoneOffset(HH:mm)` → e.g., `'14:50+06:00'`
+* - `HH:mm:ss+TimeZoneOffset(HH)` → e.g., `'14:50:00+06'`
+* - `HH:mm:ss+TimeZoneOffset(HH:mm)` → e.g., `'14:50:00+05:30'`
+* - `HH:mm:ss.mss+TimeZoneOffset(HH)` → e.g., `'14:50:00.800+06'`
+* - `HH:mm:ss.mss+TimeZoneOffset(HH:mm)` → e.g., `'14:50:00.800+06:30'`
+*
+* - *Input will default to today's date and assume local timezone if no offset is provided.*
+*
+* @param format - Format tokens accepted by {@link formatDate} method ({@link TimeOnlyFormat}) for time part only.
+*                 Default: `hh:mm:ss a` → 02:33:36 pm.
+* @returns Formatted time string in local (System) time.
+*/
+function formatTimePart(time, format) {
+	return formatDate({
+		date: `${formatDate({ format: "YYYY-MM-DD" })}T${require_helpers._normalizeOffset(time)}`,
+		format: format || "hh:mm:ss a"
+	});
+}
+/**
+* * Formats a date as a relative time string (e.g., "5m ago", "2h from now").
+*
+* @param date - The date to format, which can be a `Date` object, a date string, or a timestamp number.
+* @param format - Optional format string for dates older than 7 days. Defaults to `'mmm D, yyyy hh:mm a'`.
+* @returns A relative time string if the date is within the last 7 days, otherwise a formatted date string.
+*
+* @remarks
+* - If date is provided but `undefined`, current date and time will be used.
+* - If the provided date is invalid, the function will return `'Invalid Date!'`.
+* - For dates within the last 7 days, the output will be in the format of "Xm ago" or "Xh from now".
+* - For dates older than 7 days, the output will be formatted using the provided `format` string or the default format if none is provided.
+*
+* @example
+* formatDateRelative(Date.now() - 5 * 60000); // "5m ago"
+* formatDateRelative(Date.now() + 2 * 3600000); // "2h from now"
+* formatDateRelative(Date.now() - 10 * 86400000); // "Apr 6, 2026 04:11 PM" (formatted date string)
+*/
+function formatDateRelative(date, format) {
+	const $date = require_helpers._dateArgsToDate(date);
+	if (isNaN($date.getTime())) return "Invalid Date!";
+	const now = Date.now();
+	const then = $date.getTime();
+	const diff = Math.abs(now - then);
+	const minutes = Math.floor(diff / 6e4);
+	const hours = Math.floor(diff / 36e5);
+	const days = Math.floor(diff / 864e5);
+	const suffix = then < now ? "ago" : "from now";
+	if (minutes < 1) return "Just now";
+	if (minutes < 60) return `${minutes}m ${suffix}`;
+	if (hours < 24) return `${hours}h ${suffix}`;
+	if (days < 7) return `${days}d ${suffix}`;
+	return formatDate({
+		date,
+		format: format || "mmm D, yyyy hh:mm a"
+	});
+}
+/** Get timestamp in ISO 8601 format. */
+function getTimestamp(args, format) {
+	let $value;
+	let $format;
+	const _isTsOptions = (opt) => {
+		return require_non_primitives.isObject(opt) && ("value" in opt || "format" in opt);
+	};
+	if (_isTsOptions(args)) {
+		$value = args.value || /* @__PURE__ */ new Date();
+		$format = args.format || "utc";
+	} else {
+		$value = args || /* @__PURE__ */ new Date();
+		$format = format || "utc";
+	}
+	let date = require_helpers._dateArgsToDate($value);
+	if (isNaN(date.getTime())) date = /* @__PURE__ */ new Date();
+	if ($format === "local") {
+		const offsetMins = date.getTimezoneOffset();
+		const localDate = /* @__PURE__ */ new Date(date.getTime() - offsetMins * 6e4);
+		const offset = formatUTCOffset(-offsetMins).slice(3);
+		return localDate.toISOString().replace("Z", offset);
+	}
+	return date.toISOString();
+}
+
+//#endregion
+Object.defineProperty(exports, 'convertMinutesToTime', {
+  enumerable: true,
+  get: function () {
+    return convertMinutesToTime;
+  }
+});
+Object.defineProperty(exports, 'extractHourMinute', {
+  enumerable: true,
+  get: function () {
+    return extractHourMinute;
+  }
+});
+Object.defineProperty(exports, 'extractMinutesFromUTC', {
+  enumerable: true,
+  get: function () {
+    return extractMinutesFromUTC;
+  }
+});
+Object.defineProperty(exports, 'extractTimeFromUTC', {
+  enumerable: true,
+  get: function () {
+    return extractTimeFromUTC;
+  }
+});
+Object.defineProperty(exports, 'formatDate', {
+  enumerable: true,
+  get: function () {
+    return formatDate;
+  }
+});
+Object.defineProperty(exports, 'formatDateRelative', {
+  enumerable: true,
+  get: function () {
+    return formatDateRelative;
+  }
+});
+Object.defineProperty(exports, 'formatTimePart', {
+  enumerable: true,
+  get: function () {
+    return formatTimePart;
+  }
+});
+Object.defineProperty(exports, 'formatUTCOffset', {
+  enumerable: true,
+  get: function () {
+    return formatUTCOffset;
+  }
+});
+Object.defineProperty(exports, 'getNativeTimeZoneId', {
+  enumerable: true,
+  get: function () {
+    return getNativeTimeZoneId;
+  }
+});
+Object.defineProperty(exports, 'getTimeZoneDetails', {
+  enumerable: true,
+  get: function () {
+    return getTimeZoneDetails;
+  }
+});
+Object.defineProperty(exports, 'getTimeZoneIds', {
+  enumerable: true,
+  get: function () {
+    return getTimeZoneIds;
+  }
+});
+Object.defineProperty(exports, 'getTimestamp', {
+  enumerable: true,
+  get: function () {
+    return getTimestamp;
+  }
+});
+Object.defineProperty(exports, 'getTotalMinutes', {
+  enumerable: true,
+  get: function () {
+    return getTotalMinutes;
+  }
+});

package/dist/utils.cjs

@@ -1 +1,92 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./basic-CKxaRSHQ.cjs`),t=require(`./primitives-Db2FUp4e.cjs`),n=require(`./utilities-D2-p26DX.cjs`),r=require(`./guards.cjs`),i=require(`./utilities-B8dOAQVD.cjs`),a=require(`./greet-C-6mruI9.cjs`);function o(e,i=!1){return t.r(e)||n.a(e)?s(`${e}s`,i):r.isTimeWithUnit(e)?s(e,i):NaN}function s(n,r=!1){if(!t.n(n)||n.length>100)throw RangeError(`Value must be a string with length between 1 and 99!`);let i=/^(?<value>-?\d*\.?\d+) *(?<unit>milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|months?|mo|years?|yrs?|y)?$/i.exec(n);if(!i?.groups)return NaN;let a=(i.groups.unit??`ms`).toLowerCase(),o=e.l[a];if(!o)throw RangeError(`Unknown unit "${a}"!`);let s=parseFloat(i.groups.value)*o;return r?s/1e3:s}exports.convertMinutesToHourMinutes=i.t,exports.convertMinutesToTime=i.t,exports.getHourMinutesFromMinutes=i.t,exports.getTimeFromMinutes=i.t,exports.convertMinutesToUTCOffset=i.c,exports.formatUTCOffset=i.c,exports.minutesToUTCOffset=i.c,exports.extractHourMinute=i.n,exports.extractMinutesFromUTC=i.r,exports.getMinutesFromUTC=i.r,exports.getTotalMinutesFromUTC=i.r,exports.extractTimeFromUTC=i.i,exports.extractTimeStringFromUTC=i.i,exports.getTimeStringFromUTC=i.i,exports.extractTotalMinutesFromTime=i.p,exports.getTotalMinutes=i.p,exports.getTotalMinutesFromTime=i.p,exports.formatDate=i.a,exports.formatDateTime=i.a,exports.formatDateRelative=i.o,exports.formatRelativeDate=i.o,exports.formatRelativeTime=i.o,exports.formatTimePart=i.s,exports.generateGreeting=a.t,exports.getGreeting=a.t,exports.greet=a.t,exports.getNativeTimeZoneId=i.l,exports.getTimeZoneDetails=i.u,exports.getTimeZoneIds=i.d,exports.getTimestamp=i.f,exports.parseMSec=o,exports.parseMs=o;
+/**
+ * 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.
+ */
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_basic = require('./basic-DsQqC5nZ.cjs');
+const require_primitives = require('./primitives-CtuSNmV7.cjs');
+const require_utilities = require('./utilities-CpF3uys3.cjs');
+const require_guards = require('./guards.cjs');
+const require_utilities$1 = require('./utilities-D47SN9EZ.cjs');
+const require_greet = require('./greet-hjVsd2dt.cjs');
+
+//#region src/utils/parser.ts
+/**
+* * Parse the given value to milliseconds or optionally to seconds.
+*
+* @param value - The string (with unit) or number (or numeric string) to convert.
+* @param sec - Whether to return the value in seconds. Defaults to `false`.
+* @returns The given value parsed in milliseconds (or seconds if specified).
+*
+* @remarks
+* - A numeric value (number or numeric string ({@link Numeric})) is interpreted as seconds count, e.g., `120` or `'120'` will be treated as `'120 seconds'`.
+* - If you use time value with unit ({@link TimeWithUnit}) be sure you provide the time units (days, hours, etc.), otherwise it will return `NaN`, e.g., `'120 unknown'` will return `NaN`.
+*/
+function parseMSec(value, sec = false) {
+	if (require_primitives.isNumber(value) || require_utilities.isNumericString(value)) return _parse(`${value}s`, sec);
+	else if (require_guards.isTimeWithUnit(value)) return _parse(value, sec);
+	else return NaN;
+}
+/**
+* * Parse the given time string and return milliseconds or seconds.
+*
+* @param str - A time string to parse to milliseconds.
+* @param sec - Whether to return the value in seconds. Defaults to `false`.
+* @returns The parsed value in milliseconds (or seconds if specified), or `NaN` if the string can't be parsed.
+*/
+function _parse(str, sec = false) {
+	if (!require_primitives.isNonEmptyString(str) || str.length > 100) throw new RangeError(`Value must be a string with length between 1 and 99!`);
+	const match = /^(?<value>-?\d*\.?\d+) *(?<unit>milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|months?|mo|years?|yrs?|y)?$/i.exec(str);
+	if (!match?.groups) return NaN;
+	const unit = (match.groups.unit ?? "ms").toLowerCase();
+	const multiplier = require_basic.MS_MAP[unit];
+	if (!multiplier) throw new RangeError(`Unknown unit "${unit}"!`);
+	const ms = parseFloat(match.groups.value) * multiplier;
+	return sec ? ms / 1e3 : ms;
+}
+
+//#endregion
+exports.convertMinutesToHourMinutes = require_utilities$1.convertMinutesToTime;
+exports.convertMinutesToTime = require_utilities$1.convertMinutesToTime;
+exports.convertMinutesToUTCOffset = require_utilities$1.formatUTCOffset;
+exports.extractHourMinute = require_utilities$1.extractHourMinute;
+exports.extractMinutesFromUTC = require_utilities$1.extractMinutesFromUTC;
+exports.extractTimeFromUTC = require_utilities$1.extractTimeFromUTC;
+exports.extractTimeStringFromUTC = require_utilities$1.extractTimeFromUTC;
+exports.extractTotalMinutesFromTime = require_utilities$1.getTotalMinutes;
+exports.formatDate = require_utilities$1.formatDate;
+exports.formatDateRelative = require_utilities$1.formatDateRelative;
+exports.formatDateTime = require_utilities$1.formatDate;
+exports.formatRelativeDate = require_utilities$1.formatDateRelative;
+exports.formatRelativeTime = require_utilities$1.formatDateRelative;
+exports.formatTimePart = require_utilities$1.formatTimePart;
+exports.formatUTCOffset = require_utilities$1.formatUTCOffset;
+exports.generateGreeting = require_greet.getGreeting;
+exports.getGreeting = require_greet.getGreeting;
+exports.getHourMinutesFromMinutes = require_utilities$1.convertMinutesToTime;
+exports.getMinutesFromUTC = require_utilities$1.extractMinutesFromUTC;
+exports.getNativeTimeZoneId = require_utilities$1.getNativeTimeZoneId;
+exports.getTimeFromMinutes = require_utilities$1.convertMinutesToTime;
+exports.getTimeStringFromUTC = require_utilities$1.extractTimeFromUTC;
+exports.getTimeZoneDetails = require_utilities$1.getTimeZoneDetails;
+exports.getTimeZoneIds = require_utilities$1.getTimeZoneIds;
+exports.getTimestamp = require_utilities$1.getTimestamp;
+exports.getTotalMinutes = require_utilities$1.getTotalMinutes;
+exports.getTotalMinutesFromTime = require_utilities$1.getTotalMinutes;
+exports.getTotalMinutesFromUTC = require_utilities$1.extractMinutesFromUTC;
+exports.greet = require_greet.getGreeting;
+exports.minutesToUTCOffset = require_utilities$1.formatUTCOffset;
+exports.parseMSec = parseMSec;
+exports.parseMs = parseMSec;

package/dist/utils.d.cts

@@ -1,4 +1,20 @@
-import { At as TimeZoneDetails, Cn as Numeric, It as TimestampOptions, Mt as TimeZoneIdNative, Ot as TimeWithUnit, Rt as UTCOffset, Sn as Maybe, X as $TimeZoneIdentifier, _n as StrictFormat, at as DateFormatOptions, dt as GreetingConfigs, ft as HourMinutes, ht as ISOTimeString, it as DateArgs, pt as ISODateFormat, rt as ClockTime, yn as TimeOnlyFormat } from "./types-DPTQ_yLx.cjs";
+/**
+ * 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 { Dt as TimeWithUnit, Ft as TimestampOptions, Lt as UTCOffset, Sn as Numeric, X as $TimeZoneIdentifier, at as DateFormatOptions, dt as GreetingConfigs, ft as HourMinutes, gn as StrictFormat, it as DateArgs, jt as TimeZoneIdNative, kt as TimeZoneDetails, mt as ISODateTimeString, pt as ISODateFormat, rt as ClockTime, vn as TimeOnlyFormat, xn as Maybe } from "./types-CdmsXbU_.cjs";
 
 //#region src/utils/greet.d.ts
 /**
@@ -155,7 +171,7 @@ declare function formatDateRelative(date: Maybe<DateArgs>, format?: StrictFormat
  *
  * @returns Timestamp string in ISO 8601 format.
  */
-declare function getTimestamp(): ISOTimeString;
+declare function getTimestamp(): ISODateTimeString;
 /**
  * * Get timestamp in ISO 8601 format.
  *
@@ -171,7 +187,7 @@ declare function getTimestamp(): ISOTimeString;
  *
  * @returns Timestamp string in ISO 8601 format.
  */
-declare function getTimestamp(value: DateArgs, format?: ISODateFormat): ISOTimeString;
+declare function getTimestamp<F extends ISODateFormat = 'utc'>(value: DateArgs, format?: F): ISODateTimeString<F>;
 /**
  * * Get timestamp in ISO 8601 format.
  *
@@ -183,6 +199,6 @@ declare function getTimestamp(value: DateArgs, format?: ISODateFormat): ISOTimeS
  *
  * @returns Timestamp string in ISO 8601 format.
  */
-declare function getTimestamp(options: TimestampOptions): ISOTimeString;
+declare function getTimestamp<F extends ISODateFormat = 'utc'>(options: TimestampOptions<F>): ISODateTimeString<F>;
 //#endregion
 export { convertMinutesToTime as convertMinutesToHourMinutes, convertMinutesToTime, convertMinutesToTime as getHourMinutesFromMinutes, convertMinutesToTime as getTimeFromMinutes, formatUTCOffset as convertMinutesToUTCOffset, formatUTCOffset, formatUTCOffset as minutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractMinutesFromUTC as getMinutesFromUTC, extractMinutesFromUTC as getTotalMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, formatDate, formatDate as formatDateTime, formatDateRelative, formatDateRelative as formatRelativeDate, formatDateRelative as formatRelativeTime, formatTimePart, getGreeting as generateGreeting, getGreeting, getGreeting as greet, getNativeTimeZoneId, getTimeZoneDetails, getTimeZoneIds, getTimestamp, parseMSec, parseMSec as parseMs };

package/dist/utils.d.mts

@@ -1,4 +1,20 @@
-import { At as TimeZoneDetails, Cn as Numeric, It as TimestampOptions, Mt as TimeZoneIdNative, Ot as TimeWithUnit, Rt as UTCOffset, Sn as Maybe, X as $TimeZoneIdentifier, _n as StrictFormat, at as DateFormatOptions, dt as GreetingConfigs, ft as HourMinutes, ht as ISOTimeString, it as DateArgs, pt as ISODateFormat, rt as ClockTime, yn as TimeOnlyFormat } from "./types-B2fgrJ86.mjs";
+/**
+ * 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 { Dt as TimeWithUnit, Ft as TimestampOptions, Lt as UTCOffset, Sn as Numeric, X as $TimeZoneIdentifier, at as DateFormatOptions, dt as GreetingConfigs, ft as HourMinutes, gn as StrictFormat, it as DateArgs, jt as TimeZoneIdNative, kt as TimeZoneDetails, mt as ISODateTimeString, pt as ISODateFormat, rt as ClockTime, vn as TimeOnlyFormat, xn as Maybe } from "./types-Cb4gxrgJ.mjs";
 
 //#region src/utils/greet.d.ts
 /**
@@ -155,7 +171,7 @@ declare function formatDateRelative(date: Maybe<DateArgs>, format?: StrictFormat
  *
  * @returns Timestamp string in ISO 8601 format.
  */
-declare function getTimestamp(): ISOTimeString;
+declare function getTimestamp(): ISODateTimeString;
 /**
  * * Get timestamp in ISO 8601 format.
  *
@@ -171,7 +187,7 @@ declare function getTimestamp(): ISOTimeString;
  *
  * @returns Timestamp string in ISO 8601 format.
  */
-declare function getTimestamp(value: DateArgs, format?: ISODateFormat): ISOTimeString;
+declare function getTimestamp<F extends ISODateFormat = 'utc'>(value: DateArgs, format?: F): ISODateTimeString<F>;
 /**
  * * Get timestamp in ISO 8601 format.
  *
@@ -183,6 +199,6 @@ declare function getTimestamp(value: DateArgs, format?: ISODateFormat): ISOTimeS
  *
  * @returns Timestamp string in ISO 8601 format.
  */
-declare function getTimestamp(options: TimestampOptions): ISOTimeString;
+declare function getTimestamp<F extends ISODateFormat = 'utc'>(options: TimestampOptions<F>): ISODateTimeString<F>;
 //#endregion
 export { convertMinutesToTime as convertMinutesToHourMinutes, convertMinutesToTime, convertMinutesToTime as getHourMinutesFromMinutes, convertMinutesToTime as getTimeFromMinutes, formatUTCOffset as convertMinutesToUTCOffset, formatUTCOffset, formatUTCOffset as minutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractMinutesFromUTC as getMinutesFromUTC, extractMinutesFromUTC as getTotalMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, formatDate, formatDate as formatDateTime, formatDateRelative, formatDateRelative as formatRelativeDate, formatDateRelative as formatRelativeTime, formatTimePart, getGreeting as generateGreeting, getGreeting, getGreeting as greet, getNativeTimeZoneId, getTimeZoneDetails, getTimeZoneIds, getTimestamp, parseMSec, parseMSec as parseMs };