@web-ts-toolkit/utils 0.30.0 → 0.31.1

package/README.md

@@ -11,7 +11,7 @@ pnpm add @web-ts-toolkit/utils
 ## Highlights
 
 - object-path helpers such as `get(...)`, `set(...)`, and `hasOwn(...)`
-- collection helpers such as `map(...)`, `filter(...)`, `uniq(...)`, `uniqBy(...)`, and `orderBy(...)`
+- collection helpers such as `map(...)`, `filter(...)`, `eachRight(...)`, `join(...)`, `uniq(...)`, `uniqBy(...)`, and `orderBy(...)`
 - small type guards
 - URL helpers such as `normalizeUrlPath(...)`
 - async helpers such as `mapValuesAsync(...)`
@@ -65,7 +65,7 @@ parseBooleanString('true', false);
 ## Main Exports
 
 - object helpers: `get`, `set`, `hasOwn`, `pick`, `pickBy`, `omit`, `omitBy`, `assign`, `cloneDeep`, `mapKeys`
-- collection helpers: `map`, `filter`, `reduce`, `find`, `flatten`, `uniq`, `uniqBy`, `orderBy`, `groupBy`, `sum`, `sumBy`
+- collection helpers: `map`, `filter`, `eachRight`, `join`, `reduce`, `find`, `flatten`, `uniq`, `uniqBy`, `orderBy`, `groupBy`, `sum`, `sumBy`
 - string helpers: `startCase`, `upperCase`
 - guards: `isArray`, `isPlainObject`, `isString`, `isPromise`
 - URL helpers: `addLeadingSlash`, `removeConsecutiveSlashesFromUrl`, `normalizeUrlPath`

package/index.d.mts

@@ -12,6 +12,9 @@ declare function compact<T>(array: T[] | null | undefined): T[];
 
 declare function difference<T>(array: T[] | null | undefined, ...values: Array<T[] | null | undefined>): T[];
 
+declare function eachRight<T>(collection: T[] | null | undefined, iteratee: (value: T, key: number, collection: T[]) => unknown): T[] | null | undefined;
+declare function eachRight<T extends object>(collection: T | null | undefined, iteratee: (value: T[keyof T], key: string, collection: T) => unknown): T | null | undefined;
+
 declare function filter<T>(collection: T[] | Record<string, T> | null | undefined, predicate: (value: T, key: number | string) => boolean): T[];
 
 declare function find<T>(collection: T[] | Record<string, T> | null | undefined, predicate: (value: T, key: number | string) => boolean): T | undefined;
@@ -63,6 +66,8 @@ declare function isString(value: unknown): value is string;
 
 declare function isUndefined(value: unknown): value is undefined;
 
+declare function join(array: unknown[] | null | undefined, separator?: string): string;
+
 declare function keys(value: unknown): string[];
 
 declare function map<T, TResult>(collection: T[] | Record<string, T> | null | undefined, iteratee: string | number | ((value: T, key: number | string, collection: T[] | Record<string, T>) => TResult)): TResult[];
