@ls-stack/utils 3.60.0 → 3.62.0

package/dist/mutationUtils.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/mutationUtils.ts
 var mutationUtils_exports = {};
 __export(mutationUtils_exports, {
+  getArrayMethodsFromProduce: () => getArrayMethodsFromProduce,
   updateObject: () => updateObject
 });
 module.exports = __toCommonJS(mutationUtils_exports);
@@ -97,6 +98,11 @@ function keepPrevIfUnchanged({
   return equalityFn(prev, newValue) ? prev : newValue;
 }
 
+// src/typeGuards.ts
+function isFunction(value) {
+  return typeof value === "function";
+}
+
 // src/mutationUtils.ts
 function updateObject(object, updates) {
   if (!object || typeof object !== "object") {
@@ -112,7 +118,36 @@ function updateObject(object, updates) {
     }
   }
 }
+function getArrayMethodsFromProduce(produceFn, getItemId) {
+  return {
+    add: (item) => produceFn((draft) => {
+      draft.push(item);
+    }),
+    remove: (id) => produceFn((draft) => {
+      const index = draft.findIndex((item) => getItemId(item) === id);
+      if (index !== -1) {
+        draft.splice(index, 1);
+      }
+    }),
+    update: (id, updateItem) => produceFn((draft) => {
+      const index = draft.findIndex((item2) => getItemId(item2) === id);
+      const item = draft[index];
+      if (!item) {
+        throw new Error(`Item with id ${id} not found`);
+      }
+      if (isFunction(updateItem)) {
+        const updatedItem = updateItem(item);
+        if (updatedItem) {
+          draft[index] = updatedItem;
+        }
+      } else {
+        updateObject(item, updateItem);
+      }
+    })
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  getArrayMethodsFromProduce,
   updateObject
 });

package/dist/mutationUtils.d.cts

@@ -6,5 +6,10 @@
  * @param updates - The new values to update the object with.
  */
 declare function updateObject<T extends Record<string, unknown>>(object: T | undefined | null, updates: Partial<T>): void;
+declare function getArrayMethodsFromProduce<T extends Record<string, unknown>>(produceFn: (cb: (newVal: T[]) => void | T[]) => T[] | void, getItemId: (item: T) => string): {
+    add: (item: T) => void | T[];
+    remove: (id: string) => void | T[];
+    update: (id: string, updateItem: ((draftItem: T) => T | void) | Partial<T>) => void | T[];
+};
 
-export { updateObject };
+export { getArrayMethodsFromProduce, updateObject };

package/dist/mutationUtils.d.ts

@@ -6,5 +6,10 @@
  * @param updates - The new values to update the object with.
  */
 declare function updateObject<T extends Record<string, unknown>>(object: T | undefined | null, updates: Partial<T>): void;
+declare function getArrayMethodsFromProduce<T extends Record<string, unknown>>(produceFn: (cb: (newVal: T[]) => void | T[]) => T[] | void, getItemId: (item: T) => string): {
+    add: (item: T) => void | T[];
+    remove: (id: string) => void | T[];
+    update: (id: string, updateItem: ((draftItem: T) => T | void) | Partial<T>) => void | T[];
+};
 
-export { updateObject };
+export { getArrayMethodsFromProduce, updateObject };

package/dist/mutationUtils.js

@@ -2,6 +2,9 @@ import {
   keepPrevIfUnchanged
 } from "./chunk-QQS7I7ZL.js";
 import "./chunk-JQFUKJU5.js";
+import {
+  isFunction
+} from "./chunk-JF2MDHOJ.js";
 
 // src/mutationUtils.ts
 function updateObject(object, updates) {
@@ -18,6 +21,35 @@ function updateObject(object, updates) {
     }
   }
 }
+function getArrayMethodsFromProduce(produceFn, getItemId) {
+  return {
+    add: (item) => produceFn((draft) => {
+      draft.push(item);
+    }),
+    remove: (id) => produceFn((draft) => {
+      const index = draft.findIndex((item) => getItemId(item) === id);
+      if (index !== -1) {
+        draft.splice(index, 1);
+      }
+    }),
+    update: (id, updateItem) => produceFn((draft) => {
+      const index = draft.findIndex((item2) => getItemId(item2) === id);
+      const item = draft[index];
+      if (!item) {
+        throw new Error(`Item with id ${id} not found`);
+      }
+      if (isFunction(updateItem)) {
+        const updatedItem = updateItem(item);
+        if (updatedItem) {
+          draft[index] = updatedItem;
+        }
+      } else {
+        updateObject(item, updateItem);
+      }
+    })
+  };
+}
 export {
+  getArrayMethodsFromProduce,
   updateObject
 };

