radashi 12.2.0-beta.45f2ac3 → 12.2.0-beta.68f53c8

package/README.md

@@ -51,9 +51,7 @@
     - ⚠️ **Beware:** Preview releases are not audited by the Radashi team. Always look at their
       changes in the PR to ensure no malicious code was introduced.
 
- 
-
-<img src="https://github.com/radashi-org/radashi/raw/main/img/rule.png" width="100%" />
+<img src="https://github.com/radashi-org/radashi/raw/b80a0e4/img/rule.png" width="100%" />
 
 ## Install
 
@@ -69,9 +67,7 @@ yarn add radashi
 npm install radashi
 ```
 
-&nbsp;
-
-<img src="https://github.com/radashi-org/radashi/raw/main/img/rule.png" width="100%" />
+<img src="https://github.com/radashi-org/radashi/raw/b80a0e4/img/rule.png" width="100%" />
 
 ## Contributing
 
@@ -81,9 +77,7 @@ Contributions are welcome and appreciated! Check out the contributing guide befo
   <img src="https://github.com/radashi-org/radashi/raw/main/img/contributing-button.png" alt="Contributing to Radashi" width="250px" />
 </a>
 
-&nbsp;
-
-<img src="https://github.com/radashi-org/radashi/raw/main/img/rule.png" width="100%" />
+<img src="https://github.com/radashi-org/radashi/raw/b80a0e4/img/rule.png" width="100%" />
 
 ## Changelog
 
@@ -97,6 +91,6 @@ This section documents the changes between the original `radash` library and thi
 
 <div align="center">
   <p align="center">
-    <img src="https://github.com/radashi-org/radashi/raw/main/img/footer.png" alt="Radashi" width="100%" />
+    <img src="https://github.com/radashi-org/radashi/raw/46c8897/img/footer.png" alt="Radashi" width="100%" />
   </p>
 </div>

package/dist/index.cjs

@@ -40,6 +40,7 @@ __export(src_exports, {
   defer: () => defer,
   diff: () => diff,
   draw: () => draw,
+  filterKey: () => filterKey,
   first: () => first,
   flat: () => flat,
   fork: () => fork,
@@ -315,9 +316,10 @@ var replaceOrAppend = (list2, newItem, match) => {
 // src/array/select.ts
 var select = (array, mapper, condition) => {
   if (!array) return [];
+  let mapped;
   return array.reduce((acc, item, index) => {
-    if (!condition(item, index)) return acc;
-    acc.push(mapper(item, index));
+    if (condition) condition(item, index) && acc.push(mapper(item, index));
+    else (mapped = mapper(item, index)) != null && acc.push(mapped);
     return acc;
   }, []);
 };
@@ -363,13 +365,18 @@ var toggle = (list2, item, toKey, options) => {
 
 // src/array/unique.ts
 var unique = (array, toKey) => {
-  const valueMap = array.reduce((acc, item) => {
-    const key = toKey ? toKey(item) : item;
-    if (acc[key]) return acc;
-    acc[key] = item;
-    return acc;
-  }, {});
-  return Object.values(valueMap);
+  if (toKey) {
+    const keys2 = /* @__PURE__ */ new Set();
+    return array.reduce((acc, item) => {
+      const key = toKey(item);
+      if (!keys2.has(key)) {
+        keys2.add(key);
+        acc.push(item);
+      }
+      return acc;
+    }, []);
+  }
+  return [...new Set(array)];
 };
 
 // src/array/zip.ts
@@ -748,6 +755,11 @@ var crush = (value) => {
   );
 };
 
+// src/object/filterKey.ts
+var filterKey = (obj, key, keys2) => {
+  return isArray(keys2) ? Object.hasOwnProperty.call(obj, key) && keys2.includes(key) : keys2(obj[key], key, obj);
+};
+
 // src/object/get.ts
 var get = (value, path, defaultValue) => {
   const segments = path.split(/[\.\[\]]/g);
@@ -1040,7 +1052,7 @@ var trim = (str, charsToTrim = " ") => {
 };
 
 // src/typed/isArray.ts
-var isArray = Array.isArray;
+var isArray = /* @__PURE__ */ (() => Array.isArray)();
 
 // src/typed/isDate.ts
 var isDate = (value) => {
@@ -1174,6 +1186,7 @@ var isSymbol = (value) => {
   defer,
   diff,
   draw,
+  filterKey,
   first,
   flat,
   fork,

package/dist/index.d.cts

@@ -156,7 +156,7 @@ declare const replaceOrAppend: <T>(list: readonly T[], newItem: T, match: (a: T,
  * @example
  * select([1, 2, 3, 4], x => x*x, x > 2) == [9, 16]
  */
-declare const select: <T, K>(array: readonly T[], mapper: (item: T, index: number) => K, condition: (item: T, index: number) => boolean) => K[];
+declare const select: <T, K>(array: readonly T[], mapper: (item: T, index: number) => K, condition?: ((item: T, index: number) => boolean) | undefined) => K[];
 
 /**
  * Shift array items by n steps If n > 0 items will shift n steps to
@@ -196,7 +196,7 @@ declare const toggle: <T>(list: readonly T[], item: T, toKey?: ((item: T, idx: n
  * Accepts an optional identity function to convert each item in the
  * list to a comparable identity value
  */
-declare const unique: <T, K extends string | number | symbol>(array: readonly T[], toKey?: ((item: T) => K) | undefined) => T[];
+declare const unique: <T, K = T>(array: readonly T[], toKey?: ((item: T) => K) | undefined) => T[];
 
 /**
  * Creates an array of grouped elements, the first of which contains
@@ -511,6 +511,22 @@ declare const construct: <TObject extends object>(obj: TObject) => object;
  */
 declare const crush: <TValue extends object>(value: TValue) => object;
 
+type KeyOf<T extends object> = object extends T ? keyof any : keyof T;
+type ValueOf<T extends object> = object extends T ? unknown : T[keyof T];
+type KeyFilterFunction<T extends object = object> = (value: ValueOf<T>, key: KeyOf<T>, obj: T) => boolean;
+/**
+ * Functions can use this type to accept either an array of keys or a
+ * filter callback. This provides type safety for such a parameter
+ * type, whose value can then be passed into `matchKeys` to receive a
+ * matching function.
+ */
+type KeyFilter<T extends object = object, Key extends keyof any = keyof any> = KeyFilterFunction<T> | readonly Key[];
+/**
+ * Returns true if the key is in the “keys array” or if the “filter
+ * function” returns true.
+ */
+declare const filterKey: (obj: object, key: string, keys: KeyFilter) => boolean;
+
 /**
  * Dynamically get a nested value from an array or object with a
  * string.
@@ -699,7 +715,7 @@ declare const title: (str: string | null | undefined) => string;
  */
 declare const trim: (str: string | null | undefined, charsToTrim?: string) => string;
 
-declare const isArray: (arg: any) => arg is any[];
+declare const isArray: (value: unknown) => value is readonly any[];
 
 declare const isDate: (value: any) => value is Date;
 
@@ -743,4 +759,4 @@ declare const isString: (value: any) => value is string;
 
 declare const isSymbol: (value: any) => value is symbol;
 
-export { AggregateError, type DebounceFunction, type RetryOptions, type ThrottledFunction, all, alphabetical, assign, boil, callable, camel, capitalize, chain, clone, cluster, compose, construct, counting, crush, dash, debounce, defer, diff, draw, first, flat, fork, get, group, guard, inRange, intersects, invert, isArray, isDate, isEmpty, isEqual, isFloat, isFunction, isInt, isIntString, isNumber, isObject, isPlainObject, isPrimitive, isPromise, isString, isSymbol, iterate, keys, last, list, listify, lowerize, map, mapEntries, mapKeys, mapValues, max, memo, merge, min, objectify, omit, parallel, partial, partob, pascal, pick, proxied, random, range, reduce, replace, replaceOrAppend, retry, select, series, set, shake, shift, shuffle, sift, sleep, snake, sort, sum, template, throttle, title, toFloat, toInt, toggle, trim, tryit as try, tryit, uid, unique, upperize, zip, zipToObject };
+export { AggregateError, type DebounceFunction, type KeyFilter, type KeyFilterFunction, type RetryOptions, type ThrottledFunction, all, alphabetical, assign, boil, callable, camel, capitalize, chain, clone, cluster, compose, construct, counting, crush, dash, debounce, defer, diff, draw, filterKey, first, flat, fork, get, group, guard, inRange, intersects, invert, isArray, isDate, isEmpty, isEqual, isFloat, isFunction, isInt, isIntString, isNumber, isObject, isPlainObject, isPrimitive, isPromise, isString, isSymbol, iterate, keys, last, list, listify, lowerize, map, mapEntries, mapKeys, mapValues, max, memo, merge, min, objectify, omit, parallel, partial, partob, pascal, pick, proxied, random, range, reduce, replace, replaceOrAppend, retry, select, series, set, shake, shift, shuffle, sift, sleep, snake, sort, sum, template, throttle, title, toFloat, toInt, toggle, trim, tryit as try, tryit, uid, unique, upperize, zip, zipToObject };

package/dist/index.d.ts

@@ -156,7 +156,7 @@ declare const replaceOrAppend: <T>(list: readonly T[], newItem: T, match: (a: T,
  * @example
  * select([1, 2, 3, 4], x => x*x, x > 2) == [9, 16]
  */
-declare const select: <T, K>(array: readonly T[], mapper: (item: T, index: number) => K, condition: (item: T, index: number) => boolean) => K[];
+declare const select: <T, K>(array: readonly T[], mapper: (item: T, index: number) => K, condition?: ((item: T, index: number) => boolean) | undefined) => K[];
 
 /**
  * Shift array items by n steps If n > 0 items will shift n steps to
@@ -196,7 +196,7 @@ declare const toggle: <T>(list: readonly T[], item: T, toKey?: ((item: T, idx: n
  * Accepts an optional identity function to convert each item in the
  * list to a comparable identity value
  */
-declare const unique: <T, K extends string | number | symbol>(array: readonly T[], toKey?: ((item: T) => K) | undefined) => T[];
+declare const unique: <T, K = T>(array: readonly T[], toKey?: ((item: T) => K) | undefined) => T[];
 
 /**
  * Creates an array of grouped elements, the first of which contains
@@ -511,6 +511,22 @@ declare const construct: <TObject extends object>(obj: TObject) => object;
  */
 declare const crush: <TValue extends object>(value: TValue) => object;
 
+type KeyOf<T extends object> = object extends T ? keyof any : keyof T;
+type ValueOf<T extends object> = object extends T ? unknown : T[keyof T];
+type KeyFilterFunction<T extends object = object> = (value: ValueOf<T>, key: KeyOf<T>, obj: T) => boolean;
+/**
+ * Functions can use this type to accept either an array of keys or a
+ * filter callback. This provides type safety for such a parameter
+ * type, whose value can then be passed into `matchKeys` to receive a
+ * matching function.
+ */
+type KeyFilter<T extends object = object, Key extends keyof any = keyof any> = KeyFilterFunction<T> | readonly Key[];
+/**
+ * Returns true if the key is in the “keys array” or if the “filter
+ * function” returns true.
+ */
+declare const filterKey: (obj: object, key: string, keys: KeyFilter) => boolean;
+
 /**
  * Dynamically get a nested value from an array or object with a
  * string.
@@ -699,7 +715,7 @@ declare const title: (str: string | null | undefined) => string;
  */
 declare const trim: (str: string | null | undefined, charsToTrim?: string) => string;
 
-declare const isArray: (arg: any) => arg is any[];
+declare const isArray: (value: unknown) => value is readonly any[];
 
 declare const isDate: (value: any) => value is Date;
 
@@ -743,4 +759,4 @@ declare const isString: (value: any) => value is string;
 
 declare const isSymbol: (value: any) => value is symbol;
 
-export { AggregateError, type DebounceFunction, type RetryOptions, type ThrottledFunction, all, alphabetical, assign, boil, callable, camel, capitalize, chain, clone, cluster, compose, construct, counting, crush, dash, debounce, defer, diff, draw, first, flat, fork, get, group, guard, inRange, intersects, invert, isArray, isDate, isEmpty, isEqual, isFloat, isFunction, isInt, isIntString, isNumber, isObject, isPlainObject, isPrimitive, isPromise, isString, isSymbol, iterate, keys, last, list, listify, lowerize, map, mapEntries, mapKeys, mapValues, max, memo, merge, min, objectify, omit, parallel, partial, partob, pascal, pick, proxied, random, range, reduce, replace, replaceOrAppend, retry, select, series, set, shake, shift, shuffle, sift, sleep, snake, sort, sum, template, throttle, title, toFloat, toInt, toggle, trim, tryit as try, tryit, uid, unique, upperize, zip, zipToObject };
+export { AggregateError, type DebounceFunction, type KeyFilter, type KeyFilterFunction, type RetryOptions, type ThrottledFunction, all, alphabetical, assign, boil, callable, camel, capitalize, chain, clone, cluster, compose, construct, counting, crush, dash, debounce, defer, diff, draw, filterKey, first, flat, fork, get, group, guard, inRange, intersects, invert, isArray, isDate, isEmpty, isEqual, isFloat, isFunction, isInt, isIntString, isNumber, isObject, isPlainObject, isPrimitive, isPromise, isString, isSymbol, iterate, keys, last, list, listify, lowerize, map, mapEntries, mapKeys, mapValues, max, memo, merge, min, objectify, omit, parallel, partial, partob, pascal, pick, proxied, random, range, reduce, replace, replaceOrAppend, retry, select, series, set, shake, shift, shuffle, sift, sleep, snake, sort, sum, template, throttle, title, toFloat, toInt, toggle, trim, tryit as try, tryit, uid, unique, upperize, zip, zipToObject };

package/dist/index.js

@@ -193,9 +193,10 @@ var replaceOrAppend = (list2, newItem, match) => {
 // src/array/select.ts
 var select = (array, mapper, condition) => {
   if (!array) return [];
+  let mapped;
   return array.reduce((acc, item, index) => {
-    if (!condition(item, index)) return acc;
-    acc.push(mapper(item, index));
+    if (condition) condition(item, index) && acc.push(mapper(item, index));
+    else (mapped = mapper(item, index)) != null && acc.push(mapped);
     return acc;
   }, []);
 };
@@ -241,13 +242,18 @@ var toggle = (list2, item, toKey, options) => {
 
 // src/array/unique.ts
 var unique = (array, toKey) => {
-  const valueMap = array.reduce((acc, item) => {
-    const key = toKey ? toKey(item) : item;
-    if (acc[key]) return acc;
-    acc[key] = item;
-    return acc;
-  }, {});
-  return Object.values(valueMap);
+  if (toKey) {
+    const keys2 = /* @__PURE__ */ new Set();
+    return array.reduce((acc, item) => {
+      const key = toKey(item);
+      if (!keys2.has(key)) {
+        keys2.add(key);
+        acc.push(item);
+      }
+      return acc;
+    }, []);
+  }
+  return [...new Set(array)];
 };
 
 // src/array/zip.ts
@@ -626,6 +632,11 @@ var crush = (value) => {
   );
 };
 
+// src/object/filterKey.ts
+var filterKey = (obj, key, keys2) => {
+  return isArray(keys2) ? Object.hasOwnProperty.call(obj, key) && keys2.includes(key) : keys2(obj[key], key, obj);
+};
+
 // src/object/get.ts
 var get = (value, path, defaultValue) => {
   const segments = path.split(/[\.\[\]]/g);
@@ -918,7 +929,7 @@ var trim = (str, charsToTrim = " ") => {
 };
 
 // src/typed/isArray.ts
-var isArray = Array.isArray;
+var isArray = /* @__PURE__ */ (() => Array.isArray)();
 
 // src/typed/isDate.ts
 var isDate = (value) => {
@@ -1051,6 +1062,7 @@ export {
   defer,
   diff,
   draw,
+  filterKey,
   first,
   flat,
   fork,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "radashi",
-  "version": "12.2.0-beta.45f2ac3",
+  "version": "12.2.0-beta.68f53c8",
   "description": "Functional utility library - modern, simple, typed, powerful",
   "sideEffects": false,
   "author": "Alec Larson",