@oscarpalmer/atoms 0.76.0 → 0.77.0

package/types/array/index-of.d.cts

@@ -1,9 +1,6 @@
 // Generated by dts-bundle-generator v9.5.1
 
 export type Key = number | string;
-export type ArrayCallback<Item, Value> = (item: Item, index: number, array: Item[]) => Value;
-export type BooleanCallback<Item> = ArrayCallback<Item, boolean>;
-export type KeyCallback<Item> = ArrayCallback<Item, Key>;
 /**
  * Get the index for the first item matching `value` _(or `-1` if no match is found)_
  */
@@ -11,7 +8,7 @@ export declare function indexOf<Item>(array: Item[], value: Item): number;
 /**
  * Get the index for the first item matching `value` _(or `-1` if no match is found)_
  */
-export declare function indexOf<Item>(array: Item[], matches: BooleanCallback<Item>): number;
+export declare function indexOf<Item>(array: Item[], matches: (item: Item, index: number, array: Item[]) => boolean): number;
 /**
  * - Get the index for the first matching item _(or `-1` if no match is found)_
  * - Use `key` to find a comparison value to match with `value`
@@ -21,6 +18,6 @@ export declare function indexOf<Item, Key extends keyof Item>(array: Item[], key
  * - Get the index for the first matching item _(or `-1` if no match is found)_
  * - Use `key` to find a comparison value to match with `value`
  */
-export declare function indexOf<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, value: ReturnType<Key>): number;
+export declare function indexOf<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key, value: ReturnType<Key>): number;
 
 export {};

package/types/array/index-of.d.ts

@@ -1,4 +1,4 @@
-import type { BooleanCallback, KeyCallback } from '~/array/models';
+import type { Key as SimpleKey } from '~/models';
 /**
  * Get the index for the first item matching `value` _(or `-1` if no match is found)_
  */
@@ -6,7 +6,7 @@ export declare function indexOf<Item>(array: Item[], value: Item): number;
 /**
  * Get the index for the first item matching `value` _(or `-1` if no match is found)_
  */
-export declare function indexOf<Item>(array: Item[], matches: BooleanCallback<Item>): number;
+export declare function indexOf<Item>(array: Item[], matches: (item: Item, index: number, array: Item[]) => boolean): number;
 /**
  * - Get the index for the first matching item _(or `-1` if no match is found)_
  * - Use `key` to find a comparison value to match with `value`
@@ -16,4 +16,4 @@ export declare function indexOf<Item, Key extends keyof Item>(array: Item[], key
  * - Get the index for the first matching item _(or `-1` if no match is found)_
  * - Use `key` to find a comparison value to match with `value`
  */
-export declare function indexOf<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, value: ReturnType<Key>): number;
+export declare function indexOf<Item, Key extends (item: Item, index: number, array: Item[]) => SimpleKey>(array: Item[], key: Key, value: ReturnType<Key>): number;

package/types/array/index.d.cts

@@ -15,15 +15,6 @@ export declare function compact<Item>(array: Item[]): Exclude<Item, null | undef
  * Compact an array _(removing all falsey values)_
  */
 export declare function compact<Item>(array: Item[], strict: true): Exclude<Item, 0 | "" | false | null | undefined>[];
-export type ArrayCallback<Item, Value> = (item: Item, index: number, array: Item[]) => Value;
-export type BooleanCallback<Item> = ArrayCallback<Item, boolean>;
-export type KeyCallback<Item> = ArrayCallback<Item, Key>;
-export type SortKey<Item> = {
-	direction: "asc" | "desc";
-	value: Key | SortKeyCallback<Item>;
-};
-export type SortKeyCallback<Item> = (item: Item) => unknown;
-export type ValueCallback<Item> = ArrayCallback<Item, unknown>;
 /**
  * Get the number of items _(count)_ that match the given value
  */
@@ -31,7 +22,7 @@ export declare function count<Item>(array: Item[], value: Item): number;
 /**
  * Get the number of items _(count)_ that match the given value
  */
-export declare function count<Item>(array: Item[], matches: BooleanCallback<Item>): number;
+export declare function count<Item>(array: Item[], matches: (item: Item, index: number, array: Item[]) => boolean): number;
 /**
  * Get the number of items _(count)_ that match the given value
  */
