chronos-date 2.0.2 → 2.1.0

package/README.md

@@ -131,9 +131,15 @@ For full documentation, API reference, and interactive playgrounds, visit the [*
 
 ## 🔗 Related Packages
 
+<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+  <a target="_blank" href="https://www.npmjs.com/package/toolbox-x">
+    <img src="https://img.shields.io/badge/Toolbox--X-toolbox--x-steelblue" alt="toolbox-x" />
+  </a>
+</div>
+
 <div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
   <a target="_blank" href="https://www.npmjs.com/package/nhb-toolbox">
-    <img src="https://img.shields.io/badge/NHB_Toolbox-nhb--toolbox-steelblue" alt="nhb-toolbox" />
+    <img src="https://img.shields.io/badge/NHB_Toolbox-nhb--toolbox-darkred" alt="nhb-toolbox" />
   </a>
 </div>
 
@@ -177,7 +183,11 @@ For full documentation, API reference, and interactive playgrounds, visit the [*
 
 ## License
 
-This project is licensed under the [Apache License 2.0](LICENSE).
+This project is licensed under the [Apache License 2.0](LICENSE) with the following additional requirement:
+
+**Additional Requirement:**
+
+> Any fork, derivative work, or redistribution of this project must include clear attribution to [**Nazmul Hassan**](https://github.com/nazmul-nhb) in both the source code and any publicly available documentation.
 
 You are free to use, modify, and distribute this project under the terms of the Apache 2.0 License, provided that appropriate credit is given.
 

package/dist/constants.d.mts

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 
-import { L as VEDIC_ZODIAC_SIGNS, M as MONTHS, R as WESTERN_ZODIAC_SIGNS, _ as TIME_ZONE_LABELS, a as INDIA_IMD_SEASONS, c as JAPAN_SEASONS, d as US_ACADEMIC_SEASONS, f as IANA_TZ_IDS, g as TIME_ZONE_IDS, h as TIME_ZONES_NATIVE, i as ETHIOPIA_SEASONS, l as PHILIPPINES_SEASONS, m as TIME_ZONES, n as BANGLADESH_SEASONS, o as INDIA_TAMIL_SEASONS, p as NATIVE_TZ_IDS, r as DEFAULT_SEASONS, s as INDIA_VEDIC_SEASONS, t as AUSTRALIA_SEASONS, u as SEASON_PRESETS, w as DAYS } from "./seasons-B_kjFWIX.mjs";
+import { L as VEDIC_ZODIAC_SIGNS, M as MONTHS, R as WESTERN_ZODIAC_SIGNS, _ as TIME_ZONE_LABELS, a as INDIA_IMD_SEASONS, c as JAPAN_SEASONS, d as US_ACADEMIC_SEASONS, f as IANA_TZ_IDS, g as TIME_ZONE_IDS, h as TIME_ZONES_NATIVE, i as ETHIOPIA_SEASONS, l as PHILIPPINES_SEASONS, m as TIME_ZONES, n as BANGLADESH_SEASONS, o as INDIA_TAMIL_SEASONS, p as NATIVE_TZ_IDS, r as DEFAULT_SEASONS, s as INDIA_VEDIC_SEASONS, t as AUSTRALIA_SEASONS, u as SEASON_PRESETS, w as DAYS } from "./seasons-DYk2jvtn.mjs";
 export { AUSTRALIA_SEASONS, BANGLADESH_SEASONS, ETHIOPIA_SEASONS, IANA_TZ_IDS, INDIA_IMD_SEASONS, INDIA_TAMIL_SEASONS, INDIA_VEDIC_SEASONS, JAPAN_SEASONS, MONTHS, NATIVE_TZ_IDS, PHILIPPINES_SEASONS, SEASON_PRESETS, TIME_ZONES, TIME_ZONES as TZ_ABBREVIATIONS, TIME_ZONES_NATIVE, TIME_ZONE_IDS, TIME_ZONE_LABELS, US_ACADEMIC_SEASONS, VEDIC_ZODIAC_SIGNS, DAYS as WEEK_DAYS, DEFAULT_SEASONS as WESTERN_SEASONS, WESTERN_ZODIAC_SIGNS };

package/dist/convert-C8LsoKmI-Blf3eLS6.mjs

@@ -0,0 +1,285 @@
+/**
+ * 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.
+ */
+
+//#region node_modules/.pnpm/toolbox-x@1.0.1-rc.6/node_modules/toolbox-x/dist/primitives-Djsevc69.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.
+*/
+/**
+* * Type guard to check whether a value is a finite number (excluding `NaN` and `Infinity`).
+* @param value - The value to test.
+* @returns `true` if the value is a finite number; otherwise `false`.
+*/
+function isNumber(value) {
+	return typeof value === "number" && Number.isFinite(value);
+}
+/**
+* * Type guard to check if a value is a string.
+* @param value - The value to check.
+* @returns `true` if the value is a string, otherwise `false`.
+*/
+function isString(value) {
+	return typeof value === "string";
+}
+/**
+* * Type guard to check if a value is a boolean.
+* @param value - The value to check.
+* @returns `true` if the value is a boolean, otherwise `false`.
+*/
+function isBoolean(value) {
+	return typeof value === "boolean";
+}
+/**
+* * Type guard to check if a value is undefined.
+* @param value - The value to check.
+* @returns `true` if the value is undefined, otherwise `false`.
+*/
+function isUndefined(value) {
+	return value === void 0;
+}
+/**
+* * Type guard to check if a value is a non-empty string.
+* @param value - The value to check.
+* @returns `true` if the value is a non-empty string, otherwise `false`.
+*/
+function isNonEmptyString(value) {
+	return isString(value) && value?.length > 0;
+}
+
+//#endregion
+//#region node_modules/.pnpm/toolbox-x@1.0.1-rc.6/node_modules/toolbox-x/dist/constants-ZyfpysiQ.mjs
+/** * Bangla digits from `০-৯` mapped against `0-9` */
+const BN_DIGITS = /* @__PURE__ */ Object.freeze({
+	"০": 0,
+	"১": 1,
+	"২": 2,
+	"৩": 3,
+	"৪": 4,
+	"৫": 5,
+	"৬": 6,
+	"৭": 7,
+	"৮": 8,
+	"৯": 9
+});
+
+//#endregion
+//#region node_modules/.pnpm/toolbox-x@1.0.1-rc.6/node_modules/toolbox-x/dist/specials-Cye93-uo.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.
+*/
+/**
+* * Type guard to check if a value is an array.
+* @param value - The value to check.
+* @returns `true` if the value is an array, otherwise `false`.
+*/
+function isArray(value) {
+	return Array.isArray(value);
+}
+/**
+* * Type guard to check if a value is an array with length.
+* @param value - The value to check.
+* @returns `true` if the value is an array with length, otherwise `false`.
+*/
+function isValidArray(value) {
+	return Array.isArray(value) && value?.length > 0;
+}
+/**
+* * Type guard to check if a value is an object (excluding null).
+* @param value - The value to check.
+* @returns `true` if the value is an object, otherwise `false`.
+*/
+function isObject(value) {
+	return value !== null && typeof value === "object" && !isArray(value);
+}
+/**
+* * Type guard to check if a value is an object (excluding null) and has keys in it.
+* @param value - The value to check.
+* @returns `true` if the value is an object with valid keys, otherwise `false`.
+*/
+function isNotEmptyObject(value) {
+	return isObject(value) && Object.keys(value)?.length > 0;
+}
+/**
+* * Type guard to check if a value is an object with specific keys.
+* @param value - The value to check.
+* @param keys - The list of keys the object should contain.
+* @returns `true` if the value is an object with the specified keys, otherwise `false`.
+*/
+function isObjectWithKeys(value, keys) {
+	return isObject(value) && keys?.every((key) => key in value);
+}
+/**
+* * Type guard to check if a value is a function.
+* @param value - The value to check.
+* @returns `true` if the value is a function, otherwise `false`.
+*/
+function isFunction(value) {
+	return typeof value === "function";
+}
+/**
+* * Type guard to check if a value is a string representing a finite number.
+*
+* @remarks
+* - Accepts strings like: `"42"`, `"  -5.5 "`, `"0.123"`, `"-0"`, `"1e5"`.
+* - Rejects strings like: `"NaN"`, `"Infinity"`, `"-Infinity"`, `"abc"`, `""`, `"42abc"`.
+*
+* @param value - The value to test.
+* @returns `true` if the value is a string that fully represents a finite number.
+*/
+function isNumericString(value) {
+	return isString(value) && value?.trim() !== "" && Number.isFinite(Number(value));
+}
+
+//#endregion
+//#region node_modules/.pnpm/toolbox-x@1.0.1-rc.6/node_modules/toolbox-x/dist/utilities-B9axOvOX.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.
+*/
+/**
+* * Rounds a number to the nearest specified interval.
+* @param value - The number to round.
+* @param interval - The interval to round to. Defaults to `5`.
+* @returns The number rounded to the nearest interval.
+* @example roundToNearest(27, 5) → 25
+*/
+const roundToNearest = (value, interval = 5) => {
+	return Math.round(Number(value) / interval) * interval;
+};
+/**
+* * Returns the ordinal suffix for a given number (e.g., 1 -> 'st', 2 -> 'nd', 3 -> 'rd', 4 -> 'th' etc.).
+* @description The function handles special cases for 11, 12, and 13, which all use 'th' despite the last digit.
+* If the `withNumber` parameter is `true`, the function returns the number along with its ordinal suffix (e.g., "1st").
+* Otherwise, it returns only the ordinal suffix (e.g., "st").
+*
+* @param num - The number or number string to get the ordinal suffix for.
+* @param withNumber - Whether to include the number along with its ordinal suffix (defaults to `true`).
+* @returns The appropriate ordinal suffix, optionally with the number (e.g., '1st' or 'st`, '2nd' or 'nd' and so on.).
+*/
+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;
+};
+/**
+* * Normalize a number or numeric string to a number.
+* @description
+* This function checks if the input is a number or a numeric string and converts it to a number.
+* If the input is not a valid number or numeric string, it returns `undefined`.
+* @param num - The number to normalize.
+* @returns The normalized number or `undefined` if the input is not a valid number or numeric string.
+*/
+function normalizeNumber(num) {
+	return isNumber(num) ? num : isNumericString(num) ? Number(num) : void 0;
+}
+
+//#endregion
+//#region node_modules/.pnpm/toolbox-x@1.0.1-rc.6/node_modules/toolbox-x/dist/basics-DQe9mP_M.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.
+*/
+/**
+* * Trims all the words in a string or an array of strings.
+*
+* @param input String or array of strings.
+* @returns Trimmed string or array of strings.
+*/
+function trimString(input) {
+	if (!input) return "";
+	if (isNonEmptyString(input)) return input.trim().replace(/\s+/g, " ");
+	if (Array.isArray(input)) return input.map((str) => isNonEmptyString(str) ? str.trim().replace(/\s+/g, " ") : str);
+	throw new TypeError("Expected string or array of strings!", { cause: "Invalid Input Type" });
+}
+
+//#endregion
+//#region node_modules/.pnpm/toolbox-x@1.0.1-rc.6/node_modules/toolbox-x/dist/convert-C8LsoKmI.mjs
+/**
+* * Reverses a given string.
+* @param input - The string to reverse.
+* @returns The reversed string.
+*/
+const reverseString = (input) => {
+	return trimString(input)?.split("")?.reverse()?.join("");
+};
+/**
+* * Returns a grammatically correct unit string, optionally prefixed with the number.
+*
+* @remarks For complex and versatile pluralization, please refer to {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/string/pluralizer pluralizer} or {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/Pluralizer Pluralizer Class} instead.
+*
+* @param count The numeric value to determine singular or plural.
+* @param unit The unit name (e.g., "day", "hour").
+* @param withNumber Whether to prefix the count before the unit. Defaults to `true`.
+* @returns Formatted unit string like `"1 day"`, `"2 months"`, or `"hour"`.
+*/
+function formatUnitWithPlural(count, unit, withNumber = true) {
+	const pluralized = Math.abs(count) === 1 ? unit : `${unit}s`;
+	return withNumber ? `${count} ${pluralized}` : pluralized;
+}
+
+//#endregion
+export { isUndefined as _, roundToNearest as a, isNumericString as c, isValidArray as d, BN_DIGITS as f, isString as g, isNumber as h, normalizeNumber as i, isObject as l, isNonEmptyString as m, reverseString as n, isFunction as o, isBoolean as p, getOrdinal as r, isNotEmptyObject as s, formatUnitWithPlural as t, isObjectWithKeys as u };