@@ -114,4 +119,4 @@ declare function uniqBy<T>(array: T[] | null | undefined, iteratee?: string | nu
 
 declare function upperCase(value: unknown): string;
 
-export { addLeadingSlash, arrayToRecord, assign, castArray, cloneDeep, compact, difference, filter, find, flatten, flattenDeep, forEach, get, groupBy, hasOwn, intersection, intersectionBy, isArray, isBoolean, isEmpty, isEqual, isFunction, isMatch, isNaNValue as isNaN, isNil, isNumber, isObject, isPlainObject, isPromise, isString, isUndefined, keys, map, mapKeys, mapValues, mapValuesAsync, noop, normalizeUrlPath, omit, omitBy, orderBy, padEnd, parseBooleanString, pick, pickBy, reduce, removeConsecutiveSlashesFromUrl, set, startCase, sum, sumBy, toAsyncFn, toStringRecord, uniq, uniqBy, upperCase };
+export { addLeadingSlash, arrayToRecord, assign, castArray, cloneDeep, compact, difference, eachRight, filter, find, flatten, flattenDeep, forEach, get, groupBy, hasOwn, intersection, intersectionBy, isArray, isBoolean, isEmpty, isEqual, isFunction, isMatch, isNaNValue as isNaN, isNil, isNumber, isObject, isPlainObject, isPromise, isString, isUndefined, join, keys, map, mapKeys, mapValues, mapValuesAsync, noop, normalizeUrlPath, omit, omitBy, orderBy, padEnd, parseBooleanString, pick, pickBy, reduce, removeConsecutiveSlashesFromUrl, set, startCase, sum, sumBy, toAsyncFn, toStringRecord, uniq, uniqBy, upperCase };

package/index.d.ts

@@ -12,6 +12,9 @@ declare function compact<T>(array: T[] | null | undefined): T[];
 
 declare function difference<T>(array: T[] | null | undefined, ...values: Array<T[] | null | undefined>): T[];
 
+declare function eachRight<T>(collection: T[] | null | undefined, iteratee: (value: T, key: number, collection: T[]) => unknown): T[] | null | undefined;
+declare function eachRight<T extends object>(collection: T | null | undefined, iteratee: (value: T[keyof T], key: string, collection: T) => unknown): T | null | undefined;
+
 declare function filter<T>(collection: T[] | Record<string, T> | null | undefined, predicate: (value: T, key: number | string) => boolean): T[];
 
 declare function find<T>(collection: T[] | Record<string, T> | null | undefined, predicate: (value: T, key: number | string) => boolean): T | undefined;
@@ -63,6 +66,8 @@ declare function isString(value: unknown): value is string;
 
 declare function isUndefined(value: unknown): value is undefined;
 
+declare function join(array: unknown[] | null | undefined, separator?: string): string;
+
 declare function keys(value: unknown): string[];
 
 declare function map<T, TResult>(collection: T[] | Record<string, T> | null | undefined, iteratee: string | number | ((value: T, key: number | string, collection: T[] | Record<string, T>) => TResult)): TResult[];
@@ -114,4 +119,4 @@ declare function uniqBy<T>(array: T[] | null | undefined, iteratee?: string | nu
 
 declare function upperCase(value: unknown): string;
 
-export { addLeadingSlash, arrayToRecord, assign, castArray, cloneDeep, compact, difference, filter, find, flatten, flattenDeep, forEach, get, groupBy, hasOwn, intersection, intersectionBy, isArray, isBoolean, isEmpty, isEqual, isFunction, isMatch, isNaNValue as isNaN, isNil, isNumber, isObject, isPlainObject, isPromise, isString, isUndefined, keys, map, mapKeys, mapValues, mapValuesAsync, noop, normalizeUrlPath, omit, omitBy, orderBy, padEnd, parseBooleanString, pick, pickBy, reduce, removeConsecutiveSlashesFromUrl, set, startCase, sum, sumBy, toAsyncFn, toStringRecord, uniq, uniqBy, upperCase };
+export { addLeadingSlash, arrayToRecord, assign, castArray, cloneDeep, compact, difference, eachRight, filter, find, flatten, flattenDeep, forEach, get, groupBy, hasOwn, intersection, intersectionBy, isArray, isBoolean, isEmpty, isEqual, isFunction, isMatch, isNaNValue as isNaN, isNil, isNumber, isObject, isPlainObject, isPromise, isString, isUndefined, join, keys, map, mapKeys, mapValues, mapValuesAsync, noop, normalizeUrlPath, omit, omitBy, orderBy, padEnd, parseBooleanString, pick, pickBy, reduce, removeConsecutiveSlashesFromUrl, set, startCase, sum, sumBy, toAsyncFn, toStringRecord, uniq, uniqBy, upperCase };

package/index.js

@@ -26,6 +26,7 @@ __export(index_exports, {
   cloneDeep: () => cloneDeep,
   compact: () => compact,
   difference: () => difference,
+  eachRight: () => eachRight,
   filter: () => filter,
   find: () => find,
   flatten: () => flatten,
@@ -50,6 +51,7 @@ __export(index_exports, {
   isPromise: () => isPromise,
   isString: () => isString,
   isUndefined: () => isUndefined,
+  join: () => join,
   keys: () => keys,
   map: () => map,
   mapKeys: () => mapKeys,
@@ -401,6 +403,30 @@ function difference(array, ...values) {
   return array.filter((item) => !arrayIncludes(excluded, item));
 }
 
+// src/eachRight.ts
+function eachRight(collection, iteratee) {
+  if (!collection) {
+    return collection;
+  }
+  const callback = iteratee;
+  if (Array.isArray(collection)) {
+    for (let index = collection.length - 1; index >= 0; index--) {
+      if (callback(collection[index], index, collection) === false) {
+        break;
+      }
+    }
+    return collection;
+  }
+  const keys2 = Object.keys(collection);
+  for (let index = keys2.length - 1; index >= 0; index--) {
+    const key = keys2[index];
+    if (callback(collection[key], key, collection) === false) {
+      break;
+    }
+  }
+  return collection;
+}
+
 // src/filter.ts
 function filter(collection, predicate) {
   if (!collection) {
@@ -672,6 +698,14 @@ function isUndefined(value) {
   return value === void 0;
 }
 
+// src/join.ts
+function join(array, separator) {
+  if (!Array.isArray(array)) {
+    return "";
+  }
+  return array.join(separator);
+}
+
 // src/keys.ts
 function keys(value) {
   if (value == null) {
@@ -980,6 +1014,7 @@ function upperCase(value) {
   cloneDeep,
   compact,
   difference,
+  eachRight,
   filter,
   find,
   flatten,
@@ -1004,6 +1039,7 @@ function upperCase(value) {
   isPromise,
   isString,
   isUndefined,
+  join,
   keys,
   map,
   mapKeys,

package/index.mjs

@@ -321,6 +321,30 @@ function difference(array, ...values) {
   return array.filter((item) => !arrayIncludes(excluded, item));
 }
 
+// src/eachRight.ts
+function eachRight(collection, iteratee) {
+  if (!collection) {
+    return collection;
+  }
+  const callback = iteratee;
+  if (Array.isArray(collection)) {
+    for (let index = collection.length - 1; index >= 0; index--) {
+      if (callback(collection[index], index, collection) === false) {
+        break;
+      }
+    }
+    return collection;
+  }
+  const keys2 = Object.keys(collection);
+  for (let index = keys2.length - 1; index >= 0; index--) {
+    const key = keys2[index];
+    if (callback(collection[key], key, collection) === false) {
+      break;
+    }
+  }
+  return collection;
+}
+
 // src/filter.ts
 function filter(collection, predicate) {
   if (!collection) {
@@ -592,6 +616,14 @@ function isUndefined(value) {
   return value === void 0;
 }
 
+// src/join.ts
+function join(array, separator) {
+  if (!Array.isArray(array)) {
+    return "";
+  }
+  return array.join(separator);
+}
+
 // src/keys.ts
 function keys(value) {
   if (value == null) {
@@ -899,6 +931,7 @@ export {
   cloneDeep,
   compact,
   difference,
+  eachRight,
   filter,
   find,
   flatten,
@@ -923,6 +956,7 @@ export {
   isPromise,
   isString,
   isUndefined,
+  join,
   keys,
   map,
   mapKeys,

package/package.json

@@ -2,7 +2,7 @@
   "name": "@web-ts-toolkit/utils",
   "description": "Shared collection, object, async, and URL helpers used across workspace packages",
   "homepage": "https://web-ts-toolkit.pages.dev/docs/packages/utils",
-  "version": "0.30.0",
+  "version": "0.31.1",
   "sideEffects": false,
   "keywords": [
     "utilities",