@js-utils-kit/valid 1.0.1 → 1.1.0

package/dist/index.cjs

@@ -1 +1 @@
-let e=require(`@js-utils-kit/types`);function t(e){return/[\p{P}]$/u.test(e)}function n(e){return/\s/.test(e)}function r(e){return/^[a-zA-Z]+$/.test(e)}function i(e){return e!=null}function a(e){return i(e)&&Array.isArray(e)}function o(){return typeof window<`u`&&window.document!==void 0}function s(e){return/^[a-z][a-zA-Z0-9]*$/.test(e)}function c(){return process.env.NODE_ENV===e.Environment.DEV}function l(e){if(typeof e!=`string`)throw TypeError(`Expected a string`);if(e.length>254)return!1;let t=e.split(`@`);if(t.length!==2)return!1;let[n,r]=t;return n.length===0||n.length>64||r.length===0||r.length>255?!1:!(!/^[a-zA-Z0-9_%+-]+(\.[a-zA-Z0-9_%+-]+)*$/.test(n)||!/^(?!.*\.\.)(?!-)[A-Za-z0-9-]{1,63}(?<!-)(\.[A-Za-z0-9-]{1,63}(?<!-))*\.[A-Za-z]{2,}$/.test(r))}function u(e){return typeof e==`object`&&!!e&&Object.keys(e).length===0&&!a(e)}function d(e){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e)}function f(e){return/^[a-z]+$/.test(e)}function p(){return typeof process<`u`&&process.versions!==null&&process.versions.node!==null}function m(e){return typeof e==`object`&&!!e&&Object.keys(e).length>0&&!a(e)}function h(e){return e!=null&&typeof e==`string`}function g(e,t=!0){return h(e)?typeof e==`string`&&(t?e.trim().length>0:e.length>0):!1}function _(e){return!isNaN(Number(e))&&!isNaN(parseFloat(e))}function v(e){return i(e)&&typeof e==`object`&&!a(e)&&Object.getPrototypeOf(e)===Object.prototype}function y(e){return/^[A-Z][a-zA-Z0-9]*$/.test(e)}function b(){return process.env.NODE_ENV===e.Environment.PROD}function x(e){return/^[a-z0-9]+(_[a-z0-9]+)*$/.test(e)}function S(){return process.env.NODE_ENV===e.Environment.TEST}function C(e){return e==null}function w(e){return/^[A-Z]+$/.test(e)}function T(e){try{return new URL(e),!0}catch{return!1}}function E(e){return/^[A-Z]/.test(e)}exports.endsWithPunctuation=t,exports.hasWhitespace=n,exports.isAlphabetic=r,exports.isArray=a,exports.isBrowser=o,exports.isCamelCase=s,exports.isDefined=i,exports.isDev=c,exports.isEmail=l,exports.isEmptyObject=u,exports.isKebabCase=d,exports.isLowerCase=f,exports.isNode=p,exports.isNonEmptyObject=m,exports.isNonEmptyString=g,exports.isNumericString=_,exports.isObject=v,exports.isPascalCase=y,exports.isProd=b,exports.isSnakeCase=x,exports.isString=h,exports.isTest=S,exports.isURL=T,exports.isUndefinedOrNull=C,exports.isUpperCase=w,exports.startsWithUppercase=E,Object.keys(e).forEach(function(t){t!==`default`&&!Object.prototype.hasOwnProperty.call(exports,t)&&Object.defineProperty(exports,t,{enumerable:!0,get:function(){return e[t]}})});
+let e=require(`@js-utils-kit/types`);function t(e){return/[\p{P}]$/u.test(e)}function n(e){return/\s/.test(e)}function r(e){return/^[a-zA-Z]+$/.test(e)}function i(e){return e!=null}function a(e){return i(e)&&Array.isArray(e)}function o(){return typeof window<`u`&&window.document!==void 0}function s(e){return/^[a-z][a-zA-Z0-9]*$/.test(e)}function c(){return process.env.NODE_ENV===e.Environment.DEV}function l(e){if(typeof e!=`string`)throw TypeError(`Expected a string`);if(e.length>254)return!1;let t=e.split(`@`);if(t.length!==2)return!1;let[n,r]=t;return n.length===0||n.length>64||r.length===0||r.length>255?!1:!(!/^[a-zA-Z0-9_%+-]+(\.[a-zA-Z0-9_%+-]+)*$/.test(n)||!/^(?!.*\.\.)(?!-)[A-Za-z0-9-]{1,63}(?<!-)(\.[A-Za-z0-9-]{1,63}(?<!-))*\.[A-Za-z]{2,}$/.test(r))}function u(e){return e==null?!0:typeof e==`string`?e.trim().length===0:Array.isArray(e)?e.length===0:e instanceof Map||e instanceof Set?e.size===0:Object.prototype.toString.call(e)===`[object Object]`?Object.keys(e).length===0:!1}function d(e){return typeof e==`object`&&!!e&&Object.keys(e).length===0&&!a(e)}function f(e){return!e}function p(e){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e)}function m(e){return/^[a-z]+$/.test(e)}function h(){return typeof process<`u`&&process.versions!==null&&process.versions.node!==null}function g(e){return typeof e==`object`&&!!e&&Object.keys(e).length>0&&!a(e)}function _(e){return e!=null&&typeof e==`string`}function v(e,t=!0){return _(e)?typeof e==`string`&&(t?e.trim().length>0:e.length>0):!1}function y(e){return!isNaN(Number(e))&&!isNaN(parseFloat(e))}function b(e){return i(e)&&typeof e==`object`&&!a(e)&&Object.getPrototypeOf(e)===Object.prototype}function x(e){return/^[A-Z][a-zA-Z0-9]*$/.test(e)}function S(){return process.env.NODE_ENV===e.Environment.PROD}function C(e){return/^[a-z0-9]+(_[a-z0-9]+)*$/.test(e)}function w(){return process.env.NODE_ENV===e.Environment.TEST}function T(e){return!!e}function E(e){return e==null}function D(e){return/^[A-Z]+$/.test(e)}function O(e){try{return new URL(e),!0}catch{return!1}}function k(e){return/^[A-Z]/.test(e)}exports.endsWithPunctuation=t,exports.hasWhitespace=n,exports.isAlphabetic=r,exports.isArray=a,exports.isBrowser=o,exports.isCamelCase=s,exports.isDefined=i,exports.isDev=c,exports.isEmail=l,exports.isEmpty=u,exports.isEmptyObject=d,exports.isFalsy=f,exports.isKebabCase=p,exports.isLowerCase=m,exports.isNode=h,exports.isNonEmptyObject=g,exports.isNonEmptyString=v,exports.isNumericString=y,exports.isObject=b,exports.isPascalCase=x,exports.isProd=S,exports.isSnakeCase=C,exports.isString=_,exports.isTest=w,exports.isTruthy=T,exports.isURL=O,exports.isUndefinedOrNull=E,exports.isUpperCase=D,exports.startsWithUppercase=k,Object.keys(e).forEach(function(t){t!==`default`&&!Object.prototype.hasOwnProperty.call(exports,t)&&Object.defineProperty(exports,t,{enumerable:!0,get:function(){return e[t]}})});

