@oscarpalmer/atoms 0.75.0 → 0.76.0

package/types/array/sort.d.cts

@@ -1,24 +1,24 @@
 // Generated by dts-bundle-generator v9.5.1
 
 export type Key = number | string;
-export type SortKey<Value> = {
+export type SortKey<Item> = {
 	direction: "asc" | "desc";
-	value: Key | SortKeyCallback<Value>;
+	value: Key | SortKeyCallback<Item>;
 };
-export type SortKeyCallback<Value> = (value: Value) => Key;
+export type SortKeyCallback<Item> = (item: Item) => unknown;
 /**
- * Sorts an array of items _(ascending by default)_
+ * Sort an array of items _(defaults to ascending)_
  */
-export declare function sort<Value>(array: Value[], descending?: boolean): Value[];
+export declare function sort<Item>(array: Item[], descending?: boolean): Item[];
 /**
- * - Sorts an array of items, using a `key` to sort by a specific value
- * - Ascending by default, but can be changed by setting `descending` to `true`, or using a `SortKey`
+ * - 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<Value>(array: Value[], key: Key | SortKey<Value> | SortKeyCallback<Value>, descending?: boolean): Value[];
+export declare function sort<Item>(array: Item[], key: Key | SortKey<Item> | SortKeyCallback<Item>, descending?: boolean): Item[];
 /**
- * - Sorts an array of items, using multiple `keys` to sort by specific values
- * - Ascending by default, but can be changed by setting `descending` to `true`, or using `SortKey`
+ * - 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<Value>(array: Value[], keys: Array<Key | SortKey<Value> | SortKeyCallback<Value>>, descending?: boolean): Value[];
+export declare function sort<Item>(array: Item[], keys: Array<Key | SortKey<Item> | SortKeyCallback<Item>>, descending?: boolean): Item[];
 
 export {};

package/types/array/sort.d.ts

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

package/types/array/splice.d.cts

@@ -3,20 +3,20 @@
 /**
  * Removes and returns all items from an array starting from a specific index
  */
-export declare function splice<Value>(array: Value[], start: number): Value[];
+export declare function splice<Item>(array: Item[], start: number): Item[];
 /**
  * Removes and returns _(up to)_ a specific amount of items from an array, starting from a specific index
  */
-export declare function splice<Value>(array: Value[], start: number, amount: number): Value[];
+export declare function splice<Item>(array: Item[], start: number, amount: number): Item[];
 /**
  * - Splices values into an array and returns any removed values
  * - Uses chunking to avoid stack overflow
  */
-export declare function splice<Value>(array: Value[], start: number, values: Value[]): Value[];
+export declare function splice<Item>(array: Item[], start: number, added: Item[]): Item[];
 /**
  * - Splices values into an array and returns any removed values
  * - Uses chunking to avoid stack overflow
  */
-export declare function splice<Value>(array: Value[], start: number, amount: number, values: Value[]): Value[];
+export declare function splice<Item>(array: Item[], start: number, amount: number, added: Item[]): Item[];
 
 export {};

package/types/array/splice.d.ts

@@ -1,18 +1,18 @@
 /**
  * Removes and returns all items from an array starting from a specific index
  */
-export declare function splice<Value>(array: Value[], start: number): Value[];
+export declare function splice<Item>(array: Item[], start: number): Item[];
 /**
  * Removes and returns _(up to)_ a specific amount of items from an array, starting from a specific index
  */
-export declare function splice<Value>(array: Value[], start: number, amount: number): Value[];
+export declare function splice<Item>(array: Item[], start: number, amount: number): Item[];
 /**
  * - Splices values into an array and returns any removed values
  * - Uses chunking to avoid stack overflow
  */
-export declare function splice<Value>(array: Value[], start: number, values: Value[]): Value[];
+export declare function splice<Item>(array: Item[], start: number, added: Item[]): Item[];
 /**
  * - Splices values into an array and returns any removed values
  * - Uses chunking to avoid stack overflow
  */
-export declare function splice<Value>(array: Value[], start: number, amount: number, values: Value[]): Value[];
+export declare function splice<Item>(array: Item[], start: number, amount: number, added: Item[]): Item[];

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

@@ -1,37 +1,61 @@
 // Generated by dts-bundle-generator v9.5.1
 
+export type KeyedValue<Item, Key extends keyof Item> = Item[Key] extends PropertyKey ? Item[Key] : never;
 export type Key = number | string;
-export type ArrayCallback<Value, Returned> = (value: Value, index: number, array: Value[]) => Returned;
-export type KeyCallback<Value> = ArrayCallback<Value, Key>;
+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>;
 /**
- * Converts an array into a map, using indices as keys
+ * Create a map from an array of items _(using their indices as keys)_
  */
-export declare function toMap<Value>(array: Value[]): Map<number, Value>;
+export declare function toMap<Item>(array: Item[]): Map<number, Item>;
 /**
- * Converts an array into a map, using indices as keys and grouping values into arrays
+ * Create a map from an array of items using a specific key
  */
-export declare function toMap<Value>(array: Value[], arrays: true): Map<number, Value[]>;
+export declare function toMap<Item, Key extends keyof Item>(array: Item[], key: Key): Map<KeyedValue<Item, Key>, Item>;
 /**
- * - Converts an array into a map
- * - Uses `key` to find an identifcation value to use as keys
+ * Create a map from an array of items using a specific key, and grouping them into arrays
  */
-export declare function toMap<Value>(array: Value[], key: Key): Map<Key, Value>;
+export declare function toMap<Item, Key extends keyof Item>(array: Item[], key: Key, arrays: true): Map<KeyedValue<Item, Key>, Item[]>;
 /**
- * - Converts an array into a map
- * - Uses `key` to find an identifcation value to use as keys
- * - Groups values into arrays
+ * Create a map from an array of items using a specific key
  */
-export declare function toMap<Value>(array: Value[], key: Key, arrays: true): Map<Key, Value[]>;
+export declare function toMap<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key): Map<ReturnType<Key>, Item>;
 /**
- * - Converts an array into a map
- * - Uses `key` to find an identifcation value to use as keys
+ * Create a map from an array of items using a specific key, and grouping them into arrays
  */