@@ -39,7 +30,7 @@ export declare function count<Item, Key extends keyof Item>(array: Item[], key:
 /**
  * Get the number of items _(count)_ that match the given value
  */
-export declare function count<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, value: ReturnType<Key>): number;
+export declare function count<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key, value: ReturnType<Key>): number;
 /**
  * Does the value exist in array?
  */
@@ -47,7 +38,7 @@ export declare function exists<Item>(array: Item[], value: Item): boolean;
 /**
  * Does the value exist in array?
  */
-export declare function exists<Item>(array: Item[], matches: BooleanCallback<Item>): boolean;
+export declare function exists<Item>(array: Item[], matches: (item: Item, index: number, array: Item[]) => boolean): boolean;
 /**
  * - Does the value exist in array?
  * - Use `key` to find a comparison value to match with `value`
@@ -57,7 +48,7 @@ export declare function exists<Item, Key extends keyof Item>(array: Item[], key:
  * - Does the value exist in array?
  * - Use `key` to find a comparison value to match with `value`
  */
-export declare function exists<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, value: ReturnType<Key>): boolean;
+export declare function exists<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key, value: ReturnType<Key>): boolean;
 /**
  * Get a filtered array of items matching `value`
  */
@@ -65,7 +56,7 @@ export declare function filter<Item>(array: Item[], value: Item): Item[];
 /**
  * Get a filtered array of items matching `value`
  */
-export declare function filter<Item>(array: Item[], matches: BooleanCallback<Item>): Item[];
+export declare function filter<Item>(array: Item[], matches: (item: Item, index: number, array: Item[]) => boolean): Item[];
 /**
  * - Get a filtered array of items
  * - Use `key` to find a comparison value to match with `value`
@@ -75,7 +66,7 @@ export declare function filter<Item, Key extends keyof Item>(array: Item[], key:
  * - Get a filtered array of items
  * - Use `key` to find a comparison value to match with `value`
  */
-export declare function filter<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, value: ReturnType<Key>): Item[];
+export declare function filter<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key, value: ReturnType<Key>): Item[];
 /**
  * Get the first item matching `value` _(or `undefined` if no match is found)_
  */
@@ -83,7 +74,7 @@ export declare function find<Item>(array: Item[], value: Item): Item | undefined
 /**
  * Get the first item matching `value` _(or `undefined` if no match is found)_
  */
-export declare function find<Item>(array: Item[], matches: BooleanCallback<Item>): Item | undefined;
+export declare function find<Item>(array: Item[], matches: (item: Item, index: number, array: Item[]) => boolean): Item | undefined;
 /**
  * - Get the first matching item _(or `undefined` if no match is found)_
  * - Use `key` to find a comparison value to match with `value`
@@ -93,7 +84,7 @@ export declare function find<Item, Key extends keyof Item>(array: Item[], key: K
  * - Get the first matching item _(or `undefined` if no match is found)_
  * - Use `key` to find a comparison value to match with `value`
  */
-export declare function find<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, value: ReturnType<Key>): Item | undefined;
+export declare function find<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key, value: ReturnType<Key>): Item | undefined;
 /**
  * Create a record from an array of items using a specific key
  */
@@ -105,11 +96,11 @@ export declare function groupBy<Item, Key extends keyof Item>(array: Item[], key
 /**
  * Create a record from an array of items using a specific key
  */
-export declare function groupBy<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key): Record<ReturnType<Key>, Item>;
+export declare function groupBy<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key): Record<ReturnType<Key>, Item>;
 /**
  * Create a record from an array of items using a specific key, and grouping them into arrays
  */
-export declare function groupBy<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, arrays: true): Record<ReturnType<Key>, Item[]>;
+export declare function groupBy<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key, arrays: true): Record<ReturnType<Key>, Item[]>;
 /**
  * Create a record from an array of items using a specific key and value
  */
@@ -121,27 +112,27 @@ export declare function groupBy<Item, Key extends keyof Item, Value extends keyo
 /**
  * Create a record from an array of items using a specific key and value
  */