package/dist/regexUtils.cjs

@@ -0,0 +1,60 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/regexUtils.ts
+var regexUtils_exports = {};
+__export(regexUtils_exports, {
+  escapeRegExp: () => escapeRegExp,
+  getRegexMatchAll: () => getRegexMatchAll,
+  getRegexMatches: () => getRegexMatches
+});
+module.exports = __toCommonJS(regexUtils_exports);
+function getRegexMatches(string, regex) {
+  const [fullMatch, ...groups] = regex.exec(string) || [void 0];
+  return { groups, fullMatch };
+}
+function* getRegexMatchAll(str, regexp) {
+  const flags = regexp.global ? regexp.flags : `${regexp.flags}g`;
+  const re = new RegExp(regexp, flags);
+  let match;
+  let lastIndex = 0;
+  while (match = re.exec(str)) {
+    const [fullMatch, ...groups] = match;
+    const prevLastIndex = lastIndex;
+    lastIndex = re.lastIndex;
+    yield {
+      groups,
+      fullMatch,
+      namedGroups: match.groups,
+      start: match.index,
+      end: lastIndex,
+      prevEnd: prevLastIndex
+    };
+  }
+}
+var SPECIAL_REGEX_CHARS = /[.*+?^${}()|[\]\\]/g;
+function escapeRegExp(value) {
+  return value.replace(SPECIAL_REGEX_CHARS, "\\$&");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  escapeRegExp,
+  getRegexMatchAll,
+  getRegexMatches
+});

package/dist/regexUtils.d.cts

@@ -0,0 +1,17 @@
+declare function getRegexMatches(string: string, regex: RegExp): {
+    groups: (string | undefined)[];
+    fullMatch: string | undefined;
+};
+declare function getRegexMatchAll(str: string, regexp: RegExp): Generator<{
+    groups: (string | undefined)[];
+    fullMatch: string;
+    namedGroups: {
+        [key: string]: string;
+    } | undefined;
+    start: number;
+    end: number;
+    prevEnd: number;
+}, void, unknown>;
+declare function escapeRegExp(value: string): string;
+
+export { escapeRegExp, getRegexMatchAll, getRegexMatches };

package/dist/regexUtils.d.ts

@@ -0,0 +1,17 @@
+declare function getRegexMatches(string: string, regex: RegExp): {
+    groups: (string | undefined)[];
+    fullMatch: string | undefined;
+};
+declare function getRegexMatchAll(str: string, regexp: RegExp): Generator<{
+    groups: (string | undefined)[];
+    fullMatch: string;
+    namedGroups: {
+        [key: string]: string;
+    } | undefined;
+    start: number;
+    end: number;
+    prevEnd: number;
+}, void, unknown>;
+declare function escapeRegExp(value: string): string;
+
+export { escapeRegExp, getRegexMatchAll, getRegexMatches };

package/dist/regexUtils.js

@@ -0,0 +1,33 @@
+// src/regexUtils.ts
+function getRegexMatches(string, regex) {
+  const [fullMatch, ...groups] = regex.exec(string) || [void 0];
+  return { groups, fullMatch };
+}
+function* getRegexMatchAll(str, regexp) {
+  const flags = regexp.global ? regexp.flags : `${regexp.flags}g`;
+  const re = new RegExp(regexp, flags);
+  let match;
+  let lastIndex = 0;
+  while (match = re.exec(str)) {
+    const [fullMatch, ...groups] = match;
+    const prevLastIndex = lastIndex;
+    lastIndex = re.lastIndex;
+    yield {
+      groups,
+      fullMatch,
+      namedGroups: match.groups,
+      start: match.index,
+      end: lastIndex,
+      prevEnd: prevLastIndex
+    };
+  }
+}
+var SPECIAL_REGEX_CHARS = /[.*+?^${}()|[\]\\]/g;
+function escapeRegExp(value) {
+  return value.replace(SPECIAL_REGEX_CHARS, "\\$&");
+}
+export {
+  escapeRegExp,
+  getRegexMatchAll,
+  getRegexMatches
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ls-stack/utils",
   "description": "Universal TypeScript utilities for browser and Node.js",
-  "version": "3.60.0",
+  "version": "3.62.0",
   "license": "MIT",
   "files": [
     "dist",
@@ -152,6 +152,10 @@
       "import": "./dist/promiseUtils.js",
       "require": "./dist/promiseUtils.cjs"
     },
+    "./regexUtils": {
+      "import": "./dist/regexUtils.js",
+      "require": "./dist/regexUtils.cjs"
+    },
     "./retryOnError": {
       "import": "./dist/retryOnError.js",
       "require": "./dist/retryOnError.cjs"