import { PlainObject } from "../models.mjs";

//#region src/array/difference.d.ts
/**
 * Get the items from the first array that are not in the second array
 *
 * @param first First array
 * @param second Second array
 * @param callback Callback to get an item's value for comparison
 * @returns Unique values from the first array
 *
 * @example
 * ```typescript
 * difference(
 *   [{id: 1}, {id: 2}, {id: 3}],
 *   [{id: 2}, {id: 4}],
 *   item => item.id,
 * ); // => [{id: 1}, {id: 3}]
 * ```
 */
declare function difference<First, Second>(first: First[], second: Second[], callback: (item: First | Second) => unknown): First[];
/**
 * Get the items from the first array that are not in the second array
 *
 * @param first First array
 * @param second Second array
 * @param key Key to get an item's value for comparison
 * @returns Unique values from the first array
 *
 * @example
 * ```typescript
 * difference(
 *   [{id: 1}, {id: 2}, {id: 3}],
 *   [{id: 2}, {id: 4}],
 *   'id',
 * ); // => [{id: 1}, {id: 3}]
 * ```
 */
declare function difference<First extends PlainObject, Second extends PlainObject, SharedKey extends keyof First & keyof Second>(first: First[], second: Second[], key: SharedKey): First[];
/**
 * Get the items from the first array that are not in the second array
 *
 * @param first First array
 * @param second Second array
 * @returns Unique values from the first array
 *
 * @example
 * ```typescript
 * difference(
 *   [1, 2, 3],
 *   [2, 4],
 * ); // => [1, 3]
 * ```
 */
declare function difference<First, Second>(first: First[], second: Second[]): First[];
//#endregion
export { difference };