@oscarpalmer/atoms 0.74.1 → 0.76.0

package/src/js/value/merge.ts

@@ -1,5 +1,5 @@
-import {isArrayOrPlainObject} from '../is';
-import type {ArrayOrPlainObject, PlainObject} from '../models';
+import {isArrayOrPlainObject} from '~/is';
+import type {ArrayOrPlainObject, PlainObject} from '~/models';
 
 type MergeOptions = {
 	/**
@@ -10,7 +10,7 @@ type MergeOptions = {
 };
 
 /**
- * Merges multiple arrays or objects into a single one
+ * Merge multiple arrays or objects into a single one
  */
 export function merge<Model extends ArrayOrPlainObject>(
 	values: Model[],

package/src/js/value/set.ts

@@ -1,5 +1,5 @@
-import {handleValue} from '../internal/value-handle';
-import type {Paths, PlainObject} from '../models';
+import {handleValue} from '~/internal/value/handle';
+import type {Paths, PlainObject} from '~/models';
 
 /**
  * - Set the value in an object using a known path
@@ -38,8 +38,7 @@ export function setValue<Data extends PlainObject>(
 	const {length} = parts;
 	const lastIndex = length - 1;
 
-	let target: PlainObject =
-		typeof data === 'object' && data !== null ? data : {};
+	let target: PlainObject = data;
 
 	for (let index = 0; index < length; index += 1) {
 		const part = parts[index];

package/src/js/value/smush.ts

@@ -1,8 +1,8 @@
 import type {Get, Paths, Simplify} from 'type-fest';
 import type {ToString} from 'type-fest/source/internal/string';
-import {isArrayOrPlainObject} from '../is';
-import type {ArrayOrPlainObject, PlainObject} from '../models';
-import {join} from '../string';
+import {isArrayOrPlainObject} from '~/is';
+import type {ArrayOrPlainObject, PlainObject} from '~/models';
+import {join} from '~/string/index';
 
 type Smushed<Value> = Simplify<{
 	[Key in Paths<Value>]: Get<Value, ToString<Key>>;
@@ -31,7 +31,7 @@ function flatten(value: ArrayOrPlainObject, prefix?: string): PlainObject {
 }
 
 /**
- * Smushes an object into a flat object with dot notation keys
+ * Smush an object into a flat object that uses dot notation keys
  */
 export function smush<Value extends PlainObject>(value: Value): Smushed<Value> {
 	return flatten(value) as never;

package/src/js/value/unsmush.ts

@@ -1,7 +1,7 @@
 import type {KeysOfUnion, Simplify} from 'type-fest';
-import {isArrayOrPlainObject} from '../is';
-import type {PlainObject} from '../models';
-import {setValue} from './set';
+import {isArrayOrPlainObject} from '~/is';
+import type {PlainObject} from '~/models';
+import {setValue} from '~/value/set';
 
 type Unsmushed<Value extends PlainObject> = Simplify<
 	Omit<
@@ -32,7 +32,7 @@ function getKeyGroups(value: PlainObject): string[][] {
 }
 
 /**
- * Unsmushes a smushed object _(turning dot notation keys into nested keys)_
+ * Unsmush a smushed object _(turning dot notation keys into nested keys)_
  */
 export function unsmush<Value extends PlainObject>(
 	value: Value,

package/types/array/chunk.d.cts

@@ -0,0 +1,8 @@
+// Generated by dts-bundle-generator v9.5.1
+
+/**
+ * Chunk an array _(into smaller arrays of a specified size)_
+ */
+export declare function chunk<Item>(array: Item[], size?: number): Item[][];
+
+export {};

package/types/array/chunk.d.ts

@@ -1,4 +1,4 @@
 /**
- * Chunks an array into smaller arrays of a specified size
+ * Chunk an array _(into smaller arrays of a specified size)_
  */
-export declare function chunk<Value>(array: Value[], size?: number): Value[][];
+export declare function chunk<Item>(array: Item[], size?: number): Item[][];

package/types/array/compact.d.cts

@@ -0,0 +1,12 @@
+// Generated by dts-bundle-generator v9.5.1
+
+/**
+ * Compact an array _(removing all `null` and `undefined` values)_
+ */
+export declare function compact<Item>(array: Item[]): Exclude<Item, null | undefined>[];
+/**
+ * Compact an array _(removing all falsey values)_
+ */
+export declare function compact<Item>(array: Item[], strict: true): Exclude<Item, 0 | "" | false | null | undefined>[];
+
+export {};

package/types/array/compact.d.ts

@@ -1,8 +1,8 @@
 /**
- * Compacts and returns an array with all falsey values removed
+ * Compact an array _(removing all `null` and `undefined` values)_
  */
-export declare function compact<Value>(array: Value[], strict: true): Exclude<Value, 0 | '' | false | null | undefined>[];
+export declare function compact<Item>(array: Item[]): Exclude<Item, null | undefined>[];
 /**
- * Compacts and returns an array with all `null` and `undefined` values removed
+ * Compact an array _(removing all falsey values)_
  */
-export declare function compact<Value>(array: Value[]): Exclude<Value, null | undefined>[];
+export declare function compact<Item>(array: Item[], strict: true): Exclude<Item, 0 | '' | false | null | undefined>[];

package/types/array/count.d.cts

@@ -0,0 +1,24 @@
+// 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 number of items _(count)_ that match the given value
+ */
+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;
+/**
+ * Get the number of items _(count)_ that match the given value
+ */
+export declare function count<Item, Key extends keyof Item>(array: Item[], key: Key, value: Item[Key]): number;
+/**
+ * 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 {};

package/types/array/count.d.ts

@@ -1,11 +1,17 @@
-import type { Key } from '../models';
-import type { BooleanCallback, KeyCallback } from './models';
+import type { BooleanCallback, KeyCallback } from '~/array/models';
 /**
- * Returns the number of items _(count)_ that match the given value
+ * Get the number of items _(count)_ that match the given value
  */
-export declare function count<Model, Value>(array: Model[], value: Value | BooleanCallback<Model>): number;
+export declare function count<Item>(array: Item[], value: Item): number;
 /**
- * - Returns the number of items _(count)_ that match the given value
- * - Use `key` to find a comparison value to match with `value`
+ * Get the number of items _(count)_ that match the given value
  */
-export declare function count<Model, Value = Model>(array: Model[], value: Value, key: Key | KeyCallback<Model>): number;
+export declare function count<Item>(array: Item[], matches: BooleanCallback<Item>): number;
+/**
+ * Get the number of items _(count)_ that match the given value
+ */
+export declare function count<Item, Key extends keyof Item>(array: Item[], key: Key, value: Item[Key]): number;
+/**
+ * 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;

package/types/array/exists.d.cts

@@ -0,0 +1,26 @@
+// 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>;
+/**
+ * Does the value exist in array?
+ */
+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;
+/**
+ * - Does the value exist in array?
+ * - Use `key` to find a comparison value to match with `value`
+ */
+export declare function exists<Item, Key extends keyof Item>(array: Item[], key: Key, value: Item[Key]): boolean;
+/**
+ * - 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 {};

package/types/array/exists.d.ts

@@ -1,11 +1,19 @@
-import type { Key } from '../models';
 import type { BooleanCallback, KeyCallback } from './models';
 /**
  * Does the value exist in array?
  */
-export declare function exists<Model, Value>(array: Model[], value: Value | BooleanCallback<Model>): boolean;
+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;
+/**
+ * - Does the value exist in array?
+ * - Use `key` to find a comparison value to match with `value`
+ */
+export declare function exists<Item, Key extends keyof Item>(array: Item[], key: Key, value: Item[Key]): boolean;
 /**
  * - Does the value exist in array?
  * - Use `key` to find a comparison value to match with `value`
  */
-export declare function exists<Model, Value = Model>(array: Model[], value: Value, key: Key | KeyCallback<Model>): boolean;
+export declare function exists<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, value: ReturnType<Key>): boolean;

package/types/array/filter.d.cts

@@ -0,0 +1,26 @@
+// 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 a filtered array of items matching `value`
+ */
+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[];
+/**
+ * - Get a filtered array of items
+ * - Use `key` to find a comparison value to match with `value`
+ */
+export declare function filter<Item, Key extends keyof Item>(array: Item[], key: Key, value: Item[Key]): Item[];
+/**
+ * - 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 {};

package/types/array/filter.d.ts

@@ -1,11 +1,19 @@
-import type { Key } from '../models';
-import type { BooleanCallback, KeyCallback } from './models';
+import type { BooleanCallback, KeyCallback } from '~/array/models';
 /**
- * Returns a filtered array of items matching `value`
+ * Get a filtered array of items matching `value`
  */
-export declare function filter<Model, Value>(array: Model[], value: Value | BooleanCallback<Model>): Model[];
+export declare function filter<Item>(array: Item[], value: Item): Item[];
 /**
- * - Returns a filtered array of items
+ * Get a filtered array of items matching `value`
+ */
+export declare function filter<Item>(array: Item[], matches: BooleanCallback<Item>): Item[];
+/**
+ * - Get a filtered array of items
+ * - Use `key` to find a comparison value to match with `value`
+ */
+export declare function filter<Item, Key extends keyof Item>(array: Item[], key: Key, value: Item[Key]): Item[];
+/**
+ * - Get a filtered array of items
  * - Use `key` to find a comparison value to match with `value`
  */
-export declare function filter<Model, Value = Model>(array: Model[], value: Value, key: Key | KeyCallback<Model>): Model[];
+export declare function filter<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, value: ReturnType<Key>): Item[];

package/types/array/find.d.cts

@@ -0,0 +1,26 @@
+// 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 first item matching `value` _(or `undefined` if no match is found)_
+ */
+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;
+/**
+ * - 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 keyof Item>(array: Item[], key: Key, value: Item[Key]): 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`
+ */
+export declare function find<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, value: ReturnType<Key>): Item | undefined;
+
+export {};

package/types/array/find.d.ts

@@ -1,11 +1,19 @@
-import type { Key } from '../models';
-import type { BooleanCallback, KeyCallback } from './models';
+import type { BooleanCallback, KeyCallback } from '~/array/models';
 /**
- * Returns the first item matching `value`, or `undefined` if no match is found
+ * Get the first item matching `value` _(or `undefined` if no match is found)_
  */
-export declare function find<Model, Value>(array: Model[], value: Value | BooleanCallback<Model>): Model | undefined;
+export declare function find<Item>(array: Item[], value: Item): Item | undefined;
 /**
- * - Returns the first matching item, or `undefined` if no match is found
+ * 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;
+/**
+ * - 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 keyof Item>(array: Item[], key: Key, value: Item[Key]): 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`
  */
-export declare function find<Model, Value = Model>(array: Model[], value: Value, key: Key | KeyCallback<Model>): Model | undefined;
+export declare function find<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, value: ReturnType<Key>): Item | undefined;