-export declare function groupBy<Item, Key extends keyof Item, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value): Record<KeyedValue<Item, Key>, ReturnType<Value>>;
+export declare function groupBy<Item, Key extends keyof Item, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value): Record<KeyedValue<Item, Key>, ReturnType<Value>>;
 /**
  * Create a record from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function groupBy<Item, Key extends keyof Item, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value, arrays: true): Record<KeyedValue<Item, Key>, Array<ReturnType<Value>>>;
+export declare function groupBy<Item, Key extends keyof Item, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value, arrays: true): Record<KeyedValue<Item, Key>, Array<ReturnType<Value>>>;
 /**
  * Create a record from an array of items using a specific key and value
  */
-export declare function groupBy<Item, Key extends KeyCallback<Item>, Value extends keyof Item>(array: Item[], key: Key, value: Value): Record<ReturnType<Key>, KeyedValue<Item, Value>>;
+export declare function groupBy<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends keyof Item>(array: Item[], key: Key, value: Value): Record<ReturnType<Key>, KeyedValue<Item, Value>>;
 /**
  * Create a record from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function groupBy<Item, Key extends KeyCallback<Item>, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Record<ReturnType<Key>, Array<KeyedValue<Item, Value>>>;
+export declare function groupBy<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Record<ReturnType<Key>, Array<KeyedValue<Item, Value>>>;
 /**
  * Create a record from an array of items using a specific key and value
  */
-export declare function groupBy<Item, Key extends KeyCallback<Item>, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value): Record<ReturnType<Key>, ReturnType<Value>>;
+export declare function groupBy<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value): Record<ReturnType<Key>, ReturnType<Value>>;
 /**
  * Create a record from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function groupBy<Item, Key extends KeyCallback<Item>, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value, arrays: true): Record<ReturnType<Key>, Array<ReturnType<Value>>>;
+export declare function groupBy<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value, arrays: true): Record<ReturnType<Key>, Array<ReturnType<Value>>>;
 /**
  * Get the index for the first item matching `value` _(or `-1` if no match is found)_
  */
@@ -149,7 +140,7 @@ export declare function indexOf<Item>(array: Item[], value: Item): number;
 /**
  * Get the index for the first item matching `value` _(or `-1` if no match is found)_
  */
-export declare function indexOf<Item>(array: Item[], matches: BooleanCallback<Item>): number;
+export declare function indexOf<Item>(array: Item[], matches: (item: Item, index: number, array: Item[]) => boolean): number;
 /**
  * - Get the index for the first matching item _(or `-1` if no match is found)_
  * - Use `key` to find a comparison value to match with `value`
@@ -159,7 +150,11 @@ export declare function indexOf<Item, Key extends keyof Item>(array: Item[], key
  * - Get the index for the first matching item _(or `-1` if no match is found)_
  * - Use `key` to find a comparison value to match with `value`
  */
-export declare function indexOf<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, value: ReturnType<Key>): number;
+export declare function indexOf<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key, value: ReturnType<Key>): number;
+export type SortKey<Item> = {
+	direction: "asc" | "desc";
+	value: Key | ((item: Item) => Key);
+};
 /**
  * - Insert values into an array _(at the end)_
  * - _(Uses chunking to avoid stack overflow_)
@@ -182,12 +177,12 @@ export declare function sort<Item>(array: Item[], descending?: boolean): Item[];
  * - Sort an array of items, using a `key` to sort by a specific value
  * - Defaults to ascending, but can be changed by setting `descending` to `true`, or using a `SortKey`
  */
-export declare function sort<Item>(array: Item[], key: Key | SortKey<Item> | SortKeyCallback<Item>, descending?: boolean): Item[];
+export declare function sort<Item>(array: Item[], key: Key | SortKey<Item> | ((item: Item) => Key), descending?: boolean): Item[];
 /**
  * - Sort an array of items, using multiple `keys` to sort by specific values
  * - Defaults to ascending, but can be changed by setting `descending` to `true`, or using `SortKey`
  */
-export declare function sort<Item>(array: Item[], keys: Array<Key | SortKey<Item> | SortKeyCallback<Item>>, descending?: boolean): Item[];
+export declare function sort<Item>(array: Item[], keys: Array<Key | SortKey<Item> | ((item: Item) => Key)>, descending?: boolean): Item[];
 /**
  * Removes and returns all items from an array starting from a specific index
  */
