@ls-stack/utils 3.25.0 → 3.26.1

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:42](https://github.com/lucasols/utils/blob/main/packages/utils/src/filterObjectOrArrayKeys.ts#L42)
 
 Filters the keys of an object based on the provided patterns.
 
@@ -42,6 +42,10 @@ 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
+- Pattern expansion with parentheses:
+  - `'prop.test.(prop1|prop2|prop3)'` - Expands to `prop.test.prop1`, `prop.test.prop2`, and `prop.test.prop3`
+  - `'components[*].(table_id|columns|filters[*].value)'` - Expands to `components[*].table_id`, `components[*].columns`, and `components[*].filters[*].value`
+  - `'(users|admins)[*].name'` - Expands to `users[*].name` and `admins[*].name`
 
 #### Parameters
 

package/docs/testUtils.md

@@ -14,7 +14,7 @@
 function compactSnapshot(value, options): string;
 ```
 
-Defined in: [packages/utils/src/testUtils.ts:352](https://github.com/lucasols/utils/blob/main/packages/utils/src/testUtils.ts#L352)
+Defined in: [packages/utils/src/testUtils.ts:354](https://github.com/lucasols/utils/blob/main/packages/utils/src/testUtils.ts#L354)
 
 Produces a more compact and readable snapshot of a value using yaml.
 By default booleans are shown as `✅` and `❌`, use `showBooleansAs` to disable/configure this.
@@ -43,6 +43,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
+- Expanding the patterns with parentheses:
+  - `'prop.test.(prop1|prop2|prop3.prop4)'` - Will produce `prop.test.prop1`, `prop.test.prop2`, and `prop.test.prop3.prop4`
 
 #### Parameters
 

package/lib/{chunk-XXYTMSFH.js → chunk-2WZGT4NA.js}

@@ -13,77 +13,10 @@ 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);
+  const expandedFilterPatterns = filterPatternsRaw.flatMap(expandPatterns);
+  const expandedRejectPatterns = rejectPatternsRaw.flatMap(expandPatterns);
+  const filterPatterns = expandedFilterPatterns.map(parsePattern);
+  const rejectPatterns = expandedRejectPatterns.map(parsePattern);
   function matchPath(path, pattern) {
     function rec(pi, pti) {
       if (pti >= pattern.length) return pi === path.length;
@@ -234,6 +167,101 @@ function filterObjectOrArrayKeys(objOrArray, {
   if (built === void 0) return Array.isArray(objOrArray) ? [] : {};
   return built;
 }
+function expandPatterns(pattern) {
+  function expandSingle(str) {
+    const start = str.indexOf("(");
+    if (start === -1) {
+      return [str];
+    }
+    const end = str.indexOf(")", start);
+    if (end === -1) {
+      return [str];
+    }
+    const before = str.slice(0, start);
+    const inside = str.slice(start + 1, end);
+    const after = str.slice(end + 1);
+    if (!inside.includes("|")) {
+      return expandSingle(before + inside + after);
+    }
+    const options = inside.split("|").filter((option) => option.trim().length > 0);
+    const results = [];
+    for (const option of options) {
+      const newStr = before + option + after;
+      results.push(...expandSingle(newStr));
+    }
+    return results;
+  }
+  return expandSingle(pattern);
+}
+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;
+}
 
 export {
   filterObjectOrArrayKeys

package/lib/filterObjectOrArrayKeys.cjs

@@ -48,77 +48,10 @@ 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);
+  const expandedFilterPatterns = filterPatternsRaw.flatMap(expandPatterns);
+  const expandedRejectPatterns = rejectPatternsRaw.flatMap(expandPatterns);
+  const filterPatterns = expandedFilterPatterns.map(parsePattern);
+  const rejectPatterns = expandedRejectPatterns.map(parsePattern);
   function matchPath(path, pattern) {
     function rec(pi, pti) {
       if (pti >= pattern.length) return pi === path.length;
@@ -269,6 +202,101 @@ function filterObjectOrArrayKeys(objOrArray, {
   if (built === void 0) return Array.isArray(objOrArray) ? [] : {};
   return built;
 }
+function expandPatterns(pattern) {
+  function expandSingle(str) {
+    const start = str.indexOf("(");
+    if (start === -1) {
+      return [str];
+    }
+    const end = str.indexOf(")", start);
+    if (end === -1) {
+      return [str];
+    }
+    const before = str.slice(0, start);
+    const inside = str.slice(start + 1, end);
+    const after = str.slice(end + 1);
+    if (!inside.includes("|")) {
+      return expandSingle(before + inside + after);
+    }
+    const options = inside.split("|").filter((option) => option.trim().length > 0);
+    const results = [];
+    for (const option of options) {
+      const newStr = before + option + after;
+      results.push(...expandSingle(newStr));
+    }
+    return results;
+  }
+  return expandSingle(pattern);
+}
+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;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   filterObjectOrArrayKeys

package/lib/filterObjectOrArrayKeys.d.cts

@@ -25,6 +25,10 @@
  *   - `'[*]**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
+ * - Pattern expansion with parentheses:
+ *   - `'prop.test.(prop1|prop2|prop3)'` - Expands to `prop.test.prop1`, `prop.test.prop2`, and `prop.test.prop3`
+ *   - `'components[*].(table_id|columns|filters[*].value)'` - Expands to `components[*].table_id`, `components[*].columns`, and `components[*].filters[*].value`
+ *   - `'(users|admins)[*].name'` - Expands to `users[*].name` and `admins[*].name`
  *
  * @param objOrArray - The object or array to filter.
  * @param options - The options for the filter.

package/lib/filterObjectOrArrayKeys.d.ts

@@ -25,6 +25,10 @@
  *   - `'[*]**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
+ * - Pattern expansion with parentheses:
+ *   - `'prop.test.(prop1|prop2|prop3)'` - Expands to `prop.test.prop1`, `prop.test.prop2`, and `prop.test.prop3`
+ *   - `'components[*].(table_id|columns|filters[*].value)'` - Expands to `components[*].table_id`, `components[*].columns`, and `components[*].filters[*].value`
+ *   - `'(users|admins)[*].name'` - Expands to `users[*].name` and `admins[*].name`
  *
  * @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-2WZGT4NA.js";
 import "./chunk-JF2MDHOJ.js";
 export {
   filterObjectOrArrayKeys

package/lib/testUtils.cjs

@@ -142,77 +142,10 @@ 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);
+  const expandedFilterPatterns = filterPatternsRaw.flatMap(expandPatterns);
+  const expandedRejectPatterns = rejectPatternsRaw.flatMap(expandPatterns);
+  const filterPatterns = expandedFilterPatterns.map(parsePattern);
+  const rejectPatterns = expandedRejectPatterns.map(parsePattern);
   function matchPath(path, pattern) {
     function rec(pi, pti) {
       if (pti >= pattern.length) return pi === path.length;
@@ -363,6 +296,101 @@ function filterObjectOrArrayKeys(objOrArray, {
   if (built === void 0) return Array.isArray(objOrArray) ? [] : {};
   return built;
 }
+function expandPatterns(pattern) {
+  function expandSingle(str) {
+    const start = str.indexOf("(");
+    if (start === -1) {
+      return [str];
+    }
+    const end = str.indexOf(")", start);
+    if (end === -1) {
+      return [str];
+    }
+    const before = str.slice(0, start);
+    const inside = str.slice(start + 1, end);
+    const after = str.slice(end + 1);
+    if (!inside.includes("|")) {
+      return expandSingle(before + inside + after);
+    }
+    const options = inside.split("|").filter((option) => option.trim().length > 0);
+    const results = [];
+    for (const option of options) {
+      const newStr = before + option + after;
+      results.push(...expandSingle(newStr));
+    }
+    return results;
+  }
+  return expandSingle(pattern);
+}
+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;
+}
 
 // src/mathUtils.ts
 function clampMin(value, min) {

package/lib/testUtils.d.cts

@@ -69,6 +69,8 @@ declare function waitController(): {
  *   - `'[*]**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
+ * - Expanding the patterns with parentheses:
+ *   - `'prop.test.(prop1|prop2|prop3.prop4)'` - Will produce `prop.test.prop1`, `prop.test.prop2`, and `prop.test.prop3.prop4`
  *
  * @param value - The value to snapshot.
  * @param options - The options for the snapshot.

package/lib/testUtils.d.ts

@@ -69,6 +69,8 @@ declare function waitController(): {
  *   - `'[*]**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
+ * - Expanding the patterns with parentheses:
+ *   - `'prop.test.(prop1|prop2|prop3.prop4)'` - Will produce `prop.test.prop1`, `prop.test.prop2`, and `prop.test.prop3.prop4`
  *
  * @param value - The value to snapshot.
  * @param options - The options for the snapshot.

package/lib/testUtils.js

@@ -11,7 +11,7 @@ import {
 } from "./chunk-JQFUKJU5.js";
 import {
   filterObjectOrArrayKeys
-} from "./chunk-XXYTMSFH.js";
+} from "./chunk-2WZGT4NA.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.1",
   "license": "MIT",
   "files": [
     "lib",