@react-fabric/utilities 1.0.0-beta.8 → 1.0.1

package/dist/cjs/lists/dedupe.js

@@ -0,0 +1,54 @@
+'use strict';
+
+var isEmpty = require('../matchers/isEmpty.js');
+
+/**
+ * React Fabric
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+
+/**
+ * Remove duplicates from a list of objects based on a key or the entire object.
+ * If a key is provided, it will deduplicate based on the value of that key.
+ * If no key is provided, it will deduplicate based on the entire object.
+ * This is useful for normalizing data structures that may have nested arrays or objects.
+ *
+ * @param list
+ * @param key
+ * @typedef {T} AnyObject - A generic type representing list items.
+ * @returns {T[]} - A new array with duplicates removed.
+ */
+function dedupe(list, key) {
+  var filtered = list.filter(function (i) {
+    return !isEmpty.isEmpty(i);
+  });
+  if (!key) {
+    return Array.from(new Set(filtered).values());
+  }
+  return Array.from(new Map(filtered.map(function (obj) {
+    return [obj[key], obj];
+  })).values());
+}
+
+exports.dedupe = dedupe;

package/dist/cjs/lists/flatten.js

@@ -0,0 +1,66 @@
+'use strict';
+
+var isEmpty = require('../matchers/isEmpty.js');
+var dedupe = require('./dedupe.js');
+
+/**
+ * React Fabric
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+
+/**
+ * Flatten a list of objects, removing any empty objects.
+ * It will flatten up to 5 levels deep and filter out any empty objects.
+ * This is useful for normalizing data structures that may have nested arrays or objects.
+ *
+ * @param list
+ * @typedef {T} AnyObject - A generic type representing list items.
+ * @returns {T[]} - A flattened array of objects.
+ */
+function flatten(list) {
+  return list.flat(5).filter(function (i) {
+    return !isEmpty.isEmpty(i);
+  });
+}
+
+/**
+ * Flatten a list of objects and remove duplicates based on a key or the entire object.
+ * If a key is provided, it will deduplicate based on the value of that key.
+ * If no key is provided, it will deduplicate based on the entire object.
+ * This is useful for normalizing data structures that may have nested arrays or objects.
+ * Flattening is done first, followed by deduplication.
+ *
+ * @param list
+ * @param key
+ * @typedef {T} AnyObject - A generic type representing list items.
+ * @returns {T[]} - A new array with duplicates removed.
+ */
+function flattenAndDedupe() {
+  var list = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var key = arguments.length > 1 ? arguments[1] : undefined;
+  return dedupe.dedupe(flatten(list), key);
+}
+
+exports.flatten = flatten;
+exports.flattenAndDedupe = flattenAndDedupe;

package/dist/cjs/{_getByPath.js → lists/getByPath.js}

@@ -1,44 +1,54 @@
 'use strict';
 
-var _isType = require('./_isType.js');
+var isEmpty = require('../matchers/isEmpty.js');
+var nullChecks = require('../matchers/nullChecks.js');
+var typeChecks = require('../matchers/typeChecks.js');
 
-/*
+/**
  * React Fabric
- * @version: 1.0.0
- *
- *
- * The MIT License (MIT)
- * Copyright (c) 2024 Adarsh Pastakia
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
  *
- * Permission is hereby granted, free of charge, to any person obtaining a copy of this software
- * and associated documentation files (the "Software"), to deal in the Software without restriction,
- * including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
- * and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,
- * subject to the following conditions:
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
  *
- * The above copyright notice and this permission notice shall be included in all copies or substantial
- * portions of the Software.
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
  *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
- * TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
- * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
- * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
  */
 