@@ -221,11 +216,11 @@ export declare function toMap<Item, Key extends keyof Item>(array: Item[], key:
 /**
  * Create a map from an array of items using a specific key
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key): Map<ReturnType<Key>, Item>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key): Map<ReturnType<Key>, Item>;
 /**
  * Create a map from an array of items using a specific key, and grouping them into arrays
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, arrays: true): Map<ReturnType<Key>, Item[]>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key, arrays: true): Map<ReturnType<Key>, Item[]>;
 /**
  * Create a map from an array of items using a specific key and value
  */
@@ -237,27 +232,27 @@ export declare function toMap<Item, Key extends keyof Item, Value extends keyof
 /**
  * Create a map from an array of items using a specific key and value
  */
-export declare function toMap<Item, Key extends keyof Item, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value): Map<KeyedValue<Item, Key>, ReturnType<Value>>;
+export declare function toMap<Item, Key extends keyof Item, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value): Map<KeyedValue<Item, Key>, ReturnType<Value>>;
 /**
  * Create a map from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function toMap<Item, Key extends keyof Item, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value, arrays: true): Map<KeyedValue<Item, Key>, Array<ReturnType<Value>>>;
+export declare function toMap<Item, Key extends keyof Item, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value, arrays: true): Map<KeyedValue<Item, Key>, Array<ReturnType<Value>>>;
 /**
  * Create a map from an array of items using a specific key and value
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>, Value extends keyof Item>(array: Item[], key: Key, value: Value): Map<ReturnType<Key>, KeyedValue<Item, Value>>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends keyof Item>(array: Item[], key: Key, value: Value): Map<ReturnType<Key>, KeyedValue<Item, Value>>;
 /**
  * Create a map from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Map<ReturnType<Key>, Array<KeyedValue<Item, Value>>>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Map<ReturnType<Key>, Array<KeyedValue<Item, Value>>>;
 /**
  * Create a map from an array of items using a specific key and value
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value): Map<ReturnType<Key>, ReturnType<Value>>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value): Map<ReturnType<Key>, ReturnType<Value>>;
 /**
  * Create a map from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value, arrays: true): Map<ReturnType<Key>, Array<ReturnType<Value>>>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value, arrays: true): Map<ReturnType<Key>, Array<ReturnType<Value>>>;
 /**
  * Create a record from an array of items _(using their indices as keys)_
  */
@@ -273,11 +268,11 @@ export declare function toRecord<Item, Key extends keyof Item>(array: Item[], ke
 /**
  * Create a record from an array of items using a specific key
  */
-export declare function toRecord<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key): Record<ReturnType<Key>, Item>;
+export declare function toRecord<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key): Record<ReturnType<Key>, Item>;
 /**
  * Create a record from an array of items using a specific key, and grouping them into arrays
  */
-export declare function toRecord<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, arrays: true): Record<ReturnType<Key>, Item[]>;
+export declare function toRecord<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key, arrays: true): Record<ReturnType<Key>, Item[]>;
 /**
  * Create a record from an array of items using a specific key and value
  */
@@ -289,41 +284,41 @@ export declare function toRecord<Item, Key extends keyof Item, Value extends key
 /**
  * Create a record from an array of items using a specific key and value
  */
-export declare function toRecord<Item, Key extends keyof Item, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value): Record<KeyedValue<Item, Key>, ReturnType<Value>>;
+export declare function toRecord<Item, Key extends keyof Item, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value): Record<KeyedValue<Item, Key>, ReturnType<Value>>;
 /**
  * Create a record from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function toRecord<Item, Key extends keyof Item, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value, arrays: true): Record<KeyedValue<Item, Key>, Array<ReturnType<Value>>>;
+export declare function toRecord<Item, Key extends keyof Item, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value, arrays: true): Record<KeyedValue<Item, Key>, Array<ReturnType<Value>>>;
 /**
  * Create a record from an array of items using a specific key and value
  */
