feat(variables): added arrayFuzzySearch variable (#3002)

[Oceanity]

Description of the Change

Introduced an arrayFuzzySearch variable that allows a user to find the closest match in an array for a provided search

Applicable Issues

#3002

Testing

Tested all 3 provided examples to ensure they work as expected, and also tested passing in a simple custom variable array and an array from an HTTP Request response

Screenshots

n/a

[phroggster]

Thanks Oceanity, I love this! If only everything in computer sciences were fuzzier by default, we'd all be better off!

Two (non-blocking) ideas:

• An optional minimumSimilarity argument. Where, if specified, the variable evaluation would return the default value ("null", or see below) should the match with the smallest distance be greater than the argument's numeric-ish value.
• An optional defaultValue argument, in similar style to $userMetadata[...] or $customVariable[...], so that we can confidently match viewer-supplied text against an (admittedly esoteric) array consisting of, e.g. ["null", "mull", "bull"].

To future reviewer(s) of this:
Fuse.js released version 7.1.0 ~2 weeks ago. It adds the ability to optionally ignore diacritic (the fancy little "hats" that some letters can wear in many languages outside of English) character differences. IMHO, the fuse.js dep should get bumped to 7.1.0 to support this feature, and we should all embrace the fuzzy.

[Oceanity]

Thanks Oceanity, I love this! If only everything in computer sciences were fuzzier by default, we'd all be better off!

Two (non-blocking) ideas:

* An optional `minimumSimilarity` argument. Where, if specified, the variable evaluation would return the default value ("null", or see below) should the match with the smallest distance be greater than the argument's numeric-ish value.

* An optional `defaultValue` argument, in similar style to `$userMetadata[...]` or `$customVariable[...]`, so that we can confidently match viewer-supplied text against an (admittedly esoteric) array consisting of, e.g. `["null", "mull", "bull"]`.

To future reviewer(s) of this: Fuse.js released version 7.1.0 ~2 weeks ago. It adds the ability to optionally ignore diacritic (the fancy little "hats" that some letters can wear in many languages outside of English) character differences. IMHO, the fuse.js dep should get bumped to 7.1.0 to support this feature, and we should all embrace the fuzzy.

Added in da8c8fa

[ebiggz]

Thanks for working on this @Oceanity!

I agree with @phroggster that it would be worth updating fuse.js to latest. We are already on 7.x.x and from the change log I am not seeing any notable breaking changes. If you could bump fuses version in this PR, that would be great. Then we can get this merged in 👌🏻

[Oceanity]

Thanks for working on this @Oceanity!

I agree with @phroggster that it would be worth updating fuse.js to latest. We are already on 7.x.x and from the change log I am not seeing any notable breaking changes. If you could bump fuses version in this PR, that would be great. Then we can get this merged in 👌🏻

Updated Fuse.js to latest (d31ad98) and added param to ignore Diacritics (8ee0ba2)!