-export declare function toMap<Value>(array: Value[], key: KeyCallback<Value>): Map<Key, Value>;
+export declare function toMap<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, arrays: true): Map<ReturnType<Key>, Item[]>;
 /**
- * - Converts an array into a map
- * - Uses `key` to find an identifcation value to use as keys
- * - Groups values into arrays
+ * Create a map from an array of items using a specific key and value
  */
-export declare function toMap<Value>(array: Value[], key: KeyCallback<Value>, arrays: true): Map<Key, Value[]>;
+export declare function toMap<Item, Key extends keyof Item, Value extends keyof Item>(array: Item[], key: Key, value: Value): Map<KeyedValue<Item, 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 keyof Item, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Map<KeyedValue<Item, 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 keyof Item, Value extends ValueCallback<Item>>(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>>>;
+/**
+ * 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>>;
+/**
+ * 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>>>;
+/**
+ * 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>>;
+/**
+ * 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 {};

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

@@ -1,32 +1,54 @@
-import type { KeyCallback } from '@/array/models';
-import type { Key } from '@/models';
+import type { KeyCallback, ValueCallback } from '~/array/models';
+import type { KeyedValue } from '~/models';
 /**
- * Converts an array into a map, using indices as keys
+ * Create a map from an array of items _(using their indices as keys)_
  */
-export declare function toMap<Value>(array: Value[]): Map<number, Value>;
+export declare function toMap<Item>(array: Item[]): Map<number, Item>;
 /**
- * Converts an array into a map, using indices as keys and grouping values into arrays
+ * Create a map from an array of items using a specific key
  */
-export declare function toMap<Value>(array: Value[], arrays: true): Map<number, Value[]>;
+export declare function toMap<Item, Key extends keyof Item>(array: Item[], key: Key): Map<KeyedValue<Item, Key>, Item>;
 /**
- * - Converts an array into a map
- * - Uses `key` to find an identifcation value to use as keys
+ * Create a map from an array of items using a specific key, and grouping them into arrays
  */
-export declare function toMap<Value>(array: Value[], key: Key): Map<Key, Value>;
+export declare function toMap<Item, Key extends keyof Item>(array: Item[], key: Key, arrays: true): Map<KeyedValue<Item, Key>, Item[]>;
 /**
- * - Converts an array into a map
- * - Uses `key` to find an identifcation value to use as keys
- * - Groups values into arrays
+ * Create a map from an array of items using a specific key
  */
-export declare function toMap<Value>(array: Value[], key: Key, arrays: true): Map<Key, Value[]>;
+export declare function toMap<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key): Map<ReturnType<Key>, Item>;
 /**
- * - Converts an array into a map
- * - Uses `key` to find an identifcation value to use as keys
+ * Create a map from an array of items using a specific key, and grouping them into arrays
  */