-export declare function toRecord<Item, Key extends KeyCallback<Item>, Value extends keyof Item>(array: Item[], key: Key, value: Value): Record<ReturnType<Key>, KeyedValue<Item, Value>>;
+export declare function toRecord<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends keyof Item>(array: Item[], key: Key, value: Value): Record<ReturnType<Key>, KeyedValue<Item, Value>>;
 /**
  * Create a record from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function toRecord<Item, Key extends KeyCallback<Item>, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Record<ReturnType<Key>, Array<KeyedValue<Item, Value>>>;
+export declare function toRecord<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Record<ReturnType<Key>, Array<KeyedValue<Item, Value>>>;
 /**
  * Create a record from an array of items using a specific key and value
  */
-export declare function toRecord<Item, Key extends KeyCallback<Item>, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value): Record<ReturnType<Key>, ReturnType<Value>>;
+export declare function toRecord<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value): Record<ReturnType<Key>, ReturnType<Value>>;
 /**
  * Create a record from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function toRecord<Item, Key extends KeyCallback<Item>, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value, arrays: true): Record<ReturnType<Key>, Array<ReturnType<Value>>>;
+export declare function toRecord<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value, arrays: true): Record<ReturnType<Key>, Array<ReturnType<Value>>>;
 /**
  * Get an array of unique items
  */
 export declare function unique<Item>(array: Item[]): Item[];
 /**
  * - Get an array of unique items
- * - Use `key` to find a comparison value to match with `value`
+ * - Use `key` to find a comparison value for an item
  */
 export declare function unique<Item, Key extends keyof Item>(array: Item[], key: Key): Item[];
 /**
  * - Get an array of unique items
- * - Use `key` to find a comparison value to match with `value`
+ * - Use `key` to find a comparison value for an item
  */
-export declare function unique<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key): Item[];
+export declare function unique<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key): Item[];
 /**
  * Flatten an array _(using native `flat` and maximum depth)_
  */

package/types/array/models.d.cts

@@ -2,8 +2,6 @@
 
 export type GenericCallback = (...args: any[]) => any;
 export type Key = number | string;
