toolbox-x 1.0.0

package/dist/primitives-B26uZolQ.cjs

@@ -0,0 +1,228 @@
+/**
+ * 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/guards/primitives.ts
+/**
+* * 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 positive integer.
+* @param value - The value to check.
+* @returns `true` if the value is a positive integer, otherwise `false`.
+*/
+function isPositiveInteger(value) {
+	return isInteger(value) && value > 0;
+}
+/**
+* * 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 null.
+* @param value - The value to check.
+* @returns `true` if the value is null, otherwise `false`.
+*/
+function isNull(value) {
+	return value === null;
+}
+/**
+* * 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 symbol.
+* @param value - The value to check.
+* @returns `true` if the value is a symbol, otherwise `false`.
+*/
+function isSymbol(value) {
+	return typeof value === "symbol";
+}
+/**
+* * Type guard to check if a value is a BigInt.
+* @param value - The value to check.
+* @returns `true` if the value is a BigInt, otherwise `false`.
+*/
+function isBigInt(value) {
+	return typeof value === "bigint";
+}
+/**
+* * Type guard to check if a value is a primitive (i.e. `string | number | boolean | symbol | bigint | null | undefined`).
+* @param value - The value to check.
+* @returns `true` if the value is a primitive, otherwise `false`.
+*/
+function isPrimitive(value) {
+	return value === null || [
+		"string",
+		"number",
+		"boolean",
+		"symbol",
+		"bigint",
+		"undefined"
+	].includes(typeof value);
+}
+/**
+* * Type guard to check if a value is a normal primitive (i.e. `string | number | boolean | null | undefined`).
+* @param value - The value to check.
+* @returns `true` if the value is a primitive, otherwise `false`.
+*/
+function isNormalPrimitive(value) {
+	return value == null || [
+		"string",
+		"number",
+		"boolean",
+		"undefined"
+	].includes(typeof 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;
+}
+/**
+* * Type guard to check if a value is falsy.
+* @param value - The value to check.
+* @returns `true` if the value is falsy, otherwise `false`.
+*/
+function isFalsy(value) {
+	return !value;
+}
+/**
+* * Type guard to check if a value is truthy.
+* @param value - The value to check.
+* @returns `true` if the value is truthy (not null or undefined), otherwise `false`.
+*/
+function isTruthy(value) {
+	return Boolean(value);
+}
+
+//#endregion
+Object.defineProperty(exports, 'isBigInt', {
+  enumerable: true,
+  get: function () {
+    return isBigInt;
+  }
+});
+Object.defineProperty(exports, 'isBoolean', {
+  enumerable: true,
+  get: function () {
+    return isBoolean;
+  }
+});
+Object.defineProperty(exports, 'isFalsy', {
+  enumerable: true,
+  get: function () {
+    return isFalsy;
+  }
+});
+Object.defineProperty(exports, 'isInteger', {
+  enumerable: true,
+  get: function () {
+    return isInteger;
+  }
+});
+Object.defineProperty(exports, 'isNonEmptyString', {
+  enumerable: true,
+  get: function () {
+    return isNonEmptyString;
+  }
+});
+Object.defineProperty(exports, 'isNormalPrimitive', {
+  enumerable: true,
+  get: function () {
+    return isNormalPrimitive;
+  }
+});
+Object.defineProperty(exports, 'isNull', {
+  enumerable: true,
+  get: function () {
+    return isNull;
+  }
+});
+Object.defineProperty(exports, 'isNumber', {
+  enumerable: true,
+  get: function () {
+    return isNumber;
+  }
+});
+Object.defineProperty(exports, 'isPositiveInteger', {
+  enumerable: true,
+  get: function () {
+    return isPositiveInteger;
+  }
+});
+Object.defineProperty(exports, 'isPrimitive', {
+  enumerable: true,
+  get: function () {
+    return isPrimitive;
+  }
+});
+Object.defineProperty(exports, 'isString', {
+  enumerable: true,
+  get: function () {
+    return isString;
+  }
+});
+Object.defineProperty(exports, 'isSymbol', {
+  enumerable: true,
+  get: function () {
+    return isSymbol;
+  }
+});
+Object.defineProperty(exports, 'isTruthy', {
+  enumerable: true,
+  get: function () {
+    return isTruthy;
+  }
+});
+Object.defineProperty(exports, 'isUndefined', {
+  enumerable: true,
+  get: function () {
+    return isUndefined;
+  }
+});

package/dist/primitives-KsFUp3kQ.mjs

@@ -0,0 +1,144 @@
+/**
+ * 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/guards/primitives.ts
+/**
+* * 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 positive integer.
+* @param value - The value to check.
+* @returns `true` if the value is a positive integer, otherwise `false`.
+*/
+function isPositiveInteger(value) {
+	return isInteger(value) && value > 0;
+}
+/**
+* * 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 null.
+* @param value - The value to check.
+* @returns `true` if the value is null, otherwise `false`.
+*/
+function isNull(value) {
+	return value === null;
+}
+/**
+* * 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 symbol.
+* @param value - The value to check.
+* @returns `true` if the value is a symbol, otherwise `false`.
+*/
+function isSymbol(value) {
+	return typeof value === "symbol";
+}
+/**
+* * Type guard to check if a value is a BigInt.
+* @param value - The value to check.
+* @returns `true` if the value is a BigInt, otherwise `false`.
+*/
+function isBigInt(value) {
+	return typeof value === "bigint";
+}
+/**
+* * Type guard to check if a value is a primitive (i.e. `string | number | boolean | symbol | bigint | null | undefined`).
+* @param value - The value to check.
+* @returns `true` if the value is a primitive, otherwise `false`.
+*/
+function isPrimitive(value) {
+	return value === null || [
+		"string",
+		"number",
+		"boolean",
+		"symbol",
+		"bigint",
+		"undefined"
+	].includes(typeof value);
+}
+/**
+* * Type guard to check if a value is a normal primitive (i.e. `string | number | boolean | null | undefined`).
+* @param value - The value to check.
+* @returns `true` if the value is a primitive, otherwise `false`.
+*/
+function isNormalPrimitive(value) {
+	return value == null || [
+		"string",
+		"number",
+		"boolean",
+		"undefined"
+	].includes(typeof 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;
+}
+/**
+* * Type guard to check if a value is falsy.
+* @param value - The value to check.
+* @returns `true` if the value is falsy, otherwise `false`.
+*/
+function isFalsy(value) {
+	return !value;
+}
+/**
+* * Type guard to check if a value is truthy.
+* @param value - The value to check.
+* @returns `true` if the value is truthy (not null or undefined), otherwise `false`.
+*/
+function isTruthy(value) {
+	return Boolean(value);
+}
+
+//#endregion
+export { isNonEmptyString as a, isNumber as c, isString as d, isSymbol as f, isInteger as i, isPositiveInteger as l, isUndefined as m, isBoolean as n, isNormalPrimitive as o, isTruthy as p, isFalsy as r, isNull as s, isBigInt as t, isPrimitive as u };

package/dist/specials-D48_IZbd.d.mts

@@ -0,0 +1,108 @@
+/**
+ * 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 { g as UUIDVersion, m as UUID } from "./hash-B6JPEyAz.mjs";
+
+//#region src/guards/specials.d.ts
+/**
+ * * Type guard to check if a value is a valid email string.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid email, otherwise `false`.
+ */
+declare function isEmail(value: unknown): value is string;
+/**
+ * * Type guard to check if a value is an array of valid email strings.
+ * @param value - The value to check.
+ * @returns `true` if the value is an array of valid email strings, otherwise `false`.
+ */
+declare function isEmailArray(value: unknown): value is string[];
+/**
+ * * 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`.
+ */
+declare function isDateString(value: unknown): value is string;
+/**
+ * * Type guard to check if a value is a valid UUID (`RFC4122` `v1`-`v8`).
+ * @param value - The value to check.
+ * @returns `true` if the value matches standard UUID pattern, otherwise `false`.
+ */
+declare function isUUID(value: unknown): value is UUID<UUIDVersion>;
+/**
+ * * Type guard to check if the code is running in a browser environment.
+ * @returns `true` if the code is running in a browser, otherwise `false`.
+ */
+declare function isBrowser(): boolean;
+/**
+ * * Type guard to check if the code is running in a Node.js environment.
+ * @returns `true` if the code is running in Node.js, otherwise `false`.
+ */
+declare function isNode(): boolean;
+/**
+ * * Type guard to check if a value is a valid URL.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid URL, otherwise `false`.
+ */
+declare function isURL(value: unknown): value is string;
+/**
+ * * Type guard to check if a value is a valid Base64 encoded string.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid Base64 string, otherwise `false`.
+ */
+declare function isBase64(value: unknown): value is string;
+/**
+ * * Type guard to check if a value is a valid hexadecimal byte sequence.
+ * @param value - The value to check, spaced between bytes or un-spaced.
+ * @returns `true` if the value is a valid hexadecimal byte sequence, otherwise `false`.
+ */
+declare function isHexString(value: unknown): value is string;
+/**
+ * * Type guard to check if a value is a valid binary byte sequence.
+ * @param value - The value to check, spaced between bytes or un-spaced.
+ * @returns `true` if the value is a valid binary byte sequence, otherwise `false`.
+ */
+declare function isBinaryString(value: unknown): value is string;
+/**
+ * * Type guard to check if a value is a valid phone number.
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid phone number, otherwise `false`.
+ */
+declare function isPhoneNumber(value: unknown): value is string;
+/**
+ * * Type guard to check if a value is a valid IP address (IPv4 or IPv6).
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid IP address, otherwise `false`.
+ */
+declare function isIPAddress(value: unknown): value is string;
+/**
+ * * Type guard to check if the current environment matches a given string.
+ * @param env - The expected environment (e.g., "production", "development").
+ * @returns `true` if the value is a numeric string parsable by `Number()`, otherwise `false`.
+ */
+declare function isEnvironment(env: string): boolean;
+/**
+ * * 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.
+ */
+declare function isNumericString(value: unknown): value is `${number}`;
+//#endregion
+export { isEmail as a, isHexString as c, isNumericString as d, isPhoneNumber as f, isDateString as i, isIPAddress as l, isUUID as m, isBinaryString as n, isEmailArray as o, isURL as p, isBrowser as r, isEnvironment as s, isBase64 as t, isNode as u };