toolbox-x 1.0.0

package/dist/paginator.mjs

@@ -0,0 +1,243 @@
+/**
+ * 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 src/utils/Paginator.ts
+/** @class Generates pagination logic, offsets, metadata and other pagination logic(s) for APIs and UIs. */
+var Paginator = class Paginator {
+	#totalItems;
+	#perPage;
+	#currentPage;
+	/**
+	* * Creates an instance of the Paginator.
+	* @param options - The options for pagination.
+	*/
+	constructor(options) {
+		const { totalItems, itemsPerPage = 10, currentPage = 1 } = options ?? {};
+		this.#totalItems = Math.max(0, Number(totalItems));
+		this.#perPage = Math.max(1, Number(itemsPerPage));
+		this.#currentPage = Math.max(1, Number(currentPage));
+	}
+	/**
+	* @instance Returns a new Paginator instance with the given page number.
+	* * This method does not modify the current instance.
+	* - **N.B.** *If the provided page is out of range, it will be clamped between 1 and the last page.*
+	* @param page - The new current page to use.
+	* @returns A new Paginator instance with the updated (clamped) page.
+	*/
+	withPage(page) {
+		const safePage = Math.min(Math.max(1, page), this.totalPages());
+		return new Paginator({
+			totalItems: this.#totalItems,
+			itemsPerPage: this.#perPage,
+			currentPage: safePage
+		});
+	}
+	/**
+	* @instance Returns a new Paginator instance with the given items per page.
+	* - **N.B.** *If the value is less than `1`, it will be clamped to 1.*
+	* @param perPage - New items per page value.
+	* @returns A new Paginator instance with updated items per page.
+	*/
+	withPerPage(perPage) {
+		const safePerPage = Math.max(1, perPage);
+		return new Paginator({
+			totalItems: this.#totalItems,
+			itemsPerPage: safePerPage,
+			currentPage: this.#currentPage
+		});
+	}
+	/**
+	* @instance Returns a new Paginator instance with the given total items.
+	* - **N.B.** *If the value is `negative`, it will be clamped to `0`.*
+	* @param totalItems - New total items value.
+	* @returns A new Paginator instance with updated total items.
+	*/
+	withTotalItems(totalItems) {
+		return new Paginator({
+			totalItems: Math.max(0, totalItems),
+			itemsPerPage: this.#perPage,
+			currentPage: this.#currentPage
+		});
+	}
+	/**
+	* @instance Returns a new Paginator instance with updated pagination options.
+	* - **N.B.** *Any value provided will override the existing one, with clamping applied for safety.*
+	* @param options - Partial pagination options to override the current instance.
+	* @returns A new Paginator instance with merged and clamped options.
+	*/
+	withOptions(options) {
+		const newTotalItems = Math.max(0, options.totalItems ? Number(options.totalItems) : this.#totalItems);
+		const newItemsPerPage = Math.max(1, options.itemsPerPage ? Number(options.itemsPerPage) : this.#perPage);
+		const totalPages = Math.ceil(newTotalItems / newItemsPerPage);
+		return new Paginator({
+			totalItems: newTotalItems,
+			itemsPerPage: newItemsPerPage,
+			currentPage: Math.min(Math.max(1, options.currentPage ? Number(options.currentPage) : this.#currentPage), totalPages)
+		});
+	}
+	/**
+	* @instance Calculates the offset (number of items to skip) based on the `current page` and `items per page`.
+	* @returns The number of items to skip.
+	*/
+	offset() {
+		return (this.#currentPage - 1) * this.#perPage;
+	}
+	/**
+	* @instance Calculates the offset (number of items to skip) based on the `current page` and `items per page`.
+	* @alias of {@link offset}
+	* @returns The number of items to skip.
+	*/
+	getOffset() {
+		return this.offset();
+	}
+	/**
+	* @instance Calculates the number of items to skip based on the `current page` and `items per page`.
+	* @alias of {@link offset}
+	* @returns The number of items to skip.
+	*/
+	skipCount() {
+		return this.offset();
+	}
+	/**
+	* @instance Calculates the total number of pages based on `total items` and `items per page`.
+	* @returns The total number of pages.
+	*/
+	totalPages() {
+		return Math.ceil(this.#totalItems / this.#perPage);
+	}
+	/**
+	* * Returns pagination metadata useful for API responses or UI rendering.
+	* @returns An object with pagination metadata.
+	*/
+	getMeta() {
+		const totalPages = this.totalPages();
+		return {
+			totalItems: this.#totalItems,
+			currentPage: this.#currentPage,
+			itemsPerPage: this.#perPage,
+			totalPages,
+			hasPrev: this.hasPrevPage(),
+			hasNext: this.hasNextPage(),
+			isFirst: this.isFirstPage(),
+			isLast: this.isLastPage(),
+			offset: this.offset()
+		};
+	}
+	/**
+	* @instance Returns the next page number if it exists.
+	* @returns The next page number or null if it's the last page.
+	*/
+	nextPage() {
+		return this.#currentPage < this.totalPages() ? this.#currentPage + 1 : null;
+	}
+	/**
+	* @instance Returns the previous page number if it exists.
+	* @returns The previous page number or null if it's the first page.
+	*/
+	prevPage() {
+		return this.#currentPage > 1 ? this.#currentPage - 1 : null;
+	}
+	/**
+	* @instance Checks if the current page is the first page.
+	* @returns Whether the current page is the first page.
+	*/
+	isFirstPage() {
+		return this.#currentPage === 1;
+	}
+	/**
+	* @instance Checks if the current page is the last page.
+	* @returns Whether the current page is the last page.
+	*/
+	isLastPage() {
+		return this.#currentPage === this.totalPages();
+	}
+	/**
+	* @instance Checks if a previous page exists.
+	* @returns Whether a previous page exists.
+	*/
+	hasPrevPage() {
+		return this.#currentPage > 1;
+	}
+	/**
+	* @instance Checks if a next page exists.
+	* @returns Whether a next page exists.
+	*/
+	hasNextPage() {
+		return this.#currentPage < this.totalPages();
+	}
+	/**
+	* @instance Creates an array of page numbers for UI pagination display.
+	* @param options Options for customizing the page list.
+	* @returns An array of visible page numbers.
+	*/
+	pageList(options = {}) {
+		const total = this.totalPages();
+		const edgeCount = Math.max(0, options.edgeCount ?? 1);
+		const siblingCount = Math.max(0, options.siblingCount ?? 1);
+		const start = Math.max(this.#currentPage - siblingCount, edgeCount + 1);
+		const end = Math.min(this.#currentPage + siblingCount, total - edgeCount);
+		const _getRange = (from, to) => {
+			return from > to ? [] : Array.from({ length: to - from + 1 }, (_, i) => from + i);
+		};
+		const startPages = _getRange(1, edgeCount);
+		const middlePages = _getRange(start, end);
+		const endPages = _getRange(total - edgeCount + 1, total);
+		const pages = new Set([
+			...startPages,
+			...middlePages,
+			...endPages
+		]);
+		return Array.from(pages).sort((a, b) => a - b);
+	}
+	/**
+	* @instance Returns the first page number.
+	* @returns Always returns 1.
+	*/
+	firstPage() {
+		return 1;
+	}
+	/**
+	* @instance Returns the last page number based on total items and per page count.
+	* @returns The last page number.
+	*/
+	lastPage() {
+		return this.totalPages();
+	}
+	/**
+	* @instance Checks if a page number is valid within the pagination range.
+	* @param page - The page number to validate.
+	* @returns Whether the page number is within range.
+	*/
+	isPageValid(page) {
+		const p = Math.floor(page);
+		return p >= 1 && p <= this.totalPages();
+	}
+	/**
+	* @static Creates a new Paginator instance from a meta object.
+	* @param meta - A pagination metadata object.
+	* @returns A new Paginator instance.
+	*/
+	static fromMeta(meta) {
+		return new Paginator({
+			totalItems: meta.totalItems,
+			itemsPerPage: meta.itemsPerPage,
+			currentPage: meta.currentPage
+		});
+	}
+};
+
+//#endregion
+export { Paginator };

package/dist/parse-2ubxXZRp.cjs

@@ -0,0 +1,211 @@
+/**
+ * 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-B26uZolQ.cjs');
+const require_constants = require('./constants-DQYeCjlx.cjs');
+const require_specials = require('./specials-DzLr1ZgU.cjs');
+const require_utilities = require('./utilities-CLUmdQeV.cjs');
+const require_guards = require('./guards-Efhp1mNy.cjs');
+
+//#region src/date/helpers.ts
+/** Core formatting logic shared by `formatDate` and `Chronos`, `BanglaCalendar` classes */
+function _formatDateCore(format, dateComponents) {
+	const tokenRegex = new RegExp(`^(${require_constants.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_constants.MONTHS[month].slice(0, 3),
+		mmmm: require_constants.MONTHS[month],
+		d: require_constants.DAYS[day].slice(0, 2),
+		dd: require_constants.DAYS[day].slice(0, 3),
+		ddd: require_constants.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");
+}
+/** Converts milliseconds to seconds */
+const _toSeconds = (ms) => Math.floor(ms / 1e3);
+/** Converts timestamp seconds to JS `Date` */
+const _secToDate = (sec) => /* @__PURE__ */ new Date(sec * 1e3);
+/** 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");
+}
+/**
+* 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");
+}
+/**
+* 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_specials.isDate(value) ? value : new Date(require_primitives.isString(value) ? value.replace(/['"]/g, "") : value ?? Date.now());
+}
+
+//#endregion
+//#region src/date/parse.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_specials.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_constants.MS_MAP[unit];
+	if (!multiplier) throw new RangeError(`Unknown unit "${unit}"!`);
+	const ms = parseFloat(match.groups.value) * multiplier;
+	return sec ? ms / 1e3 : ms;
+}
+
+//#endregion
+Object.defineProperty(exports, '_dateArgsToDate', {
+  enumerable: true,
+  get: function () {
+    return _dateArgsToDate;
+  }
+});
+Object.defineProperty(exports, '_formatDate', {
+  enumerable: true,
+  get: function () {
+    return _formatDate;
+  }
+});
+Object.defineProperty(exports, '_gmtToUtcOffset', {
+  enumerable: true,
+  get: function () {
+    return _gmtToUtcOffset;
+  }
+});
+Object.defineProperty(exports, '_normalizeOffset', {
+  enumerable: true,
+  get: function () {
+    return _normalizeOffset;
+  }
+});
+Object.defineProperty(exports, '_resolveNativeTzName', {
+  enumerable: true,
+  get: function () {
+    return _resolveNativeTzName;
+  }
+});
+Object.defineProperty(exports, '_secToDate', {
+  enumerable: true,
+  get: function () {
+    return _secToDate;
+  }
+});
+Object.defineProperty(exports, '_toSeconds', {
+  enumerable: true,
+  get: function () {
+    return _toSeconds;
+  }
+});
+Object.defineProperty(exports, 'parseMSec', {
+  enumerable: true,
+  get: function () {
+    return parseMSec;
+  }
+});

package/dist/parse-N7g942uy.mjs

@@ -0,0 +1,164 @@
+/**
+ * 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 { a as isNonEmptyString, c as isNumber, d as isString } from "./primitives-KsFUp3kQ.mjs";
+import { i as SORTED_TIME_FORMATS, n as MONTHS, r as MS_MAP, t as DAYS } from "./constants-D73iFu8g.mjs";
+import { _ as isDate, d as isNumericString } from "./specials-uhDuRg8H.mjs";
+import { r as getOrdinal } from "./utilities-m5yFKqLd.mjs";
+import { i as isTimeWithUnit } from "./guards-DdyU4h4o.mjs";
+
+//#region src/date/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");
+}
+/** Converts milliseconds to seconds */
+const _toSeconds = (ms) => Math.floor(ms / 1e3);
+/** Converts timestamp seconds to JS `Date` */
+const _secToDate = (sec) => /* @__PURE__ */ new Date(sec * 1e3);
+/** 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");
+}
+/**
+* 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");
+}
+/**
+* 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());
+}
+
+//#endregion
+//#region src/date/parse.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 (isNumber(value) || isNumericString(value)) return _parse(`${value}s`, sec);
+	else if (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 (!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 = MS_MAP[unit];
+	if (!multiplier) throw new RangeError(`Unknown unit "${unit}"!`);
+	const ms = parseFloat(match.groups.value) * multiplier;
+	return sec ? ms / 1e3 : ms;
+}
+
+//#endregion
+export { _normalizeOffset as a, _toSeconds as c, _gmtToUtcOffset as i, _dateArgsToDate as n, _resolveNativeTzName as o, _formatDate as r, _secToDate as s, parseMSec as t };

package/dist/pluralizer-BjMIc6uT.d.mts

@@ -0,0 +1,42 @@
+/**
+ * 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 { it as Numeric } from "./object-B0TV3eHx.mjs";
+
+//#region src/types/pluralizer.d.ts
+/** A pair of RegExp and replacement for pluralization rules */
+type PluralizeRule = [RegExp, string];
+/**
+ * A map of irregular singular to plural forms.
+ * Used for handling exceptions in pluralization.
+ */
+type IrregularMap = Record<string, string>;
+/** * Options for pluralize method. */
+interface PluralizeOptions {
+  /**
+   * The count to determine singular or plural form. Either number or numeric string.
+   * If not provided, bypass the check and pluralize the word anyways.
+   */
+  count?: Numeric;
+  /**
+   * Whether to include the count in the output. Depends on the `count` value.
+   * If true, the output will be in the format "2 Categories".
+   * If false, it will just return the pluralized word.
+   */
+  inclusive?: boolean;
+}
+//#endregion
+export { PluralizeOptions as n, PluralizeRule as r, IrregularMap as t };

package/dist/pluralizer-Cb6ZmrDl.d.cts

@@ -0,0 +1,42 @@
+/**
+ * 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 { it as Numeric } from "./object-Blq0Amdv.cjs";
+
+//#region src/types/pluralizer.d.ts
+/** A pair of RegExp and replacement for pluralization rules */
+type PluralizeRule = [RegExp, string];
+/**
+ * A map of irregular singular to plural forms.
+ * Used for handling exceptions in pluralization.
+ */
+type IrregularMap = Record<string, string>;
+/** * Options for pluralize method. */
+interface PluralizeOptions {
+  /**
+   * The count to determine singular or plural form. Either number or numeric string.
+   * If not provided, bypass the check and pluralize the word anyways.
+   */
+  count?: Numeric;
+  /**
+   * Whether to include the count in the output. Depends on the `count` value.
+   * If true, the output will be in the format "2 Categories".
+   * If false, it will just return the pluralized word.
+   */
+  inclusive?: boolean;
+}
+//#endregion
+export { PluralizeOptions as n, PluralizeRule as r, IrregularMap as t };