-export type ArrayCallback<Item, Value> = (item: Item, index: number, array: Item[]) => Value;
-export type BooleanCallback<Item> = ArrayCallback<Item, boolean>;
 export type Callbacks = {
 	bool?: GenericCallback;
 	key?: GenericCallback;
@@ -11,16 +9,13 @@ export type Callbacks = {
 };
 export type FindType = "index" | "value";
 export type InsertType = "push" | "splice";
-export type KeyCallback<Item> = ArrayCallback<Item, Key>;
 export type SortKey<Item> = {
 	direction: "asc" | "desc";
-	value: Key | SortKeyCallback<Item>;
+	value: Key | ((item: Item) => Key);
 };
-export type SortKeyCallback<Item> = (item: Item) => unknown;
 export type SortKeyWithCallback<Item> = {
-	callback: SortKeyCallback<Item>;
+	callback: (item: Item) => Key;
 	direction: "asc" | "desc";
 };
-export type ValueCallback<Item> = ArrayCallback<Item, unknown>;
 
 export {};

package/types/array/models.d.ts

@@ -1,6 +1,4 @@
 import type { GenericCallback, Key } from '~/models';
-export type ArrayCallback<Item, Value> = (item: Item, index: number, array: Item[]) => Value;
-export type BooleanCallback<Item> = ArrayCallback<Item, boolean>;
 export type Callbacks = {
     bool?: GenericCallback;
     key?: GenericCallback;
@@ -8,14 +6,11 @@ export type Callbacks = {
 };
 export type FindType = 'index' | 'value';
 export type InsertType = 'push' | 'splice';
-export type KeyCallback<Item> = ArrayCallback<Item, Key>;
 export type SortKey<Item> = {
     direction: 'asc' | 'desc';
-    value: Key | SortKeyCallback<Item>;
+    value: Key | ((item: Item) => Key);
 };
-export type SortKeyCallback<Item> = (item: Item) => unknown;
 export type SortKeyWithCallback<Item> = {
-    callback: SortKeyCallback<Item>;
+    callback: (item: Item) => Key;
     direction: 'asc' | 'desc';
 };
-export type ValueCallback<Item> = ArrayCallback<Item, unknown>;

package/types/array/sort.d.cts

@@ -3,9 +3,8 @@
 export type Key = number | string;
 export type SortKey<Item> = {
 	direction: "asc" | "desc";
-	value: Key | SortKeyCallback<Item>;
+	value: Key | ((item: Item) => Key);
 };
-export type SortKeyCallback<Item> = (item: Item) => unknown;
 /**
  * Sort an array of items _(defaults to ascending)_
  */
@@ -14,11 +13,11 @@ export declare function sort<Item>(array: Item[], descending?: boolean): Item[];
  * - Sort an array of items, using a `key` to sort by a specific value
  * - Defaults to ascending, but can be changed by setting `descending` to `true`, or using a `SortKey`
  */
-export declare function sort<Item>(array: Item[], key: Key | SortKey<Item> | SortKeyCallback<Item>, descending?: boolean): Item[];
+export declare function sort<Item>(array: Item[], key: Key | SortKey<Item> | ((item: Item) => Key), descending?: boolean): Item[];
 /**
  * - Sort an array of items, using multiple `keys` to sort by specific values
  * - Defaults to ascending, but can be changed by setting `descending` to `true`, or using `SortKey`
  */
-export declare function sort<Item>(array: Item[], keys: Array<Key | SortKey<Item> | SortKeyCallback<Item>>, descending?: boolean): Item[];
+export declare function sort<Item>(array: Item[], keys: Array<Key | SortKey<Item> | ((item: Item) => Key)>, descending?: boolean): Item[];
 
 export {};

package/types/array/sort.d.ts

@@ -1,4 +1,4 @@
-import type { SortKey, SortKeyCallback } from '~/array/models';
+import type { SortKey } from '~/array/models';
 import type { Key } from '~/models';
 /**
  * Sort an array of items _(defaults to ascending)_
@@ -8,9 +8,9 @@ export declare function sort<Item>(array: Item[], descending?: boolean): Item[];
  * - Sort an array of items, using a `key` to sort by a specific value
  * - Defaults to ascending, but can be changed by setting `descending` to `true`, or using a `SortKey`
  */
-export declare function sort<Item>(array: Item[], key: Key | SortKey<Item> | SortKeyCallback<Item>, descending?: boolean): Item[];
+export declare function sort<Item>(array: Item[], key: Key | SortKey<Item> | ((item: Item) => Key), descending?: boolean): Item[];
 /**
  * - Sort an array of items, using multiple `keys` to sort by specific values
  * - Defaults to ascending, but can be changed by setting `descending` to `true`, or using `SortKey`
  */
-export declare function sort<Item>(array: Item[], keys: Array<Key | SortKey<Item> | SortKeyCallback<Item>>, descending?: boolean): Item[];
+export declare function sort<Item>(array: Item[], keys: Array<Key | SortKey<Item> | ((item: Item) => Key)>, descending?: boolean): Item[];

package/types/array/to-map.d.cts

@@ -2,9 +2,6 @@
 
 export type KeyedValue<Item, Key extends keyof Item> = Item[Key] extends PropertyKey ? Item[Key] : never;
 export type Key = number | string;
-export type ArrayCallback<Item, Value> = (item: Item, index: number, array: Item[]) => Value;
-export type KeyCallback<Item> = ArrayCallback<Item, Key>;
-export type ValueCallback<Item> = ArrayCallback<Item, unknown>;
 /**
  * Create a map from an array of items _(using their indices as keys)_
  */
@@ -20,11 +17,11 @@ export declare function toMap<Item, Key extends keyof Item>(array: Item[], key:
 /**
  * Create a map from an array of items using a specific key
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key): Map<ReturnType<Key>, Item>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key): Map<ReturnType<Key>, Item>;
 /**
  * Create a map from an array of items using a specific key, and grouping them into arrays
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, arrays: true): Map<ReturnType<Key>, Item[]>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key, arrays: true): Map<ReturnType<Key>, Item[]>;
 /**
  * Create a map from an array of items using a specific key and value
  */
@@ -36,26 +33,26 @@ export declare function toMap<Item, Key extends keyof Item, Value extends keyof
 /**
  * Create a map from an array of items using a specific key and value
  */
-export declare function toMap<Item, Key extends keyof Item, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value): Map<KeyedValue<Item, Key>, ReturnType<Value>>;
+export declare function toMap<Item, Key extends keyof Item, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value): Map<KeyedValue<Item, Key>, ReturnType<Value>>;
 /**
  * Create a map from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function toMap<Item, Key extends keyof Item, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value, arrays: true): Map<KeyedValue<Item, Key>, Array<ReturnType<Value>>>;
+export declare function toMap<Item, Key extends keyof Item, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value, arrays: true): Map<KeyedValue<Item, Key>, Array<ReturnType<Value>>>;
 /**
  * Create a map from an array of items using a specific key and value
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>, Value extends keyof Item>(array: Item[], key: Key, value: Value): Map<ReturnType<Key>, KeyedValue<Item, Value>>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends keyof Item>(array: Item[], key: Key, value: Value): Map<ReturnType<Key>, KeyedValue<Item, Value>>;
 /**
  * Create a map from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Map<ReturnType<Key>, Array<KeyedValue<Item, Value>>>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Map<ReturnType<Key>, Array<KeyedValue<Item, Value>>>;
 /**
  * Create a map from an array of items using a specific key and value
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value): Map<ReturnType<Key>, ReturnType<Value>>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value): Map<ReturnType<Key>, ReturnType<Value>>;
 /**
  * Create a map from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value, arrays: true): Map<ReturnType<Key>, Array<ReturnType<Value>>>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value, arrays: true): Map<ReturnType<Key>, Array<ReturnType<Value>>>;
 
 export {};

package/types/array/to-map.d.ts

@@ -1,5 +1,4 @@
-import type { KeyCallback, ValueCallback } from '~/array/models';
-import type { KeyedValue } from '~/models';
+import type { KeyedValue, Key as SimpleKey } from '~/models';
 /**
  * Create a map from an array of items _(using their indices as keys)_
  */
@@ -15,11 +14,11 @@ export declare function toMap<Item, Key extends keyof Item>(array: Item[], key:
 /**
  * Create a map from an array of items using a specific key
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key): Map<ReturnType<Key>, Item>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => SimpleKey>(array: Item[], key: Key): Map<ReturnType<Key>, Item>;
 /**
  * Create a map from an array of items using a specific key, and grouping them into arrays
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, arrays: true): Map<ReturnType<Key>, Item[]>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => SimpleKey>(array: Item[], key: Key, arrays: true): Map<ReturnType<Key>, Item[]>;
 /**
  * Create a map from an array of items using a specific key and value
  */
@@ -31,24 +30,24 @@ export declare function toMap<Item, Key extends keyof Item, Value extends keyof
 /**
  * Create a map from an array of items using a specific key and value
  */
-export declare function toMap<Item, Key extends keyof Item, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value): Map<KeyedValue<Item, Key>, ReturnType<Value>>;
+export declare function toMap<Item, Key extends keyof Item, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value): Map<KeyedValue<Item, Key>, ReturnType<Value>>;
 /**
  * Create a map from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function toMap<Item, Key extends keyof Item, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value, arrays: true): Map<KeyedValue<Item, Key>, Array<ReturnType<Value>>>;
+export declare function toMap<Item, Key extends keyof Item, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value, arrays: true): Map<KeyedValue<Item, Key>, Array<ReturnType<Value>>>;
 /**
  * Create a map from an array of items using a specific key and value
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>, Value extends keyof Item>(array: Item[], key: Key, value: Value): Map<ReturnType<Key>, KeyedValue<Item, Value>>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => SimpleKey, Value extends keyof Item>(array: Item[], key: Key, value: Value): Map<ReturnType<Key>, KeyedValue<Item, Value>>;
 /**
  * Create a map from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Map<ReturnType<Key>, Array<KeyedValue<Item, Value>>>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => SimpleKey, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Map<ReturnType<Key>, Array<KeyedValue<Item, Value>>>;
 /**
  * Create a map from an array of items using a specific key and value
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value): Map<ReturnType<Key>, ReturnType<Value>>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => SimpleKey, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value): Map<ReturnType<Key>, ReturnType<Value>>;
 /**
  * Create a map from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function toMap<Item, Key extends KeyCallback<Item>, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value, arrays: true): Map<ReturnType<Key>, Array<ReturnType<Value>>>;
+export declare function toMap<Item, Key extends (item: Item, index: number, array: Item[]) => SimpleKey, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value, arrays: true): Map<ReturnType<Key>, Array<ReturnType<Value>>>;

package/types/array/to-record.d.cts

@@ -2,9 +2,6 @@
 
 export type KeyedValue<Item, Key extends keyof Item> = Item[Key] extends PropertyKey ? Item[Key] : never;
 export type Key = number | string;
-export type ArrayCallback<Item, Value> = (item: Item, index: number, array: Item[]) => Value;
-export type KeyCallback<Item> = ArrayCallback<Item, Key>;
-export type ValueCallback<Item> = ArrayCallback<Item, unknown>;
 /**
  * Create a record from an array of items _(using their indices as keys)_
  */