-export declare function toMap<Value>(array: Value[], key: KeyCallback<Value>): Map<Key, Value>;
+export declare function toMap<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, arrays: true): Map<ReturnType<Key>, Item[]>;
 /**
- * - Converts an array into a map
- * - Uses `key` to find an identifcation value to use as keys
- * - Groups values into arrays
+ * Create a map from an array of items using a specific key and value
  */
-export declare function toMap<Value>(array: Value[], key: KeyCallback<Value>, arrays: true): Map<Key, Value[]>;
+export declare function toMap<Item, Key extends keyof Item, Value extends keyof Item>(array: Item[], key: Key, value: Value): Map<KeyedValue<Item, 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 keyof Item, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Map<KeyedValue<Item, 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 keyof Item, Value extends ValueCallback<Item>>(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>>>;
+/**
+ * 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>>;
+/**
+ * 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>>>;
+/**
+ * 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>>;
+/**
+ * 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>>>;

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

@@ -1,37 +1,61 @@
 // Generated by dts-bundle-generator v9.5.1
 
+export type KeyedValue<Item, Key extends keyof Item> = Item[Key] extends PropertyKey ? Item[Key] : never;
 export type Key = number | string;
-export type ArrayCallback<Value, Returned> = (value: Value, index: number, array: Value[]) => Returned;
-export type KeyCallback<Value> = ArrayCallback<Value, Key>;
+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>;
 /**
- * Converts an array into a record, using indices as keys
+ * Create a record from an array of items _(using their indices as keys)_
  */
-export declare function toRecord<Value>(array: Value[]): Record<number, Value>;
+export declare function toRecord<Item>(array: Item[]): Record<number, Item>;
 /**
- * Converts an array into a record, using indices as keys and grouping values into arrays
+ * Create a record from an array of items using a specific key
  */
-export declare function toRecord<Value>(array: Value[], arrays: true): Record<number, Value[]>;
+export declare function toRecord<Item, Key extends keyof Item>(array: Item[], key: Key): Record<KeyedValue<Item, Key>, Item>;
 /**
- * - Converts an array into a record
- * - Uses `key` to find an identifcation value to use as keys
+ * Create a record from an array of items using a specific key, and grouping them into arrays
  */
-export declare function toRecord<Value>(array: Value[], key: Key): Record<Key, Value>;
+export declare function toRecord<Item, Key extends keyof Item>(array: Item[], key: Key, arrays: true): Record<KeyedValue<Item, Key>, Item[]>;
 /**
- * - Converts an array into a record
- * - Uses `key` to find an identifcation value to use as keys
- * - Groups values into arrays
+ * Create a record from an array of items using a specific key
  */
-export declare function toRecord<Value>(array: Value[], key: Key, arrays: true): Record<Key, Value[]>;
+export declare function toRecord<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key): Record<ReturnType<Key>, Item>;
 /**
- * - Converts an array into a record
- * - Uses `key` to find an identifcation value to use as keys
+ * Create a record from an array of items using a specific key, and grouping them into arrays
  */
-export declare function toRecord<Value>(array: Value[], key: KeyCallback<Value>): Record<Key, Value>;
+export declare function toRecord<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, arrays: true): Record<ReturnType<Key>, Item[]>;
 /**
- * - Converts an array into a record
- * - Uses `key` to find an identifcation value to use as keys
- * - Groups values into arrays
+ * Create a record from an array of items using a specific key and value
  */