package/dist/index.d.cts

@@ -164,6 +164,42 @@ declare function isDev(): boolean;
 declare function isEmail(/** The string to validate as an email address */
 value: string): boolean;
 //#endregion
+//#region src/isEmpty.d.ts
+/**
+ * Checks whether a value is empty.
+ *
+ * Empty values include:
+ * - `null` or `undefined`
+ * - Empty strings (including whitespace-only strings)
+ * - Arrays with length `0`
+ * - Objects with no own enumerable properties
+ * - Maps and Sets with size `0`
+ *
+ * @returns `true` if the value is empty, otherwise `false`
+ *
+ * @example
+ * ```ts
+ * isEmpty(null);        // true
+ * isEmpty('');          // true
+ * isEmpty('   ');       // true
+ * isEmpty([]);          // true
+ * isEmpty({});          // true
+ * isEmpty(new Map());  // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isEmpty('hello');    // false
+ * isEmpty([1]);        // false
+ * isEmpty({ a: 1 });   // false
+ * ```
+ */
+declare function isEmpty<T>(
+/**
+ * The value to check.
+ */
+value: T): boolean;
+//#endregion
 //#region src/isEmptyObject.d.ts
 /**
  * Checks if a value is an empty object (has no enumerable own properties).
@@ -181,6 +217,43 @@ value: string): boolean;
 declare function isEmptyObject(/** The value to check */
 value: object): boolean;
 //#endregion