package/types/array/group-by.d.cts

@@ -0,0 +1,58 @@
+// 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<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 a specific key
+ */
+export declare function groupBy<Item, Key extends keyof Item>(array: Item[], key: Key): Record<KeyedValue<Item, 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 keyof Item>(array: Item[], key: Key, arrays: true): Record<KeyedValue<Item, Key>, Item[]>;
+/**
+ * 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>;
+/**
+ * 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[]>;
+/**
+ * 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 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 groupBy<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 groupBy<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 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>>>;
+/**
+ * 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>>;
+/**
+ * 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>>>;
+/**
+ * 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>>;
+/**
+ * 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 groupValues(array: unknown[], key: unknown, value: unknown, arrays: boolean): Record<Key, unknown>;
+
+export {};

package/types/array/group-by.d.ts

@@ -1,7 +1,51 @@
-import type { Key } from '../models';
-import type { KeyCallback } from './models';
+import type { KeyCallback, ValueCallback } from '~/array/models';
+import type { Key, KeyedValue } from '~/models';
 /**
- * Groups an array of items using a key or callback
+ * Create a record from an array of items using a specific key
  */
-export declare function groupBy<Value>(array: Value[], key: Key | KeyCallback<Value>): Record<Key, Value[]>;
-export declare function groupValues<Value>(array: Value[], key: Key | KeyCallback<Value>, arrays: boolean, indicable: boolean): Record<Key, unknown>;
+export declare function groupBy<Item, Key extends keyof Item>(array: Item[], key: Key): Record<KeyedValue<Item, 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 keyof Item>(array: Item[], key: Key, arrays: true): Record<KeyedValue<Item, Key>, Item[]>;
+/**
+ * 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>;
+/**
+ * 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[]>;
+/**
+ * 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 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 groupBy<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 groupBy<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 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>>>;
+/**
+ * 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>>;
+/**
+ * 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>>>;
+/**
+ * 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>>;
+/**
+ * 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 groupValues(array: unknown[], key: unknown, value: unknown, arrays: boolean): Record<Key, unknown>;

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

@@ -0,0 +1,26 @@
+// 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)_
+ */
+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;
+/**
+ * - 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 keyof Item>(array: Item[], key: Key, value: Item[Key]): 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`
+ */
+export declare function indexOf<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, value: ReturnType<Key>): number;
+
+export {};

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

@@ -1,11 +1,19 @@
-import type { Key } from '../models';
-import type { BooleanCallback, KeyCallback } from './models';
+import type { BooleanCallback, KeyCallback } from '~/array/models';
 /**
- * Returns the index for the first item matching `value`, or `-1` if no match is found
+ * Get the index for the first item matching `value` _(or `-1` if no match is found)_
  */
-export declare function indexOf<Model, Value>(array: Model[], value: Value | BooleanCallback<Model>): number;
+export declare function indexOf<Item>(array: Item[], value: Item): number;
 /**
- * - Returns the index for the first matching item, or `-1` if no match is found
+ * 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;
+/**
+ * - 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 keyof Item>(array: Item[], key: Key, value: Item[Key]): 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`
  */
-export declare function indexOf<Model, Value = Model>(array: Model[], value: Value, key: Key | KeyCallback<Model>): number;
+export declare function indexOf<Item, Key extends KeyCallback<Item>>(array: Item[], key: Key, value: ReturnType<Key>): number;