-export declare function toRecord<Value>(array: Value[], key: KeyCallback<Value>, arrays: true): Record<Key, Value[]>;
+export declare function toRecord<Item, Key extends keyof Item, Value extends keyof Item>(array: Item[], key: Key, value: Value): Record<KeyedValue<Item, 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 keyof Item, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Record<KeyedValue<Item, 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 keyof Item, Value extends ValueCallback<Item>>(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>>>;
+/**
+ * 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>>;
+/**
+ * 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>>>;
+/**
+ * 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>>;
+/**
+ * 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 {};

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

@@ -1,32 +1,54 @@
-import type { KeyCallback } from '@/array/models';
-import type { Key } from '@/models';
+import type { KeyCallback, ValueCallback } from '~/array/models';
+import type { KeyedValue } from '~/models';
 /**
- * Converts an array into a record, using indices as keys
+ * Create a record from an array of items _(using their indices as keys)_
  */
-export declare function toRecord<Value>(array: Value[]): Record<number, Value>;
+export declare function toRecord<Item>(array: Item[]): Record<number, Item>;
 /**
- * Converts an array into a record, using indices as keys and grouping values into arrays
+ * Create a record from an array of items using a specific key
  */
-export declare function toRecord<Value>(array: Value[], arrays: true): Record<number, Value[]>;
+export declare function toRecord<Item, Key extends keyof Item>(array: Item[], key: Key): Record<KeyedValue<Item, Key>, Item>;
 /**
- * - Converts an array into a record
- * - Uses `key` to find an identifcation value to use as keys
+ * Create a record from an array of items using a specific key, and grouping them into arrays
  */
-export declare function toRecord<Value>(array: Value[], key: Key): Record<Key, Value>;
+export declare function toRecord<Item, Key extends keyof Item>(array: Item[], key: Key, arrays: true): Record<KeyedValue<Item, Key>, Item[]>;
 /**
- * - Converts an array into a record
- * - Uses `key` to find an identifcation value to use as keys
- * - Groups values into arrays
+ * Create a record from an array of items using a specific key
  */
-export declare function toRecord<Value>(array: Value[], key: Key, arrays: true): Record<Key, Value[]>;
+export declare function toRecord<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key): Record<ReturnType<Key>, Item>;
 /**
- * - Converts an array into a record
- * - Uses `key` to find an identifcation value to use as keys
+ * Create a record from an array of items using a specific key, and grouping them into arrays
  */
-export declare function toRecord<Value>(array: Value[], key: KeyCallback<Value>): Record<Key, Value>;
+export declare function toRecord<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, arrays: true): Record<ReturnType<Key>, Item[]>;
 /**
- * - Converts an array into a record
- * - Uses `key` to find an identifcation value to use as keys
- * - Groups values into arrays
+ * Create a record from an array of items using a specific key and value
  */
-export declare function toRecord<Value>(array: Value[], key: KeyCallback<Value>, arrays: true): Record<Key, Value[]>;
+export declare function toRecord<Item, Key extends keyof Item, Value extends keyof Item>(array: Item[], key: Key, value: Value): Record<KeyedValue<Item, 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 keyof Item, Value extends keyof Item>(array: Item[], key: Key, value: Value, arrays: true): Record<KeyedValue<Item, 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 keyof Item, Value extends ValueCallback<Item>>(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>>>;
+/**
+ * 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>>;
+/**
+ * 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>>>;
+/**
+ * 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>>;
+/**
+ * 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>>>;

package/types/array/unique.d.cts

@@ -1,16 +1,21 @@
 // Generated by dts-bundle-generator v9.5.1
 
 export type Key = number | string;
-export type ArrayCallback<Value, Returned> = (value: Value, index: number, array: Value[]) => Returned;
-export type KeyCallback<Value> = ArrayCallback<Value, Key>;
+export type ArrayCallback<Item, Value> = (item: Item, index: number, array: Item[]) => Value;
+export type KeyCallback<Item> = ArrayCallback<Item, Key>;
 /**
- * Returns an array of unique items
+ * Get an array of unique items
  */
-export declare function unique<Value>(array: Value[]): Value[];
+export declare function unique<Item>(array: Item[]): Item[];
 /**
- * - Returns an array of unique items
+ * - Get an array of unique items
  * - Use `key` to find a comparison value to match with `value`
  */
-export declare function unique<Value>(array: Value[], key: Key | KeyCallback<Value>): Value[];
+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`
+ */
+export declare function unique<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key): Item[];
 
 export {};

package/types/array/unique.d.ts

@@ -1,11 +1,15 @@
-import type { KeyCallback } from '@/array/models';
-import type { Key } from '@/models';
+import type { KeyCallback } from '~/array/models';
 /**
- * Returns an array of unique items
+ * Get an array of unique items
  */
-export declare function unique<Value>(array: Value[]): Value[];
+export declare function unique<Item>(array: Item[]): Item[];
 /**
- * - Returns an array of unique items
+ * - Get an array of unique items
  * - Use `key` to find a comparison value to match with `value`
  */
-export declare function unique<Value>(array: Value[], key: Key | KeyCallback<Value>): Value[];
+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`
+ */
+export declare function unique<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key): Item[];