+//#region src/isFalsy.d.ts
+/**
+ * Checks whether a value is falsy.
+ *
+ * Falsy values include:
+ * - `false`
+ * - `0`
+ * - `""`
+ * - `null`
+ * - `undefined`
+ * - `NaN`
+ *
+ * @returns `true` if the value is falsy, otherwise `false`
+ *
+ * @example
+ * ```ts
+ * isFalsy(0);        // true
+ * isFalsy('');       // true
+ * isFalsy(null);     // true
+ * isFalsy(undefined);// true
+ * isFalsy(NaN);      // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isFalsy(1);        // false
+ * isFalsy('hello');  // false
+ * isFalsy([]);  // false
+ * isFalsy({});  // false
+ * ```
+ */
+declare function isFalsy<T>(
+/**
+ * The value to check.
+ */
+value: T): boolean;
+//#endregion
 //#region src/isKebabCase.d.ts
 /**
  * Checks if a string is in kebab-case format.
@@ -424,6 +497,43 @@ value: T): boolean;
  */
 declare function isTest(): boolean;
 //#endregion
+//#region src/isTruthy.d.ts
+/**
+ * Checks whether a value is truthy.
+ *
+ * Falsy values include:
+ * - `false`
+ * - `0`
+ * - `""` (empty string)
+ * - `null`
+ * - `undefined`
+ * - `NaN`
+ *
+ * @returns `true` if the value is truthy, otherwise `false`.
+ *
+ * @example
+ * ```ts
+ * isTruthy(0);         // false
+ * isTruthy('');        // false
+ * isTruthy(null);      // false
+ * isTruthy(undefined); // false
+ * isTruthy(NaN);       // false
+ * ```
+ *
+ * @example
+ * ```ts
+ * isTruthy(1);         // true
+ * isTruthy('hello');   // true
+ * isTruthy([]);        // true
+ * isTruthy({});        // true
+ * ```
+ */
+declare function isTruthy<T>(
+/**
+ * The value to check.
+ */
+value: T): boolean;
+//#endregion
 //#region src/isUndefinedOrNull.d.ts
 /**
  * Checks if a value is either null or undefined.
@@ -491,4 +601,4 @@ value: string): boolean;
 declare function startsWithUppercase(/** The input string to check */
 value: string): boolean;
 //#endregion
-export { endsWithPunctuation, hasWhitespace, isAlphabetic, isArray, isBrowser, isCamelCase, isDefined, isDev, isEmail, isEmptyObject, isKebabCase, isLowerCase, isNode, isNonEmptyObject, isNonEmptyString, isNumericString, isObject, isPascalCase, isProd, isSnakeCase, isString, isTest, isURL, isUndefinedOrNull, isUpperCase, startsWithUppercase };
+export { endsWithPunctuation, hasWhitespace, isAlphabetic, isArray, isBrowser, isCamelCase, isDefined, isDev, isEmail, isEmpty, isEmptyObject, isFalsy, isKebabCase, isLowerCase, isNode, isNonEmptyObject, isNonEmptyString, isNumericString, isObject, isPascalCase, isProd, isSnakeCase, isString, isTest, isTruthy, isURL, isUndefinedOrNull, isUpperCase, startsWithUppercase };

