@dvirus-js/utils 0.0.16 → 0.0.18

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## 0.0.17 (2026-06-12)
+
+### 🩹 Fixes
+
+- **signals:** split signal-form into secondary entry point subpath ([16b14f9](https://github.com/Dvirus97/dvirus-js/commit/16b14f9))
+
+### ❤️ Thank You
+
+- Dvir Cohen
+
+## 0.0.16 (2026-05-31)
+
+This was a version bump only for utils to align it with other projects, there were no code changes.
+
 ## 0.0.15 (2026-05-31)
 
 ### 🩹 Fixes

package/index.d.ts

@@ -9,3 +9,4 @@ export * from './lib/to-array';
 export * from './lib/signals';
 export * from './lib/html-text-parser';
 export * from './lib/brand-type';
+export * from './lib/get-empty-keys';

package/index.js

@@ -2,42 +2,42 @@ function V(e) {
   return e.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").toLowerCase().replace(/[_-]+/g, " ").replace(/\s+/g, " ").trim();
 }
 function ue(e, t) {
-  const r = V(e);
+  const n = V(e);
   switch (t) {
     case "lowercase":
-      return r.toLowerCase();
+      return n.toLowerCase();
     case "UPPERCASE":
-      return r.toUpperCase();
+      return n.toUpperCase();
     case "Title Case":
-      return r.split(" ").map(
-        (n) => n.charAt(0).toUpperCase() + n.slice(1).toLowerCase()
+      return n.split(" ").map(
+        (r) => r.charAt(0).toUpperCase() + r.slice(1).toLowerCase()
       ).join(" ");
     case "kebab-case":
-      return r.replace(/\s+/g, "-");
+      return n.replace(/\s+/g, "-");
     case "snake_case":
-      return r.replace(/\s+/g, "_");
+      return n.replace(/\s+/g, "_");
     case "camelCase": {
-      const n = r.split(" ");
-      return n.length === 0 ? "" : n[0]?.toLowerCase() + n.slice(1).map(
+      const r = n.split(" ");
+      return r.length === 0 ? "" : r[0]?.toLowerCase() + r.slice(1).map(
         (o) => o.charAt(0).toUpperCase() + o.slice(1).toLowerCase()
       ).join("");
     }
     case "PascalCase":
-      return r.split(" ").map(
-        (n) => n.charAt(0).toUpperCase() + n.slice(1).toLowerCase()
+      return n.split(" ").map(
+        (r) => r.charAt(0).toUpperCase() + r.slice(1).toLowerCase()
       ).join("");
     case "dot.case":
-      return r.replace(/\s+/g, ".");
+      return n.replace(/\s+/g, ".");
     case "path/case":
-      return r.replace(/\s+/g, "/");
+      return n.replace(/\s+/g, "/");
     case "Sentence case":
-      return r.replace(/(^\s*\w|[.!?]\s*\w)/g, (n) => n.toUpperCase()).replace(/\bi\b/g, "I");
+      return n.replace(/(^\s*\w|[.!?]\s*\w)/g, (r) => r.toUpperCase()).replace(/\bi\b/g, "I");
     case "Header-Case":
-      return r.split(" ").map(
-        (n) => n.charAt(0).toUpperCase() + n.slice(1).toLowerCase()
+      return n.split(" ").map(
+        (r) => r.charAt(0).toUpperCase() + r.slice(1).toLowerCase()
       ).join("-");
     case "reverse":
-      return r.split("").reverse().join("");
+      return n.split("").reverse().join("");
     default:
       throw new Error(`Unsupported case type: ${t}`);
   }
@@ -149,18 +149,18 @@ const U = {
    * @returns {Promise<R>} The response data.
    * @throws {Error} If the response is not ok.
    */
-  post: async function(e, t, r) {
+  post: async function(e, t, n) {
     return await w(
       () => fetch(b + e, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
-          ...r?.headers
+          ...n?.headers
         },
         body: JSON.stringify(t),
-        ...r
+        ...n
       }),
-      r
+      n
     );
   },
   /**
@@ -195,18 +195,18 @@ const U = {
    * @returns {Promise<R>} The response data.
    * @throws {Error} If the response is not ok.
    */
-  patch: async function(e, t, r) {
+  patch: async function(e, t, n) {
     return await w(
       () => fetch(b + e, {
         method: "PATCH",
         headers: {
           "Content-Type": "application/json",
-          ...r?.headers
+          ...n?.headers
         },
         body: JSON.stringify(t),
-        ...r
+        ...n
       }),
-      r
+      n
     );
   },
   /**
@@ -219,123 +219,123 @@ const U = {
    * @returns {Promise<R>} The response data.
    * @throws {Error} If the response is not ok.
    */
-  put: async function(e, t, r) {
+  put: async function(e, t, n) {
     return await w(
       () => fetch(b + e, {
         method: "PUT",
         headers: {
           "Content-Type": "application/json",
-          ...r?.headers
+          ...n?.headers
         },
         body: JSON.stringify(t),
-        ...r
+        ...n
       }),
-      r
+      n
     );
   }
 };
 async function w(e, t) {
   try {
-    const r = await e();
-    if (!r.ok) {
-      const n = await r.text(), [o, s] = E(() => JSON.parse(n));
-      throw Object.assign(r, {
-        data: s ? n : o,
-        name: `HTTP_${r.status}`,
-        message: r.statusText || U[r.status] || `HTTP_${r.status}`
+    const n = await e();
+    if (!n.ok) {
+      const r = await n.text(), [o, s] = E(() => JSON.parse(r));
+      throw Object.assign(n, {
+        data: s ? r : o,
+        name: `HTTP_${n.status}`,
+        message: n.statusText || U[n.status] || `HTTP_${n.status}`
       });
     }
-    return t?.parse === "JSON" ? Object.assign(r, {
-      data: await r.json()
-    }) : t?.parse === "TEXT" ? Object.assign(r, {
-      data: await r.text()
-    }) : t?.parse === "BLOB" ? Object.assign(r, {
-      data: await r.blob()
-    }) : t?.parse === "ARRAYBUFFER" ? Object.assign(r, {
-      data: await r.arrayBuffer()
-    }) : Object.assign(r, {
-      data: await r.json()
+    return t?.parse === "JSON" ? Object.assign(n, {
+      data: await n.json()
+    }) : t?.parse === "TEXT" ? Object.assign(n, {
+      data: await n.text()
+    }) : t?.parse === "BLOB" ? Object.assign(n, {
+      data: await n.blob()
+    }) : t?.parse === "ARRAYBUFFER" ? Object.assign(n, {
+      data: await n.arrayBuffer()
+    }) : Object.assign(n, {
+      data: await n.json()
     });
-  } catch (r) {
-    if (J(r)) throw r;
-    const n = {
-      data: r,
+  } catch (n) {
+    if (J(n)) throw n;
+    const r = {
+      data: n,
       ok: !1,
       status: 0,
       statusText: "NETWORK_ERROR",
       type: "error",
       name: "NetworkError",
-      message: r instanceof Error ? r.message : String(r),
+      message: n instanceof Error ? n.message : String(n),
       headers: new Headers(),
       url: "",
       redirected: !1,
-      clone: () => n,
+      clone: () => r,
       bodyUsed: !1,
       formData: () => Promise.resolve(new FormData())
     };
-    throw n;
+    throw r;
   }
 }
 function J(e) {
   return e !== null && typeof e == "object" && "data" in e && "body" in e;
 }
 function he(e, t) {
-  const r = {};
-  return e?.forEach((n, o) => {
-    const s = t(n, o, e)?.toString();
-    s && (r[s] ??= [], r[s].push(n));
-  }), r;
+  const n = {};
+  return e?.forEach((r, o) => {
+    const s = t(r, o, e)?.toString();
+    s && (n[s] ??= [], n[s].push(r));
+  }), n;
 }
 async function ge(e) {
   return await new Promise((t) => setTimeout(t, e));
 }
-function pe(e, t, r) {
-  return t < e ? e : t > r ? r : t;
+function pe(e, t, n) {
+  return t < e ? e : t > n ? n : t;
 }
-function me(e, t, r) {
-  let n;
-  return r?.isLoadingFn?.(!1), Object.assign((...s) => {
-    clearTimeout(n), r?.isLoadingFn?.(!0), n = setTimeout(() => {
-      r?.isLoadingFn?.(!1), e(...s);
+function me(e, t, n) {
+  let r;
+  return n?.isLoadingFn?.(!1), Object.assign((...s) => {
+    clearTimeout(r), n?.isLoadingFn?.(!0), r = setTimeout(() => {
+      n?.isLoadingFn?.(!1), e(...s);
     }, t);
   }, {
     cancel() {
-      clearTimeout(n), r?.isLoadingFn?.(!1);
+      clearTimeout(r), n?.isLoadingFn?.(!1);
     }
   });
 }
-function Z(e, t) {
+function K(e, t) {
   if (!t || typeof t != "string" || typeof e != "object" || e === null)
     return;
-  const r = t.split(".");
-  function n(o, s) {
+  const n = t.split(".");
+  function r(o, s) {
     if (!s || typeof s != "object")
       return;
     const a = o[0];
     if (a in s)
-      return o.length === 1 ? s[a] : n(o.slice(1), s[a]);
+      return o.length === 1 ? s[a] : r(o.slice(1), s[a]);
   }
-  return n(r, e);
+  return r(n, e);
 }
-function K(e, t, r) {
-  let n = e;
+function Z(e, t, n) {
+  let r = e;
   for (let o = 0; o < t.length; o++) {
     const s = t[o] ?? "";
-    o === t.length - 1 ? n[s] = r : ((!n[s] || typeof n[s] != "object") && (n[s] = {}), n = n[s]);
+    o === t.length - 1 ? r[s] = n : ((!r[s] || typeof r[s] != "object") && (r[s] = {}), r = r[s]);
   }
 }
 function ye(e, t) {
-  const r = {};
+  const n = {};
   if (!e || typeof e != "object")
-    return r;
-  for (const n of t) {
-    const o = Z(e, n);
+    return n;
+  for (const r of t) {
+    const o = K(e, r);
     if (o !== void 0) {
-      const s = n.split(".");
-      K(r, s, o);
+      const s = r.split(".");
+      Z(n, s, o);
     }
   }
-  return r;
+  return n;
 }
 class m {
   #e = null;
@@ -362,7 +362,7 @@ class m {
    * @returns {Promise<Result<T, E>>} A promise that resolves to a Result.
    */
   static async promise(t) {
-    return t.then((r) => m.ok(r)).catch((r) => m.err(r));
+    return t.then((n) => m.ok(n)).catch((n) => m.err(n));
   }
   /**
    * Wraps a function call in a Result.
@@ -370,12 +370,12 @@ class m {
    * @param {...any[]} args - The arguments to pass to the function.
    * @returns {Result<T, E>} A Result instance representing the function call result.
    */
-  static func(t, ...r) {
+  static func(t, ...n) {
     try {
-      const n = t(...r);
-      return m.ok(n);
-    } catch (n) {
-      return m.err(n);
+      const r = t(...n);
+      return m.ok(r);
+    } catch (r) {
+      return m.err(r);
     }
   }
   /**
@@ -383,16 +383,16 @@ class m {
    * @param {E | null} err - The error value.
    * @throws {Error} If both ok and err are provided or neither is provided.
    */
-  constructor(t, r) {
-    if (t == null && r == null)
+  constructor(t, n) {
+    if (t == null && n == null)
       throw new Error(
         "Result must be initialized with either an ok or an err value"
       );
-    if (t != null && r != null)
+    if (t != null && n != null)
       throw new Error(
         "Result can't be initialized with both an ok and an err value"
       );
-    t != null ? this.#e = t : this.#t = r;
+    t != null ? this.#e = t : this.#t = n;
   }
   /**
    * Gets the success value, throwing an error if the result is a failure.
@@ -430,9 +430,9 @@ class m {
     if (this.isOk())
       return this.#e;
     if (this.isErr()) {
-      const r = this.#t;
+      const n = this.#t;
       throw new Error(t + `:
-` + r.message);
+` + n.message);
     }
     throw new Error(t);
   }
@@ -469,80 +469,80 @@ const z = /* @__PURE__ */ Symbol("SIGNAL"), we = (e) => typeof e == "function" &
     g.push(...t);
   }
 }, R = (e, t) => {
-  const r = /* @__PURE__ */ new Set();
-  let n = 0;
+  const n = /* @__PURE__ */ new Set();
+  let r = 0;
   const o = () => {
     const l = g[g.length - 1];
-    l && (r.add(l.setDirty), l.addSource(() => {
-      r.delete(l.setDirty);
+    l && (n.add(l.setDirty), l.addSource(() => {
+      n.delete(l.setDirty);
     }));
   }, s = (l) => {
-    for (const h of Array.from(r)) h(l);
-  }, a = () => n > 0;
+    for (const h of Array.from(n)) h(l);
+  }, a = () => r > 0;
   return { read: Object.assign(() => (o(), e()), {
     [z]: !0,
-    subscribe: (l) => (r.add(l), n++, t?.(), () => {
-      r.delete(l), n--;
+    subscribe: (l) => (n.add(l), r++, t?.(), () => {
+      n.delete(l), r--;
     })
   }), notify: s, hasSubscribers: a };
 }, S = (e) => {
   let t = e;
-  const { read: r, notify: n } = R(() => t);
-  return Object.assign(r, {
+  const { read: n, notify: r } = R(() => t);
+  return Object.assign(n, {
     set: (o) => {
-      t !== o && (t = o, n(o));
+      t !== o && (t = o, r(o));
     },
     update: (o) => {
       const s = o(t);
-      t !== s && (t = s, n(s));
+      t !== s && (t = s, r(s));
     },
-    asReadonly: () => r
+    asReadonly: () => n
   });
 }, k = (e) => {
   const t = /* @__PURE__ */ new Set();
-  let r = !1, n = null, o = !1;
+  let n = !1, r = null, o = !1;
   const s = () => {
-    if (o = !1, r) return;
-    n && (n(), n = null), t.forEach((i) => i()), t.clear();
+    if (o = !1, n) return;
+    r && (r(), r = null), t.forEach((i) => i()), t.clear();
     const a = (i) => {
-      n = i;
+      r = i;
     };
     g.push({
       setDirty: () => {
-        !r && !o && (o = !0, queueMicrotask(s));
+        !n && !o && (o = !0, queueMicrotask(s));
       },
       addSource: (i) => t.add(i)
     }), e(a), g.pop();
   };
   return s(), {
     destroy() {
-      r = !0, n && (n(), n = null), t.forEach((a) => a()), t.clear();
+      n = !0, r && (r(), r = null), t.forEach((a) => a()), t.clear();
     }
   };
 }, j = (e) => {
   const t = /* @__PURE__ */ new Set();
-  let r, n = !0, o = () => {
+  let n, r = !0, o = () => {
   };
   const s = () => {
     t.forEach((c) => c()), t.clear(), g.push({
       setDirty: () => {
-        if (n) return;
-        n = !0;
-        const c = r;
-        s(), r !== c && o(r);
+        if (r) return;
+        r = !0;
+        const c = n;
+        s(), n !== c && o(n);
       },
       addSource: (c) => t.add(c)
-    }), r = e(), n = !1, g.pop();
+    }), n = e(), r = !1, g.pop();
   }, { read: a, notify: i } = R(
-    () => (n && s(), r),
+    () => (r && s(), n),
     () => {
-      n && s();
+      r && s();
     }
   );
   return o = i, a;
 };
 function Te(e) {
-  const t = typeof e == "function", r = t ? void 0 : e.source, n = t ? e : e.computation, o = /* @__PURE__ */ new Set();
+  const t = typeof e == "function", n = t ? void 0 : e.source, r = t ? e : e.computation, o = /* @__PURE__ */ new Set();
   let s, a = !0, i = !1, c, l = () => {
   };
   const h = () => {
@@ -555,10 +555,10 @@ function Te(e) {
       },
       addSource: (u) => o.add(u)
     }), t)
-      s = n();
+      s = r();
     else {
-      const u = r?.();
-      s = n(u, c), c = { source: u, value: s };
+      const u = n?.();
+      s = r(u, c), c = { source: u, value: s };
     }
     a = !1, g.pop();
   }, { read: v, notify: f } = R(
@@ -581,20 +581,20 @@ function Te(e) {
 }
 class X extends Error {
   constructor(t) {
-    const r = t instanceof Error ? `:
+    const n = t instanceof Error ? `:
 ${t.message}` : "";
-    super(`Cannot read resource value while in error state${r}`, { cause: t }), this.name = "ResourceErrorState";
+    super(`Cannot read resource value while in error state${n}`, { cause: t }), this.name = "ResourceErrorState";
   }
 }
 function $e(e) {
-  const t = S(void 0), r = S("idle"), n = S(void 0), o = j(() => r() === "loading"), s = S(0), a = j(() => {
-    if (r() === "error")
-      throw new X(n());
+  const t = S(void 0), n = S("idle"), r = S(void 0), o = j(() => n() === "loading"), s = S(0), a = j(() => {
+    if (n() === "error")
+      throw new X(r());
     return t();
   }), i = (f) => {
-    t.set(f), n.set(void 0), r.set("resolved");
+    t.set(f), r.set(void 0), n.set("resolved");
   }, c = (f) => {
-    t.update(f), n.set(void 0), r.set("resolved");
+    t.update(f), r.set(void 0), n.set("resolved");
   }, l = "params" in e;
   if ("stream" in e) {
     const f = S(void 0), y = k((p) => {
@@ -602,7 +602,7 @@ function $e(e) {
       const d = new AbortController();
       p(() => d.abort());
       const H = l ? e.params() : void 0;
-      r.set("loading"), n.set(void 0);
+      n.set("loading"), r.set(void 0);
       const P = e.stream, G = P(l ? {
         params: H,
         abortSignal: d.signal
@@ -614,12 +614,12 @@ function $e(e) {
       const p = f();
       if (!p) return;
       const d = p();
-      d && ("error" in d && d.error !== void 0 ? (n.set(d.error), r.set("error")) : "value" in d && (t.set(d.value), r.set("resolved")));
+      d && ("error" in d && d.error !== void 0 ? (r.set(d.error), n.set("error")) : "value" in d && (t.set(d.value), n.set("resolved")));
     });
     return {
       value: a,
-      status: r,
-      error: n,
+      status: n,
+      error: r,
       isLoading: o,
       set: i,
       update: c,
@@ -634,23 +634,23 @@ function $e(e) {
   const v = k((f) => {
     s();
     const y = l ? e.params() : void 0;
-    r.set("loading"), n.set(void 0);
+    n.set("loading"), r.set(void 0);
     const u = new AbortController();
     f(() => u.abort());
     const p = l ? { params: y, abortSignal: u.signal } : { abortSignal: u.signal };
     e.loader(p).then(
       (d) => {
-        u.signal.aborted || (t.set(d), r.set("resolved"));
+        u.signal.aborted || (t.set(d), n.set("resolved"));
       },
       (d) => {
-        u.signal.aborted || (n.set(d), r.set("error"));
+        u.signal.aborted || (r.set(d), n.set("error"));
       }
     );
   });
   return {
     value: a,
-    status: r,
-    error: n,
+    status: n,
+    error: r,
     isLoading: o,
     set: i,
     update: c,
@@ -710,23 +710,23 @@ const $ = /* @__PURE__ */ new Map([
 ]);
 function W(e) {
   const t = [];
-  let r;
-  for (const n of e) {
-    const o = n.containerTagNames.join(","), s = r?.containerTagNames.join(",");
-    o !== s && (r = {
-      containerTagNames: n.containerTagNames,
-      cssClass: n.containerTagNames.map((a) => `${C()}${a}`).join(" "),
+  let n;
+  for (const r of e) {
+    const o = r.containerTagNames.join(","), s = n?.containerTagNames.join(",");
+    o !== s && (n = {
+      containerTagNames: r.containerTagNames,
+      cssClass: r.containerTagNames.map((a) => `${C()}${a}`).join(" "),
       segments: []
-    }, t.push(r)), r.segments.push(n);
+    }, t.push(n)), n.segments.push(r);
   }
   return t;
 }
-const N = (e, t, r, n, o) => {
+const N = (e, t, n, r, o) => {
   const s = e.filter((i) => !T.has(i)), a = e.filter((i) => T.has(i));
   return {
     tagNames: e.join(","),
     tagNamesList: e,
-    text: o ?? t.slice(r, n),
+    text: o ?? t.slice(n, r),
     containerTagNames: a,
     cssClass: s.map((i) => `${C()}${i}`).join(" ")
   };
@@ -735,39 +735,39 @@ const N = (e, t, r, n, o) => {
   "gi"
 );
 function D(e) {
-  const t = [], r = /* @__PURE__ */ new Map();
-  let n = 0;
+  const t = [], n = /* @__PURE__ */ new Map();
+  let r = 0;
   for (const o of e.matchAll(te())) {
     const s = o.index;
-    s > n && t.push(
-      N([...r.keys()], e, n, s)
+    s > r && t.push(
+      N([...n.keys()], e, r, s)
     );
     const a = o[2]?.toLowerCase();
     if (a && $.has(a)) {
       t.push(
         N(
-          [...r.keys(), a],
+          [...n.keys(), a],
           e,
-          n,
+          r,
           s,
           ""
         )
-      ), n = s + o[0].length;
+      ), r = s + o[0].length;
       continue;
     }
     const i = o[0][1] === "/", c = L.get(o[1]?.toLowerCase() ?? "") ?? "";
     if (i) {
-      const l = (r.get(c) ?? 1) - 1;
-      l <= 0 ? r.delete(c) : r.set(c, l);
+      const l = (n.get(c) ?? 1) - 1;
+      l <= 0 ? n.delete(c) : n.set(c, l);
     } else
-      r.set(c, (r.get(c) ?? 0) + 1);
-    n = s + o[0].length;
+      n.set(c, (n.get(c) ?? 0) + 1);
+    r = s + o[0].length;
   }
-  return n < e.length && t.push(
+  return r < e.length && t.push(
     N(
-      [...r.keys()],
+      [...n.keys()],
       e,
-      n,
+      r,
       e.length
     )
   ), t;
@@ -778,38 +778,38 @@ function F(e) {
 function A(e, t) {
   e.className = `${C()}${t}`;
 }
-function re(e, t, r) {
-  const n = t.tagNamesList.filter((i) => !T.has(i)), o = n.filter((i) => $.has(i)), s = n.filter((i) => !$.has(i));
+function ne(e, t, n) {
+  const r = t.tagNamesList.filter((i) => !T.has(i)), o = r.filter((i) => $.has(i)), s = r.filter((i) => !$.has(i));
   let a = e;
   for (const i of s) {
-    const c = r.createElement(i);
+    const c = n.createElement(i);
     A(c, i), a.appendChild(c), a = c;
   }
   if (t.text) {
-    a.appendChild(r.createTextNode(t.text));
+    a.appendChild(n.createTextNode(t.text));
     return;
   }
   for (const i of o) {
-    const c = r.createElement(i);
+    const c = n.createElement(i);
     A(c, i), a.appendChild(c);
   }
 }
-function ne(e, t, r) {
-  const n = [];
+function re(e, t, n) {
+  const r = [];
   for (const o of t) {
     const s = o.containerTagNames;
     let a = 0;
-    for (; a < n.length && a < s.length && n[a]?.tag === s[a]; )
+    for (; a < r.length && a < s.length && r[a]?.tag === s[a]; )
       a++;
-    n.length = a;
-    let i = n[n.length - 1]?.node ?? e;
+    r.length = a;
+    let i = r[r.length - 1]?.node ?? e;
     for (const l of s.slice(a)) {
-      const h = r.createElement(l);
-      A(h, l), i.appendChild(h), n.push({ tag: l, node: h }), i = h;
+      const h = n.createElement(l);
+      A(h, l), i.appendChild(h), r.push({ tag: l, node: h }), i = h;
     }
-    const c = n[n.length - 1]?.node ?? e;
+    const c = r[r.length - 1]?.node ?? e;
     for (const l of o.segments)
-      re(c, l, r);
+      ne(c, l, n);
   }
 }
 function se(e, t) {
@@ -823,8 +823,8 @@ function se(e, t) {
     );
     return;
   }
-  const r = globalThis.document, n = F(D(t));
-  ne(e, n, r);
+  const n = globalThis.document, r = F(D(t));
+  re(e, r, n);
 }
 const O = "html-text-parser-styles", I = {};
 function M(e) {
@@ -975,28 +975,28 @@ function B() {
     );
     return;
   }
-  const e = globalThis, t = e.document.getElementById(O), r = M(C());
+  const e = globalThis, t = e.document.getElementById(O), n = M(C());
   if (t) {
-    t.textContent = r;
+    t.textContent = n;
     return;
   }
-  const n = e.document.createElement("style");
-  n.setAttribute("id", O), n.textContent = r, e.document.head.appendChild(n);
+  const r = e.document.createElement("style");
+  r.setAttribute("id", O), r.textContent = n, e.document.head.appendChild(r);
 }
 function ae(e) {
   Object.assign(
     I,
     Object.fromEntries(
-      Object.entries(e).map(([t, r]) => [
+      Object.entries(e).map(([t, n]) => [
         t,
-        r.replace(/;/g, " !important;")
+        n.replace(/;/g, " !important;")
       ])
     )
   ), "document" in globalThis && B();
 }
 function _(e) {
   if (Array.isArray(e)) {
-    e.forEach((r) => _(r));
+    e.forEach((n) => _(n));
     return;
   }
   const t = e.tagName ?? e.tag;
@@ -1004,7 +1004,7 @@ function _(e) {
 }
 function q(e) {
   if (Array.isArray(e)) {
-    e.forEach((r) => q(r));
+    e.forEach((n) => q(n));
     return;
   }
   const t = e.tagName ?? e.tag;
@@ -1029,21 +1029,21 @@ const Ce = {
   generateStylesheet: B,
   overrideStyles: ae
 };
-function le(e, t, r) {
-  function n(o) {
-    const [s, a] = E(() => r ? r(o) : o);
+function le(e, t, n) {
+  function r(o) {
+    const [s, a] = E(() => n ? n(o) : o);
     if (a) throw new Error(`Error transforming value for ${e}: ${a.message}`);
     if (!t(s)) throw new Error(`"${o}" is not a valid ${e}`);
     return s;
   }
-  return n.from = (o) => {
-    const [s, a] = E(() => r ? r(o) : o);
+  return r.from = (o) => {
+    const [s, a] = E(() => n ? n(o) : o);
     if (!a)
       return t(s) ? s : void 0;
-  }, n.is = (o) => {
-    const s = E(() => r ? r(o) : o)[0] ?? o;
+  }, r.is = (o) => {
+    const s = E(() => n ? n(o) : o)[0] ?? o;
     return t(s);
-  }, n;
+  }, r;
 }
 const ve = le(
   "NumericString",
@@ -1054,6 +1054,20 @@ const ve = le(
   ),
   (e) => String(e)
 );
+function Ee(e) {
+  return Object.keys(e).filter((t) => {
+    const n = e[t];
+    return n === "" || n === null || n === void 0;
+  });
+}
+function ke(e) {
+  if (e.length === 0) return "";
+  if (e.length === 1) {
+    const [t] = e;
+    return t || "";
+  }
+  return e.slice(0, -1).join(", ") + " and " + e[e.length - 1];
+}
 export {
   fe as Http,
   U as HttpCodeNames,
@@ -1067,15 +1081,17 @@ export {
   me as debounce,
   ge as delay,
   k as effect,
-  Z as getProp,
+  Ee as getEmptyKeys,
+  K as getProp,
   he as groupBy,
   Ce as htmlTextParser,
   we as isSignal,
+  ke as joinToSentence,
   Te as linkedSignal,
   V as normalizeString,
   ye as pickPaths,
   $e as resource,
-  K as setDeepValue,
+  Z as setDeepValue,
   S as signal,
   be as toArray,
   E as tryCatch,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dvirus-js/utils",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "type": "module",
   "main": "./index.js",
   "exports": {