-var _get = function _get(hit, field) {
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable @typescript-eslint/no-unsafe-member-access */
+/* eslint-disable @typescript-eslint/no-unsafe-assignment */
+/* eslint-disable @typescript-eslint/no-unsafe-return */
+
+function _get(hit, field) {
   /** ***************** return if object is empty *******************/
   /* istanbul ignore next */
-  if (_isType.isNil(hit)) {
+  if (nullChecks.isNil(hit)) {
     return undefined;
   }
   /** ***************** return object if property is empty *******************/
   /* istanbul ignore next */
-  if (_isType.isNil(field)) {
+  if (nullChecks.isNil(field)) {
     return hit;
   }
-  if (_isType.isObject(hit)) {
+  if (typeChecks.isObject(hit) || typeChecks.isArray(hit)) {
     /** ***************** return value if object.property is not empty *******************/
-    if (!_isType.isNil(hit[field])) {
+    if (!nullChecks.isNil(hit[field])) {
       return hit[field];
     }
 
@@ -58,7 +68,7 @@ var _get = function _get(hit, field) {
             currentValue = currentValue[outerPath];
 
             /** ***************** check for type array *******************/
-            if (_isType.isArray(currentValue)) {
+            if (typeChecks.isArray(currentValue)) {
               /** ***************** return value if remaining path found *******************/
               if (currentValue[innerPath]) {
                 return {
@@ -70,7 +80,7 @@ var _get = function _get(hit, field) {
                 v: currentValue.map(function (val) {
                   return _get(val, innerPath);
                 }).filter(function (val) {
-                  return !_isType.isEmpty(val);
+                  return !isEmpty.isEmpty(val);
                 })
               };
             } else {
@@ -89,37 +99,48 @@ var _get = function _get(hit, field) {
     }
   }
   return undefined;
-};
+}
 
 /**
- * get property value by path
- * @internal
+ * Get a value from an object by a given path.
+ * This function allows you to retrieve a value from a nested object structure using a dot-separated path.
+ * If the path does not exist or the object is empty, it returns a default value.
+ * @param {KeyValue} obj - The object from which to retrieve the value.
+ * @param {string} path - The dot-separated path to the value within the object.
+ * @param {any} defaultValue - The value to return if the path does not exist or the object is empty.
+ * @typedef {T} AnyObject - The type of the value to be returned.
+ * @returns {T} The value at the specified path, or the default value if the path does not exist.
  */
-var getByPath = function getByPath(obj, path) {
+function getByPath(obj, path) {
   var defaultValue = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : undefined;
   /** ***************** if empty object/path return defaultValue *******************/
-  if (_isType.isEmpty(obj) || _isType.isEmpty(path)) {
+  if (isEmpty.isEmpty(obj) || isEmpty.isEmpty(path)) {
     return defaultValue;
   }
   var value = _get(obj, path);
-  if (!_isType.isNil(value)) {
+  if (!nullChecks.isNil(value)) {
     return value;
   }
   return defaultValue;
-};
+}
 
 /**
- * get first available value in list
- * @internal
+ * Get the first non-empty value from the provided arguments.
+ * This function is useful for finding a default value or fallback when multiple values are provided.
+ * It checks each argument in order and returns the first one that is not empty.
+ * If all arguments are empty, it returns `undefined`.
+ *
+ * @param {...any} args - The values to check for non-emptiness.
+ * @returns {any} The first non-empty value, or `undefined` if all are empty.
  */
-var getValue = function getValue() {
+function getValue() {
   for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
     args[_key] = arguments[_key];
   }
   return args.find(function (a) {
-    return !_isType.isEmpty(a);
+    return !isEmpty.isEmpty(a);
   });
-};
+}
 
 exports.getByPath = getByPath;
 exports.getValue = getValue;

package/dist/cjs/lists/groupBy.js

@@ -0,0 +1,49 @@
+'use strict';
+
+/**
+ * React Fabric
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+/**
+ * Group a list of objects by a specific property.
+ * If the property is not present in an object, it will use the `missingKey` value as the key.
+ * This is useful for organizing data into categories based on a specific property.
+ *
+ * @param list
+ * @param prop
+ * @param missingKey
+ * @typedef {T} KeyValue - A generic type representing list items with key-value pairs.
+ * @returns {KeyValue<T[]>} - An object mapping keys to arrays of items.
+ */
+function groupBy(list, prop, missingKey) {
+  return list.reduce(function (r, i) {
+    var _ref;
+    var key = (_ref = i[prop]) !== null && _ref !== void 0 ? _ref : missingKey;
+    if (!r[key]) r[key] = [];
+    r[key].push(i);
+    return r;
+  }, {});
+}
+
+exports.groupBy = groupBy;

package/dist/cjs/matchers/compare.js

@@ -0,0 +1,70 @@
+'use strict';
+
+var getByPath = require('../lists/getByPath.js');
+var ascii = require('../strings/ascii.js');
+var typeChecks = require('./typeChecks.js');
+
+/**
+ * React Fabric
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+
+/**
+ * Compare two values for sorting.
+ * This function compares two values based on the specified order (ascending or descending).
+ * If a key is provided, it compares the values of that key in the objects.
+ * It handles various data types such as strings, numbers, booleans, and objects.
+ * It returns a comparison function that can be used with array sorting methods.
+ * * The comparison is done in a case-insensitive manner for strings,
+ *  treating special characters as their ASCII equivalents.
+ *
+ * @param {("asc" | "desc")} order - The order of comparison, either "asc" for ascending or "desc" for descending.
+ * @param {string} key - An optional key to compare values within objects.
+ * @returns {Function} A comparison function that can be used with array sorting methods.
+ */
+function compareValues() {
+  var order = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : "asc";
+  var key = arguments.length > 1 ? arguments[1] : undefined;
+  return function (a, b) {
+    var aValue = key && typeChecks.isObject(a) ? getByPath.getByPath(a, key, "") : a;
+    var bValue = key && typeChecks.isObject(b) ? getByPath.getByPath(b, key, "") : b;
+    var bigger = order === "asc" ? 1 : -1;
+    var smaller = order === "desc" ? 1 : -1;
+    // return 0 when equal, allowing for multiple sorting properties
+    if (aValue === bValue) return 0;
+    // if numbers check greater
+    if (typeChecks.isNumber(aValue) && typeChecks.isNumber(bValue)) {
+      return aValue > bValue ? bigger : smaller;
+    }
+    // if boolean sort true first
+    if (typeChecks.isBoolean(aValue) && typeChecks.isBoolean(bValue)) {
+      return aValue ? smaller : bigger;
+    }
+    var _a = ascii.ascii(aValue).toLowerCase();
+    var _b = ascii.ascii(bValue).toLowerCase();
+    return _a.localeCompare(_b) === 1 ? bigger : smaller;
+  };
+}
+
+exports.compareValues = compareValues;

package/dist/cjs/matchers/isEmpty.js

@@ -0,0 +1,34 @@
+'use strict';
+
+var _typeof = require('@babel/runtime/helpers/typeof');
+var nullChecks = require('./nullChecks.js');
+
+/**
+ * Check if a value is empty.
+ * A value is considered empty if it is:
+ * - undefined
+ * - null
+ * - an empty string
+ * - an empty array
+ * - an empty object
+ * - an empty Map or Set
+ * - a boolean, number, or bigint (not empty)
+ * @param val - The value to check.
+ * @returns true if the value is empty, false otherwise.
+ */
+function isEmpty(val) {
+  if (val instanceof Date) return false;
+  if (nullChecks.isNil(val) || val === "") {
+    return true;
+  }
+  if (Array.isArray(val) && val.filter(nullChecks.isDefined).length === 0) {
+    return true;
+  }
+  if (val instanceof Map || val instanceof Set) return val.size === 0;
+  if (["boolean", "number", "bigint", "function"].includes(_typeof(val))) {
+    return false;
+  }
+  return !!val && _typeof(val) === "object" && Object.entries(val).length === 0;
+}
+
+exports.isEmpty = isEmpty;

package/dist/cjs/matchers/isEqual.js

@@ -0,0 +1,82 @@
+'use strict';
+
+var nullChecks = require('./nullChecks.js');
+var typeChecks = require('./typeChecks.js');
+
+/**
+ * React Fabric
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+
+/**
+ * Compare two objects or values for equality.
+ * This function checks if two values are equal, including nested objects and arrays.
+ * It handles various data types such as strings, numbers, booleans, arrays, and objects.
+ * If both values are `null` or `undefined`, they are considered equal.
+ * If both values are primitive types (string, number, boolean), they are compared directly.
+ * If both values are arrays, they are compared element by element.
+ * If both values are objects, they are compared by their keys and values.
+ * If the values are of different types or structures, they are considered not equal.
+ *
+ * @param {unknown} obj - The first value to compare.
+ * @param {unknown} test - The second value to compare against the first.
+ * @returns {boolean} - Returns true if the values are equal, false otherwise.
+ */
+function isEqual(obj, test) {
+  if (nullChecks.isNil(obj) && nullChecks.isNil(test)) {
+    return true;
+  }
+  if (typeChecks.isString(obj) || typeChecks.isNumber(obj) || typeChecks.isBoolean(obj)) {
+    return obj === test;
+  } else if (Array.isArray(obj) && Array.isArray(test)) {
+    // if length dont match return false
+    if (obj.length !== test.length) {
+      return false;
+    }
+    // check if some value is false
+    return !obj.some(function (o, i) {
+      return !isEqual(o, test[i]);
+    });
+  } else if (typeChecks.isObject(obj) && typeChecks.isObject(test)) {
+    var okeys = Object.keys(obj);
+    var tkeys = Object.keys(test);
+    // if keys length dont match return false
+    if (okeys.length !== tkeys.length) {
+      return false;
+    }
+    // if keys dont match return false
+    if (okeys.some(function (k) {
+      return !tkeys.includes(k);
+    })) {
+      return false;
+    }
+    // check if some value is false
+    return !Object.keys(obj).some(function (k) {
+      return !isEqual(obj[k], test[k]);
+    });
+  }
+  return false;
+}
+
+exports.isEqual = isEqual;

package/dist/cjs/matchers/nullChecks.js

@@ -0,0 +1,61 @@
+'use strict';
+
+/**
+ * React Fabric
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+/**
+ * Check if a value is undefined.
+ * @param value - The value to check.
+ * @returns true if the value is undefined, false otherwise.
+ */
+function isUndefined(value) {
+  return value === undefined;
+}
+
+/**
+ * Check if a value is null.
+ * @param value - The value to check.
+ * @returns true if the value is null, false otherwise.
+ */
+function isNull(value) {
+  return value === null;
+}
+
+/**
+ * Check if a value is either null or undefined.
+ * @param val - The value to check.
+ * @returns true if the value is null or undefined, false otherwise.
+ */
+function isNil(val) {
+  return val === undefined || val === null;
+}
+function isDefined(val) {
+  return !isNil(val) && val !== "";
+}
+
+exports.isDefined = isDefined;
+exports.isNil = isNil;
+exports.isNull = isNull;
+exports.isUndefined = isUndefined;