package/dist/index.d.mts

@@ -164,6 +164,42 @@ declare function isDev(): boolean;
 declare function isEmail(/** The string to validate as an email address */
 value: string): boolean;
 //#endregion
+//#region src/isEmpty.d.ts
+/**
+ * Checks whether a value is empty.
+ *
+ * Empty values include:
+ * - `null` or `undefined`
+ * - Empty strings (including whitespace-only strings)
+ * - Arrays with length `0`
+ * - Objects with no own enumerable properties
+ * - Maps and Sets with size `0`
+ *
+ * @returns `true` if the value is empty, otherwise `false`
+ *
+ * @example
+ * ```ts
+ * isEmpty(null);        // true
+ * isEmpty('');          // true
+ * isEmpty('   ');       // true
+ * isEmpty([]);          // true
+ * isEmpty({});          // true
+ * isEmpty(new Map());  // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isEmpty('hello');    // false
+ * isEmpty([1]);        // false
+ * isEmpty({ a: 1 });   // false
+ * ```
+ */
+declare function isEmpty<T>(
+/**
+ * The value to check.
+ */
+value: T): boolean;
+//#endregion
 //#region src/isEmptyObject.d.ts
 /**
  * Checks if a value is an empty object (has no enumerable own properties).
@@ -181,6 +217,43 @@ value: string): boolean;
 declare function isEmptyObject(/** The value to check */
 value: object): boolean;
 //#endregion
+//#region src/isFalsy.d.ts
+/**
+ * Checks whether a value is falsy.
+ *
+ * Falsy values include:
+ * - `false`
+ * - `0`
+ * - `""`
+ * - `null`
+ * - `undefined`
+ * - `NaN`
+ *
+ * @returns `true` if the value is falsy, otherwise `false`
+ *
+ * @example
+ * ```ts
+ * isFalsy(0);        // true
+ * isFalsy('');       // true
+ * isFalsy(null);     // true
+ * isFalsy(undefined);// true
+ * isFalsy(NaN);      // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isFalsy(1);        // false
+ * isFalsy('hello');  // false
+ * isFalsy([]);  // false
+ * isFalsy({});  // false
+ * ```
+ */
+declare function isFalsy<T>(
+/**
+ * The value to check.
+ */
+value: T): boolean;
+//#endregion
 //#region src/isKebabCase.d.ts
 /**
  * Checks if a string is in kebab-case format.
@@ -424,6 +497,43 @@ value: T): boolean;
  */
 declare function isTest(): boolean;
 //#endregion
+//#region src/isTruthy.d.ts
+/**
+ * Checks whether a value is truthy.
+ *
+ * Falsy values include:
+ * - `false`
+ * - `0`
+ * - `""` (empty string)
+ * - `null`
+ * - `undefined`
+ * - `NaN`
+ *
+ * @returns `true` if the value is truthy, otherwise `false`.
+ *
+ * @example
+ * ```ts
+ * isTruthy(0);         // false
+ * isTruthy('');        // false
+ * isTruthy(null);      // false
+ * isTruthy(undefined); // false
+ * isTruthy(NaN);       // false
+ * ```
+ *
+ * @example
+ * ```ts
+ * isTruthy(1);         // true
+ * isTruthy('hello');   // true
+ * isTruthy([]);        // true
+ * isTruthy({});        // true
+ * ```
+ */
+declare function isTruthy<T>(
+/**
+ * The value to check.
+ */
+value: T): boolean;
+//#endregion
 //#region src/isUndefinedOrNull.d.ts
 /**
  * Checks if a value is either null or undefined.
@@ -491,4 +601,4 @@ value: string): boolean;
 declare function startsWithUppercase(/** The input string to check */
 value: string): boolean;
 //#endregion
