@splendidlabz/utils 1.15.1 → 1.16.0

package/dist/cjs/dom/actions/index.cjs

@@ -171,18 +171,26 @@ function isPlainObject(x) {
   return prototype === Object.prototype || prototype === null;
 }
 
+// src/lib/objects/empty.js
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "string" || Array.isArray(value)) {
+    return value.length === 0;
+  }
+  if (isPlainObject(value)) return Object.keys(value).length === 0;
+  if (typeof value.size === "number") return value.size === 0;
+  return false;
+}
+
 // src/lib/objects/omit-empty.js
 function omitEmpty(obj, options = {}) {
-  const { shallow = false, omitFalsey = false } = typeof options === "boolean" ? { shallow: options } : options;
+  const { shallow = false } = typeof options === "boolean" ? { shallow: options } : options;
   if (!isPlainObject(obj) && !Array.isArray(obj)) return obj;
   const result = Array.isArray(obj) ? [] : {};
   for (const [key, value] of Object.entries(obj)) {
-    if (value === null || value === void 0 || value === "") continue;
-    if (omitFalsey && !value) continue;
-    if ((isPlainObject(value) || Array.isArray(value)) && Object.keys(value).length === 0) {
-      continue;
-    }
-    const filteredValue = shallow ? value : omitEmpty(value, { omitFalsey });
+    if (isEmpty(value)) continue;
+    const walk = !shallow && (isPlainObject(value) || Array.isArray(value));
+    const filteredValue = walk ? omitEmpty(value) : value;
     if (Array.isArray(result)) result.push(filteredValue);
     else result[key] = filteredValue;
   }

package/dist/cjs/dom/actions/prefer-horizontal-scroll.cjs

@@ -30,18 +30,26 @@ function isPlainObject(x) {
   return prototype === Object.prototype || prototype === null;
 }
 
+// src/lib/objects/empty.js
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "string" || Array.isArray(value)) {
+    return value.length === 0;
+  }
+  if (isPlainObject(value)) return Object.keys(value).length === 0;
+  if (typeof value.size === "number") return value.size === 0;
+  return false;
+}
+
 // src/lib/objects/omit-empty.js
 function omitEmpty(obj, options = {}) {
-  const { shallow = false, omitFalsey = false } = typeof options === "boolean" ? { shallow: options } : options;
+  const { shallow = false } = typeof options === "boolean" ? { shallow: options } : options;
   if (!isPlainObject(obj) && !Array.isArray(obj)) return obj;
   const result = Array.isArray(obj) ? [] : {};
   for (const [key, value] of Object.entries(obj)) {
-    if (value === null || value === void 0 || value === "") continue;
-    if (omitFalsey && !value) continue;
-    if ((isPlainObject(value) || Array.isArray(value)) && Object.keys(value).length === 0) {
-      continue;
-    }
-    const filteredValue = shallow ? value : omitEmpty(value, { omitFalsey });
+    if (isEmpty(value)) continue;
+    const walk = !shallow && (isPlainObject(value) || Array.isArray(value));
+    const filteredValue = walk ? omitEmpty(value) : value;
     if (Array.isArray(result)) result.push(filteredValue);
     else result[key] = filteredValue;
   }

package/dist/cjs/dom/index.cjs

@@ -313,18 +313,26 @@ function isPlainObject(x) {
   return prototype === Object.prototype || prototype === null;
 }
 
+// src/lib/objects/empty.js
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "string" || Array.isArray(value)) {
+    return value.length === 0;
+  }
+  if (isPlainObject(value)) return Object.keys(value).length === 0;
+  if (typeof value.size === "number") return value.size === 0;
+  return false;
+}
+
 // src/lib/objects/omit-empty.js
 function omitEmpty(obj, options = {}) {
-  const { shallow = false, omitFalsey = false } = typeof options === "boolean" ? { shallow: options } : options;
+  const { shallow = false } = typeof options === "boolean" ? { shallow: options } : options;
   if (!isPlainObject(obj) && !Array.isArray(obj)) return obj;
   const result = Array.isArray(obj) ? [] : {};
   for (const [key, value] of Object.entries(obj)) {
-    if (value === null || value === void 0 || value === "") continue;
-    if (omitFalsey && !value) continue;
-    if ((isPlainObject(value) || Array.isArray(value)) && Object.keys(value).length === 0) {
-      continue;
-    }
-    const filteredValue = shallow ? value : omitEmpty(value, { omitFalsey });
+    if (isEmpty(value)) continue;
+    const walk = !shallow && (isPlainObject(value) || Array.isArray(value));
+    const filteredValue = walk ? omitEmpty(value) : value;
     if (Array.isArray(result)) result.push(filteredValue);
     else result[key] = filteredValue;
   }

package/dist/cjs/lib/index.cjs

@@ -835,14 +835,17 @@ function camelCaseKeys(obj) {
 }
 
 // src/lib/objects/empty.js
-function isEmpty(obj) {
-  if (typeof obj === "undefined") return true;
-  if (obj === null) return true;
-  if (Array.isArray(obj)) return obj.length === 0;
-  return Object.keys(obj).length === 0;
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "string" || Array.isArray(value)) {
+    return value.length === 0;
+  }
+  if (isPlainObject(value)) return Object.keys(value).length === 0;
+  if (typeof value.size === "number") return value.size === 0;
+  return false;
 }
