@ls-stack/utils 3.58.0 → 3.59.0

package/dist/arrayUtils.cjs

@@ -31,6 +31,7 @@ __export(arrayUtils_exports, {
   hasDuplicates: () => hasDuplicates,
   intersperse: () => intersperse,
   isInArray: () => isInArray,
+  looseIsInArray: () => looseIsInArray,
   rejectArrayUndefinedValues: () => rejectArrayUndefinedValues,
   rejectDuplicates: () => rejectDuplicates,
   repeat: () => repeat,
@@ -105,6 +106,9 @@ function isInArray(value, oneOf) {
   }
   return false;
 }
+function looseIsInArray(value, array) {
+  return array.includes(value);
+}
 function findAfterIndex(array, index, predicate) {
   for (let i = index + 1; i < array.length; i++) {
     if (predicate(array[i])) {
@@ -211,6 +215,7 @@ function repeat(value, count, separator) {
   hasDuplicates,
   intersperse,
   isInArray,
+  looseIsInArray,
   rejectArrayUndefinedValues,
   rejectDuplicates,
   repeat,

package/dist/arrayUtils.d.cts

@@ -76,6 +76,7 @@ declare function arrayWithPrevAndIndex<T>(array: T[]): {
     index: number;
 }[];
 declare function isInArray<T, const U extends T>(value: T, oneOf: readonly U[]): value is U;
+declare function looseIsInArray(value: unknown, array: readonly unknown[]): boolean;
 declare function findAfterIndex<T>(array: T[], index: number, predicate: (item: T) => boolean): T | undefined;
 declare function findBeforeIndex<T>(array: T[], index: number, predicate: (item: T) => boolean): T | undefined;
 declare function rejectArrayUndefinedValues<T extends unknown[]>(array: T): T;
@@ -152,8 +153,8 @@ declare function arrayOps<T>(array: T[]): ArrayOps<T>;
  */
 declare function intersperse<T, I>(array: T[], separator: I): (T | I)[];
 /**
- * Creates an array by repeating a value a specified number of times,
- * optionally with a separator between each repetition.
+ * Creates an array by repeating a value a specified number of times, optionally
+ * with a separator between each repetition.
  *
  * @example
  *   repeat('x', 3); // ['x', 'x', 'x']
@@ -166,4 +167,4 @@ declare function intersperse<T, I>(array: T[], separator: I): (T | I)[];
  */
 declare function repeat<T>(value: T, count: number, separator?: T): T[];
 
-export { type FilterAndMapReturn, type SortByProps, type SortByValueFn, arrayOps, arrayWithPrev, arrayWithPrevAndIndex, filterAndMap, findAfterIndex, findAndMap, findBeforeIndex, getAscIndexOrder, hasDuplicates, intersperse, isInArray, rejectArrayUndefinedValues, rejectDuplicates, repeat, sortBy, truncateArray };
+export { type FilterAndMapReturn, type SortByProps, type SortByValueFn, arrayOps, arrayWithPrev, arrayWithPrevAndIndex, filterAndMap, findAfterIndex, findAndMap, findBeforeIndex, getAscIndexOrder, hasDuplicates, intersperse, isInArray, looseIsInArray, rejectArrayUndefinedValues, rejectDuplicates, repeat, sortBy, truncateArray };

package/dist/arrayUtils.d.ts

@@ -76,6 +76,7 @@ declare function arrayWithPrevAndIndex<T>(array: T[]): {
     index: number;
 }[];
 declare function isInArray<T, const U extends T>(value: T, oneOf: readonly U[]): value is U;
+declare function looseIsInArray(value: unknown, array: readonly unknown[]): boolean;
 declare function findAfterIndex<T>(array: T[], index: number, predicate: (item: T) => boolean): T | undefined;
 declare function findBeforeIndex<T>(array: T[], index: number, predicate: (item: T) => boolean): T | undefined;
 declare function rejectArrayUndefinedValues<T extends unknown[]>(array: T): T;
@@ -152,8 +153,8 @@ declare function arrayOps<T>(array: T[]): ArrayOps<T>;
  */
 declare function intersperse<T, I>(array: T[], separator: I): (T | I)[];
 /**
- * Creates an array by repeating a value a specified number of times,
- * optionally with a separator between each repetition.
+ * Creates an array by repeating a value a specified number of times, optionally
+ * with a separator between each repetition.
  *
  * @example
  *   repeat('x', 3); // ['x', 'x', 'x']
@@ -166,4 +167,4 @@ declare function intersperse<T, I>(array: T[], separator: I): (T | I)[];
  */
 declare function repeat<T>(value: T, count: number, separator?: T): T[];
 
-export { type FilterAndMapReturn, type SortByProps, type SortByValueFn, arrayOps, arrayWithPrev, arrayWithPrevAndIndex, filterAndMap, findAfterIndex, findAndMap, findBeforeIndex, getAscIndexOrder, hasDuplicates, intersperse, isInArray, rejectArrayUndefinedValues, rejectDuplicates, repeat, sortBy, truncateArray };
+export { type FilterAndMapReturn, type SortByProps, type SortByValueFn, arrayOps, arrayWithPrev, arrayWithPrevAndIndex, filterAndMap, findAfterIndex, findAndMap, findBeforeIndex, getAscIndexOrder, hasDuplicates, intersperse, isInArray, looseIsInArray, rejectArrayUndefinedValues, rejectDuplicates, repeat, sortBy, truncateArray };

package/dist/arrayUtils.js

@@ -10,12 +10,13 @@ import {
   hasDuplicates,
   intersperse,
   isInArray,
+  looseIsInArray,
   rejectArrayUndefinedValues,
   rejectDuplicates,
   repeat,
   sortBy,
   truncateArray
-} from "./chunk-BT3UMATU.js";
+} from "./chunk-GVIDV772.js";
 import "./chunk-C2SVCIWE.js";
 import "./chunk-JF2MDHOJ.js";
 export {
@@ -30,6 +31,7 @@ export {
   hasDuplicates,
   intersperse,
   isInArray,
+  looseIsInArray,
   rejectArrayUndefinedValues,
   rejectDuplicates,
   repeat,

package/dist/{chunk-LBBC55GE.js → chunk-2LO5FYP5.js}

@@ -1,6 +1,6 @@
 import {
   sortBy
-} from "./chunk-BT3UMATU.js";
+} from "./chunk-GVIDV772.js";
 import {
   isPlainObject
 } from "./chunk-JF2MDHOJ.js";

package/dist/{chunk-BT3UMATU.js → chunk-GVIDV772.js}

@@ -60,6 +60,9 @@ function isInArray(value, oneOf) {
   }
   return false;
 }
+function looseIsInArray(value, array) {
+  return array.includes(value);
+}
 function findAfterIndex(array, index, predicate) {
   for (let i = index + 1; i < array.length; i++) {
     if (predicate(array[i])) {
@@ -161,6 +164,7 @@ export {
   arrayWithPrev,
   arrayWithPrevAndIndex,
   isInArray,
+  looseIsInArray,
   findAfterIndex,
   findBeforeIndex,
   rejectArrayUndefinedValues,

package/dist/{chunk-WNFRB7P6.js → chunk-SGRS4OEE.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-GMJTLFM6.js";
 import {
   sortBy
-} from "./chunk-BT3UMATU.js";
+} from "./chunk-GVIDV772.js";
 
 // src/objUtils.ts
 import { Result } from "t-result";
@@ -17,14 +17,16 @@ function pick(obj, keys) {
   }
   return result;
 }
-function mapArrayToObject(array, mapper) {
+function mapArrToObj(array, mapper) {
   return Object.fromEntries(array.map(mapper));
 }
-function mapObjectToObject(obj, mapper) {
+var mapArrayToObject = mapArrToObj;
+function mapObjToObj(obj, mapper) {
   return Object.fromEntries(
     objectTypedEntries(obj).map(([key, value]) => mapper(key, value))
   );
 }
+var mapObjectToObject = mapObjToObj;
 function omit(obj, keys) {
   const result = {};
   for (const key of Object.keys(obj)) {
@@ -136,16 +138,41 @@ function parsePath(path) {
 function isNumericString(str) {
   return /^\d+$/.test(str);
 }
+function getObjPropertyOrInsert(obj, prop, insertValue) {
+  if (obj[prop] === void 0) {
+    obj[prop] = insertValue();
+  }
+  return obj[prop];
+}
+function addPrefixToObjKeys(obj, prefix) {
+  const newObj = {};
+  for (const [key, value] of Object.entries(obj)) {
+    newObj[`${prefix}${key}`] = value;
+  }
+  return newObj;
+}
+function addSuffixToObjKeys(obj, suffix) {
+  const newObj = {};
+  for (const [key, value] of Object.entries(obj)) {
+    newObj[`${key}${suffix}`] = value;
+  }
+  return newObj;
+}
 
 export {
   objectTypedEntries,
   pick,
+  mapArrToObj,
   mapArrayToObject,
+  mapObjToObj,
   mapObjectToObject,
   omit,
   looseGetObjectProperty,
   rejectObjUndefinedValues,
   filterObjectKeys,
   sortObjectKeys,
-  getValueFromPath
+  getValueFromPath,
+  getObjPropertyOrInsert,
+  addPrefixToObjKeys,
+  addSuffixToObjKeys
 };

package/dist/concurrentCalls.js

@@ -9,7 +9,7 @@ import {
 } from "./chunk-5DZT3Z5Z.js";
 import {
   truncateArray
-} from "./chunk-BT3UMATU.js";
+} from "./chunk-GVIDV772.js";
 import {
   invariant
 } from "./chunk-C2SVCIWE.js";

package/dist/filterObjectOrArrayKeys.js

@@ -1,7 +1,7 @@
 import {
   filterObjectOrArrayKeys
-} from "./chunk-LBBC55GE.js";
-import "./chunk-BT3UMATU.js";
+} from "./chunk-2LO5FYP5.js";
+import "./chunk-GVIDV772.js";
 import "./chunk-C2SVCIWE.js";
 import "./chunk-JF2MDHOJ.js";
 export {

package/dist/objUtils.cjs

@@ -20,10 +20,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/objUtils.ts
 var objUtils_exports = {};
 __export(objUtils_exports, {
+  addPrefixToObjKeys: () => addPrefixToObjKeys,
+  addSuffixToObjKeys: () => addSuffixToObjKeys,
   filterObjectKeys: () => filterObjectKeys,
+  getObjPropertyOrInsert: () => getObjPropertyOrInsert,
   getValueFromPath: () => getValueFromPath,
   looseGetObjectProperty: () => looseGetObjectProperty,
+  mapArrToObj: () => mapArrToObj,
   mapArrayToObject: () => mapArrayToObject,
+  mapObjToObj: () => mapObjToObj,
   mapObjectToObject: () => mapObjectToObject,
   objectTypedEntries: () => objectTypedEntries,
   omit: () => omit,
@@ -76,14 +81,16 @@ function pick(obj, keys) {
   }
   return result;
 }
-function mapArrayToObject(array, mapper) {
+function mapArrToObj(array, mapper) {
   return Object.fromEntries(array.map(mapper));
 }
-function mapObjectToObject(obj, mapper) {
+var mapArrayToObject = mapArrToObj;
+function mapObjToObj(obj, mapper) {
   return Object.fromEntries(
     objectTypedEntries(obj).map(([key, value]) => mapper(key, value))
   );
 }
+var mapObjectToObject = mapObjToObj;
 function omit(obj, keys) {
   const result = {};
   for (const key of Object.keys(obj)) {
@@ -195,12 +202,37 @@ function parsePath(path) {
 function isNumericString(str) {
   return /^\d+$/.test(str);
 }
+function getObjPropertyOrInsert(obj, prop, insertValue) {
+  if (obj[prop] === void 0) {
+    obj[prop] = insertValue();
+  }
+  return obj[prop];
+}
+function addPrefixToObjKeys(obj, prefix) {
+  const newObj = {};
+  for (const [key, value] of Object.entries(obj)) {
+    newObj[`${prefix}${key}`] = value;
+  }
+  return newObj;
+}
+function addSuffixToObjKeys(obj, suffix) {
+  const newObj = {};
+  for (const [key, value] of Object.entries(obj)) {
+    newObj[`${key}${suffix}`] = value;
+  }
+  return newObj;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  addPrefixToObjKeys,
+  addSuffixToObjKeys,
   filterObjectKeys,
+  getObjPropertyOrInsert,
   getValueFromPath,
   looseGetObjectProperty,
+  mapArrToObj,
   mapArrayToObject,
+  mapObjToObj,
   mapObjectToObject,
   objectTypedEntries,
   omit,

package/dist/objUtils.d.cts

@@ -8,13 +8,24 @@ import { MakeUndefinedKeysOptional } from './typeUtils.cjs';
  */
 declare function objectTypedEntries<T extends Record<string, unknown>>(obj: T): [Extract<keyof T, string>, T[keyof T]][];
 declare function pick<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
-declare function mapArrayToObject<T, K extends string, O>(array: T[], mapper: (item: T, index: number) => [K, O]): Record<K, O>;
-declare function mapObjectToObject<I extends Record<string | number | symbol, unknown>, K extends string | number | symbol, O>(obj: I, mapper: (key: keyof I, value: I[keyof I]) => [K, O]): Record<K, O>;
+declare function mapArrToObj<T, K extends string, O>(array: T[], mapper: (item: T, index: number) => [K, O]): Record<K, O>;
+/** @deprecated Use mapArrToObj instead */
+declare const mapArrayToObject: typeof mapArrToObj;
+declare function mapObjToObj<I extends Record<string | number | symbol, unknown>, K extends string | number | symbol, O>(obj: I, mapper: (key: keyof I, value: I[keyof I]) => [K, O]): Record<K, O>;
+/** @deprecated Use mapObjToObj instead */
+declare const mapObjectToObject: typeof mapObjToObj;
 declare function omit<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
 declare function looseGetObjectProperty<T extends Record<string, unknown>>(obj: T, key: string): T[keyof T] | undefined;
 declare function rejectObjUndefinedValues<T extends Record<string, unknown>>(obj: T): MakeUndefinedKeysOptional<T>;
 declare function filterObjectKeys<T extends Record<string, unknown>>(obj: T, predicate: (key: keyof T, value: T[keyof T]) => boolean): Partial<T>;
 declare function sortObjectKeys<T extends Record<string, unknown>>(obj: T, sortByFn: SortByValueFn<[key: keyof T, value: T[keyof T]]>, options?: SortByProps): T;
 declare function getValueFromPath(obj: Record<string, unknown>, path: string): Result<unknown, Error>;
+declare function getObjPropertyOrInsert<T extends Record<string, any>, K extends keyof T>(obj: T, prop: K, insertValue: () => Exclude<T[K], undefined>): Exclude<T[K], undefined>;
+declare function addPrefixToObjKeys<T extends Record<string, unknown>, P extends string>(obj: T, prefix: P): {
+    [K in keyof T & string as `${P}${K}`]: T[K];
+};
+declare function addSuffixToObjKeys<T extends Record<string, unknown>, S extends string>(obj: T, suffix: S): {
+    [K in keyof T & string as `${K}${S}`]: T[K];
+};
 
-export { filterObjectKeys, getValueFromPath, looseGetObjectProperty, mapArrayToObject, mapObjectToObject, objectTypedEntries, omit, pick, rejectObjUndefinedValues, sortObjectKeys };
+export { addPrefixToObjKeys, addSuffixToObjKeys, filterObjectKeys, getObjPropertyOrInsert, getValueFromPath, looseGetObjectProperty, mapArrToObj, mapArrayToObject, mapObjToObj, mapObjectToObject, objectTypedEntries, omit, pick, rejectObjUndefinedValues, sortObjectKeys };

package/dist/objUtils.d.ts

@@ -8,13 +8,24 @@ import { MakeUndefinedKeysOptional } from './typeUtils.js';
  */
 declare function objectTypedEntries<T extends Record<string, unknown>>(obj: T): [Extract<keyof T, string>, T[keyof T]][];
 declare function pick<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
-declare function mapArrayToObject<T, K extends string, O>(array: T[], mapper: (item: T, index: number) => [K, O]): Record<K, O>;
-declare function mapObjectToObject<I extends Record<string | number | symbol, unknown>, K extends string | number | symbol, O>(obj: I, mapper: (key: keyof I, value: I[keyof I]) => [K, O]): Record<K, O>;
+declare function mapArrToObj<T, K extends string, O>(array: T[], mapper: (item: T, index: number) => [K, O]): Record<K, O>;
+/** @deprecated Use mapArrToObj instead */
+declare const mapArrayToObject: typeof mapArrToObj;
+declare function mapObjToObj<I extends Record<string | number | symbol, unknown>, K extends string | number | symbol, O>(obj: I, mapper: (key: keyof I, value: I[keyof I]) => [K, O]): Record<K, O>;
+/** @deprecated Use mapObjToObj instead */
+declare const mapObjectToObject: typeof mapObjToObj;
 declare function omit<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
 declare function looseGetObjectProperty<T extends Record<string, unknown>>(obj: T, key: string): T[keyof T] | undefined;
 declare function rejectObjUndefinedValues<T extends Record<string, unknown>>(obj: T): MakeUndefinedKeysOptional<T>;
 declare function filterObjectKeys<T extends Record<string, unknown>>(obj: T, predicate: (key: keyof T, value: T[keyof T]) => boolean): Partial<T>;
 declare function sortObjectKeys<T extends Record<string, unknown>>(obj: T, sortByFn: SortByValueFn<[key: keyof T, value: T[keyof T]]>, options?: SortByProps): T;
 declare function getValueFromPath(obj: Record<string, unknown>, path: string): Result<unknown, Error>;
+declare function getObjPropertyOrInsert<T extends Record<string, any>, K extends keyof T>(obj: T, prop: K, insertValue: () => Exclude<T[K], undefined>): Exclude<T[K], undefined>;
+declare function addPrefixToObjKeys<T extends Record<string, unknown>, P extends string>(obj: T, prefix: P): {
+    [K in keyof T & string as `${P}${K}`]: T[K];
+};
+declare function addSuffixToObjKeys<T extends Record<string, unknown>, S extends string>(obj: T, suffix: S): {
+    [K in keyof T & string as `${K}${S}`]: T[K];
+};
 
-export { filterObjectKeys, getValueFromPath, looseGetObjectProperty, mapArrayToObject, mapObjectToObject, objectTypedEntries, omit, pick, rejectObjUndefinedValues, sortObjectKeys };
+export { addPrefixToObjKeys, addSuffixToObjKeys, filterObjectKeys, getObjPropertyOrInsert, getValueFromPath, looseGetObjectProperty, mapArrToObj, mapArrayToObject, mapObjToObj, mapObjectToObject, objectTypedEntries, omit, pick, rejectObjUndefinedValues, sortObjectKeys };

package/dist/objUtils.js

@@ -1,24 +1,34 @@
 import {
+  addPrefixToObjKeys,
+  addSuffixToObjKeys,
   filterObjectKeys,
+  getObjPropertyOrInsert,
   getValueFromPath,
   looseGetObjectProperty,
+  mapArrToObj,
   mapArrayToObject,
+  mapObjToObj,
   mapObjectToObject,
   objectTypedEntries,
   omit,
   pick,
   rejectObjUndefinedValues,
   sortObjectKeys
-} from "./chunk-WNFRB7P6.js";
+} from "./chunk-SGRS4OEE.js";
 import "./chunk-GMJTLFM6.js";
-import "./chunk-BT3UMATU.js";
+import "./chunk-GVIDV772.js";
 import "./chunk-C2SVCIWE.js";
 import "./chunk-JF2MDHOJ.js";
 export {
+  addPrefixToObjKeys,
+  addSuffixToObjKeys,
   filterObjectKeys,
+  getObjPropertyOrInsert,
   getValueFromPath,
   looseGetObjectProperty,
+  mapArrToObj,
   mapArrayToObject,
+  mapObjToObj,
   mapObjectToObject,
   objectTypedEntries,
   omit,

package/dist/serializeXML.js

@@ -1,6 +1,6 @@
 import {
   filterAndMap
-} from "./chunk-BT3UMATU.js";
+} from "./chunk-GVIDV772.js";
 import "./chunk-C2SVCIWE.js";
 import {
   isTruthy

package/dist/testUtils.js

@@ -4,11 +4,11 @@ import {
 import {
   omit,
   pick
-} from "./chunk-WNFRB7P6.js";
+} from "./chunk-SGRS4OEE.js";
 import "./chunk-GMJTLFM6.js";
 import {
   filterObjectOrArrayKeys
-} from "./chunk-LBBC55GE.js";
+} from "./chunk-2LO5FYP5.js";
 import "./chunk-IATIXMCE.js";
 import {
   deepEqual
@@ -26,7 +26,7 @@ import "./chunk-BM4PYVOX.js";
 import {
   arrayWithPrevAndIndex,
   filterAndMap
-} from "./chunk-BT3UMATU.js";
+} from "./chunk-GVIDV772.js";
 import {
   isObject
 } from "./chunk-C2SVCIWE.js";

package/package.json

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