-export { endsWithPunctuation, hasWhitespace, isAlphabetic, isArray, isBrowser, isCamelCase, isDefined, isDev, isEmail, isEmptyObject, isKebabCase, isLowerCase, isNode, isNonEmptyObject, isNonEmptyString, isNumericString, isObject, isPascalCase, isProd, isSnakeCase, isString, isTest, isURL, isUndefinedOrNull, isUpperCase, startsWithUppercase };
+export { endsWithPunctuation, hasWhitespace, isAlphabetic, isArray, isBrowser, isCamelCase, isDefined, isDev, isEmail, isEmpty, isEmptyObject, isFalsy, isKebabCase, isLowerCase, isNode, isNonEmptyObject, isNonEmptyString, isNumericString, isObject, isPascalCase, isProd, isSnakeCase, isString, isTest, isTruthy, isURL, isUndefinedOrNull, isUpperCase, startsWithUppercase };

package/dist/index.mjs

@@ -1 +1 @@
-import{Environment as e}from"@js-utils-kit/types";export*from"@js-utils-kit/types";function t(e){return/[\p{P}]$/u.test(e)}function n(e){return/\s/.test(e)}function r(e){return/^[a-zA-Z]+$/.test(e)}function i(e){return e!=null}function a(e){return i(e)&&Array.isArray(e)}function o(){return typeof window<`u`&&window.document!==void 0}function s(e){return/^[a-z][a-zA-Z0-9]*$/.test(e)}function c(){return process.env.NODE_ENV===e.DEV}function l(e){if(typeof e!=`string`)throw TypeError(`Expected a string`);if(e.length>254)return!1;let t=e.split(`@`);if(t.length!==2)return!1;let[n,r]=t;return n.length===0||n.length>64||r.length===0||r.length>255?!1:!(!/^[a-zA-Z0-9_%+-]+(\.[a-zA-Z0-9_%+-]+)*$/.test(n)||!/^(?!.*\.\.)(?!-)[A-Za-z0-9-]{1,63}(?<!-)(\.[A-Za-z0-9-]{1,63}(?<!-))*\.[A-Za-z]{2,}$/.test(r))}function u(e){return typeof e==`object`&&!!e&&Object.keys(e).length===0&&!a(e)}function d(e){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e)}function f(e){return/^[a-z]+$/.test(e)}function p(){return typeof process<`u`&&process.versions!==null&&process.versions.node!==null}function m(e){return typeof e==`object`&&!!e&&Object.keys(e).length>0&&!a(e)}function h(e){return e!=null&&typeof e==`string`}function g(e,t=!0){return h(e)?typeof e==`string`&&(t?e.trim().length>0:e.length>0):!1}function _(e){return!isNaN(Number(e))&&!isNaN(parseFloat(e))}function v(e){return i(e)&&typeof e==`object`&&!a(e)&&Object.getPrototypeOf(e)===Object.prototype}function y(e){return/^[A-Z][a-zA-Z0-9]*$/.test(e)}function b(){return process.env.NODE_ENV===e.PROD}function x(e){return/^[a-z0-9]+(_[a-z0-9]+)*$/.test(e)}function S(){return process.env.NODE_ENV===e.TEST}function C(e){return e==null}function w(e){return/^[A-Z]+$/.test(e)}function T(e){try{return new URL(e),!0}catch{return!1}}function E(e){return/^[A-Z]/.test(e)}export{t as endsWithPunctuation,n as hasWhitespace,r as isAlphabetic,a as isArray,o as isBrowser,s as isCamelCase,i as isDefined,c as isDev,l as isEmail,u as isEmptyObject,d as isKebabCase,f as isLowerCase,p as isNode,m as isNonEmptyObject,g as isNonEmptyString,_ as isNumericString,v as isObject,y as isPascalCase,b as isProd,x as isSnakeCase,h as isString,S as isTest,T as isURL,C as isUndefinedOrNull,w as isUpperCase,E as startsWithUppercase};
+import{Environment as e}from"@js-utils-kit/types";export*from"@js-utils-kit/types";function t(e){return/[\p{P}]$/u.test(e)}function n(e){return/\s/.test(e)}function r(e){return/^[a-zA-Z]+$/.test(e)}function i(e){return e!=null}function a(e){return i(e)&&Array.isArray(e)}function o(){return typeof window<`u`&&window.document!==void 0}function s(e){return/^[a-z][a-zA-Z0-9]*$/.test(e)}function c(){return process.env.NODE_ENV===e.DEV}function l(e){if(typeof e!=`string`)throw TypeError(`Expected a string`);if(e.length>254)return!1;let t=e.split(`@`);if(t.length!==2)return!1;let[n,r]=t;return n.length===0||n.length>64||r.length===0||r.length>255?!1:!(!/^[a-zA-Z0-9_%+-]+(\.[a-zA-Z0-9_%+-]+)*$/.test(n)||!/^(?!.*\.\.)(?!-)[A-Za-z0-9-]{1,63}(?<!-)(\.[A-Za-z0-9-]{1,63}(?<!-))*\.[A-Za-z]{2,}$/.test(r))}function u(e){return e==null?!0:typeof e==`string`?e.trim().length===0:Array.isArray(e)?e.length===0:e instanceof Map||e instanceof Set?e.size===0:Object.prototype.toString.call(e)===`[object Object]`?Object.keys(e).length===0:!1}function d(e){return typeof e==`object`&&!!e&&Object.keys(e).length===0&&!a(e)}function f(e){return!e}function p(e){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e)}function m(e){return/^[a-z]+$/.test(e)}function h(){return typeof process<`u`&&process.versions!==null&&process.versions.node!==null}function g(e){return typeof e==`object`&&!!e&&Object.keys(e).length>0&&!a(e)}function _(e){return e!=null&&typeof e==`string`}function v(e,t=!0){return _(e)?typeof e==`string`&&(t?e.trim().length>0:e.length>0):!1}function y(e){return!isNaN(Number(e))&&!isNaN(parseFloat(e))}function b(e){return i(e)&&typeof e==`object`&&!a(e)&&Object.getPrototypeOf(e)===Object.prototype}function x(e){return/^[A-Z][a-zA-Z0-9]*$/.test(e)}function S(){return process.env.NODE_ENV===e.PROD}function C(e){return/^[a-z0-9]+(_[a-z0-9]+)*$/.test(e)}function w(){return process.env.NODE_ENV===e.TEST}function T(e){return!!e}function E(e){return e==null}function D(e){return/^[A-Z]+$/.test(e)}function O(e){try{return new URL(e),!0}catch{return!1}}function k(e){return/^[A-Z]/.test(e)}export{t as endsWithPunctuation,n as hasWhitespace,r as isAlphabetic,a as isArray,o as isBrowser,s as isCamelCase,i as isDefined,c as isDev,l as isEmail,u as isEmpty,d as isEmptyObject,f as isFalsy,p as isKebabCase,m as isLowerCase,h as isNode,g as isNonEmptyObject,v as isNonEmptyString,y as isNumericString,b as isObject,x as isPascalCase,S as isProd,C as isSnakeCase,_ as isString,w as isTest,T as isTruthy,O as isURL,E as isUndefinedOrNull,D as isUpperCase,k as startsWithUppercase};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@js-utils-kit/valid",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Validation utilities",
   "license": "MIT",
   "private": false,
@@ -36,12 +36,12 @@
   "types": "./dist/index.d.cts",
   "exports": {
     ".": {
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs"
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.mjs"
     }
   },
   "dependencies": {
-    "@js-utils-kit/types": "1.0.0"
+    "@js-utils-kit/types": "1.1.0"
   },
   "scripts": {
     "build": "tsdown",