-function notEmpty(obj) {
-  return !isEmpty(obj);
+function notEmpty(value) {
+  return !isEmpty(value);
 }
 
 // src/lib/objects/equal.js
@@ -974,16 +977,13 @@ function parseJSON(value, defaultValue = {}) {
 
 // src/lib/objects/omit-empty.js
 function omitEmpty(obj, options = {}) {
-  const { shallow = false, omitFalsey = false } = typeof options === "boolean" ? { shallow: options } : options;
+  const { shallow = false } = typeof options === "boolean" ? { shallow: options } : options;
   if (!isPlainObject(obj) && !Array.isArray(obj)) return obj;
   const result = Array.isArray(obj) ? [] : {};
   for (const [key, value] of Object.entries(obj)) {
-    if (value === null || value === void 0 || value === "") continue;
-    if (omitFalsey && !value) continue;
-    if ((isPlainObject(value) || Array.isArray(value)) && Object.keys(value).length === 0) {
-      continue;
-    }
-    const filteredValue = shallow ? value : omitEmpty(value, { omitFalsey });
+    if (isEmpty(value)) continue;
+    const walk = !shallow && (isPlainObject(value) || Array.isArray(value));
+    const filteredValue = walk ? omitEmpty(value) : value;
     if (Array.isArray(result)) result.push(filteredValue);
     else result[key] = filteredValue;
   }

package/dist/cjs/lib/objects/empty.cjs

@@ -23,14 +23,26 @@ __export(empty_exports, {
   notEmpty: () => notEmpty
 });
 module.exports = __toCommonJS(empty_exports);
-function isEmpty(obj) {
-  if (typeof obj === "undefined") return true;
-  if (obj === null) return true;
-  if (Array.isArray(obj)) return obj.length === 0;
-  return Object.keys(obj).length === 0;
+
+// src/lib/checks.js
+function isPlainObject(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const prototype = Object.getPrototypeOf(x);
+  return prototype === Object.prototype || prototype === null;
+}
+
+// src/lib/objects/empty.js
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "string" || Array.isArray(value)) {
+    return value.length === 0;
+  }
+  if (isPlainObject(value)) return Object.keys(value).length === 0;
+  if (typeof value.size === "number") return value.size === 0;
+  return false;
 }
-function notEmpty(obj) {
-  return !isEmpty(obj);
+function notEmpty(value) {
+  return !isEmpty(value);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/cjs/lib/objects/index.cjs

@@ -114,15 +114,28 @@ function camelCaseKeys(obj) {
   return result;
 }
 
+// src/lib/checks.js
+function isObject(x) {
+  return typeof x === "object" && !Array.isArray(x) && x !== null;
+}
+function isPlainObject(x) {
+  if (typeof x !== "object" || x === null) return false;
+  const prototype = Object.getPrototypeOf(x);
+  return prototype === Object.prototype || prototype === null;
+}
+
 // src/lib/objects/empty.js
-function isEmpty(obj) {
-  if (typeof obj === "undefined") return true;
-  if (obj === null) return true;
-  if (Array.isArray(obj)) return obj.length === 0;
-  return Object.keys(obj).length === 0;
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "string" || Array.isArray(value)) {
+    return value.length === 0;
+  }
+  if (isPlainObject(value)) return Object.keys(value).length === 0;
+  if (typeof value.size === "number") return value.size === 0;
+  return false;
 }
-function notEmpty(obj) {
-  return !isEmpty(obj);
+function notEmpty(value) {
+  return !isEmpty(value);
 }
 
 // src/lib/objects/equal.js
@@ -246,16 +259,6 @@ function extendObject(object) {
   return { orig, extended };
 }
 
-// src/lib/checks.js
-function isObject(x) {
-  return typeof x === "object" && !Array.isArray(x) && x !== null;
-}
-function isPlainObject(x) {
-  if (typeof x !== "object" || x === null) return false;
-  const prototype = Object.getPrototypeOf(x);
-  return prototype === Object.prototype || prototype === null;
-}
-
 // src/lib/objects/flatten.js
 function flattenObject(obj, { separator, prefix = "" }) {
   return Object.entries(obj).reduce((acc, [key, value]) => {
@@ -297,16 +300,13 @@ function getNestedValue(object, path) {
 
 // src/lib/objects/omit-empty.js
 function omitEmpty(obj, options = {}) {
-  const { shallow = false, omitFalsey = false } = typeof options === "boolean" ? { shallow: options } : options;
+  const { shallow = false } = typeof options === "boolean" ? { shallow: options } : options;
   if (!isPlainObject(obj) && !Array.isArray(obj)) return obj;
   const result = Array.isArray(obj) ? [] : {};
   for (const [key, value] of Object.entries(obj)) {
-    if (value === null || value === void 0 || value === "") continue;
-    if (omitFalsey && !value) continue;
-    if ((isPlainObject(value) || Array.isArray(value)) && Object.keys(value).length === 0) {
-      continue;
-    }
-    const filteredValue = shallow ? value : omitEmpty(value, { omitFalsey });
+    if (isEmpty(value)) continue;
+    const walk = !shallow && (isPlainObject(value) || Array.isArray(value));
+    const filteredValue = walk ? omitEmpty(value) : value;
     if (Array.isArray(result)) result.push(filteredValue);
     else result[key] = filteredValue;
   }

package/dist/cjs/lib/objects/normalize-object.cjs

@@ -92,18 +92,26 @@ function isPlainObject(x) {
   return prototype === Object.prototype || prototype === null;
 }
 
+// src/lib/objects/empty.js
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "string" || Array.isArray(value)) {
+    return value.length === 0;
+  }
+  if (isPlainObject(value)) return Object.keys(value).length === 0;
+  if (typeof value.size === "number") return value.size === 0;
+  return false;
+}
+
 // src/lib/objects/omit-empty.js
 function omitEmpty(obj, options = {}) {
-  const { shallow = false, omitFalsey = false } = typeof options === "boolean" ? { shallow: options } : options;
+  const { shallow = false } = typeof options === "boolean" ? { shallow: options } : options;
   if (!isPlainObject(obj) && !Array.isArray(obj)) return obj;
   const result = Array.isArray(obj) ? [] : {};
   for (const [key, value] of Object.entries(obj)) {
-    if (value === null || value === void 0 || value === "") continue;
-    if (omitFalsey && !value) continue;
-    if ((isPlainObject(value) || Array.isArray(value)) && Object.keys(value).length === 0) {
-      continue;
-    }
-    const filteredValue = shallow ? value : omitEmpty(value, { omitFalsey });
+    if (isEmpty(value)) continue;
+    const walk = !shallow && (isPlainObject(value) || Array.isArray(value));
+    const filteredValue = walk ? omitEmpty(value) : value;
     if (Array.isArray(result)) result.push(filteredValue);
     else result[key] = filteredValue;
   }

package/dist/cjs/lib/objects/omit-empty.cjs

@@ -30,18 +30,26 @@ function isPlainObject(x) {
   return prototype === Object.prototype || prototype === null;
 }
 
+// src/lib/objects/empty.js
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "string" || Array.isArray(value)) {
+    return value.length === 0;
+  }
+  if (isPlainObject(value)) return Object.keys(value).length === 0;
+  if (typeof value.size === "number") return value.size === 0;
+  return false;
+}
+
 // src/lib/objects/omit-empty.js
 function omitEmpty(obj, options = {}) {
-  const { shallow = false, omitFalsey = false } = typeof options === "boolean" ? { shallow: options } : options;
+  const { shallow = false } = typeof options === "boolean" ? { shallow: options } : options;
   if (!isPlainObject(obj) && !Array.isArray(obj)) return obj;
   const result = Array.isArray(obj) ? [] : {};
   for (const [key, value] of Object.entries(obj)) {
-    if (value === null || value === void 0 || value === "") continue;
-    if (omitFalsey && !value) continue;
-    if ((isPlainObject(value) || Array.isArray(value)) && Object.keys(value).length === 0) {
-      continue;
-    }
-    const filteredValue = shallow ? value : omitEmpty(value, { omitFalsey });
+    if (isEmpty(value)) continue;
+    const walk = !shallow && (isPlainObject(value) || Array.isArray(value));
+    const filteredValue = walk ? omitEmpty(value) : value;
     if (Array.isArray(result)) result.push(filteredValue);
     else result[key] = filteredValue;
   }

package/dist/cjs/lib/promises/index.cjs

@@ -30,18 +30,26 @@ function isPlainObject(x) {
   return prototype === Object.prototype || prototype === null;
 }
 
+// src/lib/objects/empty.js
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "string" || Array.isArray(value)) {
+    return value.length === 0;
+  }
+  if (isPlainObject(value)) return Object.keys(value).length === 0;
+  if (typeof value.size === "number") return value.size === 0;
+  return false;
+}
+
 // src/lib/objects/omit-empty.js
 function omitEmpty(obj, options = {}) {
-  const { shallow = false, omitFalsey = false } = typeof options === "boolean" ? { shallow: options } : options;
+  const { shallow = false } = typeof options === "boolean" ? { shallow: options } : options;
   if (!isPlainObject(obj) && !Array.isArray(obj)) return obj;
   const result = Array.isArray(obj) ? [] : {};
   for (const [key, value] of Object.entries(obj)) {
-    if (value === null || value === void 0 || value === "") continue;
-    if (omitFalsey && !value) continue;
-    if ((isPlainObject(value) || Array.isArray(value)) && Object.keys(value).length === 0) {
-      continue;
-    }
-    const filteredValue = shallow ? value : omitEmpty(value, { omitFalsey });
+    if (isEmpty(value)) continue;
+    const walk = !shallow && (isPlainObject(value) || Array.isArray(value));
+    const filteredValue = walk ? omitEmpty(value) : value;
     if (Array.isArray(result)) result.push(filteredValue);
     else result[key] = filteredValue;
   }

package/dist/cjs/lib/promises/reject.cjs

@@ -30,18 +30,26 @@ function isPlainObject(x) {
   return prototype === Object.prototype || prototype === null;
 }
 
+// src/lib/objects/empty.js
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "string" || Array.isArray(value)) {
+    return value.length === 0;
+  }
+  if (isPlainObject(value)) return Object.keys(value).length === 0;
+  if (typeof value.size === "number") return value.size === 0;
+  return false;
+}
+
 // src/lib/objects/omit-empty.js
 function omitEmpty(obj, options = {}) {
-  const { shallow = false, omitFalsey = false } = typeof options === "boolean" ? { shallow: options } : options;
+  const { shallow = false } = typeof options === "boolean" ? { shallow: options } : options;
   if (!isPlainObject(obj) && !Array.isArray(obj)) return obj;
   const result = Array.isArray(obj) ? [] : {};
   for (const [key, value] of Object.entries(obj)) {
-    if (value === null || value === void 0 || value === "") continue;
-    if (omitFalsey && !value) continue;
-    if ((isPlainObject(value) || Array.isArray(value)) && Object.keys(value).length === 0) {
-      continue;
-    }
-    const filteredValue = shallow ? value : omitEmpty(value, { omitFalsey });
+    if (isEmpty(value)) continue;
+    const walk = !shallow && (isPlainObject(value) || Array.isArray(value));
+    const filteredValue = walk ? omitEmpty(value) : value;
     if (Array.isArray(result)) result.push(filteredValue);
     else result[key] = filteredValue;
   }

package/dist/cjs/lib/sse.cjs

@@ -40,18 +40,26 @@ function isPlainObject(x) {
   return prototype === Object.prototype || prototype === null;
 }
 
+// src/lib/objects/empty.js
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "string" || Array.isArray(value)) {
+    return value.length === 0;
+  }
+  if (isPlainObject(value)) return Object.keys(value).length === 0;
+  if (typeof value.size === "number") return value.size === 0;
+  return false;
+}
+
 // src/lib/objects/omit-empty.js
 function omitEmpty(obj, options = {}) {
-  const { shallow = false, omitFalsey = false } = typeof options === "boolean" ? { shallow: options } : options;
+  const { shallow = false } = typeof options === "boolean" ? { shallow: options } : options;
   if (!isPlainObject(obj) && !Array.isArray(obj)) return obj;
   const result = Array.isArray(obj) ? [] : {};
   for (const [key, value] of Object.entries(obj)) {
-    if (value === null || value === void 0 || value === "") continue;
-    if (omitFalsey && !value) continue;
-    if ((isPlainObject(value) || Array.isArray(value)) && Object.keys(value).length === 0) {
-      continue;
-    }
-    const filteredValue = shallow ? value : omitEmpty(value, { omitFalsey });
+    if (isEmpty(value)) continue;
+    const walk = !shallow && (isPlainObject(value) || Array.isArray(value));
+    const filteredValue = walk ? omitEmpty(value) : value;
     if (Array.isArray(result)) result.push(filteredValue);
     else result[key] = filteredValue;
   }

package/dist/esm/lib/objects/empty.js

@@ -1,11 +1,15 @@
-function isEmpty(obj) {
-  if (typeof obj === "undefined") return true;
-  if (obj === null) return true;
-  if (Array.isArray(obj)) return obj.length === 0;
-  return Object.keys(obj).length === 0;
+import { isPlainObject } from "../checks.js";
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "string" || Array.isArray(value)) {
+    return value.length === 0;
+  }
+  if (isPlainObject(value)) return Object.keys(value).length === 0;
+  if (typeof value.size === "number") return value.size === 0;
+  return false;
 }
-function notEmpty(obj) {
-  return !isEmpty(obj);
+function notEmpty(value) {
+  return !isEmpty(value);
 }
 export {
   isEmpty,

package/dist/esm/lib/objects/omit-empty.js

@@ -1,15 +1,13 @@
 import { isPlainObject } from "../checks.js";
+import { isEmpty } from "./empty.js";
 function omitEmpty(obj, options = {}) {
-  const { shallow = false, omitFalsey = false } = typeof options === "boolean" ? { shallow: options } : options;
+  const { shallow = false } = typeof options === "boolean" ? { shallow: options } : options;
   if (!isPlainObject(obj) && !Array.isArray(obj)) return obj;
   const result = Array.isArray(obj) ? [] : {};
   for (const [key, value] of Object.entries(obj)) {
-    if (value === null || value === void 0 || value === "") continue;
-    if (omitFalsey && !value) continue;
-    if ((isPlainObject(value) || Array.isArray(value)) && Object.keys(value).length === 0) {
-      continue;
-    }
-    const filteredValue = shallow ? value : omitEmpty(value, { omitFalsey });
+    if (isEmpty(value)) continue;
+    const walk = !shallow && (isPlainObject(value) || Array.isArray(value));
+    const filteredValue = walk ? omitEmpty(value) : value;
     if (Array.isArray(result)) result.push(filteredValue);
     else result[key] = filteredValue;
   }

package/dist/types/lib/objects/empty.d.cts

@@ -1,4 +1,21 @@
-declare function isEmpty(obj: any): boolean;
-declare function notEmpty(obj: any): boolean;
+/**
+ * Says whether a value holds nothing — absence, or a container with nothing in it. `0` and `false` are answers, not emptiness.
+ * @param {any} value - The value to check
+ * @returns {boolean} True where there is nothing there
+ * @example
+ * isEmpty(null) // true
+ * isEmpty([]) // true
+ * isEmpty(new Map()) // true
+ * isEmpty(0) // false
+ * isEmpty(false) // false
+ * isEmpty(new Date()) // false
+ */
+declare function isEmpty(value: any): boolean;
+/**
+ * Says whether a value holds something. The inverse of {@link isEmpty}.
+ * @param {any} value - The value to check
+ * @returns {boolean} True where there is something there
+ */
+declare function notEmpty(value: any): boolean;
 
 export { isEmpty, notEmpty };

package/dist/types/lib/objects/omit-empty.d.cts

@@ -1,17 +1,15 @@
 /**
- * Drop the keys holding nothing — null, undefined, an empty string, an empty object or an empty array.
+ * Drop the keys holding nothing, as {@link isEmpty} reads it.
  *
  * @template {object} T
  * @overload
  * @param {T} obj Object to filter.
  * @param {object} [options]
  * @param {boolean} [options.shallow=false] Leave nested values alone.
- * @param {boolean} [options.omitFalsey=false] Drop 0, false and NaN too.
  * @returns {T extends readonly (infer E)[] ? NonNullable<E>[] : Partial<T>} A copy without the empty keys. An array answers with an array, its element type stripped of `null` and `undefined` — the two entries this always drops.
  */
 declare function omitEmpty<T extends unknown>(obj: T, options?: {
     shallow?: boolean;
-    omitFalsey?: boolean;
 }): T extends readonly (infer E)[] ? NonNullable<E>[] : Partial<T>;
 /**
  * Drop the keys holding nothing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@splendidlabz/utils",
-  "version": "1.15.1",
+  "version": "1.16.0",
   "description": "",
   "type": "module",
   "homepage": "https://splendidlabz.com/docs/utils",