Fuzzy Search

Performs a fuzzy search by matching characters in sequence against array elements.

`fuzzySearch()`

Performs a fuzzy search by matching characters in sequence against array elements.

Important Note

You should not use this method explicitly unless you have a specific use case that requires it.
Instead, consider using the { fuzzy: true } option in the findOne, findAll, findOneAsync, and findAllAsync methods to enable fuzzy search.

fuzzySearch(
  array: T[],
  matcher: string,
  keySelector: (item: T) => string | number,
  caseInsensitive: boolean
): T | undefined

Parameter	Type	Description
`array`	`T[]`	The collection to search.
`matcher`	`string`	The sequence to search for (e.g. `'cmn'` matches `'California'`).
`keySelector`	`(item: T) => string \| number`	Value extractor function.
`caseInsensitive`	`boolean`	Whether to ignore character case.

The fuzzySearch method implements a flexible pattern matching algorithm that:

Finds items where the search characters appear in order (but not necessarily consecutively).
Supports both string and numeric property values.
Provides case sensitivity control.
Returns the first matching item found.

playground.ts