@@ -20,11 +17,11 @@ export declare function toRecord<Item, Key extends keyof Item>(array: Item[], ke
 /**
  * Create a record from an array of items using a specific key
  */
-export declare function toRecord<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key): Record<ReturnType<Key>, Item>;
+export declare function toRecord<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key): Record<ReturnType<Key>, Item>;
 /**
  * Create a record from an array of items using a specific key, and grouping them into arrays
  */
-export declare function toRecord<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, arrays: true): Record<ReturnType<Key>, Item[]>;
+export declare function toRecord<Item, Key extends (item: Item, index: number, array: Item[]) => Key>(array: Item[], key: Key, arrays: true): Record<ReturnType<Key>, Item[]>;
 /**
  * Create a record from an array of items using a specific key and value
  */
@@ -36,26 +33,26 @@ export declare function toRecord<Item, Key extends keyof Item, Value extends key
 /**
  * Create a record from an array of items using a specific key and value
  */
-export declare function toRecord<Item, Key extends keyof Item, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value): Record<KeyedValue<Item, Key>, ReturnType<Value>>;
+export declare function toRecord<Item, Key extends keyof Item, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value): Record<KeyedValue<Item, Key>, ReturnType<Value>>;
 /**
  * Create a record from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function toRecord<Item, Key extends keyof Item, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value, arrays: true): Record<KeyedValue<Item, Key>, Array<ReturnType<Value>>>;
+export declare function toRecord<Item, Key extends keyof Item, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value, arrays: true): Record<KeyedValue<Item, Key>, Array<ReturnType<Value>>>;
 /**
  * Create a record from an array of items using a specific key and value
  */
