@ls-stack/utils 3.33.0 → 3.34.1

package/{lib → dist}/arrayUtils.cjs

@@ -26,6 +26,7 @@ __export(arrayUtils_exports, {
   filterAndMap: () => filterAndMap,
   findAfterIndex: () => findAfterIndex,
   findBeforeIndex: () => findBeforeIndex,
+  getAscIndexOrder: () => getAscIndexOrder,
   hasDuplicates: () => hasDuplicates,
   isInArray: () => isInArray,
   rejectArrayUndefinedValues: () => rejectArrayUndefinedValues,
@@ -80,6 +81,9 @@ function sortBy(arr, sortByValue, props = "asc") {
     return 0;
   });
 }
+function getAscIndexOrder(index) {
+  return index === -1 ? Infinity : index ?? Infinity;
+}
 function arrayWithPrev(array) {
   return array.map((item, i) => [item, array[i - 1] ?? null]);
 }
@@ -171,6 +175,7 @@ function arrayOps(array) {
   filterAndMap,
   findAfterIndex,
   findBeforeIndex,
+  getAscIndexOrder,
   hasDuplicates,
   isInArray,
   rejectArrayUndefinedValues,

package/{lib → dist}/arrayUtils.d.cts

@@ -47,6 +47,24 @@ type SortByProps = {
  * const sortedItems = sortBy(items, (item) => [item.a, item.b]);
  */
 declare function sortBy<T>(arr: T[], sortByValue: SortByValue<T>, props?: SortByProps): T[];
+/**
+ * Get the correct 0 based value for sync with other array in ascending order
+ *
+ * @param index
+ *
+ * @example
+ * ```ts
+ * const items = [1, 2, 3];
+ *
+ * const index = sortBy(
+ *   items,
+ *   (item) => getAscIndexOrder(
+ *     followOrder.findIndex((order) => order === item)
+ *   )
+ * );
+ * ```
+ */
+declare function getAscIndexOrder(index: number | undefined): number;
 declare function arrayWithPrev<T>(array: T[]): [current: T, prev: T | null][];
 declare function arrayWithPrevAndIndex<T>(array: T[]): {
     item: T;
@@ -91,4 +109,4 @@ type ArrayOps<T> = {
  */
 declare function arrayOps<T>(array: T[]): ArrayOps<T>;
 
-export { type FilterAndMapReturn, arrayOps, arrayWithPrev, arrayWithPrevAndIndex, filterAndMap, findAfterIndex, findBeforeIndex, hasDuplicates, isInArray, rejectArrayUndefinedValues, rejectDuplicates, sortBy, truncateArray };
+export { type FilterAndMapReturn, arrayOps, arrayWithPrev, arrayWithPrevAndIndex, filterAndMap, findAfterIndex, findBeforeIndex, getAscIndexOrder, hasDuplicates, isInArray, rejectArrayUndefinedValues, rejectDuplicates, sortBy, truncateArray };

package/{lib → dist}/arrayUtils.d.ts

@@ -47,6 +47,24 @@ type SortByProps = {
  * const sortedItems = sortBy(items, (item) => [item.a, item.b]);
  */
 declare function sortBy<T>(arr: T[], sortByValue: SortByValue<T>, props?: SortByProps): T[];
+/**
+ * Get the correct 0 based value for sync with other array in ascending order
+ *
+ * @param index
+ *
+ * @example
+ * ```ts
+ * const items = [1, 2, 3];
+ *
+ * const index = sortBy(
+ *   items,
+ *   (item) => getAscIndexOrder(
+ *     followOrder.findIndex((order) => order === item)
+ *   )
+ * );
+ * ```
+ */
+declare function getAscIndexOrder(index: number | undefined): number;
 declare function arrayWithPrev<T>(array: T[]): [current: T, prev: T | null][];
 declare function arrayWithPrevAndIndex<T>(array: T[]): {
     item: T;
@@ -91,4 +109,4 @@ type ArrayOps<T> = {
  */
 declare function arrayOps<T>(array: T[]): ArrayOps<T>;
 
-export { type FilterAndMapReturn, arrayOps, arrayWithPrev, arrayWithPrevAndIndex, filterAndMap, findAfterIndex, findBeforeIndex, hasDuplicates, isInArray, rejectArrayUndefinedValues, rejectDuplicates, sortBy, truncateArray };
+export { type FilterAndMapReturn, arrayOps, arrayWithPrev, arrayWithPrevAndIndex, filterAndMap, findAfterIndex, findBeforeIndex, getAscIndexOrder, hasDuplicates, isInArray, rejectArrayUndefinedValues, rejectDuplicates, sortBy, truncateArray };

package/{lib → dist}/arrayUtils.js

@@ -5,13 +5,14 @@ import {
   filterAndMap,
   findAfterIndex,
   findBeforeIndex,
+  getAscIndexOrder,
   hasDuplicates,
   isInArray,
   rejectArrayUndefinedValues,
   rejectDuplicates,
   sortBy,
   truncateArray
-} from "./chunk-RYBJST64.js";
+} from "./chunk-4DVTWCXL.js";
 import "./chunk-C2SVCIWE.js";
 import "./chunk-JF2MDHOJ.js";
 export {
@@ -21,6 +22,7 @@ export {
   filterAndMap,
   findAfterIndex,
   findBeforeIndex,
+  getAscIndexOrder,
   hasDuplicates,
   isInArray,
   rejectArrayUndefinedValues,

package/{lib/chunk-RYBJST64.js → dist/chunk-4DVTWCXL.js}

@@ -39,6 +39,9 @@ function sortBy(arr, sortByValue, props = "asc") {
     return 0;
   });
 }
+function getAscIndexOrder(index) {
+  return index === -1 ? Infinity : index ?? Infinity;
+}
 function arrayWithPrev(array) {
   return array.map((item, i) => [item, array[i - 1] ?? null]);
 }
@@ -126,6 +129,7 @@ function arrayOps(array) {
 export {
   filterAndMap,
   sortBy,
+  getAscIndexOrder,
   arrayWithPrev,
   arrayWithPrevAndIndex,
   isInArray,

package/{lib/chunk-IY3KYH32.js → dist/chunk-ADM37GSC.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-IATIXMCE.js";
 import {
   truncateString
-} from "./chunk-3LZQMZAS.js";
+} from "./chunk-KW55OTUG.js";
 import {
   isObject,
   isPlainObject

package/{lib/chunk-3LZQMZAS.js → dist/chunk-KW55OTUG.js}

@@ -42,6 +42,9 @@ function truncateString(str, length, ellipsis = "\u2026") {
   if (str.length <= length) return str;
   return str.slice(0, length - 1) + ellipsis;
 }
+function removeANSIColors(str) {
+  return str.replace(/\u001b\[\d+m/g, "");
+}
 
 export {
   concatStrings,
@@ -53,5 +56,6 @@ export {
   convertToCamelCase,
   convertToSentenceCase,
   convertToTitleCase,
-  truncateString
+  truncateString,
+  removeANSIColors
 };

package/{lib/chunk-XUNY3QUT.js → dist/chunk-XPOGWCUC.js}

@@ -1,6 +1,6 @@
 import {
   sortBy
-} from "./chunk-RYBJST64.js";
+} from "./chunk-4DVTWCXL.js";
 import {
   isPlainObject
 } from "./chunk-JF2MDHOJ.js";

package/{lib → dist}/concurrentCalls.js

@@ -1,6 +1,6 @@
 import {
   truncateString
-} from "./chunk-3LZQMZAS.js";
+} from "./chunk-KW55OTUG.js";
 import {
   sleep
 } from "./chunk-5DZT3Z5Z.js";
@@ -9,7 +9,7 @@ import {
 } from "./chunk-VAAMRG4K.js";
 import {
   truncateArray
-} from "./chunk-RYBJST64.js";
+} from "./chunk-4DVTWCXL.js";
 import {
   invariant
 } from "./chunk-C2SVCIWE.js";

package/{lib → dist}/filterObjectOrArrayKeys.js

@@ -1,7 +1,7 @@
 import {
   filterObjectOrArrayKeys
-} from "./chunk-XUNY3QUT.js";
-import "./chunk-RYBJST64.js";
+} from "./chunk-XPOGWCUC.js";
+import "./chunk-4DVTWCXL.js";
 import "./chunk-C2SVCIWE.js";
 import "./chunk-JF2MDHOJ.js";
 export {

package/{lib → dist}/serializeXML.js

@@ -1,6 +1,6 @@
 import {
   filterAndMap
-} from "./chunk-RYBJST64.js";
+} from "./chunk-4DVTWCXL.js";
 import "./chunk-C2SVCIWE.js";
 import {
   isTruthy

package/{lib → dist}/stringUtils.cjs

@@ -29,6 +29,7 @@ __export(stringUtils_exports, {
   formatNum: () => formatNum,
   isSnakeCase: () => isSnakeCase,
   joinStrings: () => joinStrings,
+  removeANSIColors: () => removeANSIColors,
   truncateString: () => truncateString
 });
 module.exports = __toCommonJS(stringUtils_exports);
@@ -75,6 +76,9 @@ function truncateString(str, length, ellipsis = "\u2026") {
   if (str.length <= length) return str;
   return str.slice(0, length - 1) + ellipsis;
 }
+function removeANSIColors(str) {
+  return str.replace(/\u001b\[\d+m/g, "");
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   concatStrings,
@@ -86,5 +90,6 @@ function truncateString(str, length, ellipsis = "\u2026") {
   formatNum,
   isSnakeCase,
   joinStrings,
+  removeANSIColors,
   truncateString
 });

package/{lib → dist}/stringUtils.d.cts

@@ -21,5 +21,6 @@ declare function convertToCamelCase(str: string): string;
 declare function convertToSentenceCase(str: string): string;
 declare function convertToTitleCase(str: string): string;
 declare function truncateString(str: string, length: number, ellipsis?: string): string;
+declare function removeANSIColors(str: string): string;
 
-export { concatStrings, convertToCamelCase, convertToPascalCase, convertToSentenceCase, convertToSnakeCase, convertToTitleCase, formatNum, isSnakeCase, joinStrings, truncateString };
+export { concatStrings, convertToCamelCase, convertToPascalCase, convertToSentenceCase, convertToSnakeCase, convertToTitleCase, formatNum, isSnakeCase, joinStrings, removeANSIColors, truncateString };

package/{lib → dist}/stringUtils.d.ts

@@ -21,5 +21,6 @@ declare function convertToCamelCase(str: string): string;
 declare function convertToSentenceCase(str: string): string;
 declare function convertToTitleCase(str: string): string;
 declare function truncateString(str: string, length: number, ellipsis?: string): string;
+declare function removeANSIColors(str: string): string;
 
-export { concatStrings, convertToCamelCase, convertToPascalCase, convertToSentenceCase, convertToSnakeCase, convertToTitleCase, formatNum, isSnakeCase, joinStrings, truncateString };
+export { concatStrings, convertToCamelCase, convertToPascalCase, convertToSentenceCase, convertToSnakeCase, convertToTitleCase, formatNum, isSnakeCase, joinStrings, removeANSIColors, truncateString };

package/{lib → dist}/stringUtils.js

@@ -8,8 +8,9 @@ import {
   formatNum,
   isSnakeCase,
   joinStrings,
+  removeANSIColors,
   truncateString
-} from "./chunk-3LZQMZAS.js";
+} from "./chunk-KW55OTUG.js";
 export {
   concatStrings,
   convertToCamelCase,
@@ -20,5 +21,6 @@ export {
   formatNum,
   isSnakeCase,
   joinStrings,
+  removeANSIColors,
   truncateString
 };

package/{lib → dist}/testUtils.js

@@ -1,6 +1,6 @@
 import {
   yamlStringify
-} from "./chunk-IY3KYH32.js";
+} from "./chunk-ADM37GSC.js";
 import {
   omit,
   pick
@@ -11,18 +11,18 @@ import {
 } from "./chunk-JQFUKJU5.js";
 import {
   filterObjectOrArrayKeys
-} from "./chunk-XUNY3QUT.js";
+} from "./chunk-XPOGWCUC.js";
 import {
   defer
 } from "./chunk-DFXNVEH6.js";
 import {
   clampMin
 } from "./chunk-HTCYUMDR.js";
-import "./chunk-3LZQMZAS.js";
+import "./chunk-KW55OTUG.js";
 import {
   arrayWithPrevAndIndex,
   filterAndMap
-} from "./chunk-RYBJST64.js";
+} from "./chunk-4DVTWCXL.js";
 import {
   isObject
 } from "./chunk-C2SVCIWE.js";

package/{lib → dist}/yamlStringify.js

@@ -1,8 +1,8 @@
 import {
   yamlStringify
-} from "./chunk-IY3KYH32.js";
+} from "./chunk-ADM37GSC.js";
 import "./chunk-IATIXMCE.js";
-import "./chunk-3LZQMZAS.js";
+import "./chunk-KW55OTUG.js";
 import "./chunk-JF2MDHOJ.js";
 export {
   yamlStringify

package/docs/arrayUtils/-internal-.md

@@ -14,7 +14,7 @@
 type ArrayOps<T> = object;
 ```
 
-Defined in: [packages/utils/src/arrayUtils.ts:238](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L238)
+Defined in: [packages/utils/src/arrayUtils.ts:259](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L259)
 
 #### Type Parameters
 
@@ -30,7 +30,7 @@ Defined in: [packages/utils/src/arrayUtils.ts:238](https://github.com/lucasols/u
 filterAndMap: <R>(mapFilter) => R[];
 ```
 
-Defined in: [packages/utils/src/arrayUtils.ts:251](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L251)
+Defined in: [packages/utils/src/arrayUtils.ts:272](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L272)
 
 Filter and map an array
 
@@ -69,7 +69,7 @@ enhancedItems.filterAndMap((item) => item === 2 ? false : item);
 rejectDuplicates: (getKey) => T[];
 ```
 
-Defined in: [packages/utils/src/arrayUtils.ts:253](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L253)
+Defined in: [packages/utils/src/arrayUtils.ts:274](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L274)
 
 ###### Parameters
 
@@ -87,7 +87,7 @@ Defined in: [packages/utils/src/arrayUtils.ts:253](https://github.com/lucasols/u
 sortBy: (sortByValue, props) => T[];
 ```
 
-Defined in: [packages/utils/src/arrayUtils.ts:252](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L252)
+Defined in: [packages/utils/src/arrayUtils.ts:273](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L273)
 
 ###### Parameters
 

package/docs/arrayUtils/README.md

@@ -34,7 +34,7 @@ Defined in: [packages/utils/src/arrayUtils.ts:42](https://github.com/lucasols/ut
 function arrayOps<T>(array): ArrayOps<T>;
 ```
 
-Defined in: [packages/utils/src/arrayUtils.ts:268](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L268)
+Defined in: [packages/utils/src/arrayUtils.ts:289](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L289)
 
 Enhance an array with extra methods
 
@@ -72,7 +72,7 @@ enhancedItems.rejectDuplicates((item) => item);
 function arrayWithPrev<T>(array): [T, null | T][];
 ```
 
-Defined in: [packages/utils/src/arrayUtils.ts:117](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L117)
+Defined in: [packages/utils/src/arrayUtils.ts:138](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L138)
 
 #### Type Parameters
 
@@ -98,7 +98,7 @@ Defined in: [packages/utils/src/arrayUtils.ts:117](https://github.com/lucasols/u
 function arrayWithPrevAndIndex<T>(array): object[];
 ```
 
-Defined in: [packages/utils/src/arrayUtils.ts:121](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L121)
+Defined in: [packages/utils/src/arrayUtils.ts:142](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L142)
 
 #### Type Parameters
 
@@ -181,7 +181,7 @@ function findAfterIndex<T>(
    predicate): undefined | T;
 ```
 
-Defined in: [packages/utils/src/arrayUtils.ts:144](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L144)
+Defined in: [packages/utils/src/arrayUtils.ts:165](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L165)
 
 #### Type Parameters
 
@@ -218,7 +218,7 @@ function findBeforeIndex<T>(
    predicate): undefined | T;
 ```
 
-Defined in: [packages/utils/src/arrayUtils.ts:158](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L158)
+Defined in: [packages/utils/src/arrayUtils.ts:179](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L179)
 
 #### Type Parameters
 
@@ -246,13 +246,48 @@ Defined in: [packages/utils/src/arrayUtils.ts:158](https://github.com/lucasols/u
 
 ***
 
+### getAscIndexOrder()
+
+```ts
+function getAscIndexOrder(index): number;
+```
+
+Defined in: [packages/utils/src/arrayUtils.ts:134](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L134)
+
+Get the correct 0 based value for sync with other array in ascending order
+
+#### Parameters
+
+##### index
+
+`undefined` | `number`
+
+#### Returns
+
+`number`
+
+#### Example
+
+```ts
+const items = [1, 2, 3];
+
+const index = sortBy(
+  items,
+  (item) => getAscIndexOrder(
+    followOrder.findIndex((order) => order === item)
+  )
+);
+```
+
+***
+
 ### hasDuplicates()
 
 ```ts
 function hasDuplicates<T>(array, getKey): boolean;
 ```
 
-Defined in: [packages/utils/src/arrayUtils.ts:182](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L182)
+Defined in: [packages/utils/src/arrayUtils.ts:203](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L203)
 
 #### Type Parameters
 
@@ -282,7 +317,7 @@ Defined in: [packages/utils/src/arrayUtils.ts:182](https://github.com/lucasols/u
 function isInArray<T, U>(value, oneOf): value is U;
 ```
 
-Defined in: [packages/utils/src/arrayUtils.ts:131](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L131)
+Defined in: [packages/utils/src/arrayUtils.ts:152](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L152)
 
 #### Type Parameters
 
@@ -316,7 +351,7 @@ readonly `U`[]
 function rejectArrayUndefinedValues<T>(array): T;
 ```
 
-Defined in: [packages/utils/src/arrayUtils.ts:178](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L178)
+Defined in: [packages/utils/src/arrayUtils.ts:199](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L199)
 
 #### Type Parameters
 
@@ -342,7 +377,7 @@ Defined in: [packages/utils/src/arrayUtils.ts:178](https://github.com/lucasols/u
 function rejectDuplicates<T>(array, getKey): T[];
 ```
 
-Defined in: [packages/utils/src/arrayUtils.ts:199](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L199)
+Defined in: [packages/utils/src/arrayUtils.ts:220](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L220)
 
 #### Type Parameters
 
@@ -432,7 +467,7 @@ function truncateArray<T>(
    appendIfTruncated?): T[];
 ```
 
-Defined in: [packages/utils/src/arrayUtils.ts:219](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L219)
+Defined in: [packages/utils/src/arrayUtils.ts:240](https://github.com/lucasols/utils/blob/main/packages/utils/src/arrayUtils.ts#L240)
 
 #### Type Parameters
 

package/docs/stringUtils/README.md

@@ -220,6 +220,26 @@ Defined in: [packages/utils/src/stringUtils.ts:50](https://github.com/lucasols/u
 
 ***
 
+### removeANSIColors()
+
+```ts
+function removeANSIColors(str): string;
+```
+
+Defined in: [packages/utils/src/stringUtils.ts:98](https://github.com/lucasols/utils/blob/main/packages/utils/src/stringUtils.ts#L98)
+
+#### Parameters
+
+##### str
+
+`string`
+
+#### Returns
+
+`string`
+
+***
+
 ### truncateString()
 
 ```ts