package/types/colour/base.d.cts

@@ -7,35 +7,41 @@ export type HSLColourValue = {
 };
 declare class HSLColour extends Colour<HSLColourValue> {
 	/**
-	 * Gets the current hue
+	 * Get the current hue
 	 */
 	get hue(): number;
 	/**
-	 * Sets the current hue
+	 * Set the current hue
 	 */
 	set hue(value: number);
 	/**
-	 * Gets the current lightness
+	 * Get the current lightness
 	 */
 	get lightness(): number;
 	/**
-	 * Sets the current lightness
+	 * Set the current lightness
 	 */
 	set lightness(value: number);
 	/**
-	 * Gets the current saturation
+	 * Get the current saturation
 	 */
 	get saturation(): number;
 	/**
-	 * Sets the current saturation
+	 * Set the current saturation
 	 */
 	set saturation(value: number);
 	constructor(value: HSLColourValue);
+	/**
+	 * @inheritdoc
+	 */
 	toHex(): HexColour;
 	/**
-	 * Converts the colour to an RGB-colour
+	 * Convert the colour to an RGB-colour
 	 */
 	toRgb(): RGBColour;
+	/**
+	 * @inheritdoc
+	 */
 	toString(): string;
 	/**
 	 * Convert an HSL-colour to an RGB-colour
@@ -46,11 +52,11 @@ declare class HexColour {
 	private readonly $colour;
 	private readonly state;
 	/**
-	 * Gets the value of the colour
+	 * Get the value of the colour
 	 */
 	get value(): string;
 	/**
-	 * Sets the value of the colour
+	 * Set the value of the colour
 	 */
 	set value(value: string);
 	constructor(value: string);
@@ -75,7 +81,7 @@ export declare abstract class Colour<Model> {
 	private readonly $colour;
 	protected readonly state: ColourState<Model>;
 	/**
-	 * Gets the current value of the colour
+	 * Get the current value of the colour
 	 */
 	get value(): Model;
 	constructor(type: string, value: Model, defaults: Model, properties: Array<keyof Model>);
@@ -98,35 +104,41 @@ export type RGBColourValue = {
 };
 declare class RGBColour extends Colour<RGBColourValue> {
 	/**
-	 * Gets the current blue value
+	 * Get the current blue value
 	 */
 	get blue(): number;
 	/**
-	 * Sets the current blue value
+	 * Set the current blue value
 	 */
 	set blue(value: number);
 	/**
-	 * Gets the current green value
+	 * Get the current green value
 	 */
 	get green(): number;
 	/**
-	 * Sets the current green value
+	 * Set the current green value
 	 */
 	set green(value: number);
 	/**
-	 * Gets the current red value
+	 * Get the current red value
 	 */
 	get red(): number;
 	/**
-	 * Sets the current red value
+	 * Set the current red value
 	 */
 	set red(value: number);
 	constructor(value: RGBColourValue);
+	/**
+	 * @inheritdoc
+	 */
 	toHex(): HexColour;
 	/**
 	 * Convert the colour to an HSL-colour
 	 */
 	toHsl(): HSLColour;
+	/**
+	 * @inheritdoc
+	 */
 	toString(): string;
 	/**
 	 * Convert an RGB-colour to a hex-colour

package/types/colour/base.d.ts

@@ -1,9 +1,9 @@
-import type { HexColour } from '@/colour/hex';
+import type { HexColour } from '~/colour/hex';
 export declare abstract class Colour<Model> {
     private readonly $colour;
     protected readonly state: ColourState<Model>;
     /**
-     * Gets the current value of the colour
+     * Get the current value of the colour
      */
     get value(): Model;
     constructor(type: string, value: Model, defaults: Model, properties: Array<keyof Model>);