-export declare function toRecord<Item, Key extends KeyCallback<Item>, Value extends keyof Item>(array: Item[], key: Key, value: Value): Record<ReturnType<Key>, KeyedValue<Item, Value>>;
+export declare function toRecord<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends keyof Item>(array: Item[], key: Key, value: Value): Record<ReturnType<Key>, KeyedValue<Item, Value>>;
 /**
  * Create a record from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function toRecord<Item, Key extends KeyCallback<Item>, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Record<ReturnType<Key>, Array<KeyedValue<Item, Value>>>;
+export declare function toRecord<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Record<ReturnType<Key>, Array<KeyedValue<Item, Value>>>;
 /**
  * Create a record from an array of items using a specific key and value
  */
-export declare function toRecord<Item, Key extends KeyCallback<Item>, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value): Record<ReturnType<Key>, ReturnType<Value>>;
+export declare function toRecord<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value): Record<ReturnType<Key>, ReturnType<Value>>;
 /**
  * Create a record from an array of items using a specific key and value, and grouping them into arrays
  */
-export declare function toRecord<Item, Key extends KeyCallback<Item>, Value extends ValueCallback<Item>>(array: Item[], key: Key, value: Value, arrays: true): Record<ReturnType<Key>, Array<ReturnType<Value>>>;
+export declare function toRecord<Item, Key extends (item: Item, index: number, array: Item[]) => Key, Value extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: Key, value: Value, arrays: true): Record<ReturnType<Key>, Array<ReturnType<Value>>>;
 
 export {};