bn-calendar 1.2.2 → 1.2.4

package/README.md

@@ -96,10 +96,10 @@ import { BanglaCalendar } from 'bn-calendar';
 - [Quick Examples](#quick-examples)
 - [API Reference](#api-reference)
   - [Constructor](#constructor)
-  - [Constructor Signatures](#constructor-signatures)
-  - [Parameters](#parameters)
-  - [Behavior](#behavior)
-  - [Examples](#examples)
+    - [Constructor Signatures](#constructor-signatures)
+    - [Parameters](#parameters)
+    - [Behavior](#behavior)
+    - [Examples](#examples)
   - [Properties](#properties)
     - [variant](#variant)
     - [year](#year)
@@ -191,7 +191,7 @@ const date5 = new BanglaCalendar('১৪৩০', '১', '১', { variant: 'revis
 
 Creates a new `BanglaCalendar` instance from various input formats.
 
-### Constructor Signatures
+#### Constructor Signatures
 
 **Signature 1:** From current date with optional configuration
 
@@ -257,7 +257,7 @@ constructor(
 )
 ```
 
-### Parameters
+#### Parameters
 
 - `date`: Various date formats including Bangla date strings, Gregorian date strings, Date objects, timestamps, or individual date components
 - `bnYear`: Bengali year in either Bangla (`০-৯৯৯৯`) or Latin (`0-9999`) digits
@@ -265,7 +265,7 @@ constructor(
 - `bnDate`: Bengali day of month (1-31 or `১-৩১`)
 - `config`: Optional configuration object with `variant` property (`'revised-2019'` or `'revised-1966'`)
 
-### Behavior
+#### Behavior
 
 - Automatically detects input format and parses accordingly
 - Defaults to current date if no valid input is provided
@@ -273,7 +273,7 @@ constructor(
 - Validates all date components
 - Handles leap years according to the selected variant
 
-### Examples
+#### Examples
 
 ```typescript
 // Current date
@@ -1497,7 +1497,7 @@ import { banglaToDigit, digitToBangla } from 'bn-calendar/utils'
 
 > [!NOTE]
 >
-> `banglaToDigit()` and `digitToBangla()` functions are imported from the [**nhb-toolbox**](https://toolbox.nazmul-nhb.dev/) package.
+> `banglaToDigit()` and `digitToBangla()` functions are imported from the [**toolbox-x**](https://toolbox-x.nazmul-nhb.dev/) package.
 
 The digit conversion utilities provide seamless conversion between Bangla (Bengali) digits (`০-৯`) and Latin (Arabic) digits (`0-9`). These functions are essential for applications that need to handle multilingual numeric representations, particularly in Bengali-language interfaces.
 

package/dist/dist-BSh0fQzq.mjs

@@ -0,0 +1,255 @@
+/**
+ * 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 an integer.
+* @param value - The value to check.
+* @returns `true` if the value is an integer, otherwise `false`.
+*/
+function isInteger(value) {
+	return isNumber(value) && Number.isInteger(value);
+}
+/**
+* * 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 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 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 valid date string.
+* @param value - The value to check.
+* @returns `true` if the value is a valid date string, otherwise `false`.
+*/
+function isDateString(value) {
+	return isString(value) && !isNaN(Date.parse(value));
+}
+/**
+* * 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.
+*/
+/**
+* * 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/index.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.
+*/
+/**
+* * Converts Bangla (Arabic system) digits to Latin (Arabic system) digits.
+*
+* @remarks
+* - Behavior depends on the `forceNumber` flag:
+*   - When `forceNumber` is `true`, always returns a `number` (strips non-digit characters).
+* 	   - Returns `NaN` if the input is non empty string or does not include any numeric string.
+*   - When `forceNumber` is `false`, always returns a string, including non-digit characters.
+* 	   - Returns empty string if the input is non empty string.
+*
+* @param bnDigit - A string containing Bangla (Arabic system) digits.
+* @param forceNumber - Whether to force number conversion even if the input includes non-digit character(s). Default is `false`.
+*
+* @example
+* banglaToDigit('১২৩abc'); // 123
+* banglaToDigit(''); // NaN
+* banglaToDigit('৪৫৬');    // 456
+*
+* @example
+* banglaToDigit('১২৩', false);	// "123"
+* banglaToDigit('১২৩abc', false);	// "123abc"
+*/
+function banglaToDigit(bnDigit, forceNumber = true) {
+	if (!isNonEmptyString(bnDigit)) return forceNumber ? NaN : "";
+	const digitStr = bnDigit.replace(/[০১২৩৪৫৬৭৮৯]/g, (d) => String(BN_DIGITS[d]));
+	if (forceNumber) return Number(digitStr.split("").filter((dig) => !isNaN(Number(dig))).join(""));
+	return digitStr;
+}
+/**
+* * Converts Latin (Arabic system) digits to Bangla digits (Arabic system).
+*
+* @remarks
+* - Accepts numbers or numeric strings including non-digit characters.
+* - When `preserveNonDigit` is `true`, non-digit characters are preserved in the output.
+* - When `preserveNonDigit` is `false`, non-numeric strings are stripped.
+* - Returns empty string for invalid input.
+*
+* @param digit - A number or string containing Latin (Arabic system) digits.
+* @param preserveNonDigit - Whether to preserve non-digit characters in the output. Default is `true`.
+*
+* @example
+* digitToBangla(123);          // "১২৩"
+* digitToBangla('456');        // "৪৫৬"
+*
+* @example
+* digitToBangla('12ab', false);	// "১২"
+* digitToBangla('12ab');		// "১২ab"
+*/
+function digitToBangla(digit, preserveNonDigit = true) {
+	const banglaDigits = Object.keys(BN_DIGITS);
+	const _matchAndConvert = (value) => {
+		return value.replace(/\d/g, (dig) => banglaDigits[Number(dig)]);
+	};
+	if (isNumber(digit)) return _matchAndConvert(String(digit));
+	if (isNonEmptyString(digit)) {
+		const bnDigStr = _matchAndConvert(digit);
+		if (preserveNonDigit || isNumericString(digit)) return bnDigStr;
+		return bnDigStr.split("").filter((dig) => banglaDigits.includes(dig)).join("");
+	}
+	return "";
+}
+
+//#endregion
+export { isObjectWithKeys as a, isNumber as c, isDateString as i, digitToBangla as n, isInteger as o, normalizeNumber as r, isNonEmptyString as s, banglaToDigit as t };

package/dist/dist-BasKGWW6.cjs

@@ -0,0 +1,303 @@
+/**
+ * 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 an integer.
+* @param value - The value to check.
+* @returns `true` if the value is an integer, otherwise `false`.
+*/
+function isInteger(value) {
+	return isNumber(value) && Number.isInteger(value);
+}
+/**
+* * 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 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 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 valid date string.
+* @param value - The value to check.
+* @returns `true` if the value is a valid date string, otherwise `false`.
+*/
+function isDateString(value) {
+	return isString(value) && !isNaN(Date.parse(value));
+}
+/**
+* * 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.
+*/
+/**
+* * 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/index.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.
+*/
+/**
+* * Converts Bangla (Arabic system) digits to Latin (Arabic system) digits.
+*
+* @remarks
+* - Behavior depends on the `forceNumber` flag:
+*   - When `forceNumber` is `true`, always returns a `number` (strips non-digit characters).
+* 	   - Returns `NaN` if the input is non empty string or does not include any numeric string.
+*   - When `forceNumber` is `false`, always returns a string, including non-digit characters.
+* 	   - Returns empty string if the input is non empty string.
+*
+* @param bnDigit - A string containing Bangla (Arabic system) digits.
+* @param forceNumber - Whether to force number conversion even if the input includes non-digit character(s). Default is `false`.
+*
+* @example
+* banglaToDigit('১২৩abc'); // 123
+* banglaToDigit(''); // NaN
+* banglaToDigit('৪৫৬');    // 456
+*
+* @example
+* banglaToDigit('১২৩', false);	// "123"
+* banglaToDigit('১২৩abc', false);	// "123abc"
+*/
+function banglaToDigit(bnDigit, forceNumber = true) {
+	if (!isNonEmptyString(bnDigit)) return forceNumber ? NaN : "";
+	const digitStr = bnDigit.replace(/[০১২৩৪৫৬৭৮৯]/g, (d) => String(BN_DIGITS[d]));
+	if (forceNumber) return Number(digitStr.split("").filter((dig) => !isNaN(Number(dig))).join(""));
+	return digitStr;
+}
+/**
+* * Converts Latin (Arabic system) digits to Bangla digits (Arabic system).
+*
+* @remarks
+* - Accepts numbers or numeric strings including non-digit characters.
+* - When `preserveNonDigit` is `true`, non-digit characters are preserved in the output.
+* - When `preserveNonDigit` is `false`, non-numeric strings are stripped.
+* - Returns empty string for invalid input.
+*
+* @param digit - A number or string containing Latin (Arabic system) digits.
+* @param preserveNonDigit - Whether to preserve non-digit characters in the output. Default is `true`.
+*
+* @example
+* digitToBangla(123);          // "১২৩"
+* digitToBangla('456');        // "৪৫৬"
+*
+* @example
+* digitToBangla('12ab', false);	// "১২"
+* digitToBangla('12ab');		// "১২ab"
+*/
+function digitToBangla(digit, preserveNonDigit = true) {
+	const banglaDigits = Object.keys(BN_DIGITS);
+	const _matchAndConvert = (value) => {
+		return value.replace(/\d/g, (dig) => banglaDigits[Number(dig)]);
+	};
+	if (isNumber(digit)) return _matchAndConvert(String(digit));
+	if (isNonEmptyString(digit)) {
+		const bnDigStr = _matchAndConvert(digit);
+		if (preserveNonDigit || isNumericString(digit)) return bnDigStr;
+		return bnDigStr.split("").filter((dig) => banglaDigits.includes(dig)).join("");
+	}
+	return "";
+}
+
+//#endregion
+Object.defineProperty(exports, 'banglaToDigit', {
+  enumerable: true,
+  get: function () {
+    return banglaToDigit;
+  }
+});
+Object.defineProperty(exports, 'digitToBangla', {
+  enumerable: true,
+  get: function () {
+    return digitToBangla;
+  }
+});
+Object.defineProperty(exports, 'isDateString', {
+  enumerable: true,
+  get: function () {
+    return isDateString;
+  }
+});
+Object.defineProperty(exports, 'isInteger', {
+  enumerable: true,
+  get: function () {
+    return isInteger;
+  }
+});
+Object.defineProperty(exports, 'isNonEmptyString', {
+  enumerable: true,
+  get: function () {
+    return isNonEmptyString;
+  }
+});
+Object.defineProperty(exports, 'isNumber', {
+  enumerable: true,
+  get: function () {
+    return isNumber;
+  }
+});
+Object.defineProperty(exports, 'isObjectWithKeys', {
+  enumerable: true,
+  get: function () {
+    return isObjectWithKeys;
+  }
+});
+Object.defineProperty(exports, 'normalizeNumber', {
+  enumerable: true,
+  get: function () {
+    return normalizeNumber;
+  }
+});