@ls-stack/utils 3.25.0 → 3.26.0

package/docs/filterObjectOrArrayKeys.md

@@ -14,7 +14,7 @@
 function filterObjectOrArrayKeys(objOrArray, options): Record<string, any> | Record<string, any>[];
 ```
 
-Defined in: [packages/utils/src/filterObjectOrArrayKeys.ts:38](https://github.com/lucasols/utils/blob/main/packages/utils/src/filterObjectOrArrayKeys.ts#L38)
+Defined in: [packages/utils/src/filterObjectOrArrayKeys.ts:40](https://github.com/lucasols/utils/blob/main/packages/utils/src/filterObjectOrArrayKeys.ts#L40)
 
 Filters the keys of an object based on the provided patterns.
 
@@ -42,6 +42,8 @@ Filtering patterns in `rejectKeys` and `filterKeys`:
   - `'[*]**nested'` - all `nested` props of all items of the array
   - `'[0-2]'` - The first three items of the array
   - `'[4-*]'` - All items of the array from the fourth index to the end
+- Selecting multiple properties:
+  - `'prop.test.(prop1|prop2|prop3)'` - The `prop1`, `prop2`, and `prop3` properties of `prop.test` object
 
 #### Parameters
 

package/lib/{chunk-XXYTMSFH.js → chunk-FXRZ4RQU.js}

@@ -13,75 +13,6 @@ function filterObjectOrArrayKeys(objOrArray, {
   const rejectPatternsRaw = toArray(rejectKeys);
   const hasFilters = filterPatternsRaw.length > 0;
   const hasRejects = rejectPatternsRaw.length > 0;
-  function parsePattern(pattern) {
-    const tokens = [];
-    let i = 0;
-    const n = pattern.length;
-    const pushKey = (name) => {
-      if (name.length === 0) return;
-      tokens.push({ type: "KEY", name });
-    };
-    while (i < n) {
-      const ch = pattern[i];
-      if (ch === ".") {
-        i += 1;
-        continue;
-      }
-      if (ch === "[") {
-        const end = pattern.indexOf("]", i + 1);
-        const inside = end === -1 ? pattern.slice(i + 1) : pattern.slice(i + 1, end);
-        if (inside === "*") {
-          tokens.push({ type: "INDEX_ANY" });
-        } else if (inside.includes("-")) {
-          const parts = inside.split("-");
-          const startStr = parts[0] ?? "";
-          const endStr = parts[1] ?? "";
-          const start = parseInt(startStr, 10);
-          const endNum = endStr === "*" ? null : parseInt(endStr, 10);
-          tokens.push({
-            type: "INDEX_RANGE",
-            start,
-            end: endNum === null || Number.isFinite(endNum) ? endNum : null
-          });
-        } else if (inside.length > 0) {
-          const idx = parseInt(inside, 10);
-          tokens.push({ type: "INDEX", index: idx });
-        }
-        i = end === -1 ? n : end + 1;
-        continue;
-      }
-      if (ch === "*") {
-        if (pattern[i + 1] === "*") {
-          tokens.push({ type: "WILDCARD_ANY" });
-          i += 2;
-          let j2 = i;
-          while (j2 < n) {
-            const c = pattern[j2];
-            if (c === "." || c === "[") break;
-            j2 += 1;
-          }
-          if (j2 > i) {
-            pushKey(pattern.slice(i, j2));
-            i = j2;
-          }
-          continue;
-        } else {
-          tokens.push({ type: "WILDCARD_ONE" });
-          i += 1;
-          continue;
-        }
-      }
-      let j = i;
-      while (j < n) {
-        const c = pattern[j];
-        if (c === "." || c === "[") break;
-        j += 1;
-      }
-      pushKey(pattern.slice(i, j));
-      i = j;
-    }
-    return tokens;
-  }
   const filterPatterns = filterPatternsRaw.map(parsePattern);
   const rejectPatterns = rejectPatternsRaw.map(parsePattern);
   function matchPath(path, pattern) {
@@ -111,6 +42,11 @@ function filterObjectOrArrayKeys(objOrArray, {
             return rec(pi + 1, pti + 1);
           if (ct.type === "INDEX") return rec(pi + 1, pti);
           return false;
+        case "MULTI_KEY":
+          if (ct.type === "KEY" && pt.names.includes(ct.name))
+            return rec(pi + 1, pti + 1);
+          if (ct.type === "INDEX") return rec(pi + 1, pti);
+          return false;
         case "INDEX":
           if (ct.type === "INDEX" && ct.index === pt.index)
             return rec(pi + 1, pti + 1);
@@ -234,6 +170,87 @@ function filterObjectOrArrayKeys(objOrArray, {
   if (built === void 0) return Array.isArray(objOrArray) ? [] : {};
   return built;
 }
+function parsePattern(pattern) {
+  const tokens = [];
+  let i = 0;
+  const n = pattern.length;
+  const pushKey = (name) => {
+    if (name.length === 0) return;
+    tokens.push({ type: "KEY", name });
+  };
+  while (i < n) {
+    const ch = pattern[i];
+    if (ch === ".") {
+      i += 1;
+      continue;
+    }
+    if (ch === "[") {
+      const end = pattern.indexOf("]", i + 1);
+      const inside = end === -1 ? pattern.slice(i + 1) : pattern.slice(i + 1, end);
+      if (inside === "*") {
+        tokens.push({ type: "INDEX_ANY" });
+      } else if (inside.includes("-")) {
+        const parts = inside.split("-");
+        const startStr = parts[0] ?? "";
+        const endStr = parts[1] ?? "";
+        const start = parseInt(startStr, 10);
+        const endNum = endStr === "*" ? null : parseInt(endStr, 10);
+        tokens.push({
+          type: "INDEX_RANGE",
+          start,
+          end: endNum === null || Number.isFinite(endNum) ? endNum : null
+        });
+      } else if (inside.length > 0) {
+        const idx = parseInt(inside, 10);
+        tokens.push({ type: "INDEX", index: idx });
+      }
+      i = end === -1 ? n : end + 1;
+      continue;
+    }
+    if (ch === "(") {
+      const end = pattern.indexOf(")", i + 1);
+      const inside = end === -1 ? pattern.slice(i + 1) : pattern.slice(i + 1, end);
+      if (inside.includes("|") && inside.trim().length > 0) {
+        const names = inside.split("|").filter((name) => name.length > 0);
+        if (names.length > 0) {
+          tokens.push({ type: "MULTI_KEY", names });
+        }
+      }
+      i = end === -1 ? n : end + 1;
+      continue;
+    }
+    if (ch === "*") {
+      if (pattern[i + 1] === "*") {
+        tokens.push({ type: "WILDCARD_ANY" });
+        i += 2;
+        let j2 = i;
+        while (j2 < n) {
+          const c = pattern[j2];
+          if (c === "." || c === "[") break;
+          j2 += 1;
+        }
+        if (j2 > i) {
+          pushKey(pattern.slice(i, j2));
+          i = j2;
+        }
+        continue;
+      } else {
+        tokens.push({ type: "WILDCARD_ONE" });
+        i += 1;
+        continue;
+      }
+    }
+    let j = i;
+    while (j < n) {
+      const c = pattern[j];
+      if (c === "." || c === "[") break;
+      j += 1;
+    }
+    pushKey(pattern.slice(i, j));
+    i = j;
+  }
+  return tokens;
+}
 
 export {
   filterObjectOrArrayKeys

package/lib/filterObjectOrArrayKeys.cjs

@@ -48,75 +48,6 @@ function filterObjectOrArrayKeys(objOrArray, {
   const rejectPatternsRaw = toArray(rejectKeys);
   const hasFilters = filterPatternsRaw.length > 0;
   const hasRejects = rejectPatternsRaw.length > 0;
-  function parsePattern(pattern) {
-    const tokens = [];
-    let i = 0;
-    const n = pattern.length;
-    const pushKey = (name) => {
-      if (name.length === 0) return;
-      tokens.push({ type: "KEY", name });
-    };
-    while (i < n) {
-      const ch = pattern[i];
-      if (ch === ".") {
-        i += 1;
-        continue;
-      }
-      if (ch === "[") {
-        const end = pattern.indexOf("]", i + 1);
-        const inside = end === -1 ? pattern.slice(i + 1) : pattern.slice(i + 1, end);
-        if (inside === "*") {
-          tokens.push({ type: "INDEX_ANY" });
-        } else if (inside.includes("-")) {
-          const parts = inside.split("-");
-          const startStr = parts[0] ?? "";
-          const endStr = parts[1] ?? "";
-          const start = parseInt(startStr, 10);
-          const endNum = endStr === "*" ? null : parseInt(endStr, 10);
-          tokens.push({
-            type: "INDEX_RANGE",
-            start,
-            end: endNum === null || Number.isFinite(endNum) ? endNum : null
-          });
-        } else if (inside.length > 0) {
-          const idx = parseInt(inside, 10);
-          tokens.push({ type: "INDEX", index: idx });
-        }
-        i = end === -1 ? n : end + 1;
-        continue;
-      }
-      if (ch === "*") {
-        if (pattern[i + 1] === "*") {
-          tokens.push({ type: "WILDCARD_ANY" });
-          i += 2;
-          let j2 = i;
-          while (j2 < n) {
-            const c = pattern[j2];
-            if (c === "." || c === "[") break;
-            j2 += 1;
-          }
-          if (j2 > i) {
-            pushKey(pattern.slice(i, j2));
-            i = j2;
-          }
-          continue;
-        } else {
-          tokens.push({ type: "WILDCARD_ONE" });
-          i += 1;
-          continue;
-        }
-      }
-      let j = i;
-      while (j < n) {
-        const c = pattern[j];
-        if (c === "." || c === "[") break;
-        j += 1;
-      }
-      pushKey(pattern.slice(i, j));
-      i = j;
-    }
-    return tokens;
-  }
   const filterPatterns = filterPatternsRaw.map(parsePattern);
   const rejectPatterns = rejectPatternsRaw.map(parsePattern);
   function matchPath(path, pattern) {
@@ -146,6 +77,11 @@ function filterObjectOrArrayKeys(objOrArray, {
             return rec(pi + 1, pti + 1);
           if (ct.type === "INDEX") return rec(pi + 1, pti);
           return false;
+        case "MULTI_KEY":
+          if (ct.type === "KEY" && pt.names.includes(ct.name))
+            return rec(pi + 1, pti + 1);
+          if (ct.type === "INDEX") return rec(pi + 1, pti);
+          return false;
         case "INDEX":
           if (ct.type === "INDEX" && ct.index === pt.index)
             return rec(pi + 1, pti + 1);
@@ -269,6 +205,87 @@ function filterObjectOrArrayKeys(objOrArray, {
   if (built === void 0) return Array.isArray(objOrArray) ? [] : {};
   return built;
 }
+function parsePattern(pattern) {
+  const tokens = [];
+  let i = 0;
+  const n = pattern.length;
+  const pushKey = (name) => {
+    if (name.length === 0) return;
+    tokens.push({ type: "KEY", name });
+  };
+  while (i < n) {
+    const ch = pattern[i];
+    if (ch === ".") {
+      i += 1;
+      continue;
+    }
+    if (ch === "[") {
+      const end = pattern.indexOf("]", i + 1);
+      const inside = end === -1 ? pattern.slice(i + 1) : pattern.slice(i + 1, end);
+      if (inside === "*") {
+        tokens.push({ type: "INDEX_ANY" });
+      } else if (inside.includes("-")) {
+        const parts = inside.split("-");
+        const startStr = parts[0] ?? "";
+        const endStr = parts[1] ?? "";
+        const start = parseInt(startStr, 10);
+        const endNum = endStr === "*" ? null : parseInt(endStr, 10);
+        tokens.push({
+          type: "INDEX_RANGE",
+          start,
+          end: endNum === null || Number.isFinite(endNum) ? endNum : null
+        });
+      } else if (inside.length > 0) {
+        const idx = parseInt(inside, 10);
+        tokens.push({ type: "INDEX", index: idx });
+      }
+      i = end === -1 ? n : end + 1;
+      continue;
+    }
+    if (ch === "(") {
+      const end = pattern.indexOf(")", i + 1);
+      const inside = end === -1 ? pattern.slice(i + 1) : pattern.slice(i + 1, end);
+      if (inside.includes("|") && inside.trim().length > 0) {
+        const names = inside.split("|").filter((name) => name.length > 0);
+        if (names.length > 0) {
+          tokens.push({ type: "MULTI_KEY", names });
+        }
+      }
+      i = end === -1 ? n : end + 1;
+      continue;
+    }
+    if (ch === "*") {
+      if (pattern[i + 1] === "*") {
+        tokens.push({ type: "WILDCARD_ANY" });
+        i += 2;
+        let j2 = i;
+        while (j2 < n) {
+          const c = pattern[j2];
+          if (c === "." || c === "[") break;
+          j2 += 1;
+        }
+        if (j2 > i) {
+          pushKey(pattern.slice(i, j2));
+          i = j2;
+        }
+        continue;
+      } else {
+        tokens.push({ type: "WILDCARD_ONE" });
+        i += 1;
+        continue;
+      }
+    }
+    let j = i;
+    while (j < n) {
+      const c = pattern[j];
+      if (c === "." || c === "[") break;
+      j += 1;
+    }
+    pushKey(pattern.slice(i, j));
+    i = j;
+  }
+  return tokens;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   filterObjectOrArrayKeys

package/lib/filterObjectOrArrayKeys.d.cts

@@ -25,6 +25,8 @@
  *   - `'[*]**nested'` - all `nested` props of all items of the array
  *   - `'[0-2]'` - The first three items of the array
  *   - `'[4-*]'` - All items of the array from the fourth index to the end
+ * - Selecting multiple properties:
+ *   - `'prop.test.(prop1|prop2|prop3)'` - The `prop1`, `prop2`, and `prop3` properties of `prop.test` object
  *
  * @param objOrArray - The object or array to filter.
  * @param options - The options for the filter.

package/lib/filterObjectOrArrayKeys.d.ts

@@ -25,6 +25,8 @@
  *   - `'[*]**nested'` - all `nested` props of all items of the array
  *   - `'[0-2]'` - The first three items of the array
  *   - `'[4-*]'` - All items of the array from the fourth index to the end
+ * - Selecting multiple properties:
+ *   - `'prop.test.(prop1|prop2|prop3)'` - The `prop1`, `prop2`, and `prop3` properties of `prop.test` object
  *
  * @param objOrArray - The object or array to filter.
  * @param options - The options for the filter.

package/lib/filterObjectOrArrayKeys.js

@@ -1,6 +1,6 @@
 import {
   filterObjectOrArrayKeys
-} from "./chunk-XXYTMSFH.js";
+} from "./chunk-FXRZ4RQU.js";
 import "./chunk-JF2MDHOJ.js";
 export {
   filterObjectOrArrayKeys

package/lib/testUtils.cjs

@@ -142,75 +142,6 @@ function filterObjectOrArrayKeys(objOrArray, {
   const rejectPatternsRaw = toArray(rejectKeys);
   const hasFilters = filterPatternsRaw.length > 0;
   const hasRejects = rejectPatternsRaw.length > 0;
-  function parsePattern(pattern) {
-    const tokens = [];
-    let i = 0;
-    const n = pattern.length;
-    const pushKey = (name) => {
-      if (name.length === 0) return;
-      tokens.push({ type: "KEY", name });
-    };
-    while (i < n) {
-      const ch = pattern[i];
-      if (ch === ".") {
-        i += 1;
-        continue;
-      }
-      if (ch === "[") {
-        const end = pattern.indexOf("]", i + 1);
-        const inside = end === -1 ? pattern.slice(i + 1) : pattern.slice(i + 1, end);
-        if (inside === "*") {
-          tokens.push({ type: "INDEX_ANY" });
-        } else if (inside.includes("-")) {
-          const parts = inside.split("-");
-          const startStr = parts[0] ?? "";
-          const endStr = parts[1] ?? "";
-          const start = parseInt(startStr, 10);
-          const endNum = endStr === "*" ? null : parseInt(endStr, 10);
-          tokens.push({
-            type: "INDEX_RANGE",
-            start,
-            end: endNum === null || Number.isFinite(endNum) ? endNum : null
-          });
-        } else if (inside.length > 0) {
-          const idx = parseInt(inside, 10);
-          tokens.push({ type: "INDEX", index: idx });
-        }
-        i = end === -1 ? n : end + 1;
-        continue;
-      }
-      if (ch === "*") {
-        if (pattern[i + 1] === "*") {
-          tokens.push({ type: "WILDCARD_ANY" });
-          i += 2;
-          let j2 = i;
-          while (j2 < n) {
-            const c = pattern[j2];
-            if (c === "." || c === "[") break;
-            j2 += 1;
-          }
-          if (j2 > i) {
-            pushKey(pattern.slice(i, j2));
-            i = j2;
-          }
-          continue;
-        } else {
-          tokens.push({ type: "WILDCARD_ONE" });
-          i += 1;
-          continue;
-        }
-      }
-      let j = i;
-      while (j < n) {
-        const c = pattern[j];
-        if (c === "." || c === "[") break;
-        j += 1;
-      }
-      pushKey(pattern.slice(i, j));
-      i = j;
-    }
-    return tokens;
-  }
   const filterPatterns = filterPatternsRaw.map(parsePattern);
   const rejectPatterns = rejectPatternsRaw.map(parsePattern);
   function matchPath(path, pattern) {
@@ -240,6 +171,11 @@ function filterObjectOrArrayKeys(objOrArray, {
             return rec(pi + 1, pti + 1);
           if (ct.type === "INDEX") return rec(pi + 1, pti);
           return false;
+        case "MULTI_KEY":
+          if (ct.type === "KEY" && pt.names.includes(ct.name))
+            return rec(pi + 1, pti + 1);
+          if (ct.type === "INDEX") return rec(pi + 1, pti);
+          return false;
         case "INDEX":
           if (ct.type === "INDEX" && ct.index === pt.index)
             return rec(pi + 1, pti + 1);
@@ -363,6 +299,87 @@ function filterObjectOrArrayKeys(objOrArray, {
   if (built === void 0) return Array.isArray(objOrArray) ? [] : {};
   return built;
 }
+function parsePattern(pattern) {
+  const tokens = [];
+  let i = 0;
+  const n = pattern.length;
+  const pushKey = (name) => {
+    if (name.length === 0) return;
+    tokens.push({ type: "KEY", name });
+  };
+  while (i < n) {
+    const ch = pattern[i];
+    if (ch === ".") {
+      i += 1;
+      continue;
+    }
+    if (ch === "[") {
+      const end = pattern.indexOf("]", i + 1);
+      const inside = end === -1 ? pattern.slice(i + 1) : pattern.slice(i + 1, end);
+      if (inside === "*") {
+        tokens.push({ type: "INDEX_ANY" });
+      } else if (inside.includes("-")) {
+        const parts = inside.split("-");
+        const startStr = parts[0] ?? "";
+        const endStr = parts[1] ?? "";
+        const start = parseInt(startStr, 10);
+        const endNum = endStr === "*" ? null : parseInt(endStr, 10);
+        tokens.push({
+          type: "INDEX_RANGE",
+          start,
+          end: endNum === null || Number.isFinite(endNum) ? endNum : null
+        });
+      } else if (inside.length > 0) {
+        const idx = parseInt(inside, 10);
+        tokens.push({ type: "INDEX", index: idx });
+      }
+      i = end === -1 ? n : end + 1;
+      continue;
+    }
+    if (ch === "(") {
+      const end = pattern.indexOf(")", i + 1);
+      const inside = end === -1 ? pattern.slice(i + 1) : pattern.slice(i + 1, end);
+      if (inside.includes("|") && inside.trim().length > 0) {
+        const names = inside.split("|").filter((name) => name.length > 0);
+        if (names.length > 0) {
+          tokens.push({ type: "MULTI_KEY", names });
+        }
+      }
+      i = end === -1 ? n : end + 1;
+      continue;
+    }
+    if (ch === "*") {
+      if (pattern[i + 1] === "*") {
+        tokens.push({ type: "WILDCARD_ANY" });
+        i += 2;
+        let j2 = i;
+        while (j2 < n) {
+          const c = pattern[j2];
+          if (c === "." || c === "[") break;
+          j2 += 1;
+        }
+        if (j2 > i) {
+          pushKey(pattern.slice(i, j2));
+          i = j2;
+        }
+        continue;
+      } else {
+        tokens.push({ type: "WILDCARD_ONE" });
+        i += 1;
+        continue;
+      }
+    }
+    let j = i;
+    while (j < n) {
+      const c = pattern[j];
+      if (c === "." || c === "[") break;
+      j += 1;
+    }
+    pushKey(pattern.slice(i, j));
+    i = j;
+  }
+  return tokens;
+}
 
 // src/mathUtils.ts
 function clampMin(value, min) {

package/lib/testUtils.js

@@ -11,7 +11,7 @@ import {
 } from "./chunk-JQFUKJU5.js";
 import {
   filterObjectOrArrayKeys
-} from "./chunk-XXYTMSFH.js";
+} from "./chunk-FXRZ4RQU.js";
 import {
   defer
 } from "./chunk-DFXNVEH6.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ls-stack/utils",
   "description": "Universal TypeScript utilities for browser and Node.js",
-  "version": "3.25.0",
+  "version": "3.26.0",
   "license": "MIT",
   "files": [
     "lib",